@swarmvaultai/cli 3.0.0 → 3.2.0

package/README.md

@@ -47,6 +47,7 @@ swarmvault query "What keeps recurring?" --commit
 swarmvault context build "Ship this feature safely" --target ./src --budget 8000
 swarmvault task start "Ship this feature safely" --target ./src --agent codex
 swarmvault retrieval status
+swarmvault doctor --repair
 swarmvault query "Turn this into slides" --format slides
 swarmvault explore "What should I research next?" --steps 3
 swarmvault lint --deep
@@ -115,6 +116,16 @@ Compare the current `state/graph.json` against the last committed graph in git.
 - when no git baseline exists, falls back to a summary of the current graph state
 - supports `--json` for structured automation output
 
+### `swarmvault doctor [--repair]`
+
+Run a whole-vault health check before handing the workspace to an agent or opening the live viewer.
+
+- checks workspace config and schema presence
+- reports graph, page, source, review, candidate, task, watch, migration, and retrieval state
+- emits suggested follow-up commands for warnings and errors
+- supports `--json` for structured automation output
+- add `--repair` to rebuild safe derived retrieval artifacts
+
 ### `swarmvault source add|list|reload|review|guide|session|delete`
 
 Manage recurring source roots through a registry-backed workflow.
@@ -400,16 +411,17 @@ Run SwarmVault as a local MCP server over stdio. This exposes the vault to compa
 - `retrieval_status`
 - `rebuild_retrieval`
 - `doctor_retrieval`
+- `doctor_vault`
 
-`compile_vault` also accepts `maxTokens` for bounded wiki output, `blast_radius` traces reverse import impact for a file or module target, `build_context_pack` creates the same bounded agent evidence bundles as `swarmvault context build`, the task tools mirror `swarmvault task`, the memory tools mirror the compatibility command group, and retrieval tools inspect or repair the local index.
+`compile_vault` also accepts `maxTokens` for bounded wiki output, `blast_radius` traces reverse import impact for a file or module target, `build_context_pack` creates the same bounded agent evidence bundles as `swarmvault context build`, the task tools mirror `swarmvault task`, the memory tools mirror the compatibility command group, `doctor_vault` mirrors `swarmvault doctor`, and retrieval tools inspect or repair the local index.
 
 The MCP surface also exposes `swarmvault://schema`, `swarmvault://sessions`, `swarmvault://sessions/{path}`, `swarmvault://context-packs`, `swarmvault://tasks`, `swarmvault://memory-tasks`, and includes `schemaPath` in `workspace_info`.
 
 ### `swarmvault graph serve`
 
-Start the local graph workspace backed by `state/graph.json`, `/api/search`, `/api/page`, and local graph query/path/explain endpoints.
+Start the local graph workspace backed by `state/graph.json`, `/api/search`, `/api/page`, local graph query/path/explain endpoints, and the workbench APIs for doctor, retrieval repair, capture, context packs, task start, and source reload.
 
-It also exposes `/api/bookmarklet` and `/api/clip`, so a running local viewer can ingest the current browser page through a bookmarklet without leaving the browser.
+It also exposes `/api/bookmarklet` and `/api/clip`, so a running local viewer can capture the current browser URL, selected text, markdown, HTML excerpts, and tags through the workbench or bookmarklet without leaving the browser.
 
 ### `swarmvault graph query "<question>" [--dfs] [--budget <n>]`
 

package/dist/index.js

@@ -23,6 +23,7 @@ import {
   deleteContextPack,
   deleteManagedSource,
   doctorRetrieval,
+  doctorVault,
   downloadWhisperModel,
   explainGraphVault,
   exploreVault,
@@ -308,9 +309,9 @@ program.name("swarmvault").description("SwarmVault is a local-first knowledge co
 function readCliVersion() {
   try {
     const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
-    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "3.0.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "3.2.0";
   } catch {
-    return "3.0.0";
+    return "3.2.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -1713,7 +1714,7 @@ program.command("mcp").description("Run SwarmVault as a local MCP server over st
 });
 program.command("install").description("Install SwarmVault instructions for an agent in the current project.").requiredOption(
   "--agent <agent>",
-  "codex, claude, cursor, goose, pi, gemini, opencode, aider, copilot, trae, claw, droid, kiro, hermes, antigravity, or vscode"
+  "claude, codex, cursor, gemini, goose, opencode, copilot, aider, droid, pi, trae, claw, kiro, hermes, antigravity, vscode, amp, augment, adal, bob, cline, codebuddy, command-code, continue, cortex, crush, deepagents, firebender, iflow, junie, kilo-code, kimi, kode, mcpjam, mistral-vibe, mux, neovate, openclaw, openhands, pochi, qoder, qwen-code, replit, roo-code, trae-cn, warp, windsurf, or zencoder"
 ).option("--hook", "Also install hook/plugin guidance when the target agent supports it", false).action(
   async (options) => {
     const hookCapableAgents = /* @__PURE__ */ new Set(["claude", "opencode", "gemini", "copilot"]);
@@ -2013,6 +2014,26 @@ program.command("diff").description("Show what changed in the knowledge graph si
     }
   }
 });
+program.command("doctor").description("Diagnose vault health across graph, retrieval, review queues, watch state, and migrations.").option("--repair", "Run safe repairs such as rebuilding stale retrieval artifacts", false).action(async (options) => {
+  const report = await doctorVault(process2.cwd(), { repair: options.repair });
+  if (isJson()) {
+    emitJson(report);
+    return;
+  }
+  log(`Vault health: ${report.status}${report.repaired.length ? ` (repaired: ${report.repaired.join(", ")})` : ""}`);
+  log(
+    `Sources ${report.counts.sources} | Managed ${report.counts.managedSources} | Pages ${report.counts.pages} | Nodes ${report.counts.nodes} | Edges ${report.counts.edges}`
+  );
+  for (const check of report.checks) {
+    log(`[${check.status}] ${check.label}: ${check.summary}`);
+    if (check.detail) {
+      log(`  ${check.detail}`);
+    }
+    for (const action of check.actions ?? []) {
+      log(`  Try: ${action.command} - ${action.description}`);
+    }
+  }
+});
 var retrieval = program.command("retrieval").description("Inspect and repair the local retrieval index.");
 retrieval.command("status").description("Show retrieval index health and configuration.").action(async () => {
   const status = await getRetrievalStatus(process2.cwd());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
     "prepublishOnly": "node ../../scripts/check-release-sync.mjs && node ../../scripts/check-published-manifests.mjs"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "3.0.0",
+    "@swarmvaultai/engine": "3.2.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {