swarmvault doctor

Run a whole-vault health check before an agent handoff, release smoke, or viewer session.

Usage

swarmvault doctor
swarmvault doctor --repair
swarmvault doctor --json

What It Checks

• workspace config and swarmvault.schema.md
• compiled graph and graph-report artifacts
• page, source, node, edge, review, candidate, task, and pending watch counts
• local retrieval index freshness
• managed-source registry state
• migration plan state

Repair

--repair only repairs safe derived artifacts today. It rebuilds missing or stale retrieval artifacts under state/retrieval/ and reports the repair in the result. Missing graph or wiki content still requires swarmvault compile because those artifacts are generated from source manifests and schema intent.

Output

Plain text output prints a summary, prioritized recommended next actions, each check, and suggested next commands. --json returns the same structured doctor report used by MCP doctor_vault and the graph viewer workbench.

In swarmvault graph serve, the workbench shows prioritized doctor recommendations plus the full check list with details and copyable suggested commands. It only runs the existing safe doctor --repair path directly; other suggested commands are copied back to a terminal for deliberate execution.