npm - @swarmvaultai/cli - Versions diffs - 3.16.1 → 3.17.0 - Mend

@swarmvaultai/cli 3.16.1 → 3.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/dist/index.js +41 -10
package/package.json +2 -2

package/dist/index.js CHANGED Viewed

@@ -80,6 +80,7 @@ import {
   readContextPack,
   readGraphReport,
   readMemoryTask,
+  readPage,
   rebuildRetrievalIndex,
   refreshGraphClusters,
   registerLocalWhisperProvider,
@@ -336,9 +337,9 @@ program.addHelpText(
 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.16.1";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "3.17.0";
   } catch {
-    return "3.16.1";
+    return "3.17.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -791,17 +792,29 @@ function getCommandPath(command) {
 }
 async function runGraphUpdateCommand(targetPath, options) {
   const overrideRoots = targetPath ? [path2.resolve(process2.cwd(), targetPath)] : void 0;
+  const files = options.file?.length ? options.file.map((candidate2) => path2.resolve(process2.cwd(), candidate2)) : void 0;
   const result = await runWatchCycle(process2.cwd(), {
     repo: true,
     codeOnly: true,
     lint: options.lint ?? false,
     force: options.force ?? false,
-    overrideRoots
+    overrideRoots,
+    files
   });
   if (isJson()) {
     emitJson(result);
     return;
   }
+  if (result.queuedFiles?.length && result.scannedCount === 0) {
+    log(`Another refresh holds the lock. Queued ${result.queuedFiles.length} file(s) for the active refresh to fold in.`);
+    return;
+  }
+  if (files) {
+    log(
+      `Refreshed ${result.scannedCount} file(s). Imported ${result.repoImportedCount}, updated ${result.repoUpdatedCount}, removed ${result.repoRemovedCount}, pending semantic refresh ${result.pendingSemanticRefreshCount}.`
+    );
+    return;
+  }
   log(
     `Updated graph from ${result.watchedRepoRoots.length} repo root${result.watchedRepoRoots.length === 1 ? "" : "s"}. Imported ${result.repoImportedCount}, updated ${result.repoUpdatedCount}, removed ${result.repoRemovedCount}, pending semantic refresh ${result.pendingSemanticRefreshCount}.`
   );
@@ -1814,7 +1827,7 @@ program.command("lint").description("Run anti-drift and wiki-health checks.").op
 });
 var graph = program.command("graph").description("Graph-related commands.").enablePositionalOptions();
 var graphPush = graph.command("push").description("Push the compiled graph into external sinks.");
-graph.command("update").alias("refresh").description("Refresh code-derived graph artifacts from tracked repo roots or one explicit repo path.").argument("[path]", "Optional repo root to refresh instead of configured/tracked roots").option("--lint", "Run lint after the refresh cycle", false).option("--force", "Allow graph updates even when node or edge counts shrink sharply", false).action(runGraphUpdateCommand);
+graph.command("update").alias("refresh").description("Refresh code-derived graph artifacts from tracked repo roots, one explicit repo path, or explicit files.").argument("[path]", "Optional repo root to refresh instead of configured/tracked roots").option("--file <path>", "Refresh only this file (repeatable); skips the full tracked-root walk", collectRepeated, []).option("--lint", "Run lint after the refresh cycle", false).option("--force", "Allow graph updates even when node or edge counts shrink sharply", false).action(runGraphUpdateCommand);
 graph.command("tree").description("Write a collapsible source/module/symbol tree for the compiled graph.").option("--output <html>", "Output HTML path (default: wiki/graph/tree.html)").option("--root <path>", "Vault root to read instead of the current directory").option("--label <name>", "Tree title").option("--max-children <n>", "Maximum children to render per tree node", "250").action(runGraphTreeCommand);
 graph.command("merge").description("Merge SwarmVault or node-link JSON graph files into one namespaced graph artifact.").argument("<graphs...>", "Graph JSON files to merge").requiredOption("--out <path>", "Output graph JSON path").option("--label <name>", "Label/prefix to use when merging one graph").action(runGraphMergeCommand);
 graph.command("status").description("Read-only check for graph/report presence and tracked repo changes.").argument("[path]", "Optional repo root to check instead of configured/tracked roots").action(showGraphStatusCommand);
@@ -2030,6 +2043,17 @@ graph.command("query").description("Traverse the compiled graph deterministicall
       return;
     }
     log(result.summary);
+    if (result.topMatchPagePath) {
+      const page = await readPage(process2.cwd(), result.topMatchPagePath).catch(() => null);
+      if (page?.content) {
+        const limit = 1600;
+        const excerpt = page.content.length > limit ? `${page.content.slice(0, limit)}
+\u2026 (truncated \u2014 read wiki/${result.topMatchPagePath} for the rest)` : page.content;
+        log(`
+--- Top match page: wiki/${result.topMatchPagePath} ---
+${excerpt}`);
+      }
+    }
   }
 );
 graph.command("path").description("Find the shortest graph path between two nodes or pages.").argument("<from>", "Source node/page label or id").argument("<to>", "Target node/page label or id").action(async (from, to) => {
@@ -2459,7 +2483,7 @@ async function showWatchStatus() {
 watch.command("status").description("Show the latest watch run plus pending semantic refresh entries.").action(showWatchStatus);
 program.command("watch-status").description("Show the latest watch run plus pending semantic refresh entries.").action(showWatchStatus);
 program.command("check-update", { hidden: true }).description("Compatibility alias for graph status: read-only graph/report freshness and tracked repo change check.").argument("[path]", "Optional repo root to check instead of configured/tracked roots").action(showGraphStatusCommand);
-program.command("update", { hidden: true }).description("Compatibility alias for graph update: refresh code-derived graph artifacts from tracked repo roots.").argument("[path]", "Optional repo root to refresh instead of configured/tracked roots").option("--lint", "Run lint after the refresh cycle", false).option("--force", "Allow graph updates even when node or edge counts shrink sharply", false).action(runGraphUpdateCommand);
+program.command("update", { hidden: true }).description("Compatibility alias for graph update: refresh code-derived graph artifacts from tracked repo roots.").argument("[path]", "Optional repo root to refresh instead of configured/tracked roots").option("--file <path>", "Refresh only this file (repeatable); skips the full tracked-root walk", collectRepeated, []).option("--lint", "Run lint after the refresh cycle", false).option("--force", "Allow graph updates even when node or edge counts shrink sharply", false).action(runGraphUpdateCommand);
 program.command("cluster-only", { hidden: true }).description("Compatibility alias for graph cluster: recompute graph communities and report artifacts without re-ingesting.").argument("[vault]", "Optional vault root to cluster instead of the current directory").option("--resolution <number>", "Override the Louvain community resolution for this run").action(
   (vaultPath, options) => runGraphClusterCommand(options, vaultPath ? path2.resolve(process2.cwd(), vaultPath) : process2.cwd())
 );
@@ -2571,9 +2595,13 @@ program.command("mcp").description("Run SwarmVault as a local MCP server over st
   });
 });
 var install = program.command("install").description("Install SwarmVault instructions for an agent in the current project.");
-install.command("status").description("Show whether SwarmVault instructions are installed for an agent.").requiredOption("--agent <agent>", "Agent name").option("--hook", "Include hook/plugin targets in the status check", false).option("--scope <scope>", "Install scope to inspect: project or user", "project").action(async (options) => {
+install.command("status").description("Show whether SwarmVault instructions are installed for an agent.").requiredOption("--agent <agent>", "Agent name").option("--hook", "Include hook/plugin targets in the status check", false).option("--mcp", "Include MCP config targets in the status check", false).option("--scope <scope>", "Install scope to inspect: project or user", "project").action(async (options) => {
   const scope = options.scope === "user" ? "user" : "project";
-  const result = await getAgentInstallStatus(process2.cwd(), options.agent, { hook: options.hook ?? false, scope });
+  const result = await getAgentInstallStatus(process2.cwd(), options.agent, {
+    hook: options.hook ?? false,
+    mcp: options.mcp ?? false,
+    scope
+  });
   if (isJson()) {
     emitJson(result);
     return;
@@ -2586,7 +2614,7 @@ install.command("status").description("Show whether SwarmVault instructions are
 install.option(
   "--agent <agent>",
   "claude, codex, cursor, gemini, goose, opencode, copilot, aider, droid, pi, trae, claw, kiro, kilo, hermes, antigravity, vscode, amp, augment, adal, bob, cline, codebuddy, command-code, continue, cortex, crush, deepagents, devin, 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).option("--scope <scope>", "Install scope: project or user", "project").action(async (options) => {
+).option("--hook", "Also install hook/plugin guidance when the target agent supports it", false).option("--mcp", "Also register the SwarmVault MCP server in the agent's project MCP config", false).option("--scope <scope>", "Install scope: project or user", "project").action(async (options) => {
   if (!options.agent) {
     throw new Error("Specify --agent <agent>.");
   }
@@ -2594,10 +2622,13 @@ install.option(
   if (options.hook && !hookCapableAgents.has(options.agent)) {
     throw new Error("--hook is only supported for --agent codex, claude, opencode, gemini, copilot, or kilo");
   }
+  if (options.mcp && options.agent !== "claude") {
+    throw new Error("--mcp is currently only supported for --agent claude (project-level .mcp.json)");
+  }
   const scope = options.scope === "user" ? "user" : "project";
-  const result = await installAgent(process2.cwd(), options.agent, { hook: options.hook ?? false, scope });
+  const result = await installAgent(process2.cwd(), options.agent, { hook: options.hook ?? false, mcp: options.mcp ?? false, scope });
   if (isJson()) {
-    emitJson({ ...result, hook: options.hook ?? false, scope });
+    emitJson({ ...result, hook: options.hook ?? false, mcp: options.mcp ?? false, scope });
   } else {
     log(`Installed rules into ${result.target}`);
     if (result.targets.length > 1) {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "3.16.1",
+  "version": "3.17.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.16.1",
+    "@swarmvaultai/engine": "3.17.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {