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

@swarmvaultai/cli 3.17.0 → 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 +32 -11
package/package.json +2 -2

package/dist/index.js CHANGED Viewed

@@ -337,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.17.0";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "3.18.0";
   } catch {
-    return "3.17.0";
+    return "3.18.0";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -2490,24 +2490,24 @@ program.command("cluster-only", { hidden: true }).description("Compatibility ali
 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;
@@ -2614,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("--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) => {
+).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>.");
   }
@@ -2625,12 +2628,30 @@ install.option(
   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, mcp: options.mcp ?? 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, mcp: options.mcp ?? 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.17.0",
+  "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.17.0",
+    "@swarmvaultai/engine": "3.18.0",
     "commander": "^14.0.1"
   },
   "devDependencies": {