@hiveai/cli 0.2.6 → 0.2.8

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 
 // src/commands/briefing.ts
 import { existsSync } from "fs";
@@ -291,9 +291,49 @@ var BRIDGE_BODY = `<!-- hAIve bridge file \u2014 do not edit by hand. -->
 
 See \`.ai/project-context.md\` for the full project context.
 Memories live under \`.ai/memories/\` (personal/team/module).
+
+## hAIve \u2014 mandatory rules for AI agents
+- **Before** marking a task as done ("Done", "Finished", "C'est fait"), call the MCP prompt \`post_task\`.
+- **Immediately** when an approach fails (wrong API, wrong pattern, wrong assumption), call \`mem_tried\` \u2014 do not wait until the end of the session.
+- When starting a new task, call \`get_briefing\` with the task description to load relevant memories and avoid repeating past mistakes.
+`;
+var CI_WORKFLOW = `name: haive-sync
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    paths:
+      - '.ai/**'
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install hAIve CLI
+        run: npm install -g @haive/cli
+
+      - name: Sync memories (verify anchors + auto-promote)
+        run: haive sync --quiet
+
+      - 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
 `;
 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").action(async (opts) => {
+  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) => {
     const root = path3.resolve(opts.dir);
     const paths = resolveHaivePaths4(root);
     if (existsSync3(paths.haiveDir)) {
@@ -312,6 +352,16 @@ function registerInit(program2) {
       await writeBridge(root, ".cursorrules");
       await writeBridge(root, path3.join(".github", "copilot-instructions.md"));
     }
+    if (opts.withCi) {
+      const ciPath = path3.join(root, ".github", "workflows", "haive-sync.yml");
+      if (existsSync3(ciPath)) {
+        ui.info("CI workflow already exists \u2014 skipped");
+      } else {
+        await mkdir(path3.dirname(ciPath), { recursive: true });
+        await writeFile(ciPath, CI_WORKFLOW, "utf8");
+        ui.success(`Created ${path3.relative(root, ciPath)}`);
+      }
+    }
     ui.success(`hAIve initialized at ${root}`);
     ui.info("Next: " + ui.bold("haive memory add --type convention --slug <name>"));
   });
@@ -429,6 +479,7 @@ import {
   findProjectRoot as findProjectRoot8,
   getUsage,
   isAutoPromoteEligible,
+  isDecaying,
   loadMemoriesFromDir as loadMemoriesFromDir2,
   loadUsageIndex,
   resolveHaivePaths as resolveHaivePaths5,
@@ -444,7 +495,7 @@ function registerSync(program2) {
   ).option("--no-verify", "skip the anchor verification step").option("--no-promote", "skip the auto-promotion step").option(
     "--inject-bridge",
     "inject top validated memories into CLAUDE.md (or --bridge-file) between <!-- haive:memories-start/end --> markers"
-  ).option("--bridge-file <path>", "bridge file to inject into (default: CLAUDE.md)").option("--bridge-max-memories <n>", "max memories to inject into bridge file", "5").action(async (opts) => {
+  ).option("--bridge-file <path>", "bridge file to inject into (default: CLAUDE.md)").option("--bridge-max-memories <n>", "max memories to inject into bridge file", "5").option("--embed", "rebuild embeddings index after sync (requires @haive/embeddings)").action(async (opts) => {
     const root = findProjectRoot8(opts.dir);
     const paths = resolveHaivePaths5(root);
     if (!existsSync6(paths.memoriesDir)) {
@@ -555,6 +606,33 @@ function registerSync(program2) {
         for (const f of sinceReport.removed) log(`  - ${f}`);
       }
     }
+    if (!opts.quiet) {
+      const allForDecay = await loadMemoriesFromDir2(paths.memoriesDir);
+      const usageForDecay = await loadUsageIndex(paths);
+      const decaying = allForDecay.filter(({ memory: memory2 }) => {
+        const fm = memory2.frontmatter;
+        if (fm.status === "rejected" || fm.status === "deprecated" || fm.status === "stale") return false;
+        const u = getUsage(usageForDecay, fm.id);
+        return isDecaying(u, fm.created_at);
+      });
+      if (decaying.length > 0) {
+        log(ui.yellow(`
+\u26A0  ${decaying.length} memor${decaying.length === 1 ? "y" : "ies"} not read in >90 days (consider reviewing or deprecating):`));
+        for (const { memory: memory2 } of decaying) {
+          log(ui.dim(`   ${memory2.frontmatter.id}`));
+        }
+      }
+    }
+    if (opts.embed) {
+      try {
+        const emb = await import("@hiveai/embeddings");
+        log(ui.dim("embed: rebuilding index\u2026"));
+        const report = await emb.rebuildIndex(paths);
+        log(ui.dim(`embed: index rebuilt (${report.added} added, ${report.updated} updated, ${report.removed} removed)`));
+      } catch {
+        ui.warn("--embed: @hiveai/embeddings not available or index build failed. Run `haive embeddings index` manually.");
+      }
+    }
   });
 }
 async function injectBridge(bridgeFile, memoriesDir, maxMemories, root, quiet) {
@@ -582,13 +660,26 @@ ${m.memory.body.trim()}`;
 ` + block + `
 
 ${BRIDGE_END}`;
-  let existing = existsSync6(bridgeFile) ? await readFile3(bridgeFile, "utf8") : "";
+  const fileExists = existsSync6(bridgeFile);
+  let existing = fileExists ? await readFile3(bridgeFile, "utf8") : "";
+  existing = existing.replace(/\r\n/g, "\n");
   const startIdx = existing.indexOf(BRIDGE_START);
   const endIdx = existing.indexOf(BRIDGE_END);
+  if (startIdx !== -1 && endIdx === -1) {
+    ui.warn(`${path6.relative(root, bridgeFile)}: found ${BRIDGE_START} without ${BRIDGE_END}. Fix the file manually before running --inject-bridge.`);
+    return;
+  }
+  if (startIdx === -1 && endIdx !== -1) {
+    ui.warn(`${path6.relative(root, bridgeFile)}: found ${BRIDGE_END} without ${BRIDGE_START}. Fix the file manually before running --inject-bridge.`);
+    return;
+  }
   let updated;
   if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
     updated = existing.slice(0, startIdx) + injected + existing.slice(endIdx + BRIDGE_END.length);
   } else {
+    if (!fileExists && !quiet) {
+      ui.info(`Creating ${path6.relative(root, bridgeFile)} with haive memory block.`);
+    }
     updated = existing + (existing.endsWith("\n") ? "" : "\n") + "\n" + injected + "\n";
   }
   await writeFile3(bridgeFile, updated, "utf8");
@@ -618,7 +709,7 @@ function collectSinceChanges(root, ref) {
 }
 
 // src/commands/memory-add.ts
-import { mkdir as mkdir3, writeFile as writeFile4 } from "fs/promises";
+import { mkdir as mkdir3, readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
 import { existsSync as existsSync7 } from "fs";
 import path7 from "path";
 import "commander";
@@ -626,12 +717,13 @@ import {
   buildFrontmatter,
   findProjectRoot as findProjectRoot9,
   inferModulesFromPaths,
+  loadMemoriesFromDir as loadMemoriesFromDir3,
   memoryFilePath,
   resolveHaivePaths as resolveHaivePaths6,
   serializeMemory as serializeMemory2
 } from "@hiveai/core";
 function registerMemoryAdd(memory2) {
-  memory2.command("add").description("Add a new memory (defaults to personal scope)").requiredOption("--type <type>", "convention | decision | gotcha | architecture | glossary | attempt").requiredOption("--slug <slug>", "short 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", "personal").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags").option("--domain <domain>", "domain (e.g. transactions)").option("--author <author>", "author email or handle").option("--paths <csv>", "anchor paths, comma-separated").option("--symbols <csv>", "anchor symbols, comma-separated").option("--commit <sha>", "anchor commit SHA").option("--body <text>", "memory body content (Markdown) \u2014 overrides --title default body").option("--no-auto-tag", "disable automatic tag suggestions inferred from anchor paths").option("-d, --dir <dir>", "project root").action(async (opts) => {
+  memory2.command("add").description("Add a new memory (defaults to personal scope)").requiredOption("--type <type>", "convention | decision | gotcha | architecture | glossary | attempt").requiredOption("--slug <slug>", "short 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", "personal").option("--module <name>", "module name (required when scope=module)").option("--tags <csv>", "comma-separated tags").option("--domain <domain>", "domain (e.g. transactions)").option("--author <author>", "author email or handle").option("--paths <csv>", "anchor paths, comma-separated").option("--symbols <csv>", "anchor symbols, comma-separated").option("--commit <sha>", "anchor 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 alternative to --body for long content").option("--no-auto-tag", "disable automatic tag suggestions inferred from anchor paths").option("-d, --dir <dir>", "project root").action(async (opts) => {
     const root = findProjectRoot9(opts.dir);
     const paths = resolveHaivePaths6(root);
     if (!existsSync7(paths.haiveDir)) {
@@ -658,7 +750,18 @@ function registerMemoryAdd(memory2) {
     });
     const title = opts.title ?? opts.slug;
     let body;
-    if (opts.body !== void 0) {
+    if (opts.bodyFile !== void 0) {
+      if (!existsSync7(opts.bodyFile)) {
+        ui.error(`--body-file not found: ${opts.bodyFile}`);
+        process.exitCode = 1;
+        return;
+      }
+      const fileContent = await readFile4(opts.bodyFile, "utf8");
+      body = opts.title ? `# ${opts.title}
+
+${fileContent.trim()}
+` : fileContent;
+    } else if (opts.body !== void 0) {
       body = opts.title ? `# ${opts.title}
 
 ${opts.body}` : opts.body;
@@ -675,6 +778,18 @@ TODO \u2014 write the memory body.
       process.exitCode = 1;
       return;
     }
+    if (existsSync7(paths.memoriesDir)) {
+      const existing = await loadMemoriesFromDir3(paths.memoriesDir);
+      const slugTokens = opts.slug.toLowerCase().split(/[-_\s]+/).filter(Boolean);
+      const similar = existing.filter(({ memory: memory3 }) => {
+        const id = memory3.frontmatter.id.toLowerCase();
+        return slugTokens.length >= 2 && slugTokens.filter((t) => id.includes(t)).length >= Math.ceil(slugTokens.length * 0.6);
+      });
+      if (similar.length > 0) {
+        ui.warn(`Possible duplicate \u2014 similar memories exist: ${similar.map((m) => m.memory.frontmatter.id).join(", ")}`);
+        ui.warn("Consider updating one of these with `haive memory update` instead.");
+      }
+    }
     await writeFile4(file, serializeMemory2({ frontmatter, body }), "utf8");
     ui.success(`Created ${path7.relative(root, file)}`);
     ui.info(`id=${frontmatter.id}  scope=${frontmatter.scope}  status=${frontmatter.status}`);
@@ -707,7 +822,7 @@ import { findProjectRoot as findProjectRoot10, resolveHaivePaths as resolveHaive
 
 // src/utils/fs.ts
 import {
-  loadMemoriesFromDir as loadMemoriesFromDir3,
+  loadMemoriesFromDir as loadMemoriesFromDir4,
   loadMemory,
   listMarkdownFilesRecursive
 } from "@hiveai/core";
@@ -722,7 +837,7 @@ function registerMemoryList(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const statusFilter = opts.status ? opts.status.split(",").map((s) => s.trim()) : null;
     const filtered = all.filter((m) => {
       if (!matchesFilters(m, opts)) return false;
@@ -803,7 +918,7 @@ function registerMemoryPromote(memory2) {
       process.exitCode = 1;
       return;
     }
-    const teamAndModule = await loadMemoriesFromDir3(paths.memoriesDir);
+    const teamAndModule = await loadMemoriesFromDir4(paths.memoriesDir);
     const alreadyShared = teamAndModule.find(
       (m) => m.memory.frontmatter.id === id && (m.memory.frontmatter.scope === "team" || m.memory.frontmatter.scope === "module")
     );
@@ -817,7 +932,7 @@ function registerMemoryPromote(memory2) {
       }
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.personalDir);
+    const all = await loadMemoriesFromDir4(paths.personalDir);
     const found = all.find((m) => m.memory.frontmatter.id === id);
     if (!found) {
       ui.error(`No personal memory with id "${id}". (Promotion only applies to personal scope.)`);
@@ -861,7 +976,7 @@ function registerMemoryApprove(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     if (opts.all || opts.pending) {
       const candidates = all.filter((m) => {
         const s = m.memory.frontmatter.status;
@@ -932,7 +1047,7 @@ function registerMemoryUpdate(memory2) {
       process.exitCode = 1;
       return;
     }
-    const memories = await loadMemoriesFromDir3(paths.memoriesDir);
+    const memories = await loadMemoriesFromDir4(paths.memoriesDir);
     const loaded = memories.find((m) => m.memory.frontmatter.id === id);
     if (!loaded) {
       ui.error(`No memory with id "${id}".`);
@@ -1028,7 +1143,7 @@ function registerMemoryAutoPromote(memory2) {
       minReads: Number(opts.minReads ?? DEFAULT_AUTO_PROMOTE_RULE2.minReads),
       maxRejections: Number(opts.maxRejections ?? DEFAULT_AUTO_PROMOTE_RULE2.maxRejections)
     };
-    const memories = await loadMemoriesFromDir3(paths.memoriesDir);
+    const memories = await loadMemoriesFromDir4(paths.memoriesDir);
     const usage = await loadUsageIndex2(paths);
     const eligible = memories.filter(
       ({ memory: memory3 }) => isAutoPromoteEligible2(memory3.frontmatter, getUsage2(usage, memory3.frontmatter.id), rule)
@@ -1063,7 +1178,7 @@ function registerMemoryAutoPromote(memory2) {
 // src/commands/memory-edit.ts
 import { spawn as spawn2 } from "child_process";
 import { existsSync as existsSync13 } from "fs";
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile5 } from "fs/promises";
 import path13 from "path";
 import "commander";
 import {
@@ -1080,7 +1195,7 @@ function registerMemoryEdit(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const found = all.find((m) => m.memory.frontmatter.id === id);
     if (!found) {
       ui.error(`No memory with id "${id}".`);
@@ -1094,7 +1209,7 @@ function registerMemoryEdit(memory2) {
       ui.warn(`Editor exited with status ${code}.`);
     }
     try {
-      const fresh = await readFile4(found.filePath, "utf8");
+      const fresh = await readFile5(found.filePath, "utf8");
       parseMemory(fresh);
       ui.success("Memory still parses cleanly.");
     } catch (err) {
@@ -1136,7 +1251,7 @@ function registerMemoryForFiles(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const usage = await loadUsageIndex3(paths);
     const inferred = inferModulesFromPaths2(files);
     const byAnchor = [];
@@ -1208,7 +1323,7 @@ function registerMemoryHot(memory2) {
       return;
     }
     const threshold = Math.max(1, Number(opts.threshold ?? 3));
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const usage = await loadUsageIndex4(paths);
     const candidates = all.filter(({ memory: mem }) => {
       const fm = mem.frontmatter;
@@ -1314,7 +1429,7 @@ function registerMemoryPending(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const usage = await loadUsageIndex5(paths);
     const proposed = all.filter(({ memory: mem }) => {
       if (mem.frontmatter.status !== "proposed") return false;
@@ -1366,8 +1481,12 @@ function registerMemoryQuery(memory2) {
       return;
     }
     const tokens = tokenizeQuery2(text);
+    if (tokens.length === 0) {
+      ui.warn("Empty query \u2014 use `haive memory list` to list all memories.");
+      return;
+    }
     const statusFilter = opts.status ? opts.status.split(",").map((s) => s.trim()) : null;
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const passesFilters = (mem) => {
       const fm = mem.frontmatter;
       if (opts.scope && fm.scope !== opts.scope) return false;
@@ -1428,7 +1547,7 @@ function registerMemoryReject(memory2) {
       process.exitCode = 1;
       return;
     }
-    const memories = await loadMemoriesFromDir3(paths.memoriesDir);
+    const memories = await loadMemoriesFromDir4(paths.memoriesDir);
     const loaded = memories.find((m) => m.memory.frontmatter.id === id);
     if (!loaded) {
       ui.error(`No memory with id "${id}".`);
@@ -1479,7 +1598,7 @@ function registerMemoryRm(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const found = all.find((m) => m.memory.frontmatter.id === id);
     if (!found) {
       ui.error(`No memory with id "${id}".`);
@@ -1511,7 +1630,7 @@ function registerMemoryRm(memory2) {
 
 // src/commands/memory-show.ts
 import { existsSync as existsSync21 } from "fs";
-import { readFile as readFile5 } from "fs/promises";
+import { readFile as readFile6 } from "fs/promises";
 import path20 from "path";
 import "commander";
 import {
@@ -1530,7 +1649,7 @@ function registerMemoryShow(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const found = all.find((m) => m.memory.frontmatter.id === id);
     if (!found) {
       ui.error(`No memory with id "${id}".`);
@@ -1538,7 +1657,7 @@ function registerMemoryShow(memory2) {
       return;
     }
     if (opts.raw) {
-      console.log(await readFile5(found.filePath, "utf8"));
+      console.log(await readFile6(found.filePath, "utf8"));
       return;
     }
     const fm = found.memory.frontmatter;
@@ -1588,7 +1707,7 @@ function registerMemoryStats(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const usage = await loadUsageIndex9(paths);
     const target = opts.id ? all.filter((m) => m.memory.frontmatter.id === opts.id) : all;
     if (target.length === 0) {
@@ -1633,7 +1752,7 @@ function registerMemoryVerify(memory2) {
       process.exitCode = 1;
       return;
     }
-    const all = await loadMemoriesFromDir3(paths.memoriesDir);
+    const all = await loadMemoriesFromDir4(paths.memoriesDir);
     const targets = opts.id ? all.filter((m) => m.memory.frontmatter.id === opts.id) : all;
     if (opts.id && targets.length === 0) {
       ui.error(`No memory with id "${opts.id}".`);
@@ -1642,13 +1761,13 @@ function registerMemoryVerify(memory2) {
     }
     let staleCount = 0;
     let freshCount = 0;
-    let anchorless = 0;
+    const anchorlessIds = [];
     let updated = 0;
     for (const { memory: mem, filePath } of targets) {
       const result = await verifyAnchor2(mem, { projectRoot: root });
       const isAnchored = mem.frontmatter.anchor.paths.length > 0 || mem.frontmatter.anchor.symbols.length > 0;
       if (!isAnchored) {
-        anchorless++;
+        anchorlessIds.push(mem.frontmatter.id);
         continue;
       }
       const rel = path22.relative(root, filePath);
@@ -1657,6 +1776,9 @@ function registerMemoryVerify(memory2) {
         console.log(`${ui.bold("STALE")}  ${mem.frontmatter.id}`);
         console.log(`       ${ui.dim(rel)}`);
         console.log(`       ${result.reason}`);
+        if (result.possibleRenames.length > 0) {
+          console.log(`       ${ui.yellow("Possible renames:")} ${result.possibleRenames.join(", ")}`);
+        }
       } else {
         freshCount++;
         console.log(`${ui.dim("fresh")}  ${mem.frontmatter.id}`);
@@ -1670,10 +1792,19 @@ function registerMemoryVerify(memory2) {
     const summary = [
       `${freshCount} fresh`,
       `${staleCount} stale`,
-      `${anchorless} anchorless (skipped)`
+      `${anchorlessIds.length} anchorless (skipped)`
     ];
     if (opts.update) summary.push(`${updated} updated on disk`);
     ui.info(summary.join(" \xB7 "));
+    if (anchorlessIds.length > 0) {
+      console.log(
+        ui.dim(
+          `Anchorless memories (no paths/symbols \u2014 staleness cannot be detected):
+` + anchorlessIds.map((id) => `  ${id}`).join("\n") + `
+Tip: use \`haive memory update <id> --paths <files>\` to add anchors.`
+        )
+      );
+    }
   });
 }
 function applyVerification(mem, result) {
@@ -1701,9 +1832,60 @@ function applyVerification(mem, result) {
   };
 }
 
+// src/commands/memory-import.ts
+import { readFile as readFile7 } from "fs/promises";
+import { existsSync as existsSync24 } from "fs";
+import "commander";
+import {
+  findProjectRoot as findProjectRoot26,
+  resolveHaivePaths as resolveHaivePaths23
+} from "@hiveai/core";
+function registerMemoryImport(memory2) {
+  memory2.command("import").description(
+    "Parse a Markdown file and suggest memories via the import_docs MCP prompt (prints a ready-to-use prompt invocation)"
+  ).requiredOption("--from <file>", "Markdown/text file to import from").option("--scope <scope>", "personal | team (default: team)", "team").option("-d, --dir <dir>", "project root").action(async (opts) => {
+    const root = findProjectRoot26(opts.dir);
+    const paths = resolveHaivePaths23(root);
+    if (!existsSync24(paths.haiveDir)) {
+      ui.error(`No .ai/ found at ${root}. Run \`haive init\` first.`);
+      process.exitCode = 1;
+      return;
+    }
+    if (!existsSync24(opts.from)) {
+      ui.error(`File not found: ${opts.from}`);
+      process.exitCode = 1;
+      return;
+    }
+    const content = await readFile7(opts.from, "utf8");
+    const scope = opts.scope ?? "team";
+    ui.info(`Preparing import from: ${opts.from}  (scope=${scope})`);
+    ui.info(`Content length: ${content.length} chars`);
+    console.log();
+    console.log(ui.bold("To import via MCP, invoke the `import_docs` prompt with:"));
+    console.log();
+    console.log(
+      ui.dim(
+        JSON.stringify(
+          {
+            content: content.slice(0, 200) + (content.length > 200 ? "\u2026" : ""),
+            source: opts.from,
+            scope
+          },
+          null,
+          2
+        )
+      )
+    );
+    console.log();
+    ui.info(
+      'Or use your AI client to call: import_docs({ content: <file contents>, source: "' + opts.from + '", scope: "' + scope + '" })'
+    );
+  });
+}
+
 // src/index.ts
-var program = new Command26();
-program.name("haive").description("hAIve \u2014 team-first persistent memory layer for AI coding agents").version("0.2.6");
+var program = new Command27();
+program.name("haive").description("hAIve \u2014 team-first persistent memory layer for AI coding agents").version("0.2.8");
 registerInit(program);
 registerMcp(program);
 registerBriefing(program);
@@ -1730,6 +1912,7 @@ registerMemoryApprove(memory);
 registerMemoryUpdate(memory);
 registerMemoryHot(memory);
 registerMemoryTried(memory);
+registerMemoryImport(memory);
 program.parseAsync(process.argv).catch((err) => {
   if (isZodError(err)) {
     for (const issue of err.issues) {