@hiveai/cli 0.13.9 → 0.14.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command58 } from "commander";
+import { Command as Command59 } from "commander";
 
 // src/commands/briefing.ts
 import { existsSync as existsSync3 } from "fs";
@@ -199,7 +199,7 @@ async function getHotFiles(root, daysBack, maxHotFiles, filePaths) {
       if (!f) continue;
       counts.set(f, (counts.get(f) ?? 0) + 1);
     }
-    let entries = [...counts.entries()].map(([path55, changes]) => ({ path: path55, changes }));
+    let entries = [...counts.entries()].map(([path56, changes]) => ({ path: path56, changes }));
     const lowerPaths = filePaths.map((p) => p.toLowerCase());
     if (lowerPaths.length > 0) {
       entries = entries.filter((e) => lowerPaths.some((p) => e.path.toLowerCase().includes(p)));
@@ -3019,7 +3019,7 @@ ${SEED_FOOTER(stack)}` });
 }
 
 // src/commands/init.ts
-var HAIVE_GITHUB_ACTION_REF = `v${"0.13.9"}`;
+var HAIVE_GITHUB_ACTION_REF = `v${"0.14.0"}`;
 var PROJECT_CONTEXT_TEMPLATE = `# Project context
 
 > Generated by \`haive init\`. Run \`haive init --bootstrap\` to auto-fill from your codebase,
@@ -4089,10 +4089,13 @@ import {
   literalMatchesAnyToken as literalMatchesAnyToken22,
   loadCodeMap as loadCodeMap5,
   loadConfig as loadConfig3,
+  hashProjectContext,
   loadMemoriesFromDir as loadMemoriesFromDir15,
   loadUsageIndex as loadUsageIndex8,
   memoryMatchesAnchorPaths as memoryMatchesAnchorPaths22,
+  projectContextRecentlyEmitted,
   rankMemoriesLexical as rankMemoriesLexical2,
+  recordProjectContextEmission,
   queryCodeMap as queryCodeMap2,
   resolveBriefingBudget as resolveBriefingBudget2,
   serializeMemory as serializeMemory10,
@@ -5711,6 +5714,9 @@ var GetBriefingInputSchema = {
   ),
   max_memories: z19.number().int().positive().default(8).describe("Cap on memories surfaced regardless of token budget"),
   include_project_context: z19.boolean().default(true),
+  dedupe_project_context: z19.boolean().optional().describe(
+    "Token saver (default ON): skip re-emitting the project-context body if an identical copy was already sent within the last few minutes this session (the agent still has it). Set false to always include it."
+  ),
   include_module_contexts: z19.boolean().default(true),
   semantic: z19.boolean().default(true).describe(
     "Use semantic ranking when a task is provided (requires `haive embeddings index`)."
@@ -5918,7 +5924,17 @@ async function getBriefing(input, ctx) {
       }
     }
   }
-  const projectContextRaw = input.include_project_context && existsSync21(ctx.paths.projectContext) ? await readFile52(ctx.paths.projectContext, "utf8") : "";
+  let projectContextRaw = input.include_project_context && existsSync21(ctx.paths.projectContext) ? await readFile52(ctx.paths.projectContext, "utf8") : "";
+  let contextOmittedRecent = false;
+  if (projectContextRaw && input.dedupe_project_context !== false) {
+    const ctxHash = hashProjectContext(projectContextRaw);
+    if (await projectContextRecentlyEmitted(ctx.paths, ctxHash)) {
+      contextOmittedRecent = true;
+      projectContextRaw = "";
+    } else {
+      await recordProjectContextEmission(ctx.paths, ctxHash);
+    }
+  }
   const isTemplateContext = projectContextRaw.includes("TODO \u2014 high-level overview") || projectContextRaw.includes("Generated by `haive init`");
   const setupWarnings = [];
   let autoContextGenerated = false;
@@ -6186,7 +6202,11 @@ When done, call \`mem_session_end\` to acknowledge \u2014 this clears the pendin
     search_mode: searchMode,
     inferred_modules: inferred,
     ...lastSession ? { last_session: lastSession } : {},
-    project_context: adaptiveTrim ? {
+    project_context: contextOmittedRecent ? {
+      content: "(project context unchanged \u2014 omitted to save tokens; it was provided earlier this session. Pass dedupe_project_context:false to force a full copy.)",
+      truncated: false,
+      omitted_recent: true
+    } : adaptiveTrim ? {
       content: "(adaptive briefing: auto-generated context omitted \u2014 no team-specific policy matched, so a capable model needs nothing extra here)",
       truncated: false,
       ...isTemplateContext && !autoContextGenerated ? { is_template: true } : {},
@@ -7504,7 +7524,7 @@ async function patternDetect(input, ctx) {
   for (const [p, { count, tools }] of pathCounts) {
     if (count < HOT_FILE_MIN) continue;
     if (tools.has("mem_tried") || tools.has("mem_observe")) continue;
-    if (CONFIG_PATTERNS.some((cp) => path122.basename(p).includes(cp))) continue;
+    if (CONFIG_PATTERNS.some((cp2) => path122.basename(p).includes(cp2))) continue;
     const slug = p.replace(/[^a-z0-9]/g, "-").replace(/-+/g, "-").slice(0, 40);
     matches.push({
       kind: "hot_file",
@@ -7938,7 +7958,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.13.9";
+var SERVER_VERSION = "0.14.0";
 function jsonResult(data) {
   return {
     content: [
@@ -8687,6 +8707,7 @@ function createHaiveServer(options = {}) {
     "anti_patterns_check",
     [
       "Scan a diff (or set of paths) against documented attempt/gotcha memories.",
+      "[Diff-scan layer: the MEMORY-MATCH component. `pre_commit_check` combines this with sensors + stale checks; `haive enforce check` is the gate.]",
       "Surfaces 'you are about to repeat a known mistake' warnings BEFORE you commit.",
       "",
       "USE BEFORE finalizing a non-trivial change. Cheap and high-signal: the only",
@@ -8830,6 +8851,7 @@ function createHaiveServer(options = {}) {
     "pre_commit_check",
     [
       "One-shot 'should I block this commit?' check. Combines three signals:",
+      "[Diff-scan layer: the COMBINED check (sensors + anti-patterns + stale). `haive enforce check` is the gate that runs this at commit time.]",
       "",
       "  1. anti_patterns_check \u2014 known gotchas/attempts that match the diff",
       "  2. mem_for_files       \u2014 conventions/decisions anchored to touched files",
@@ -13308,8 +13330,8 @@ function registerDoctor(program2) {
         fix: "haive init"
       });
     } else {
-      const { readFile: readFile26 } = await import("fs/promises");
-      const content = await readFile26(paths.projectContext, "utf8");
+      const { readFile: readFile27 } = await import("fs/promises");
+      const content = await readFile27(paths.projectContext, "utf8");
       const isTemplate = content.includes("TODO \u2014 high-level overview") || content.includes("Generated by `haive init`");
       if (isTemplate) {
         findings.push({
@@ -13483,8 +13505,8 @@ function registerDoctor(program2) {
       let hasClaudeEnforcement = false;
       if (existsSync68(claudeSettings)) {
         try {
-          const { readFile: readFile26 } = await import("fs/promises");
-          const raw = await readFile26(claudeSettings, "utf8");
+          const { readFile: readFile27 } = await import("fs/promises");
+          const raw = await readFile27(claudeSettings, "utf8");
           hasClaudeEnforcement = raw.includes("haive enforce session-start") && raw.includes("haive enforce pre-tool-use");
         } catch {
           hasClaudeEnforcement = false;
@@ -13507,7 +13529,7 @@ function registerDoctor(program2) {
         fix: "Edit .ai/haive.config.json: set autoSessionEnd: true (or re-run `haive init` without --manual)."
       });
     }
-    findings.push(...await collectInstallFindings(root, "0.13.9"));
+    findings.push(...await collectInstallFindings(root, "0.14.0"));
     findings.push(...await collectToolchainFindings(root));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
@@ -13515,7 +13537,7 @@ function registerDoctor(program2) {
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.13.9";
+      const cliVersion = "0.14.0";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -14748,52 +14770,73 @@ ${briefing.project_context.content.slice(0, 1800)}`);
 [setup warning] ${warning}`);
     }
   });
-  enforce.command("pre-tool-use").description("Claude Code PreToolUse hook: block writes until hAIve briefing has been loaded.").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  enforce.command("pre-tool-use").description("Claude Code PreToolUse hook: surface the relevant team policy for the edited file (advise; configurable to block).").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const payload = await readHookPayload();
     const root = resolveRoot(opts.dir, payload);
     if (!root) return;
     const paths = resolveHaivePaths48(root);
     if (!existsSync75(paths.haiveDir)) return;
     if (!isWriteLikeTool(payload)) return;
-    const ok = await hasRecentBriefingMarker2(paths, payload.session_id);
-    if (ok) {
-      const targetFiles = extractToolPaths(payload, root);
-      if (targetFiles.length === 0) return;
-      const missing = await missingRequiredMemoriesForFiles(paths, targetFiles, payload.session_id);
-      if (missing.length === 0) return;
-      const ids = missing.slice(0, 6).map((memory2) => memory2.memory.frontmatter.id);
+    const config = await loadConfig13(paths);
+    if (config.enforcement?.requireBriefingFirst === false) return;
+    const gate = config.enforcement?.preEditGate ?? "advise";
+    const targetFiles = extractToolPaths(payload, root);
+    const hasMarker = await hasRecentBriefingMarker2(paths, payload.session_id);
+    const missing = targetFiles.length > 0 ? await missingRequiredMemoriesForFiles(paths, targetFiles, payload.session_id) : [];
+    if (hasMarker && missing.length === 0) return;
+    if (targetFiles.length > 0) {
+      await recordFilesIntoBriefingMarker(paths, targetFiles, missing, payload.session_id).catch(() => {
+      });
+    }
+    const contextText = buildPreEditContext(payload.tool_name ?? "write tool", targetFiles, missing, hasMarker);
+    if (gate === "block") {
       console.error(
-        [
-          "hAIve enforcement blocked this action.",
-          `Tool: ${payload.tool_name ?? "write tool"}`,
-          `Files: ${targetFiles.slice(0, 6).join(", ")}`,
-          "",
-          "These files have required hAIve context that was not in the current briefing:",
-          ...ids.map((id) => `  - ${id}`),
-          "",
-          "Load the targeted briefing before editing:",
-          `  ${briefingCommandForFiles(targetFiles)}`
-        ].join("\n")
+        contextText + '\n\nThe relevant context is now recorded \u2014 re-issue the same edit to proceed (no `haive briefing` command needed). To make this advisory instead of blocking, set `{ "enforcement": { "preEditGate": "advise" } }` in .ai/haive.config.json.'
       );
       process.exit(2);
     }
-    const tool = payload.tool_name ?? "write tool";
-    console.error(
-      [
-        "hAIve enforcement blocked this action.",
-        `Tool: ${tool}`,
-        "",
-        "This project is initialized with hAIve. Load the team briefing before editing:",
-        "  haive enforce session-start",
-        "or call MCP get_briefing / mem_relevant_to from your AI client.",
-        "",
-        "If this is intentional, a human can disable enforcement in .ai/haive.config.json:",
-        '  { "enforcement": { "requireBriefingFirst": false } }'
-      ].join("\n")
-    );
-    process.exit(2);
+    emitPreToolUseContext(contextText);
   });
 }
+async function recordFilesIntoBriefingMarker(paths, files, missing, sessionId) {
+  const existing = await readRecentBriefingMarker(paths, sessionId);
+  const ids = new Set(existing?.memory_ids ?? []);
+  for (const { memory: memory2 } of missing) ids.add(memory2.frontmatter.id);
+  await writeBriefingMarker3(paths, {
+    sessionId,
+    task: existing?.task ?? "pre-edit auto-briefing",
+    source: "haive-pre-edit",
+    files,
+    memoryIds: [...ids]
+  });
+}
+function buildPreEditContext(tool, files, missing, hasMarker) {
+  const lines = ["hAIve \u2014 relevant team policy for this edit", `Tool: ${tool}`];
+  if (files.length > 0) lines.push(`Files: ${files.slice(0, 6).join(", ")}`);
+  if (missing.length > 0) {
+    lines.push("", "Consult these before editing (anchored to the files you are touching):");
+    for (const { memory: memory2 } of missing.slice(0, 5)) {
+      const fm = memory2.frontmatter;
+      lines.push("", `### ${fm.id}  (${fm.scope}/${fm.type})`, memory2.body.trim().slice(0, 900));
+    }
+  } else if (!hasMarker) {
+    lines.push(
+      "",
+      "No team briefing was loaded yet this session. Proceeding \u2014 but for substantive work call get_briefing / mem_relevant_to for richer context."
+    );
+  }
+  return lines.join("\n");
+}
+function emitPreToolUseContext(text) {
+  console.log(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        additionalContext: text
+      }
+    })
+  );
+}
 async function buildFinishReport(dir) {
   const root = findProjectRoot52(dir);
   const paths = resolveHaivePaths48(root);
@@ -15124,7 +15167,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "hAIve enforcement is disabled." }]
     });
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.13.9"));
+  findings.push(...await inspectIntegrationVersions(root, "0.14.0"));
   if (config.enforcement?.requireBriefingFirst !== false && stage !== "ci") {
     const hasBriefing = await hasRecentBriefingMarker2(paths, sessionId);
     findings.push(hasBriefing ? { severity: "ok", code: "briefing-loaded", message: "A recent hAIve briefing marker exists." } : {
@@ -15242,7 +15285,7 @@ async function verifyMemoryPolicy(paths, config) {
 }
 async function verifyDecisionCoverage(paths, stage, sessionId) {
   if (!existsSync75(paths.memoriesDir)) return [];
-  const changedFiles = await getChangedFiles(paths.root, stage);
+  const changedFiles = (await getChangedFiles(paths.root, stage)).filter((f) => !isGeneratedArtifact(f));
   if (changedFiles.length === 0) {
     return [{ severity: "info", code: "decision-coverage-no-changes", message: "No changed files to match against policy memories." }];
   }
@@ -16039,8 +16082,10 @@ async function missingRequiredMemoriesForFiles(paths, files, sessionId) {
     return memoryMatchesAnchorPaths6(memory2, files);
   }).map(({ memory: memory2, filePath }) => ({ memory: memory2, filePath }));
 }
-function briefingCommandForFiles(files) {
-  return `haive briefing --files "${files.slice(0, 10).join(",")}" --task "edit ${files.slice(0, 3).join(", ")}"`;
+function isGeneratedArtifact(file) {
+  if (file === ".ai/project-context.md" || file === ".ai/code-map.json") return true;
+  if (file.startsWith(".ai/.cache/") || file.startsWith(".ai/.runtime/") || file.startsWith(".ai/.usage/")) return true;
+  return false;
 }
 async function readStdin2(maxBytes) {
   if (process.stdin.isTTY) return "";
@@ -16151,7 +16196,9 @@ function registerSensors(program2) {
       if (row.last_fired) console.log(`     ${ui.dim("last fired:")} ${row.last_fired}`);
     }
   });
-  sensors.command("check").description("Run regex sensors against a diff; defaults to `git diff --cached`").option("--diff-file <path>", "read unified diff from a file instead of staged changes").option("--json", "emit JSON", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
+  sensors.command("check").description(
+    "Run regex sensors against a diff (the deterministic/computational layer); defaults to `git diff --cached`.\n  Diff-scan layers: `sensors check` (regex) and `anti_patterns_check` (memory match) are components;\n  `pre_commit_check` combines them; `haive enforce check` is THE gate that runs at commit."
+  ).option("--diff-file <path>", "read unified diff from a file instead of staged changes").option("--json", "emit JSON", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot53(opts.dir);
     const paths = resolveHaivePaths49(root);
     const memories = await runnableSensorMemories(paths);
@@ -16634,9 +16681,72 @@ function warnNum(n) {
   return n > 0 ? ui.yellow(String(n)) : String(n);
 }
 
+// src/commands/dev-link.ts
+import { execFile as execFile3 } from "child_process";
+import { cp, readFile as readFile26 } from "fs/promises";
+import { existsSync as existsSync79 } from "fs";
+import path55 from "path";
+import { promisify as promisify3 } from "util";
+import "commander";
+import { findProjectRoot as findProjectRoot56 } from "@hiveai/core";
+var exec3 = promisify3(execFile3);
+function registerDevLink(program2) {
+  const dev = program2.commands.find((c) => c.name() === "dev") ?? program2.command("dev").description("Developer utilities for working on hAIve itself.");
+  dev.command("link").description("Hot-swap this repo's built dist into the global @hiveai install so `haive` runs your local code.").option("-d, --dir <dir>", "repo root (default: discovered from cwd)").option("--json", "emit a machine-readable summary", false).action(async (opts) => {
+    const root = findProjectRoot56(opts.dir);
+    if (!existsSync79(path55.join(root, "packages", "cli", "dist", "index.js"))) {
+      ui.error(`Not the hAIve monorepo (no packages/cli/dist) at ${root}. Run \`pnpm -r build\` first, or pass --dir.`);
+      process.exitCode = 1;
+      return;
+    }
+    let globalModules;
+    try {
+      globalModules = (await exec3("npm", ["root", "-g"])).stdout.trim();
+    } catch {
+      globalModules = path55.join(path55.dirname(path55.dirname(process.execPath)), "lib", "node_modules");
+    }
+    const globalHive = path55.join(globalModules, "@hiveai");
+    if (!existsSync79(globalHive)) {
+      ui.error(`No global @hiveai install at ${globalHive}. Install once with \`npm i -g @hiveai/cli\`, then re-run.`);
+      process.exitCode = 1;
+      return;
+    }
+    const linked = [];
+    const copyDist = async (fromPkg, toDistDir) => {
+      const from = path55.join(root, "packages", fromPkg, "dist");
+      if (!existsSync79(from) || !existsSync79(path55.dirname(toDistDir))) return;
+      await cp(from, toDistDir, { recursive: true });
+      linked.push(path55.relative(globalModules, toDistDir));
+    };
+    for (const pkg of ["cli", "mcp"]) {
+      await copyDist(pkg, path55.join(globalHive, pkg, "dist"));
+      for (const nested of ["core", "embeddings"]) {
+        await copyDist(nested, path55.join(globalHive, pkg, "node_modules", "@hiveai", nested, "dist"));
+      }
+    }
+    await copyDist("core", path55.join(globalHive, "core", "dist"));
+    let version = "unknown";
+    try {
+      version = JSON.parse(await readFile26(path55.join(root, "package.json"), "utf8")).version ?? "unknown";
+    } catch {
+    }
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: linked.length > 0, version, global_root: globalHive, linked }, null, 2));
+      return;
+    }
+    if (linked.length === 0) {
+      ui.warn("Nothing linked \u2014 no matching dist targets were found in the global install.");
+      return;
+    }
+    ui.success(`Linked local dist (v${version}) into the global @hiveai install:`);
+    for (const t of linked) console.log(`  ${ui.dim("\u2192")} ${t}`);
+    console.log(ui.dim("The global `haive` now runs your local build (git hooks + MCP included)."));
+  });
+}
+
 // src/index.ts
-var program = new Command58();
-program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.13.9").option("--advanced", "show maintenance and experimental commands in help");
+var program = new Command59();
+program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.14.0").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -16647,6 +16757,7 @@ registerAgent(program);
 registerSensors(program);
 registerIngest(program);
 registerDashboard(program);
+registerDevLink(program);
 registerMcp(program);
 registerBriefing(program);
 registerTui(program);