@hiveai/cli 0.13.8 → 0.14.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command58 } from "commander";
+import { Command as Command59 } from "commander";
 
 // src/commands/briefing.ts
 import { existsSync as existsSync3 } from "fs";
@@ -199,7 +199,7 @@ async function getHotFiles(root, daysBack, maxHotFiles, filePaths) {
       if (!f) continue;
       counts.set(f, (counts.get(f) ?? 0) + 1);
     }
-    let entries = [...counts.entries()].map(([path55, changes]) => ({ path: path55, changes }));
+    let entries = [...counts.entries()].map(([path56, changes]) => ({ path: path56, changes }));
     const lowerPaths = filePaths.map((p) => p.toLowerCase());
     if (lowerPaths.length > 0) {
       entries = entries.filter((e) => lowerPaths.some((p) => e.path.toLowerCase().includes(p)));
@@ -3019,7 +3019,7 @@ ${SEED_FOOTER(stack)}` });
 }
 
 // src/commands/init.ts
-var HAIVE_GITHUB_ACTION_REF = `v${"0.13.8"}`;
+var HAIVE_GITHUB_ACTION_REF = `v${"0.14.0"}`;
 var PROJECT_CONTEXT_TEMPLATE = `# Project context
 
 > Generated by \`haive init\`. Run \`haive init --bootstrap\` to auto-fill from your codebase,
@@ -4089,10 +4089,13 @@ import {
   literalMatchesAnyToken as literalMatchesAnyToken22,
   loadCodeMap as loadCodeMap5,
   loadConfig as loadConfig3,
+  hashProjectContext,
   loadMemoriesFromDir as loadMemoriesFromDir15,
   loadUsageIndex as loadUsageIndex8,
   memoryMatchesAnchorPaths as memoryMatchesAnchorPaths22,
+  projectContextRecentlyEmitted,
   rankMemoriesLexical as rankMemoriesLexical2,
+  recordProjectContextEmission,
   queryCodeMap as queryCodeMap2,
   resolveBriefingBudget as resolveBriefingBudget2,
   serializeMemory as serializeMemory10,
@@ -4133,6 +4136,7 @@ import { z as z25 } from "zod";
 import { existsSync as existsSync25 } from "fs";
 import {
   addedLinesFromDiff,
+  appendPreventionEvent,
   buildDocFrequency,
   CODE_STOPWORDS,
   deriveConfidence as deriveConfidence6,
@@ -4143,7 +4147,9 @@ import {
   loadUsageIndex as loadUsageIndex10,
   literalMatchesAnyToken as literalMatchesAnyToken3,
   memoryMatchesAnchorPaths as memoryMatchesAnchorPaths4,
+  recordPrevention,
   runSensors,
+  saveUsageIndex as saveUsageIndex4,
   sensorTargetsFromDiff,
   tokenizeQuery as tokenizeQuery3
 } from "@hiveai/core";
@@ -5708,6 +5714,9 @@ var GetBriefingInputSchema = {
   ),
   max_memories: z19.number().int().positive().default(8).describe("Cap on memories surfaced regardless of token budget"),
   include_project_context: z19.boolean().default(true),
+  dedupe_project_context: z19.boolean().optional().describe(
+    "Token saver (default ON): skip re-emitting the project-context body if an identical copy was already sent within the last few minutes this session (the agent still has it). Set false to always include it."
+  ),
   include_module_contexts: z19.boolean().default(true),
   semantic: z19.boolean().default(true).describe(
     "Use semantic ranking when a task is provided (requires `haive embeddings index`)."
@@ -5915,7 +5924,17 @@ async function getBriefing(input, ctx) {
       }
     }
   }
-  const projectContextRaw = input.include_project_context && existsSync21(ctx.paths.projectContext) ? await readFile52(ctx.paths.projectContext, "utf8") : "";
+  let projectContextRaw = input.include_project_context && existsSync21(ctx.paths.projectContext) ? await readFile52(ctx.paths.projectContext, "utf8") : "";
+  let contextOmittedRecent = false;
+  if (projectContextRaw && input.dedupe_project_context !== false) {
+    const ctxHash = hashProjectContext(projectContextRaw);
+    if (await projectContextRecentlyEmitted(ctx.paths, ctxHash)) {
+      contextOmittedRecent = true;
+      projectContextRaw = "";
+    } else {
+      await recordProjectContextEmission(ctx.paths, ctxHash);
+    }
+  }
   const isTemplateContext = projectContextRaw.includes("TODO \u2014 high-level overview") || projectContextRaw.includes("Generated by `haive init`");
   const setupWarnings = [];
   let autoContextGenerated = false;
@@ -6183,7 +6202,11 @@ When done, call \`mem_session_end\` to acknowledge \u2014 this clears the pendin
     search_mode: searchMode,
     inferred_modules: inferred,
     ...lastSession ? { last_session: lastSession } : {},
-    project_context: adaptiveTrim ? {
+    project_context: contextOmittedRecent ? {
+      content: "(project context unchanged \u2014 omitted to save tokens; it was provided earlier this session. Pass dedupe_project_context:false to force a full copy.)",
+      truncated: false,
+      omitted_recent: true
+    } : adaptiveTrim ? {
       content: "(adaptive briefing: auto-generated context omitted \u2014 no team-specific policy matched, so a capable model needs nothing extra here)",
       truncated: false,
       ...isTemplateContext && !autoContextGenerated ? { is_template: true } : {},
@@ -6669,6 +6692,22 @@ async function antiPatternsCheck(input, ctx) {
     };
     return score(b) - score(a);
   }).slice(0, input.limit);
+  const strongCatches = warnings.filter(
+    (w) => w.reasons.includes("sensor") || w.distinctive_literal === true || w.reasons.includes("anchor") && w.reasons.includes("literal")
+  );
+  if (strongCatches.length > 0) {
+    const recordedIds = [];
+    for (const w of strongCatches) if (recordPrevention(usage, w.id)) recordedIds.push(w.id);
+    if (recordedIds.length > 0) {
+      await saveUsageIndex4(ctx.paths, usage).catch(() => {
+      });
+      const at = (/* @__PURE__ */ new Date()).toISOString();
+      for (const id of recordedIds) {
+        await appendPreventionEvent(ctx.paths, { at, id, source: "anti-pattern" }).catch(() => {
+        });
+      }
+    }
+  }
   return {
     scanned: negative.length,
     warnings
@@ -7485,7 +7524,7 @@ async function patternDetect(input, ctx) {
   for (const [p, { count, tools }] of pathCounts) {
     if (count < HOT_FILE_MIN) continue;
     if (tools.has("mem_tried") || tools.has("mem_observe")) continue;
-    if (CONFIG_PATTERNS.some((cp) => path122.basename(p).includes(cp))) continue;
+    if (CONFIG_PATTERNS.some((cp2) => path122.basename(p).includes(cp2))) continue;
     const slug = p.replace(/[^a-z0-9]/g, "-").replace(/-+/g, "-").slice(0, 40);
     matches.push({
       kind: "hot_file",
@@ -7919,7 +7958,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.13.8";
+var SERVER_VERSION = "0.14.0";
 function jsonResult(data) {
   return {
     content: [
@@ -8668,6 +8707,7 @@ function createHaiveServer(options = {}) {
     "anti_patterns_check",
     [
       "Scan a diff (or set of paths) against documented attempt/gotcha memories.",
+      "[Diff-scan layer: the MEMORY-MATCH component. `pre_commit_check` combines this with sensors + stale checks; `haive enforce check` is the gate.]",
       "Surfaces 'you are about to repeat a known mistake' warnings BEFORE you commit.",
       "",
       "USE BEFORE finalizing a non-trivial change. Cheap and high-signal: the only",
@@ -8811,6 +8851,7 @@ function createHaiveServer(options = {}) {
     "pre_commit_check",
     [
       "One-shot 'should I block this commit?' check. Combines three signals:",
+      "[Diff-scan layer: the COMBINED check (sensors + anti-patterns + stale). `haive enforce check` is the gate that runs this at commit time.]",
       "",
       "  1. anti_patterns_check \u2014 known gotchas/attempts that match the diff",
       "  2. mem_for_files       \u2014 conventions/decisions anchored to touched files",
@@ -10688,7 +10729,7 @@ import {
   loadUsageIndex as loadUsageIndex18,
   recordRejection as recordRejection3,
   resolveHaivePaths as resolveHaivePaths23,
-  saveUsageIndex as saveUsageIndex4,
+  saveUsageIndex as saveUsageIndex5,
   serializeMemory as serializeMemory19
 } from "@hiveai/core";
 function registerMemoryReject(memory2) {
@@ -10721,7 +10762,7 @@ function registerMemoryReject(memory2) {
     );
     const idx = await loadUsageIndex18(paths);
     recordRejection3(idx, id, opts.reason ?? null);
-    await saveUsageIndex4(paths, idx);
+    await saveUsageIndex5(paths, idx);
     const u = idx.by_id[id];
     ui.success(
       `Rejected ${id} (status=rejected, ${u.rejected_count} rejection${u.rejected_count === 1 ? "" : "s"})`
@@ -10740,7 +10781,7 @@ import {
   findProjectRoot as findProjectRoot27,
   loadUsageIndex as loadUsageIndex19,
   resolveHaivePaths as resolveHaivePaths24,
-  saveUsageIndex as saveUsageIndex5
+  saveUsageIndex as saveUsageIndex6
 } from "@hiveai/core";
 function registerMemoryRm(memory2) {
   memory2.command("delete <id>").alias("rm").description("Delete a memory file (and its usage entry by default). Mirrors MCP mem_delete. Alias: rm").option("-y, --yes", "skip the confirmation prompt").option("--keep-usage", "do not remove the usage.json entry").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
@@ -10774,7 +10815,7 @@ function registerMemoryRm(memory2) {
       const idx = await loadUsageIndex19(paths);
       if (idx.by_id[id]) {
         delete idx.by_id[id];
-        await saveUsageIndex5(paths, idx);
+        await saveUsageIndex6(paths, idx);
         ui.info("Removed usage entry");
       }
     }
@@ -10984,7 +11025,7 @@ import {
   recordApplied as recordApplied2,
   recordRejection as recordRejection4,
   resolveHaivePaths as resolveHaivePaths28,
-  saveUsageIndex as saveUsageIndex6
+  saveUsageIndex as saveUsageIndex7
 } from "@hiveai/core";
 function registerMemoryFeedback(memory2) {
   memory2.command("feedback <id>").description(
@@ -11013,7 +11054,7 @@ function registerMemoryFeedback(memory2) {
     const outcome = opts.applied ? "applied" : "rejected";
     if (opts.applied) recordApplied2(index, id);
     else recordRejection4(index, id, opts.reason ?? null);
-    await saveUsageIndex6(paths, index);
+    await saveUsageIndex7(paths, index);
     const usage = getUsage19(index, id);
     const impact = computeImpact4(target.memory.frontmatter, usage);
     if (opts.json) {
@@ -13289,8 +13330,8 @@ function registerDoctor(program2) {
         fix: "haive init"
       });
     } else {
-      const { readFile: readFile26 } = await import("fs/promises");
-      const content = await readFile26(paths.projectContext, "utf8");
+      const { readFile: readFile27 } = await import("fs/promises");
+      const content = await readFile27(paths.projectContext, "utf8");
       const isTemplate = content.includes("TODO \u2014 high-level overview") || content.includes("Generated by `haive init`");
       if (isTemplate) {
         findings.push({
@@ -13464,8 +13505,8 @@ function registerDoctor(program2) {
       let hasClaudeEnforcement = false;
       if (existsSync68(claudeSettings)) {
         try {
-          const { readFile: readFile26 } = await import("fs/promises");
-          const raw = await readFile26(claudeSettings, "utf8");
+          const { readFile: readFile27 } = await import("fs/promises");
+          const raw = await readFile27(claudeSettings, "utf8");
           hasClaudeEnforcement = raw.includes("haive enforce session-start") && raw.includes("haive enforce pre-tool-use");
         } catch {
           hasClaudeEnforcement = false;
@@ -13488,7 +13529,7 @@ 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.13.8"));
+    findings.push(...await collectInstallFindings(root, "0.14.0"));
     findings.push(...await collectToolchainFindings(root));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
@@ -13496,7 +13537,7 @@ function registerDoctor(program2) {
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.13.8";
+      const cliVersion = "0.14.0";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -14729,52 +14770,73 @@ ${briefing.project_context.content.slice(0, 1800)}`);
 [setup warning] ${warning}`);
     }
   });
-  enforce.command("pre-tool-use").description("Claude Code PreToolUse hook: block writes until hAIve briefing has been loaded.").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  enforce.command("pre-tool-use").description("Claude Code PreToolUse hook: surface the relevant team policy for the edited file (advise; configurable to block).").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const payload = await readHookPayload();
     const root = resolveRoot(opts.dir, payload);
     if (!root) return;
     const paths = resolveHaivePaths48(root);
     if (!existsSync75(paths.haiveDir)) return;
     if (!isWriteLikeTool(payload)) return;
-    const ok = await hasRecentBriefingMarker2(paths, payload.session_id);
-    if (ok) {
-      const targetFiles = extractToolPaths(payload, root);
-      if (targetFiles.length === 0) return;
-      const missing = await missingRequiredMemoriesForFiles(paths, targetFiles, payload.session_id);
-      if (missing.length === 0) return;
-      const ids = missing.slice(0, 6).map((memory2) => memory2.memory.frontmatter.id);
+    const config = await loadConfig13(paths);
+    if (config.enforcement?.requireBriefingFirst === false) return;
+    const gate = config.enforcement?.preEditGate ?? "advise";
+    const targetFiles = extractToolPaths(payload, root);
+    const hasMarker = await hasRecentBriefingMarker2(paths, payload.session_id);
+    const missing = targetFiles.length > 0 ? await missingRequiredMemoriesForFiles(paths, targetFiles, payload.session_id) : [];
+    if (hasMarker && missing.length === 0) return;
+    if (targetFiles.length > 0) {
+      await recordFilesIntoBriefingMarker(paths, targetFiles, missing, payload.session_id).catch(() => {
+      });
+    }
+    const contextText = buildPreEditContext(payload.tool_name ?? "write tool", targetFiles, missing, hasMarker);
+    if (gate === "block") {
       console.error(
-        [
-          "hAIve enforcement blocked this action.",
-          `Tool: ${payload.tool_name ?? "write tool"}`,
-          `Files: ${targetFiles.slice(0, 6).join(", ")}`,
-          "",
-          "These files have required hAIve context that was not in the current briefing:",
-          ...ids.map((id) => `  - ${id}`),
-          "",
-          "Load the targeted briefing before editing:",
-          `  ${briefingCommandForFiles(targetFiles)}`
-        ].join("\n")
+        contextText + '\n\nThe relevant context is now recorded \u2014 re-issue the same edit to proceed (no `haive briefing` command needed). To make this advisory instead of blocking, set `{ "enforcement": { "preEditGate": "advise" } }` in .ai/haive.config.json.'
       );
       process.exit(2);
     }
-    const tool = payload.tool_name ?? "write tool";
-    console.error(
-      [
-        "hAIve enforcement blocked this action.",
-        `Tool: ${tool}`,
-        "",
-        "This project is initialized with hAIve. Load the team briefing before editing:",
-        "  haive enforce session-start",
-        "or call MCP get_briefing / mem_relevant_to from your AI client.",
-        "",
-        "If this is intentional, a human can disable enforcement in .ai/haive.config.json:",
-        '  { "enforcement": { "requireBriefingFirst": false } }'
-      ].join("\n")
-    );
-    process.exit(2);
+    emitPreToolUseContext(contextText);
+  });
+}
+async function recordFilesIntoBriefingMarker(paths, files, missing, sessionId) {
+  const existing = await readRecentBriefingMarker(paths, sessionId);
+  const ids = new Set(existing?.memory_ids ?? []);
+  for (const { memory: memory2 } of missing) ids.add(memory2.frontmatter.id);
+  await writeBriefingMarker3(paths, {
+    sessionId,
+    task: existing?.task ?? "pre-edit auto-briefing",
+    source: "haive-pre-edit",
+    files,
+    memoryIds: [...ids]
   });
 }
+function buildPreEditContext(tool, files, missing, hasMarker) {
+  const lines = ["hAIve \u2014 relevant team policy for this edit", `Tool: ${tool}`];
+  if (files.length > 0) lines.push(`Files: ${files.slice(0, 6).join(", ")}`);
+  if (missing.length > 0) {
+    lines.push("", "Consult these before editing (anchored to the files you are touching):");
+    for (const { memory: memory2 } of missing.slice(0, 5)) {
+      const fm = memory2.frontmatter;
+      lines.push("", `### ${fm.id}  (${fm.scope}/${fm.type})`, memory2.body.trim().slice(0, 900));
+    }
+  } else if (!hasMarker) {
+    lines.push(
+      "",
+      "No team briefing was loaded yet this session. Proceeding \u2014 but for substantive work call get_briefing / mem_relevant_to for richer context."
+    );
+  }
+  return lines.join("\n");
+}
+function emitPreToolUseContext(text) {
+  console.log(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        additionalContext: text
+      }
+    })
+  );
+}
 async function buildFinishReport(dir) {
   const root = findProjectRoot52(dir);
   const paths = resolveHaivePaths48(root);
@@ -15105,7 +15167,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "hAIve enforcement is disabled." }]
     });
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.13.8"));
+  findings.push(...await inspectIntegrationVersions(root, "0.14.0"));
   if (config.enforcement?.requireBriefingFirst !== false && stage !== "ci") {
     const hasBriefing = await hasRecentBriefingMarker2(paths, sessionId);
     findings.push(hasBriefing ? { severity: "ok", code: "briefing-loaded", message: "A recent hAIve briefing marker exists." } : {
@@ -15223,7 +15285,7 @@ async function verifyMemoryPolicy(paths, config) {
 }
 async function verifyDecisionCoverage(paths, stage, sessionId) {
   if (!existsSync75(paths.memoriesDir)) return [];
-  const changedFiles = await getChangedFiles(paths.root, stage);
+  const changedFiles = (await getChangedFiles(paths.root, stage)).filter((f) => !isGeneratedArtifact(f));
   if (changedFiles.length === 0) {
     return [{ severity: "info", code: "decision-coverage-no-changes", message: "No changed files to match against policy memories." }];
   }
@@ -16020,8 +16082,10 @@ async function missingRequiredMemoriesForFiles(paths, files, sessionId) {
     return memoryMatchesAnchorPaths6(memory2, files);
   }).map(({ memory: memory2, filePath }) => ({ memory: memory2, filePath }));
 }
-function briefingCommandForFiles(files) {
-  return `haive briefing --files "${files.slice(0, 10).join(",")}" --task "edit ${files.slice(0, 3).join(", ")}"`;
+function isGeneratedArtifact(file) {
+  if (file === ".ai/project-context.md" || file === ".ai/code-map.json") return true;
+  if (file.startsWith(".ai/.cache/") || file.startsWith(".ai/.runtime/") || file.startsWith(".ai/.usage/")) return true;
+  return false;
 }
 async function readStdin2(maxBytes) {
   if (process.stdin.isTTY) return "";
@@ -16096,14 +16160,15 @@ import path53 from "path";
 import { promisify as promisify2 } from "util";
 import "commander";
 import {
+  appendPreventionEvent as appendPreventionEvent2,
   findProjectRoot as findProjectRoot53,
   isRetiredMemory as isRetiredMemory3,
   loadMemoriesFromDir as loadMemoriesFromDir39,
   loadUsageIndex as loadUsageIndex29,
-  recordPrevention,
+  recordPrevention as recordPrevention2,
   resolveHaivePaths as resolveHaivePaths49,
   runSensors as runSensors2,
-  saveUsageIndex as saveUsageIndex7,
+  saveUsageIndex as saveUsageIndex8,
   sensorTargetsFromDiff as sensorTargetsFromDiff2,
   serializeMemory as serializeMemory27
 } from "@hiveai/core";
@@ -16131,7 +16196,9 @@ function registerSensors(program2) {
       if (row.last_fired) console.log(`     ${ui.dim("last fired:")} ${row.last_fired}`);
     }
   });
-  sensors.command("check").description("Run regex sensors against a diff; defaults to `git diff --cached`").option("--diff-file <path>", "read unified diff from a file instead of staged changes").option("--json", "emit JSON", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
+  sensors.command("check").description(
+    "Run regex sensors against a diff (the deterministic/computational layer); defaults to `git diff --cached`.\n  Diff-scan layers: `sensors check` (regex) and `anti_patterns_check` (memory match) are components;\n  `pre_commit_check` combines them; `haive enforce check` is THE gate that runs at commit."
+  ).option("--diff-file <path>", "read unified diff from a file instead of staged changes").option("--json", "emit JSON", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot53(opts.dir);
     const paths = resolveHaivePaths49(root);
     const memories = await runnableSensorMemories(paths);
@@ -16141,10 +16208,17 @@ function registerSensors(program2) {
     const firedIds = [...new Set(hits.map((hit) => hit.memory_id))];
     if (firedIds.length > 0) {
       const usage = await loadUsageIndex29(paths);
-      let recorded = 0;
-      for (const id of firedIds) if (recordPrevention(usage, id)) recorded++;
-      if (recorded > 0) await saveUsageIndex7(paths, usage).catch(() => {
-      });
+      const recordedIds = [];
+      for (const id of firedIds) if (recordPrevention2(usage, id)) recordedIds.push(id);
+      if (recordedIds.length > 0) {
+        await saveUsageIndex8(paths, usage).catch(() => {
+        });
+        const at = (/* @__PURE__ */ new Date()).toISOString();
+        for (const id of recordedIds) {
+          await appendPreventionEvent2(paths, { at, id, source: "sensor" }).catch(() => {
+          });
+        }
+      }
     }
     const output = {
       scanned: memories.length,
@@ -16489,6 +16563,7 @@ import {
   buildDashboard,
   findProjectRoot as findProjectRoot55,
   loadMemoriesFromDir as loadMemoriesFromDir41,
+  loadPreventionEvents,
   loadUsageIndex as loadUsageIndex30,
   resolveHaivePaths as resolveHaivePaths51
 } from "@hiveai/core";
@@ -16505,10 +16580,12 @@ function registerDashboard(program2) {
     }
     const memories = existsSync78(paths.memoriesDir) ? await loadMemoriesFromDir41(paths.memoriesDir) : [];
     const usage = await loadUsageIndex30(paths);
+    const preventionEvents = await loadPreventionEvents(paths);
     const top = Math.max(1, Number.parseInt(opts.top ?? "10", 10) || 10);
     const dormantDays = opts.dormantDays ? Number.parseInt(opts.dormantDays, 10) : void 0;
     const report = buildDashboard(memories, usage, {
       top,
+      preventionEvents,
       ...dormantDays !== void 0 && Number.isFinite(dormantDays) ? { dormantDays } : {}
     });
     if (opts.json) {
@@ -16553,11 +16630,22 @@ function renderDashboard(r) {
   console.log(
     `  ${prevention.total_events > 0 ? ui.green(`${prevention.total_events} catch event(s)`) : "0 catch events"} \xB7 ${prevention.memories_with_catches} memor${prevention.memories_with_catches === 1 ? "y" : "ies"} with catches`
   );
+  console.log(
+    `  ${ui.dim("trend:")} ${prevention.trend.last_7d} in 7d \xB7 ${prevention.trend.last_30d} in 30d  ${ui.dim("weekly")} [${prevention.trend.weekly.join(" ")}]`
+  );
   for (const p of prevention.top.slice(0, 5)) {
     console.log(
       `    ${ui.green("\u2713")} ${p.prevented_count}\xD7 ${p.id}` + (p.last_prevented_at ? ui.dim(`  last ${p.last_prevented_at.slice(0, 10)}`) : "")
     );
   }
+  if (prevention.recurrence.recurring_count > 0) {
+    console.log(
+      `  ${ui.yellow("recurrence:")} ${prevention.recurrence.recurring_count} lesson(s) re-introduced after capture ` + ui.dim("(caught on \u22652 distinct days)")
+    );
+    for (const r2 of prevention.recurrence.top.slice(0, 5)) {
+      console.log(`    ${ui.yellow("\u21BB")} ${r2.distinct_days} days \xB7 ${r2.catches}\xD7 ${r2.id}`);
+    }
+  }
   console.log();
   console.log(ui.bold("Health"));
   console.log(
@@ -16593,9 +16681,72 @@ function warnNum(n) {
   return n > 0 ? ui.yellow(String(n)) : String(n);
 }
 
+// src/commands/dev-link.ts
+import { execFile as execFile3 } from "child_process";
+import { cp, readFile as readFile26 } from "fs/promises";
+import { existsSync as existsSync79 } from "fs";
+import path55 from "path";
+import { promisify as promisify3 } from "util";
+import "commander";
+import { findProjectRoot as findProjectRoot56 } from "@hiveai/core";
+var exec3 = promisify3(execFile3);
+function registerDevLink(program2) {
+  const dev = program2.commands.find((c) => c.name() === "dev") ?? program2.command("dev").description("Developer utilities for working on hAIve itself.");
+  dev.command("link").description("Hot-swap this repo's built dist into the global @hiveai install so `haive` runs your local code.").option("-d, --dir <dir>", "repo root (default: discovered from cwd)").option("--json", "emit a machine-readable summary", false).action(async (opts) => {
+    const root = findProjectRoot56(opts.dir);
+    if (!existsSync79(path55.join(root, "packages", "cli", "dist", "index.js"))) {
+      ui.error(`Not the hAIve monorepo (no packages/cli/dist) at ${root}. Run \`pnpm -r build\` first, or pass --dir.`);
+      process.exitCode = 1;
+      return;
+    }
+    let globalModules;
+    try {
+      globalModules = (await exec3("npm", ["root", "-g"])).stdout.trim();
+    } catch {
+      globalModules = path55.join(path55.dirname(path55.dirname(process.execPath)), "lib", "node_modules");
+    }
+    const globalHive = path55.join(globalModules, "@hiveai");
+    if (!existsSync79(globalHive)) {
+      ui.error(`No global @hiveai install at ${globalHive}. Install once with \`npm i -g @hiveai/cli\`, then re-run.`);
+      process.exitCode = 1;
+      return;
+    }
+    const linked = [];
+    const copyDist = async (fromPkg, toDistDir) => {
+      const from = path55.join(root, "packages", fromPkg, "dist");
+      if (!existsSync79(from) || !existsSync79(path55.dirname(toDistDir))) return;
+      await cp(from, toDistDir, { recursive: true });
+      linked.push(path55.relative(globalModules, toDistDir));
+    };
+    for (const pkg of ["cli", "mcp"]) {
+      await copyDist(pkg, path55.join(globalHive, pkg, "dist"));
+      for (const nested of ["core", "embeddings"]) {
+        await copyDist(nested, path55.join(globalHive, pkg, "node_modules", "@hiveai", nested, "dist"));
+      }
+    }
+    await copyDist("core", path55.join(globalHive, "core", "dist"));
+    let version = "unknown";
+    try {
+      version = JSON.parse(await readFile26(path55.join(root, "package.json"), "utf8")).version ?? "unknown";
+    } catch {
+    }
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: linked.length > 0, version, global_root: globalHive, linked }, null, 2));
+      return;
+    }
+    if (linked.length === 0) {
+      ui.warn("Nothing linked \u2014 no matching dist targets were found in the global install.");
+      return;
+    }
+    ui.success(`Linked local dist (v${version}) into the global @hiveai install:`);
+    for (const t of linked) console.log(`  ${ui.dim("\u2192")} ${t}`);
+    console.log(ui.dim("The global `haive` now runs your local build (git hooks + MCP included)."));
+  });
+}
+
 // src/index.ts
-var program = new Command58();
-program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.13.8").option("--advanced", "show maintenance and experimental commands in help");
+var program = new Command59();
+program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.14.0").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -16606,6 +16757,7 @@ registerAgent(program);
 registerSensors(program);
 registerIngest(program);
 registerDashboard(program);
+registerDevLink(program);
 registerMcp(program);
 registerBriefing(program);
 registerTui(program);