@hiveai/cli 0.9.24 → 0.9.26

package/dist/index.js

@@ -4,22 +4,22 @@
 import { Command as Command51 } from "commander";
 
 // src/commands/briefing.ts
-import { existsSync } from "fs";
-import { mkdir, readFile } from "fs/promises";
-import path from "path";
+import { existsSync as existsSync3 } from "fs";
+import { mkdir, readFile as readFile2 } from "fs/promises";
+import path3 from "path";
 import "commander";
 import {
   extractActionsBriefBody,
-  findProjectRoot,
+  findProjectRoot as findProjectRoot2,
   literalMatchesAllTokens,
   literalMatchesAnyToken,
-  loadCodeMap,
-  loadMemoriesFromDir,
-  loadUsageIndex,
+  loadCodeMap as loadCodeMap3,
+  loadMemoriesFromDir as loadMemoriesFromDir3,
+  loadUsageIndex as loadUsageIndex2,
   memoryMatchesAnchorPaths,
   queryCodeMap,
   resolveBriefingBudget,
-  resolveHaivePaths,
+  resolveHaivePaths as resolveHaivePaths2,
   tokenizeQuery,
   trackReads,
   writeBriefingMarker
@@ -225,1451 +225,1461 @@ function radarHasContent(r) {
   return r.recentCommits.length > 0 || r.openTodos.length > 0 || r.hotFiles.length > 0;
 }
 
-// src/commands/briefing.ts
-var RADAR_AUTO_THRESHOLD = 3;
-var CHARS_PER_TOKEN = 4;
-function printRadar(radar, out, reason) {
-  if (!radar.insideGitRepo) return;
-  if (!radarHasContent(radar)) return;
-  const header = reason === "low-memory-signal" ? "=== Project Radar (few relevant memories \u2014 surfacing live signals) ===" : "=== Project Radar ===";
-  out(`${ui.bold(header)}
-`);
-  if (radar.recentCommits.length > 0) {
-    out(ui.bold("Recent commits:"));
-    for (const c of radar.recentCommits) {
-      const filesBlurb = c.files.slice(0, 3).join(", ");
-      const more = c.files.length > 3 ? ` (+${c.files.length - 3})` : "";
-      out(`  ${ui.dim(c.date)} ${c.sha}  ${c.subject}`);
-      if (filesBlurb) out(ui.dim(`    ${filesBlurb}${more}`));
+// src/utils/autopilot.ts
+import { existsSync as existsSync2 } from "fs";
+import { readFile, writeFile as writeFile2 } from "fs/promises";
+import path2 from "path";
+import {
+  AUTOPILOT_DEFAULTS,
+  buildCodeMap,
+  loadCodeMap as loadCodeMap2,
+  loadConfig,
+  loadMemoriesFromDir as loadMemoriesFromDir2,
+  saveCodeMap,
+  saveConfig
+} from "@hiveai/core";
+
+// src/commands/memory-lint.ts
+import { existsSync } from "fs";
+import { writeFile } from "fs/promises";
+import { spawnSync } from "child_process";
+import path from "path";
+import "commander";
+import {
+  findProjectRoot,
+  getUsage,
+  loadCodeMap,
+  loadMemoriesFromDir,
+  loadUsageIndex,
+  resolveHaivePaths,
+  serializeMemory
+} from "@hiveai/core";
+async function lintMemoriesAsync(root, options = {}) {
+  const paths = resolveHaivePaths(root);
+  const out = [];
+  const fixes = [];
+  if (!existsSync(paths.memoriesDir)) return { findings: out, fixes };
+  const loaded = await loadMemoriesFromDir(paths.memoriesDir);
+  const usage = await loadUsageIndex(paths);
+  const codeMap = await loadCodeMap(paths);
+  const trackedFiles = gitTrackedFiles(root);
+  const ANCHOR_TYPES = /* @__PURE__ */ new Set(["decision", "architecture", "gotcha"]);
+  const actionableWords = /\b(always|never|prefer|use|run|avoid|because|instead|why|rationale|do not|must|should|require|required|requires|fix|fail|failed|fails|prevent|prevents|allow|allows|lets|ensure|ensures|catch|catches)\b/i;
+  for (const { filePath, memory: memory2 } of loaded) {
+    const fm = memory2.frontmatter;
+    if (fm.type === "session_recap") continue;
+    const body = memory2.body.trim();
+    const naked = body.replace(/^#.*$/gm, "").replace(/```[\s\S]*?```/g, "").trim();
+    if (naked.length < 40 && fm.status !== "rejected") {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "warn",
+        code: "SHORT_BODY",
+        message: "Body looks very short (< ~40 chars of prose after headings). Prefer actionable detail."
+      });
     }
-    out("");
-  }
-  if (radar.openTodos.length > 0) {
-    out(ui.bold("Open TODOs/FIXMEs:"));
-    for (const t of radar.openTodos) {
-      out(`  ${ui.dim(t.file + ":" + t.line)}  ${t.text}`);
+    if (["decision", "gotcha", "convention", "architecture", "attempt"].includes(fm.type) && fm.status !== "rejected" && !actionableWords.test(naked)) {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "info",
+        code: "LOW_ACTIONABILITY",
+        message: "Record does not contain obvious action/rationale words. Add the concrete rule, why it exists, and what to do instead."
+      });
     }
-    out("");
-  }
-  if (radar.hotFiles.length > 0) {
-    out(ui.bold("Hot files (most modified recently):"));
-    for (const f of radar.hotFiles) {
-      out(`  ${f.changes}\xD7 ${ui.dim(f.path)}`);
+    const suggestedAnchors = suggestAnchors(root, { filePath, memory: memory2 }, codeMap, trackedFiles);
+    if (ANCHOR_TYPES.has(fm.type) && fm.anchor.paths.length === 0 && fm.status === "validated") {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "warn",
+        code: "MISSING_ANCHOR",
+        message: `${fm.type} is validated without anchor paths \u2014 add anchor.paths so haive sync can flag staleness.`,
+        ...suggestedAnchors.paths.length > 0 || suggestedAnchors.symbols.length > 0 ? { suggested_anchors: suggestedAnchors } : {}
+      });
     }
-    out("");
-  }
-}
-var TokenBudgetWriter = class {
-  constructor(budgetChars) {
-    this.budgetChars = budgetChars;
-  }
-  budgetChars;
-  used = 0;
-  truncated = false;
-  write(text) {
-    if (this.truncated) return false;
-    const next = this.used + text.length + 1;
-    if (next > this.budgetChars) {
-      console.log(ui.dim(`... [briefing truncated to fit --max-tokens budget \xB7 ${Math.round(this.used / CHARS_PER_TOKEN)} tokens used]`));
-      this.truncated = true;
-      return false;
+    if (fm.status === "stale" && !fm.stale_reason) {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "info",
+        code: "STALE_NO_REASON",
+        message: "Status is stale but stale_reason is empty \u2014 document why when possible."
+      });
     }
-    console.log(text);
-    this.used = next;
-    return true;
-  }
-  isTruncated() {
-    return this.truncated;
-  }
-  remainingChars() {
-    return Math.max(0, this.budgetChars - this.used);
-  }
-};
-function registerBriefing(program2) {
-  program2.command("briefing").description(
-    'Print the full project briefing: last session recap + project context + relevant memories.\n  Equivalent to calling get_briefing via MCP. Run before starting any task.\n\n  Examples:\n    haive briefing\n    haive briefing --task "add Stripe payment" --files src/payments/PaymentService.ts\n    haive briefing --budget quick --task "tiny fix"\n'
-  ).option("--task <text>", "what you are about to do \u2014 filters memories by relevance").option("--files <csv>", "comma-separated file paths being worked on (surfaces anchored memories)").option("--symbols <csv>", "symbol names to look up in the code-map (e.g. PaymentService,TenantFilter) \u2014 requires haive index code").option("--max-memories <n>", "cap on memories surfaced", "8").option("--max-tokens <n>", "approximate token budget for the entire briefing (truncates if exceeded)").option("--explain-source", "annotate each memory with [source: <relative-path> \xB7 anchors: <files>] for traceable citations").option("--radar", "force project radar (recent commits, open TODOs, hot files) even when memories are plentiful").option("--no-radar", "disable the project radar even when memories are scarce").option(
-    "--budget <preset>",
-    "align with MCP get_briefing budget_preset: quick | balanced | deep \u2014 sets cap + truncation budget (overrides --max-memories / replaces default open-ended output)",
-    void 0
-  ).option(
-    "--memory-format <mode>",
-    "printed memory bodies: full (default) | actions (cheap bullet-focused excerpt)",
-    "full"
-  ).option(
-    "--format <mode>",
-    "alias for --memory-format; accepts full | actions | compact"
-  ).option(
-    "--scope <scope>",
-    "personal | team | shared | all (default: all \u2014 includes team + shared cross-repo memories)",
-    "all"
-  ).option("--include-draft", "include draft memories (excluded by default)").option("--include-stale", "include stale memories (excluded by default \u2014 may be outdated)").option(
-    "--include <path>",
-    "merge memories from another haive-initialized project (repeatable). Useful for teams with multiple coordinated repos (e.g. backend + frontend).",
-    collectInclude,
-    []
-  ).option("-d, --dir <dir>", "project root").action(async (opts) => {
-    const root = findProjectRoot(opts.dir);
-    const paths = resolveHaivePaths(root);
-    const requestedFormat = (opts.format ?? opts.memoryFormat ?? "full").toLowerCase();
-    opts.memoryFormat = requestedFormat === "compact" ? "actions" : requestedFormat;
-    const markerFiles = parseCsv(opts.files);
-    if (existsSync(paths.haiveDir)) {
-      await mkdir(paths.runtimeDir, { recursive: true });
-      await writeBriefingMarker(paths, {
-        task: opts.task ?? "CLI briefing",
-        source: "haive-briefing-cli",
-        sessionId: process.env.HAIVE_SESSION_ID,
-        files: markerFiles
-      }).catch(() => {
+    if (fm.type === "glossary" && naked.length > 6e3) {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "info",
+        code: "LONG_GLOSSARY",
+        message: "Very long glossary \u2014 consider splitting concepts for tighter briefings."
       });
     }
-    let budgetPreset = null;
-    if (opts.budget) {
-      const b = opts.budget.trim().toLowerCase();
-      if (b === "quick" || b === "balanced" || b === "deep") budgetPreset = b;
-      else ui.warn(`Unknown --budget '${opts.budget}' \u2014 ignoring (use quick|balanced|deep).`);
+    const hasMarkdownHeading = /^#{1,3}\s+\S/m.test(memory2.body.trim());
+    if (!hasMarkdownHeading) {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "warn",
+        code: "NO_MD_HEADING",
+        message: "No Markdown heading (#/##/###) \u2014 add one so humans and auditors can skim the memo quickly."
+      });
     }
-    let maxMemories = Math.max(1, Number(opts.maxMemories ?? 8));
-    let budgetTokensCap = opts.maxTokens ? Math.max(100, Number(opts.maxTokens)) : null;
-    if (budgetPreset !== null) {
-      const presetNums = resolveBriefingBudget(budgetPreset, {
-        max_tokens: 8e3,
-        max_memories: 8,
-        include_module_contexts: true
+    const u = getUsage(usage, fm.id);
+    const createdAt = Date.parse(fm.created_at);
+    const ageDays = Number.isFinite(createdAt) ? (Date.now() - createdAt) / (24 * 60 * 60 * 1e3) : 0;
+    if (fm.status === "validated" && u.read_count === 0 && ageDays >= 7) {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "info",
+        code: "NEVER_READ",
+        message: "Validated record has never been surfaced/read. Consider improving tags/anchors or archiving it if it is not useful."
       });
-      budgetTokensCap = presetNums.max_tokens;
-      maxMemories = presetNums.max_memories;
     }
-    const writer = budgetTokensCap !== null ? new TokenBudgetWriter(budgetTokensCap * CHARS_PER_TOKEN) : null;
-    const out = (text) => {
-      if (writer) return writer.write(text);
-      console.log(text);
-      return true;
-    };
-    const stopped = () => writer?.isTruncated() ?? false;
-    if (!existsSync(paths.memoriesDir)) {
-      if (existsSync(paths.projectContext)) {
-        out(`${ui.bold("=== Project Context ===")}
-`);
-        out((await readFile(paths.projectContext, "utf8")).trim());
-        out("");
-      } else {
-        ui.warn("No project-context.md found. Run `haive init` and the `bootstrap_project` MCP prompt to set it up.");
+    if (options.fix) {
+      const actions = [];
+      let nextBody = memory2.body;
+      let nextFrontmatter = memory2.frontmatter;
+      if (!hasMarkdownHeading) {
+        nextBody = `# ${titleFromId(fm.id)}
+
+${nextBody.trim()}`;
+        actions.push("add missing Markdown heading");
       }
-      if (opts.radar !== false && !stopped()) {
-        const filePathsEarly = parseCsv(opts.files);
-        const tokensEarly = opts.task ? tokenizeQuery(opts.task) : null;
-        const radar = await buildRadar({ root, taskTokens: tokensEarly, filePaths: filePathsEarly });
-        printRadar(radar, out, "low-memory-signal");
+      if (ANCHOR_TYPES.has(fm.type) && fm.anchor.paths.length === 0 && fm.status === "validated" && suggestedAnchors.paths.length > 0) {
+        nextFrontmatter = {
+          ...nextFrontmatter,
+          anchor: {
+            ...nextFrontmatter.anchor,
+            paths: [.../* @__PURE__ */ new Set([...nextFrontmatter.anchor.paths, ...suggestedAnchors.paths])],
+            symbols: [
+              .../* @__PURE__ */ new Set([...nextFrontmatter.anchor.symbols, ...suggestedAnchors.symbols])
+            ]
+          },
+          tags: nextFrontmatter.tags.filter((tag) => tag !== "needs_anchor")
+        };
+        actions.push("add suggested tracked anchor paths");
+        if (suggestedAnchors.symbols.length > 0) {
+          actions.push("add suggested anchor symbols");
+        }
+      }
+      if (ANCHOR_TYPES.has(fm.type) && fm.anchor.paths.length === 0 && fm.anchor.symbols.length === 0 && suggestedAnchors.paths.length === 0 && fm.status === "validated" && !fm.tags.includes("needs_anchor")) {
+        nextFrontmatter = {
+          ...nextFrontmatter,
+          tags: [...nextFrontmatter.tags, "needs_anchor"]
+        };
+        actions.push("tag validated anchorless record with needs_anchor");
+      }
+      if (actions.length > 0) {
+        fixes.push({ file: filePath, id: fm.id, actions, applied: Boolean(options.apply) });
+        if (options.apply) {
+          await writeFile(
+            filePath,
+            serializeMemory({ frontmatter: nextFrontmatter, body: nextBody }),
+            "utf8"
+          );
+        }
       }
-      return;
     }
-    const ownMemories = await loadMemoriesFromDir(paths.memoriesDir);
-    const externalRoots = [];
-    if (opts.include && opts.include.length > 0) {
-      for (const includePath of opts.include) {
-        try {
-          const otherRoot = findProjectRoot(includePath);
-          if (otherRoot === root) continue;
-          const otherPaths = resolveHaivePaths(otherRoot);
-          if (!existsSync(otherPaths.memoriesDir)) {
-            ui.warn(`--include ${includePath}: no .ai/memories at ${otherRoot} \u2014 skipping`);
-            continue;
-          }
-          const otherMemories = await loadMemoriesFromDir(otherPaths.memoriesDir);
-          const tag = path.basename(otherRoot);
-          for (const m of otherMemories) {
-            ownMemories.push({ ...m, origin: tag });
+  }
+  for (const dup of nearDuplicatePairs(loaded)) {
+    out.push({
+      file: dup.file,
+      id: dup.id,
+      severity: "warn",
+      code: "NEAR_DUPLICATE",
+      message: `Body overlaps ~${Math.round(dup.score * 100)}% with ${dup.otherId}. Merge or deprecate one record to reduce briefing noise.`
+    });
+  }
+  return { findings: out, fixes };
+}
+function titleFromId(id) {
+  const withoutDate = id.replace(/^\d{4}-\d{2}-\d{2}-/, "");
+  return withoutDate.split("-").filter(Boolean).map((part) => part.slice(0, 1).toUpperCase() + part.slice(1)).join(" ");
+}
+function suggestAnchors(root, loaded, codeMap, trackedFiles) {
+  const body = loaded.memory.body;
+  const paths = /* @__PURE__ */ new Set();
+  const symbols = /* @__PURE__ */ new Set();
+  for (const match of body.matchAll(/`([^`\n]+\.[A-Za-z0-9]+)`|(?:^|\s)([A-Za-z0-9_./-]+\.[A-Za-z0-9]+)/gm)) {
+    const candidate = (match[1] ?? match[2] ?? "").replace(/^\.?\//, "");
+    if (!candidate || candidate.startsWith("http")) continue;
+    if (existsSync(path.join(root, candidate)) && isSafeAnchorPath(candidate, trackedFiles)) {
+      paths.add(candidate);
+    }
+  }
+  if (codeMap) {
+    const lowered = body.toLowerCase();
+    for (const [file, entry] of Object.entries(codeMap.files)) {
+      for (const exp of entry.exports) {
+        if (!exp.name || exp.name.length < 4) continue;
+        if (lowered.includes(exp.name.toLowerCase())) {
+          if (isSafeAnchorPath(file, trackedFiles)) {
+            paths.add(file);
+            symbols.add(exp.name);
           }
-          externalRoots.push(`${tag} (${otherMemories.length})`);
-        } catch (err) {
-          ui.warn(`--include ${includePath}: ${err instanceof Error ? err.message : String(err)}`);
         }
+        if (paths.size >= 5 && symbols.size >= 5) break;
       }
-      if (externalRoots.length > 0) {
-        ui.info(`merged from: ${externalRoots.join(", ")}`);
-        console.log();
+      if (paths.size >= 5 && symbols.size >= 5) break;
+    }
+  }
+  return {
+    paths: [...paths].slice(0, 5),
+    symbols: [...symbols].slice(0, 5)
+  };
+}
+function gitTrackedFiles(root) {
+  const result = spawnSync("git", ["ls-files"], {
+    cwd: root,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+  if (result.status !== 0) return null;
+  const files = result.stdout.split("\n").map((line) => line.trim()).filter(Boolean);
+  return new Set(files);
+}
+function isSafeAnchorPath(file, trackedFiles) {
+  const normalized = file.replace(/\\/g, "/").replace(/^\.?\//, "");
+  if (normalized.startsWith(".ai/.cache/") || normalized.startsWith(".ai/.runtime/")) return false;
+  if (normalized.includes("/node_modules/") || normalized.startsWith("node_modules/")) return false;
+  if (normalized.includes("/dist/") || normalized.startsWith("dist/")) return false;
+  if (trackedFiles && !trackedFiles.has(normalized)) return false;
+  return true;
+}
+function nearDuplicatePairs(loaded) {
+  const out = [];
+  const candidates = loaded.filter(({ memory: memory2 }) => {
+    const fm = memory2.frontmatter;
+    return fm.type !== "session_recap" && fm.status !== "rejected" && fm.status !== "deprecated";
+  });
+  for (let i = 0; i < candidates.length; i++) {
+    for (let j = i + 1; j < candidates.length; j++) {
+      const a = candidates[i];
+      const b = candidates[j];
+      if (a.memory.frontmatter.scope !== b.memory.frontmatter.scope) continue;
+      if (a.memory.frontmatter.type !== b.memory.frontmatter.type) continue;
+      const score = jaccard(tokenSet(a.memory.body), tokenSet(b.memory.body));
+      if (score >= 0.72) {
+        out.push({
+          id: a.memory.frontmatter.id,
+          otherId: b.memory.frontmatter.id,
+          file: a.filePath,
+          score
+        });
       }
     }
-    const all = ownMemories;
-    const filePaths = markerFiles;
-    const tokens = opts.task ? tokenizeQuery(opts.task) : null;
-    const scopeFilter = opts.scope ?? "all";
-    const recaps = all.filter(({ memory: mem }) => mem.frontmatter.type === "session_recap").sort(
-      (a, b) => new Date(b.memory.frontmatter.created_at).getTime() - new Date(a.memory.frontmatter.created_at).getTime()
-    );
-    if (recaps.length > 0 && !stopped()) {
-      const recap = recaps[0];
-      const fm = recap.memory.frontmatter;
-      const rev = fm.revision_count ? ` \xB7 revision #${fm.revision_count}` : "";
-      out(`${ui.bold("=== Last Session Recap ===")}
-`);
-      out(ui.dim(`${fm.id} (${fm.scope}${rev})`));
-      out(recap.memory.body.trim());
-      out("");
+  }
+  return out;
+}
+function tokenSet(body) {
+  return new Set(
+    (body.toLowerCase().match(/\b[a-z0-9]{4,}\b/g) ?? []).filter((word) => !["this", "that", "with", "from", "have"].includes(word))
+  );
+}
+function jaccard(a, b) {
+  if (a.size === 0 || b.size === 0) return 0;
+  let inter = 0;
+  for (const item of a) if (b.has(item)) inter++;
+  return inter / (a.size + b.size - inter);
+}
+function registerMemoryLint(parent) {
+  parent.command("lint").description(
+    "Heuristic corpus checks (anchors on key types, headings, verbosity). Static analysis only."
+  ).option("--json", "emit findings as JSON", false).option("--fix", "prepare simple automatic fixes (use with --dry-run or --apply)", false).option("--dry-run", "with --fix, show files that would change without writing", false).option("--apply", "with --fix, write simple fixes to disk", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot(opts.dir);
+    const apply = Boolean(opts.fix && opts.apply);
+    const dryRun = Boolean(opts.fix && (opts.dryRun || !opts.apply));
+    const report = await lintMemoriesAsync(root, { fix: Boolean(opts.fix), apply });
+    const findings = report.findings;
+    if (opts.json) {
+      console.log(JSON.stringify({
+        findings_count: findings.length,
+        findings,
+        fixes_count: report.fixes.length,
+        fixes: report.fixes,
+        fix_mode: opts.fix ? apply ? "apply" : "dry-run" : "off"
+      }, null, 2));
+      process.exitCode = findings.some((f) => f.severity === "error") ? 1 : 0;
+      return;
     }
-    if (existsSync(paths.projectContext) && !stopped()) {
-      const ctx = await readFile(paths.projectContext, "utf8");
-      const isTemplate = ctx.includes("TODO \u2014 high-level overview") || ctx.includes("Generated by `haive init`");
-      if (isTemplate) {
-        ui.warn(
-          "project-context.md still contains the default template \u2014 get_briefing will return little value."
-        );
-        ui.warn(
-          "Fix: in your AI client, invoke the MCP prompt bootstrap_project to auto-fill it from your codebase."
-        );
-        out("");
-      } else {
-        out(`${ui.bold("=== Project Context ===")}
+    if (findings.length === 0) {
+      ui.success(`memory lint OK \u2014 ${root}`);
+      return;
+    }
+    console.log(ui.bold(`memory lint (${findings.length} finding${findings.length === 1 ? "" : "s"})`) + `
 `);
-        out(ctx.trim());
-        out("");
+    if (opts.fix) {
+      const mode = apply ? "apply" : dryRun ? "dry-run" : "dry-run";
+      const verb = apply ? "changed" : "would change";
+      console.log(ui.bold(`fix ${mode}: ${report.fixes.length} file${report.fixes.length === 1 ? "" : "s"} ${verb}`));
+      for (const fix of report.fixes) {
+        console.log(`  ${ui.dim(fix.id)} ${fix.actions.join("; ")}`);
+        console.log(ui.dim(`       \u2192 ${fix.file}`));
       }
-    } else if (!existsSync(paths.projectContext)) {
-      ui.warn(
-        "No project-context.md found. Run `haive init` then invoke the bootstrap_project MCP prompt."
-      );
+      console.log();
     }
-    const candidates = all.filter(({ memory: mem }) => {
-      const fm = mem.frontmatter;
-      if (fm.status === "rejected" || fm.status === "deprecated") return false;
-      if (!opts.includeDraft && fm.status === "draft") return false;
-      if (!opts.includeStale && fm.status === "stale") return false;
-      if (scopeFilter !== "all" && fm.scope !== scopeFilter && !(scopeFilter === "team" && fm.scope === "shared")) return false;
-      if (fm.type === "session_recap") return false;
-      return true;
-    });
-    const andTaskHits = tokens ? new Set(candidates.filter(({ memory: mem }) => literalMatchesAllTokens(mem, tokens)).map(({ memory: mem }) => mem.frontmatter.id)) : null;
-    const useOrFallback = andTaskHits !== null && andTaskHits.size === 0 && (tokens?.length ?? 0) > 1;
-    const scored = candidates.map(({ memory: mem, filePath }) => {
-      const fm = mem.frontmatter;
-      let score = 0;
-      if (fm.status === "validated") score += 3;
-      else if (fm.status === "proposed") score += 1;
-      if (filePaths.length > 0 && memoryMatchesAnchorPaths(mem, filePaths)) score += 4;
-      if (tokens) {
-        if (andTaskHits?.has(fm.id)) score += 3;
-        else if (useOrFallback && literalMatchesAnyToken(mem, tokens)) score += 1;
-      }
-      return { memory: mem, filePath, score };
-    });
-    scored.sort((a, b) => b.score - a.score);
-    const top = scored.slice(0, maxMemories);
-    if (top.length === 0) {
-      ui.info("No relevant memories found.");
-      const draftCount = all.filter(
-        (m) => m.memory.frontmatter.status === "draft" && (scopeFilter === "all" || m.memory.frontmatter.scope === scopeFilter)
-      ).length;
-      if (draftCount > 0) {
-        ui.info(`(${draftCount} draft memories excluded \u2014 use --include-draft to show)`);
-      }
-      if (opts.radar !== false && !stopped()) {
-        const radar = await buildRadar({ root, taskTokens: tokens, filePaths });
-        out("");
-        printRadar(radar, out, "low-memory-signal");
-      }
-      return;
-    }
-    if (stopped()) return;
-    const usageIndex = await loadUsageIndex(paths).catch(() => null);
-    out(`${ui.bold("=== Relevant Memories ===")}
-`);
-    const priorities = top.map(
-      (item) => classifyCliPriority(
-        item,
-        filePaths,
-        tokens,
-        Boolean(andTaskHits?.has(item.memory.frontmatter.id)),
-        Boolean(useOrFallback && tokens && literalMatchesAnyToken(item.memory, tokens))
-      )
-    );
-    const mustReadCount = priorities.filter((p) => p === "must_read").length;
-    const usefulCount = priorities.filter((p) => p === "useful").length;
-    const backgroundCount = priorities.filter((p) => p === "background").length;
-    const quality = mustReadCount > 0 || usefulCount > 0 ? backgroundCount > mustReadCount + usefulCount && backgroundCount > 2 ? "noisy" : "strong" : "thin";
-    out(ui.dim(`briefing_quality: ${quality} \xB7 must_read=${mustReadCount} useful=${usefulCount} background=${backgroundCount}`));
-    out("");
-    for (const [idx, item] of top.entries()) {
-      if (stopped()) break;
-      const fm = item.memory.frontmatter;
-      const badge = ui.statusBadge(fm.status);
-      const draftMarker = fm.status === "draft" ? ui.yellow(" [DRAFT]") : "";
-      const unverifiedMarker = fm.status === "proposed" ? ui.yellow(" [UNVERIFIED]") : "";
-      const originMarker = item.origin ? ` ${ui.yellow("[from " + item.origin + "]")}` : "";
-      const reads = usageIndex?.by_id[fm.id]?.read_count ?? 0;
-      const hitMarker = reads > 0 ? ` ${ui.dim("\xB7 " + reads + "\xD7 read")}` : "";
-      const priority = priorities[idx] ?? "background";
-      out(
-        `${ui.bold(fm.id)}  ${priorityBadge(priority)}  ${ui.dim(fm.scope + "/" + fm.type)}  ${badge}${draftMarker}${unverifiedMarker}${originMarker}${hitMarker}`
-      );
-      if (opts.explainSource) {
-        const relPath = path.relative(root, item.filePath);
-        const anchorPaths = fm.anchor?.paths ?? [];
-        const anchorSymbols = fm.anchor?.symbols ?? [];
-        const parts = [`source: ${relPath}`];
-        if (anchorPaths.length > 0) parts.push(`paths: ${anchorPaths.join(", ")}`);
-        if (anchorSymbols.length > 0) parts.push(`symbols: ${anchorSymbols.join(", ")}`);
-        out(ui.dim(`  [${parts.join(" \xB7 ")}]`));
-      }
-      const memBody = opts.memoryFormat?.toLowerCase() === "actions" ? extractActionsBriefBody(item.memory.body) : item.memory.body.trim();
-      out(memBody);
-      out("");
-    }
-    if (!stopped()) out(ui.dim(`${top.length} memor${top.length === 1 ? "y" : "ies"} surfaced`));
-    const ids = top.map(({ memory: mem }) => mem.frontmatter.id);
-    if (ids.length > 0) {
-      await trackReads(paths, ids).catch(() => {
-      });
-      await writeBriefingMarker(paths, {
-        task: opts.task ?? "CLI briefing",
-        source: "haive-briefing-cli",
-        sessionId: process.env.HAIVE_SESSION_ID,
-        memoryIds: ids,
-        files: filePaths
-      }).catch(() => {
-      });
-    }
-    const radarForced = opts.radar === true;
-    const radarAuto = opts.radar !== false && top.length < RADAR_AUTO_THRESHOLD;
-    if ((radarForced || radarAuto) && !stopped()) {
-      const radar = await buildRadar({ root, taskTokens: tokens, filePaths });
-      if (radarHasContent(radar)) {
-        out("");
-        printRadar(radar, out, radarForced ? "forced" : "low-memory-signal");
-      }
-    }
-    const requestedSymbols = (opts.symbols ?? "").split(",").map((s) => s.trim()).filter(Boolean);
-    if (requestedSymbols.length > 0 && !stopped()) {
-      const codeMap = await loadCodeMap(paths);
-      if (!codeMap) {
-        ui.warn("No code-map found. Run `haive index code` first to enable symbol lookup.");
-      } else {
-        out(`
-${ui.bold("=== Symbol Locations ===")}
-`);
-        for (const sym of requestedSymbols) {
-          if (stopped()) break;
-          const { files } = queryCodeMap(codeMap, { symbol: sym });
-          if (files.length === 0) {
-            out(`${ui.dim(sym)}  (not found in code-map)`);
-          } else {
-            for (const f of files) {
-              if (stopped()) break;
-              const exports = f.entry.exports.filter(
-                (e) => e.name.toLowerCase().includes(sym.toLowerCase())
-              );
-              for (const e of exports) {
-                if (stopped()) break;
-                const desc = e.description ? `  \u2014 ${e.description}` : "";
-                out(`${ui.bold(e.name)}  ${ui.dim(f.path + ":" + e.line)}  [${e.kind}]${desc}`);
-              }
-            }
-          }
-        }
-        out("");
+    const order = { error: 0, warn: 1, info: 2 };
+    findings.sort((a, b) => order[a.severity] - order[b.severity] || a.id.localeCompare(b.id));
+    for (const f of findings) {
+      const color = f.severity === "error" ? ui.red : f.severity === "warn" ? ui.yellow : ui.dim;
+      console.log(
+        `${color(f.severity.padEnd(5))} ${ui.dim(f.code)} ${f.id}`
+      );
+      console.log(`       ${f.message}`);
+      if (f.suggested_anchors) {
+        const pathHints = f.suggested_anchors.paths.length > 0 ? `paths: ${f.suggested_anchors.paths.join(", ")}` : "";
+        const symbolHints = f.suggested_anchors.symbols.length > 0 ? `symbols: ${f.suggested_anchors.symbols.join(", ")}` : "";
+        console.log(ui.dim(`       suggested anchors: ${[pathHints, symbolHints].filter(Boolean).join(" \xB7 ")}`));
       }
+      console.log(ui.dim(`       \u2192 ${f.file}`));
     }
+    process.exitCode = findings.some((x) => x.severity === "error") ? 1 : 0;
   });
 }
-function classifyCliPriority(item, filePaths, tokens, exactTaskHit, partialTaskHit) {
-  const fm = item.memory.frontmatter;
-  const anchored = filePaths.length > 0 && memoryMatchesAnchorPaths(item.memory, filePaths);
-  if (anchored || fm.type === "attempt" && exactTaskHit) return "must_read";
-  if (exactTaskHit || partialTaskHit || item.score >= 4 || tokens && fm.tags.some((tag) => tokens.includes(tag))) {
-    return "useful";
-  }
-  return "background";
-}
-function priorityBadge(priority) {
-  if (priority === "must_read") return ui.red("[must_read]");
-  if (priority === "useful") return ui.yellow("[useful]");
-  return ui.dim("[background]");
-}
-function parseCsv(value) {
-  if (!value) return [];
-  return value.split(",").map((s) => s.trim()).filter(Boolean);
-}
-function collectInclude(value, previous) {
-  return [...previous, value];
-}
 
-// src/commands/tui.ts
-import "commander";
-import { findProjectRoot as findProjectRoot2 } from "@hiveai/core";
-function registerTui(program2) {
-  program2.command("tui").description(
-    "Interactive terminal dashboard for browsing and managing memories.\n\n  Screens (switch with 1 / 2 / 3):\n    1 \u2014 Memories: list + preview, filter by status (Tab), actions (a/r/p/d)\n    2 \u2014 Health:   stale, pending review, anchorless memories\n    3 \u2014 Stats:    most-read, decaying, total counts\n\n  Key bindings:\n    \u2191 \u2193     navigate list\n    Tab     cycle status filter (all \u2192 proposed \u2192 validated \u2192 stale)\n    a       approve selected memory\n    r       reject selected memory\n    p       promote personal \u2192 team (proposed)\n    d       delete selected memory\n    q / Esc exit\n"
-  ).option("-d, --dir <dir>", "project root").action(async (opts) => {
-    if (!process.stdout.isTTY) {
-      console.error("haive tui requires an interactive terminal (TTY).");
-      process.exitCode = 1;
-      return;
+// src/utils/autopilot.ts
+async function applyAutopilotRepairs(root, paths, options = {}) {
+  const repairs = [];
+  const config = await loadConfig(paths);
+  if (options.applyConfig) {
+    const changed = await ensureAutopilotConfig(paths, config);
+    if (changed) {
+      repairs.push({
+        code: "autopilot-config",
+        message: "Enabled autopilot defaults in .ai/haive.config.json."
+      });
     }
-    const root = findProjectRoot2(opts.dir);
-    const { render } = await import("ink");
-    const { createElement } = await import("react");
-    const { Dashboard } = await import("./Dashboard-Y2AIWFZK.js");
-    const { waitUntilExit } = render(createElement(Dashboard, { root }));
-    await waitUntilExit();
-  });
-}
-
-// src/commands/embeddings.ts
-import { existsSync as existsSync2 } from "fs";
-import path2 from "path";
-import "commander";
-import { findProjectRoot as findProjectRoot3, resolveHaivePaths as resolveHaivePaths2 } from "@hiveai/core";
-function registerEmbeddings(program2) {
-  const embeddings = program2.command("embeddings").description("Manage local embeddings index for semantic search");
-  embeddings.command("index").description("Generate or refresh the embeddings index for all memories").option("-d, --dir <dir>", "project root").action(async (opts) => {
-    const root = findProjectRoot3(opts.dir);
-    const paths = resolveHaivePaths2(root);
-    if (!existsSync2(paths.memoriesDir)) {
-      ui.error(`No .ai/memories at ${root}. Run \`haive init\` first.`);
-      process.exitCode = 1;
-      return;
+  }
+  const current = await loadConfig(paths);
+  const autoRepair = current.autoRepair ?? {};
+  if (options.applyContext ?? autoRepair.context ?? current.autopilot) {
+    const changed = await syncProjectContextVersion(root, paths);
+    if (changed) {
+      repairs.push({
+        code: "project-context-version",
+        message: "Updated .ai/project-context.md version metadata from package.json."
+      });
     }
-    const { Embedder, rebuildIndex } = await loadEmbeddings();
-    ui.info("Loading embedding model (first run downloads ~110MB)\u2026");
-    const embedder = await Embedder.create();
-    ui.info(`Model ready: ${embedder.model} (dim=${embedder.dimension}). Indexing memories\u2026`);
-    const { report } = await rebuildIndex(paths, embedder);
-    ui.success(
-      `Indexed ${report.total} memories \u2014 added=${report.added} updated=${report.updated} unchanged=${report.unchanged} removed=${report.removed}`
-    );
-  });
-  embeddings.command("query <text>").description("Run a semantic search against the local embeddings index").option("-d, --dir <dir>", "project root").option("--limit <n>", "max results", "10").option("--min-score <n>", "minimum cosine similarity (0-1)", "0").action(async (text, opts) => {
-    const root = findProjectRoot3(opts.dir);
-    const paths = resolveHaivePaths2(root);
-    const { semanticSearch } = await loadEmbeddings();
-    const result = await semanticSearch(paths, text, {
-      limit: Number(opts.limit ?? 10),
-      minScore: Number(opts.minScore ?? 0)
-    });
-    if (!result) {
-      ui.error("No embeddings index found. Run `haive embeddings index` first.");
-      process.exitCode = 1;
-      return;
+  }
+  if (options.applyCorpus ?? autoRepair.corpus ?? current.autopilot) {
+    const report = await lintMemoriesAsync(root, { fix: true, apply: true });
+    const applied = report.fixes.filter((fix) => fix.applied);
+    if (applied.length > 0) {
+      repairs.push({
+        code: "memory-lint-fix",
+        message: `Applied ${applied.length} safe memory lint fix${applied.length === 1 ? "" : "es"}.`
+      });
     }
-    if (result.hits.length === 0) {
-      ui.info("No semantic matches above the threshold.");
-      return;
+    const indexed = await refreshMemorySemanticIndex(paths);
+    if (indexed) {
+      repairs.push({
+        code: "memory-embeddings-index",
+        message: "Refreshed memory embeddings index."
+      });
     }
-    for (const hit of result.hits) {
-      const score = hit.score.toFixed(3);
-      console.log(`${ui.bold(score)}  ${hit.id}`);
-      console.log(`       ${ui.dim(path2.relative(root, hit.file_path))}`);
+  }
+  if (options.applyCodeMap ?? autoRepair.codeMap ?? current.autopilot) {
+    const refreshed = await refreshCodeMap(root, paths, Boolean(options.forceCodeMap));
+    if (refreshed) {
+      repairs.push({
+        code: "code-map-refresh",
+        message: "Refreshed .ai/code-map.json."
+      });
     }
-  });
-  embeddings.command("status").description("Show the embeddings index status").option("-d, --dir <dir>", "project root").action(async (opts) => {
-    const root = findProjectRoot3(opts.dir);
-    const paths = resolveHaivePaths2(root);
-    const { indexStat } = await loadEmbeddings();
-    const stat2 = await indexStat(paths);
-    if (!stat2.exists) {
-      ui.warn("No embeddings index. Run `haive embeddings index` to create one.");
-      return;
+  }
+  if (options.applyCodeSearch ?? autoRepair.codeSearch ?? current.autopilot) {
+    const indexed = await refreshCodeSearchIndex(paths);
+    if (indexed) {
+      repairs.push({
+        code: "code-search-index",
+        message: "Refreshed code-search embeddings index."
+      });
     }
-    console.log(`${ui.bold("entries:")}    ${stat2.count}`);
-    console.log(`${ui.bold("model:")}      ${stat2.model}`);
-    console.log(`${ui.bold("updated_at:")} ${stat2.updatedAt}`);
-    console.log(`${ui.bold("size:")}       ${(stat2.sizeBytes / 1024).toFixed(1)} KB`);
-  });
-}
-async function loadEmbeddings() {
-  try {
-    return await import("@hiveai/embeddings");
-  } catch {
-    ui.error(
-      "Could not load @hiveai/embeddings. Run: npm install -g @hiveai/embeddings  (or `pnpm build` in the monorepo)"
-    );
-    process.exit(1);
   }
+  return repairs;
 }
-
-// src/commands/index-code.ts
-import path3 from "path";
-import "commander";
-import {
-  buildCodeMap,
-  codeMapPath,
-  findProjectRoot as findProjectRoot4,
-  resolveHaivePaths as resolveHaivePaths3,
-  saveCodeMap
-} from "@hiveai/core";
-function registerIndexCode(program2) {
-  const idx = program2.command("index").description(
-    "Build local indexes that let AIs look up symbols instead of grepping.\n\n  Run once after init, then haive sync refreshes it automatically when source changes."
-  );
-  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"
-  ).option("-d, --dir <dir>", "project root").option(
-    "--exclude <csv>",
-    "extra directory names to skip (comma-separated)",
-    ""
-  ).action(async (opts) => {
-    const root = findProjectRoot4(opts.dir);
-    const paths = resolveHaivePaths3(root);
-    const extraExcludes = (opts.exclude ?? "").split(",").map((s) => s.trim()).filter(Boolean);
-    ui.info(`Indexing source files in ${root}\u2026`);
-    const map = await buildCodeMap(root, {
-      includeUntracked: true,
-      excludeDirs: [
-        "node_modules",
-        "dist",
-        "build",
-        "out",
-        ".git",
-        ".next",
-        ".turbo",
-        ".vitest-cache",
-        "coverage",
-        ...extraExcludes
-      ]
-    });
-    await saveCodeMap(paths, map);
-    const fileCount = Object.keys(map.files).length;
-    const exportCount = Object.values(map.files).reduce((s, f) => s + f.exports.length, 0);
-    ui.success(
-      `Indexed ${fileCount} file(s) with ${exportCount} export(s) \u2192 ${path3.relative(root, codeMapPath(paths))}`
-    );
-  });
-  idx.command("code-search").description(
-    "Build the semantic-search embeddings index for code (powers the code_search MCP tool).\n\n  Reads .ai/code-map.json (run `haive index code` first) and embeds each exported\n  symbol's metadata (filename + name + kind + description).\n\n  Re-runs are incremental: unchanged entries keep their cached vectors, only the\n  diff is re-embedded. First run downloads the bge-small-en-v1.5 model (~110MB).\n"
-  ).option("-d, --dir <dir>", "project root").action(async (opts) => {
-    const root = findProjectRoot4(opts.dir);
-    const paths = resolveHaivePaths3(root);
-    let mod;
-    try {
-      mod = await import("@hiveai/embeddings");
-    } catch {
-      ui.error(
-        "@hiveai/embeddings is not installed. Install it (`pnpm add @hiveai/embeddings`) or run `haive embeddings install`."
-      );
-      process.exit(1);
-    }
-    ui.info("Loading embedder (first run downloads ~110MB)\u2026");
-    const embedder = await mod.Embedder.create();
-    ui.info(`Embedding code-map symbols\u2026`);
-    try {
-      const { report } = await mod.rebuildCodeIndex(paths, embedder);
-      ui.success(
-        `Code-search index ready: ${report.total} symbols (+${report.added} new, ~${report.updated} updated, =${report.unchanged} cached, -${report.removed} removed)`
-      );
-    } catch (err) {
-      ui.error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
+async function ensureAutopilotConfig(paths, currentConfig) {
+  const current = currentConfig ?? await loadConfig(paths);
+  const next = {
+    ...current,
+    autopilot: true,
+    defaultScope: "team",
+    defaultStatus: "validated",
+    autoApproveDelayHours: current.autoApproveDelayHours ?? AUTOPILOT_DEFAULTS.autoApproveDelayHours,
+    autoPromoteMinReads: current.autoPromoteMinReads ?? AUTOPILOT_DEFAULTS.autoPromoteMinReads,
+    autoSessionEnd: true,
+    autoContext: true,
+    autoRepair: {
+      context: true,
+      corpus: true,
+      codeMap: true,
+      codeSearch: current.autoRepair?.codeSearch ?? true
+    },
+    enforcement: {
+      ...AUTOPILOT_DEFAULTS.enforcement,
+      ...current.enforcement,
+      mode: "strict",
+      requireBriefingFirst: true,
+      requireSessionRecap: true,
+      requireMemoryVerify: true,
+      blockStaleDecisionChanges: true,
+      requireDecisionCoverage: true,
+      cleanupGeneratedArtifacts: true,
+      toolProfile: current.enforcement?.toolProfile ?? "enforcement"
     }
-  });
-}
-
-// src/commands/init.ts
-import { mkdir as mkdir5, readFile as readFile5, writeFile as writeFile6 } from "fs/promises";
-import { existsSync as existsSync9 } from "fs";
-import path10 from "path";
-import { spawnSync as spawnSync3 } from "child_process";
-import "commander";
-import {
-  AUTOPILOT_DEFAULTS as AUTOPILOT_DEFAULTS2,
-  buildCodeMap as buildCodeMap3,
-  resolveHaivePaths as resolveHaivePaths6,
-  saveCodeMap as saveCodeMap3,
-  saveConfig as saveConfig2
-} from "@hiveai/core";
-
-// src/commands/agent.ts
-import { spawnSync } from "child_process";
-import { existsSync as existsSync4 } from "fs";
-import { mkdir as mkdir3, writeFile as writeFile2 } from "fs/promises";
-import os2 from "os";
-import path5 from "path";
-import { createInterface } from "readline/promises";
-import "commander";
-import { findProjectRoot as findProjectRoot5, resolveHaivePaths as resolveHaivePaths4 } from "@hiveai/core";
-
-// src/commands/init-mcp-setup.ts
-import { readFile as readFile2, writeFile, mkdir as mkdir2 } from "fs/promises";
-import { existsSync as existsSync3 } from "fs";
-import path4 from "path";
-import os from "os";
-var HOME = os.homedir();
-var HAIVE_MCP_ENTRY = {
-  command: "haive",
-  args: ["mcp", "--stdio"]
-};
-function projectMcpEntry(root) {
-  return {
-    command: "haive",
-    args: ["mcp", "--stdio"],
-    env: { HAIVE_PROJECT_ROOT: root }
   };
+  if (JSON.stringify(current) === JSON.stringify(next)) return false;
+  await saveConfig(paths, next);
+  return true;
 }
-function cursorMcpPath() {
-  return path4.join(HOME, ".cursor", "mcp.json");
-}
-async function configureCursor() {
-  const mcpPath = cursorMcpPath();
-  const cursorDir = path4.join(HOME, ".cursor");
-  if (!existsSync3(cursorDir)) return { client: "Cursor", status: "not_installed" };
-  let config = {};
-  if (existsSync3(mcpPath)) {
-    try {
-      config = JSON.parse(await readFile2(mcpPath, "utf8"));
-    } catch {
-    }
+async function syncProjectContextVersion(root, paths) {
+  const status = await projectContextVersionStatus(root, paths);
+  if (!status.canSync || !status.expectedVersion) return false;
+  const original = await readFile(paths.projectContext, "utf8");
+  let updated = original.replace(
+    /^# Project context — hAIve \(v[^)]+\)$/m,
+    `# Project context \u2014 hAIve (v${status.expectedVersion})`
+  ).replace(
+    /> \*\*Current version\*\*: [^—\n]+—/m,
+    `> **Current version**: ${status.expectedVersion} \u2014`
+  );
+  if (updated === original && !original.includes("Current version")) {
+    updated = original.replace(
+      /^(> Repo-native context enforcement[^\n]*\n)/m,
+      `$1> **Current version**: ${status.expectedVersion} \u2014 @hiveai/core, cli, mcp, embeddings are versioned together.
+`
+    );
   }
-  config.mcpServers ??= {};
-  if (config.mcpServers["haive"]) return { client: "Cursor", status: "already_configured" };
-  config.mcpServers["haive"] = HAIVE_MCP_ENTRY;
-  await mkdir2(cursorDir, { recursive: true });
-  await writeFile(mcpPath, JSON.stringify(config, null, 2), "utf8");
-  return { client: "Cursor", status: "configured", path: mcpPath };
-}
-function vscodeMcpPath() {
-  const candidates = [
-    path4.join(HOME, ".config", "Code", "User", "mcp.json"),
-    // Linux
-    path4.join(HOME, "Library", "Application Support", "Code", "User", "mcp.json"),
-    // macOS
-    path4.join(HOME, "AppData", "Roaming", "Code", "User", "mcp.json"),
-    // Windows
-    path4.join(HOME, ".config", "Code - Insiders", "User", "mcp.json")
-  ];
-  for (const c of candidates) {
-    if (existsSync3(path4.dirname(c))) return c;
+  if (updated === original && !original.includes("Current version")) {
+    updated = original.replace(
+      /^(# Project context[^\n]*\n)/m,
+      `$1
+> **Current version**: ${status.expectedVersion}
+`
+    );
   }
-  return null;
+  if (updated === original) return false;
+  await writeFile2(paths.projectContext, updated, "utf8");
+  return true;
 }
-async function configureVSCode() {
-  const mcpPath = vscodeMcpPath();
-  if (!mcpPath) return { client: "VS Code", status: "not_installed" };
-  let config = {};
-  if (existsSync3(mcpPath)) {
-    try {
-      config = JSON.parse(await readFile2(mcpPath, "utf8"));
-    } catch {
-    }
+async function projectContextVersionStatus(root, paths) {
+  if (!existsSync2(paths.projectContext)) {
+    return { mismatch: false, canSync: false };
   }
-  config.servers ??= {};
-  if (config.servers["haive"]) return { client: "VS Code", status: "already_configured" };
-  config.servers["haive"] = { ...HAIVE_MCP_ENTRY, type: "stdio" };
-  await mkdir2(path4.dirname(mcpPath), { recursive: true });
-  await writeFile(mcpPath, JSON.stringify(config, null, 2), "utf8");
-  return { client: "VS Code", status: "configured", path: mcpPath };
-}
-function claudeConfigPath() {
-  const p = path4.join(HOME, ".claude.json");
-  if (existsSync3(p)) return p;
-  const p2 = path4.join(HOME, ".config", "claude", "claude.json");
-  if (existsSync3(path4.dirname(p2))) return p2;
-  return null;
-}
-async function configureClaude() {
-  const cfgPath = claudeConfigPath() ?? path4.join(HOME, ".claude.json");
-  if (!existsSync3(cfgPath) && !existsSync3(path4.join(HOME, ".claude"))) {
-    return { client: "Claude Code", status: "not_installed" };
+  const packagePath = path2.join(root, "package.json");
+  if (!existsSync2(packagePath)) {
+    return { mismatch: false, canSync: false };
   }
-  let config = {};
-  if (existsSync3(cfgPath)) {
-    try {
-      config = JSON.parse(await readFile2(cfgPath, "utf8"));
-    } catch {
-    }
+  const packageJson = JSON.parse(await readFile(packagePath, "utf8"));
+  const expectedVersion = packageJson.version;
+  if (!expectedVersion) {
+    return { mismatch: false, canSync: false };
   }
-  config.mcpServers ??= {};
-  if (config.mcpServers["haive"]) return { client: "Claude Code", status: "already_configured" };
-  config.mcpServers["haive"] = { ...HAIVE_MCP_ENTRY, type: "stdio" };
-  await writeFile(cfgPath, JSON.stringify(config, null, 2), "utf8");
-  return { client: "Claude Code", status: "configured", path: cfgPath };
+  const content = await readFile(paths.projectContext, "utf8");
+  const headingVersion = content.match(/^# Project context — hAIve \(v([^)]+)\)$/m)?.[1];
+  const currentLineVersion = content.match(/^> \*\*Current version\*\*: ([^—\n]+)/m)?.[1]?.trim();
+  const currentVersion = currentLineVersion ?? headingVersion;
+  return {
+    expectedVersion,
+    currentVersion,
+    mismatch: currentVersion !== expectedVersion,
+    canSync: true
+  };
 }
-function windsurfMcpPath() {
-  const candidates = [
-    path4.join(HOME, ".codeium", "windsurf", "mcp_config.json"),
-    path4.join(HOME, ".windsurf", "mcp.json")
-  ];
-  for (const c of candidates) {
-    if (existsSync3(path4.dirname(c))) return c;
+async function refreshCodeMap(root, paths, force) {
+  const existing = await loadCodeMap2(paths);
+  if (existing && !force) return false;
+  const map = await buildCodeMap(root, {
+    includeUntracked: true,
+    excludeDirs: [
+      "node_modules",
+      "dist",
+      "build",
+      "out",
+      ".git",
+      ".next",
+      ".turbo",
+      ".vitest-cache",
+      "coverage"
+    ]
+  });
+  if (existing && existing.root === map.root && JSON.stringify(existing.files) === JSON.stringify(map.files)) {
+    return false;
   }
-  return null;
+  await saveCodeMap(paths, map);
+  return true;
 }
-async function configureWindsurf() {
-  const mcpPath = windsurfMcpPath();
-  if (!mcpPath) return { client: "Windsurf", status: "not_installed" };
-  let config = {};
-  if (existsSync3(mcpPath)) {
-    try {
-      config = JSON.parse(await readFile2(mcpPath, "utf8"));
-    } catch {
-    }
+async function refreshCodeSearchIndex(paths) {
+  try {
+    const mod = await import("@hiveai/embeddings");
+    const embedder = await mod.Embedder.create();
+    const { report } = await mod.rebuildCodeIndex(paths, embedder);
+    return report.added > 0 || report.updated > 0 || report.removed > 0;
+  } catch {
+    return false;
   }
-  config.mcpServers ??= {};
-  if (config.mcpServers["haive"]) return { client: "Windsurf", status: "already_configured" };
-  config.mcpServers["haive"] = HAIVE_MCP_ENTRY;
-  await mkdir2(path4.dirname(mcpPath), { recursive: true });
-  await writeFile(mcpPath, JSON.stringify(config, null, 2), "utf8");
-  return { client: "Windsurf", status: "configured", path: mcpPath };
 }
-async function autoConfigureMcpClients() {
-  const results = [];
-  const configurators = [configureCursor, configureVSCode, configureClaude, configureWindsurf];
-  for (const fn of configurators) {
-    try {
-      results.push(await fn());
-    } catch (err) {
-      const name = fn.name.replace("configure", "");
-      results.push({ client: name, status: "error", error: String(err) });
-    }
-  }
-  return results;
-}
-async function configureProjectMcpClients(root) {
-  const entry = projectMcpEntry(root);
-  const results = [];
-  try {
-    const cursorPath = path4.join(root, ".cursor", "mcp.json");
-    let config = {};
-    if (existsSync3(cursorPath)) {
-      try {
-        config = JSON.parse(await readFile2(cursorPath, "utf8"));
-      } catch {
-      }
-    }
-    config.mcpServers ??= {};
-    config.mcpServers["haive"] = entry;
-    await mkdir2(path4.dirname(cursorPath), { recursive: true });
-    await writeFile(cursorPath, JSON.stringify(config, null, 2) + "\n", "utf8");
-    results.push({ client: "Cursor (project)", status: "configured", path: cursorPath });
-  } catch (err) {
-    results.push({ client: "Cursor (project)", status: "error", error: String(err) });
-  }
-  try {
-    const vscodePath = path4.join(root, ".vscode", "mcp.json");
-    let config = {};
-    if (existsSync3(vscodePath)) {
-      try {
-        config = JSON.parse(await readFile2(vscodePath, "utf8"));
-      } catch {
-      }
-    }
-    config.servers ??= {};
-    config.servers["haive"] = { ...entry, type: "stdio" };
-    await mkdir2(path4.dirname(vscodePath), { recursive: true });
-    await writeFile(vscodePath, JSON.stringify(config, null, 2) + "\n", "utf8");
-    results.push({ client: "VS Code (workspace)", status: "configured", path: vscodePath });
-  } catch (err) {
-    results.push({ client: "VS Code (workspace)", status: "error", error: String(err) });
-  }
+async function refreshMemorySemanticIndex(paths) {
   try {
-    const mcpPath = path4.join(root, ".mcp.json");
-    let config = {};
-    if (existsSync3(mcpPath)) {
-      try {
-        config = JSON.parse(await readFile2(mcpPath, "utf8"));
-      } catch {
-      }
-    }
-    config.mcpServers ??= {};
-    config.mcpServers["haive"] = { ...entry, type: "stdio" };
-    await writeFile(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf8");
-    results.push({ client: "Claude Code (project)", status: "configured", path: mcpPath });
-  } catch (err) {
-    results.push({ client: "Claude Code (project)", status: "error", error: String(err) });
+    if (!existsSync2(paths.memoriesDir)) return false;
+    const memories = await loadMemoriesFromDir2(paths.memoriesDir);
+    if (memories.length === 0) return false;
+    const mod = await import("@hiveai/embeddings");
+    const embedder = await mod.Embedder.create();
+    const { report } = await mod.rebuildIndex(paths, embedder);
+    return report.added > 0 || report.updated > 0 || report.removed > 0;
+  } catch {
+    return false;
   }
-  return results;
 }
 
-// src/commands/agent.ts
-function registerAgent(program2) {
-  const agent = program2.command("agent").description("Detect, configure, and report the best hAIve mode for AI coding agents.");
-  agent.command("detect").description("Detect available AI agents and hAIve MCP/wrapper readiness.").option("-d, --dir <dir>", "project root").option("--json", "emit JSON", false).action(async (opts) => {
-    const detection = await detectAgentMode(opts.dir);
-    printDetection(detection, Boolean(opts.json));
-  });
-  agent.command("status").description("Alias for agent detect.").option("-d, --dir <dir>", "project root").option("--json", "emit JSON", false).action(async (opts) => {
-    const detection = await detectAgentMode(opts.dir);
-    printDetection(detection, Boolean(opts.json));
-  });
-  agent.command("setup").description("Configure hAIve project MCP, optional global MCP clients, and wrapper fallback metadata.").option("-d, --dir <dir>", "project root").option("-y, --yes", "approve user-level/global MCP configuration without prompting", false).option("--no-global", "skip user-level/global MCP configuration").option("--json", "emit JSON", false).action(async (opts) => {
-    const result = await setupAgentMode(opts.dir, {
-      yes: Boolean(opts.yes),
-      global: opts.global !== false && opts.noGlobal !== true,
-      interactive: process.stdin.isTTY
-    });
-    if (opts.json) {
-      console.log(JSON.stringify(result, null, 2));
-      return;
+// src/commands/briefing.ts
+var RADAR_AUTO_THRESHOLD = 3;
+var CHARS_PER_TOKEN = 4;
+function printRadar(radar, out, reason) {
+  if (!radar.insideGitRepo) return;
+  if (!radarHasContent(radar)) return;
+  const header = reason === "low-memory-signal" ? "=== Project Radar (few relevant memories \u2014 surfacing live signals) ===" : "=== Project Radar ===";
+  out(`${ui.bold(header)}
+`);
+  if (radar.recentCommits.length > 0) {
+    out(ui.bold("Recent commits:"));
+    for (const c of radar.recentCommits) {
+      const filesBlurb = c.files.slice(0, 3).join(", ");
+      const more = c.files.length > 3 ? ` (+${c.files.length - 3})` : "";
+      out(`  ${ui.dim(c.date)} ${c.sha}  ${c.subject}`);
+      if (filesBlurb) out(ui.dim(`    ${filesBlurb}${more}`));
     }
-    printSetupResult(result);
-  });
-}
-async function setupAgentMode(dir, opts = {}) {
-  const root = findProjectRoot5(dir);
-  const paths = resolveHaivePaths4(root);
-  const projectResults = await configureProjectMcpClients(root);
-  const detectionBeforeGlobal = await detectAgentMode(root);
-  let globalResults = [];
-  let globalSkippedReason;
-  const shouldConsiderGlobal = opts.global !== false;
-  if (shouldConsiderGlobal) {
-    const approved = opts.yes === true || (opts.interactive ? await confirmGlobalSetup() : false);
-    if (approved) {
-      globalResults = await autoConfigureMcpClients();
-      const codex = await configureCodexIfAvailable(root);
-      if (codex) globalResults.push(codex);
-    } else {
-      globalSkippedReason = opts.interactive ? "User declined user-level/global MCP configuration." : "Non-interactive shell; skipped user-level/global MCP configuration. Re-run `haive agent setup --yes` to apply it.";
+    out("");
+  }
+  if (radar.openTodos.length > 0) {
+    out(ui.bold("Open TODOs/FIXMEs:"));
+    for (const t of radar.openTodos) {
+      out(`  ${ui.dim(t.file + ":" + t.line)}  ${t.text}`);
     }
-  } else {
-    globalSkippedReason = "User-level/global MCP configuration disabled.";
+    out("");
   }
-  const detection = await detectAgentMode(root);
-  const modeFile = await writeAgentModeRecord(paths, detection, globalSkippedReason);
-  return {
-    detection,
-    project_results: projectResults,
-    global_results: globalResults,
-    mode_file: modeFile,
-    ...globalSkippedReason ? { global_skipped_reason: globalSkippedReason } : {}
-  };
-}
-async function detectAgentMode(dir) {
-  const root = findProjectRoot5(dir);
-  const paths = resolveHaivePaths4(root);
-  const projectMcp = [
-    { client: "Claude Code", path: path5.join(root, ".mcp.json"), present: existsSync4(path5.join(root, ".mcp.json")) },
-    { client: "Cursor", path: path5.join(root, ".cursor", "mcp.json"), present: existsSync4(path5.join(root, ".cursor", "mcp.json")) },
-    { client: "VS Code", path: path5.join(root, ".vscode", "mcp.json"), present: existsSync4(path5.join(root, ".vscode", "mcp.json")) }
-  ];
-  const installedAgents = [
-    { agent: "Codex", command: "codex", installed: commandExists("codex"), mcp_configured: codexMcpConfigured() },
-    { agent: "Claude", command: "claude", installed: commandExists("claude") },
-    { agent: "Aider", command: "aider", installed: commandExists("aider") },
-    { agent: "Cursor", command: "cursor", installed: commandExists("cursor") }
-  ];
-  const hasProjectMcp = projectMcp.some((item) => item.present);
-  const hasNativeMcp = hasProjectMcp || installedAgents.some((a) => a.mcp_configured);
-  const wrapperAgent = installedAgents.find((a) => a.installed && ["codex", "claude", "aider"].includes(a.command));
-  const recommendedMode = hasNativeMcp ? "mcp" : wrapperAgent ? "wrapped" : "fallback";
-  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: existsSync4(paths.haiveDir),
-    project_mcp: projectMcp,
-    installed_agents: installedAgents,
-    recommended_mode: recommendedMode,
-    recommended_command: recommendedCommand
-  };
-}
-async function writeAgentModeRecord(paths, detection, skippedReason) {
-  const dir = path5.join(paths.runtimeDir, "enforcement");
-  await mkdir3(dir, { recursive: true });
-  const file = path5.join(dir, "agent-mode.json");
-  const record = {
-    selected_mode: detection.recommended_mode,
-    recommended_command: detection.recommended_command,
-    configured_at: (/* @__PURE__ */ new Date()).toISOString(),
-    project_root: detection.root,
-    notes: [
-      "mcp = native hAIve MCP tools are available or project MCP config exists.",
-      "wrapped = use haive run when native MCP is unavailable.",
-      "fallback = use haive briefing/enforce manually.",
-      ...skippedReason ? [skippedReason] : []
-    ]
-  };
-  await writeFile2(file, JSON.stringify(record, null, 2) + "\n", "utf8");
-  return file;
-}
-async function confirmGlobalSetup() {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = await rl.question(
-      "Configure hAIve in user-level AI client configs (Cursor/VS Code/Claude/Codex when detected)? [y/N] "
-    );
-    return /^y(es)?$/i.test(answer.trim());
-  } finally {
-    rl.close();
+  if (radar.hotFiles.length > 0) {
+    out(ui.bold("Hot files (most modified recently):"));
+    for (const f of radar.hotFiles) {
+      out(`  ${f.changes}\xD7 ${ui.dim(f.path)}`);
+    }
+    out("");
   }
 }
-async function configureCodexIfAvailable(root) {
-  if (!commandExists("codex")) return { client: "Codex", status: "not_installed" };
-  if (codexMcpConfigured()) return { client: "Codex", status: "already_configured" };
-  const result = spawnSync("codex", [
-    "mcp",
-    "add",
-    "haive",
-    "--env",
-    `HAIVE_PROJECT_ROOT=${root}`,
-    "--",
-    "haive",
-    "mcp",
-    "--stdio"
-  ], { encoding: "utf8" });
-  if (result.status === 0) return { client: "Codex", status: "configured", path: path5.join(os2.homedir(), ".codex", "config.toml") };
-  return { client: "Codex", status: "error", error: result.stderr || result.stdout || "codex mcp add failed" };
-}
-function commandExists(command) {
-  const result = spawnSync(process.platform === "win32" ? "where" : "which", [command], {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-  return result.status === 0;
-}
-function codexMcpConfigured() {
-  if (!commandExists("codex")) return false;
-  const result = spawnSync("codex", ["mcp", "get", "haive"], {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-  return result.status === 0;
-}
-function printDetection(detection, json) {
-  if (json) {
-    console.log(JSON.stringify(detection, null, 2));
-    return;
-  }
-  console.log(ui.bold("hAIve agent status"));
-  console.log(ui.dim(`  root: ${detection.root}`));
-  console.log(`${detection.initialized ? ui.green("\u2713") : ui.red("\u2717")} project initialized`);
-  for (const cfg of detection.project_mcp) {
-    console.log(`${cfg.present ? ui.green("\u2713") : ui.yellow("\u2022")} ${cfg.client} project MCP ${ui.dim(path5.relative(detection.root, cfg.path))}`);
+var TokenBudgetWriter = class {
+  constructor(budgetChars) {
+    this.budgetChars = budgetChars;
   }
-  for (const agent of detection.installed_agents) {
-    const marker = agent.installed ? ui.green("\u2713") : ui.dim("\u2022");
-    const mcp = agent.mcp_configured === true ? " + hAIve MCP" : "";
-    console.log(`${marker} ${agent.agent} (${agent.command})${mcp}`);
+  budgetChars;
+  used = 0;
+  truncated = false;
+  write(text) {
+    if (this.truncated) return false;
+    const next = this.used + text.length + 1;
+    if (next > this.budgetChars) {
+      console.log(ui.dim(`... [briefing truncated to fit --max-tokens budget \xB7 ${Math.round(this.used / CHARS_PER_TOKEN)} tokens used]`));
+      this.truncated = true;
+      return false;
+    }
+    console.log(text);
+    this.used = next;
+    return true;
   }
-  console.log(ui.bold(`Recommended mode: ${detection.recommended_mode}`));
-  console.log(`  ${detection.recommended_command}`);
-}
-function printSetupResult(result) {
-  for (const item of result.project_results) {
-    if (item.status === "configured") ui.success(`${item.client} project MCP config written (${item.path})`);
-    else if (item.status === "already_configured") ui.info(`${item.client} already configured`);
-    else if (item.status === "error") ui.warn(`${item.client}: ${item.error}`);
+  isTruncated() {
+    return this.truncated;
   }
-  for (const item of result.global_results) {
-    if (item.status === "configured") ui.success(`${item.client} user-level MCP configured${item.path ? ` (${item.path})` : ""}`);
-    else if (item.status === "already_configured") ui.info(`${item.client} user-level MCP already configured`);
-    else if (item.status === "not_installed") ui.info(`${item.client} not detected`);
-    else if (item.status === "error") ui.warn(`${item.client}: ${item.error}`);
+  remainingChars() {
+    return Math.max(0, this.budgetChars - this.used);
   }
-  if (result.global_skipped_reason) ui.warn(result.global_skipped_reason);
-  ui.success(`Agent mode recorded at ${result.mode_file}`);
-  printDetection(result.detection, false);
-}
-
-// src/utils/autopilot.ts
-import { existsSync as existsSync6 } from "fs";
-import { readFile as readFile3, writeFile as writeFile4 } from "fs/promises";
-import path7 from "path";
-import {
-  AUTOPILOT_DEFAULTS,
-  buildCodeMap as buildCodeMap2,
-  loadCodeMap as loadCodeMap3,
-  loadConfig,
-  loadMemoriesFromDir as loadMemoriesFromDir3,
-  saveCodeMap as saveCodeMap2,
-  saveConfig
-} from "@hiveai/core";
-
-// src/commands/memory-lint.ts
-import { existsSync as existsSync5 } from "fs";
-import { writeFile as writeFile3 } from "fs/promises";
-import { spawnSync as spawnSync2 } from "child_process";
-import path6 from "path";
-import "commander";
-import {
-  findProjectRoot as findProjectRoot6,
-  getUsage,
-  loadCodeMap as loadCodeMap2,
-  loadMemoriesFromDir as loadMemoriesFromDir2,
-  loadUsageIndex as loadUsageIndex2,
-  resolveHaivePaths as resolveHaivePaths5,
-  serializeMemory
-} from "@hiveai/core";
-async function lintMemoriesAsync(root, options = {}) {
-  const paths = resolveHaivePaths5(root);
-  const out = [];
-  const fixes = [];
-  if (!existsSync5(paths.memoriesDir)) return { findings: out, fixes };
-  const loaded = await loadMemoriesFromDir2(paths.memoriesDir);
-  const usage = await loadUsageIndex2(paths);
-  const codeMap = await loadCodeMap2(paths);
-  const trackedFiles = gitTrackedFiles(root);
-  const ANCHOR_TYPES = /* @__PURE__ */ new Set(["decision", "architecture", "gotcha"]);
-  const actionableWords = /\b(always|never|prefer|use|run|avoid|because|instead|why|rationale|do not|must|should|require|required|requires|fix|fail|failed|fails|prevent|prevents|allow|allows|lets|ensure|ensures|catch|catches)\b/i;
-  for (const { filePath, memory: memory2 } of loaded) {
-    const fm = memory2.frontmatter;
-    if (fm.type === "session_recap") continue;
-    const body = memory2.body.trim();
-    const naked = body.replace(/^#.*$/gm, "").replace(/```[\s\S]*?```/g, "").trim();
-    if (naked.length < 40 && fm.status !== "rejected") {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "warn",
-        code: "SHORT_BODY",
-        message: "Body looks very short (< ~40 chars of prose after headings). Prefer actionable detail."
+};
+function registerBriefing(program2) {
+  program2.command("briefing").description(
+    'Print the full project briefing: last session recap + project context + relevant memories.\n  Equivalent to calling get_briefing via MCP. Run before starting any task.\n\n  Examples:\n    haive briefing\n    haive briefing --task "add Stripe payment" --files src/payments/PaymentService.ts\n    haive briefing --budget quick --task "tiny fix"\n'
+  ).option("--task <text>", "what you are about to do \u2014 filters memories by relevance").option("--files <csv>", "comma-separated file paths being worked on (surfaces anchored memories)").option("--symbols <csv>", "symbol names to look up in the code-map (e.g. PaymentService,TenantFilter) \u2014 requires haive index code").option("--max-memories <n>", "cap on memories surfaced", "8").option("--max-tokens <n>", "approximate token budget for the entire briefing (truncates if exceeded)").option("--explain-source", "annotate each memory with [source: <relative-path> \xB7 anchors: <files>] for traceable citations").option("--radar", "force project radar (recent commits, open TODOs, hot files) even when memories are plentiful").option("--no-radar", "disable the project radar even when memories are scarce").option(
+    "--budget <preset>",
+    "align with MCP get_briefing budget_preset: quick | balanced | deep \u2014 sets cap + truncation budget (overrides --max-memories / replaces default open-ended output)",
+    void 0
+  ).option(
+    "--memory-format <mode>",
+    "printed memory bodies: full (default) | actions (cheap bullet-focused excerpt)",
+    "full"
+  ).option(
+    "--format <mode>",
+    "alias for --memory-format; accepts full | actions | compact"
+  ).option(
+    "--scope <scope>",
+    "personal | team | shared | all (default: all \u2014 includes team + shared cross-repo memories)",
+    "all"
+  ).option("--include-draft", "include draft memories (excluded by default)").option("--include-stale", "include stale memories (excluded by default \u2014 may be outdated)").option(
+    "--include <path>",
+    "merge memories from another haive-initialized project (repeatable). Useful for teams with multiple coordinated repos (e.g. backend + frontend).",
+    collectInclude,
+    []
+  ).option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot2(opts.dir);
+    const paths = resolveHaivePaths2(root);
+    const requestedFormat = (opts.format ?? opts.memoryFormat ?? "full").toLowerCase();
+    opts.memoryFormat = requestedFormat === "compact" ? "actions" : requestedFormat;
+    const markerFiles = parseCsv(opts.files);
+    if (existsSync3(paths.haiveDir)) {
+      await applyAutopilotRepairs(root, paths, {
+        applyConfig: false,
+        applyContext: true,
+        applyCorpus: true,
+        applyCodeMap: false,
+        applyCodeSearch: true
+      }).catch(() => {
       });
     }
-    if (["decision", "gotcha", "convention", "architecture", "attempt"].includes(fm.type) && fm.status !== "rejected" && !actionableWords.test(naked)) {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "info",
-        code: "LOW_ACTIONABILITY",
-        message: "Record does not contain obvious action/rationale words. Add the concrete rule, why it exists, and what to do instead."
+    if (existsSync3(paths.haiveDir)) {
+      await mkdir(paths.runtimeDir, { recursive: true });
+      await writeBriefingMarker(paths, {
+        task: opts.task ?? "CLI briefing",
+        source: "haive-briefing-cli",
+        sessionId: process.env.HAIVE_SESSION_ID,
+        files: markerFiles
+      }).catch(() => {
       });
     }
-    const suggestedAnchors = suggestAnchors(root, { filePath, memory: memory2 }, codeMap, trackedFiles);
-    if (ANCHOR_TYPES.has(fm.type) && fm.anchor.paths.length === 0 && fm.status === "validated") {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "warn",
-        code: "MISSING_ANCHOR",
-        message: `${fm.type} is validated without anchor paths \u2014 add anchor.paths so haive sync can flag staleness.`,
-        ...suggestedAnchors.paths.length > 0 || suggestedAnchors.symbols.length > 0 ? { suggested_anchors: suggestedAnchors } : {}
-      });
+    let budgetPreset = null;
+    if (opts.budget) {
+      const b = opts.budget.trim().toLowerCase();
+      if (b === "quick" || b === "balanced" || b === "deep") budgetPreset = b;
+      else ui.warn(`Unknown --budget '${opts.budget}' \u2014 ignoring (use quick|balanced|deep).`);
     }
-    if (fm.status === "stale" && !fm.stale_reason) {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "info",
-        code: "STALE_NO_REASON",
-        message: "Status is stale but stale_reason is empty \u2014 document why when possible."
+    let maxMemories = Math.max(1, Number(opts.maxMemories ?? 8));
+    let budgetTokensCap = opts.maxTokens ? Math.max(100, Number(opts.maxTokens)) : null;
+    if (budgetPreset !== null) {
+      const presetNums = resolveBriefingBudget(budgetPreset, {
+        max_tokens: 8e3,
+        max_memories: 8,
+        include_module_contexts: true
       });
+      budgetTokensCap = presetNums.max_tokens;
+      maxMemories = presetNums.max_memories;
     }
-    if (fm.type === "glossary" && naked.length > 6e3) {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "info",
-        code: "LONG_GLOSSARY",
-        message: "Very long glossary \u2014 consider splitting concepts for tighter briefings."
-      });
+    const writer = budgetTokensCap !== null ? new TokenBudgetWriter(budgetTokensCap * CHARS_PER_TOKEN) : null;
+    const out = (text) => {
+      if (writer) return writer.write(text);
+      console.log(text);
+      return true;
+    };
+    const stopped = () => writer?.isTruncated() ?? false;
+    if (!existsSync3(paths.memoriesDir)) {
+      if (existsSync3(paths.projectContext)) {
+        out(`${ui.bold("=== Project Context ===")}
+`);
+        out((await readFile2(paths.projectContext, "utf8")).trim());
+        out("");
+      } else {
+        ui.warn("No project-context.md found. Run `haive init` and the `bootstrap_project` MCP prompt to set it up.");
+      }
+      if (opts.radar !== false && !stopped()) {
+        const filePathsEarly = parseCsv(opts.files);
+        const tokensEarly = opts.task ? tokenizeQuery(opts.task) : null;
+        const radar = await buildRadar({ root, taskTokens: tokensEarly, filePaths: filePathsEarly });
+        printRadar(radar, out, "low-memory-signal");
+      }
+      return;
     }
-    const hasMarkdownHeading = /^#{1,3}\s+\S/m.test(memory2.body.trim());
-    if (!hasMarkdownHeading) {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "warn",
-        code: "NO_MD_HEADING",
-        message: "No Markdown heading (#/##/###) \u2014 add one so humans and auditors can skim the memo quickly."
-      });
+    const ownMemories = await loadMemoriesFromDir3(paths.memoriesDir);
+    const externalRoots = [];
+    if (opts.include && opts.include.length > 0) {
+      for (const includePath of opts.include) {
+        try {
+          const otherRoot = findProjectRoot2(includePath);
+          if (otherRoot === root) continue;
+          const otherPaths = resolveHaivePaths2(otherRoot);
+          if (!existsSync3(otherPaths.memoriesDir)) {
+            ui.warn(`--include ${includePath}: no .ai/memories at ${otherRoot} \u2014 skipping`);
+            continue;
+          }
+          const otherMemories = await loadMemoriesFromDir3(otherPaths.memoriesDir);
+          const tag = path3.basename(otherRoot);
+          for (const m of otherMemories) {
+            ownMemories.push({ ...m, origin: tag });
+          }
+          externalRoots.push(`${tag} (${otherMemories.length})`);
+        } catch (err) {
+          ui.warn(`--include ${includePath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
+      if (externalRoots.length > 0) {
+        ui.info(`merged from: ${externalRoots.join(", ")}`);
+        console.log();
+      }
     }
-    const u = getUsage(usage, fm.id);
-    const createdAt = Date.parse(fm.created_at);
-    const ageDays = Number.isFinite(createdAt) ? (Date.now() - createdAt) / (24 * 60 * 60 * 1e3) : 0;
-    if (fm.status === "validated" && u.read_count === 0 && ageDays >= 7) {
-      out.push({
-        file: filePath,
-        id: fm.id,
-        severity: "info",
-        code: "NEVER_READ",
-        message: "Validated record has never been surfaced/read. Consider improving tags/anchors or archiving it if it is not useful."
-      });
+    const all = ownMemories;
+    const filePaths = markerFiles;
+    const tokens = opts.task ? tokenizeQuery(opts.task) : null;
+    const scopeFilter = opts.scope ?? "all";
+    const recaps = all.filter(({ memory: mem }) => mem.frontmatter.type === "session_recap").sort(
+      (a, b) => new Date(b.memory.frontmatter.created_at).getTime() - new Date(a.memory.frontmatter.created_at).getTime()
+    );
+    if (recaps.length > 0 && !stopped()) {
+      const recap = recaps[0];
+      const fm = recap.memory.frontmatter;
+      const rev = fm.revision_count ? ` \xB7 revision #${fm.revision_count}` : "";
+      out(`${ui.bold("=== Last Session Recap ===")}
+`);
+      out(ui.dim(`${fm.id} (${fm.scope}${rev})`));
+      out(recap.memory.body.trim());
+      out("");
     }
-    if (options.fix) {
-      const actions = [];
-      let nextBody = memory2.body;
-      let nextFrontmatter = memory2.frontmatter;
-      if (!hasMarkdownHeading) {
-        nextBody = `# ${titleFromId(fm.id)}
-
-${nextBody.trim()}`;
-        actions.push("add missing Markdown heading");
+    if (existsSync3(paths.projectContext) && !stopped()) {
+      const ctx = await readFile2(paths.projectContext, "utf8");
+      const isTemplate = ctx.includes("TODO \u2014 high-level overview") || ctx.includes("Generated by `haive init`");
+      if (isTemplate) {
+        ui.warn(
+          "project-context.md still contains the default template \u2014 get_briefing will return little value."
+        );
+        ui.warn(
+          "Fix: in your AI client, invoke the MCP prompt bootstrap_project to auto-fill it from your codebase."
+        );
+        out("");
+      } else {
+        out(`${ui.bold("=== Project Context ===")}
+`);
+        out(ctx.trim());
+        out("");
       }
-      if (ANCHOR_TYPES.has(fm.type) && fm.anchor.paths.length === 0 && fm.status === "validated" && suggestedAnchors.paths.length > 0) {
-        nextFrontmatter = {
-          ...nextFrontmatter,
-          anchor: {
-            ...nextFrontmatter.anchor,
-            paths: [.../* @__PURE__ */ new Set([...nextFrontmatter.anchor.paths, ...suggestedAnchors.paths])],
-            symbols: [
-              .../* @__PURE__ */ new Set([...nextFrontmatter.anchor.symbols, ...suggestedAnchors.symbols])
-            ]
-          },
-          tags: nextFrontmatter.tags.filter((tag) => tag !== "needs_anchor")
-        };
-        actions.push("add suggested tracked anchor paths");
-        if (suggestedAnchors.symbols.length > 0) {
-          actions.push("add suggested anchor symbols");
-        }
+    } else if (!existsSync3(paths.projectContext)) {
+      ui.warn(
+        "No project-context.md found. Run `haive init` then invoke the bootstrap_project MCP prompt."
+      );
+    }
+    const candidates = all.filter(({ memory: mem }) => {
+      const fm = mem.frontmatter;
+      if (fm.status === "rejected" || fm.status === "deprecated") return false;
+      if (!opts.includeDraft && fm.status === "draft") return false;
+      if (!opts.includeStale && fm.status === "stale") return false;
+      if (scopeFilter !== "all" && fm.scope !== scopeFilter && !(scopeFilter === "team" && fm.scope === "shared")) return false;
+      if (fm.type === "session_recap") return false;
+      return true;
+    });
+    const andTaskHits = tokens ? new Set(candidates.filter(({ memory: mem }) => literalMatchesAllTokens(mem, tokens)).map(({ memory: mem }) => mem.frontmatter.id)) : null;
+    const useOrFallback = andTaskHits !== null && andTaskHits.size === 0 && (tokens?.length ?? 0) > 1;
+    const scored = candidates.map(({ memory: mem, filePath }) => {
+      const fm = mem.frontmatter;
+      let score = 0;
+      if (fm.status === "validated") score += 3;
+      else if (fm.status === "proposed") score += 1;
+      if (filePaths.length > 0 && memoryMatchesAnchorPaths(mem, filePaths)) score += 4;
+      if (tokens) {
+        if (andTaskHits?.has(fm.id)) score += 3;
+        else if (useOrFallback && literalMatchesAnyToken(mem, tokens)) score += 1;
       }
-      if (ANCHOR_TYPES.has(fm.type) && fm.anchor.paths.length === 0 && fm.anchor.symbols.length === 0 && suggestedAnchors.paths.length === 0 && fm.status === "validated" && !fm.tags.includes("needs_anchor")) {
-        nextFrontmatter = {
-          ...nextFrontmatter,
-          tags: [...nextFrontmatter.tags, "needs_anchor"]
-        };
-        actions.push("tag validated anchorless record with needs_anchor");
+      return { memory: mem, filePath, score };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    const top = scored.slice(0, maxMemories);
+    if (top.length === 0) {
+      ui.info("No relevant memories found.");
+      const draftCount = all.filter(
+        (m) => m.memory.frontmatter.status === "draft" && (scopeFilter === "all" || m.memory.frontmatter.scope === scopeFilter)
+      ).length;
+      if (draftCount > 0) {
+        ui.info(`(${draftCount} draft memories excluded \u2014 use --include-draft to show)`);
       }
-      if (actions.length > 0) {
-        fixes.push({ file: filePath, id: fm.id, actions, applied: Boolean(options.apply) });
-        if (options.apply) {
-          await writeFile3(
-            filePath,
-            serializeMemory({ frontmatter: nextFrontmatter, body: nextBody }),
-            "utf8"
-          );
+      if (opts.radar !== false && !stopped()) {
+        const radar = await buildRadar({ root, taskTokens: tokens, filePaths });
+        out("");
+        printRadar(radar, out, "low-memory-signal");
+      }
+      return;
+    }
+    if (stopped()) return;
+    const usageIndex = await loadUsageIndex2(paths).catch(() => null);
+    out(`${ui.bold("=== Relevant Memories ===")}
+`);
+    const priorities = top.map(
+      (item) => classifyCliPriority(
+        item,
+        filePaths,
+        tokens,
+        Boolean(andTaskHits?.has(item.memory.frontmatter.id)),
+        Boolean(useOrFallback && tokens && literalMatchesAnyToken(item.memory, tokens))
+      )
+    );
+    const mustReadCount = priorities.filter((p) => p === "must_read").length;
+    const usefulCount = priorities.filter((p) => p === "useful").length;
+    const backgroundCount = priorities.filter((p) => p === "background").length;
+    const quality = mustReadCount > 0 || usefulCount > 0 ? backgroundCount > mustReadCount + usefulCount && backgroundCount > 2 ? "noisy" : "strong" : "thin";
+    out(ui.dim(`briefing_quality: ${quality} \xB7 must_read=${mustReadCount} useful=${usefulCount} background=${backgroundCount}`));
+    out("");
+    for (const [idx, item] of top.entries()) {
+      if (stopped()) break;
+      const fm = item.memory.frontmatter;
+      const badge = ui.statusBadge(fm.status);
+      const draftMarker = fm.status === "draft" ? ui.yellow(" [DRAFT]") : "";
+      const unverifiedMarker = fm.status === "proposed" ? ui.yellow(" [UNVERIFIED]") : "";
+      const originMarker = item.origin ? ` ${ui.yellow("[from " + item.origin + "]")}` : "";
+      const reads = usageIndex?.by_id[fm.id]?.read_count ?? 0;
+      const hitMarker = reads > 0 ? ` ${ui.dim("\xB7 " + reads + "\xD7 read")}` : "";
+      const priority = priorities[idx] ?? "background";
+      out(
+        `${ui.bold(fm.id)}  ${priorityBadge(priority)}  ${ui.dim(fm.scope + "/" + fm.type)}  ${badge}${draftMarker}${unverifiedMarker}${originMarker}${hitMarker}`
+      );
+      if (opts.explainSource) {
+        const relPath = path3.relative(root, item.filePath);
+        const anchorPaths = fm.anchor?.paths ?? [];
+        const anchorSymbols = fm.anchor?.symbols ?? [];
+        const parts = [`source: ${relPath}`];
+        if (anchorPaths.length > 0) parts.push(`paths: ${anchorPaths.join(", ")}`);
+        if (anchorSymbols.length > 0) parts.push(`symbols: ${anchorSymbols.join(", ")}`);
+        out(ui.dim(`  [${parts.join(" \xB7 ")}]`));
+      }
+      const memBody = opts.memoryFormat?.toLowerCase() === "actions" ? extractActionsBriefBody(item.memory.body) : item.memory.body.trim();
+      out(memBody);
+      out("");
+    }
+    if (!stopped()) out(ui.dim(`${top.length} memor${top.length === 1 ? "y" : "ies"} surfaced`));
+    const ids = top.map(({ memory: mem }) => mem.frontmatter.id);
+    if (ids.length > 0) {
+      await trackReads(paths, ids).catch(() => {
+      });
+      await writeBriefingMarker(paths, {
+        task: opts.task ?? "CLI briefing",
+        source: "haive-briefing-cli",
+        sessionId: process.env.HAIVE_SESSION_ID,
+        memoryIds: ids,
+        files: filePaths
+      }).catch(() => {
+      });
+    }
+    const radarForced = opts.radar === true;
+    const radarAuto = opts.radar !== false && top.length < RADAR_AUTO_THRESHOLD;
+    if ((radarForced || radarAuto) && !stopped()) {
+      const radar = await buildRadar({ root, taskTokens: tokens, filePaths });
+      if (radarHasContent(radar)) {
+        out("");
+        printRadar(radar, out, radarForced ? "forced" : "low-memory-signal");
+      }
+    }
+    const requestedSymbols = (opts.symbols ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    if (requestedSymbols.length > 0 && !stopped()) {
+      const codeMap = await loadCodeMap3(paths);
+      if (!codeMap) {
+        ui.warn("No code-map found. Run `haive index code` first to enable symbol lookup.");
+      } else {
+        out(`
+${ui.bold("=== Symbol Locations ===")}
+`);
+        for (const sym of requestedSymbols) {
+          if (stopped()) break;
+          const { files } = queryCodeMap(codeMap, { symbol: sym });
+          if (files.length === 0) {
+            out(`${ui.dim(sym)}  (not found in code-map)`);
+          } else {
+            for (const f of files) {
+              if (stopped()) break;
+              const exports = f.entry.exports.filter(
+                (e) => e.name.toLowerCase().includes(sym.toLowerCase())
+              );
+              for (const e of exports) {
+                if (stopped()) break;
+                const desc = e.description ? `  \u2014 ${e.description}` : "";
+                out(`${ui.bold(e.name)}  ${ui.dim(f.path + ":" + e.line)}  [${e.kind}]${desc}`);
+              }
+            }
+          }
         }
+        out("");
       }
     }
+  });
+}
+function classifyCliPriority(item, filePaths, tokens, exactTaskHit, partialTaskHit) {
+  const fm = item.memory.frontmatter;
+  const anchored = filePaths.length > 0 && memoryMatchesAnchorPaths(item.memory, filePaths);
+  if (anchored || fm.type === "attempt" && exactTaskHit) return "must_read";
+  if (exactTaskHit || partialTaskHit || item.score >= 4 || tokens && fm.tags.some((tag) => tokens.includes(tag))) {
+    return "useful";
   }
-  for (const dup of nearDuplicatePairs(loaded)) {
-    out.push({
-      file: dup.file,
-      id: dup.id,
-      severity: "warn",
-      code: "NEAR_DUPLICATE",
-      message: `Body overlaps ~${Math.round(dup.score * 100)}% with ${dup.otherId}. Merge or deprecate one record to reduce briefing noise.`
+  return "background";
+}
+function priorityBadge(priority) {
+  if (priority === "must_read") return ui.red("[must_read]");
+  if (priority === "useful") return ui.yellow("[useful]");
+  return ui.dim("[background]");
+}
+function parseCsv(value) {
+  if (!value) return [];
+  return value.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function collectInclude(value, previous) {
+  return [...previous, value];
+}
+
+// src/commands/tui.ts
+import "commander";
+import { findProjectRoot as findProjectRoot3 } from "@hiveai/core";
+function registerTui(program2) {
+  program2.command("tui").description(
+    "Interactive terminal dashboard for browsing and managing memories.\n\n  Screens (switch with 1 / 2 / 3):\n    1 \u2014 Memories: list + preview, filter by status (Tab), actions (a/r/p/d)\n    2 \u2014 Health:   stale, pending review, anchorless memories\n    3 \u2014 Stats:    most-read, decaying, total counts\n\n  Key bindings:\n    \u2191 \u2193     navigate list\n    Tab     cycle status filter (all \u2192 proposed \u2192 validated \u2192 stale)\n    a       approve selected memory\n    r       reject selected memory\n    p       promote personal \u2192 team (proposed)\n    d       delete selected memory\n    q / Esc exit\n"
+  ).option("-d, --dir <dir>", "project root").action(async (opts) => {
+    if (!process.stdout.isTTY) {
+      console.error("haive tui requires an interactive terminal (TTY).");
+      process.exitCode = 1;
+      return;
+    }
+    const root = findProjectRoot3(opts.dir);
+    const { render } = await import("ink");
+    const { createElement } = await import("react");
+    const { Dashboard } = await import("./Dashboard-Y2AIWFZK.js");
+    const { waitUntilExit } = render(createElement(Dashboard, { root }));
+    await waitUntilExit();
+  });
+}
+
+// src/commands/embeddings.ts
+import { existsSync as existsSync4 } from "fs";
+import path4 from "path";
+import "commander";
+import { findProjectRoot as findProjectRoot4, resolveHaivePaths as resolveHaivePaths3 } from "@hiveai/core";
+function registerEmbeddings(program2) {
+  const embeddings = program2.command("embeddings").description("Manage local embeddings index for semantic search");
+  embeddings.command("index").description("Generate or refresh the embeddings index for all memories").option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot4(opts.dir);
+    const paths = resolveHaivePaths3(root);
+    if (!existsSync4(paths.memoriesDir)) {
+      ui.error(`No .ai/memories at ${root}. Run \`haive init\` first.`);
+      process.exitCode = 1;
+      return;
+    }
+    const { Embedder, rebuildIndex } = await loadEmbeddings();
+    ui.info("Loading embedding model (first run downloads ~110MB)\u2026");
+    const embedder = await Embedder.create();
+    ui.info(`Model ready: ${embedder.model} (dim=${embedder.dimension}). Indexing memories\u2026`);
+    const { report } = await rebuildIndex(paths, embedder);
+    ui.success(
+      `Indexed ${report.total} memories \u2014 added=${report.added} updated=${report.updated} unchanged=${report.unchanged} removed=${report.removed}`
+    );
+  });
+  embeddings.command("query <text>").description("Run a semantic search against the local embeddings index").option("-d, --dir <dir>", "project root").option("--limit <n>", "max results", "10").option("--min-score <n>", "minimum cosine similarity (0-1)", "0").action(async (text, opts) => {
+    const root = findProjectRoot4(opts.dir);
+    const paths = resolveHaivePaths3(root);
+    const { semanticSearch } = await loadEmbeddings();
+    const result = await semanticSearch(paths, text, {
+      limit: Number(opts.limit ?? 10),
+      minScore: Number(opts.minScore ?? 0)
     });
-  }
-  return { findings: out, fixes };
-}
-function titleFromId(id) {
-  const withoutDate = id.replace(/^\d{4}-\d{2}-\d{2}-/, "");
-  return withoutDate.split("-").filter(Boolean).map((part) => part.slice(0, 1).toUpperCase() + part.slice(1)).join(" ");
-}
-function suggestAnchors(root, loaded, codeMap, trackedFiles) {
-  const body = loaded.memory.body;
-  const paths = /* @__PURE__ */ new Set();
-  const symbols = /* @__PURE__ */ new Set();
-  for (const match of body.matchAll(/`([^`\n]+\.[A-Za-z0-9]+)`|(?:^|\s)([A-Za-z0-9_./-]+\.[A-Za-z0-9]+)/gm)) {
-    const candidate = (match[1] ?? match[2] ?? "").replace(/^\.?\//, "");
-    if (!candidate || candidate.startsWith("http")) continue;
-    if (existsSync5(path6.join(root, candidate)) && isSafeAnchorPath(candidate, trackedFiles)) {
-      paths.add(candidate);
+    if (!result) {
+      ui.error("No embeddings index found. Run `haive embeddings index` first.");
+      process.exitCode = 1;
+      return;
     }
-  }
-  if (codeMap) {
-    const lowered = body.toLowerCase();
-    for (const [file, entry] of Object.entries(codeMap.files)) {
-      for (const exp of entry.exports) {
-        if (!exp.name || exp.name.length < 4) continue;
-        if (lowered.includes(exp.name.toLowerCase())) {
-          if (isSafeAnchorPath(file, trackedFiles)) {
-            paths.add(file);
-            symbols.add(exp.name);
-          }
-        }
-        if (paths.size >= 5 && symbols.size >= 5) break;
-      }
-      if (paths.size >= 5 && symbols.size >= 5) break;
+    if (result.hits.length === 0) {
+      ui.info("No semantic matches above the threshold.");
+      return;
+    }
+    for (const hit of result.hits) {
+      const score = hit.score.toFixed(3);
+      console.log(`${ui.bold(score)}  ${hit.id}`);
+      console.log(`       ${ui.dim(path4.relative(root, hit.file_path))}`);
     }
-  }
-  return {
-    paths: [...paths].slice(0, 5),
-    symbols: [...symbols].slice(0, 5)
-  };
-}
-function gitTrackedFiles(root) {
-  const result = spawnSync2("git", ["ls-files"], {
-    cwd: root,
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"]
   });
-  if (result.status !== 0) return null;
-  const files = result.stdout.split("\n").map((line) => line.trim()).filter(Boolean);
-  return new Set(files);
+  embeddings.command("status").description("Show the embeddings index status").option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot4(opts.dir);
+    const paths = resolveHaivePaths3(root);
+    const { indexStat } = await loadEmbeddings();
+    const stat2 = await indexStat(paths);
+    if (!stat2.exists) {
+      ui.warn("No embeddings index. Run `haive embeddings index` to create one.");
+      return;
+    }
+    console.log(`${ui.bold("entries:")}    ${stat2.count}`);
+    console.log(`${ui.bold("model:")}      ${stat2.model}`);
+    console.log(`${ui.bold("updated_at:")} ${stat2.updatedAt}`);
+    console.log(`${ui.bold("size:")}       ${(stat2.sizeBytes / 1024).toFixed(1)} KB`);
+  });
 }
-function isSafeAnchorPath(file, trackedFiles) {
-  const normalized = file.replace(/\\/g, "/").replace(/^\.?\//, "");
-  if (normalized.startsWith(".ai/.cache/") || normalized.startsWith(".ai/.runtime/")) return false;
-  if (normalized.includes("/node_modules/") || normalized.startsWith("node_modules/")) return false;
-  if (normalized.includes("/dist/") || normalized.startsWith("dist/")) return false;
-  if (trackedFiles && !trackedFiles.has(normalized)) return false;
-  return true;
+async function loadEmbeddings() {
+  try {
+    return await import("@hiveai/embeddings");
+  } catch {
+    ui.error(
+      "Could not load @hiveai/embeddings. Run: npm install -g @hiveai/embeddings  (or `pnpm build` in the monorepo)"
+    );
+    process.exit(1);
+  }
 }
-function nearDuplicatePairs(loaded) {
-  const out = [];
-  const candidates = loaded.filter(({ memory: memory2 }) => {
-    const fm = memory2.frontmatter;
-    return fm.type !== "session_recap" && fm.status !== "rejected" && fm.status !== "deprecated";
+
+// src/commands/index-code.ts
+import path5 from "path";
+import "commander";
+import {
+  buildCodeMap as buildCodeMap2,
+  codeMapPath,
+  findProjectRoot as findProjectRoot5,
+  resolveHaivePaths as resolveHaivePaths4,
+  saveCodeMap as saveCodeMap2
+} from "@hiveai/core";
+function registerIndexCode(program2) {
+  const idx = program2.command("index").description(
+    "Build local indexes that let AIs look up symbols instead of grepping.\n\n  Run once after init, then haive sync refreshes it automatically when source changes."
+  );
+  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"
+  ).option("-d, --dir <dir>", "project root").option(
+    "--exclude <csv>",
+    "extra directory names to skip (comma-separated)",
+    ""
+  ).action(async (opts) => {
+    const root = findProjectRoot5(opts.dir);
+    const paths = resolveHaivePaths4(root);
+    const extraExcludes = (opts.exclude ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    ui.info(`Indexing source files in ${root}\u2026`);
+    const map = await buildCodeMap2(root, {
+      includeUntracked: true,
+      excludeDirs: [
+        "node_modules",
+        "dist",
+        "build",
+        "out",
+        ".git",
+        ".next",
+        ".turbo",
+        ".vitest-cache",
+        "coverage",
+        ...extraExcludes
+      ]
+    });
+    await saveCodeMap2(paths, map);
+    const fileCount = Object.keys(map.files).length;
+    const exportCount = Object.values(map.files).reduce((s, f) => s + f.exports.length, 0);
+    ui.success(
+      `Indexed ${fileCount} file(s) with ${exportCount} export(s) \u2192 ${path5.relative(root, codeMapPath(paths))}`
+    );
   });
-  for (let i = 0; i < candidates.length; i++) {
-    for (let j = i + 1; j < candidates.length; j++) {
-      const a = candidates[i];
-      const b = candidates[j];
-      if (a.memory.frontmatter.scope !== b.memory.frontmatter.scope) continue;
-      if (a.memory.frontmatter.type !== b.memory.frontmatter.type) continue;
-      const score = jaccard(tokenSet(a.memory.body), tokenSet(b.memory.body));
-      if (score >= 0.72) {
-        out.push({
-          id: a.memory.frontmatter.id,
-          otherId: b.memory.frontmatter.id,
-          file: a.filePath,
-          score
-        });
-      }
+  idx.command("code-search").description(
+    "Build the semantic-search embeddings index for code (powers the code_search MCP tool).\n\n  Reads .ai/code-map.json (run `haive index code` first) and embeds each exported\n  symbol's metadata (filename + name + kind + description).\n\n  Re-runs are incremental: unchanged entries keep their cached vectors, only the\n  diff is re-embedded. First run downloads the bge-small-en-v1.5 model (~110MB).\n"
+  ).option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot5(opts.dir);
+    const paths = resolveHaivePaths4(root);
+    let mod;
+    try {
+      mod = await import("@hiveai/embeddings");
+    } catch {
+      ui.error(
+        "@hiveai/embeddings is not installed. Install it (`pnpm add @hiveai/embeddings`) or run `haive embeddings install`."
+      );
+      process.exit(1);
     }
-  }
-  return out;
+    ui.info("Loading embedder (first run downloads ~110MB)\u2026");
+    const embedder = await mod.Embedder.create();
+    ui.info(`Embedding code-map symbols\u2026`);
+    try {
+      const { report } = await mod.rebuildCodeIndex(paths, embedder);
+      ui.success(
+        `Code-search index ready: ${report.total} symbols (+${report.added} new, ~${report.updated} updated, =${report.unchanged} cached, -${report.removed} removed)`
+      );
+    } catch (err) {
+      ui.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
 }
-function tokenSet(body) {
-  return new Set(
-    (body.toLowerCase().match(/\b[a-z0-9]{4,}\b/g) ?? []).filter((word) => !["this", "that", "with", "from", "have"].includes(word))
-  );
+
+// src/commands/init.ts
+import { mkdir as mkdir5, readFile as readFile5, writeFile as writeFile6 } from "fs/promises";
+import { existsSync as existsSync9 } from "fs";
+import path10 from "path";
+import { spawnSync as spawnSync3 } from "child_process";
+import "commander";
+import {
+  AUTOPILOT_DEFAULTS as AUTOPILOT_DEFAULTS2,
+  buildCodeMap as buildCodeMap3,
+  resolveHaivePaths as resolveHaivePaths6,
+  saveCodeMap as saveCodeMap3,
+  saveConfig as saveConfig2
+} from "@hiveai/core";
+
+// src/commands/agent.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import { existsSync as existsSync6 } from "fs";
+import { mkdir as mkdir3, writeFile as writeFile4 } from "fs/promises";
+import os2 from "os";
+import path7 from "path";
+import { createInterface } from "readline/promises";
+import "commander";
+import { findProjectRoot as findProjectRoot6, resolveHaivePaths as resolveHaivePaths5 } from "@hiveai/core";
+
+// 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 path6 from "path";
+import os from "os";
+var HOME = os.homedir();
+var HAIVE_MCP_ENTRY = {
+  command: "haive",
+  args: ["mcp", "--stdio"]
+};
+function projectMcpEntry(root) {
+  return {
+    command: "haive",
+    args: ["mcp", "--stdio"],
+    env: { HAIVE_PROJECT_ROOT: root }
+  };
 }
-function jaccard(a, b) {
-  if (a.size === 0 || b.size === 0) return 0;
-  let inter = 0;
-  for (const item of a) if (b.has(item)) inter++;
-  return inter / (a.size + b.size - inter);
+function cursorMcpPath() {
+  return path6.join(HOME, ".cursor", "mcp.json");
 }
-function registerMemoryLint(parent) {
-  parent.command("lint").description(
-    "Heuristic corpus checks (anchors on key types, headings, verbosity). Static analysis only."
-  ).option("--json", "emit findings as JSON", false).option("--fix", "prepare simple automatic fixes (use with --dry-run or --apply)", false).option("--dry-run", "with --fix, show files that would change without writing", false).option("--apply", "with --fix, write simple fixes to disk", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
-    const root = findProjectRoot6(opts.dir);
-    const apply = Boolean(opts.fix && opts.apply);
-    const dryRun = Boolean(opts.fix && (opts.dryRun || !opts.apply));
-    const report = await lintMemoriesAsync(root, { fix: Boolean(opts.fix), apply });
-    const findings = report.findings;
-    if (opts.json) {
-      console.log(JSON.stringify({
-        findings_count: findings.length,
-        findings,
-        fixes_count: report.fixes.length,
-        fixes: report.fixes,
-        fix_mode: opts.fix ? apply ? "apply" : "dry-run" : "off"
-      }, null, 2));
-      process.exitCode = findings.some((f) => f.severity === "error") ? 1 : 0;
-      return;
-    }
-    if (findings.length === 0) {
-      ui.success(`memory lint OK \u2014 ${root}`);
-      return;
-    }
-    console.log(ui.bold(`memory lint (${findings.length} finding${findings.length === 1 ? "" : "s"})`) + `
-`);
-    if (opts.fix) {
-      const mode = apply ? "apply" : dryRun ? "dry-run" : "dry-run";
-      const verb = apply ? "changed" : "would change";
-      console.log(ui.bold(`fix ${mode}: ${report.fixes.length} file${report.fixes.length === 1 ? "" : "s"} ${verb}`));
-      for (const fix of report.fixes) {
-        console.log(`  ${ui.dim(fix.id)} ${fix.actions.join("; ")}`);
-        console.log(ui.dim(`       \u2192 ${fix.file}`));
-      }
-      console.log();
+async function configureCursor() {
+  const mcpPath = cursorMcpPath();
+  const cursorDir = path6.join(HOME, ".cursor");
+  if (!existsSync5(cursorDir)) return { client: "Cursor", status: "not_installed" };
+  let config = {};
+  if (existsSync5(mcpPath)) {
+    try {
+      config = JSON.parse(await readFile3(mcpPath, "utf8"));
+    } catch {
     }
-    const order = { error: 0, warn: 1, info: 2 };
-    findings.sort((a, b) => order[a.severity] - order[b.severity] || a.id.localeCompare(b.id));
-    for (const f of findings) {
-      const color = f.severity === "error" ? ui.red : f.severity === "warn" ? ui.yellow : ui.dim;
-      console.log(
-        `${color(f.severity.padEnd(5))} ${ui.dim(f.code)} ${f.id}`
-      );
-      console.log(`       ${f.message}`);
-      if (f.suggested_anchors) {
-        const pathHints = f.suggested_anchors.paths.length > 0 ? `paths: ${f.suggested_anchors.paths.join(", ")}` : "";
-        const symbolHints = f.suggested_anchors.symbols.length > 0 ? `symbols: ${f.suggested_anchors.symbols.join(", ")}` : "";
-        console.log(ui.dim(`       suggested anchors: ${[pathHints, symbolHints].filter(Boolean).join(" \xB7 ")}`));
-      }
-      console.log(ui.dim(`       \u2192 ${f.file}`));
+  }
+  config.mcpServers ??= {};
+  if (config.mcpServers["haive"]) return { client: "Cursor", status: "already_configured" };
+  config.mcpServers["haive"] = HAIVE_MCP_ENTRY;
+  await mkdir2(cursorDir, { recursive: true });
+  await writeFile3(mcpPath, JSON.stringify(config, null, 2), "utf8");
+  return { client: "Cursor", status: "configured", path: mcpPath };
+}
+function vscodeMcpPath() {
+  const candidates = [
+    path6.join(HOME, ".config", "Code", "User", "mcp.json"),
+    // Linux
+    path6.join(HOME, "Library", "Application Support", "Code", "User", "mcp.json"),
+    // macOS
+    path6.join(HOME, "AppData", "Roaming", "Code", "User", "mcp.json"),
+    // Windows
+    path6.join(HOME, ".config", "Code - Insiders", "User", "mcp.json")
+  ];
+  for (const c of candidates) {
+    if (existsSync5(path6.dirname(c))) return c;
+  }
+  return null;
+}
+async function configureVSCode() {
+  const mcpPath = vscodeMcpPath();
+  if (!mcpPath) return { client: "VS Code", status: "not_installed" };
+  let config = {};
+  if (existsSync5(mcpPath)) {
+    try {
+      config = JSON.parse(await readFile3(mcpPath, "utf8"));
+    } catch {
     }
-    process.exitCode = findings.some((x) => x.severity === "error") ? 1 : 0;
-  });
+  }
+  config.servers ??= {};
+  if (config.servers["haive"]) return { client: "VS Code", status: "already_configured" };
+  config.servers["haive"] = { ...HAIVE_MCP_ENTRY, type: "stdio" };
+  await mkdir2(path6.dirname(mcpPath), { recursive: true });
+  await writeFile3(mcpPath, JSON.stringify(config, null, 2), "utf8");
+  return { client: "VS Code", status: "configured", path: mcpPath };
 }
-
-// src/utils/autopilot.ts
-async function applyAutopilotRepairs(root, paths, options = {}) {
-  const repairs = [];
-  const config = await loadConfig(paths);
-  if (options.applyConfig) {
-    const changed = await ensureAutopilotConfig(paths, config);
-    if (changed) {
-      repairs.push({
-        code: "autopilot-config",
-        message: "Enabled autopilot defaults in .ai/haive.config.json."
-      });
+function claudeConfigPath() {
+  const p = path6.join(HOME, ".claude.json");
+  if (existsSync5(p)) return p;
+  const p2 = path6.join(HOME, ".config", "claude", "claude.json");
+  if (existsSync5(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"))) {
+    return { client: "Claude Code", status: "not_installed" };
+  }
+  let config = {};
+  if (existsSync5(cfgPath)) {
+    try {
+      config = JSON.parse(await readFile3(cfgPath, "utf8"));
+    } catch {
     }
   }
-  const current = await loadConfig(paths);
-  const autoRepair = current.autoRepair ?? {};
-  if (options.applyContext ?? autoRepair.context ?? current.autopilot) {
-    const changed = await syncProjectContextVersion(root, paths);
-    if (changed) {
-      repairs.push({
-        code: "project-context-version",
-        message: "Updated .ai/project-context.md version metadata from package.json."
-      });
+  config.mcpServers ??= {};
+  if (config.mcpServers["haive"]) return { client: "Claude Code", status: "already_configured" };
+  config.mcpServers["haive"] = { ...HAIVE_MCP_ENTRY, type: "stdio" };
+  await writeFile3(cfgPath, JSON.stringify(config, null, 2), "utf8");
+  return { client: "Claude Code", status: "configured", path: cfgPath };
+}
+function windsurfMcpPath() {
+  const candidates = [
+    path6.join(HOME, ".codeium", "windsurf", "mcp_config.json"),
+    path6.join(HOME, ".windsurf", "mcp.json")
+  ];
+  for (const c of candidates) {
+    if (existsSync5(path6.dirname(c))) return c;
+  }
+  return null;
+}
+async function configureWindsurf() {
+  const mcpPath = windsurfMcpPath();
+  if (!mcpPath) return { client: "Windsurf", status: "not_installed" };
+  let config = {};
+  if (existsSync5(mcpPath)) {
+    try {
+      config = JSON.parse(await readFile3(mcpPath, "utf8"));
+    } catch {
     }
   }
-  if (options.applyCorpus ?? autoRepair.corpus ?? current.autopilot) {
-    const report = await lintMemoriesAsync(root, { fix: true, apply: true });
-    const applied = report.fixes.filter((fix) => fix.applied);
-    if (applied.length > 0) {
-      repairs.push({
-        code: "memory-lint-fix",
-        message: `Applied ${applied.length} safe memory lint fix${applied.length === 1 ? "" : "es"}.`
-      });
+  config.mcpServers ??= {};
+  if (config.mcpServers["haive"]) return { client: "Windsurf", status: "already_configured" };
+  config.mcpServers["haive"] = HAIVE_MCP_ENTRY;
+  await mkdir2(path6.dirname(mcpPath), { recursive: true });
+  await writeFile3(mcpPath, JSON.stringify(config, null, 2), "utf8");
+  return { client: "Windsurf", status: "configured", path: mcpPath };
+}
+async function autoConfigureMcpClients() {
+  const results = [];
+  const configurators = [configureCursor, configureVSCode, configureClaude, configureWindsurf];
+  for (const fn of configurators) {
+    try {
+      results.push(await fn());
+    } catch (err) {
+      const name = fn.name.replace("configure", "");
+      results.push({ client: name, status: "error", error: String(err) });
     }
-    const indexed = await refreshMemorySemanticIndex(paths);
-    if (indexed) {
-      repairs.push({
-        code: "memory-embeddings-index",
-        message: "Refreshed memory embeddings index."
-      });
+  }
+  return results;
+}
+async function configureProjectMcpClients(root) {
+  const entry = projectMcpEntry(root);
+  const results = [];
+  try {
+    const cursorPath = path6.join(root, ".cursor", "mcp.json");
+    let config = {};
+    if (existsSync5(cursorPath)) {
+      try {
+        config = JSON.parse(await readFile3(cursorPath, "utf8"));
+      } catch {
+      }
     }
+    config.mcpServers ??= {};
+    config.mcpServers["haive"] = entry;
+    await mkdir2(path6.dirname(cursorPath), { recursive: true });
+    await writeFile3(cursorPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+    results.push({ client: "Cursor (project)", status: "configured", path: cursorPath });
+  } catch (err) {
+    results.push({ client: "Cursor (project)", status: "error", error: String(err) });
   }
-  if (options.applyCodeMap ?? autoRepair.codeMap ?? current.autopilot) {
-    const refreshed = await refreshCodeMap(root, paths, Boolean(options.forceCodeMap));
-    if (refreshed) {
-      repairs.push({
-        code: "code-map-refresh",
-        message: "Refreshed .ai/code-map.json."
-      });
+  try {
+    const vscodePath = path6.join(root, ".vscode", "mcp.json");
+    let config = {};
+    if (existsSync5(vscodePath)) {
+      try {
+        config = JSON.parse(await readFile3(vscodePath, "utf8"));
+      } catch {
+      }
     }
+    config.servers ??= {};
+    config.servers["haive"] = { ...entry, type: "stdio" };
+    await mkdir2(path6.dirname(vscodePath), { recursive: true });
+    await writeFile3(vscodePath, JSON.stringify(config, null, 2) + "\n", "utf8");
+    results.push({ client: "VS Code (workspace)", status: "configured", path: vscodePath });
+  } catch (err) {
+    results.push({ client: "VS Code (workspace)", status: "error", error: String(err) });
   }
-  if (options.applyCodeSearch ?? autoRepair.codeSearch ?? current.autopilot) {
-    const indexed = await refreshCodeSearchIndex(paths);
-    if (indexed) {
-      repairs.push({
-        code: "code-search-index",
-        message: "Refreshed code-search embeddings index."
-      });
+  try {
+    const mcpPath = path6.join(root, ".mcp.json");
+    let config = {};
+    if (existsSync5(mcpPath)) {
+      try {
+        config = JSON.parse(await readFile3(mcpPath, "utf8"));
+      } catch {
+      }
     }
+    config.mcpServers ??= {};
+    config.mcpServers["haive"] = { ...entry, type: "stdio" };
+    await writeFile3(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+    results.push({ client: "Claude Code (project)", status: "configured", path: mcpPath });
+  } catch (err) {
+    results.push({ client: "Claude Code (project)", status: "error", error: String(err) });
   }
-  return repairs;
+  return results;
 }
-async function ensureAutopilotConfig(paths, currentConfig) {
-  const current = currentConfig ?? await loadConfig(paths);
-  const next = {
-    ...current,
-    autopilot: true,
-    defaultScope: "team",
-    defaultStatus: "validated",
-    autoApproveDelayHours: current.autoApproveDelayHours ?? AUTOPILOT_DEFAULTS.autoApproveDelayHours,
-    autoPromoteMinReads: current.autoPromoteMinReads ?? AUTOPILOT_DEFAULTS.autoPromoteMinReads,
-    autoSessionEnd: true,
-    autoContext: true,
-    autoRepair: {
-      context: true,
-      corpus: true,
-      codeMap: true,
-      codeSearch: current.autoRepair?.codeSearch ?? true
-    },
-    enforcement: {
-      ...AUTOPILOT_DEFAULTS.enforcement,
-      ...current.enforcement,
-      mode: "strict",
-      requireBriefingFirst: true,
-      requireSessionRecap: true,
-      requireMemoryVerify: true,
-      blockStaleDecisionChanges: true,
-      requireDecisionCoverage: true,
-      cleanupGeneratedArtifacts: true,
-      toolProfile: current.enforcement?.toolProfile ?? "enforcement"
+
+// src/commands/agent.ts
+function registerAgent(program2) {
+  const agent = program2.command("agent").description("Detect, configure, and report the best hAIve mode for AI coding agents.");
+  agent.command("detect").description("Detect available AI agents and hAIve MCP/wrapper readiness.").option("-d, --dir <dir>", "project root").option("--json", "emit JSON", false).action(async (opts) => {
+    const detection = await detectAgentMode(opts.dir);
+    printDetection(detection, Boolean(opts.json));
+  });
+  agent.command("status").description("Alias for agent detect.").option("-d, --dir <dir>", "project root").option("--json", "emit JSON", false).action(async (opts) => {
+    const detection = await detectAgentMode(opts.dir);
+    printDetection(detection, Boolean(opts.json));
+  });
+  agent.command("setup").description("Configure hAIve project MCP, optional global MCP clients, and wrapper fallback metadata.").option("-d, --dir <dir>", "project root").option("-y, --yes", "approve user-level/global MCP configuration without prompting", false).option("--no-global", "skip user-level/global MCP configuration").option("--json", "emit JSON", false).action(async (opts) => {
+    const result = await setupAgentMode(opts.dir, {
+      yes: Boolean(opts.yes),
+      global: opts.global !== false && opts.noGlobal !== true,
+      interactive: process.stdin.isTTY
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
     }
-  };
-  if (JSON.stringify(current) === JSON.stringify(next)) return false;
-  await saveConfig(paths, next);
-  return true;
+    printSetupResult(result);
+  });
 }
-async function syncProjectContextVersion(root, paths) {
-  const status = await projectContextVersionStatus(root, paths);
-  if (!status.canSync || !status.expectedVersion) return false;
-  const original = await readFile3(paths.projectContext, "utf8");
-  let updated = original.replace(
-    /^# Project context — hAIve \(v[^)]+\)$/m,
-    `# Project context \u2014 hAIve (v${status.expectedVersion})`
-  ).replace(
-    /> \*\*Current version\*\*: [^—\n]+—/m,
-    `> **Current version**: ${status.expectedVersion} \u2014`
-  );
-  if (updated === original && !original.includes("Current version")) {
-    updated = original.replace(
-      /^(> Repo-native context enforcement[^\n]*\n)/m,
-      `$1> **Current version**: ${status.expectedVersion} \u2014 @hiveai/core, cli, mcp, embeddings are versioned together.
-`
-    );
-  }
-  if (updated === original && !original.includes("Current version")) {
-    updated = original.replace(
-      /^(# Project context[^\n]*\n)/m,
-      `$1
-> **Current version**: ${status.expectedVersion}
-`
-    );
+async function setupAgentMode(dir, opts = {}) {
+  const root = findProjectRoot6(dir);
+  const paths = resolveHaivePaths5(root);
+  const projectResults = await configureProjectMcpClients(root);
+  const detectionBeforeGlobal = await detectAgentMode(root);
+  let globalResults = [];
+  let globalSkippedReason;
+  const shouldConsiderGlobal = opts.global !== false;
+  if (shouldConsiderGlobal) {
+    const approved = opts.yes === true || (opts.interactive ? await confirmGlobalSetup() : false);
+    if (approved) {
+      globalResults = await autoConfigureMcpClients();
+      const codex = await configureCodexIfAvailable(root);
+      if (codex) globalResults.push(codex);
+    } else {
+      globalSkippedReason = opts.interactive ? "User declined user-level/global MCP configuration." : "Non-interactive shell; skipped user-level/global MCP configuration. Re-run `haive agent setup --yes` to apply it.";
+    }
+  } else {
+    globalSkippedReason = "User-level/global MCP configuration disabled.";
   }
-  if (updated === original) return false;
-  await writeFile4(paths.projectContext, updated, "utf8");
-  return true;
+  const detection = await detectAgentMode(root);
+  const modeFile = await writeAgentModeRecord(paths, detection, globalSkippedReason);
+  return {
+    detection,
+    project_results: projectResults,
+    global_results: globalResults,
+    mode_file: modeFile,
+    ...globalSkippedReason ? { global_skipped_reason: globalSkippedReason } : {}
+  };
 }
-async function projectContextVersionStatus(root, paths) {
-  if (!existsSync6(paths.projectContext)) {
-    return { mismatch: false, canSync: false };
-  }
-  const packagePath = path7.join(root, "package.json");
-  if (!existsSync6(packagePath)) {
-    return { mismatch: false, canSync: false };
-  }
-  const packageJson = JSON.parse(await readFile3(packagePath, "utf8"));
-  const expectedVersion = packageJson.version;
-  if (!expectedVersion) {
-    return { mismatch: false, canSync: false };
-  }
-  const content = await readFile3(paths.projectContext, "utf8");
-  const headingVersion = content.match(/^# Project context — hAIve \(v([^)]+)\)$/m)?.[1];
-  const currentLineVersion = content.match(/^> \*\*Current version\*\*: ([^—\n]+)/m)?.[1]?.trim();
-  const currentVersion = currentLineVersion ?? headingVersion;
+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")) }
+  ];
+  const installedAgents = [
+    { agent: "Codex", command: "codex", installed: commandExists("codex"), mcp_configured: codexMcpConfigured() },
+    { agent: "Claude", command: "claude", installed: commandExists("claude") },
+    { agent: "Aider", command: "aider", installed: commandExists("aider") },
+    { agent: "Cursor", command: "cursor", installed: commandExists("cursor") }
+  ];
+  const hasProjectMcp = projectMcp.some((item) => item.present);
+  const hasNativeMcp = hasProjectMcp || installedAgents.some((a) => a.mcp_configured);
+  const wrapperAgent = installedAgents.find((a) => a.installed && ["codex", "claude", "aider"].includes(a.command));
+  const recommendedMode = hasNativeMcp ? "mcp" : wrapperAgent ? "wrapped" : "fallback";
+  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 {
-    expectedVersion,
-    currentVersion,
-    mismatch: currentVersion !== expectedVersion,
-    canSync: true
+    root,
+    initialized: existsSync6(paths.haiveDir),
+    project_mcp: projectMcp,
+    installed_agents: installedAgents,
+    recommended_mode: recommendedMode,
+    recommended_command: recommendedCommand
   };
 }
-async function refreshCodeMap(root, paths, force) {
-  const existing = await loadCodeMap3(paths);
-  if (existing && !force) return false;
-  const map = await buildCodeMap2(root, {
-    includeUntracked: true,
-    excludeDirs: [
-      "node_modules",
-      "dist",
-      "build",
-      "out",
-      ".git",
-      ".next",
-      ".turbo",
-      ".vitest-cache",
-      "coverage"
+async function writeAgentModeRecord(paths, detection, skippedReason) {
+  const dir = path7.join(paths.runtimeDir, "enforcement");
+  await mkdir3(dir, { recursive: true });
+  const file = path7.join(dir, "agent-mode.json");
+  const record = {
+    selected_mode: detection.recommended_mode,
+    recommended_command: detection.recommended_command,
+    configured_at: (/* @__PURE__ */ new Date()).toISOString(),
+    project_root: detection.root,
+    notes: [
+      "mcp = native hAIve MCP tools are available or project MCP config exists.",
+      "wrapped = use haive run when native MCP is unavailable.",
+      "fallback = use haive briefing/enforce manually.",
+      ...skippedReason ? [skippedReason] : []
     ]
-  });
-  if (existing && existing.root === map.root && JSON.stringify(existing.files) === JSON.stringify(map.files)) {
-    return false;
-  }
-  await saveCodeMap2(paths, map);
-  return true;
+  };
+  await writeFile4(file, JSON.stringify(record, null, 2) + "\n", "utf8");
+  return file;
 }
-async function refreshCodeSearchIndex(paths) {
+async function confirmGlobalSetup() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
-    const mod = await import("@hiveai/embeddings");
-    const embedder = await mod.Embedder.create();
-    const { report } = await mod.rebuildCodeIndex(paths, embedder);
-    return report.added > 0 || report.updated > 0 || report.removed > 0;
-  } catch {
-    return false;
+    const answer = await rl.question(
+      "Configure hAIve in user-level AI client configs (Cursor/VS Code/Claude/Codex when detected)? [y/N] "
+    );
+    return /^y(es)?$/i.test(answer.trim());
+  } finally {
+    rl.close();
   }
 }
-async function refreshMemorySemanticIndex(paths) {
-  try {
-    if (!existsSync6(paths.memoriesDir)) return false;
-    const memories = await loadMemoriesFromDir3(paths.memoriesDir);
-    if (memories.length === 0) return false;
-    const mod = await import("@hiveai/embeddings");
-    const embedder = await mod.Embedder.create();
-    const { report } = await mod.rebuildIndex(paths, embedder);
-    return report.added > 0 || report.updated > 0 || report.removed > 0;
-  } catch {
-    return false;
+async function configureCodexIfAvailable(root) {
+  if (!commandExists("codex")) return { client: "Codex", status: "not_installed" };
+  if (codexMcpConfigured()) return { client: "Codex", status: "already_configured" };
+  const result = spawnSync2("codex", [
+    "mcp",
+    "add",
+    "haive",
+    "--env",
+    `HAIVE_PROJECT_ROOT=${root}`,
+    "--",
+    "haive",
+    "mcp",
+    "--stdio"
+  ], { encoding: "utf8" });
+  if (result.status === 0) return { client: "Codex", status: "configured", path: path7.join(os2.homedir(), ".codex", "config.toml") };
+  return { client: "Codex", status: "error", error: result.stderr || result.stdout || "codex mcp add failed" };
+}
+function commandExists(command) {
+  const result = spawnSync2(process.platform === "win32" ? "where" : "which", [command], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+  return result.status === 0;
+}
+function codexMcpConfigured() {
+  if (!commandExists("codex")) return false;
+  const result = spawnSync2("codex", ["mcp", "get", "haive"], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+  return result.status === 0;
+}
+function printDetection(detection, json) {
+  if (json) {
+    console.log(JSON.stringify(detection, null, 2));
+    return;
+  }
+  console.log(ui.bold("hAIve agent status"));
+  console.log(ui.dim(`  root: ${detection.root}`));
+  console.log(`${detection.initialized ? ui.green("\u2713") : ui.red("\u2717")} project initialized`);
+  for (const cfg of detection.project_mcp) {
+    console.log(`${cfg.present ? ui.green("\u2713") : ui.yellow("\u2022")} ${cfg.client} project MCP ${ui.dim(path7.relative(detection.root, cfg.path))}`);
+  }
+  for (const agent of detection.installed_agents) {
+    const marker = agent.installed ? ui.green("\u2713") : ui.dim("\u2022");
+    const mcp = agent.mcp_configured === true ? " + hAIve MCP" : "";
+    console.log(`${marker} ${agent.agent} (${agent.command})${mcp}`);
+  }
+  console.log(ui.bold(`Recommended mode: ${detection.recommended_mode}`));
+  console.log(`  ${detection.recommended_command}`);
+}
+function printSetupResult(result) {
+  for (const item of result.project_results) {
+    if (item.status === "configured") ui.success(`${item.client} project MCP config written (${item.path})`);
+    else if (item.status === "already_configured") ui.info(`${item.client} already configured`);
+    else if (item.status === "error") ui.warn(`${item.client}: ${item.error}`);
   }
+  for (const item of result.global_results) {
+    if (item.status === "configured") ui.success(`${item.client} user-level MCP configured${item.path ? ` (${item.path})` : ""}`);
+    else if (item.status === "already_configured") ui.info(`${item.client} user-level MCP already configured`);
+    else if (item.status === "not_installed") ui.info(`${item.client} not detected`);
+    else if (item.status === "error") ui.warn(`${item.client}: ${item.error}`);
+  }
+  if (result.global_skipped_reason) ui.warn(result.global_skipped_reason);
+  ui.success(`Agent mode recorded at ${result.mode_file}`);
+  printDetection(result.detection, false);
 }
 
 // src/commands/init-bootstrap.ts
@@ -3425,6 +3435,27 @@ async function readStdin(maxBytes) {
     setTimeout(finish, 2e3);
   });
 }
+function detectFailure(payload) {
+  const response = payload.tool_response;
+  if (!response) return false;
+  const responseText = typeof response === "string" ? response : JSON.stringify(response);
+  if (payload.tool_name === "Bash") {
+    if (typeof response === "object") {
+      const code = response["exit_code"] ?? response["exitCode"];
+      if (typeof code === "number" && code !== 0) return true;
+    }
+    if (/\b(command not found|No such file or directory|ERR_MODULE_NOT_FOUND|ENOENT|EACCES)\b/.test(responseText)) return true;
+    if (/\berror TS\d+:/i.test(responseText)) return true;
+  }
+  if (["Edit", "Write", "Read"].includes(payload.tool_name ?? "")) {
+    if (typeof response === "object") {
+      const err = response["error"] ?? response["message"];
+      if (typeof err === "string" && err.length > 0) return true;
+    }
+  }
+  if (/^\s*(Error|FAILED|ENOENT|EACCES|unknown option|Cannot find module)\b/m.test(responseText)) return true;
+  return false;
+}
 function registerObserve(program2) {
   program2.command("observe").description(
     "Passive-capture endpoint for Claude Code PostToolUse hooks.\n\n  Reads a JSON payload on stdin and appends an observation record to\n  .ai/.cache/observations.jsonl. Always exits 0; never blocks the agent.\n  Wired up automatically by `haive install-hooks claude`."
@@ -3448,13 +3479,15 @@ function registerObserve(program2) {
       if (!root) return;
       const paths = resolveHaivePaths7(root);
       if (!existsSync12(paths.haiveDir)) return;
+      const failureHint = detectFailure(payload);
       const observation = {
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         session_id: payload.session_id,
         cwd: payload.cwd,
         tool: payload.tool_name ?? "?",
         summary: buildSummary(payload),
-        files: extractFiles(payload)
+        files: extractFiles(payload),
+        ...failureHint ? { failure_hint: true } : {}
       };
       const cacheDir = path13.join(paths.haiveDir, ".cache");
       await mkdir8(cacheDir, { recursive: true });
@@ -4874,7 +4907,12 @@ async function memSessionEnd(input, ctx) {
   }
   const body = buildBody(input);
   const topic = recapTopic(input.scope, input.module);
-  const invalidPaths = input.files_touched.filter(
+  const normalizedFiles = input.files_touched.map((p) => {
+    if (!p || !path82.isAbsolute(p)) return p;
+    const rel = path82.relative(ctx.paths.root, p);
+    return rel.startsWith("..") ? p : rel;
+  });
+  const invalidPaths = normalizedFiles.filter(
     (p) => !existsSync17(path82.resolve(ctx.paths.root, p))
   );
   if (invalidPaths.length > 0) {
@@ -4893,7 +4931,7 @@ async function memSessionEnd(input, ctx) {
       revision_count: revisionCount,
       anchor: {
         ...fm.anchor,
-        paths: input.files_touched.length ? input.files_touched : fm.anchor.paths
+        paths: normalizedFiles.length ? normalizedFiles : fm.anchor.paths
       }
     };
     await writeFile10(
@@ -4916,7 +4954,7 @@ async function memSessionEnd(input, ctx) {
     scope: input.scope,
     module: input.module,
     tags: ["session", "recap"],
-    paths: input.files_touched,
+    paths: normalizedFiles,
     topic,
     status: "validated"
   });
@@ -6525,7 +6563,9 @@ function isDocLikePath(file) {
 }
 function isPackageOrConfigPath(file) {
   const lower = file.toLowerCase();
-  return lower.endsWith("package.json") || lower.endsWith("package-lock.json") || lower.endsWith("pnpm-lock.yaml") || lower.endsWith("yarn.lock") || lower.endsWith("bun.lockb") || lower.endsWith(".config.ts") || lower.endsWith(".config.js") || lower.endsWith(".json") || lower.endsWith(".yml") || lower.endsWith(".yaml") || lower.startsWith(".github/workflows/");
+  const base = lower.split("/").pop() ?? lower;
+  return lower.endsWith("package.json") || lower.endsWith("package-lock.json") || lower.endsWith("pnpm-lock.yaml") || lower.endsWith("yarn.lock") || lower.endsWith("bun.lockb") || lower.endsWith(".config.ts") || lower.endsWith(".config.js") || lower.endsWith(".json") || lower.endsWith(".yml") || lower.endsWith(".yaml") || lower.endsWith(".toml") || lower.startsWith(".github/workflows/") || lower.startsWith(".github/") && lower.endsWith(".yml") || // Dotfiles that are pure configuration/tooling — never trigger runtime gotchas
+  base === ".gitignore" || base === ".gitattributes" || base === ".gitmodules" || base === ".editorconfig" || base === ".nvmrc" || base === ".node-version" || base === ".npmrc" || base === ".yarnrc" || base === ".yarnrc.yml" || base === ".dockerignore" || base === "dockerfile" || base.startsWith("dockerfile.") || base === ".env.example" || base === ".env.template" || lower.endsWith(".prettierrc") || lower.endsWith(".eslintrc") || lower.endsWith(".eslintignore") || lower.endsWith(".prettierignore") || lower.endsWith(".stylelintrc") || lower.endsWith(".browserslistrc");
 }
 function repairCommandForWarning(warning, paths) {
   const firstPath = paths[0];
@@ -7062,7 +7102,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.24";
+var SERVER_VERSION = "0.9.26";
 function jsonResult(data) {
   return {
     content: [
@@ -10226,6 +10266,7 @@ function registerMemoryDigest(program2) {
 // src/commands/session-end.ts
 import { writeFile as writeFile25, mkdir as mkdir15, readFile as readFile16, rm as rm2 } from "fs/promises";
 import { existsSync as existsSync53 } from "fs";
+import { spawn as spawn4 } from "child_process";
 import path36 from "path";
 import "commander";
 import {
@@ -10238,9 +10279,9 @@ import {
 } from "@hiveai/core";
 async function buildAutoRecap(paths) {
   const obsFile = path36.join(paths.haiveDir, ".cache", "observations.jsonl");
-  if (!existsSync53(obsFile)) return null;
+  if (!existsSync53(obsFile)) return await buildGitAutoRecap(paths);
   const raw = await readFile16(obsFile, "utf8").catch(() => "");
-  if (!raw.trim()) return null;
+  if (!raw.trim()) return await buildGitAutoRecap(paths);
   const lines = raw.split("\n").filter(Boolean);
   const obs = [];
   for (const line of lines) {
@@ -10249,27 +10290,119 @@ async function buildAutoRecap(paths) {
     } catch {
     }
   }
-  if (obs.length === 0) return null;
+  if (obs.length === 0) return await buildGitAutoRecap(paths);
   const toolCounts = /* @__PURE__ */ new Map();
-  const fileCounts = /* @__PURE__ */ new Map();
-  const summaries = [];
+  const writeFiles = /* @__PURE__ */ new Set();
+  const readFiles = /* @__PURE__ */ new Set();
   for (const o of obs) {
     toolCounts.set(o.tool, (toolCounts.get(o.tool) ?? 0) + 1);
-    for (const f of o.files ?? []) fileCounts.set(f, (fileCounts.get(f) ?? 0) + 1);
-    if (summaries.length < 10) summaries.push(`- ${o.summary}`);
+    const isWrite = ["Edit", "Write", "NotebookEdit"].includes(o.tool);
+    for (const f of o.files ?? []) {
+      const rel = normalizeAnchorPath(paths.root, f);
+      if (isWrite) writeFiles.add(rel);
+      else readFiles.add(rel);
+    }
   }
+  for (const f of writeFiles) readFiles.delete(f);
   const topTools = [...toolCounts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5).map(([t, c]) => `${t} \xD7${c}`).join(", ");
-  const topFiles = [...fileCounts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 8);
-  const goal = `Auto-captured session \u2014 ${obs.length} tool calls (${topTools})`;
-  const accomplished = summaries.length ? `Recent activity:
-${summaries.join("\n")}` : `Activity captured but no parseable summaries.`;
+  const recentCommits = await runGit(paths.root, ["log", "--oneline", "-5"]).catch(() => "");
+  const accomplishedParts = [];
+  if (writeFiles.size > 0) {
+    accomplishedParts.push(
+      `**Files modified (${writeFiles.size}):**`,
+      ...[...writeFiles].slice(0, 10).map((f) => `- \`${f}\``),
+      ...writeFiles.size > 10 ? [`- ...and ${writeFiles.size - 10} more`] : []
+    );
+  }
+  if (recentCommits.trim()) {
+    accomplishedParts.push("", "**Recent commits:**");
+    for (const line of recentCommits.trim().split("\n").slice(0, 5)) {
+      accomplishedParts.push(`- ${line}`);
+    }
+  }
+  if (accomplishedParts.length === 0) {
+    accomplishedParts.push(`${obs.length} tool calls (${topTools}) \u2014 no file writes detected.`);
+  }
+  const failures = obs.filter((o) => o.failure_hint);
+  const discoveriesParts = [];
+  if (failures.length > 0) {
+    discoveriesParts.push(
+      `\u26A0\uFE0F ${failures.length} failure${failures.length === 1 ? "" : "s"} detected \u2014 call \`mem_tried\` for each unresolved one:`,
+      ...failures.slice(0, 8).map((o) => `- ${o.summary.slice(0, 180)}`)
+    );
+  }
+  const goal = writeFiles.size > 0 ? `Edited ${writeFiles.size} file${writeFiles.size === 1 ? "" : "s"} across ${obs.length} tool calls` : `Session with ${obs.length} tool calls (${topTools}) \u2014 read-only or no writes captured`;
   return {
     goal,
-    accomplished,
-    files: topFiles.map(([f]) => f),
+    accomplished: accomplishedParts.join("\n"),
+    ...discoveriesParts.length > 0 ? { discoveries: discoveriesParts.join("\n") } : {},
+    files: [...writeFiles].slice(0, 12),
     rawCount: obs.length
   };
 }
+async function buildGitAutoRecap(paths) {
+  const changed = await runGit(paths.root, ["diff", "--name-only"]).catch(() => "");
+  const staged = await runGit(paths.root, ["diff", "--cached", "--name-only"]).catch(() => "");
+  const statusRaw = await runGit(paths.root, ["status", "--porcelain"]).catch(() => "");
+  const recentLog = await runGit(paths.root, ["log", "--oneline", "-5"]).catch(() => "");
+  const diffStat = await runGit(paths.root, ["diff", "--stat", "HEAD"]).catch(() => "");
+  const files = Array.from(new Set(
+    [
+      ...changed.split("\n"),
+      ...staged.split("\n"),
+      ...statusRaw.split("\n").map((line) => line.replace(/^[ MADRCU?!]{1,2}\s+/, ""))
+    ].map((s) => s.trim()).filter(Boolean).filter((file) => !file.startsWith(".ai/.runtime/") && !file.startsWith(".ai/.cache/"))
+  )).sort();
+  const modified = [];
+  const added = [];
+  const deleted = [];
+  for (const line of statusRaw.split("\n")) {
+    const code = line.substring(0, 2).trim();
+    const file = line.substring(3).trim().replace(/".+"/g, (m) => m.slice(1, -1));
+    if (!file || file.startsWith(".ai/.runtime/") || file.startsWith(".ai/.cache/")) continue;
+    if (code === "D" || code === "DD") deleted.push(file);
+    else if (code === "A" || code === "??") added.push(file);
+    else if (file) modified.push(file);
+  }
+  const accomplishedParts = [];
+  if (modified.length > 0) {
+    accomplishedParts.push(`**Modified (${modified.length}):**`);
+    for (const f of modified.slice(0, 8)) accomplishedParts.push(`- \`${f}\``);
+    if (modified.length > 8) accomplishedParts.push(`- ...and ${modified.length - 8} more`);
+  }
+  if (added.length > 0) {
+    accomplishedParts.push(`
+**Added (${added.length}):**`);
+    for (const f of added.slice(0, 5)) accomplishedParts.push(`- \`${f}\``);
+    if (added.length > 5) accomplishedParts.push(`- ...and ${added.length - 5} more`);
+  }
+  if (deleted.length > 0) {
+    accomplishedParts.push(`
+**Deleted (${deleted.length}):**`);
+    for (const f of deleted.slice(0, 5)) accomplishedParts.push(`- \`${f}\``);
+  }
+  if (recentLog.trim()) {
+    accomplishedParts.push("\n**Recent commits:**");
+    for (const line of recentLog.trim().split("\n").slice(0, 5)) {
+      accomplishedParts.push(`- ${line}`);
+    }
+  }
+  if (accomplishedParts.length === 0 && files.length === 0) return null;
+  if (accomplishedParts.length === 0) {
+    accomplishedParts.push(...files.slice(0, 12).map((f) => `- \`${f}\``));
+    if (files.length > 12) accomplishedParts.push(`- ...and ${files.length - 12} more`);
+  }
+  return {
+    goal: files.length > 0 ? `Session with ${files.length} changed file${files.length === 1 ? "" : "s"}` : `Session with recent commits (no uncommitted changes)`,
+    accomplished: accomplishedParts.join("\n"),
+    discoveries: diffStat.trim() ? `Git diff stat:
+\`\`\`
+${diffStat.trim()}
+\`\`\`` : void 0,
+    files: files.slice(0, 12),
+    rawCount: files.length
+  };
+}
 function buildRecapBody(opts) {
   const lines = [];
   lines.push(`## Goal
@@ -10295,6 +10428,24 @@ ${opts.next}`);
   }
   return lines.join("\n");
 }
+function runGit(cwd, args) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn4("git", args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    proc.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    proc.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    proc.on("error", reject);
+    proc.on("close", (code) => {
+      if (code === 0) resolve(stdout);
+      else reject(new Error(stderr || `git ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+}
 function recapTopic2(scope, module) {
   return module ? `session-recap-${scope}-${module}` : `session-recap-${scope}`;
 }
@@ -10333,6 +10484,7 @@ function registerSessionEnd(session2) {
       if (!synth) return;
       goal = goal ?? synth.goal;
       accomplished = accomplished ?? synth.accomplished;
+      opts.discoveries = opts.discoveries ?? synth.discoveries;
       if (!resolvedFiles && synth.files.length) resolvedFiles = synth.files.join(",");
     }
     if (!goal || !accomplished) {
@@ -10350,7 +10502,7 @@ function registerSessionEnd(session2) {
       next: opts.next
     });
     const topic = recapTopic2(scope, opts.module);
-    const filesTouched = parseCsv5(resolvedFiles);
+    const filesTouched = parseCsv5(resolvedFiles).map((p) => normalizeAnchorPath(root, p));
     const missingPaths = filesTouched.filter((p) => !existsSync53(path36.resolve(root, p)));
     if (missingPaths.length > 0 && !opts.quiet) {
       ui.warn(`Anchor path${missingPaths.length > 1 ? "s" : ""} not found in project (will be stale):`);
@@ -10415,6 +10567,13 @@ function parseCsv5(value) {
   if (!value) return [];
   return value.split(",").map((s) => s.trim()).filter(Boolean);
 }
+function normalizeAnchorPath(root, filePath) {
+  if (!filePath) return filePath;
+  if (!path36.isAbsolute(filePath)) return filePath;
+  const rel = path36.relative(root, filePath);
+  if (rel.startsWith("..")) return filePath;
+  return rel;
+}
 
 // src/commands/snapshot.ts
 import { existsSync as existsSync54 } from "fs";
@@ -11603,7 +11762,7 @@ function parseDays(input) {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync60 } from "fs";
+import { existsSync as existsSync60, statSync } from "fs";
 import { readFile as readFile19, stat } from "fs/promises";
 import path44 from "path";
 import { execFileSync, execSync as execSync3 } from "child_process";
@@ -11707,6 +11866,22 @@ function registerDoctor(program2) {
           fix: "haive memory pending      # list them\nhaive memory auto-promote   # promote those with high read_count"
         });
       }
+      const OLD_DRAFT_DAYS = 30;
+      const oldDrafts = memories.filter((m) => {
+        if (m.memory.frontmatter.status !== "draft") return false;
+        const age = (now - Date.parse(m.memory.frontmatter.created_at)) / MS_PER_DAY3;
+        return age > OLD_DRAFT_DAYS;
+      });
+      if (oldDrafts.length > 0) {
+        const ids = oldDrafts.slice(0, 4).map((m) => m.memory.frontmatter.id).join(", ");
+        const more = oldDrafts.length > 4 ? ` (+${oldDrafts.length - 4} more)` : "";
+        findings.push({
+          severity: "warn",
+          code: "stale-draft-memories",
+          message: `${oldDrafts.length} draft memor${oldDrafts.length === 1 ? "y has" : "ies have"} been in draft status for 30+ days: ${ids}${more}`,
+          fix: "haive memory approve <id>   # activate\nhaive memory rm <id>         # or delete if obsolete"
+        });
+      }
       const anchorless = memories.filter(
         (m) => m.memory.frontmatter.anchor.paths.length === 0 && m.memory.frontmatter.anchor.symbols.length === 0 && m.memory.frontmatter.type !== "session_recap" && m.memory.frontmatter.type !== "glossary" && m.memory.frontmatter.type !== "skill"
       );
@@ -11832,14 +12007,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.24"));
+    findings.push(...await collectInstallFindings(root, "0.9.26"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.24";
+      const cliVersion = "0.9.26";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -11996,13 +12171,22 @@ async function collectHarnessCoverageFindings(codeMap, memories) {
   }
   const covered = coveredFiles.size;
   const pct = Math.round(covered / total * 100);
+  const uncovered = codeFiles.filter((f) => !coveredFiles.has(f)).sort((a, b) => {
+    const depthA = a.split("/").length;
+    const depthB = b.split("/").length;
+    if (depthA !== depthB) return depthA - depthB;
+    return a.localeCompare(b);
+  }).slice(0, 5);
+  const coverageDesc = pct < 10 && total > 10 ? "Low coverage \u2014 add memory anchors on key modules to improve harness enforcement." : pct < 50 ? "Partial coverage \u2014 useful but not yet broad enough to call the harness mature." : pct < 80 ? "Good coverage \u2014 critical modules are increasingly protected." : "Good harness coverage.";
+  const uncoveredHint = uncovered.length > 0 ? `
+  Top uncovered: ${uncovered.map((f) => `\`${f}\``).join(", ")}` : "";
   const findings = [];
   findings.push({
     severity: "info",
     code: "harness-coverage",
     coverage_percent: pct,
-    message: `${covered}/${total} code-map files have validated memory anchors (${pct}%). ` + (pct < 10 && total > 10 ? "Low coverage \u2014 add memory anchors on key modules to improve harness enforcement." : pct < 50 ? "Partial coverage \u2014 useful but not yet broad enough to call the harness mature." : pct < 80 ? "Good coverage \u2014 critical modules are increasingly protected." : "Good harness coverage."),
-    fix: pct < 50 && total > 10 ? "haive memory add --type gotcha|convention|architecture --paths <key-file> --scope team" : void 0,
+    message: `${covered}/${total} code-map files have validated memory anchors (${pct}%). ` + coverageDesc + uncoveredHint,
+    fix: pct < 50 && total > 10 ? `haive memory add --type gotcha|convention|architecture --paths <key-file> --scope team` : void 0,
     section: "Harness coverage"
   });
   return findings;
@@ -12234,7 +12418,13 @@ function extractAbsoluteHaiveBins(text) {
   const re = /(["'\s])((?:\/[^"'\s]+)*\/haive)\b/g;
   let match;
   while (match = re.exec(text)) {
-    if (match[2]) out.add(match[2]);
+    const p = match[2];
+    if (!p) continue;
+    try {
+      if (statSync(p).isDirectory()) continue;
+    } catch {
+    }
+    out.add(p);
   }
   return [...out].sort();
 }
@@ -12357,7 +12547,7 @@ function truncate3(text, max) {
 }
 
 // src/commands/precommit.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn5 } from "child_process";
 import "commander";
 import {
   findProjectRoot as findProjectRoot43,
@@ -12484,7 +12674,7 @@ function printWarnings(title, warnings, tone) {
 }
 function runCommand3(cmd, args, cwd) {
   return new Promise((resolve, reject) => {
-    const proc = spawn4(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const proc = spawn5(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let stderr = "";
     proc.stdout.on("data", (chunk) => {
@@ -12734,8 +12924,8 @@ function registerMemoryConflictCandidates(memory2) {
 }
 
 // src/commands/enforce.ts
-import { execFileSync as execFileSync2, spawn as spawn5 } from "child_process";
-import { existsSync as existsSync67 } from "fs";
+import { execFileSync as execFileSync2, spawn as spawn6 } from "child_process";
+import { existsSync as existsSync67, statSync as statSync2 } from "fs";
 import { chmod as chmod2, mkdir as mkdir19, readFile as readFile20, readdir as readdir6, rm as rm3, writeFile as writeFile31 } from "fs/promises";
 import path49 from "path";
 import "commander";
@@ -12838,6 +13028,7 @@ function registerEnforce(program2) {
     await mkdir19(paths.runtimeDir, { recursive: true });
     const sessionId = opts.sessionId ?? payload.session_id;
     const task = opts.task ?? payload.prompt ?? "Start an AI coding session in this hAIve-initialized project.";
+    await applyLightweightRepairs(root, paths);
     const budget = resolveBriefingBudget3("quick", {
       max_tokens: 2500,
       max_memories: 5,
@@ -12899,7 +13090,27 @@ ${briefing.project_context.content.slice(0, 1800)}`);
     if (!existsSync67(paths.haiveDir)) return;
     if (!isWriteLikeTool(payload)) return;
     const ok = await hasRecentBriefingMarker(paths, payload.session_id);
-    if (ok) return;
+    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);
+      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")
+      );
+      process.exit(2);
+    }
     const tool = payload.tool_name ?? "write tool";
     console.error(
       [
@@ -12940,7 +13151,7 @@ async function runWithEnforcement(command, args, opts) {
   }
   ui.info(`hAIve briefing marker created for wrapped agent session: ${sessionId}`);
   ui.info(`Briefing written to ${path49.relative(root, briefingFile)} and exported as HAIVE_BRIEFING_FILE`);
-  const child = spawn5(command, args, {
+  const child = spawn6(command, args, {
     cwd: root,
     stdio: "inherit",
     env: {
@@ -12962,6 +13173,7 @@ async function runWithEnforcement(command, args, opts) {
   });
 }
 async function writeWrapperBriefing(paths, sessionId, task) {
+  await applyLightweightRepairs(paths.root, paths);
   const budget = resolveBriefingBudget3("quick", {
     max_tokens: 2500,
     max_memories: 5,
@@ -13016,6 +13228,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
   const paths = resolveHaivePaths44(root);
   const initialized = existsSync67(paths.haiveDir);
   const config = initialized ? await loadConfig10(paths) : {};
+  if (initialized) await applyLightweightRepairs(root, paths);
   const mode = config.enforcement?.mode ?? "strict";
   const findings = [];
   if (!initialized) {
@@ -13044,7 +13257,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.24"));
+  findings.push(...await inspectIntegrationVersions(root, "0.9.26"));
   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." } : {
@@ -13196,6 +13409,9 @@ async function verifyDecisionCoverage(paths, stage, sessionId) {
     code: "decision-coverage-missing",
     message: `${missing.length}/${relevant.length} relevant anchored decisions/policies were not present in the latest briefing: ${missing.slice(0, 6).map((m) => m.frontmatter.id).join(", ")}`,
     fix: `Run \`haive briefing --files "${changedFiles.slice(0, 10).join(",")}" --task "..."\` before committing.`,
+    reason: "Changed files overlap validated anchored policy memories that were not recorded in the latest briefing marker.",
+    affected_files: changedFiles.slice(0, 10),
+    memory_ids: missing.slice(0, 10).map((m) => m.frontmatter.id),
     impact: Math.min(35, 10 + missing.length * 5)
   }];
 }
@@ -13344,7 +13560,13 @@ function extractAbsoluteHaiveBins2(text) {
   const re = /(["'\s])((?:\/[^"'\s]+)*\/haive)\b/g;
   let match;
   while (match = re.exec(text)) {
-    if (match[2]) out.add(match[2]);
+    const p = match[2];
+    if (!p) continue;
+    try {
+      if (statSync2(p).isDirectory()) continue;
+    } catch {
+    }
+    out.add(p);
   }
   return [...out].sort();
 }
@@ -13501,8 +13723,21 @@ function printFindingGroup(title, findings, tone) {
 function printFinding(finding, explain = false) {
   const marker = finding.severity === "error" ? ui.red("\u2717") : finding.severity === "warn" ? ui.yellow("\u26A0") : finding.severity === "ok" ? ui.green("\u2713") : ui.dim("\u2022");
   console.log(`${marker} ${finding.code}: ${finding.message}`);
+  if (explain && finding.reason) console.log(ui.dim(`  why: ${finding.reason}`));
+  if (explain && finding.affected_files?.length) console.log(ui.dim(`  files: ${finding.affected_files.join(", ")}`));
+  if (explain && finding.memory_ids?.length) console.log(ui.dim(`  memories: ${finding.memory_ids.join(", ")}`));
   if (finding.fix) console.log(ui.dim(`${explain ? "  repair: " : "  fix: "}${finding.fix}`));
 }
+async function applyLightweightRepairs(root, paths) {
+  await applyAutopilotRepairs(root, paths, {
+    applyConfig: false,
+    applyContext: true,
+    applyCorpus: true,
+    applyCodeMap: false,
+    applyCodeSearch: true
+  }).catch(() => {
+  });
+}
 async function readHookPayload() {
   const raw = await readStdin2(MAX_STDIN_BYTES2);
   if (!raw.trim()) return {};
@@ -13526,6 +13761,51 @@ function isWriteLikeTool(payload) {
   const command = String(payload.tool_input?.["command"] ?? "");
   return /\b(rm|mv|cp|mkdir|touch|tee|sed|perl|python|node|npm|pnpm|yarn|git)\b/.test(command) || />{1,2}/.test(command);
 }
+function extractToolPaths(payload, root) {
+  const input = payload.tool_input ?? {};
+  const values = [
+    input["file_path"],
+    input["path"],
+    input["notebook_path"]
+  ];
+  if (Array.isArray(input["file_paths"])) values.push(...input["file_paths"]);
+  if (Array.isArray(input["files"])) values.push(...input["files"]);
+  if (payload.tool_name === "MultiEdit" && Array.isArray(input["edits"])) {
+    for (const edit of input["edits"]) {
+      if (edit && typeof edit === "object" && "file_path" in edit) {
+        values.push(edit.file_path);
+      }
+    }
+  }
+  const out = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (typeof value !== "string" || !value.trim()) continue;
+    out.add(normalizeToolPath(value, root));
+  }
+  return [...out].filter(Boolean).sort();
+}
+function normalizeToolPath(file, root) {
+  const normalized = file.replace(/\\/g, "/");
+  if (!path49.isAbsolute(normalized)) return normalized.replace(/^\.\//, "");
+  return path49.relative(root, normalized).replace(/\\/g, "/");
+}
+async function missingRequiredMemoriesForFiles(paths, files, sessionId) {
+  if (!existsSync67(paths.memoriesDir)) return [];
+  const marker = await readRecentBriefingMarker(paths, sessionId);
+  const consulted = new Set(marker?.memory_ids ?? []);
+  const policyTypes = /* @__PURE__ */ new Set(["decision", "gotcha", "architecture", "convention", "attempt"]);
+  const all = await loadMemoriesFromDir36(paths.memoriesDir);
+  return all.filter(({ memory: memory2 }) => {
+    const fm = memory2.frontmatter;
+    if (!policyTypes.has(fm.type)) return false;
+    if (fm.status !== "validated") return false;
+    if (consulted.has(fm.id)) return false;
+    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(", ")}"`;
+}
 async function readStdin2(maxBytes) {
   if (process.stdin.isTTY) return "";
   return await new Promise((resolve) => {
@@ -13553,7 +13833,7 @@ async function readStdin2(maxBytes) {
 }
 function runCommand4(cmd, args, cwd) {
   return new Promise((resolve, reject) => {
-    const proc = spawn5(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const proc = spawn6(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let stderr = "";
     proc.stdout.on("data", (chunk) => {
@@ -13584,7 +13864,7 @@ function registerRun(program2) {
 
 // src/index.ts
 var program = new Command51();
-program.name("haive").description("hAIve \u2014 the memory and enforcement layer of your agent harness").version("0.9.24").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.26").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);