Coverage Audit
This page tracks how the public docs site maps to Sero product behavior. It is source-driven: each row names the product source files or directories checked before assigning a coverage status.
Use this audit when adding or updating docs. If a feature is partly documented, update the existing page named in Gap / action before creating another page.
Status legend
| Status | Meaning |
|---|---|
| Covered | The docs site has current user-facing coverage and source paths were checked. |
| Partial | The docs site covers part of the feature, but important behavior, caveats, or source-checked details are missing. |
| Missing | The feature needs a new guide/reference page or a major new section. |
| Not user-facing | Keep out of public docs except for implementation reference or support context. |
Product coverage
| Area | User entry point | Source of truth checked | Current docs | Gap / action | Status |
|---|---|---|---|---|---|
| Shell layout and app navigation | Main sidebar, title bar, chat panel, status bar, command menu | apps/desktop/src/components/layout/TitleBar.tsx, apps/desktop/src/components/layout/StatusBar.tsx, apps/desktop/src/components/layout/CommandMenu.tsx, apps/desktop/src/stores/app.ts |
/guide/overview, /guide/workspace-and-chat, /reference/architecture |
Keep existing pages current when sidebar/chat/title-bar behavior changes. | Partial |
| Profiles and onboarding | First launch, profile switcher, onboarding screens | docs/features/profiles.md, apps/desktop/src/components/profiles/**, apps/desktop/electron/features/profile/**, apps/desktop/electron/features/onboarding/**, apps/desktop/src/types/ipc-channels.ts |
/guide/profiles-and-onboarding, /guide/workspace-and-chat, /reference/state-and-folders, /reference/security-privacy |
Keep profile docs aligned with custom path, restart-on-switch, transferable data, and deletion behavior. | Covered |
| Workspaces and attached folders | Add workspace menu, workspace tree, workspace references | apps/desktop/src/components/layout/AddWorkspaceMenu.tsx, apps/desktop/src/components/layout/workspace/**, apps/desktop/electron/features/workspace/**, apps/desktop/src/stores/workspace.ts |
/guide/workspace-and-chat, /guide/explorer-workspace, /reference/state-and-folders |
Expand profile/workspace handoff after the profile guide exists. | Partial |
| Explorer file tree, editor, terminal, and LSP | Explorer app, editor tabs, terminal panel | apps/desktop/src/components/apps/explorer/**, apps/desktop/electron/features/editor/**, apps/desktop/electron/features/container/terminal/**, apps/desktop/src/stores/explorer.ts, apps/desktop/src/stores/terminal.ts |
/guide/explorer-workspace, /reference/containers-host-mode, /reference/troubleshooting |
Add deeper LSP/editor and terminal recovery details to Explorer/troubleshooting pages. | Partial |
| Chat sessions and composer | Chat panel, model selector, prompt box, session tree | apps/desktop/src/components/layout/ChatPanel.tsx, apps/desktop/src/components/layout/ChatPromptArea.tsx, apps/desktop/src/components/layout/ModelSelector.tsx, apps/desktop/src/stores/agent.ts, apps/desktop/src/stores/sessions.ts |
/guide/agent-sessions-and-context, /guide/workspace-and-chat, /guide/models-and-providers |
Keep composer/control details in the agent sessions guide; avoid duplicating stale details elsewhere. | Covered |
| Context controls, attachments, slash commands, and file references | @ file menu, slash command menu, attachments, context editor, workspace snapshot |
apps/desktop/src/components/layout/FileReferenceMenu.tsx, apps/desktop/src/components/layout/SlashCommandMenu.tsx, apps/desktop/src/components/layout/ContextEditor.tsx, apps/desktop/src/components/layout/WorkspaceSnapshotMenuItem.tsx, apps/desktop/src/stores/context-editor.ts, apps/desktop/src/stores/composer-attachments.ts |
/guide/agent-sessions-and-context, /guide/workspace-and-chat |
Keep “context helps but is not guaranteed every turn” caveat visible. | Covered |
| Voice transcription | Microphone button in chat composer | apps/desktop/src/components/layout/VoiceTranscriptionControl.tsx, apps/desktop/electron/features/agent/assistants/voice-transcription.ts, apps/desktop/src/components/layout/voice-utils.ts |
/guide/agent-sessions-and-context, /guide/models-and-providers |
Keep OpenAI credential requirement, mic permission, provider/privacy wording current. | Covered |
| Subagents and agent definitions | Agent delegation, agent files, subagent result panels | apps/desktop/electron/features/subagent/**, apps/desktop/src/stores/subagent.ts, apps/desktop/src/types/subagent.ts, docs/features/subagents.md, docs/specs/subagents.md |
/guide/subagents, /reference/agent-definitions, /guide/settings-models-admin, /reference/state-and-folders |
Keep no-recursion, child-session limits, and ignored tools field caveats explicit. |
Covered |
| Collaboration and debate mode | Collaboration activity panel and multi-agent responses | apps/desktop/electron/features/collaboration/**, apps/desktop/src/components/layout/CollaborationActivityPanel.tsx, apps/desktop/src/stores/agent-collaboration.ts, apps/desktop/src/types/collaboration.ts |
/guide/subagents, /guide/agent-sessions-and-context |
Covered in subagents guide as distinct standard/debate collaboration, with degraded-mode caveats. | Covered |
| Containers and workspace runtime | Container-backed workspace, host mode fallback, terminal/runtime status | apps/desktop/electron/features/container/**, apps/desktop/src/stores/container.ts, docs/guides/macos-containers.md, docs/decisions.md |
/guide/containers-dev-servers, /reference/container-isolation, /reference/containers-host-mode, /guide/explorer-workspace, /reference/troubleshooting |
Keep lifecycle/mount/network semantics source-checked; do not overstate isolation or persistence. | Covered |
| Dev servers and previews | Dev server panel, Explorer browser preview, sero devserver ... |
apps/desktop/src/components/layout/DevServerPanel.tsx, apps/desktop/src/stores/dev-server.ts, apps/desktop/electron/cli/commands/container/devserver.ts, apps/desktop/electron/features/container/registries/dev-server-registry.ts, apps/desktop/electron/features/container/network/** |
/guide/containers-dev-servers, /reference/container-isolation, /guide/explorer-workspace, /reference/sero-cli, /reference/troubleshooting |
Keep registry id, in-memory status, stop/restart behavior, and container-IP URL wording aligned with code. | Covered |
| Browser preview, app capture, screenshots, and recording | Explorer browser, app-control CLI, screenshot/record commands | apps/desktop/electron/cli/commands/browser/browser.ts, apps/desktop/electron/cli/commands/apps/app-control*.ts, apps/desktop/src/lib/app-control-bridge.ts, apps/desktop/src/lib/app-control/dom-interactions.ts, apps/desktop/src/stores/browser.ts |
/guide/browser-and-capture, /reference/sero-cli, /guide/explorer-workspace, /reference/troubleshooting |
Add media assets later; keep visible-browser vs app-control bridge distinction explicit. | Covered |
| Sero CLI | Terminal command sero ..., agent CLI bridge |
apps/desktop/electron/cli/index.ts, apps/desktop/electron/cli/core/registry.ts, apps/desktop/electron/cli/core/types.ts, apps/desktop/electron/cli/core/batch-executor.ts, apps/desktop/electron/cli/commands/** |
/reference/sero-cli, /guide/containers-dev-servers, /guide/browser-and-capture, /guide/remote-control |
Keep command tables generated/source-checked when namespaces or bridge policy change. | Covered |
| Providers, models, health, and tiers | Onboarding providers, Settings/Admin models, model selector | apps/desktop/electron/shared/auth/provider-catalog.ts, apps/desktop/electron/shared/providers/package-provider-manifests.ts, apps/desktop/electron/features/onboarding/provider-health.ts, apps/desktop/electron/features/onboarding/model-groups.ts, docs/guides/combined-model-selection.md, plugins/sero-alibaba-plugin/package.json |
/guide/models-and-providers, /guide/settings-models-admin |
Keep provider tables source-checked when built-in or plugin-defined provider manifests change. | Covered |
| Local/custom models and LM Studio | Settings/Admin local models, models.json |
apps/desktop/src/types/local-models.ts, apps/desktop/electron/ipc/agent/handlers/local-models.ts, apps/desktop/src/components/layout/models/model-manager/local-models/presets.ts, apps/desktop/electron/features/onboarding/provider-health.ts, docs/guides/combined-model-selection.md |
/guide/local-llms-lm-studio, /reference/models-json, /guide/models-and-providers, /reference/state-and-folders |
Add screenshots/media later if needed; keep schema limited to source-supported fields. | Covered |
| Apps, plugins, app store, and favorites | App sidebar, App Store dialog, local plugin development | apps/desktop/src/components/layout/AppStoreDialog.tsx, apps/desktop/src/components/layout/AppStoreCard.tsx, apps/desktop/electron/features/plugins/**, apps/desktop/electron/features/apps/**, docs/features/local-plugin-development.md, packages/app-runtime/src/index.ts |
/guide/plugins-and-apps, /guide/app-store-favorites, /plugins/catalog, /reference/plugins, /reference/app-runtime |
Keep built-in/external status and local-dev-vs-attached-folder wording current as plugin APIs evolve. | Covered |
| Dashboard and widgets | Dashboard app, Add Widget dialog, draggable widget grid | apps/desktop/src/components/apps/dashboard/Dashboard.tsx, apps/desktop/src/components/apps/dashboard/AddWidgetDialog.tsx, apps/desktop/src/components/apps/dashboard/DashboardWidget.tsx, apps/desktop/src/stores/dashboard.ts, packages/app-runtime/src/use-widget-registration.ts |
/guide/dashboard-widgets, /guide/plugins-and-apps, /guide/workspace-and-chat, /reference/state-and-folders |
Keep manifest-vs-runtime widget wording and profile layout persistence caveats current. | Covered |
| Built-in plugins | Built-in app/plugin surfaces and agent tools | plugins/sero-admin-plugin/package.json, plugins/sero-alibaba-plugin/package.json, plugins/sero-cron-plugin/package.json, plugins/sero-git-plugin/package.json, plugins/sero-mcp-plugin/package.json, plugins/sero-memory-plugin/package.json, plugins/sero-user-feedback-plugin/package.json, plugins/sero-web-plugin/package.json |
/plugins/catalog, /guide/settings-models-admin, /guide/models-and-providers#plugin-defined-providers, /guide/scheduler-reminders, /guide/git-integration, /guide/mcp, /guide/memory, /plugins/user-feedback, /guide/web |
Keep catalog rows aligned with manifests; built-ins are not third-party packages removed through Plugin Manager. | Covered |
| External/local plugins | Installed or local plugin development sessions | ../plugins/sero-google-plugin/package.json, ../plugins/sero-kanban-plugin/package.json, ../plugins/sero-notes-plugin/package.json, ../plugins/sero-todo-plugin-main/package.json, ../plugins/sero-research-plugin/package.json, ../plugins/sero-plan-mode-plugin/package.json, ../plugins/sero-spotify-plugin/package.json, ../plugins/sero-imagegen-plugin/package.json, ../plugins/sero-starling-plugin/package.json, ../plugins/sero-weight-tracker-plugin/package.json, ../plugins/sero-calc-plugin/package.json, ../plugins/sero-daily-quote-plugin/package.json, ../plugins/sero-humanizer-plugin/package.json, ../plugins/sero-slopzilla-plugin/package.json, ../plugins/sero-tetris-plugin/package.json |
/plugins/catalog, /plugins/google, /plugins/kanban, /plugins/notes, /plugins/todo, /plugins/research, /plugins/plan-mode, /plugins/spotify, /plugins/imagegen, /plugins/starling, /plugins/weight-tracker |
Catalog-only coverage exists for Calculator, Daily Quote, Humanizer, SlopZilla, and Tetris; keep privacy caveats for sensitive plugins. | Covered |
| Remote control and device gateway | Connect device dialog, remote origin manager, gateway server | apps/desktop/src/components/layout/ConnectDeviceDialog.tsx, apps/desktop/src/components/layout/RemoteOriginManager.tsx, apps/desktop/electron/features/gateway/** |
/guide/remote-control, /reference/security-privacy, /reference/troubleshooting |
Keep covered pages updated with security caveats and failure modes. | Covered |
| MCP | MCP guide/settings/plugin | plugins/sero-mcp-plugin/package.json, plugins/sero-mcp-plugin/src/**, apps/docs-site/docs/guide/mcp.md |
/guide/mcp, /reference/plugins |
Add catalog linkage when plugin catalog exists. | Covered |
| Git, VCS, checkpoints, and turn undo | Git plugin, Explorer VCS UI, checkpoint restore dialog, chat undo | plugins/sero-git-plugin/package.json, apps/desktop/src/components/apps/explorer/vcs/**, apps/desktop/src/components/layout/CheckpointRestoreDialog.tsx, apps/desktop/src/hooks/useCheckpointRestore.ts, apps/desktop/electron/ipc/agent/core/agent-checkpoint.ts, apps/desktop/electron/features/vcs/** |
/guide/checkpoints-and-undo, /guide/git-integration, /guide/explorer-workspace, /reference/troubleshooting |
Keep manual checkpoint, restore checkpoint, turn undo, and source-control operation distinctions explicit. | Covered |
| Memory and daily logs | Memory plugin, memory context block, memory docs | plugins/sero-memory-plugin/package.json, plugins/sero-memory-plugin/src/**, apps/desktop/src/components/layout/MemoryContextBlock.tsx, docs/features/memory.md |
/guide/memory, /reference/state-and-folders, /reference/security-privacy |
Add catalog linkage; verify memory visibility wording during agent-context pass. | Covered |
| Scheduler and reminders | Cron plugin reminders/scheduled jobs | plugins/sero-cron-plugin/package.json, plugins/sero-cron-plugin/src/** |
/guide/scheduler-reminders, /plugins/catalog |
Keep scheduling limitations and dashboard-widget wording current. | Covered |
| Web integration | Web plugin UI/tools | plugins/sero-web-plugin/package.json, plugins/sero-web-plugin/src/** |
/guide/web, /plugins/catalog, /guide/browser-and-capture |
Keep provider-specific limitations and browser-capture distinction current. | Covered |
| User feedback and permission prompts | Pending question cards, questionnaire notices, feedback buttons | plugins/sero-user-feedback-plugin/package.json, apps/desktop/src/components/layout/PendingQuestionCard.tsx, apps/desktop/src/components/layout/QuestionnaireNotice.tsx, apps/desktop/src/components/layout/ResponseFeedback.tsx, apps/desktop/src/stores/user-feedback-store.ts |
/plugins/user-feedback, /plugins/catalog |
Keep pending-answer privacy warnings current. | Covered |
| Testing and evals | Contributor commands and promptfoo evals | package.json, promptfooconfig.yaml, eval/promptfoo-snapshot.yaml, eval/scenarios/**, docs/testing/eval-guide.md, apps/desktop/electron/__tests__/** |
/guide/running-evals, /reference/testing-evals, /guide/development-setup |
Keep snapshot vs live eval workflow, cost/auth warnings, scenario matrix, and failure interpretation aligned with scripts/configs. | Covered |
| Security, privacy, and support boundaries | Security reference, support scope, sensitive state | SECURITY.md, docs/security/**, apps/desktop/electron/features/gateway/security/**, apps/desktop/electron/env.ts, apps/docs-site/docs/reference/security-privacy.md |
/reference/security-privacy, /reference/support-scope, /reference/state-and-folders, /reference/known-limitations, /guide/profiles-and-onboarding, /reference/models-json |
Keep redaction guidance aligned as plugins, agent context, and remote-control docs expand. | Partial |
| Media assets and screenshots | Docs screenshots and future captures | apps/docs-site/docs/assets/**, apps/docs-site/docs/index.md, apps/docs-site/docs/guide/** |
Existing screenshots in selected pages; /assets/CAPTURE_NOTES.md records stable directories, capture rules, and omissions |
Stable asset directories now exist for shell, Explorer, containers, CLI, models, subagents, browser capture, evals, and plugins. No new screenshots/recordings were captured in this pass; omissions are recorded instead of reusing unrelated assets. | Partial |
| Internal planning and cleanup docs | Maintainer-only trees | docs/README.md, .pi/plans/**, docs/plans/**, docs/superpowers/**, docs/deslopify/** |
none in public nav | Keep these out of public navigation; harvest facts into curated pages instead of linking transient trees. | Not user-facing |
Final validation trace
Validation pass: 2026-04-28.
- Docs build:
pnpm --filter @sero/docs-site buildsucceeded. - IA/source-file size:
apps/docs-site/rspress.config.tsis 130 lines, under the 500 LOC limit. - Public nav/index link check:
rspress.config.ts, home, guide index, and reference index link only existing docs-site pages and public GitHub URLs. - Stale path/internal-tree check: no legacy Pi agent directory references were found in public docs-site content. Internal planning tree names appear only in this audit row as source/private-boundary examples, not as public links.
- Link/source check: practical Markdown/config link script found 0 missing internal Markdown or asset links.
Remaining gaps and omissions
- Media capture remains partial. Stable directories and capture rules now exist under
apps/docs-site/docs/assets/, but no new screenshots or recordings were captured in this pass. Seeapps/docs-site/docs/assets/CAPTURE_NOTES.mdfor required assets and omission reasons. - Shell layout, workspace/Explorer/LSP, and security/privacy rows remain
Partialbecause they have usable public docs but still need deeper source-checked details or fresh redacted media in future passes. - Smaller external plugins (Calculator, Daily Quote, Humanizer, SlopZilla, and Tetris) remain catalog-only by design to avoid sidebar bloat.
ON THIS PAGE