@hivelore/cli 0.44.0 → 0.47.0

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   readPresumedCorrectTargets,
   runAstSensorOnContent,
   runHaiveMcpStdio
-} from "./chunk-6KRXMDLC.js";
+} from "./chunk-HBS7PNNY.js";
 import {
   registerMemoryPending
 } from "./chunk-OYJKHD22.js";
@@ -3758,7 +3758,7 @@ ${SEED_FOOTER(stack)}` });
 
 // src/commands/init.ts
 var execFileAsync = promisify2(execFile2);
-var HAIVE_GITHUB_ACTION_REF = `v${"0.44.0"}`;
+var HAIVE_GITHUB_ACTION_REF = `v${"0.47.0"}`;
 var PROJECT_CONTEXT_TEMPLATE = `# Project context
 
 > Generated by \`hivelore init\`. Run \`hivelore init --bootstrap\` to auto-fill from your codebase,
@@ -7418,7 +7418,10 @@ import { mkdir as mkdir12, writeFile as writeFile18 } from "fs/promises";
 import path30 from "path";
 import {
   aggregateUsage,
+  assessBehaviourCoverage,
   buildPreventionReceipt,
+  loadCodeMap as loadCodeMap6,
+  renderBehaviourCoverageLine,
   renderPreventionReceipt,
   findProjectRoot as findProjectRoot28,
   loadMemoriesFromDir as loadMemoriesFromDir11,
@@ -7447,6 +7450,19 @@ function registerStats(program2) {
     const receipt = buildPreventionReceipt(events, memories, usage, { since });
     const output = sub.share ? renderPreventionReceiptShare(receipt) : opts.json ? JSON.stringify(receipt, null, 2) : renderPreventionReceipt(receipt);
     console.log(output);
+    if (!opts.json && !sub.share) {
+      try {
+        const codeMap = await loadCodeMap6(paths);
+        if (codeMap) {
+          const cov = assessBehaviourCoverage({ memories, codeFiles: Object.keys(codeMap.files) });
+          if (cov.mainAreas.length > 0) {
+            console.log(`
+Behaviour harness: ${renderBehaviourCoverageLine(cov)}.`);
+          }
+        }
+      } catch {
+      }
+    }
   });
   stats.option("--since <window>", "ISO date or relative (e.g. '7d', '24h', '30m')", "30d").option("--json", "emit JSON instead of human-readable output", false).option("--memory-hits", "show top-read memories (which mems are actually being used)", false).option(
     "--export-report <path>",
@@ -8785,6 +8801,8 @@ import "commander";
 import {
   codeMapPath as codeMapPath2,
   assessSensorHealth as assessSensorHealth2,
+  assessBehaviourCoverage as assessBehaviourCoverage2,
+  renderBehaviourCoverageLine as renderBehaviourCoverageLine2,
   sensorPromotedAtMap as sensorPromotedAtMap2,
   countSourceFilesOnDisk,
   extractReferencedPaths,
@@ -8793,7 +8811,7 @@ import {
   findProjectRoot as findProjectRoot35,
   getUsage as getUsage9,
   isStackPackSeed as isStackPackSeed2,
-  loadCodeMap as loadCodeMap6,
+  loadCodeMap as loadCodeMap7,
   loadConfig as loadConfig10,
   loadMemoriesFromDirDetailed,
   loadSensorLedger as loadSensorLedger2,
@@ -9124,7 +9142,7 @@ function registerDoctor(program2) {
     }
     const astSensorCount = sensorMemories.filter((m) => m.memory.frontmatter.sensor?.kind === "ast").length;
     if (astSensorCount > 0) {
-      const { astEngineAvailable: astEngineAvailable2 } = await import("./server-MCNCAFJN.js");
+      const { astEngineAvailable: astEngineAvailable2 } = await import("./server-LNSXYVVW.js");
       if (!await astEngineAvailable2()) {
         findings.push({
           severity: "warn",
@@ -9185,7 +9203,7 @@ function registerDoctor(program2) {
         fix: "Review the sensor manually; no automatic delete/retire command is provided."
       });
     }
-    const codeMap = await loadCodeMap6(paths);
+    const codeMap = await loadCodeMap7(paths);
     if (!codeMap) {
       findings.push({
         severity: "warn",
@@ -9217,6 +9235,7 @@ function registerDoctor(program2) {
       }
     }
     findings.push(...await collectHarnessCoverageFindings(codeMap, memories));
+    findings.push(...collectBehaviourCoverageFindings(codeMap, memories));
     findings.push(...await collectSemanticIndexFindings(paths, config, memories.length, codeMap));
     try {
       const scaffoldGaps = await collectScaffoldLoopGaps(paths);
@@ -9294,8 +9313,8 @@ function registerDoctor(program2) {
         fix: "Edit .ai/haive.config.json: set autoSessionEnd: true (or re-run `hivelore init` without --manual)."
       });
     }
-    findings.push(...await collectInstallFindings(root, "0.44.0"));
-    findings.push(...await collectMcpRuntimeFindings(paths, "0.44.0"));
+    findings.push(...await collectInstallFindings(root, "0.47.0"));
+    findings.push(...await collectMcpRuntimeFindings(paths, "0.47.0"));
     findings.push(...await collectToolchainFindings(root));
     try {
       const legacyRaw = execSync("haive-mcp --version", {
@@ -9303,7 +9322,7 @@ function registerDoctor(program2) {
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.44.0";
+      const cliVersion = "0.47.0";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -9560,6 +9579,32 @@ async function collectHarnessCoverageFindings(codeMap, memories) {
   });
   return findings;
 }
+function collectBehaviourCoverageFindings(codeMap, memories) {
+  if (!codeMap) return [];
+  const codeFiles = Object.keys(codeMap.files);
+  const cov = assessBehaviourCoverage2({ memories, codeFiles });
+  if (cov.mainAreas.length === 0) return [];
+  const uncoveredHint = cov.uncoveredAreas.length > 0 && cov.totalOracles > 0 ? `
+  No behavioural oracle: ${cov.uncoveredAreas.slice(0, 5).map((a) => `\`${a}\``).join(", ")}` + (cov.uncoveredAreas.length > 5 ? `, +${cov.uncoveredAreas.length - 5} more` : "") : "";
+  let fix;
+  if (cov.uncoveredAreas.length > 0) {
+    const lines = cov.uncoveredAreaSuggestions.slice(0, 4).map(
+      (s) => s.candidateLessonId ? `hivelore sensors scaffold ${s.candidateLessonId} --red-ref <pre-fix-commit>   # guard ${s.area}` : `hivelore memory tried --paths ${s.area}/ --what "<incident>" --why-failed "<why>"   # then scaffold --red-ref for ${s.area}`
+    );
+    if (cov.uncoveredAreas.length > 4) lines.push(`# +${cov.uncoveredAreas.length - 4} more uncovered area(s) \u2014 run doctor after guarding these`);
+    fix = lines.join("\n");
+  } else if (cov.armedOracles < cov.totalOracles || cov.redProvenOracles < cov.armedOracles) {
+    fix = "Arm warn-only oracles to `block` and re-propose with `--red-ref` so each substantiates its incident.";
+  }
+  return [{
+    severity: "info",
+    code: "behaviour-coverage",
+    section: "Protection",
+    coverage_percent: Math.round(cov.areasWithOracle.length / cov.mainAreas.length * 100),
+    message: `Behaviour harness: ${renderBehaviourCoverageLine2(cov)}.` + uncoveredHint,
+    fix
+  }];
+}
 async function collectSemanticIndexFindings(paths, config, memoryCount, codeMap) {
   const findings = [];
   const autoWantsCodeSearch = Boolean(config.autopilot || config.autoRepair?.codeSearch);
@@ -10085,7 +10130,7 @@ import {
   detectSensorWeakening,
   isSensorScannablePath,
   findProjectRoot as findProjectRoot37,
-  loadCodeMap as loadCodeMap7,
+  loadCodeMap as loadCodeMap8,
   renderBootstrapChecklist,
   findUncapturedFailures,
   handoffAgeMs,
@@ -11018,7 +11063,7 @@ async function checkBootstrapComplete(paths, config, productionCodeChanged) {
   } catch {
   }
   const memories = existsSync42(paths.memoriesDir) ? await loadMemoriesFromDir15(paths.memoriesDir) : [];
-  const codeMap = await loadCodeMap7(paths);
+  const codeMap = await loadCodeMap8(paths);
   const codeFiles = codeMap ? Object.keys(codeMap.files).filter((file) => existsSync42(path40.join(paths.root, file))) : [];
   let existingModules = [];
   try {
@@ -11083,7 +11128,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "Hivelore enforcement is disabled." }]
     });
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.44.0"));
+  findings.push(...await inspectIntegrationVersions(root, "0.47.0"));
   if (config.enforcement?.requireBriefingFirst !== false && stage !== "ci") {
     const hasBriefing = await hasRecentBriefingMarker(paths, sessionId);
     findings.push(hasBriefing ? { severity: "ok", code: "briefing-loaded", message: "A recent Hivelore briefing marker exists." } : {
@@ -11403,6 +11448,7 @@ async function runPrecommitPolicy(paths, gate, stage, config) {
     } catch {
     }
   }
+  const noticeFinding = result.notice ? [{ severity: "info", code: "precommit-policy-notice", message: result.notice }] : [];
   if (!result.should_block) {
     return [
       {
@@ -11410,6 +11456,7 @@ async function runPrecommitPolicy(paths, gate, stage, config) {
         code: "precommit-policy-pass",
         message: `${stage === "ci" ? "CI" : "Pre-commit"} policy passed for ${touchedPaths.length} changed file(s).`
       },
+      ...noticeFinding,
       ...reviewFinding,
       ...sensorFindings,
       ...weakeningFindings
@@ -11426,6 +11473,7 @@ async function runPrecommitPolicy(paths, gate, stage, config) {
       memory_ids: blockingWarnings.slice(0, 10).map((w) => w.id),
       impact: 45
     },
+    ...noticeFinding,
     ...reviewFinding,
     ...sensorFindings,
     ...weakeningFindings
@@ -12720,6 +12768,7 @@ import {
   addedLineNumbersFromDiff as addedLineNumbersFromDiff2,
   buildProposeCommand,
   scaffoldPostIncidentTest,
+  incidentHintsFromDiff,
   selectCommandSensors as selectCommandSensors2,
   TEST_FRAMEWORKS,
   sensorPatternBrittleness as sensorPatternBrittleness2,
@@ -13051,7 +13100,7 @@ function registerSensors(program2) {
         }
       }
       const root2 = findProjectRoot39(opts.dir);
-      const { proposeSensor } = await import("./server-MCNCAFJN.js");
+      const { proposeSensor } = await import("./server-LNSXYVVW.js");
       const out = await proposeSensor(
         {
           memory_id: id,
@@ -13175,7 +13224,10 @@ function registerSensors(program2) {
   });
   sensors.command("scaffold").description(
     "Generate a PENDING post-incident test from a lesson (mem_tried/attempt/gotcha) \u2014 the on-ramp to\n  a command sensor. Writes a test stub carrying the incident's provenance, then prints the exact\n  `sensors propose --kind test` line to arm it once you've written the assertion. It never arms a\n  sensor itself \u2014 propose_sensor stays the sole validated writer.\n\n  Example:\n    hivelore sensors scaffold 2026-07-03-attempt-refund-exceeds-capture --framework vitest"
-  ).argument("<memory-id>", "lesson id to scaffold a test from").option("--framework <fw>", `test framework: ${TEST_FRAMEWORKS.join(" | ")} (auto-detected when omitted)`).option("--out <path>", "override the generated test file path (project-relative)").option("--stdout", "print the test to stdout instead of writing a file", false).option("--force", "overwrite an existing file at the target path", false).option("-d, --dir <dir>", "project root").action(async (id, opts) => {
+  ).argument("<memory-id>", "lesson id to scaffold a test from").option("--framework <fw>", `test framework: ${TEST_FRAMEWORKS.join(" | ")} (auto-detected when omitted)`).option("--out <path>", "override the generated test file path (project-relative)").option("--stdout", "print the test to stdout instead of writing a file", false).option("--force", "overwrite an existing file at the target path", false).option(
+    "--red-ref <ref>",
+    "pre-fix incident commit/ref: the scaffold names the symbols the fix (<ref>..HEAD) touched and pre-fills the example around them, so the assertion is a targeted edit, not a blank page"
+  ).option("-d, --dir <dir>", "project root").action(async (id, opts) => {
     const root = findProjectRoot39(opts.dir);
     const paths = resolveHaivePaths36(root);
     const loaded = existsSync44(paths.memoriesDir) ? await loadMemoriesFromDir16(paths.memoriesDir) : [];
@@ -13195,13 +13247,28 @@ function registerSensors(program2) {
     const allGroups = await detectTestFrameworksForAnchors(root, fm.anchor.paths ?? []);
     const groups = opts.out ? allGroups.slice(0, 1) : allGroups;
     const fields = parseLessonFields(found.memory.body);
+    let incidentHints;
+    if (opts.redRef) {
+      try {
+        const args = ["diff", `${opts.redRef}`, "HEAD", "--", ...fm.anchor.paths ?? []];
+        const { stdout } = await exec5("git", args, { cwd: root, maxBuffer: 64 * 1024 * 1024 });
+        incidentHints = incidentHintsFromDiff(stdout, { redRef: opts.redRef });
+        if (incidentHints.changedSymbols.length === 0 && incidentHints.changedFiles.length === 0) {
+          ui.warn(`--red-ref ${opts.redRef}: no changed symbols found in the anchor scope \u2014 using the generic template.`);
+          incidentHints = void 0;
+        }
+      } catch (err) {
+        ui.warn(`--red-ref ${opts.redRef}: could not read the fix diff (${err instanceof Error ? err.message : String(err)}) \u2014 using the generic template.`);
+      }
+    }
     const lesson = {
       memoryId: id,
       title: fields.title || id,
       whyFailed: fields.whyFailed,
       instead: fields.instead,
       incident: fm.sensor?.incident,
-      paths: fm.anchor.paths
+      paths: fm.anchor.paths,
+      incidentHints
     };
     let scaffolds = groups.map(
       (g) => scaffoldPostIncidentTest(lesson, { framework: forced ?? g.framework, outPath: opts.out, baseDir: g.baseDir })
@@ -13304,7 +13371,7 @@ async function runnableSensorMemories(paths, regexOnly = true) {
 }
 async function stagedDiff(root) {
   try {
-    const { stdout } = await exec5("git", ["diff", "--cached"], { cwd: root });
+    const { stdout } = await exec5("git", ["diff", "--cached"], { cwd: root, maxBuffer: 256 * 1024 * 1024 });
     return stdout;
   } catch (err) {
     throw new Error(`git diff --cached failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -14082,7 +14149,7 @@ function registerBridges(program2) {
 
 // src/index.ts
 var program = new Command48();
-program.name("hivelore").description("Hivelore - the deterministic policy gate for agent-written code (rules live as repo-native team memory)").version("0.44.0").option("--advanced", "show maintenance and experimental commands in help").showSuggestionAfterError(true);
+program.name("hivelore").description("Hivelore - the deterministic policy gate for agent-written code (rules live as repo-native team memory)").version("0.47.0").option("--advanced", "show maintenance and experimental commands in help").showSuggestionAfterError(true);
 registerInit(program);
 registerResolveProject(program);
 registerEnforce(program);
@@ -14172,7 +14239,7 @@ program.parseAsync(process.argv).catch((err) => {
       console.error(`\x1B[31m\u2717\x1B[0m ${field}${issue.message}`);
     }
   } else {
-    console.error(err instanceof Error ? err.message : err);
+    console.error(err instanceof Error ? process.env.HIVELORE_DEBUG ? err.stack ?? err.message : err.message : err);
   }
   process.exit(1);
 });