@hiveai/cli 0.9.30 → 0.10.0

package/dist/index.js

@@ -253,7 +253,8 @@ import {
   loadMemoriesFromDir,
   loadUsageIndex,
   resolveHaivePaths,
-  serializeMemory
+  serializeMemory,
+  specificityScore
 } from "@hiveai/core";
 async function lintMemoriesAsync(root, options = {}) {
   const paths = resolveHaivePaths(root);
@@ -289,6 +290,15 @@ async function lintMemoriesAsync(root, options = {}) {
         message: "Record does not contain obvious action/rationale words. Add the concrete rule, why it exists, and what to do instead."
       });
     }
+    if (["decision", "gotcha", "convention", "architecture"].includes(fm.type) && fm.status !== "rejected" && naked.length >= 40 && specificityScore(naked) < 0.2) {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "info",
+        code: "LOW_VALUE_GUESSABLE",
+        message: "Reads like generic best practice a capable model already follows. hAIve's value is UNGUESSABLE team knowledge \u2014 add the concrete, arbitrary specifics (exact names, values, formats, magic numbers) or consider removing it to keep briefings high-signal."
+      });
+    }
     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({
@@ -935,12 +945,10 @@ function registerBriefing(program2) {
     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) {
+      const bootstrapUnfilled = /Auto-generated by `haive init/i.test(ctx) && (ctx.match(/TODO —/g)?.length ?? 0) >= 2;
+      if (isTemplate || bootstrapUnfilled) {
         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."
+          "project-context.md is still auto-generated/unfilled \u2014 skipping it (low value). Fill it in, or invoke the bootstrap_project MCP prompt for real context."
         );
         out("");
       } else {
@@ -3701,6 +3709,7 @@ import { existsSync as existsSync15 } from "fs";
 import path62 from "path";
 import {
   buildFrontmatter as buildFrontmatter3,
+  isLikelyGuessable,
   memoryFilePath as memoryFilePath3,
   serializeMemory as serializeMemory7
 } from "@hiveai/core";
@@ -3750,6 +3759,8 @@ import {
   queryCodeMap as queryCodeMap2,
   resolveBriefingBudget as resolveBriefingBudget2,
   serializeMemory as serializeMemory9,
+  specificityScore as specificityScore2,
+  GUESSABLE_THRESHOLD,
   tokenizeQuery as tokenizeQuery22,
   trackReads as trackReads3,
   truncateToTokens,
@@ -4780,12 +4791,25 @@ var MemObserveInputSchema = {
   scope: z15.enum(["personal", "team", "module"]).default("team").describe("Visibility scope \u2014 defaults to team since discoveries benefit everyone"),
   module: z15.string().optional().describe("Module name (required when scope=module)"),
   tags: z15.array(z15.string()).default([]).describe("Tags for filtering"),
-  author: z15.string().optional().describe("Author handle or email")
+  author: z15.string().optional().describe("Author handle or email"),
+  force: z15.boolean().default(false).describe(
+    "Save even if the observation looks like generic, guessable knowledge. By default, low-specificity observations (things a capable model already knows) are SKIPPED to keep the corpus high-signal \u2014 only unguessable, team-specific discoveries are worth storing."
+  )
 };
 async function memObserve(input, ctx) {
   if (!existsSync15(ctx.paths.haiveDir)) {
     throw new Error(`No .ai/ directory at ${ctx.paths.root}. Run 'haive init' first.`);
   }
+  const signalText = [input.what, input.impact, input.fix ?? ""].join(" ");
+  if (!input.force && isLikelyGuessable(signalText)) {
+    return {
+      id: "",
+      scope: input.scope,
+      file_path: "",
+      skipped: true,
+      reason: "Observation looks like generic, guessable knowledge (low specificity) \u2014 not saved. Capture only arbitrary, team-specific facts (exact names, values, formats). Pass force=true to override."
+    };
+  }
   const slug = input.what.toLowerCase().replace(/[^a-z0-9\s]/g, "").trim().split(/\s+/).slice(0, 6).join("-");
   const anchorPaths = input.where.split(/[,\n]/).map((s) => s.trim()).filter(Boolean);
   const baseFm = buildFrontmatter3({
@@ -5472,6 +5496,14 @@ When done, call \`mem_session_end\` to acknowledge \u2014 this clears the pendin
   const memoriesEmpty = outputMemories.length === 0;
   const hasMemoriesDir = existsSync18(ctx.paths.memoriesDir);
   const isColdStart = isTemplateContext && memoriesEmpty && !lastSession && !autoContextGenerated;
+  const hasUnguessableSignal = outputMemories.some(
+    (m) => (m.priority === "must_read" || m.priority === "useful") && specificityScore2(m.body) >= GUESSABLE_THRESHOLD
+  );
+  const briefingValueLow = !hasUnguessableSignal;
+  const adaptiveConfig = await loadConfig3(ctx.paths);
+  const bootstrapUnfilled = /Auto-generated by `haive init/i.test(projectContextRaw) && (projectContextRaw.match(/TODO —/g)?.length ?? 0) >= 2;
+  const contextIsInferable = isTemplateContext || autoContextGenerated || bootstrapUnfilled;
+  const adaptiveTrim = adaptiveConfig.adaptiveBriefing !== false && briefingValueLow && contextIsInferable;
   const hints = [];
   if (isColdStart) {
     hints.push(
@@ -5504,6 +5536,11 @@ When done, call \`mem_session_end\` to acknowledge \u2014 this clears the pendin
       );
     }
   }
+  if (adaptiveTrim) {
+    hints.push(
+      "No team-specific policy matched these files/task \u2014 nothing here a capable model can't infer. The auto-generated project context was trimmed to keep this briefing near-zero-cost; proceed with normal Read/Grep."
+    );
+  }
   if (existsSync18(ctx.paths.haiveDir)) {
     await writeBriefingMarker2(ctx.paths, {
       sessionId: process.env.HAIVE_SESSION_ID,
@@ -5519,7 +5556,12 @@ 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: projectContextRaw || autoContextGenerated ? {
+    project_context: 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 } : {},
+      ...autoContextGenerated ? { auto_generated: true } : {}
+    } : projectContextRaw || autoContextGenerated ? {
       content: projectSlice.text,
       truncated: projectSlice.truncated,
       ...isTemplateContext && !autoContextGenerated ? { is_template: true } : {},
@@ -5533,6 +5575,7 @@ When done, call \`mem_session_end\` to acknowledge \u2014 this clears the pendin
     decay_warnings: decayWarnings,
     setup_warnings: setupWarnings,
     ...isColdStart ? { low_value: true } : {},
+    briefing_value: briefingValueLow ? "low" : "high",
     ...hints.length > 0 ? { hints } : {},
     estimated_tokens: totalTokens,
     budget: {
@@ -6061,8 +6104,12 @@ var CODE_STOPWORDS = /* @__PURE__ */ new Set([
   "console"
 ]);
 function tokenizeDiffForLiteral(diff) {
-  const wsTokens = tokenizeQuery3(diff);
-  const wordTokens = diff.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 4 && !CODE_STOPWORDS.has(t));
+  const lines = diff.split("\n");
+  const looksLikeDiff = lines.some((l) => /^[+-]/.test(l));
+  const addedOnly = looksLikeDiff ? lines.filter((l) => l.startsWith("+") && !l.startsWith("+++")).join("\n") : diff;
+  const source = addedOnly.trim().length > 0 ? addedOnly : diff;
+  const wsTokens = tokenizeQuery3(source);
+  const wordTokens = source.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 4 && !CODE_STOPWORDS.has(t));
   return [.../* @__PURE__ */ new Set([...wsTokens, ...wordTokens])];
 }
 async function antiPatternsCheck(input, ctx) {
@@ -7323,7 +7370,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.30";
+var SERVER_VERSION = "0.10.0";
 function jsonResult(data) {
   return {
     content: [
@@ -12043,6 +12090,7 @@ import "commander";
 import {
   findProjectRoot as findProjectRoot41,
   getUsage as getUsage18,
+  loadConfig as loadConfig10,
   loadMemoriesFromDir as loadMemoriesFromDir31,
   loadUsageIndex as loadUsageIndex24,
   resolveHaivePaths as resolveHaivePaths37,
@@ -12052,7 +12100,7 @@ var MS_PER_DAY2 = 24 * 60 * 60 * 1e3;
 function registerMemoryArchive(memory2) {
   memory2.command("archive").description(
     "Archive obsolete memories: marks status='deprecated' for memories not read in N days\n  whose anchored paths have all disappeared (or have no anchor at all).\n\n  Defaults to a DRY RUN \u2014 pass --apply to actually rewrite files.\n  Targets `attempt` memories by default since they age the fastest.\n\n  Recover later with `haive memory edit <id>` to set status back to validated."
-  ).option("--since <window>", "minimum age since last read (e.g. '180d', '6m')", "180d").option("--type <type>", "limit to a memory type (default 'attempt'). Pass 'all' to scan all types.", "attempt").option("--apply", "actually rewrite files (default: dry run)", false).option("--json", "emit JSON instead of human-readable output", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
+  ).option("--since <window>", "minimum age since last read (e.g. '180d', '6m'). Default: enforcement.decayAfterDays or 180d").option("--type <type>", "limit to a memory type (default 'attempt'). Pass 'all' to scan all types.", "attempt").option("--unread", "decay by unread-age ALONE (ignore anchor status) \u2014 more aggressive corpus hygiene", false).option("--apply", "actually rewrite files (default: dry run)", false).option("--json", "emit JSON instead of human-readable output", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot41(opts.dir);
     const paths = resolveHaivePaths37(root);
     if (!existsSync60(paths.memoriesDir)) {
@@ -12060,7 +12108,9 @@ function registerMemoryArchive(memory2) {
       process.exitCode = 1;
       return;
     }
-    const minDays = parseDays(opts.since ?? "180d");
+    const config = await loadConfig10(paths);
+    const defaultWindow = config.enforcement?.decayAfterDays ? `${config.enforcement.decayAfterDays}d` : "180d";
+    const minDays = parseDays(opts.since ?? defaultWindow);
     if (minDays === null) {
       ui.error(`Invalid --since value: ${opts.since}. Use formats like '180d', '6m', '1y'.`);
       process.exitCode = 1;
@@ -12074,20 +12124,22 @@ function registerMemoryArchive(memory2) {
     for (const { memory: mem, filePath } of all) {
       const fm = mem.frontmatter;
       if (typeFilter && fm.type !== typeFilter) continue;
+      if (fm.type === "session_recap" || fm.requires_human_approval) continue;
       if (fm.status === "deprecated" || fm.status === "rejected") continue;
       const hasAnyAnchor = fm.anchor.paths.length + fm.anchor.symbols.length > 0;
       const allPathsGone = fm.anchor.paths.length > 0 && fm.anchor.paths.every((p) => !existsSync60(path44.join(paths.root, p)));
       const isAnchorless = !hasAnyAnchor;
-      if (!isAnchorless && !allPathsGone) continue;
+      if (!opts.unread && !isAnchorless && !allPathsGone) continue;
       const u = getUsage18(usage, fm.id);
       const lastSeen = u.last_read_at ?? fm.created_at;
       if (Date.parse(lastSeen) >= cutoff) continue;
+      const reason = isAnchorless ? `anchorless and not read since ${lastSeen.slice(0, 10)}` : allPathsGone ? `all ${fm.anchor.paths.length} anchored path(s) missing and not read since ${lastSeen.slice(0, 10)}` : `not read since ${lastSeen.slice(0, 10)} (unread decay)`;
       candidates.push({
         id: fm.id,
         type: fm.type,
         status: fm.status,
         last_seen: lastSeen,
-        reason: isAnchorless ? `anchorless and not read since ${lastSeen.slice(0, 10)}` : `all ${fm.anchor.paths.length} anchored path(s) missing and not read since ${lastSeen.slice(0, 10)}`,
+        reason,
         filePath
       });
     }
@@ -12160,7 +12212,7 @@ import {
   findProjectRoot as findProjectRoot42,
   getUsage as getUsage19,
   loadCodeMap as loadCodeMap7,
-  loadConfig as loadConfig10,
+  loadConfig as loadConfig11,
   loadMemoriesFromDir as loadMemoriesFromDir33,
   loadUsageIndex as loadUsageIndex25,
   readUsageEvents as readUsageEvents4,
@@ -12175,7 +12227,7 @@ function registerDoctor(program2) {
     const paths = resolveHaivePaths38(root);
     const findings = [];
     const repairs = [];
-    const config = await loadConfig10(paths);
+    const config = await loadConfig11(paths);
     if (!existsSync61(paths.haiveDir)) {
       findings.push({
         severity: "error",
@@ -12395,14 +12447,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.30"));
+    findings.push(...await collectInstallFindings(root, "0.10.0"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.30";
+      const cliVersion = "0.10.0";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -12982,7 +13034,9 @@ function truncate3(text, max) {
 import { spawn as spawn5 } from "child_process";
 import "commander";
 import {
+  antiPatternGateParams,
   findProjectRoot as findProjectRoot44,
+  loadConfig as loadConfig12,
   resolveHaivePaths as resolveHaivePaths40
 } from "@hiveai/core";
 function registerPrecommit(program2) {
@@ -12990,8 +13044,7 @@ function registerPrecommit(program2) {
     "Run a pre-commit safety check: scans `git diff --cached` against known anti-patterns,\n  surfaces conventions/decisions anchored to touched files, and warns about stale anchored memories.\n\n  Wire it into git as: `.git/hooks/pre-commit` running `haive precommit` (exit 1 = block).\n\n  Examples:\n    haive precommit                                # auto-detects staged diff\n    haive precommit --block-on any                 # block on any warning, not just high-confidence\n    haive precommit --paths src/auth.ts src/db.ts  # explicit paths instead of git diff"
   ).option(
     "--block-on <mode>",
-    "'any' | 'high-confidence' (default) | 'never' (report only)",
-    "high-confidence"
+    "'any' | 'high-confidence' | 'never' (report only). Default: derived from enforcement.antiPatternGate."
   ).option("--no-semantic", "disable semantic search in anti-patterns matching").option(
     "--no-anchored-blocks",
     "do not block on anchored, diff-corroborated anti-patterns (only block on very strong semantic matches)"
@@ -12999,6 +13052,11 @@ function registerPrecommit(program2) {
     const root = findProjectRoot44(opts.dir);
     const paths = resolveHaivePaths40(root);
     const ctx = { paths };
+    const config = await loadConfig12(paths);
+    const gate = config.enforcement?.antiPatternGate ?? "anchored";
+    const gateParams = antiPatternGateParams(gate);
+    const blockOn = opts.blockOn ?? gateParams.block_on;
+    const anchoredBlocks = opts.anchoredBlocks === false ? false : gateParams.anchored_blocks;
     let diff = "";
     let touchedPaths = opts.paths ?? [];
     if (touchedPaths.length === 0) {
@@ -13036,8 +13094,8 @@ function registerPrecommit(program2) {
     const result = await preCommitCheck({
       diff: diff || void 0,
       paths: touchedPaths,
-      block_on: opts.blockOn ?? "high-confidence",
-      anchored_blocks: opts.anchoredBlocks !== false,
+      block_on: blockOn,
+      anchored_blocks: anchoredBlocks,
       semantic: opts.noSemantic ? false : true
     }, ctx);
     if (opts.json) {
@@ -13080,7 +13138,7 @@ function registerPrecommit(program2) {
       console.log();
     }
     if (result.should_block) {
-      ui.error(`Blocking commit (block_on=${opts.blockOn ?? "high-confidence"}). Address the warnings above or pass --block-on never to bypass.`);
+      ui.error(`Blocking commit (gate=${gate}, block_on=${blockOn}). Address the warnings above or pass --block-on never to bypass.`);
       process.exit(1);
     }
     if (result.warnings.length === 0 && result.stale_anchors.length === 0) {
@@ -13366,10 +13424,11 @@ import { chmod as chmod2, mkdir as mkdir19, readFile as readFile21, readdir as r
 import path50 from "path";
 import "commander";
 import {
+  antiPatternGateParams as antiPatternGateParams2,
   findProjectRoot as findProjectRoot49,
   hasRecentBriefingMarker,
   isFreshIsoDate,
-  loadConfig as loadConfig11,
+  loadConfig as loadConfig13,
   loadMemoriesFromDir as loadMemoriesFromDir36,
   memoryMatchesAnchorPaths as memoryMatchesAnchorPaths6,
   readRecentBriefingMarker,
@@ -13390,7 +13449,7 @@ function registerEnforce(program2) {
     const root = findProjectRoot49(opts.dir);
     const paths = resolveHaivePaths45(root);
     await mkdir19(paths.haiveDir, { recursive: true });
-    const current = await loadConfig11(paths);
+    const current = await loadConfig13(paths);
     await saveConfig4(paths, {
       ...current,
       enforcement: {
@@ -13663,7 +13722,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
   const root = findProjectRoot49(dir);
   const paths = resolveHaivePaths45(root);
   const initialized = existsSync68(paths.haiveDir);
-  const config = initialized ? await loadConfig11(paths) : {};
+  const config = initialized ? await loadConfig13(paths) : {};
   if (initialized) await applyLightweightRepairs(root, paths);
   const mode = config.enforcement?.mode ?? "strict";
   const findings = [];
@@ -13693,7 +13752,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.30"));
+  findings.push(...await inspectIntegrationVersions(root, "0.10.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 hAIve briefing marker exists." } : {
@@ -13861,11 +13920,12 @@ async function runPrecommitPolicy(paths, gate) {
     return [{ severity: "info", code: "no-staged-changes", message: "No staged changes found for pre-commit policy." }];
   }
   const diff = await runCommand4("git", ["diff", "--cached"], paths.root).catch(() => "");
+  const { block_on, anchored_blocks } = antiPatternGateParams2(gate);
   const result = await preCommitCheck({
     diff,
     paths: touchedPaths,
-    block_on: gate === "strict" ? "any" : "high-confidence",
-    anchored_blocks: gate === "anchored",
+    block_on,
+    anchored_blocks,
     semantic: true
   }, { paths });
   if (!result.should_block) {
@@ -14304,7 +14364,7 @@ function registerRun(program2) {
 
 // src/index.ts
 var program = new Command52();
-program.name("haive").description("hAIve \u2014 the memory and enforcement layer of your agent harness").version("0.9.30").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.10.0").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -14363,17 +14423,14 @@ registerPrecommit(program);
 var CORE_ROOT_COMMANDS = /* @__PURE__ */ new Set([
   "init",
   "doctor",
-  "tui",
   "agent",
+  "briefing",
   "enforce",
   "run",
-  "briefing",
   "sync",
   "mcp",
   "memory",
-  "session",
-  "precommit",
-  "welcome"
+  "session"
 ]);
 var CORE_MEMORY_COMMANDS = /* @__PURE__ */ new Set([
   "add",