@hiveai/cli 0.9.29 → 0.9.31

package/dist/index.js

@@ -1213,12 +1213,14 @@ async function loadEmbeddings() {
 }
 
 // src/commands/index-code.ts
+import { existsSync as existsSync5, statSync } from "fs";
 import path5 from "path";
 import "commander";
 import {
   buildCodeMap as buildCodeMap2,
   codeMapPath,
   findProjectRoot as findProjectRoot5,
+  loadCodeMap as loadCodeMap4,
   resolveHaivePaths as resolveHaivePaths4,
   saveCodeMap as saveCodeMap2
 } from "@hiveai/core";
@@ -1228,14 +1230,18 @@ function registerIndexCode(program2) {
   );
   idx.action(() => idx.help());
   idx.command("code").description(
-    "Scan source files and write .ai/code-map.json (file \u2192 exports + 1-line description).\n\n  Supported languages: TypeScript, JavaScript, Java, Python, Go, Rust, C#, PHP.\n  The map is used by:\n    \u2022 get_briefing (symbol_locations) \u2014 look up where a class/function lives\n    \u2022 code_map MCP tool \u2014 browse exports without grepping\n    \u2022 haive briefing --symbols \u2014 look up symbols from the CLI\n\n  Run automatically by haive init (autopilot mode) and haive sync (if source changed).\n\n  Example:\n    haive index code\n    haive index code --exclude generated,proto\n"
+    "Scan source files and write .ai/code-map.json (file \u2192 exports + 1-line description).\n\n  Supported languages: TypeScript, JavaScript, Java, Python, Go, Rust, C#, PHP.\n  The map is used by:\n    \u2022 get_briefing (symbol_locations) \u2014 look up where a class/function lives\n    \u2022 code_map MCP tool \u2014 browse exports without grepping\n    \u2022 haive briefing --symbols \u2014 look up symbols from the CLI\n\n  Run automatically by haive init (autopilot mode) and haive sync (if source changed).\n\n  Example:\n    haive index code\n    haive index code --status        # report freshness without rebuilding\n    haive index code --exclude generated,proto\n"
   ).option("-d, --dir <dir>", "project root").option(
     "--exclude <csv>",
     "extra directory names to skip (comma-separated)",
     ""
-  ).action(async (opts) => {
+  ).option("--status", "report code-map / code-search index freshness without rebuilding").option("--json", "with --status, emit machine-readable JSON (for CI / agents)").action(async (opts) => {
     const root = findProjectRoot5(opts.dir);
     const paths = resolveHaivePaths4(root);
+    if (opts.status) {
+      await reportIndexStatus(root, paths, opts.json === true);
+      return;
+    }
     const extraExcludes = (opts.exclude ?? "").split(",").map((s) => s.trim()).filter(Boolean);
     ui.info(`Indexing source files in ${root}\u2026`);
     const map = await buildCodeMap2(root, {
@@ -1288,10 +1294,49 @@ function registerIndexCode(program2) {
     }
   });
 }
+async function reportIndexStatus(root, paths, asJson) {
+  const mapFile = codeMapPath(paths);
+  const map = existsSync5(mapFile) ? await loadCodeMap4(paths) : null;
+  const fileCount = map ? Object.keys(map.files).length : 0;
+  const exportCount = map ? Object.values(map.files).reduce((s, f) => s + f.exports.length, 0) : 0;
+  const mapMtime = existsSync5(mapFile) ? statSync(mapFile).mtime.toISOString() : null;
+  const searchIndexFile = path5.join(paths.haiveDir, ".cache", "embeddings", "code-embeddings-index.json");
+  const searchIndexPresent = existsSync5(searchIndexFile);
+  const status = {
+    code_map: {
+      present: map !== null,
+      path: path5.relative(root, mapFile),
+      files: fileCount,
+      exports: exportCount,
+      generated_at: map?.generated_at ?? null,
+      file_mtime: mapMtime
+    },
+    code_search_index: {
+      present: searchIndexPresent,
+      path: path5.relative(root, searchIndexFile)
+    }
+  };
+  if (asJson) {
+    console.log(JSON.stringify(status, null, 2));
+    if (!status.code_map.present) process.exitCode = 1;
+    return;
+  }
+  if (!status.code_map.present) {
+    ui.warn(`No code-map at ${status.code_map.path}. Run \`haive index code\`.`);
+    process.exitCode = 1;
+    return;
+  }
+  ui.info(
+    `code-map: ${fileCount} file(s), ${exportCount} export(s) \xB7 generated ${status.code_map.generated_at ?? "?"}`
+  );
+  ui.info(
+    status.code_search_index.present ? `code-search index: present (${status.code_search_index.path})` : `code-search index: missing \u2014 run \`haive index code-search\` for semantic code lookup.`
+  );
+}
 
 // src/commands/init.ts
 import { mkdir as mkdir5, readFile as readFile5, writeFile as writeFile6 } from "fs/promises";
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import path10 from "path";
 import { spawnSync as spawnSync3 } from "child_process";
 import "commander";
@@ -1305,7 +1350,7 @@ import {
 
 // src/commands/agent.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import { mkdir as mkdir3, writeFile as writeFile4 } from "fs/promises";
 import os2 from "os";
 import path7 from "path";
@@ -1315,7 +1360,7 @@ import { findProjectRoot as findProjectRoot6, resolveHaivePaths as resolveHaiveP
 
 // src/commands/init-mcp-setup.ts
 import { readFile as readFile3, writeFile as writeFile3, mkdir as mkdir2 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import path6 from "path";
 import os from "os";
 var HOME = os.homedir();
@@ -1336,9 +1381,9 @@ function cursorMcpPath() {
 async function configureCursor() {
   const mcpPath = cursorMcpPath();
   const cursorDir = path6.join(HOME, ".cursor");
-  if (!existsSync5(cursorDir)) return { client: "Cursor", status: "not_installed" };
+  if (!existsSync6(cursorDir)) return { client: "Cursor", status: "not_installed" };
   let config = {};
-  if (existsSync5(mcpPath)) {
+  if (existsSync6(mcpPath)) {
     try {
       config = JSON.parse(await readFile3(mcpPath, "utf8"));
     } catch {
@@ -1362,7 +1407,7 @@ function vscodeMcpPath() {
     path6.join(HOME, ".config", "Code - Insiders", "User", "mcp.json")
   ];
   for (const c of candidates) {
-    if (existsSync5(path6.dirname(c))) return c;
+    if (existsSync6(path6.dirname(c))) return c;
   }
   return null;
 }
@@ -1370,7 +1415,7 @@ async function configureVSCode() {
   const mcpPath = vscodeMcpPath();
   if (!mcpPath) return { client: "VS Code", status: "not_installed" };
   let config = {};
-  if (existsSync5(mcpPath)) {
+  if (existsSync6(mcpPath)) {
     try {
       config = JSON.parse(await readFile3(mcpPath, "utf8"));
     } catch {
@@ -1385,18 +1430,18 @@ async function configureVSCode() {
 }
 function claudeConfigPath() {
   const p = path6.join(HOME, ".claude.json");
-  if (existsSync5(p)) return p;
+  if (existsSync6(p)) return p;
   const p2 = path6.join(HOME, ".config", "claude", "claude.json");
-  if (existsSync5(path6.dirname(p2))) return p2;
+  if (existsSync6(path6.dirname(p2))) return p2;
   return null;
 }
 async function configureClaude() {
   const cfgPath = claudeConfigPath() ?? path6.join(HOME, ".claude.json");
-  if (!existsSync5(cfgPath) && !existsSync5(path6.join(HOME, ".claude"))) {
+  if (!existsSync6(cfgPath) && !existsSync6(path6.join(HOME, ".claude"))) {
     return { client: "Claude Code", status: "not_installed" };
   }
   let config = {};
-  if (existsSync5(cfgPath)) {
+  if (existsSync6(cfgPath)) {
     try {
       config = JSON.parse(await readFile3(cfgPath, "utf8"));
     } catch {
@@ -1414,7 +1459,7 @@ function windsurfMcpPath() {
     path6.join(HOME, ".windsurf", "mcp.json")
   ];
   for (const c of candidates) {
-    if (existsSync5(path6.dirname(c))) return c;
+    if (existsSync6(path6.dirname(c))) return c;
   }
   return null;
 }
@@ -1422,7 +1467,7 @@ async function configureWindsurf() {
   const mcpPath = windsurfMcpPath();
   if (!mcpPath) return { client: "Windsurf", status: "not_installed" };
   let config = {};
-  if (existsSync5(mcpPath)) {
+  if (existsSync6(mcpPath)) {
     try {
       config = JSON.parse(await readFile3(mcpPath, "utf8"));
     } catch {
@@ -1454,7 +1499,7 @@ async function configureProjectMcpClients(root) {
   try {
     const cursorPath = path6.join(root, ".cursor", "mcp.json");
     let config = {};
-    if (existsSync5(cursorPath)) {
+    if (existsSync6(cursorPath)) {
       try {
         config = JSON.parse(await readFile3(cursorPath, "utf8"));
       } catch {
@@ -1471,7 +1516,7 @@ async function configureProjectMcpClients(root) {
   try {
     const vscodePath = path6.join(root, ".vscode", "mcp.json");
     let config = {};
-    if (existsSync5(vscodePath)) {
+    if (existsSync6(vscodePath)) {
       try {
         config = JSON.parse(await readFile3(vscodePath, "utf8"));
       } catch {
@@ -1488,7 +1533,7 @@ async function configureProjectMcpClients(root) {
   try {
     const mcpPath = path6.join(root, ".mcp.json");
     let config = {};
-    if (existsSync5(mcpPath)) {
+    if (existsSync6(mcpPath)) {
       try {
         config = JSON.parse(await readFile3(mcpPath, "utf8"));
       } catch {
@@ -1562,9 +1607,9 @@ async function detectAgentMode(dir) {
   const root = findProjectRoot6(dir);
   const paths = resolveHaivePaths5(root);
   const projectMcp = [
-    { client: "Claude Code", path: path7.join(root, ".mcp.json"), present: existsSync6(path7.join(root, ".mcp.json")) },
-    { client: "Cursor", path: path7.join(root, ".cursor", "mcp.json"), present: existsSync6(path7.join(root, ".cursor", "mcp.json")) },
-    { client: "VS Code", path: path7.join(root, ".vscode", "mcp.json"), present: existsSync6(path7.join(root, ".vscode", "mcp.json")) }
+    { client: "Claude Code", path: path7.join(root, ".mcp.json"), present: existsSync7(path7.join(root, ".mcp.json")) },
+    { client: "Cursor", path: path7.join(root, ".cursor", "mcp.json"), present: existsSync7(path7.join(root, ".cursor", "mcp.json")) },
+    { client: "VS Code", path: path7.join(root, ".vscode", "mcp.json"), present: existsSync7(path7.join(root, ".vscode", "mcp.json")) }
   ];
   const installedAgents = [
     { agent: "Codex", command: "codex", installed: commandExists("codex"), mcp_configured: codexMcpConfigured() },
@@ -1579,7 +1624,7 @@ async function detectAgentMode(dir) {
   const recommendedCommand = recommendedMode === "mcp" ? "Restart your AI client, then call get_briefing before editing." : recommendedMode === "wrapped" && wrapperAgent ? `haive run -- ${wrapperAgent.command}` : 'haive briefing --task "..." --files "..."';
   return {
     root,
-    initialized: existsSync6(paths.haiveDir),
+    initialized: existsSync7(paths.haiveDir),
     project_mcp: projectMcp,
     installed_agents: installedAgents,
     recommended_mode: recommendedMode,
@@ -1686,7 +1731,7 @@ function printSetupResult(result) {
 
 // src/commands/init-bootstrap.ts
 import { readdir, readFile as readFile4 } from "fs/promises";
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8, readdirSync } from "fs";
 import path8 from "path";
 var IGNORE_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
@@ -1773,14 +1818,38 @@ function detectKeyDeps(allDeps) {
   return KEY_DEPS.filter((d) => allDeps[d] !== void 0);
 }
 function detectLanguage(root) {
-  if (existsSync7(path8.join(root, "tsconfig.json"))) return "TypeScript";
-  if (existsSync7(path8.join(root, "pyproject.toml")) || existsSync7(path8.join(root, "setup.py"))) return "Python";
-  if (existsSync7(path8.join(root, "go.mod"))) return "Go";
-  if (existsSync7(path8.join(root, "pom.xml")) || existsSync7(path8.join(root, "build.gradle"))) return "Java/Kotlin";
-  if (existsSync7(path8.join(root, "Cargo.toml"))) return "Rust";
-  if (existsSync7(path8.join(root, "package.json"))) return "JavaScript";
+  if (existsSync8(path8.join(root, "tsconfig.json"))) return "TypeScript";
+  if (existsSync8(path8.join(root, "pyproject.toml")) || existsSync8(path8.join(root, "setup.py"))) return "Python";
+  if (existsSync8(path8.join(root, "go.mod"))) return "Go";
+  if (existsSync8(path8.join(root, "pom.xml")) || existsSync8(path8.join(root, "build.gradle"))) return "Java/Kotlin";
+  if (existsSync8(path8.join(root, "Cargo.toml"))) return "Rust";
+  if (existsSync8(path8.join(root, "package.json"))) {
+    return hasSourceWithExt(root, [".ts", ".tsx", ".mts", ".cts"]) ? "TypeScript" : "JavaScript";
+  }
   return "Unknown";
 }
+function hasSourceWithExt(root, exts) {
+  const matches = (name) => !name.endsWith(".d.ts") && exts.some((ext) => name.endsWith(ext));
+  const scanDir = (dir, depth) => {
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return false;
+    }
+    for (const entry of entries) {
+      if (entry.isFile() && matches(entry.name)) return true;
+    }
+    if (depth <= 0) return false;
+    for (const entry of entries) {
+      if (entry.isDirectory() && !IGNORE_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
+        if (scanDir(path8.join(dir, entry.name), depth - 1)) return true;
+      }
+    }
+    return false;
+  };
+  return scanDir(root, 2);
+}
 function detectProjectType(frameworks, scripts, isMonorepo) {
   if (isMonorepo) {
     if (frameworks.includes("NestJS")) return "Monorepo (NestJS backend)";
@@ -1795,7 +1864,7 @@ function detectProjectType(frameworks, scripts, isMonorepo) {
   if (frameworks.includes("Express") || frameworks.includes("Fastify") || frameworks.includes("Hono")) return "Backend API";
   if (frameworks.includes("React") || frameworks.includes("Vue") || frameworks.includes("Svelte")) return "Frontend SPA";
   if (scripts["build"] && !scripts["dev"]) return "CLI tool / library";
-  if (existsSync7("pom.xml")) return "Java backend";
+  if (existsSync8("pom.xml")) return "Java backend";
   return "Application";
 }
 async function scanDirs(root, maxDepth = 2) {
@@ -1931,7 +2000,7 @@ function readmeExcerpt(readme) {
 async function generateBootstrapContext(root) {
   let pkg = {};
   const pkgPath = path8.join(root, "package.json");
-  if (existsSync7(pkgPath)) {
+  if (existsSync8(pkgPath)) {
     try {
       pkg = JSON.parse(await readFile4(pkgPath, "utf8"));
     } catch {
@@ -1948,7 +2017,7 @@ async function generateBootstrapContext(root) {
   let readmeSummary = "";
   for (const name of ["README.md", "readme.md", "README"]) {
     const p = path8.join(root, name);
-    if (existsSync7(p)) {
+    if (existsSync8(p)) {
       try {
         const content = await readFile4(p, "utf8");
         readmeSummary = readmeExcerpt(content);
@@ -2015,7 +2084,7 @@ async function generateBootstrapContext(root) {
 
 // src/commands/init-stack-packs.ts
 import { mkdir as mkdir4, writeFile as writeFile5 } from "fs/promises";
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 import path9 from "path";
 import {
   buildFrontmatter,
@@ -2643,7 +2712,7 @@ async function seedStackPack(haivePaths, stack) {
       tags: [...mem.tags, STACK_PACK_TAG]
     });
     const filePath = memoryFilePath(haivePaths, "team", fm.id);
-    if (existsSync8(filePath)) continue;
+    if (existsSync9(filePath)) continue;
     const content = serializeMemory2({ frontmatter: fm, body: `${mem.body}
 
 ${SEED_FOOTER(stack)}` });
@@ -2867,7 +2936,7 @@ function registerInit(program2) {
     const autopilot = opts.manual !== true;
     const wantBootstrap = opts.bootstrap === void 0 ? autopilot : opts.bootstrap;
     const wantStack = opts.stack === void 0 ? autopilot ? "auto" : void 0 : opts.stack === "none" ? void 0 : opts.stack;
-    if (existsSync9(paths.haiveDir)) {
+    if (existsSync10(paths.haiveDir)) {
       ui.warn(`.ai/ already exists at ${paths.haiveDir} \u2014 leaving existing files in place.`);
     }
     await mkdir5(paths.personalDir, { recursive: true });
@@ -2876,7 +2945,7 @@ function registerInit(program2) {
     await mkdir5(paths.modulesContextDir, { recursive: true });
     await ensureAiRuntimeLayout(paths.runtimeDir);
     await ensureAiCacheLayout(path10.join(paths.haiveDir, ".cache"));
-    if (!existsSync9(paths.projectContext)) {
+    if (!existsSync10(paths.projectContext)) {
       if (wantBootstrap) {
         ui.info("Bootstrapping project context from local files\u2026");
         try {
@@ -2892,7 +2961,7 @@ function registerInit(program2) {
         ui.success(`Created ${path10.relative(root, paths.projectContext)}`);
       }
     }
-    const configExists = existsSync9(
+    const configExists = existsSync10(
       path10.join(paths.haiveDir, "haive.config.json")
     );
     if (!configExists) {
@@ -2931,7 +3000,7 @@ function registerInit(program2) {
     const wantCi = opts.withCi || autopilot;
     if (wantCi) {
       const ciPath = path10.join(root, ".github", "workflows", "haive-sync.yml");
-      if (existsSync9(ciPath)) {
+      if (existsSync10(ciPath)) {
         ui.info("CI workflow already exists \u2014 skipped");
       } else {
         await mkdir5(path10.dirname(ciPath), { recursive: true });
@@ -2980,8 +3049,8 @@ function registerInit(program2) {
         else if (r.status === "error") ui.warn(`${r.client}: ${r.error}`);
       }
       for (const r of agentSetup.global_results) {
-        if (r.status === "configured") ui.success(`haive MCP configured in ${r.client}${r.path ? ` (${r.path})` : ""}`);
-        else if (r.status === "already_configured") ui.info(`haive MCP already configured in ${r.client} \u2014 skipped`);
+        if (r.status === "configured") ui.success(`haive MCP configured in ${r.client} user-level config${r.path ? ` (${r.path})` : ""}`);
+        else if (r.status === "already_configured") ui.info(`haive MCP already present in ${r.client} user-level config \u2014 left unchanged (this project's config was written above)`);
       }
       if (agentSetup.global_skipped_reason) ui.warn(agentSetup.global_skipped_reason);
       ui.info(`Recommended agent mode: ${agentSetup.detection.recommended_mode}`);
@@ -3048,7 +3117,7 @@ async function resolveStacksToSeed(root, stackOpt) {
   if (!stackOpt) return [];
   if (stackOpt === "auto") {
     const pkgPath = path10.join(root, "package.json");
-    if (!existsSync9(pkgPath)) return [];
+    if (!existsSync10(pkgPath)) return [];
     try {
       const pkg = JSON.parse(await readFile5(pkgPath, "utf8"));
       const allDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
@@ -3062,7 +3131,7 @@ async function resolveStacksToSeed(root, stackOpt) {
 async function writeCursorHaiveRule(root) {
   const relPath = ".cursor/rules/haive-mcp-required.mdc";
   const target = path10.join(root, relPath);
-  if (existsSync9(target)) {
+  if (existsSync10(target)) {
     ui.info(`Cursor rule ${relPath} already exists \u2014 skipped`);
     return;
   }
@@ -3072,7 +3141,7 @@ async function writeCursorHaiveRule(root) {
 }
 async function writeBridge(root, relPath) {
   const target = path10.join(root, relPath);
-  if (existsSync9(target)) {
+  if (existsSync10(target)) {
     ui.info(`Bridge ${relPath} already exists \u2014 skipped`);
     return;
   }
@@ -3095,18 +3164,18 @@ var RUNTIME_GITIGNORE_BODY = `*
 async function ensureAiRuntimeLayout(runtimeDir) {
   await mkdir5(runtimeDir, { recursive: true });
   const gi = path10.join(runtimeDir, ".gitignore");
-  if (!existsSync9(gi)) {
+  if (!existsSync10(gi)) {
     await writeFile6(gi, RUNTIME_GITIGNORE_BODY, "utf8");
   }
   const readme = path10.join(runtimeDir, "README.md");
-  if (!existsSync9(readme)) {
+  if (!existsSync10(readme)) {
     await writeFile6(readme, RUNTIME_README_BODY, "utf8");
   }
 }
 async function ensureAiCacheLayout(cacheDir) {
   await mkdir5(cacheDir, { recursive: true });
   const gi = path10.join(cacheDir, ".gitignore");
-  if (!existsSync9(gi)) {
+  if (!existsSync10(gi)) {
     await writeFile6(gi, "*\n!.gitignore\n", "utf8");
   }
 }
@@ -3114,7 +3183,7 @@ async function ensureGitignoreEntries(root, patterns) {
   try {
     const gitignorePath = path10.join(root, ".gitignore");
     let existing = "";
-    if (existsSync9(gitignorePath)) {
+    if (existsSync10(gitignorePath)) {
       existing = await readFile5(gitignorePath, "utf8");
     }
     const lines = existing.split("\n");
@@ -3128,13 +3197,13 @@ async function ensureGitignoreEntries(root, patterns) {
 
 // src/commands/install-hooks.ts
 import { mkdir as mkdir7, writeFile as writeFile8, chmod, readFile as readFile7 } from "fs/promises";
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import path12 from "path";
 import "commander";
 import { findProjectRoot as findProjectRoot8 } from "@hiveai/core";
 
 // src/utils/claude-hooks.ts
-import { existsSync as existsSync10 } from "fs";
+import { existsSync as existsSync11 } from "fs";
 import { mkdir as mkdir6, readFile as readFile6, writeFile as writeFile7 } from "fs/promises";
 import path11 from "path";
 var HAIVE_HOOK_TAG = "haive-enforcement";
@@ -3222,7 +3291,7 @@ function unpatchClaudeSettings(input) {
 async function installClaudeHooksAtPath(settingsPath) {
   let raw = null;
   let created = false;
-  if (existsSync10(settingsPath)) {
+  if (existsSync11(settingsPath)) {
     try {
       raw = JSON.parse(await readFile6(settingsPath, "utf8"));
     } catch {
@@ -3237,7 +3306,7 @@ async function installClaudeHooksAtPath(settingsPath) {
   return { settingsPath, created };
 }
 async function uninstallClaudeHooksAtPath(settingsPath) {
-  if (!existsSync10(settingsPath)) {
+  if (!existsSync11(settingsPath)) {
     return { settingsPath, created: false };
   }
   const raw = JSON.parse(await readFile6(settingsPath, "utf8"));
@@ -3308,7 +3377,7 @@ fi
 async function installGitHooks(opts) {
   const root = findProjectRoot8(opts.dir);
   const gitDir = path12.join(root, ".git");
-  if (!existsSync11(gitDir)) {
+  if (!existsSync12(gitDir)) {
     ui.error(`No .git directory at ${root}.`);
     process.exitCode = 1;
     return;
@@ -3319,7 +3388,7 @@ async function installGitHooks(opts) {
   let skipped = 0;
   for (const { name, body } of HOOKS) {
     const file = path12.join(hooksDir, name);
-    if (existsSync11(file) && !opts.force) {
+    if (existsSync12(file) && !opts.force) {
       const existing = await readFile7(file, "utf8");
       if (!existing.includes(HOOK_MARKER)) {
         ui.warn(`${name} already exists and was not written by hAIve. Re-run with --force to overwrite.`);
@@ -3383,7 +3452,7 @@ function registerInstallHooks(program2) {
 
 // src/commands/observe.ts
 import { appendFile, mkdir as mkdir8 } from "fs/promises";
-import { existsSync as existsSync12 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import path13 from "path";
 import "commander";
 import { findProjectRoot as findProjectRoot9, resolveHaivePaths as resolveHaivePaths7 } from "@hiveai/core";
@@ -3484,7 +3553,7 @@ function registerObserve(program2) {
       })();
       if (!root) return;
       const paths = resolveHaivePaths7(root);
-      if (!existsSync12(paths.haiveDir)) return;
+      if (!existsSync13(paths.haiveDir)) return;
       const failureHint = detectFailure(payload);
       const observation = {
         ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -3516,7 +3585,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { findProjectRoot as findProjectRoot10, resolveHaivePaths as resolveHaivePaths8 } from "@hiveai/core";
 import { mkdir as mkdir9, writeFile as writeFile9 } from "fs/promises";
-import { existsSync as existsSync13 } from "fs";
+import { existsSync as existsSync14 } from "fs";
 import path14 from "path";
 import { z } from "zod";
 import { readFile as readFile8, readdir as readdir2 } from "fs/promises";
@@ -3619,7 +3688,7 @@ import {
 } from "@hiveai/core";
 import { z as z13 } from "zod";
 import { mkdir as mkdir32, writeFile as writeFile72 } from "fs/promises";
-import { existsSync as existsSync14 } from "fs";
+import { existsSync as existsSync142 } from "fs";
 import path52 from "path";
 import {
   buildFrontmatter as buildFrontmatter22,
@@ -3672,7 +3741,7 @@ import {
   isStackPackSeed as isStackPackSeed2,
   literalMatchesAllTokens as literalMatchesAllTokens22,
   literalMatchesAnyToken as literalMatchesAnyToken22,
-  loadCodeMap as loadCodeMap4,
+  loadCodeMap as loadCodeMap5,
   loadConfig as loadConfig3,
   loadMemoriesFromDir as loadMemoriesFromDir13,
   loadUsageIndex as loadUsageIndex7,
@@ -3795,7 +3864,7 @@ var BootstrapProjectSaveInputSchema = {
 };
 async function bootstrapProjectSave(input, ctx) {
   const target = input.module ? path14.join(ctx.paths.modulesContextDir, input.module, "context.md") : ctx.paths.projectContext;
-  const exists = existsSync13(target);
+  const exists = existsSync14(target);
   if (exists && !input.overwrite) {
     throw new Error(
       `${target} already exists. Pass overwrite=true to replace it.`
@@ -4675,7 +4744,7 @@ var MemTriedInputSchema = {
   author: z14.string().optional().describe("Author handle or email")
 };
 async function memTried(input, ctx) {
-  if (!existsSync14(ctx.paths.haiveDir)) {
+  if (!existsSync142(ctx.paths.haiveDir)) {
     throw new Error(`No .ai/ directory at ${ctx.paths.root}. Run 'haive init' first.`);
   }
   const slug = input.what.toLowerCase().replace(/[^a-z0-9\s]/g, "").trim().split(/\s+/).slice(0, 5).join("-");
@@ -4697,7 +4766,7 @@ async function memTried(input, ctx) {
   const body = lines.join("\n") + "\n";
   const file = memoryFilePath22(ctx.paths, frontmatter.scope, frontmatter.id, frontmatter.module);
   await mkdir32(path52.dirname(file), { recursive: true });
-  if (existsSync14(file)) {
+  if (existsSync142(file)) {
     throw new Error(`Memory already exists at ${file}`);
   }
   await writeFile72(file, serializeMemory6({ frontmatter, body }), "utf8");
@@ -5189,7 +5258,7 @@ async function getBriefing(input, ctx) {
   if ((isTemplateContext || !existsSync18(ctx.paths.projectContext)) && input.include_project_context) {
     const haiveConfig = await loadConfig3(ctx.paths);
     if (haiveConfig.autoContext) {
-      const codeMap = await loadCodeMap4(ctx.paths);
+      const codeMap = await loadCodeMap5(ctx.paths);
       if (codeMap) {
         const totalFiles = Object.keys(codeMap.files).length;
         const extensions = /* @__PURE__ */ new Map();
@@ -5317,7 +5386,7 @@ ${m.content}`).join("\n\n---\n\n"),
     }
   }
   if (symbolsToLookup.size > 0) {
-    const codeMap = await loadCodeMap4(ctx.paths);
+    const codeMap = await loadCodeMap5(ctx.paths);
     if (codeMap) {
       symbolLocations = [];
       for (const sym of symbolsToLookup) {
@@ -5944,6 +6013,58 @@ var AntiPatternsCheckInputSchema = {
     "When true, also use semantic search (requires @hiveai/embeddings + memory index) to find related anti-patterns."
   )
 };
+var CODE_STOPWORDS = /* @__PURE__ */ new Set([
+  "import",
+  "export",
+  "function",
+  "return",
+  "const",
+  "let",
+  "var",
+  "class",
+  "public",
+  "private",
+  "protected",
+  "static",
+  "this",
+  "true",
+  "false",
+  "null",
+  "undefined",
+  "void",
+  "async",
+  "await",
+  "from",
+  "type",
+  "interface",
+  "extends",
+  "implements",
+  "number",
+  "string",
+  "boolean",
+  "value",
+  "default",
+  "case",
+  "break",
+  "continue",
+  "throw",
+  "catch",
+  "finally",
+  "else",
+  "while",
+  "for",
+  "new",
+  "super",
+  "yield",
+  "module",
+  "require",
+  "console"
+]);
+function tokenizeDiffForLiteral(diff) {
+  const wsTokens = tokenizeQuery3(diff);
+  const wordTokens = diff.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 4 && !CODE_STOPWORDS.has(t));
+  return [.../* @__PURE__ */ new Set([...wsTokens, ...wordTokens])];
+}
 async function antiPatternsCheck(input, ctx) {
   if (!input.diff && input.paths.length === 0) {
     return {
@@ -5997,7 +6118,7 @@ async function antiPatternsCheck(input, ctx) {
     }
   }
   if (input.diff) {
-    const tokens = tokenizeQuery3(input.diff);
+    const tokens = tokenizeDiffForLiteral(input.diff);
     if (tokens.length > 0) {
       for (const { memory: memory2 } of negative) {
         if (literalMatchesAnyToken3(memory2, tokens)) {
@@ -6450,7 +6571,10 @@ var PreCommitCheckInputSchema = {
   block_on: z28.enum(["any", "high-confidence", "never"]).default("high-confidence").describe(
     "When to set should_block=true: 'any' = any warning blocks; 'high-confidence' = only warnings from authoritative/trusted memories block; 'never' = report only, never block."
   ),
-  semantic: z28.boolean().default(true).describe("Enable semantic search in anti_patterns_check (requires embeddings index).")
+  semantic: z28.boolean().default(true).describe("Enable semantic search in anti_patterns_check (requires embeddings index)."),
+  anchored_blocks: z28.boolean().default(false).describe(
+    "When true, ALSO block a high-confidence anti-pattern (attempt/gotcha) that is anchored to a touched file AND corroborated by the diff (literal token overlap, or semantic >= 0.45) \u2014 not just very strong semantic matches. Powers the 'anchored' enforcement gate. Config/docs-only commits are still downgraded. Default false preserves the soft, semantic-only blocking behavior."
+  )
 };
 async function preCommitCheck(input, ctx) {
   if (!input.diff && input.paths.length === 0) {
@@ -6475,7 +6599,7 @@ async function preCommitCheck(input, ctx) {
   const filesTouching = new Set(relevantMatches.map((m) => m.id));
   const staleHits = verifyResult.results.filter((r) => r.stale && filesTouching.has(r.id));
   const blockOn = input.block_on;
-  const classifiedWarnings = apResult.warnings.map((warning) => classifyWarning(warning, input.paths));
+  const classifiedWarnings = apResult.warnings.map((warning) => classifyWarning(warning, input.paths, input.anchored_blocks));
   const blockingWarnings = classifiedWarnings.filter((w) => w.level === "blocking");
   const reviewWarnings = classifiedWarnings.filter((w) => w.level === "review");
   const infoWarnings = classifiedWarnings.filter((w) => w.level === "info");
@@ -6515,7 +6639,7 @@ async function preCommitCheck(input, ctx) {
     })
   };
 }
-function classifyWarning(warning, paths) {
+function classifyWarning(warning, paths, anchoredBlocks = false) {
   const affectedFiles = paths.filter((p) => !p.startsWith(".ai/.usage/"));
   const repairCommand = repairCommandForWarning(warning, affectedFiles);
   const fileDowngrade = fileTypeDowngradeReason(warning, affectedFiles);
@@ -6540,6 +6664,15 @@ function classifyWarning(warning, paths) {
   const hasSemantic = warning.reasons.includes("semantic");
   const semanticScore = warning.semantic_score ?? 0;
   const highConfidence = warning.confidence === "authoritative" || warning.confidence === "trusted";
+  if (anchoredBlocks && highConfidence && warning.reasons.includes("anchor") && (warning.reasons.includes("literal") || hasSemantic && semanticScore >= 0.45)) {
+    return {
+      ...warning,
+      level: "blocking",
+      rationale: "high-confidence anti-pattern anchored to a touched file and corroborated by the diff (anchored gate)",
+      affected_files: affectedFiles,
+      repair_command: repairCommand
+    };
+  }
   if (hasSemantic && semanticScore >= 0.45 || highConfidence && warning.reasons.includes("anchor") && warning.reasons.includes("literal")) {
     return {
       ...warning,
@@ -7190,7 +7323,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.29";
+var SERVER_VERSION = "0.9.31";
 function jsonResult(data) {
   return {
     content: [
@@ -8172,7 +8305,7 @@ import {
   isAutoPromoteEligible as isAutoPromoteEligible2,
   isDecaying as isDecaying2,
   isStackPackSeed as isStackPackSeed3,
-  loadCodeMap as loadCodeMap5,
+  loadCodeMap as loadCodeMap6,
   loadConfig as loadConfig4,
   loadMemoriesFromDir as loadMemoriesFromDir23,
   loadUsageIndex as loadUsageIndex12,
@@ -8543,7 +8676,7 @@ Attends une **confirmation explicite** avant d'agir.
         ui.warn(`contract watcher failed: ${String(err)}`);
       }
     }
-    const existingMap = await loadCodeMap5(paths);
+    const existingMap = await loadCodeMap6(paths);
     if (!dryRun && !existingMap && (config.autopilot || autoRepair.codeMap)) {
       try {
         const { buildCodeMap: buildCodeMap4, saveCodeMap: saveCodeMap4 } = await import("@hiveai/core");
@@ -8737,7 +8870,7 @@ function registerMemoryAdd(memory2) {
     haive memory add --type convention --slug flyway-no-modify --topic flyway \\\\
       --scope team --body "Never modify existing migrations. Create V{n+1}__desc.sql."
 `
-  ).requiredOption("--type <type>", "skill | convention | decision | gotcha | architecture | glossary | attempt").option("--slug <slug>", "short kebab-case identifier used in the file name (auto-derived from --title/--body when omitted)").option("--title <text>", "memory title \u2014 becomes the first heading of the body").option("--scope <scope>", "personal | team | module (default: config default; team in autopilot)").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags for easier retrieval").option("--domain <domain>", "domain (e.g. transactions)").option("--author <author>", "author email or handle").option("--paths <csv>", "anchor to source files \u2014 used for staleness detection by haive sync").option("--symbols <csv>", "anchor to specific symbols (class/function names)").option("--commit <sha>", "anchor to a specific commit SHA").option("--body <text>", "memory body content (Markdown) \u2014 overrides --title default body").option("--body-file <path>", "read memory body from a Markdown file \u2014 for long content").option("--no-auto-tag", "disable automatic tag suggestions inferred from anchor paths").option("--topic <key>", "stable key for upsert: if a memory with this topic+scope already exists, update it in-place (revision_count++)").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  ).requiredOption("--type <type>", "skill | convention | decision | gotcha | architecture | glossary | attempt").option("--slug <slug>", "short kebab-case identifier used in the file name (auto-derived from --title/--body when omitted)").option("--title <text>", "memory title \u2014 becomes the first heading of the body").option("--scope <scope>", "personal | team | module (default: config default; team in autopilot)").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags for easier retrieval").option("--domain <domain>", "domain (e.g. transactions)").option("--author <author>", "author email or handle").option("--paths <csv>", "anchor to source files \u2014 used for staleness detection by haive sync").option("--files <csv>", "alias for --paths (matches the MCP `files` parameter)").option("--symbols <csv>", "anchor to specific symbols (class/function names)").option("--commit <sha>", "anchor to a specific commit SHA").option("--body <text>", "memory body content (Markdown) \u2014 overrides --title default body").option("--body-file <path>", "read memory body from a Markdown file \u2014 for long content").option("--no-auto-tag", "disable automatic tag suggestions inferred from anchor paths").option("--topic <key>", "stable key for upsert: if a memory with this topic+scope already exists, update it in-place (revision_count++)").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot13(opts.dir);
     const paths = resolveHaivePaths10(root);
     if (!existsSync30(paths.haiveDir)) {
@@ -8747,7 +8880,7 @@ function registerMemoryAdd(memory2) {
     }
     const config = await loadConfig5(paths);
     const userTags = parseCsv2(opts.tags);
-    const anchorPaths = parseCsv2(opts.paths);
+    const anchorPaths = parseCsv2(opts.paths ?? opts.files);
     const autoTagsEnabled = opts.autoTag !== false;
     const inferredTags = autoTagsEnabled ? inferModulesFromPaths3(anchorPaths) : [];
     const mergedTags = Array.from(/* @__PURE__ */ new Set([...userTags, ...inferredTags]));
@@ -9156,7 +9289,7 @@ import {
   serializeMemory as serializeMemory15
 } from "@hiveai/core";
 function registerMemoryUpdate(memory2) {
-  memory2.command("update <id>").description("Update body, tags, or anchor of an existing memory (preserves id and usage history)").option("--type <type>", "change the memory type (convention | decision | gotcha | architecture | glossary | skill | attempt)").option("--title <text>", "new title \u2014 replaces the first heading of the body").option("--body <text>", "new Markdown body \u2014 replaces the existing body").option("--body-file <path>", "read new body from a Markdown file \u2014 for long content").option("--tags <csv>", "new tags, comma-separated \u2014 fully replaces existing tags").option("--paths <csv>", "new anchor paths, comma-separated").option("--symbols <csv>", "new anchor symbols, comma-separated").option("--commit <sha>", "new anchor commit SHA").option("--domain <domain>", "new domain label").option("--author <author>", "new author handle or email").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
+  memory2.command("update <id>").description("Update body, tags, or anchor of an existing memory (preserves id and usage history)").option("--type <type>", "change the memory type (convention | decision | gotcha | architecture | glossary | skill | attempt)").option("--title <text>", "new title \u2014 replaces the first heading of the body").option("--body <text>", "new Markdown body \u2014 replaces the existing body").option("--body-file <path>", "read new body from a Markdown file \u2014 for long content").option("--tags <csv>", "new tags, comma-separated \u2014 fully replaces existing tags").option("--paths <csv>", "new anchor paths, comma-separated").option("--files <csv>", "alias for --paths (matches the MCP `files` parameter)").option("--symbols <csv>", "new anchor symbols, comma-separated").option("--commit <sha>", "new anchor commit SHA").option("--domain <domain>", "new domain label").option("--author <author>", "new author handle or email").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
     const root = findProjectRoot17(opts.dir);
     const paths = resolveHaivePaths14(root);
     if (!existsSync35(paths.memoriesDir)) {
@@ -9174,8 +9307,9 @@ function registerMemoryUpdate(memory2) {
     const updated = [];
     const { frontmatter, body } = loaded.memory;
     const newAnchor = { ...frontmatter.anchor };
-    if (opts.paths !== void 0) {
-      newAnchor.paths = parseCsv3(opts.paths);
+    const pathsOpt = opts.paths ?? opts.files;
+    if (pathsOpt !== void 0) {
+      newAnchor.paths = parseCsv3(pathsOpt);
       updated.push("anchor.paths");
     }
     if (opts.symbols !== void 0) {
@@ -9570,7 +9704,7 @@ function registerMemoryTried(memory2) {
       --instead "use static import in the entry file" \\\\
       --paths packages/cli/src/index.ts
 `
-  ).requiredOption("--what <text>", "what approach was tried (short, descriptive title)").requiredOption("--why-failed <text>", "why it failed or should NOT be used (include the exact error if possible)").option("--instead <text>", "the correct approach to use instead").option("--scope <scope>", "personal | team | module", "personal").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags").option("--paths <csv>", "anchor paths, comma-separated").option("--author <author>", "author email or handle").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  ).requiredOption("--what <text>", "what approach was tried (short, descriptive title)").requiredOption("--why-failed <text>", "why it failed or should NOT be used (include the exact error if possible)").option("--instead <text>", "the correct approach to use instead").option("--scope <scope>", "personal | team | module", "personal").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags").option("--paths <csv>", "anchor paths, comma-separated").option("--files <csv>", "alias for --paths (matches the MCP `files` parameter)").option("--author <author>", "author email or handle").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot22(opts.dir);
     const paths = resolveHaivePaths19(root);
     if (!existsSync40(paths.haiveDir)) {
@@ -9585,7 +9719,7 @@ function registerMemoryTried(memory2) {
       scope: opts.scope,
       module: opts.module,
       tags: parseCsv4(opts.tags),
-      paths: parseCsv4(opts.paths),
+      paths: parseCsv4(opts.paths ?? opts.files),
       author: opts.author
     });
     const frontmatter = { ...baseFm, status: "validated" };
@@ -10075,44 +10209,64 @@ import {
 function registerMemoryVerify(memory2) {
   memory2.command("verify").description(
     "Check that memory anchor paths still exist in the current codebase.\n\n  A memory is 'stale' when its anchored file or symbol was moved, deleted, or renamed.\n  Stale memories are shown with a warning in get_briefing and should be updated or deleted.\n\n  haive sync runs this automatically. Use this command for on-demand checks or in CI.\n\n  CI recommendation: add 'haive memory verify' to your haive-sync.yml PR check job\n  to catch stale memories before they reach main.\n\n  Examples:\n    haive memory verify                          # check all, report only\n    haive memory verify --update                 # mark stale/fresh on disk\n    haive memory verify --id 2026-04-28-gotcha-x # check one memory\n"
-  ).option("--id <id>", "verify a single memory by id").option("--all", "verify every memory (default if --id is omitted)").option("--update", "write status=stale or status=validated back to disk").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  ).option("--id <id>", "verify a single memory by id").option("--all", "verify every memory (default if --id is omitted)").option("--update", "write status=stale or status=validated back to disk").option("--json", "emit machine-readable JSON (for CI / agents)").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot30(opts.dir);
     const paths = resolveHaivePaths27(root);
     if (!existsSync49(paths.memoriesDir)) {
-      ui.error(`No .ai/memories at ${root}. Run \`haive init\` first.`);
+      if (opts.json) {
+        console.log(JSON.stringify({ error: "not-initialized", root }, null, 2));
+      } else {
+        ui.error(`No .ai/memories at ${root}. Run \`haive init\` first.`);
+      }
       process.exitCode = 1;
       return;
     }
     const all = await loadMemoriesFromDir25(paths.memoriesDir);
     const targets = opts.id ? all.filter((m) => m.memory.frontmatter.id === opts.id) : all;
     if (opts.id && targets.length === 0) {
-      ui.error(`No memory with id "${opts.id}".`);
+      if (opts.json) {
+        console.log(JSON.stringify({ error: "not-found", id: opts.id }, null, 2));
+      } else {
+        ui.error(`No memory with id "${opts.id}".`);
+      }
       process.exitCode = 1;
       return;
     }
     let staleCount = 0;
     let freshCount = 0;
     const anchorlessIds = [];
+    const entries = [];
     let updated = 0;
     for (const { memory: mem, filePath } of targets) {
       const result = await verifyAnchor3(mem, { projectRoot: root });
       const isAnchored = mem.frontmatter.anchor.paths.length > 0 || mem.frontmatter.anchor.symbols.length > 0;
+      const rel = path34.relative(root, filePath);
       if (!isAnchored) {
         anchorlessIds.push(mem.frontmatter.id);
+        entries.push({ id: mem.frontmatter.id, status: "anchorless", path: rel });
         continue;
       }
-      const rel = path34.relative(root, filePath);
       if (result.stale) {
         staleCount++;
-        console.log(`${ui.bold("STALE")}  ${mem.frontmatter.id}`);
-        console.log(`       ${ui.dim(rel)}`);
-        console.log(`       ${result.reason}`);
-        if (result.possibleRenames.length > 0) {
-          console.log(`       ${ui.yellow("Possible renames:")} ${result.possibleRenames.join(", ")}`);
+        entries.push({
+          id: mem.frontmatter.id,
+          status: "stale",
+          path: rel,
+          reason: result.reason ?? void 0,
+          possible_renames: result.possibleRenames
+        });
+        if (!opts.json) {
+          console.log(`${ui.bold("STALE")}  ${mem.frontmatter.id}`);
+          console.log(`       ${ui.dim(rel)}`);
+          console.log(`       ${result.reason}`);
+          if (result.possibleRenames.length > 0) {
+            console.log(`       ${ui.yellow("Possible renames:")} ${result.possibleRenames.join(", ")}`);
+          }
         }
       } else {
         freshCount++;
-        console.log(`${ui.dim("fresh")}  ${mem.frontmatter.id}`);
+        entries.push({ id: mem.frontmatter.id, status: "fresh", path: rel });
+        if (!opts.json) console.log(`${ui.dim("fresh")}  ${mem.frontmatter.id}`);
       }
       if (opts.update) {
         const next = applyVerification2(mem, result);
@@ -10120,6 +10274,20 @@ function registerMemoryVerify(memory2) {
         updated++;
       }
     }
+    if (opts.json) {
+      console.log(JSON.stringify({
+        summary: {
+          checked: freshCount + staleCount,
+          fresh: freshCount,
+          stale: staleCount,
+          anchorless: anchorlessIds.length,
+          updated
+        },
+        results: entries
+      }, null, 2));
+      if (staleCount > 0) process.exitCode = 1;
+      return;
+    }
     const summary = [
       `${freshCount} fresh`,
       `${staleCount} stale`,
@@ -11982,7 +12150,7 @@ function parseDays(input) {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync61, statSync } from "fs";
+import { existsSync as existsSync61, statSync as statSync2 } from "fs";
 import { readFile as readFile20, stat, writeFile as writeFile31 } from "fs/promises";
 import path45 from "path";
 import { execFileSync, execSync as execSync3 } from "child_process";
@@ -11991,7 +12159,7 @@ import {
   codeMapPath as codeMapPath2,
   findProjectRoot as findProjectRoot42,
   getUsage as getUsage19,
-  loadCodeMap as loadCodeMap6,
+  loadCodeMap as loadCodeMap7,
   loadConfig as loadConfig10,
   loadMemoriesFromDir as loadMemoriesFromDir33,
   loadUsageIndex as loadUsageIndex25,
@@ -12140,7 +12308,7 @@ function registerDoctor(program2) {
         fix: "haive memory lint --fix --apply"
       });
     }
-    const codeMap = await loadCodeMap6(paths);
+    const codeMap = await loadCodeMap7(paths);
     if (!codeMap) {
       findings.push({
         severity: "warn",
@@ -12227,14 +12395,14 @@ function registerDoctor(program2) {
         fix: "Edit .ai/haive.config.json: set autoSessionEnd: true (or re-run `haive init` without --manual)."
       });
     }
-    findings.push(...await collectInstallFindings(root, "0.9.29"));
+    findings.push(...await collectInstallFindings(root, "0.9.31"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.29";
+      const cliVersion = "0.9.31";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -12685,7 +12853,7 @@ function extractAbsoluteHaiveBins(text) {
     const p = match[2];
     if (!p) continue;
     try {
-      if (statSync(p).isDirectory()) continue;
+      if (statSync2(p).isDirectory()) continue;
     } catch {
     }
     out.add(p);
@@ -12814,7 +12982,9 @@ function truncate3(text, max) {
 import { spawn as spawn5 } from "child_process";
 import "commander";
 import {
+  antiPatternGateParams,
   findProjectRoot as findProjectRoot44,
+  loadConfig as loadConfig11,
   resolveHaivePaths as resolveHaivePaths40
 } from "@hiveai/core";
 function registerPrecommit(program2) {
@@ -12822,12 +12992,19 @@ function registerPrecommit(program2) {
     "Run a pre-commit safety check: scans `git diff --cached` against known anti-patterns,\n  surfaces conventions/decisions anchored to touched files, and warns about stale anchored memories.\n\n  Wire it into git as: `.git/hooks/pre-commit` running `haive precommit` (exit 1 = block).\n\n  Examples:\n    haive precommit                                # auto-detects staged diff\n    haive precommit --block-on any                 # block on any warning, not just high-confidence\n    haive precommit --paths src/auth.ts src/db.ts  # explicit paths instead of git diff"
   ).option(
     "--block-on <mode>",
-    "'any' | 'high-confidence' (default) | 'never' (report only)",
-    "high-confidence"
-  ).option("--no-semantic", "disable semantic search in anti-patterns matching").option("--json", "emit JSON instead of human-readable output", false).option("--paths <paths...>", "explicit paths to check (skips git diff)").option("-d, --dir <dir>", "project root").action(async (opts) => {
+    "'any' | 'high-confidence' | 'never' (report only). Default: derived from enforcement.antiPatternGate."
+  ).option("--no-semantic", "disable semantic search in anti-patterns matching").option(
+    "--no-anchored-blocks",
+    "do not block on anchored, diff-corroborated anti-patterns (only block on very strong semantic matches)"
+  ).option("--json", "emit JSON instead of human-readable output", false).option("--paths <paths...>", "explicit paths to check (skips git diff)").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot44(opts.dir);
     const paths = resolveHaivePaths40(root);
     const ctx = { paths };
+    const config = await loadConfig11(paths);
+    const gate = config.enforcement?.antiPatternGate ?? "anchored";
+    const gateParams = antiPatternGateParams(gate);
+    const blockOn = opts.blockOn ?? gateParams.block_on;
+    const anchoredBlocks = opts.anchoredBlocks === false ? false : gateParams.anchored_blocks;
     let diff = "";
     let touchedPaths = opts.paths ?? [];
     if (touchedPaths.length === 0) {
@@ -12865,7 +13042,8 @@ function registerPrecommit(program2) {
     const result = await preCommitCheck({
       diff: diff || void 0,
       paths: touchedPaths,
-      block_on: opts.blockOn ?? "high-confidence",
+      block_on: blockOn,
+      anchored_blocks: anchoredBlocks,
       semantic: opts.noSemantic ? false : true
     }, ctx);
     if (opts.json) {
@@ -12908,7 +13086,7 @@ function registerPrecommit(program2) {
       console.log();
     }
     if (result.should_block) {
-      ui.error(`Blocking commit (block_on=${opts.blockOn ?? "high-confidence"}). Address the warnings above or pass --block-on never to bypass.`);
+      ui.error(`Blocking commit (gate=${gate}, block_on=${blockOn}). Address the warnings above or pass --block-on never to bypass.`);
       process.exit(1);
     }
     if (result.warnings.length === 0 && result.stale_anchors.length === 0) {
@@ -13189,15 +13367,16 @@ function registerMemoryConflictCandidates(memory2) {
 
 // src/commands/enforce.ts
 import { execFileSync as execFileSync2, spawn as spawn6 } from "child_process";
-import { existsSync as existsSync68, statSync as statSync2 } from "fs";
+import { existsSync as existsSync68, statSync as statSync3 } from "fs";
 import { chmod as chmod2, mkdir as mkdir19, readFile as readFile21, readdir as readdir6, rm as rm3, writeFile as writeFile33 } from "fs/promises";
 import path50 from "path";
 import "commander";
 import {
+  antiPatternGateParams as antiPatternGateParams2,
   findProjectRoot as findProjectRoot49,
   hasRecentBriefingMarker,
   isFreshIsoDate,
-  loadConfig as loadConfig11,
+  loadConfig as loadConfig12,
   loadMemoriesFromDir as loadMemoriesFromDir36,
   memoryMatchesAnchorPaths as memoryMatchesAnchorPaths6,
   readRecentBriefingMarker,
@@ -13218,7 +13397,7 @@ function registerEnforce(program2) {
     const root = findProjectRoot49(opts.dir);
     const paths = resolveHaivePaths45(root);
     await mkdir19(paths.haiveDir, { recursive: true });
-    const current = await loadConfig11(paths);
+    const current = await loadConfig12(paths);
     await saveConfig4(paths, {
       ...current,
       enforcement: {
@@ -13491,7 +13670,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
   const root = findProjectRoot49(dir);
   const paths = resolveHaivePaths45(root);
   const initialized = existsSync68(paths.haiveDir);
-  const config = initialized ? await loadConfig11(paths) : {};
+  const config = initialized ? await loadConfig12(paths) : {};
   if (initialized) await applyLightweightRepairs(root, paths);
   const mode = config.enforcement?.mode ?? "strict";
   const findings = [];
@@ -13521,7 +13700,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "hAIve enforcement is disabled." }]
     });
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.9.29"));
+  findings.push(...await inspectIntegrationVersions(root, "0.9.31"));
   if (config.enforcement?.requireBriefingFirst !== false && stage !== "ci") {
     const hasBriefing = await hasRecentBriefingMarker(paths, sessionId);
     findings.push(hasBriefing ? { severity: "ok", code: "briefing-loaded", message: "A recent hAIve briefing marker exists." } : {
@@ -13555,7 +13734,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
     findings.push(...await verifyDecisionCoverage(paths, stage, sessionId));
   }
   if (stage === "pre-commit" || stage === "ci") {
-    findings.push(...await runPrecommitPolicy(paths));
+    findings.push(...await runPrecommitPolicy(paths, config.enforcement?.antiPatternGate ?? "anchored"));
   }
   if (config.enforcement?.cleanupGeneratedArtifacts !== false) {
     findings.push(...await findGeneratedArtifacts(paths));
@@ -13679,17 +13858,22 @@ async function verifyDecisionCoverage(paths, stage, sessionId) {
     impact: Math.min(35, 10 + missing.length * 5)
   }];
 }
-async function runPrecommitPolicy(paths) {
+async function runPrecommitPolicy(paths, gate) {
+  if (gate === "off") {
+    return [{ severity: "info", code: "precommit-policy-off", message: "Anti-pattern gate is disabled (enforcement.antiPatternGate=off)." }];
+  }
   const staged = await runCommand4("git", ["diff", "--cached", "--name-only"], paths.root).catch(() => "");
   const touchedPaths = staged.split("\n").map((s) => s.trim()).filter(Boolean);
   if (touchedPaths.length === 0) {
     return [{ severity: "info", code: "no-staged-changes", message: "No staged changes found for pre-commit policy." }];
   }
   const diff = await runCommand4("git", ["diff", "--cached"], paths.root).catch(() => "");
+  const { block_on, anchored_blocks } = antiPatternGateParams2(gate);
   const result = await preCommitCheck({
     diff,
     paths: touchedPaths,
-    block_on: "high-confidence",
+    block_on,
+    anchored_blocks,
     semantic: true
   }, { paths });
   if (!result.should_block) {
@@ -13827,7 +14011,7 @@ function extractAbsoluteHaiveBins2(text) {
     const p = match[2];
     if (!p) continue;
     try {
-      if (statSync2(p).isDirectory()) continue;
+      if (statSync3(p).isDirectory()) continue;
     } catch {
     }
     out.add(p);
@@ -14128,7 +14312,7 @@ function registerRun(program2) {
 
 // src/index.ts
 var program = new Command52();
-program.name("haive").description("hAIve \u2014 the memory and enforcement layer of your agent harness").version("0.9.29").option("--advanced", "show maintenance and experimental commands in help");
+program.name("haive").description("hAIve \u2014 the memory and enforcement layer of your agent harness").version("0.9.31").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);