@swarmvaultai/cli 3.3.0 → 3.4.0

package/README.md

@@ -122,10 +122,11 @@ Run a whole-vault health check before handing the workspace to an agent or openi
 
 - checks workspace config and schema presence
 - reports graph, page, source, review, candidate, task, watch, migration, and retrieval state
+- emits prioritized recommended next actions before the full check list
 - 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
+- the live viewer workbench shows the same recommendations and checks with details, copyable suggested commands, and safe direct repair
 
 ### `swarmvault source add|list|reload|review|guide|session|delete`
 
@@ -422,9 +423,9 @@ The MCP surface also exposes `swarmvault://schema`, `swarmvault://sessions`, `sw
 
 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.
+The workbench renders prioritized vault doctor recommendations, every 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`), title/tag capture fields, 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 capture the current browser URL, selected text, markdown, HTML excerpts, and tags through the workbench or bookmarklet without leaving the browser.
+It also exposes `/api/bookmarklet` and `/api/clip`, so a running local viewer can capture the current browser URL, page title, selected text, markdown, HTML excerpts, and tags through the workbench or bookmarklet without leaving the browser. URL-only bookmarklet clips use normalized `add`; selected text is imported through the inbox path.
 
 ### `swarmvault graph query "<question>" [--dfs] [--budget <n>]`
 

package/dist/index.js

@@ -309,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.3.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "3.4.0";
   } catch {
-    return "3.3.0";
+    return "3.4.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -2024,6 +2024,16 @@ program.command("doctor").description("Diagnose vault health across graph, retri
   log(
     `Sources ${report.counts.sources} | Managed ${report.counts.managedSources} | Pages ${report.counts.pages} | Nodes ${report.counts.nodes} | Edges ${report.counts.edges}`
   );
+  if (report.recommendations.length) {
+    log("Recommended next actions:");
+    for (const recommendation of report.recommendations) {
+      const action = recommendation.command ? ` ${recommendation.command}` : "";
+      log(`  [${recommendation.priority}] ${recommendation.label}:${action}`);
+      if (recommendation.description) {
+        log(`    ${recommendation.description}`);
+      }
+    }
+  }
   for (const check of report.checks) {
     log(`[${check.status}] ${check.label}: ${check.summary}`);
     if (check.detail) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "3.3.0",
+  "version": "3.4.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.3.0",
+    "@swarmvaultai/engine": "3.4.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {