@hiveai/cli 0.2.15 → 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"
@@ -89,13 +91,24 @@ function registerBriefing(program2) {
     }
     if (existsSync(paths.projectContext)) {
       const ctx = await readFile(paths.projectContext, "utf8");
-      console.log(`${ui.bold("=== Project Context ===")}
+      const isTemplate = ctx.includes("TODO \u2014 high-level overview") || ctx.includes("Generated by `haive init`");
+      if (isTemplate) {
+        ui.warn(
+          "project-context.md still contains the default template \u2014 get_briefing will return little value."
+        );
+        ui.warn(
+          "Fix: in your AI client, invoke the MCP prompt bootstrap_project to auto-fill it from your codebase."
+        );
+        console.log();
+      } else {
+        console.log(`${ui.bold("=== Project Context ===")}
 `);
-      console.log(ctx.trim());
-      console.log();
+        console.log(ctx.trim());
+        console.log();
+      }
     } else {
       ui.warn(
-        "No project-context.md found. Run `haive init` and the `bootstrap_project` MCP prompt to set it up."
+        "No project-context.md found. Run `haive init` then invoke the bootstrap_project MCP prompt."
       );
     }
     const candidates = all.filter(({ memory: mem }) => {
@@ -152,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) {
@@ -172,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();
   });
@@ -338,12 +379,15 @@ on:
   push:
     branches: [main, master]
   pull_request:
-    paths:
-      - '.ai/**'
+    branches: [main, master]
 
 jobs:
-  sync:
+  # On push to main/master: sync anchors + auto-promote + commit changes
+  sync-on-merge:
+    if: github.event_name == 'push'
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - uses: actions/checkout@v4
         with:
@@ -353,19 +397,58 @@ jobs:
         with:
           node-version: '20'
 
-      - name: Install hAIve CLI
-        run: npm install -g @haive/cli
+      - name: install haive
+        run: npm install -g @hiveai/cli
 
-      - name: Sync memories (verify anchors + auto-promote)
-        run: haive sync --quiet
+      - name: refresh memory anchors + auto-promote
+        run: haive sync --since HEAD~1 || true
 
-      - name: Commit updated memories (if any)
+      - name: commit updated memories (if any)
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git add .ai/
           git diff --cached --quiet || git commit -m "chore: haive sync [skip ci]"
           git push
+
+  # On pull request: warn if PR touches files that would invalidate memories
+  pr-stale-check:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: install haive
+        run: npm install -g @hiveai/cli
+
+      - name: verify memory anchors touched by this PR
+        id: verify
+        run: |
+          haive memory verify 2>&1 | tee /tmp/haive-verify.txt || true
+          STALE=$(grep -c 'stale' /tmp/haive-verify.txt || echo 0)
+          echo "stale_count=$STALE" >> "$GITHUB_OUTPUT"
+
+      - name: comment on PR if stale memories detected
+        if: steps.verify.outputs.stale_count != '0'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const report = fs.readFileSync('/tmp/haive-verify.txt', 'utf8').trim();
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: \`### haive \u2014 Stale memories detected\\n\\nSome memories anchored to code modified in this PR may be outdated:\\n\\n\\\`\\\`\\\`\\n\${report}\\n\\\`\\\`\\\`\\n\\nRun \\\`haive memory verify --update\\\` locally to refresh them before merging.\`
+            });
 `;
 function registerInit(program2) {
   program2.command("init").description("Initialize a hAIve project (.ai/ structure + bridge files)").option("-d, --dir <dir>", "project root", process.cwd()).option("--no-bridges", "do not generate CLAUDE.md / .cursorrules / copilot-instructions.md").option("--with-ci", "write a GitHub Actions workflow (.github/workflows/haive-sync.yml)").action(async (opts) => {
@@ -813,6 +896,16 @@ function registerMemoryAdd(memory2) {
     const autoTagsEnabled = opts.autoTag !== false;
     const inferredTags = autoTagsEnabled ? inferModulesFromPaths(anchorPaths) : [];
     const mergedTags = Array.from(/* @__PURE__ */ new Set([...userTags, ...inferredTags]));
+    if (anchorPaths.length > 0) {
+      const missing = anchorPaths.filter((p) => !existsSync7(path7.resolve(root, p)));
+      if (missing.length > 0) {
+        ui.warn(`Anchor path${missing.length > 1 ? "s" : ""} not found in project:`);
+        for (const p of missing) ui.warn(`  \u2717 ${p}`);
+        ui.warn(
+          "Memories anchored to non-existent paths will be immediately marked stale by `haive sync`.\n  Verify the paths are relative to the project root and the files/directories exist."
+        );
+      }
+    }
     const title = opts.title ?? opts.slug;
     let body;
     if (opts.bodyFile !== void 0) {
@@ -2066,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) {
@@ -2109,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;
@@ -2120,8 +2320,13 @@ function registerSessionEnd(session2) {
     const body = buildRecapBody(opts);
     const topic = recapTopic(scope, opts.module);
     const filesTouched = parseCsv5(opts.files);
-    if (existsSync25(paths.memoriesDir)) {
-      const existing = await loadMemoriesFromDir5(paths.memoriesDir);
+    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 (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)
       );
@@ -2136,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;
       }
     }
@@ -2153,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.");
   });
 }
@@ -2166,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.15");
+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);
@@ -2195,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) => {