@hiveai/cli 0.9.31 → 0.10.1

package/dist/index.js

@@ -249,11 +249,13 @@ import "commander";
 import {
   findProjectRoot,
   getUsage,
+  retirementSignal,
   loadCodeMap,
   loadMemoriesFromDir,
   loadUsageIndex,
   resolveHaivePaths,
-  serializeMemory
+  serializeMemory,
+  specificityScore
 } from "@hiveai/core";
 async function lintMemoriesAsync(root, options = {}) {
   const paths = resolveHaivePaths(root);
@@ -271,6 +273,16 @@ async function lintMemoriesAsync(root, options = {}) {
     if (fm.type === "session_recap") continue;
     const body = memory2.body.trim();
     const naked = body.replace(/^#.*$/gm, "").replace(/```[\s\S]*?```/g, "").trim();
+    const retired = retirementSignal(fm, memory2.body);
+    if (retired.retired && fm.status !== "deprecated" && fm.status !== "rejected" && fm.status !== "stale") {
+      out.push({
+        file: filePath,
+        id: fm.id,
+        severity: "warn",
+        code: "RETIRED_ACTIVE_MEMORY",
+        message: `Record is still active but lifecycle metadata says it should be retired (${retired.reason}). Mark it deprecated or remove the fixed/superseded marker if it still applies.`
+      });
+    }
     if (naked.length < 40 && fm.status !== "rejected") {
       out.push({
         file: filePath,
@@ -289,6 +301,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 +956,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) {
-        ui.warn(
-          "project-context.md still contains the default template \u2014 get_briefing will return little value."
-        );
+      const bootstrapUnfilled = /Auto-generated by `haive init/i.test(ctx) && (ctx.match(/TODO —/g)?.length ?? 0) >= 2;
+      if (isTemplate || bootstrapUnfilled) {
         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 +3720,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";
@@ -3736,6 +3756,7 @@ import {
   getUsage as getUsage5,
   inferModulesFromPaths as inferModulesFromPaths2,
   isGlobPath,
+  isRetiredMemory,
   isAutoPromoteEligible,
   isDecaying,
   isStackPackSeed as isStackPackSeed2,
@@ -3750,6 +3771,8 @@ import {
   queryCodeMap as queryCodeMap2,
   resolveBriefingBudget as resolveBriefingBudget2,
   serializeMemory as serializeMemory9,
+  specificityScore as specificityScore2,
+  GUESSABLE_THRESHOLD,
   tokenizeQuery as tokenizeQuery22,
   trackReads as trackReads3,
   truncateToTokens,
@@ -3782,6 +3805,7 @@ import { existsSync as existsSync222 } from "fs";
 import {
   deriveConfidence as deriveConfidence6,
   getUsage as getUsage7,
+  isRetiredMemory as isRetiredMemory2,
   loadMemoriesFromDir as loadMemoriesFromDir17,
   loadUsageIndex as loadUsageIndex9,
   literalMatchesAnyToken as literalMatchesAnyToken3,
@@ -4780,12 +4804,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({
@@ -5117,6 +5154,7 @@ async function getBriefing(input, ctx) {
       const s = memory2.frontmatter.status;
       if (s === "rejected" || s === "deprecated") return false;
       if (!input.include_stale && s === "stale") return false;
+      if (!input.include_stale && isRetiredMemory(memory2.frontmatter, memory2.body)) return false;
       if (memory2.frontmatter.type === "session_recap") return false;
       return true;
     });
@@ -5472,6 +5510,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 +5550,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 +5570,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 +5589,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: {
@@ -6011,6 +6068,9 @@ var AntiPatternsCheckInputSchema = {
   limit: z24.number().int().positive().max(20).default(8).describe("Cap on returned warnings."),
   semantic: z24.boolean().default(true).describe(
     "When true, also use semantic search (requires @hiveai/embeddings + memory index) to find related anti-patterns."
+  ),
+  min_semantic_score: z24.number().min(0).max(1).default(0.45).describe(
+    "Minimum cosine score for semantic-only anti-pattern hits. Anchor/literal matches still surface. Default 0.45 keeps broad, weakly-related memories out of review noise."
   )
 };
 var CODE_STOPWORDS = /* @__PURE__ */ new Set([
@@ -6061,8 +6121,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) {
@@ -6077,11 +6141,12 @@ async function antiPatternsCheck(input, ctx) {
     return { scanned: 0, warnings: [], notice: "No .ai/memories directory \u2014 nothing to check against." };
   }
   const all = await loadMemoriesFromDir17(ctx.paths.memoriesDir);
+  const minSemanticScore = input.min_semantic_score ?? 0.45;
   const negative = all.filter(({ memory: memory2 }) => {
     const t = memory2.frontmatter.type;
     if (t !== "attempt" && t !== "gotcha") return false;
     const s = memory2.frontmatter.status;
-    return s !== "rejected" && s !== "deprecated" && s !== "stale";
+    return s !== "rejected" && s !== "deprecated" && s !== "stale" && !isRetiredMemory2(memory2.frontmatter, memory2.body);
   });
   if (negative.length === 0) {
     return { scanned: 0, warnings: [], notice: "No attempt/gotcha memories found yet." };
@@ -6135,6 +6200,7 @@ async function antiPatternsCheck(input, ctx) {
         const negativeIds = new Set(negative.map(({ memory: memory2 }) => memory2.frontmatter.id));
         for (const hit of result.hits) {
           if (!negativeIds.has(hit.id)) continue;
+          if (hit.score < minSemanticScore && !seen.has(hit.id)) continue;
           const found = negative.find(({ memory: memory2 }) => memory2.frontmatter.id === hit.id);
           if (found) upsert(found.memory.frontmatter, found.memory.body, "semantic", hit.score);
         }
@@ -7323,7 +7389,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.31";
+var SERVER_VERSION = "0.10.1";
 function jsonResult(data) {
   return {
     content: [
@@ -7362,7 +7428,6 @@ var MAINTENANCE_PROFILE_TOOLS = [
   "mem_delete",
   "mem_diff",
   "get_recap",
-  "code_search",
   "anti_patterns_check",
   "mem_distill",
   "mem_timeline",
@@ -12043,6 +12108,8 @@ import "commander";
 import {
   findProjectRoot as findProjectRoot41,
   getUsage as getUsage18,
+  retirementSignal as retirementSignal2,
+  loadConfig as loadConfig10,
   loadMemoriesFromDir as loadMemoriesFromDir31,
   loadUsageIndex as loadUsageIndex24,
   resolveHaivePaths as resolveHaivePaths37,
@@ -12052,7 +12119,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 +12127,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 +12143,23 @@ 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 retired = retirementSignal2(fm, mem.body);
       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 (!retired.retired && !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;
+      if (!retired.retired && Date.parse(lastSeen) >= cutoff) continue;
+      const reason = retired.retired ? `retired lifecycle signal: ${retired.reason ?? "unknown"}` : 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 +12232,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 +12247,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 +12467,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.31"));
+    findings.push(...await collectInstallFindings(root, "0.10.1"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.31";
+      const cliVersion = "0.10.1";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -12984,7 +13056,7 @@ import "commander";
 import {
   antiPatternGateParams,
   findProjectRoot as findProjectRoot44,
-  loadConfig as loadConfig11,
+  loadConfig as loadConfig12,
   resolveHaivePaths as resolveHaivePaths40
 } from "@hiveai/core";
 function registerPrecommit(program2) {
@@ -13000,7 +13072,7 @@ function registerPrecommit(program2) {
     const root = findProjectRoot44(opts.dir);
     const paths = resolveHaivePaths40(root);
     const ctx = { paths };
-    const config = await loadConfig11(paths);
+    const config = await loadConfig12(paths);
     const gate = config.enforcement?.antiPatternGate ?? "anchored";
     const gateParams = antiPatternGateParams(gate);
     const blockOn = opts.blockOn ?? gateParams.block_on;
@@ -13376,7 +13448,7 @@ import {
   findProjectRoot as findProjectRoot49,
   hasRecentBriefingMarker,
   isFreshIsoDate,
-  loadConfig as loadConfig12,
+  loadConfig as loadConfig13,
   loadMemoriesFromDir as loadMemoriesFromDir36,
   memoryMatchesAnchorPaths as memoryMatchesAnchorPaths6,
   readRecentBriefingMarker,
@@ -13397,7 +13469,7 @@ function registerEnforce(program2) {
     const root = findProjectRoot49(opts.dir);
     const paths = resolveHaivePaths45(root);
     await mkdir19(paths.haiveDir, { recursive: true });
-    const current = await loadConfig12(paths);
+    const current = await loadConfig13(paths);
     await saveConfig4(paths, {
       ...current,
       enforcement: {
@@ -13670,7 +13742,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
   const root = findProjectRoot49(dir);
   const paths = resolveHaivePaths45(root);
   const initialized = existsSync68(paths.haiveDir);
-  const config = initialized ? await loadConfig12(paths) : {};
+  const config = initialized ? await loadConfig13(paths) : {};
   if (initialized) await applyLightweightRepairs(root, paths);
   const mode = config.enforcement?.mode ?? "strict";
   const findings = [];
@@ -13700,7 +13772,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.31"));
+  findings.push(...await inspectIntegrationVersions(root, "0.10.1"));
   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." } : {
@@ -14312,7 +14384,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.31").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.1").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -14371,17 +14443,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",