@hiveai/cli 0.9.27 → 0.9.28

package/dist/index.js

@@ -11,6 +11,7 @@ import "commander";
 import {
   extractActionsBriefBody,
   findProjectRoot as findProjectRoot2,
+  isStackPackSeed,
   literalMatchesAllTokens,
   literalMatchesAnyToken,
   loadCodeMap as loadCodeMap3,
@@ -1098,6 +1099,7 @@ function classifyCliPriority(item, filePaths, tokens, exactTaskHit, partialTaskH
   const fm = item.memory.frontmatter;
   const anchored = filePaths.length > 0 && memoryMatchesAnchorPaths(item.memory, filePaths);
   if (anchored || fm.type === "attempt" && exactTaskHit) return "must_read";
+  if (isStackPackSeed(fm)) return "background";
   if (exactTaskHit || partialTaskHit || item.score >= 4 || tokens && fm.tags.some((tag) => tokens.includes(tag))) {
     return "useful";
   }
@@ -2018,7 +2020,8 @@ import path9 from "path";
 import {
   buildFrontmatter,
   memoryFilePath,
-  serializeMemory as serializeMemory2
+  serializeMemory as serializeMemory2,
+  STACK_PACK_TAG
 } from "@hiveai/core";
 var PACKS = {
   nestjs: [
@@ -2593,6 +2596,7 @@ new ApolloServer({
     }
   ]
 };
+var SEED_FOOTER = (stack) => `> _Seeded by \`haive init\` from the **${stack}** stack pack \u2014 generic guidance, not repo-specific. Anchor it to a real file or replace it with a repo-specific note to raise it above background priority._`;
 var SUPPORTED_STACKS = Object.keys(PACKS);
 function isValidStack(name) {
   return name in PACKS;
@@ -2634,11 +2638,15 @@ async function seedStackPack(haivePaths, stack) {
       slug: `${stack}-${mem.slug}`,
       scope: "team",
       status: "validated",
-      tags: mem.tags
+      // 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]
     });
     const filePath = memoryFilePath(haivePaths, "team", fm.id);
     if (existsSync8(filePath)) continue;
-    const content = serializeMemory2({ frontmatter: fm, body: mem.body });
+    const content = serializeMemory2({ frontmatter: fm, body: `${mem.body}
+
+${SEED_FOOTER(stack)}` });
     await mkdir4(path9.dirname(filePath), { recursive: true });
     await writeFile5(filePath, content, "utf8");
     count++;
@@ -2669,30 +2677,25 @@ TODO \u2014 domain terms and what they mean here.
 TODO \u2014 known traps, surprising behavior, things newcomers stub their toes on.
 `;
 var BRIDGE_BODY = `<!-- hAIve bridge file \u2014 do not edit by hand. -->
-<!-- This file points your AI tool at the shared hAIve project context. -->
-
-See \`.ai/project-context.md\` for the full project context.
-Memories live under \`.ai/memories/\` (personal/team/module).
 
-## hAIve \u2014 mandatory rules for AI agents
+This repo uses **hAIve** for shared context. The map:
 
-Installing or initializing hAIve in this repository means **the team expects AI agents to drive work through hAIve**, not bypass it.
+- \`.ai/project-context.md\` \u2014 project overview, architecture, conventions.
+- \`.ai/memories/\` \u2014 decisions, gotchas, conventions, failed attempts (personal/team/module).
+- The breadcrumbs injected below (if any) are the top current memories.
 
-### MCP first (default \u2014 never optional unless the developer says so)
-The **haive** MCP server must be enabled in your client. Until it is unavailable (misconfiguration report to the developer), you **must** use it for substantive work:
+## Working through hAIve
 
-- **Before** you edit project source files, configs (\`package.json\`, tooling), or workflows for the current goal, invoke \`get_briefing\` with a short **task** string (and **files** / **symbols** when you know them). If project context was already refreshed in this session and you only need ranked memories, you may call \`mem_relevant_to\` instead\u2014but **still** consult hAIve before trusting ungrounded guesses.
-- **Before** declaring a coding task finished, invoke the MCP prompt \`post_task\` when the session produced learnings or substantive changes worth capturing.
+1. **Before editing** for a goal, call \`get_briefing\` (task + files/symbols) to load ranked context \u2014 or \`mem_relevant_to\` if project context is already loaded this session.
+2. **When an approach fails**, call \`mem_tried\` right away so the next agent skips the dead end.
+3. **Before closing** a substantive session, run the \`post_task\` prompt to capture what was learned.
 
-Do **not** treat these as nice-to-have: they are **default-required** for coding agents here.
+If the haive MCP server is not available, tell the developer rather than silently skipping it.
 
-### Session rules
-- **Immediately** when an approach fails (wrong API, wrong pattern, wrong assumption), call \`mem_tried\` \u2014 do not wait until the end of the session.
+## Safety
 
-### Safety rules \u2014 NEVER violate these
-- If \`get_briefing\` returns an \`action_required\` list, **stop and show each item to the developer** before doing anything. Use the exact \`developer_message\` provided. Wait for explicit confirmation.
-- **Never modify code autonomously** because of a breaking change detected in another project (dependency version bump, API contract change, removed field). Always ask first.
-- When in doubt about a cross-repo change: ask, don't act.
+- If \`get_briefing\` returns \`action_required\`, surface each item to the developer (use its \`developer_message\`) and wait for confirmation before changing code.
+- Never act autonomously on a cross-repo breaking change (dep bump, contract/API diff) \u2014 ask first.
 `;
 var CURSOR_HAIVE_RULE_MDC = `---
 description: Require hAIve MCP (get_briefing / mem_relevant_to) before substantive repo edits
@@ -2918,7 +2921,10 @@ function registerInit(program2) {
       }
       if (totalSeeded > 0) {
         ui.success(
-          `${totalSeeded} validated team memories pre-seeded \u2014 haive is useful from J+0`
+          `${totalSeeded} starter memories seeded (generic stack guidance, kept at background priority)`
+        );
+        ui.info(
+          "Anchor them to real files or replace them with repo-specific notes to make them high-signal."
         );
       }
     }
@@ -3663,6 +3669,7 @@ import {
   isGlobPath,
   isAutoPromoteEligible,
   isDecaying,
+  isStackPackSeed as isStackPackSeed2,
   literalMatchesAllTokens as literalMatchesAllTokens22,
   literalMatchesAnyToken as literalMatchesAnyToken22,
   loadCodeMap as loadCodeMap4,
@@ -3676,7 +3683,8 @@ import {
   serializeMemory as serializeMemory9,
   tokenizeQuery as tokenizeQuery22,
   trackReads as trackReads3,
-  truncateToTokens
+  truncateToTokens,
+  writeBriefingMarker as writeBriefingMarker2
 } from "@hiveai/core";
 import { z as z17 } from "zod";
 import { estimateTokens as estimateTokens2, loadCodeMap as loadCodeMap22, queryCodeMap as queryCodeMap22 } from "@hiveai/core";
@@ -5427,6 +5435,16 @@ When done, call \`mem_session_end\` to acknowledge \u2014 this clears the pendin
       );
     }
   }
+  if (existsSync18(ctx.paths.haiveDir)) {
+    await writeBriefingMarker2(ctx.paths, {
+      sessionId: process.env.HAIVE_SESSION_ID,
+      ...input.task ? { task: input.task } : {},
+      source: "mcp-get-briefing",
+      files: input.files,
+      memoryIds: outputMemories.map((m) => m.id)
+    }).catch(() => {
+    });
+  }
   return {
     ...input.task ? { task: input.task } : {},
     search_mode: searchMode,
@@ -5481,6 +5499,9 @@ function classifyMemoryPriority(memory2, loaded, inputFiles, inputSymbols) {
   if (fm?.requires_human_approval || directAnchor || directSymbol || memory2.type === "attempt" && (memory2.match_quality === "exact" || strongSemantic) || memory2.type === "skill" && (memory2.match_quality === "exact" || strongSemantic)) {
     return "must_read";
   }
+  if (isStackPackSeed2(fm)) {
+    return "background";
+  }
   if (memory2.type === "skill" || memory2.reasons.includes("module") || memory2.reasons.includes("domain") || memory2.match_quality === "exact" || usefulSemantic) {
     return "useful";
   }
@@ -5963,6 +5984,8 @@ async function antiPatternsCheck(input, ctx) {
       confidence: deriveConfidence6(fm, u),
       body_preview: body.split("\n").slice(0, 5).join("\n").slice(0, 400),
       reasons: [reason],
+      tags: fm.tags ?? [],
+      anchor_paths: fm.anchor?.paths ?? [],
       ...score !== void 0 ? { semantic_score: score } : {}
     });
   };
@@ -6553,8 +6576,45 @@ function fileTypeDowngradeReason(warning, paths) {
   if (configOnly && !warning.reasons.includes("anchor") && !hasStrongSemantic(warning)) {
     return "package/config-only change; warning has no anchor on these files and no strong semantic match \u2014 downgraded to info.";
   }
+  const touchesBuildFile = paths.some(isPackageOrConfigPath);
+  if (!touchesBuildFile && isBuildScopedWarning(warning) && !warning.reasons.includes("anchor") && !hasStrongSemantic(warning)) {
+    return "build/packaging gotcha, but no package/build file changed \u2014 downgraded to info.";
+  }
   return null;
 }
+function isBuildScopedWarning(warning) {
+  const tags = warning.tags ?? [];
+  if (tags.some((t) => BUILD_SCOPED_TAGS.has(t.toLowerCase()))) return true;
+  const anchors = warning.anchor_paths ?? [];
+  return anchors.length > 0 && anchors.every(isPackageOrConfigPath);
+}
+var BUILD_SCOPED_TAGS = /* @__PURE__ */ new Set([
+  "npm",
+  "pnpm",
+  "yarn",
+  "publish",
+  "install",
+  "packaging",
+  "package",
+  "build",
+  "tsup",
+  "bundler",
+  "monorepo",
+  "workspace",
+  "versioning",
+  "version",
+  "dev-workflow",
+  "hotswap",
+  "ci",
+  "workflow",
+  "release",
+  "changelog",
+  "dependencies",
+  "deps",
+  "dependency",
+  "tooling",
+  "config"
+]);
 function hasStrongSemantic(warning) {
   return warning.reasons.includes("semantic") && (warning.semantic_score ?? 0) >= 0.65;
 }
@@ -7130,7 +7190,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.27";
+var SERVER_VERSION = "0.9.28";
 function jsonResult(data) {
   return {
     content: [
@@ -8111,6 +8171,7 @@ import {
   getUsage as getUsage10,
   isAutoPromoteEligible as isAutoPromoteEligible2,
   isDecaying as isDecaying2,
+  isStackPackSeed as isStackPackSeed3,
   loadCodeMap as loadCodeMap5,
   loadConfig as loadConfig4,
   loadMemoriesFromDir as loadMemoriesFromDir23,
@@ -8555,12 +8616,18 @@ Attends une **confirmation explicite** avant d'agir.
     }
   });
 }
+function bridgeSummaryLine(body) {
+  const firstLine = body.split("\n").map((l) => l.replace(/^#+\s*/, "").trim()).find((l) => l.length > 0) ?? "";
+  const oneLine = firstLine.replace(/\s+/g, " ");
+  return oneLine.length > 140 ? oneLine.slice(0, 137) + "\u2026" : oneLine;
+}
 async function injectBridge(bridgeFile, memoriesDir, maxMemories, root, quiet) {
   if (!existsSync29(memoriesDir)) return;
   const all = await loadMemoriesFromDir23(memoriesDir);
   const top = all.filter(({ memory: memory2 }) => {
     const s = memory2.frontmatter.status;
     if (memory2.frontmatter.type === "session_recap") return false;
+    if (isStackPackSeed3(memory2.frontmatter)) return false;
     return s === "validated" || s === "proposed";
   }).sort((a, b) => {
     const score = (m) => {
@@ -8572,11 +8639,11 @@ async function injectBridge(bridgeFile, memoriesDir, maxMemories, root, quiet) {
   const block = top.map((m) => {
     const fm = m.memory.frontmatter;
     const unverified = fm.status === "proposed" ? " [UNVERIFIED]" : "";
-    return `### ${fm.id} (${fm.scope}/${fm.type})${unverified}
-${m.memory.body.trim()}`;
-  }).join("\n\n---\n\n");
+    return `- \`${fm.id}\` (${fm.scope}/${fm.type})${unverified} \u2014 ${bridgeSummaryLine(m.memory.body)}`;
+  }).join("\n");
   const injected = `${BRIDGE_START}
 <!-- AUTO-GENERATED by haive sync --inject-bridge \u2014 do not edit between these markers -->
+<!-- Top memories \u2014 call get_briefing / mem_get for the full body. -->
 
 ` + block + `
 
@@ -12063,14 +12130,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.27"));
+    findings.push(...await collectInstallFindings(root, "0.9.28"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.27";
+      const cliVersion = "0.9.28";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -13042,7 +13109,7 @@ import {
   saveConfig as saveConfig4,
   SESSION_RECAP_TTL_MS,
   verifyAnchor as verifyAnchor4,
-  writeBriefingMarker as writeBriefingMarker2
+  writeBriefingMarker as writeBriefingMarker3
 } from "@hiveai/core";
 var MAX_STDIN_BYTES2 = 256 * 1024;
 var ENFORCE_HOOK_MARKER = "# hAIve enforcement hook";
@@ -13152,7 +13219,7 @@ function registerEnforce(program2) {
       },
       { paths }
     );
-    await writeBriefingMarker2(paths, {
+    await writeBriefingMarker3(paths, {
       sessionId,
       task,
       source: opts.source ?? "claude-session-start",
@@ -13237,7 +13304,7 @@ async function runWithEnforcement(command, args, opts) {
   }
   const sessionId = `haive-run-${process.pid}-${Date.now()}`;
   const task = opts.task ?? `Run agent command: ${[command, ...args].join(" ")}`;
-  await writeBriefingMarker2(paths, {
+  await writeBriefingMarker3(paths, {
     sessionId,
     task,
     source: "haive-run"
@@ -13294,7 +13361,7 @@ async function writeWrapperBriefing(paths, sessionId, task) {
     min_semantic_score: 0.25,
     budget_preset: "quick"
   }, { paths });
-  await writeBriefingMarker2(paths, {
+  await writeBriefingMarker3(paths, {
     sessionId,
     task,
     source: "haive-run",
@@ -13357,7 +13424,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.27"));
+  findings.push(...await inspectIntegrationVersions(root, "0.9.28"));
   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." } : {
@@ -13964,7 +14031,7 @@ function registerRun(program2) {
 
 // src/index.ts
 var program = new Command51();
-program.name("haive").description("hAIve \u2014 the memory and enforcement layer of your agent harness").version("0.9.27").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.9.28").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);