@hiveai/cli 0.9.19 → 0.9.21

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.21";
 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>`
@@ -8715,6 +8718,8 @@ function registerMemoryList(memory2) {
       console.log(
         `${ui.bold(fm.id)} ${ui.dim(fm.scope)}/${ui.dim(fm.type)} ${statusBadge}${moduleStr}${tagStr}`
       );
+      const title = mem.body.match(/^#\s+(.+)$/m)?.[1]?.trim();
+      if (title && title !== fm.id) console.log(`  ${title}`);
       console.log(`  ${ui.dim(path17.relative(root, filePath))}`);
     }
     console.log(ui.dim(`
@@ -8880,7 +8885,7 @@ function registerMemoryApprove(memory2) {
 }
 
 // src/commands/memory-update.ts
-import { writeFile as writeFile19 } from "fs/promises";
+import { readFile as readFile11, writeFile as writeFile19 } from "fs/promises";
 import { existsSync as existsSync37 } from "fs";
 import path20 from "path";
 import "commander";
@@ -8890,7 +8895,7 @@ import {
   serializeMemory as serializeMemory16
 } from "@hiveai/core";
 function registerMemoryUpdate(memory2) {
-  memory2.command("update <id>").description("Update body, tags, or anchor of an existing memory (preserves id and usage history)").option("--title <text>", "new title \u2014 replaces the first heading of the body").option("--body <text>", "new Markdown body \u2014 replaces the existing body").option("--tags <csv>", "new tags, comma-separated \u2014 fully replaces existing tags").option("--paths <csv>", "new anchor paths, comma-separated").option("--symbols <csv>", "new anchor symbols, comma-separated").option("--commit <sha>", "new anchor commit SHA").option("--domain <domain>", "new domain label").option("--author <author>", "new author handle or email").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
+  memory2.command("update <id>").description("Update body, tags, or anchor of an existing memory (preserves id and usage history)").option("--type <type>", "change the memory type (convention | decision | gotcha | architecture | glossary | skill | attempt)").option("--title <text>", "new title \u2014 replaces the first heading of the body").option("--body <text>", "new Markdown body \u2014 replaces the existing body").option("--body-file <path>", "read new body from a Markdown file \u2014 for long content").option("--tags <csv>", "new tags, comma-separated \u2014 fully replaces existing tags").option("--paths <csv>", "new anchor paths, comma-separated").option("--symbols <csv>", "new anchor symbols, comma-separated").option("--commit <sha>", "new anchor commit SHA").option("--domain <domain>", "new domain label").option("--author <author>", "new author handle or email").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
     const root = findProjectRoot17(opts.dir);
     const paths = resolveHaivePaths14(root);
     if (!existsSync37(paths.memoriesDir)) {
@@ -8923,19 +8928,34 @@ function registerMemoryUpdate(memory2) {
     const newFrontmatter = {
       ...frontmatter,
       anchor: newAnchor,
+      ...opts.type !== void 0 ? { type: opts.type } : {},
       ...opts.tags !== void 0 ? { tags: parseCsv3(opts.tags) } : {},
       ...opts.domain !== void 0 ? { domain: opts.domain } : {},
       ...opts.author !== void 0 ? { author: opts.author } : {}
     };
+    if (opts.type !== void 0) updated.push("type");
     if (opts.tags !== void 0) updated.push("tags");
     if (opts.domain !== void 0) updated.push("domain");
     if (opts.author !== void 0) updated.push("author");
-    let newBody = opts.body !== void 0 ? opts.body : body;
+    let newBody;
+    if (opts.bodyFile !== void 0) {
+      if (!existsSync37(opts.bodyFile)) {
+        ui.error(`--body-file not found: ${opts.bodyFile}`);
+        process.exitCode = 1;
+        return;
+      }
+      newBody = await readFile11(opts.bodyFile, "utf8");
+      updated.push("body");
+    } else if (opts.body !== void 0) {
+      newBody = opts.body;
+      updated.push("body");
+    } else {
+      newBody = body;
+    }
     if (opts.title !== void 0) {
       newBody = replaceFirstHeading(newBody, opts.title);
       updated.push("title");
     }
-    if (opts.body !== void 0) updated.push("body");
     if (updated.length === 0) {
       ui.warn("Nothing to update \u2014 provide at least one option.");
       return;
@@ -9029,7 +9049,7 @@ function registerMemoryAutoPromote(memory2) {
 // src/commands/memory-edit.ts
 import { spawn as spawn3 } from "child_process";
 import { existsSync as existsSync39 } from "fs";
-import { readFile as readFile11 } from "fs/promises";
+import { readFile as readFile12 } from "fs/promises";
 import path23 from "path";
 import "commander";
 import {
@@ -9060,7 +9080,7 @@ function registerMemoryEdit(memory2) {
       ui.warn(`Editor exited with status ${code}.`);
     }
     try {
-      const fresh = await readFile11(found.filePath, "utf8");
+      const fresh = await readFile12(found.filePath, "utf8");
       parseMemory(fresh);
       ui.success("Memory still parses cleanly.");
     } catch (err) {
@@ -9286,7 +9306,7 @@ function registerMemoryTried(memory2) {
       --instead "use static import in the entry file" \\\\
       --paths packages/cli/src/index.ts
 `
-  ).requiredOption("--what <text>", "what approach was tried (short, descriptive title)").requiredOption("--why-failed <text>", "why it failed or should NOT be used (include the exact error if possible)").option("--instead <text>", "the correct approach to use instead").option("--scope <scope>", "personal | team | module (default: personal)", "personal").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags").option("--paths <csv>", "anchor paths, comma-separated").option("--author <author>", "author email or handle").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  ).requiredOption("--what <text>", "what approach was tried (short, descriptive title)").requiredOption("--why-failed <text>", "why it failed or should NOT be used (include the exact error if possible)").option("--instead <text>", "the correct approach to use instead").option("--scope <scope>", "personal | team | module", "personal").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags").option("--paths <csv>", "anchor paths, comma-separated").option("--author <author>", "author email or handle").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot22(opts.dir);
     const paths = resolveHaivePaths19(root);
     if (!existsSync43(paths.haiveDir)) {
@@ -9339,7 +9359,7 @@ import {
   resolveHaivePaths as resolveHaivePaths20
 } from "@hiveai/core";
 function registerMemoryPending(memory2) {
-  memory2.command("pending").description("List 'proposed' memories awaiting review (sorted by reads desc)").option("--scope <scope>", "filter by scope (personal | team | module)").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  memory2.command("pending").description("List draft and proposed memories awaiting review (sorted by reads desc).\n\n  draft = created but not yet activated \xB7 proposed = promoted, awaiting team validation").option("--scope <scope>", "filter by scope (personal | team | module)").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot23(opts.dir);
     const paths = resolveHaivePaths20(root);
     if (!existsSync44(paths.memoriesDir)) {
@@ -9349,30 +9369,53 @@ function registerMemoryPending(memory2) {
     }
     const all = await loadMemoriesFromDir26(paths.memoriesDir);
     const usage = await loadUsageIndex17(paths);
-    const proposed = all.filter(({ memory: mem }) => {
-      if (mem.frontmatter.status !== "proposed") return false;
+    const filterFn = ({ memory: mem }) => {
+      if (mem.frontmatter.status !== "proposed" && mem.frontmatter.status !== "draft") return false;
       if (opts.scope && mem.frontmatter.scope !== opts.scope) return false;
       return true;
-    });
-    if (proposed.length === 0) {
-      ui.info("No memories awaiting review.");
+    };
+    const pending = all.filter(filterFn);
+    if (pending.length === 0) {
+      ui.info("No draft or proposed memories awaiting review.");
+      ui.info("Drafts are created by `haive memory add` without `--status validated`.");
       return;
     }
-    proposed.sort(
+    pending.sort(
       (a, b) => getUsage15(usage, b.memory.frontmatter.id).read_count - getUsage15(usage, a.memory.frontmatter.id).read_count
     );
     const now = Date.now();
-    for (const { memory: mem, filePath } of proposed) {
-      const fm = mem.frontmatter;
-      const u = getUsage15(usage, fm.id);
-      const ageDays = Math.floor((now - new Date(fm.created_at).getTime()) / 864e5);
-      const ageStr = ageDays === 0 ? "today" : `${ageDays}d`;
-      console.log(
-        `${ui.bold(fm.id)}  ${ui.dim(`${fm.scope}/${fm.type}`)}  ${ui.dim(`age=${ageStr} reads=${u.read_count} rejections=${u.rejected_count}`)}`
-      );
-      console.log(`  ${ui.dim(path27.relative(root, filePath))}`);
+    const drafts = pending.filter((m) => m.memory.frontmatter.status === "draft");
+    const proposed = pending.filter((m) => m.memory.frontmatter.status === "proposed");
+    if (proposed.length > 0) {
+      console.log(ui.bold(`Proposed (${proposed.length}) \u2014 awaiting team validation`));
+      for (const { memory: mem, filePath } of proposed) {
+        const fm = mem.frontmatter;
+        const u = getUsage15(usage, fm.id);
+        const ageDays = Math.floor((now - new Date(fm.created_at).getTime()) / 864e5);
+        const ageStr = ageDays === 0 ? "today" : `${ageDays}d`;
+        console.log(
+          `  ${ui.bold(fm.id)}  ${ui.dim(`${fm.scope}/${fm.type}`)}  ${ui.dim(`age=${ageStr} reads=${u.read_count}`)}`
+        );
+        console.log(`    ${ui.dim(path27.relative(root, filePath))}`);
+      }
+      if (proposed.length > 0) console.log(ui.dim(`  \u2192 haive memory approve <id>  or  haive memory auto-promote`));
+      console.log();
+    }
+    if (drafts.length > 0) {
+      console.log(ui.bold(`Draft (${drafts.length}) \u2014 created but not yet activated`));
+      for (const { memory: mem, filePath } of drafts) {
+        const fm = mem.frontmatter;
+        const u = getUsage15(usage, fm.id);
+        const ageDays = Math.floor((now - new Date(fm.created_at).getTime()) / 864e5);
+        const ageStr = ageDays === 0 ? "today" : `${ageDays}d`;
+        console.log(
+          `  ${ui.bold(fm.id)}  ${ui.dim(`${fm.scope}/${fm.type}`)}  ${ui.dim(`age=${ageStr} reads=${u.read_count}`)}`
+        );
+        console.log(`    ${ui.dim(path27.relative(root, filePath))}`);
+      }
+      console.log(ui.dim(`  \u2192 haive memory approve <id>   (activate)  |  haive memory promote <id>  (share with team)`));
     }
-    ui.info(`${proposed.length} pending`);
+    ui.info(`${pending.length} total pending (${proposed.length} proposed \xB7 ${drafts.length} draft)`);
   });
 }
 
@@ -9555,7 +9598,7 @@ function registerMemoryRm(memory2) {
 
 // src/commands/memory-show.ts
 import { existsSync as existsSync48 } from "fs";
-import { readFile as readFile12 } from "fs/promises";
+import { readFile as readFile13 } from "fs/promises";
 import path30 from "path";
 import "commander";
 import {
@@ -9582,7 +9625,7 @@ function registerMemoryShow(memory2) {
       return;
     }
     if (opts.raw) {
-      console.log(await readFile12(found.filePath, "utf8"));
+      console.log(await readFile13(found.filePath, "utf8"));
       return;
     }
     const fm = found.memory.frontmatter;
@@ -9760,7 +9803,7 @@ function applyVerification2(mem, result) {
 }
 
 // src/commands/memory-import.ts
-import { readFile as readFile13 } from "fs/promises";
+import { readFile as readFile14 } from "fs/promises";
 import { existsSync as existsSync51 } from "fs";
 import "commander";
 import {
@@ -9783,7 +9826,7 @@ function registerMemoryImport(memory2) {
       process.exitCode = 1;
       return;
     }
-    const content = await readFile13(opts.from, "utf8");
+    const content = await readFile14(opts.from, "utf8");
     const scope = opts.scope ?? "team";
     ui.info(`Preparing import from: ${opts.from}  (scope=${scope})`);
     ui.info(`Content length: ${content.length} chars`);
@@ -9812,7 +9855,7 @@ function registerMemoryImport(memory2) {
 
 // src/commands/memory-import-changelog.ts
 import { existsSync as existsSync53 } from "fs";
-import { readFile as readFile14, mkdir as mkdir14, writeFile as writeFile25 } from "fs/promises";
+import { readFile as readFile15, mkdir as mkdir14, writeFile as writeFile25 } from "fs/promises";
 import path34 from "path";
 import "commander";
 import {
@@ -9891,7 +9934,7 @@ function registerMemoryImportChangelog(memory2) {
       process.exitCode = 1;
       return;
     }
-    const content = await readFile14(changelogPath, "utf8");
+    const content = await readFile15(changelogPath, "utf8");
     let entries = parseChangelog(content);
     if (entries.length === 0) {
       ui.warn("No breaking changes, deprecations, or removals found in the CHANGELOG.");
@@ -10080,7 +10123,7 @@ function registerMemoryDigest(program2) {
 }
 
 // src/commands/session-end.ts
-import { writeFile as writeFile27, mkdir as mkdir15, readFile as readFile15, rm as rm2 } from "fs/promises";
+import { writeFile as writeFile27, mkdir as mkdir15, readFile as readFile16, rm as rm2 } from "fs/promises";
 import { existsSync as existsSync55 } from "fs";
 import path36 from "path";
 import "commander";
@@ -10095,7 +10138,7 @@ import {
 async function buildAutoRecap(paths) {
   const obsFile = path36.join(paths.haiveDir, ".cache", "observations.jsonl");
   if (!existsSync55(obsFile)) return null;
-  const raw = await readFile15(obsFile, "utf8").catch(() => "");
+  const raw = await readFile16(obsFile, "utf8").catch(() => "");
   if (!raw.trim()) return null;
   const lines = raw.split("\n").filter(Boolean);
   const obs = [];
@@ -10440,7 +10483,7 @@ function detectFormat(filePath) {
 
 // src/commands/hub.ts
 import { existsSync as existsSync57 } from "fs";
-import { mkdir as mkdir16, readFile as readFile16, writeFile as writeFile28, copyFile } from "fs/promises";
+import { mkdir as mkdir16, readFile as readFile17, writeFile as writeFile28, copyFile } from "fs/promises";
 import path38 from "path";
 import { spawnSync as spawnSync5 } from "child_process";
 import "commander";
@@ -10635,7 +10678,7 @@ Next steps:
       for (const file of sourceFiles) {
         const srcPath = path38.join(sourceDir, file);
         const destPath = path38.join(destDir, file);
-        const fileContent = await readFile16(srcPath, "utf8");
+        const fileContent = await readFile17(srcPath, "utf8");
         const alreadyTagged = fileContent.includes(`cross-repo:${sourceName}`);
         if (!alreadyTagged) {
           await copyFile(srcPath, destPath);
@@ -10687,7 +10730,7 @@ Next steps:
     if (outgoing.length > 0) {
       console.log(ui.dim("  Run `haive hub push` to publish them to the hub."));
     }
-    void readFile16;
+    void readFile17;
     void writeFile28;
     void saveConfig3;
   });
@@ -10994,7 +11037,7 @@ function summarize(name, t0, payload, notes) {
 
 // src/commands/benchmark.ts
 import { existsSync as existsSync59 } from "fs";
-import { readdir as readdir5, readFile as readFile17, writeFile as writeFile30 } from "fs/promises";
+import { readdir as readdir5, readFile as readFile18, writeFile as writeFile30 } from "fs/promises";
 import path40 from "path";
 import "commander";
 import { estimateTokens as estimateTokens4, findProjectRoot as findProjectRoot38 } from "@hiveai/core";
@@ -11049,7 +11092,7 @@ async function collectRows(root) {
     const fixtureDir = path40.join(root, entry.name);
     const reportFile = path40.join(fixtureDir, "BENCHMARK_AGENT_REPORT.md");
     if (!existsSync59(reportFile)) continue;
-    const report = await readFile17(reportFile, "utf8");
+    const report = await readFile18(reportFile, "utf8");
     rows.push(parseAgentReport(entry.name, report));
   }
   return rows.sort((a, b) => a.fixture.localeCompare(b.fixture));
@@ -11460,7 +11503,7 @@ function parseDays(input) {
 
 // src/commands/doctor.ts
 import { existsSync as existsSync63 } from "fs";
-import { readFile as readFile18, stat } from "fs/promises";
+import { readFile as readFile19, stat } from "fs/promises";
 import path44 from "path";
 import { execFileSync, execSync as execSync3 } from "child_process";
 import "commander";
@@ -11513,8 +11556,8 @@ function registerDoctor(program2) {
         fix: "haive init"
       });
     } else {
-      const { readFile: readFile20 } = await import("fs/promises");
-      const content = await readFile20(paths.projectContext, "utf8");
+      const { readFile: readFile21 } = await import("fs/promises");
+      const content = await readFile21(paths.projectContext, "utf8");
       const isTemplate = content.includes("TODO \u2014 high-level overview") || content.includes("Generated by `haive init`");
       if (isTemplate) {
         findings.push({
@@ -11563,7 +11606,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 +11664,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) {
@@ -11662,8 +11706,8 @@ function registerDoctor(program2) {
       let hasClaudeEnforcement = false;
       if (existsSync63(claudeSettings)) {
         try {
-          const { readFile: readFile20 } = await import("fs/promises");
-          const raw = await readFile20(claudeSettings, "utf8");
+          const { readFile: readFile21 } = await import("fs/promises");
+          const raw = await readFile21(claudeSettings, "utf8");
           hasClaudeEnforcement = raw.includes("haive enforce session-start") && raw.includes("haive enforce pre-tool-use");
         } catch {
           hasClaudeEnforcement = false;
@@ -11686,14 +11730,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.21"));
     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.21";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -11741,7 +11785,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 +11794,7 @@ function emit(findings, opts, repairs = []) {
     "Agent coverage",
     "Context quality",
     "Corpus health",
+    "Harness coverage",
     "Index health",
     "Next actions"
   ];
@@ -11787,6 +11832,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 +11848,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 +11863,7 @@ function groupBySection(findings) {
     "Agent coverage": [],
     "Context quality": [],
     "Corpus health": [],
+    "Harness coverage": [],
     "Index health": [],
     "Next actions": []
   };
@@ -11823,6 +11873,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);
@@ -11919,7 +12000,7 @@ which -a haive`
   for (const rel of integrationFiles) {
     const file = path44.join(root, rel);
     if (!existsSync63(file)) continue;
-    const text = await readFile18(file, "utf8").catch(() => "");
+    const text = await readFile19(file, "utf8").catch(() => "");
     for (const bin of extractAbsoluteHaiveBins(text)) {
       const version = versionForBinary(bin);
       if (!version) {
@@ -12227,12 +12308,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(
@@ -12452,7 +12534,7 @@ function registerMemoryConflictCandidates(memory2) {
 // src/commands/enforce.ts
 import { execFileSync as execFileSync2, spawn as spawn5 } from "child_process";
 import { existsSync as existsSync69 } from "fs";
-import { chmod as chmod2, mkdir as mkdir19, readFile as readFile19, rm as rm3, writeFile as writeFile34 } from "fs/promises";
+import { chmod as chmod2, mkdir as mkdir19, readFile as readFile20, rm as rm3, writeFile as writeFile34 } from "fs/promises";
 import path49 from "path";
 import "commander";
 import {
@@ -12758,7 +12840,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.21"));
   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." } : {
@@ -12970,7 +13052,7 @@ async function inspectIntegrationVersions(root, expectedVersion) {
   for (const rel of files) {
     const file = path49.join(root, rel);
     if (!existsSync69(file)) continue;
-    const text = await readFile19(file, "utf8").catch(() => "");
+    const text = await readFile20(file, "utf8").catch(() => "");
     for (const bin of extractAbsoluteHaiveBins2(text)) {
       const version = versionForBinary2(bin);
       if (!version) {
@@ -13083,7 +13165,7 @@ haive enforce check --stage pre-push --dir . || exit $?
   for (const hook of hooks) {
     const file = path49.join(hooksDir, hook.name);
     if (existsSync69(file)) {
-      const current = await readFile19(file, "utf8").catch(() => "");
+      const current = await readFile20(file, "utf8").catch(() => "");
       if (current.includes(ENFORCE_HOOK_MARKER)) {
         await writeFile34(file, hook.body, "utf8");
       } else {
@@ -13246,7 +13328,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.21").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -13289,7 +13371,9 @@ registerMemoryTimeline(memory);
 registerMemoryConflictCandidates(memory);
 registerMemoryArchive(memory);
 registerMemoryLint(memory);
-var session = program.command("session").description("Manage session lifecycle");
+var session = program.command("session").description(
+  "Manage session lifecycle.\n\n  Session start is automatic \u2014 hAIve loads context via `get_briefing` at the start\n  of each agent session (Claude Code SessionStart hook or MCP first call).\n  Use `haive session end` to save a rich end-of-session recap for the next session."
+);
 registerSessionEnd(session);
 registerSnapshot(program);
 registerHub(program);
@@ -13302,6 +13386,7 @@ registerPrecommit(program);
 var CORE_ROOT_COMMANDS = /* @__PURE__ */ new Set([
   "init",
   "doctor",
+  "tui",
   "agent",
   "enforce",
   "run",
@@ -13343,7 +13428,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")