@swarmvaultai/cli 3.1.0 → 3.3.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,17 @@ 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
+- the live viewer workbench shows the same checks with details and copyable suggested commands
+
 ### `swarmvault source add|list|reload|review|guide|session|delete`
 
 Manage recurring source roots through a registry-backed workflow.
@@ -400,16 +412,19 @@ 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.
+
+The workbench renders every vault doctor check with details, suggested commands that can be copied back to a terminal, safe one-click retrieval repair through `doctor --repair`, selectable capture modes (`ingest`, normalized `add`, or `inbox`), editable token budgets for context packs and task starts, and action receipts after workbench operations complete.
 
-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.1.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "3.3.0";
   } catch {
-    return "3.1.0";
+    return "3.3.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -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.1.0",
+  "version": "3.3.0",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -37,18 +37,19 @@
   "engines": {
     "node": ">=24.0.0"
   },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "node ../../scripts/check-release-sync.mjs && node ../../scripts/check-published-manifests.mjs"
+  },
   "dependencies": {
-    "@swarmvaultai/engine": "3.1.0",
+    "@swarmvaultai/engine": "3.3.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
     "tsup": "^8.5.0",
     "vitest": "^3.2.4"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 SwarmVault
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.