@hiveai/cli 0.13.1 → 0.13.5

package/dist/index.js

@@ -3012,7 +3012,7 @@ ${SEED_FOOTER(stack)}` });
 }
 
 // src/commands/init.ts
-var HAIVE_GITHUB_ACTION_REF = `v${"0.13.1"}`;
+var HAIVE_GITHUB_ACTION_REF = `v${"0.13.5"}`;
 var PROJECT_CONTEXT_TEMPLATE = `# Project context
 
 > Generated by \`haive init\`. Run \`haive init --bootstrap\` to auto-fill from your codebase,
@@ -3749,7 +3749,7 @@ async function installClaudeHooks(opts) {
 }
 function registerInstallHooks(program2) {
   program2.command("install-hooks [target]").description(
-    "Install hAIve hooks. Targets:\n\n    git     (default) post-merge / post-rewrite / pre-push for haive sync + precommit\n    claude  SessionStart + PreToolUse + PostToolUse + SessionEnd hooks\n            for briefing injection, pre-edit blocking, and capture (Claude Code only)\n\n  Examples:\n    haive install-hooks           # git hooks (legacy default)\n    haive install-hooks git\n    haive install-hooks claude\n    haive install-hooks claude --scope project\n    haive install-hooks claude --uninstall\n"
+    "Install hAIve hooks (same effect as `haive enforce install`, kept for back-compat). Targets:\n\n    git     (default) post-merge / post-rewrite / pre-push for haive sync + precommit\n    claude  SessionStart + PreToolUse + PostToolUse + SessionEnd hooks\n            for briefing injection, pre-edit blocking, and capture (Claude Code only)\n\n  Examples:\n    haive install-hooks           # git hooks (legacy default)\n    haive install-hooks git\n    haive install-hooks claude\n    haive install-hooks claude --scope project\n    haive install-hooks claude --uninstall\n"
   ).option("-d, --dir <dir>", "project root").option("--force", "overwrite existing hooks (git target only)").option("--scope <scope>", "claude target: 'user' (~/.claude) or 'project' (.claude/)", "user").option("--uninstall", "remove previously installed hAIve hooks (claude target only)").option("--settings <path>", "explicit path to settings.json (claude target only)").action(async (target, opts) => {
     const t = (target ?? "git").toLowerCase();
     if (t === "git") {
@@ -7912,7 +7912,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
   };
 }
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.13.1";
+var SERVER_VERSION = "0.13.5";
 function jsonResult(data) {
   return {
     content: [
@@ -9308,7 +9308,7 @@ Attends une **confirmation explicite** avant d'agir.
 
 **Prochaines \xE9tapes (si confirm\xE9) :**
 - Rechercher les usages : \`haive memory for-files <fichiers concern\xE9s>\`
-- V\xE9rifier les m\xE9moires li\xE9es : \`haive memory query ${diff.contract}\``;
+- V\xE9rifier les m\xE9moires li\xE9es : \`haive memory search ${diff.contract}\``;
             const fm = buildFrontmatter6({
               type: "gotcha",
               slug,
@@ -9505,8 +9505,8 @@ import {
   suggestSensorFromMemory as suggestSensorFromMemory3
 } from "@hiveai/core";
 function registerMemoryAdd(memory2) {
-  memory2.command("add").description(
-    `Save a piece of knowledge as a persistent memory.
+  memory2.command("save").alias("add").description(
+    `Save a piece of knowledge as a persistent memory. Mirrors MCP mem_save. Alias: add.
 
   Memory types:
     skill       \u2014 reusable procedure/playbook agents follow for a recurring task (e.g. deploy, review)
@@ -10555,7 +10555,7 @@ function registerMemoryPending(memory2) {
     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`.");
+      ui.info("Drafts are created by `haive memory save` without `--status validated`.");
       return;
     }
     pending.sort(
@@ -10612,7 +10612,7 @@ import {
   trackReads as trackReads4
 } from "@hiveai/core";
 function registerMemoryQuery(memory2) {
-  memory2.command("query <text>").alias("search").description("Search memories by id, tag, or substring (AND, OR fallback). Alias: search").option("-d, --dir <dir>", "project root").option("--limit <n>", "max results", "20").option("--scope <scope>", "personal | team | module").option("--status <csv>", "filter by status (draft,proposed,validated,stale,rejected)").option("--show-rejected", "include rejected memories (hidden by default)").action(async (text, opts) => {
+  memory2.command("search <text>").alias("query").description("Search memories by id, tag, or substring (AND, OR fallback). Mirrors MCP mem_search. Alias: query").option("-d, --dir <dir>", "project root").option("--limit <n>", "max results", "20").option("--scope <scope>", "personal | team | module").option("--status <csv>", "filter by status (draft,proposed,validated,stale,rejected)").option("--show-rejected", "include rejected memories (hidden by default)").action(async (text, opts) => {
     const root = findProjectRoot25(opts.dir);
     const paths = resolveHaivePaths22(root);
     if (!existsSync47(paths.memoriesDir)) {
@@ -10736,7 +10736,7 @@ import {
   saveUsageIndex as saveUsageIndex5
 } from "@hiveai/core";
 function registerMemoryRm(memory2) {
-  memory2.command("rm <id>").description("Delete a memory file (and its usage entry by default)").option("-y, --yes", "skip the confirmation prompt").option("--keep-usage", "do not remove the usage.json entry").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
+  memory2.command("delete <id>").alias("rm").description("Delete a memory file (and its usage entry by default). Mirrors MCP mem_delete. Alias: rm").option("-y, --yes", "skip the confirmation prompt").option("--keep-usage", "do not remove the usage.json entry").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
     const root = findProjectRoot27(opts.dir);
     const paths = resolveHaivePaths24(root);
     if (!existsSync49(paths.memoriesDir)) {
@@ -10787,7 +10787,7 @@ import {
   resolveHaivePaths as resolveHaivePaths25
 } from "@hiveai/core";
 function registerMemoryShow(memory2) {
-  memory2.command("show <id>").description("Print a memory's frontmatter, body, and confidence/usage").option("--raw", "print the raw file contents instead of a summary").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
+  memory2.command("get <id>").alias("show").description("Print a memory's frontmatter, body, and confidence/usage. Mirrors MCP mem_get. Alias: show").option("--raw", "print the raw file contents instead of a summary").option("-d, --dir <dir>", "project root").action(async (id, opts) => {
     const root = findProjectRoot28(opts.dir);
     const paths = resolveHaivePaths25(root);
     if (!existsSync50(paths.memoriesDir)) {
@@ -12355,7 +12355,7 @@ async function renderMemoryHits(paths, opts) {
   console.log(ui.bold(`Memory hits (${window})`));
   if (entries.length === 0) {
     ui.info(
-      `No memory reads recorded in window. Reads are logged when \`haive briefing\` or \`haive memory query\` surface a memory.`
+      `No memory reads recorded in window. Reads are logged when \`haive briefing\` or \`haive memory search\` surface a memory.`
     );
     return;
   }
@@ -12388,7 +12388,7 @@ import {
   resolveHaivePaths as resolveHaivePaths37
 } from "@hiveai/core";
 function registerBench(program2) {
-  program2.command("bench").description("Self-test the local hAIve setup: runs core MCP tools against this project and reports latency + payload size.").option("-t, --task <task>", "task description for ranking-aware tools", "audit dependencies for security risks").option("--json", "emit JSON instead of a table", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
+  program2.command("selftest").alias("bench").description("Self-test the LOCAL hAIve install: runs core MCP tools against this project and reports latency + payload size. Different from `benchmark` (which measures hAIve-vs-plain agent value). Alias: bench").option("-t, --task <task>", "task description for ranking-aware tools", "audit dependencies for security risks").option("--json", "emit JSON instead of a table", false).option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot40(opts.dir);
     const paths = resolveHaivePaths37(root);
     const ctx = { paths };
@@ -12515,7 +12515,7 @@ import path41 from "path";
 import "commander";
 import { estimateTokens as estimateTokens4, findProjectRoot as findProjectRoot41 } from "@hiveai/core";
 function registerBenchmark(program2) {
-  const benchmark = program2.command("benchmark").description("Official hAIve benchmark/demo utilities for measuring agent enforcement value.");
+  const benchmark = program2.command("benchmark").description("Measure hAIve's VALUE: paired hAIve-vs-plain agent runs (correctness, tokens, tools). Different from `selftest` (which only checks local install latency).");
   benchmark.command("report").description("Summarize BENCHMARK_AGENT_REPORT.md files from a paired hAIve/plain agent benchmark.").option("-d, --dir <dir>", "benchmark root", "benchmarks/agent-benchmark").option("--out <file>", "write a Markdown report").option("--json", "emit JSON", false).action(async (opts) => {
     const root = resolveBenchmarkRoot(opts.dir);
     const rows = await collectRows(root);
@@ -13344,7 +13344,7 @@ function registerDoctor(program2) {
           severity: "warn",
           code: "stale-draft-memories",
           message: `${oldDrafts.length} draft memor${oldDrafts.length === 1 ? "y has" : "ies have"} been in draft status for 30+ days: ${ids}${more}`,
-          fix: "haive memory approve <id>   # activate\nhaive memory rm <id>         # or delete if obsolete"
+          fix: "haive memory approve <id>   # activate\nhaive memory delete <id>     # or delete if obsolete"
         });
       }
       const policyMemories = memories.filter((m) => !isStackPackSeed4(m.memory.frontmatter));
@@ -13481,7 +13481,7 @@ 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.13.1"));
+    findings.push(...await collectInstallFindings(root, "0.13.5"));
     findings.push(...await collectToolchainFindings(root));
     try {
       const legacyRaw = execSync3("haive-mcp --version", {
@@ -13489,7 +13489,7 @@ function registerDoctor(program2) {
         timeout: 3e3,
         stdio: ["ignore", "pipe", "ignore"]
       }).trim();
-      const cliVersion = "0.13.1";
+      const cliVersion = "0.13.5";
       if (legacyRaw && legacyRaw !== cliVersion) {
         findings.push({
           severity: "warn",
@@ -13705,7 +13705,7 @@ async function collectHarnessCoverageFindings(codeMap, memories) {
     code: "harness-coverage",
     coverage_percent: pct2,
     message: `${covered}/${total} code-map files have validated memory anchors (${pct2}%). ` + coverageDesc + uncoveredHint,
-    fix: pct2 < 50 && total > 10 ? `haive memory add --type gotcha|convention|architecture --paths <key-file> --scope team` : void 0,
+    fix: pct2 < 50 && total > 10 ? `haive memory save --type gotcha|convention|architecture --paths <key-file> --scope team` : void 0,
     section: "Harness coverage"
   });
   return findings;
@@ -14166,7 +14166,7 @@ import {
 } from "@hiveai/core";
 function registerPrecommit(program2) {
   program2.command("precommit").description(
-    "Run a pre-commit safety check: scans `git diff --cached` against known anti-patterns,\n  surfaces conventions/decisions anchored to touched files, and warns about stale anchored memories.\n\n  Wire it into git as: `.git/hooks/pre-commit` running `haive precommit` (exit 1 = block).\n\n  Examples:\n    haive precommit                                # auto-detects staged diff\n    haive precommit --block-on any                 # block on any warning, not just high-confidence\n    haive precommit --paths src/auth.ts src/db.ts  # explicit paths instead of git diff"
+    "Run a pre-commit safety check (manual variant of `haive enforce check --stage pre-commit`):\n  scans `git diff --cached` against known anti-patterns,\n  surfaces conventions/decisions anchored to touched files, and warns about stale anchored memories.\n\n  Wire it into git as: `.git/hooks/pre-commit` running `haive precommit` (exit 1 = block).\n\n  Examples:\n    haive precommit                                # auto-detects staged diff\n    haive precommit --block-on any                 # block on any warning, not just high-confidence\n    haive precommit --paths src/auth.ts src/db.ts  # explicit paths instead of git diff"
   ).option(
     "--block-on <mode>",
     "'any' | 'high-confidence' | 'never' (report only). Default: derived from enforcement.antiPatternGate."
@@ -14356,7 +14356,7 @@ function registerWelcome(program2) {
     console.log(ui.bold(`hAIve welcome \u2014 ${pick.length} team memories (${root})`));
     console.log(ui.dim(`Next: invoke get_briefing with your task or run 'haive briefing --task "\u2026"'`));
     if (pick.length === 0) {
-      ui.warn("No team memories yet \u2014 add some with 'haive memory add' or promote personal ones.");
+      ui.warn("No team memories yet \u2014 add some with 'haive memory save' or promote personal ones.");
       return;
     }
     let i = 1;
@@ -15053,7 +15053,10 @@ async function buildEnforcementReport(dir, stage, sessionId) {
   const paths = resolveHaivePaths48(root);
   const initialized = existsSync75(paths.haiveDir);
   const config = initialized ? await loadConfig13(paths) : {};
-  if (initialized) await applyLightweightRepairs(root, paths);
+  if (initialized) {
+    await applyLightweightRepairs(root, paths);
+    if (stage === "pre-commit") await stageResyncedArtifacts(root, paths);
+  }
   const mode = config.enforcement?.mode ?? "strict";
   const findings = [];
   if (!initialized) {
@@ -15082,7 +15085,7 @@ async function buildEnforcementReport(dir, stage, sessionId) {
       findings: [{ severity: "info", code: "enforcement-off", message: "hAIve enforcement is disabled." }]
     });
   }
-  findings.push(...await inspectIntegrationVersions(root, "0.13.1"));
+  findings.push(...await inspectIntegrationVersions(root, "0.13.5"));
   if (config.enforcement?.requireBriefingFirst !== false && stage !== "ci") {
     const hasBriefing = await hasRecentBriefingMarker2(paths, sessionId);
     findings.push(hasBriefing ? { severity: "ok", code: "briefing-loaded", message: "A recent hAIve briefing marker exists." } : {
@@ -15971,6 +15974,15 @@ async function readStdin2(maxBytes) {
     setTimeout(finish, 2e3);
   });
 }
+async function stageResyncedArtifacts(root, paths) {
+  const rel = path51.relative(root, paths.projectContext);
+  const tracked = await runCommand4("git", ["ls-files", "--error-unmatch", "--", rel], root).then(() => true).catch(() => false);
+  if (!tracked) return;
+  const unchanged = await runCommand4("git", ["diff", "--quiet", "--", rel], root).then(() => true).catch(() => false);
+  if (unchanged) return;
+  await runCommand4("git", ["add", "--", rel], root).catch(() => {
+  });
+}
 function runCommand4(cmd, args, cwd) {
   return new Promise((resolve, reject) => {
     const proc = spawn6(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
@@ -16488,7 +16500,7 @@ function warnNum(n) {
 
 // src/index.ts
 var program = new Command58();
-program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.13.1").option("--advanced", "show maintenance and experimental commands in help");
+program.name("haive").description("hAIve - repo-native memory and context policy for coding-agent harnesses").version("0.13.5").option("--advanced", "show maintenance and experimental commands in help");
 registerInit(program);
 registerWelcome(program);
 registerResolveProject(program);
@@ -16564,14 +16576,14 @@ var CORE_ROOT_COMMANDS = /* @__PURE__ */ new Set([
   "session"
 ]);
 var CORE_MEMORY_COMMANDS = /* @__PURE__ */ new Set([
-  "add",
+  "save",
   "list",
-  "query",
-  "show",
+  "search",
+  "get",
   "verify",
   "lint",
   "tried",
-  "rm"
+  "delete"
 ]);
 var CORE_SESSION_COMMANDS = /* @__PURE__ */ new Set(["end"]);
 applySurfaceVisibility(program);
@@ -16589,12 +16601,24 @@ program.parseAsync(process.argv).catch((err) => {
 function applySurfaceVisibility(root) {
   const showAdvanced = process.argv.includes("--advanced") || process.env.HAIVE_SHOW_ADVANCED === "1";
   if (!showAdvanced) hideNonCoreCommands(root);
+  const familiesBlock = showAdvanced ? [
+    "",
+    "Advanced surface, by family:",
+    "  reports:  dashboard \xB7 stats \xB7 playback        eval:     eval \xB7 benchmark \xB7 selftest (alias: bench)",
+    "  index:    index \xB7 code-search \xB7 embeddings    runtime:  runtime \xB7 observe \xB7 snapshot",
+    "  ops:      memory <sub> \xB7 sensors \xB7 ingest \xB7 hub \xB7 sync \xB7 install-hooks (= enforce install) \xB7 precommit (= enforce check)"
+  ] : [];
   root.addHelpText(
     "after",
     [
       "",
-      "Default help shows the core harness workflow: init, doctor, agent setup, briefing, enforcement,",
-      "sync, session recaps, and high-signal memory commands.",
+      "Golden path (what you type day to day):",
+      "  init \u2192 doctor \u2192 agent setup \u2192 briefing \u2192 memory save/tried \u2192 sensors check \u2192 enforce finish \u2192 sync \u2192 session end",
+      "",
+      "Memory verbs mirror the MCP tools: memory save/search/get/delete <-> mem_save/mem_search/mem_get/mem_delete",
+      "(old verbs add/query/show/rm still work as aliases).",
+      ...familiesBlock,
+      "",
       "Run `haive --advanced --help` or set HAIVE_SHOW_ADVANCED=1 to show maintenance and experimental commands."
     ].join("\n")
   );