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

@swarmvaultai/cli 3.16.1 → 3.18.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 +68 -16
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.18.0";
   } catch {
-    return "3.16.1";
+    return "3.18.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,31 +2483,31 @@ 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())
 );
 program.command("tree", { hidden: true }).description("Compatibility alias for graph tree: 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);
 program.command("merge-graphs", { hidden: true }).description("Compatibility alias for graph merge: combine graph JSON 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);
 var hook = program.command("hook").description("Install local git hooks that keep tracked repos and the vault in sync.");
-hook.command("install").description("Install post-commit and post-checkout hooks for the nearest git repository.").action(async () => {
-  const status = await installGitHooks(process2.cwd());
+hook.command("install").description("Install post-commit and post-checkout hooks for the nearest git repository, or an explicit repo below the vault root.").argument("[repo]", "Optional git repo path when the tracked repo lives below the vault root").action(async (repo) => {
+  const status = await installGitHooks(process2.cwd(), { repoPath: repo });
   if (isJson()) {
     emitJson(status);
     return;
   }
   log(`Installed hooks in ${status.repoRoot}`);
 });
-hook.command("uninstall").description("Remove the SwarmVault-managed git hook blocks from the nearest git repository.").action(async () => {
-  const status = await uninstallGitHooks(process2.cwd());
+hook.command("uninstall").description("Remove the SwarmVault-managed git hook blocks from the nearest git repository or an explicit repo path.").argument("[repo]", "Optional git repo path when the tracked repo lives below the vault root").action(async (repo) => {
+  const status = await uninstallGitHooks(process2.cwd(), { repoPath: repo });
   if (isJson()) {
     emitJson(status);
     return;
   }
   log(`Removed SwarmVault hook blocks from ${status.repoRoot ?? "the current workspace"}`);
 });
-hook.command("status").description("Show whether SwarmVault-managed git hooks are installed.").action(async () => {
-  const status = await getGitHookStatus(process2.cwd());
+hook.command("status").description("Show whether SwarmVault-managed git hooks are installed.").argument("[repo]", "Optional git repo path when the tracked repo lives below the vault root").action(async (repo) => {
+  const status = await getGitHookStatus(process2.cwd(), { repoPath: repo });
   if (isJson()) {
     emitJson(status);
     return;
@@ -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,10 @@ 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(
+  "--graph-first [mode]",
+  "Opt in to graph-first search enforcement for installed hooks: deny (default when the flag is passed), context, or off; persisted as hooks.graphFirst"
+).option("--scope <scope>", "Install scope: project or user", "project").action(async (options) => {
   if (!options.agent) {
     throw new Error("Specify --agent <agent>.");
   }
@@ -2594,12 +2625,33 @@ 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)");
+  }
+  let graphFirst;
+  if (options.graphFirst !== void 0) {
+    const mode = options.graphFirst === true ? "deny" : String(options.graphFirst).toLowerCase();
+    if (mode !== "deny" && mode !== "context" && mode !== "off") {
+      throw new Error("--graph-first accepts deny, context, or off");
+    }
+    graphFirst = mode;
+  }
   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,
+    graphFirst,
+    scope
+  });
   if (isJson()) {
-    emitJson({ ...result, hook: options.hook ?? false, scope });
+    emitJson({ ...result, hook: options.hook ?? false, mcp: options.mcp ?? false, graphFirst: graphFirst ?? null, scope });
   } else {
     log(`Installed rules into ${result.target}`);
+    if (graphFirst) {
+      log(`Graph-first hook mode set to "${graphFirst}" in swarmvault.config.json.`);
+    } else if (options.hook) {
+      log('Hooks run in advisory mode by default; add --graph-first to opt in to search enforcement (hooks.graphFirst: "deny").');
+    }
     if (result.targets.length > 1) {
       log(`Also wrote: ${result.targets.filter((entry) => entry !== result.target).join(", ")}`);
     }

package/package.json CHANGED Viewed

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