@hiveai/cli 0.2.16 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 
 // src/commands/briefing.ts
 import { existsSync } from "fs";
@@ -11,8 +11,10 @@ import {
   findProjectRoot,
   literalMatchesAllTokens,
   literalMatchesAnyToken,
+  loadCodeMap,
   loadMemoriesFromDir,
   memoryMatchesAnchorPaths,
+  queryCodeMap,
   resolveHaivePaths,
   tokenizeQuery,
   trackReads
@@ -52,7 +54,7 @@ var ui = {
 function registerBriefing(program2) {
   program2.command("briefing").description(
     "Print project context + relevant memories in one shot \u2014 ideal for agent onboarding"
-  ).option("--task <text>", "what you are about to do \u2014 filters memories by relevance").option("--files <csv>", "comma-separated file paths being worked on (anchors memories)").option("--max-memories <n>", "cap on memories surfaced", "10").option(
+  ).option("--task <text>", "what you are about to do \u2014 filters memories by relevance").option("--files <csv>", "comma-separated file paths being worked on (anchors memories)").option("--symbols <csv>", "symbol names to look up in the code-map (e.g. PaymentService,TenantFilter)").option("--max-memories <n>", "cap on memories surfaced", "10").option(
     "--scope <scope>",
     "personal | team | module | all (default: team)",
     "team"
@@ -163,6 +165,34 @@ function registerBriefing(program2) {
       await trackReads(paths, ids).catch(() => {
       });
     }
+    const requestedSymbols = (opts.symbols ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    if (requestedSymbols.length > 0) {
+      const codeMap = await loadCodeMap(paths);
+      if (!codeMap) {
+        ui.warn("No code-map found. Run `haive index code` first to enable symbol lookup.");
+      } else {
+        console.log(`
+${ui.bold("=== Symbol Locations ===")}
+`);
+        for (const sym of requestedSymbols) {
+          const { files } = queryCodeMap(codeMap, { symbol: sym });
+          if (files.length === 0) {
+            console.log(`${ui.dim(sym)}  (not found in code-map)`);
+          } else {
+            for (const f of files) {
+              const exports = f.entry.exports.filter(
+                (e) => e.name.toLowerCase().includes(sym.toLowerCase())
+              );
+              for (const e of exports) {
+                const desc = e.description ? `  \u2014 ${e.description}` : "";
+                console.log(`${ui.bold(e.name)}  ${ui.dim(f.path + ":" + e.line)}  [${e.kind}]${desc}`);
+              }
+            }
+          }
+        }
+        console.log();
+      }
+    }
   });
 }
 function parseCsv(value) {
@@ -183,7 +213,7 @@ function registerTui(program2) {
     const root = findProjectRoot2(opts.dir);
     const { render } = await import("ink");
     const { createElement } = await import("react");
-    const { Dashboard } = await import("./Dashboard-SRPCHP7Z.js");
+    const { Dashboard } = await import("./Dashboard-HVELRRC7.js");
     const { waitUntilExit } = render(createElement(Dashboard, { root }));
     await waitUntilExit();
   });
@@ -2129,17 +2159,124 @@ function registerMemoryImport(memory2) {
   });
 }
 
-// src/commands/session-end.ts
-import { writeFile as writeFile12, mkdir as mkdir6 } from "fs/promises";
+// src/commands/memory-digest.ts
 import { existsSync as existsSync25 } from "fs";
+import { writeFile as writeFile12 } from "fs/promises";
 import path23 from "path";
 import "commander";
 import {
-  buildFrontmatter as buildFrontmatter3,
+  deriveConfidence as deriveConfidence4,
   findProjectRoot as findProjectRoot27,
+  getUsage as getUsage8,
   loadMemoriesFromDir as loadMemoriesFromDir5,
+  loadUsageIndex as loadUsageIndex10,
+  resolveHaivePaths as resolveHaivePaths24
+} from "@hiveai/core";
+var CONFIDENCE_EMOJI = {
+  unverified: "\u2B1C",
+  low: "\u{1F7E1}",
+  trusted: "\u{1F7E2}",
+  authoritative: "\u2B50",
+  stale: "\u{1F534}"
+};
+function registerMemoryDigest(program2) {
+  program2.command("digest").description(
+    "Generate a Markdown review digest of recently added/updated memories (default: last 7 days)"
+  ).option("--days <n>", "look-back window in days", "7").option("--scope <scope>", "personal | team | module | all", "team").option("--out <file>", "write digest to a file instead of stdout").option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot27(opts.dir);
+    const paths = resolveHaivePaths24(root);
+    if (!existsSync25(paths.memoriesDir)) {
+      ui.error("No .ai/memories found. Run `haive init` first.");
+      process.exitCode = 1;
+      return;
+    }
+    const days = Math.max(1, Number(opts.days ?? 7));
+    const scopeFilter = opts.scope ?? "team";
+    const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1e3);
+    const all = await loadMemoriesFromDir5(paths.memoriesDir);
+    const usage = await loadUsageIndex10(paths);
+    const recent = all.filter(({ memory: mem }) => {
+      const fm = mem.frontmatter;
+      if (fm.type === "session_recap") return false;
+      if (fm.status === "rejected" || fm.status === "deprecated") return false;
+      if (scopeFilter !== "all" && fm.scope !== scopeFilter) return false;
+      return new Date(fm.created_at) >= cutoff;
+    });
+    const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const lines = [
+      `# hAIve Memory Digest \u2014 ${now}`,
+      ``,
+      `> **Period:** last ${days} day${days > 1 ? "s" : ""}  |  **Scope:** ${scopeFilter}  |  **Total:** ${recent.length} memor${recent.length === 1 ? "y" : "ies"}`,
+      ``,
+      `---`,
+      ``
+    ];
+    if (recent.length === 0) {
+      lines.push(`_No new memories in the last ${days} days._`);
+    } else {
+      const byType = /* @__PURE__ */ new Map();
+      for (const m of recent) {
+        const t = m.memory.frontmatter.type;
+        if (!byType.has(t)) byType.set(t, []);
+        byType.get(t).push(m);
+      }
+      for (const [type, mems] of byType) {
+        lines.push(`## ${type.charAt(0).toUpperCase() + type.slice(1)} (${mems.length})`);
+        lines.push(``);
+        for (const { memory: mem } of mems) {
+          const fm = mem.frontmatter;
+          const u = getUsage8(usage, fm.id);
+          const confidence = deriveConfidence4(fm, u);
+          const emoji = CONFIDENCE_EMOJI[confidence] ?? "\u2B1C";
+          const anchor = fm.anchor.paths.length > 0 ? `\`${fm.anchor.paths[0]}\`` + (fm.anchor.paths.length > 1 ? ` +${fm.anchor.paths.length - 1}` : "") : "_no anchor_";
+          lines.push(`### ${emoji} \`${fm.id}\``);
+          lines.push(``);
+          lines.push(`| Field | Value |`);
+          lines.push(`|---|---|`);
+          lines.push(`| **Status** | \`${fm.status}\` |`);
+          lines.push(`| **Confidence** | ${confidence} |`);
+          lines.push(`| **Scope** | ${fm.scope}${fm.module ? `/${fm.module}` : ""} |`);
+          lines.push(`| **Tags** | ${fm.tags.length > 0 ? fm.tags.map((t) => `\`${t}\``).join(", ") : "_none_"} |`);
+          lines.push(`| **Anchor** | ${anchor} |`);
+          lines.push(`| **Reads** | ${u.read_count} |`);
+          lines.push(`| **Created** | ${fm.created_at.slice(0, 10)} |`);
+          lines.push(``);
+          const bodyPreview = mem.body.split("\n").slice(0, 6).join("\n").trim();
+          lines.push(bodyPreview);
+          lines.push(``);
+          lines.push(`**Action:** [ ] approve &nbsp;&nbsp; [ ] reject &nbsp;&nbsp; [ ] keep as-is`);
+          lines.push(``);
+          lines.push(`---`);
+          lines.push(``);
+        }
+      }
+    }
+    lines.push(``);
+    lines.push(
+      `> _To take action: \`haive memory approve <id>\`, \`haive memory reject <id>\`, or open \`haive tui\` for interactive review._`
+    );
+    const digest = lines.join("\n");
+    if (opts.out) {
+      const outPath = path23.resolve(process.cwd(), opts.out);
+      await writeFile12(outPath, digest, "utf8");
+      ui.success(`Digest written to ${opts.out}  (${recent.length} memor${recent.length === 1 ? "y" : "ies"})`);
+    } else {
+      console.log(digest);
+    }
+  });
+}
+
+// src/commands/session-end.ts
+import { writeFile as writeFile13, mkdir as mkdir6 } from "fs/promises";
+import { existsSync as existsSync26 } from "fs";
+import path24 from "path";
+import "commander";
+import {
+  buildFrontmatter as buildFrontmatter3,
+  findProjectRoot as findProjectRoot28,
+  loadMemoriesFromDir as loadMemoriesFromDir6,
   memoryFilePath as memoryFilePath4,
-  resolveHaivePaths as resolveHaivePaths24,
+  resolveHaivePaths as resolveHaivePaths25,
   serializeMemory as serializeMemory10
 } from "@hiveai/core";
 function buildRecapBody(opts) {
@@ -2172,9 +2309,9 @@ function recapTopic(scope, module) {
 }
 function registerSessionEnd(session2) {
   session2.command("end").description("Save a structured end-of-session recap (goal / accomplished / discoveries / next steps)").requiredOption("--goal <text>", "What you were trying to accomplish (1\u20132 sentences)").requiredOption("--accomplished <text>", "What was actually done (bullet list recommended)").option("--discoveries <text>", "Bugs, surprises, or inconsistencies found during this session").option("--files <csv>", "Key files touched, comma-separated").option("--next <text>", "What should happen next (for the next session or a teammate)").option("--scope <scope>", "personal | team | module", "personal").option("--module <name>", "module name (required when scope=module)").option("-d, --dir <dir>", "project root").action(async (opts) => {
-    const root = findProjectRoot27(opts.dir);
-    const paths = resolveHaivePaths24(root);
-    if (!existsSync25(paths.haiveDir)) {
+    const root = findProjectRoot28(opts.dir);
+    const paths = resolveHaivePaths25(root);
+    if (!existsSync26(paths.haiveDir)) {
       ui.error(`No .ai/ found at ${root}. Run \`haive init\` first.`);
       process.exitCode = 1;
       return;
@@ -2183,13 +2320,13 @@ function registerSessionEnd(session2) {
     const body = buildRecapBody(opts);
     const topic = recapTopic(scope, opts.module);
     const filesTouched = parseCsv5(opts.files);
-    const missingPaths = filesTouched.filter((p) => !existsSync25(path23.resolve(root, p)));
+    const missingPaths = filesTouched.filter((p) => !existsSync26(path24.resolve(root, p)));
     if (missingPaths.length > 0) {
       ui.warn(`Anchor path${missingPaths.length > 1 ? "s" : ""} not found in project (will be stale):`);
       for (const p of missingPaths) ui.warn(`  \u2717 ${p}`);
     }
-    if (existsSync25(paths.memoriesDir)) {
-      const existing = await loadMemoriesFromDir5(paths.memoriesDir);
+    if (existsSync26(paths.memoriesDir)) {
+      const existing = await loadMemoriesFromDir6(paths.memoriesDir);
       const topicMatch = existing.find(
         ({ memory: memory2 }) => memory2.frontmatter.topic === topic && memory2.frontmatter.scope === scope && (!opts.module || memory2.frontmatter.module === opts.module)
       );
@@ -2204,9 +2341,9 @@ function registerSessionEnd(session2) {
             paths: filesTouched.length ? filesTouched : fm.anchor.paths
           }
         };
-        await writeFile12(topicMatch.filePath, serializeMemory10({ frontmatter: newFrontmatter, body }), "utf8");
+        await writeFile13(topicMatch.filePath, serializeMemory10({ frontmatter: newFrontmatter, body }), "utf8");
         ui.success(`Session recap updated (revision #${revisionCount})`);
-        ui.info(`id=${fm.id}  file=${path23.relative(root, topicMatch.filePath)}`);
+        ui.info(`id=${fm.id}  file=${path24.relative(root, topicMatch.filePath)}`);
         return;
       }
     }
@@ -2221,10 +2358,10 @@ function registerSessionEnd(session2) {
       status: "validated"
     });
     const file = memoryFilePath4(paths, frontmatter.scope, frontmatter.id, frontmatter.module);
-    await mkdir6(path23.dirname(file), { recursive: true });
-    await writeFile12(file, serializeMemory10({ frontmatter, body }), "utf8");
+    await mkdir6(path24.dirname(file), { recursive: true });
+    await writeFile13(file, serializeMemory10({ frontmatter, body }), "utf8");
     ui.success(`Session recap created`);
-    ui.info(`id=${frontmatter.id}  scope=${scope}  file=${path23.relative(root, file)}`);
+    ui.info(`id=${frontmatter.id}  scope=${scope}  file=${path24.relative(root, file)}`);
     ui.info("Next session: call `get_briefing` \u2014 the recap will be surfaced automatically.");
   });
 }
@@ -2234,8 +2371,8 @@ function parseCsv5(value) {
 }
 
 // src/index.ts
-var program = new Command28();
-program.name("haive").description("hAIve \u2014 team-first persistent memory layer for AI coding agents").version("0.2.16");
+var program = new Command29();
+program.name("haive").description("hAIve \u2014 team-first persistent memory layer for AI coding agents").version("0.3.0");
 registerInit(program);
 registerMcp(program);
 registerBriefing(program);
@@ -2263,6 +2400,7 @@ registerMemoryUpdate(memory);
 registerMemoryHot(memory);
 registerMemoryTried(memory);
 registerMemoryImport(memory);
+registerMemoryDigest(memory);
 var session = program.command("session").description("Manage session lifecycle");
 registerSessionEnd(session);
 program.parseAsync(process.argv).catch((err) => {