@hiveai/cli 0.9.19 → 0.9.20

package/dist/index.js

@@ -3294,8 +3294,8 @@ async function memList(input, ctx) {
   return { memories };
 }
 var MemSaveInputSchema = {
-  type: z4.enum(["convention", "decision", "gotcha", "architecture", "glossary", "attempt", "session_recap"]).describe(
-    "Kind of memory being saved. Use 'attempt' for failed approaches (auto-validated). Use 'session_recap' via mem_session_end instead."
+  type: z4.enum(["convention", "decision", "gotcha", "architecture", "glossary", "skill", "attempt", "session_recap"]).describe(
+    "Kind of memory being saved. Use 'skill' for reusable procedures/playbooks agents should follow for recurring tasks (feedforward harness guide). Use 'attempt' for failed approaches (auto-validated). Use 'session_recap' via mem_session_end instead."
   ),
   slug: z4.string().min(1).describe("Short human-readable identifier \u2014 becomes part of the filename"),
   body: z4.string().describe("Markdown body of the memory"),
@@ -4895,10 +4895,10 @@ function classifyMemoryPriority(memory2, loaded, inputFiles, inputSymbols) {
   );
   const strongSemantic = (memory2.semantic_score ?? 0) >= 0.65;
   const usefulSemantic = (memory2.semantic_score ?? 0) >= 0.35;
-  if (fm?.requires_human_approval || directAnchor || directSymbol || memory2.type === "attempt" && (memory2.match_quality === "exact" || strongSemantic)) {
+  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 (memory2.reasons.includes("module") || memory2.reasons.includes("domain") || memory2.match_quality === "exact" || usefulSemantic) {
+  if (memory2.type === "skill" || memory2.reasons.includes("module") || memory2.reasons.includes("domain") || memory2.match_quality === "exact" || usefulSemantic) {
     return "useful";
   }
   return "background";
@@ -4978,6 +4978,7 @@ function explainWhySurfaced(memory2, loaded, inputFiles, inferredModules) {
   }
   why.push(`Confidence: ${memory2.confidence}; read ${memory2.read_count} time${memory2.read_count === 1 ? "" : "s"}.`);
   if (memory2.type === "attempt") why.push("Failed-approach record; read before repeating the same path.");
+  if (memory2.type === "skill") why.push("Skill (reusable procedure/playbook) \u2014 follow the steps described when doing this type of task.");
   if (memory2.status === "proposed" || memory2.status === "draft") {
     why.push("Unvalidated record; use cautiously or ask a human before treating it as policy.");
   }
@@ -6515,7 +6516,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.19";
+var SERVER_VERSION = "0.9.20";
 function jsonResult(data) {
   return {
     content: [
@@ -8496,6 +8497,7 @@ function registerMemoryAdd(memory2) {
     `Save a piece of knowledge as a persistent memory.
 
   Memory types:
+    skill       \u2014 reusable procedure/playbook agents follow for a recurring task (e.g. deploy, review)
     convention  \u2014 how things are done here (naming, patterns, tooling)
     decision    \u2014 a choice made and WHY (tradeoffs, constraints)
     gotcha      \u2014 non-obvious behavior that surprises newcomers
@@ -8515,7 +8517,7 @@ function registerMemoryAdd(memory2) {
     haive memory add --type convention --slug flyway-no-modify --topic flyway \\\\
       --scope team --body "Never modify existing migrations. Create V{n+1}__desc.sql."
 `
-  ).requiredOption("--type <type>", "convention | decision | gotcha | architecture | glossary | attempt").requiredOption("--slug <slug>", "short kebab-case identifier used in the file name").option("--title <text>", "memory title \u2014 becomes the first heading of the body").option("--scope <scope>", "personal | team | module (default: config default; team in autopilot)").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags for easier retrieval").option("--domain <domain>", "domain (e.g. transactions)").option("--author <author>", "author email or handle").option("--paths <csv>", "anchor to source files \u2014 used for staleness detection by haive sync").option("--symbols <csv>", "anchor to specific symbols (class/function names)").option("--commit <sha>", "anchor to a specific commit SHA").option("--body <text>", "memory body content (Markdown) \u2014 overrides --title default body").option("--body-file <path>", "read memory body from a Markdown file \u2014 for long content").option("--no-auto-tag", "disable automatic tag suggestions inferred from anchor paths").option("--topic <key>", "stable key for upsert: if a memory with this topic+scope already exists, update it in-place (revision_count++)").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  ).requiredOption("--type <type>", "skill | convention | decision | gotcha | architecture | glossary | attempt").requiredOption("--slug <slug>", "short kebab-case identifier used in the file name").option("--title <text>", "memory title \u2014 becomes the first heading of the body").option("--scope <scope>", "personal | team | module (default: config default; team in autopilot)").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags for easier retrieval").option("--domain <domain>", "domain (e.g. transactions)").option("--author <author>", "author email or handle").option("--paths <csv>", "anchor to source files \u2014 used for staleness detection by haive sync").option("--symbols <csv>", "anchor to specific symbols (class/function names)").option("--commit <sha>", "anchor to a specific commit SHA").option("--body <text>", "memory body content (Markdown) \u2014 overrides --title default body").option("--body-file <path>", "read memory body from a Markdown file \u2014 for long content").option("--no-auto-tag", "disable automatic tag suggestions inferred from anchor paths").option("--topic <key>", "stable key for upsert: if a memory with this topic+scope already exists, update it in-place (revision_count++)").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot13(opts.dir);
     const paths = resolveHaivePaths10(root);
     if (!existsSync33(paths.haiveDir)) {
@@ -8639,7 +8641,8 @@ TODO \u2014 write the memory body.
     if (inferredTags.length > 0) {
       ui.info(`auto-tagged: ${inferredTags.join(", ")}  (use --no-auto-tag to disable)`);
     }
-    if (anchorPaths.length === 0) {
+    const typeNeedsAnchor = !["skill", "glossary", "session_recap"].includes(opts.type);
+    if (anchorPaths.length === 0 && typeNeedsAnchor) {
       ui.warn(
         `This memory has no anchor paths \u2014 staleness cannot be detected automatically.
   Add file anchors: haive memory update ${frontmatter.id} --paths <file1,file2>`
@@ -11563,7 +11566,7 @@ function registerDoctor(program2) {
         });
       }
       const anchorless = memories.filter(
-        (m) => m.memory.frontmatter.anchor.paths.length === 0 && m.memory.frontmatter.anchor.symbols.length === 0 && m.memory.frontmatter.type !== "session_recap" && m.memory.frontmatter.type !== "glossary"
+        (m) => m.memory.frontmatter.anchor.paths.length === 0 && m.memory.frontmatter.anchor.symbols.length === 0 && m.memory.frontmatter.type !== "session_recap" && m.memory.frontmatter.type !== "glossary" && m.memory.frontmatter.type !== "skill"
       );
       if (anchorless.length / Math.max(memories.length, 1) > 0.3) {
         findings.push({
@@ -11621,6 +11624,7 @@ function registerDoctor(program2) {
         });
       }
     }
+    findings.push(...await collectHarnessCoverageFindings(codeMap, memories));
     findings.push(...await collectSemanticIndexFindings(paths, config, memories.length, codeMap));
     const events = await readUsageEvents4(paths);
     if (events.length === 0) {
@@ -11686,14 +11690,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.19"));
+    findings.push(...await collectInstallFindings(root, "0.9.20"));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
         encoding: "utf8",
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.9.19";
+      const cliVersion = "0.9.20";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -11741,7 +11745,7 @@ function emit(findings, opts, repairs = []) {
   console.log(ui.bold(`hAIve doctor \u2014 ${classified.length} finding${classified.length === 1 ? "" : "s"}`));
   console.log(
     ui.dim(
-      `  protection=${scores.protection_score}  context=${scores.context_quality_score}  corpus=${scores.corpus_quality_score}`
+      `  protection=${scores.protection_score}  context=${scores.context_quality_score}  corpus=${scores.corpus_quality_score}  harness-coverage=${scores.harness_coverage_score}%`
     )
   );
   console.log();
@@ -11750,6 +11754,7 @@ function emit(findings, opts, repairs = []) {
     "Agent coverage",
     "Context quality",
     "Corpus health",
+    "Harness coverage",
     "Index health",
     "Next actions"
   ];
@@ -11787,6 +11792,7 @@ function emit(findings, opts, repairs = []) {
 function sectionForFinding(finding) {
   if (finding.code.includes("haive") || finding.code.includes("integration") || finding.code.includes("claude") || finding.code.includes("autopilot")) return "Agent coverage";
   if (finding.code.includes("context") || finding.code.includes("briefing") || finding.code.includes("search")) return "Context quality";
+  if (finding.code.includes("harness-coverage")) return "Harness coverage";
   if (finding.code.includes("code-map") || finding.code.includes("index")) return "Index health";
   if (finding.code.includes("memory") || finding.code.includes("anchor") || finding.code.includes("pending") || finding.code.includes("decay")) return "Corpus health";
   if (finding.severity === "error") return "Protection";
@@ -11802,10 +11808,13 @@ function computeDoctorScores(findings) {
     }, 0);
     return Math.max(0, 100 - penalty);
   };
+  const coverageFinding = findings.find((f) => f.code === "harness-coverage");
+  const harnessCoverageScore = coverageFinding ? parseInt((coverageFinding.message.match(/\((\d+)%\)/) ?? [])[1] ?? "0", 10) : 0;
   return {
     protection_score: scoreFor(["Protection", "Agent coverage"]),
     context_quality_score: scoreFor(["Context quality", "Index health"]),
-    corpus_quality_score: scoreFor(["Corpus health"])
+    corpus_quality_score: scoreFor(["Corpus health"]),
+    harness_coverage_score: harnessCoverageScore
   };
 }
 function groupBySection(findings) {
@@ -11814,6 +11823,7 @@ function groupBySection(findings) {
     "Agent coverage": [],
     "Context quality": [],
     "Corpus health": [],
+    "Harness coverage": [],
     "Index health": [],
     "Next actions": []
   };
@@ -11823,6 +11833,37 @@ function groupBySection(findings) {
 function nextActions(findings) {
   return [...new Set(findings.flatMap((finding) => finding.fix ? finding.fix.split("\n") : []))].filter(Boolean);
 }
+async function collectHarnessCoverageFindings(codeMap, memories) {
+  if (!codeMap) return [];
+  const codeFiles = Object.keys(codeMap.files);
+  const total = codeFiles.length;
+  if (total === 0) return [];
+  const validatedWithAnchors = memories.filter(
+    (m) => (m.memory.frontmatter.status === "validated" || m.memory.frontmatter.status === "proposed") && m.memory.frontmatter.anchor.paths.length > 0
+  );
+  const coveredFiles = /* @__PURE__ */ new Set();
+  for (const m of validatedWithAnchors) {
+    for (const anchorPath of m.memory.frontmatter.anchor.paths) {
+      const normalized = anchorPath.replace(/^\/+/, "");
+      for (const codeFile of codeFiles) {
+        if (codeFile === normalized || codeFile.startsWith(normalized + "/") || normalized.startsWith(codeFile + "/")) {
+          coveredFiles.add(codeFile);
+        }
+      }
+    }
+  }
+  const covered = coveredFiles.size;
+  const pct = Math.round(covered / total * 100);
+  const findings = [];
+  findings.push({
+    severity: pct < 10 && total > 10 ? "info" : "info",
+    code: "harness-coverage",
+    message: `${covered}/${total} code-map files have validated memory anchors (${pct}%). ` + (pct < 10 && total > 10 ? "Low coverage \u2014 add memory anchors on key modules to improve harness enforcement." : pct < 30 ? "Partial coverage \u2014 consider anchoring critical modules and patterns." : "Good harness coverage."),
+    fix: pct < 10 && total > 10 ? "haive memory add --type gotcha|convention|architecture --paths <key-file> --scope team" : void 0,
+    section: "Harness coverage"
+  });
+  return findings;
+}
 async function collectSemanticIndexFindings(paths, config, memoryCount, codeMap) {
   const findings = [];
   const autoWantsCodeSearch = Boolean(config.autopilot || config.autoRepair?.codeSearch);
@@ -12227,12 +12268,13 @@ import {
   resolveHaivePaths as resolveHaivePaths40
 } from "@hiveai/core";
 var TYPE_RANK = {
-  decision: 0,
-  architecture: 1,
-  convention: 2,
-  glossary: 3,
-  gotcha: 4,
-  attempt: 5
+  skill: 0,
+  decision: 1,
+  architecture: 2,
+  convention: 3,
+  glossary: 4,
+  gotcha: 5,
+  attempt: 6
 };
 function registerWelcome(program2) {
   program2.command("welcome").description(
@@ -12758,7 +12800,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.19"));
+  findings.push(...await inspectIntegrationVersions(root, "0.9.20"));
   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." } : {
@@ -13246,7 +13288,7 @@ function registerRun(program2) {
 
 // src/index.ts
 var program = new Command51();
-program.name("haive").description("hAIve \u2014 policy enforcement layer for AI coding agents").version("0.9.19").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.20").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -13343,7 +13385,7 @@ function applySurfaceVisibility(root) {
     "after",
     [
       "",
-      "Default help shows the core hAIve harness: init, doctor, agent setup, briefing, enforcement,",
+      "Default help shows the core harness workflow: init, doctor, agent setup, briefing, enforcement,",
       "sync, session recaps, and high-signal memory commands.",
       "Run `haive --advanced --help` or set HAIVE_SHOW_ADVANCED=1 to show maintenance and experimental commands."
     ].join("\n")