@hiveai/cli 0.20.0 → 0.21.0

package/dist/index.js

@@ -834,7 +834,7 @@ var TokenBudgetWriter = class {
 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(
+  ).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("--json", "emit the ranked briefing as JSON (memories + scores + priority), like the MCP get_briefing tool", false).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
@@ -897,8 +897,10 @@ function registerBriefing(program2) {
       budgetTokensCap = presetNums.max_tokens;
       maxMemories = presetNums.max_memories;
     }
+    const json = opts.json === true;
     const writer = budgetTokensCap !== null ? new TokenBudgetWriter(budgetTokensCap * CHARS_PER_TOKEN) : null;
     const out = (text) => {
+      if (json) return true;
       if (writer) return writer.write(text);
       console.log(text);
       return true;
@@ -1015,6 +1017,10 @@ function registerBriefing(program2) {
     scored.sort((a, b) => b.score - a.score);
     const top = scored.slice(0, maxMemories);
     if (top.length === 0) {
+      if (json) {
+        console.log(JSON.stringify({ task: opts.task ?? null, memories: [], briefing_quality: "thin" }, null, 2));
+        return;
+      }
       ui.info("No relevant memories found.");
       const draftCount = all.filter(
         (m) => m.memory.frontmatter.status === "draft" && (scopeFilter === "all" || m.memory.frontmatter.scope === scopeFilter)
@@ -1046,6 +1052,26 @@ function registerBriefing(program2) {
     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";
+    if (json) {
+      console.log(JSON.stringify({
+        task: opts.task ?? null,
+        files: filePaths,
+        briefing_quality: quality,
+        counts: { must_read: mustReadCount, useful: usefulCount, background: backgroundCount },
+        recap_id: recaps[0]?.memory.frontmatter.id ?? null,
+        memories: top.map((item, i) => ({
+          id: item.memory.frontmatter.id,
+          scope: item.memory.frontmatter.scope,
+          type: item.memory.frontmatter.type,
+          status: item.memory.frontmatter.status,
+          priority: priorities[i],
+          score: item.score,
+          file: path3.relative(root, item.filePath),
+          summary: (item.memory.body.split("\n").map((l) => l.replace(/^#+\s*/, "").trim()).find((l) => l.length > 0) ?? "").slice(0, 140)
+        }))
+      }, null, 2));
+      return;
+    }
     out(ui.dim(`briefing_quality: ${quality} \xB7 must_read=${mustReadCount} useful=${usefulCount} background=${backgroundCount}`));
     out("");
     for (const [idx, item] of top.entries()) {
@@ -2222,6 +2248,7 @@ import { existsSync as existsSync10 } from "fs";
 import path10 from "path";
 import {
   buildFrontmatter,
+  loadMemoriesFromDir as loadMemoriesFromDir5,
   memoryFilePath,
   serializeMemory as serializeMemory2,
   STACK_PACK_TAG
@@ -3299,6 +3326,15 @@ async function seedStackPack(haivePaths, stack) {
   const memories = PACKS[stack];
   if (!memories) return { memories: 0, sensors: 0 };
   await mkdir5(haivePaths.teamDir, { recursive: true });
+  const DATE_PREFIX = /^\d{4}-\d{2}-\d{2}-/;
+  const existingTopics = /* @__PURE__ */ new Set();
+  const existingSignatures = /* @__PURE__ */ new Set();
+  if (existsSync10(haivePaths.memoriesDir)) {
+    for (const { memory: memory2 } of await loadMemoriesFromDir5(haivePaths.memoriesDir)) {
+      if (memory2.frontmatter.topic) existingTopics.add(memory2.frontmatter.topic);
+      existingSignatures.add(memory2.frontmatter.id.replace(DATE_PREFIX, ""));
+    }
+  }
   let memCount = 0;
   let sensorCount = 0;
   for (const mem of memories) {
@@ -3313,6 +3349,9 @@ async function seedStackPack(haivePaths, stack) {
       last_fired: null
     } : void 0;
     const combinedSlug = mem.slug === stack || mem.slug.startsWith(`${stack}-`) ? mem.slug : `${stack}-${mem.slug}`;
+    const topic = `stack-pack:${stack}:${mem.slug}`;
+    const signature = `${mem.type}-${combinedSlug}`;
+    if (existingTopics.has(topic) || existingSignatures.has(signature)) continue;
     const fm = buildFrontmatter({
       type: mem.type,
       slug: combinedSlug,
@@ -3321,15 +3360,24 @@ async function seedStackPack(haivePaths, stack) {
       // STACK_PACK_TAG marks this as generic seed knowledge so briefing ranking
       // keeps it at `background` priority until it earns a repo-specific anchor.
       tags: [...mem.tags, STACK_PACK_TAG],
+      topic,
       ...sensor ? { sensor } : {}
     });
     const filePath = memoryFilePath(haivePaths, "team", fm.id);
     if (existsSync10(filePath)) continue;
-    const content = serializeMemory2({ frontmatter: fm, body: `${mem.body}
+    const ruleSlug = combinedSlug.startsWith(`${stack}-`) ? combinedSlug.slice(stack.length + 1) : combinedSlug;
+    const titleCase = (s) => s.split("-").filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+    const heading = `${titleCase(stack)}: ${titleCase(ruleSlug)}`;
+    const titledBody = /^#{1,3}\s+\S/m.test(mem.body.trim()) ? mem.body : `# ${heading}
+
+${mem.body}`;
+    const content = serializeMemory2({ frontmatter: fm, body: `${titledBody}
 
 ${SEED_FOOTER(stack)}` });
     await mkdir5(path10.dirname(filePath), { recursive: true });
     await writeFile6(filePath, content, "utf8");
+    existingTopics.add(topic);
+    existingSignatures.add(signature);
     memCount++;
     if (sensor) sensorCount++;
   }
@@ -3338,7 +3386,7 @@ ${SEED_FOOTER(stack)}` });
 
 // src/commands/init.ts
 var execFileAsync = promisify2(execFile2);
-var HAIVE_GITHUB_ACTION_REF = `v${"0.20.0"}`;
+var HAIVE_GITHUB_ACTION_REF = `v${"0.21.0"}`;
 var PROJECT_CONTEXT_TEMPLATE = `# Project context
 
 > Generated by \`haive init\`. Run \`haive init --bootstrap\` to auto-fill from your codebase,
@@ -4459,7 +4507,7 @@ import { existsSync as existsSync22 } from "fs";
 import path22 from "path";
 import { z as z2 } from "zod";
 import { existsSync as existsSync32 } from "fs";
-import { loadMemoriesFromDir as loadMemoriesFromDir5 } from "@hiveai/core";
+import { loadMemoriesFromDir as loadMemoriesFromDir6 } from "@hiveai/core";
 import { z as z3 } from "zod";
 import { createHash } from "crypto";
 import { mkdir as mkdir22, writeFile as writeFile22 } from "fs/promises";
@@ -4511,7 +4559,7 @@ import {
   applyFeedbackAdjustment,
   computeImpact,
   getUsage as getUsage22,
-  loadMemoriesFromDir as loadMemoriesFromDir6,
+  loadMemoriesFromDir as loadMemoriesFromDir62,
   loadUsageIndex as loadUsageIndex32,
   recordApplied,
   recordRejection as recordRejection2,
@@ -4842,7 +4890,7 @@ async function memList(input, ctx) {
   if (!existsSync32(ctx.paths.memoriesDir)) {
     return { memories: [] };
   }
-  const all = await loadMemoriesFromDir5(ctx.paths.memoriesDir);
+  const all = await loadMemoriesFromDir6(ctx.paths.memoriesDir);
   const filtered = all.filter(({ memory: memory2 }) => {
     const fm = memory2.frontmatter;
     if (input.scope && fm.scope !== input.scope) return false;
@@ -5374,7 +5422,7 @@ async function memFeedback(input, ctx) {
   if (!existsSync82(ctx.paths.memoriesDir)) {
     return { ok: false, id: input.id, error: "No .ai/memories \u2014 run `haive init` first." };
   }
-  const all = await loadMemoriesFromDir6(ctx.paths.memoriesDir);
+  const all = await loadMemoriesFromDir62(ctx.paths.memoriesDir);
   const target = all.find((m) => m.memory.frontmatter.id === input.id);
   if (!target) {
     return { ok: false, id: input.id, error: `No memory with id '${input.id}'.` };
@@ -8584,7 +8632,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.20.0";
+var SERVER_VERSION = "0.21.0";
 function jsonResult(data) {
   return {
     content: [
@@ -14336,7 +14384,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.20.0"));
+    findings.push(...await collectInstallFindings(root, "0.21.0"));
     findings.push(...await collectToolchainFindings(root));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
@@ -14344,7 +14392,7 @@ function registerDoctor(program2) {
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.20.0";
+      const cliVersion = "0.21.0";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -16044,7 +16092,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "hAIve enforcement is disabled." }]
     });
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.20.0"));
+  findings.push(...await inspectIntegrationVersions(root, "0.21.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." } : {
@@ -16167,8 +16215,9 @@ async function verifyDecisionCoverage(paths, stage, sessionId) {
     return [{ severity: "info", code: "decision-coverage-no-changes", message: "No changed files to match against policy memories." }];
   }
   const all = await loadMemoriesFromDir38(paths.memoriesDir);
+  const changedSet = new Set(changedFiles);
   const policyTypes = /* @__PURE__ */ new Set(["decision", "gotcha", "architecture", "convention"]);
-  const relevant = all.map(({ memory: memory2 }) => memory2).filter((memory2) => {
+  const relevant = all.filter(({ memory: memory2 }) => {
     const fm = memory2.frontmatter;
     if (!policyTypes.has(fm.type)) return false;
     if (fm.status !== "validated") return false;
@@ -16187,12 +16236,16 @@ async function verifyDecisionCoverage(paths, stage, sessionId) {
       severity: "ok",
       code: "decision-coverage-ci-pass",
       message: `CI surfaced ${relevant.length} relevant anchored decision/polic${relevant.length === 1 ? "y" : "ies"} for ${changedFiles.length} changed file(s). Runtime briefing markers are local-only and are not expected on GitHub Actions.`,
-      memory_ids: relevant.slice(0, 20).map((memory2) => memory2.frontmatter.id),
+      memory_ids: relevant.slice(0, 20).map(({ memory: memory2 }) => memory2.frontmatter.id),
       affected_files: changedFiles.slice(0, 10)
     }];
   }
   const consulted = new Set(marker?.memory_ids ?? []);
-  const missing = relevant.filter((memory2) => !consulted.has(memory2.frontmatter.id));
+  const missing = relevant.filter(({ memory: memory2, filePath }) => {
+    if (consulted.has(memory2.frontmatter.id)) return false;
+    if (changedSet.has(path53.relative(paths.root, filePath))) return false;
+    return true;
+  }).map(({ memory: memory2 }) => memory2);
   if (missing.length === 0) {
     return [{
       severity: "ok",
@@ -16200,6 +16253,26 @@ async function verifyDecisionCoverage(paths, stage, sessionId) {
       message: `Relevant decisions/policies were surfaced for ${changedFiles.length} changed file(s): ${relevant.length}/${relevant.length}.`
     }];
   }
+  if (stage === "pre-commit" || stage === "pre-push") {
+    const cfg = await loadConfig14(paths).catch(() => ({}));
+    if (cfg.enforcement?.autoBrief !== false) {
+      await writeBriefingMarker3(paths, {
+        sessionId,
+        source: "haive-autobrief",
+        task: "decision-coverage auto-surfaced at commit",
+        memoryIds: relevant.map(({ memory: memory2 }) => memory2.frontmatter.id),
+        files: changedFiles
+      }).catch(() => {
+      });
+      return [{
+        severity: "ok",
+        code: "decision-coverage-autosurfaced",
+        message: `Surfaced ${relevant.length} relevant decision/policy memor${relevant.length === 1 ? "y" : "ies"} for ${changedFiles.length} changed file(s) at commit time` + (missing.length > 0 ? ` (${missing.length} not previously briefed \u2014 now recorded)` : "") + ". Set enforcement.autoBrief=false to require a manual briefing first.",
+        memory_ids: relevant.slice(0, 12).map(({ memory: memory2 }) => memory2.frontmatter.id),
+        affected_files: changedFiles.slice(0, 10)
+      }];
+    }
+  }
   return [{
     severity: stage === "local" ? "warn" : "error",
     code: "decision-coverage-missing",
@@ -18079,7 +18152,7 @@ function registerBridges(program2) {
 
 // src/index.ts
 var program = new Command64();
-program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.20.0").option("--advanced", "show maintenance and experimental commands in help");
+program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.21.0").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);