@hiveai/cli 0.9.20 → 0.9.21

package/dist/index.js

@@ -6516,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.20";
+var SERVER_VERSION = "0.9.21";
 function jsonResult(data) {
   return {
     content: [
@@ -8718,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(`
@@ -8883,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";
@@ -8893,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)) {
@@ -8926,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;
@@ -9032,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 {
@@ -9063,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) {
@@ -9289,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)) {
@@ -9342,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)) {
@@ -9352,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)`);
   });
 }
 
@@ -9558,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 {
@@ -9585,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;
@@ -9763,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 {
@@ -9786,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`);
@@ -9815,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 {
@@ -9894,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.");
@@ -10083,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";
@@ -10098,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 = [];
@@ -10443,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";
@@ -10638,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);
@@ -10690,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;
   });
@@ -10997,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";
@@ -11052,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));
@@ -11463,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";
@@ -11516,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({
@@ -11666,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;
@@ -11690,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.20"));
+    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.20";
+      const cliVersion = "0.9.21";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -11960,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) {
@@ -12494,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 {
@@ -12800,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.20"));
+  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." } : {
@@ -13012,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) {
@@ -13125,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 {
@@ -13288,7 +13328,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.20").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);
@@ -13331,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);
@@ -13344,6 +13386,7 @@ registerPrecommit(program);
 var CORE_ROOT_COMMANDS = /* @__PURE__ */ new Set([
   "init",
   "doctor",
+  "tui",
   "agent",
   "enforce",
   "run",