caveat-cli 0.5.0 → 0.6.1

package/README.md

@@ -1,6 +1,6 @@
 # caveat-cli
 
-External spec gotcha knowledge base CLI — markdown + SQLite FTS5 + MCP server + Claude Code hooks.
+External spec gotcha knowledge base CLI — markdown + SQLite FTS5 + MCP server + Claude Code hooks, with a shared community knowledge DB out of the box.
 
 **Source / full docs**: https://github.com/kitepon-rgb/Caveat
 
@@ -11,22 +11,48 @@ npm install -g caveat-cli
 caveat init
 ```
 
-`caveat init` creates `~/.caveat/`, registers the MCP server with Claude Code (via `claude mcp add --scope user`), and merges `UserPromptSubmit` / `Stop` hooks into `~/.claude/settings.json`. Existing hook entries are preserved; the settings file is backed up before any write. Run `caveat init --dry-run` to preview, or `caveat init --skip-claude` to skip Claude Code wiring.
+`caveat init` (idempotent, `--dry-run` supported) does 4 things:
+
+1. Scaffolds `~/.caveat/own/` (your personal knowledge repo) + `~/.caveat/index/caveat.db`
+2. **Subscribes you to the shared community DB** (`kitepon-rgb/Caveat` by default) — shallow-clones into `~/.caveat/community/Caveat/` and indexes so other users' caveats are immediately searchable
+3. Registers the MCP server with Claude Code (`claude mcp add --scope user`)
+4. Merges `UserPromptSubmit` / `Stop` hooks into `~/.claude/settings.json` (existing entries preserved, backup written before any change)
+
+Opt-out flags: `--skip-claude`, `--skip-shared`. `caveat uninstall` reverses the Claude Code changes without touching `~/.caveat/`.
 
 ## Basic usage
 
 ```sh
-caveat search "rtx"         # FTS against your knowledge repo
+caveat search "rtx"         # FTS across your own entries + the shared community DB
 caveat list                 # recent entries
+caveat pull                 # fetch new community contributions + re-index
+caveat push <entry-id>      # contribute your entry via fork + PR (requires gh CLI)
 caveat serve                # http://localhost:4242 read-only portal
-caveat community add <url>  # shallow-clone another user's caveats repo
+caveat community add <url>  # subscribe to an additional community repo
 caveat uninstall            # reverse `caveat init` Claude integration
 ```
 
+## MCP tools (7)
+
+Exposed to Claude Code via the MCP server that `caveat init` registers:
+
+`caveat_search`, `caveat_get`, `caveat_record`, `caveat_update`, `caveat_list_recent`, `caveat_pull`, `caveat_push`.
+
+Claude can autonomously pull community updates (safe, idempotent) and push your recorded caveats (gated by Claude Code's tool permission prompt for user consent — contribution is a public action).
+
+## Pointing at a different shared DB
+
+For an internal/enterprise shared knowledge pool, override in `~/.caveatrc.json`:
+
+```json
+{ "sharedRepo": "https://github.com/your-org/your-caveats" }
+```
+
 ## Requirements
 
 - Node 22.5+ (for built-in `node:sqlite`)
-- Optional: Claude Code installed for MCP / hooks integration. Without it, `caveat init --skip-claude` still provisions the local knowledge repo + index.
+- `gh` CLI authenticated (`gh auth login`) if you want to use `caveat push`
+- Claude Code installed if you want MCP / hooks integration. Without it, `caveat init --skip-claude` still provisions local state + shared DB
 
 ## License
 

package/dist/index.js

@@ -15948,8 +15948,7 @@ function recordEntry(input, opts) {
     source_session: generateSourceSession(now),
     created_at: ymd,
     updated_at: ymd,
-    last_verified: ymd,
-    ...input.brief_id !== void 0 ? { brief_id: input.brief_id } : {}
+    last_verified: ymd
   };
   const sections = {};
   if (input.context !== void 0) sections["Context"] = input.context;
@@ -15996,8 +15995,7 @@ var IMMUTABLE_KEYS = /* @__PURE__ */ new Set([
   "id",
   "created_at",
   "source_session",
-  "source_project",
-  "brief_id"
+  "source_project"
 ]);
 function updateEntry(id, patch, opts) {
   const source = opts.source ?? "own";
@@ -16035,9 +16033,6 @@ function updateEntry(id, patch, opts) {
   if (patch.frontmatter?.tags !== void 0) {
     mergedFrontmatter.tags = patch.frontmatter.tags;
   }
-  if (parsed.frontmatter.brief_id !== void 0) {
-    mergedFrontmatter.brief_id = parsed.frontmatter.brief_id;
-  }
   const mergedSections = { ...parsed.sections };
   if (patch.sections) {
     for (const [heading2, content] of Object.entries(patch.sections)) {
@@ -16077,39 +16072,6 @@ function formatYmd2(d) {
   return `${yyyy}-${mm}-${dd}`;
 }
 
-// ../../packages/core/dist/brief.js
-function generateBrief(db, topic, limit = 10) {
-  const related = topic.trim().length > 0 ? search(db, { query: topic, limit }) : [];
-  const brief_id = `brf-${Date.now().toString(36)}-${randomHex(8)}`;
-  const lines = [];
-  lines.push(`# \u8ABF\u67FB\u4F9D\u983C: ${topic}`);
-  lines.push("");
-  lines.push("## \u4F9D\u983C\u306E\u80CC\u666F");
-  lines.push(
-    `\u4EE5\u4E0B\u306E\u8A71\u984C\u306B\u3064\u3044\u3066\u3001\u4E00\u6B21\u30BD\u30FC\u30B9\u4E2D\u5FC3\u3067\u8ABF\u67FB\u3057\u3066\u304F\u3060\u3055\u3044: ${topic}`
-  );
-  lines.push("");
-  if (related.length > 0) {
-    lines.push("## \u65E2\u5B58\u306E\u95A2\u9023 caveat\uFF08\u53C2\u8003\uFF09");
-    for (const r2 of related) {
-      lines.push(`- \`${r2.id}\` (${r2.confidence}) ${r2.title}`);
-    }
-    lines.push("");
-  }
-  lines.push("## \u6C42\u3081\u305F\u3044\u60C5\u5831");
-  lines.push("1. \u516C\u5F0F\u4ED5\u69D8 (RFC / \u4ED5\u69D8\u66F8 / \u30D9\u30F3\u30C0\u30FC\u516C\u5F0F\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8) \u2014 \u30D0\u30FC\u30B8\u30E7\u30F3\u660E\u8A18");
-  lines.push("2. \u65E2\u77E5\u306E\u843D\u3068\u3057\u7A74 (\u30D0\u30FC\u30B8\u30E7\u30F3\u4F9D\u5B58\u3001\u30D7\u30E9\u30C3\u30C8\u30D5\u30A9\u30FC\u30E0\u5DEE\u7570\u3001\u65E2\u5831\u306E\u4E0D\u5177\u5408)");
-  lines.push("3. \u56DE\u907F\u7B56\u3068\u4EE3\u66FF\u624B\u6BB5\uFF08\u52B9\u679C\u306E\u88CF\u53D6\u308A\u3064\u304D\uFF09");
-  lines.push("4. \u4E00\u6B21\u30BD\u30FC\u30B9 URL\u3002\u4E8C\u6B21\u30BD\u30FC\u30B9\uFF08\u30D6\u30ED\u30B0\u7B49\uFF09\u306F\u533A\u5225\u3057\u3066\u8A18\u8F09");
-  lines.push("");
-  lines.push("## \u51FA\u529B\u306E\u5F62");
-  lines.push("Symptom / Cause / Resolution / Evidence \u306E 4 \u30BB\u30AF\u30B7\u30E7\u30F3\u3067\u3001\u5F8C\u7D9A\u306E `ingest_research` \u306B\u6E21\u305B\u308B\u5F62\u5F0F\u3067\u8FD4\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
-  lines.push("");
-  lines.push("---");
-  lines.push(`brief_id: ${brief_id}`);
-  return { brief_id, text: lines.join("\n") };
-}
-
 // ../../packages/core/dist/paths.js
 import { existsSync as existsSync4 } from "node:fs";
 import { dirname as dirname3, isAbsolute, join as join5, resolve } from "node:path";
@@ -16133,7 +16095,11 @@ function resolvePaths(caveatHome, knowledgeRepo, userHome) {
     knowledgeRepo: resolved,
     dbPath: join5(caveatHome, "index", "caveat.db"),
     entriesDir: join5(resolved, "entries"),
-    communityDir: join5(resolved, "community")
+    // community/ lives at caveatHome level, NOT inside knowledgeRepo. Community
+    // clones are external knowledge caches — not semantically "owned" by the
+    // user — and they embed their own .git dirs which would otherwise nest
+    // inside the user's git-tracked knowledge repo.
+    communityDir: join5(caveatHome, "community")
   };
 }
 
@@ -21291,16 +21257,16 @@ async function pushEntry(opts) {
     const stagingDir = forkStagingDir(opts.caveatHome);
     ensureStagingClone(stagingDir, ghUser, sharedName, sharedOwner);
     const branch = `caveat-push-${owned.id}-${Date.now().toString(36)}`;
-    run("git", ["checkout", "-b", branch], { cwd: stagingDir });
+    runOrThrow("git", ["checkout", "-b", branch], { cwd: stagingDir });
     const destPath = join7(stagingDir, "entries", owned.relPath);
     mkdirSync3(dirname4(destPath), { recursive: true });
     copyFileSync(owned.absPath, destPath);
-    run("git", ["add", join7("entries", owned.relPath)], { cwd: stagingDir });
+    runOrThrow("git", ["add", join7("entries", owned.relPath)], { cwd: stagingDir });
     const isUpdate = upstreamAlreadyHas(stagingDir, "entries/" + owned.relPath);
     const verb = isUpdate ? "update" : "add";
     const commitMsg = `${verb}: ${owned.title}`;
-    run("git", ["commit", "-m", commitMsg], { cwd: stagingDir });
-    run("git", ["push", "--set-upstream", "origin", branch], { cwd: stagingDir });
+    runOrThrow("git", ["commit", "-m", commitMsg], { cwd: stagingDir });
+    runOrThrow("git", ["push", "--set-upstream", "origin", branch], { cwd: stagingDir });
     const prTitle = `${verb}: ${owned.title}`;
     const prBody = [
       `Contribution of caveat \`${owned.id}\` via \`caveat push\`.`,
@@ -21310,7 +21276,7 @@ async function pushEntry(opts) {
       "",
       "Merged PRs will appear in subscribers' repos on their next `caveat pull`."
     ].join("\n");
-    const pr = spawnSync(
+    const pr = runCapture(
       "gh",
       [
         "pr",
@@ -21326,16 +21292,15 @@ async function pushEntry(opts) {
         "--body",
         prBody
       ],
-      { cwd: stagingDir, encoding: "utf-8", shell: true }
+      { cwd: stagingDir }
     );
     if (pr.status !== 0) {
       return {
         status: "failed",
-        detail: (typeof pr.stderr === "string" ? pr.stderr : String(pr.stderr ?? "")).trim() || "gh pr create failed"
+        detail: (pr.stderr || "gh pr create failed").trim()
       };
     }
-    const prUrl = (typeof pr.stdout === "string" ? pr.stdout : String(pr.stdout ?? "")).trim();
-    return { status: "ok", prUrl };
+    return { status: "ok", prUrl: pr.stdout.trim() };
   } catch (err) {
     return {
       status: "failed",
@@ -21343,21 +21308,41 @@ async function pushEntry(opts) {
     };
   }
 }
+function shellQuote(s) {
+  if (!/[\s&|<>^()"`$!*?\[\]{}\\]/.test(s)) return s;
+  return `"${s.replace(/"/g, '""')}"`;
+}
+function runCapture(command, args, opts = {}) {
+  const line = [command, ...args].map(shellQuote).join(" ");
+  const r2 = spawnSync(line, {
+    encoding: "utf-8",
+    cwd: opts.cwd,
+    shell: true
+  });
+  return {
+    status: r2.status,
+    stdout: typeof r2.stdout === "string" ? r2.stdout : "",
+    stderr: typeof r2.stderr === "string" ? r2.stderr : ""
+  };
+}
+function runOrThrow(command, args, opts = {}) {
+  const r2 = runCapture(command, args, opts);
+  if (r2.status !== 0) {
+    throw new Error(
+      `${command} ${args.join(" ")} failed: ${(r2.stderr || r2.stdout || "unknown").trim()}`
+    );
+  }
+}
 function checkGhAvailable() {
-  const r2 = spawnSync("gh", ["--version"], { encoding: "utf-8", shell: true });
-  return r2.status === 0;
+  return runCapture("gh", ["--version"]).status === 0;
 }
 function checkGhAuthed() {
-  const r2 = spawnSync("gh", ["auth", "status"], { encoding: "utf-8", shell: true });
-  return r2.status === 0;
+  return runCapture("gh", ["auth", "status"]).status === 0;
 }
 function resolveGhUser() {
-  const r2 = spawnSync("gh", ["api", "user", "--jq", ".login"], {
-    encoding: "utf-8",
-    shell: true
-  });
+  const r2 = runCapture("gh", ["api", "user", "--jq", ".login"]);
   if (r2.status !== 0) return void 0;
-  return typeof r2.stdout === "string" ? r2.stdout.trim() : "";
+  return r2.stdout.trim() || void 0;
 }
 function parseOwnerRepo(url) {
   const m = /^https:\/\/github\.com\/([^/]+)\/([^/]+?)(\.git)?\/?$/.exec(url);
@@ -21389,44 +21374,28 @@ function forkStagingDir(caveatHome) {
   return join7(caveatHome, "push-fork");
 }
 function ensureFork(owner, repo) {
-  spawnSync(
-    "gh",
-    ["repo", "fork", `${owner}/${repo}`, "--clone=false", "--remote=false"],
-    { encoding: "utf-8", shell: true }
-  );
+  runCapture("gh", ["repo", "fork", `${owner}/${repo}`, "--clone=false", "--remote=false"]);
 }
 function ensureStagingClone(stagingDir, ghUser, sharedName, upstreamOwner) {
   if (!existsSync7(stagingDir)) {
     mkdirSync3(dirname4(stagingDir), { recursive: true });
     const forkUrl = `https://github.com/${ghUser}/${sharedName}.git`;
-    run("git", ["clone", "--depth", "30", forkUrl, stagingDir]);
-    run(
+    runOrThrow("git", ["clone", "--depth", "30", forkUrl, stagingDir]);
+    runOrThrow(
       "git",
       ["remote", "add", "upstream", `https://github.com/${upstreamOwner}/${sharedName}.git`],
       { cwd: stagingDir }
     );
   } else {
-    run("git", ["checkout", "main"], { cwd: stagingDir });
-    run("git", ["fetch", "upstream", "main"], { cwd: stagingDir });
-    run("git", ["reset", "--hard", "upstream/main"], { cwd: stagingDir });
-    run("git", ["push", "origin", "main", "--force-with-lease"], { cwd: stagingDir });
+    runOrThrow("git", ["checkout", "main"], { cwd: stagingDir });
+    runOrThrow("git", ["fetch", "upstream", "main"], { cwd: stagingDir });
+    runOrThrow("git", ["reset", "--hard", "upstream/main"], { cwd: stagingDir });
+    runOrThrow("git", ["push", "origin", "main", "--force-with-lease"], { cwd: stagingDir });
   }
 }
 function upstreamAlreadyHas(stagingDir, relFromRoot) {
   return existsSync7(join7(stagingDir, relFromRoot));
 }
-function run(command, args, opts = {}) {
-  const r2 = spawnSync(command, args, {
-    encoding: "utf-8",
-    cwd: opts.cwd,
-    shell: true
-  });
-  if (r2.status !== 0) {
-    const stderr = typeof r2.stderr === "string" ? r2.stderr : String(r2.stderr ?? "");
-    const stdout = typeof r2.stdout === "string" ? r2.stdout : String(r2.stdout ?? "");
-    throw new Error(`${command} ${args.join(" ")} failed: ${(stderr || stdout || "unknown").trim()}`);
-  }
-}
 
 // ../../packages/core/dist/pullShared.js
 import { existsSync as existsSync8, readdirSync as readdirSync5 } from "node:fs";
@@ -21473,6 +21442,21 @@ function buildContext(logger, overrides = {}) {
   return { caveatHome, userHome, userConfigPath, config: config3, paths, logger };
 }
 
+// src/version.ts
+import { readFileSync as readFileSync6 } from "node:fs";
+import { dirname as dirname5, join as join10 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+function resolveVersion() {
+  try {
+    const here2 = dirname5(fileURLToPath3(import.meta.url));
+    const pkg = JSON.parse(readFileSync6(join10(here2, "..", "package.json"), "utf-8"));
+    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var CAVEAT_VERSION = resolveVersion();
+
 // src/logger.ts
 var stdoutLogger = {
   info: (m) => process.stdout.write(`[caveat] ${m}
@@ -21484,13 +21468,13 @@ var stdoutLogger = {
 };
 
 // src/commands/init.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync5, readdirSync as readdirSync6, writeFileSync as writeFileSync5 } from "node:fs";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync5, readdirSync as readdirSync6, renameSync, rmdirSync, writeFileSync as writeFileSync5 } from "node:fs";
+import { join as join12 } from "node:path";
 
 // src/claudeInstall.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { copyFileSync as copyFileSync2, existsSync as existsSync9, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname as dirname5, join as join10 } from "node:path";
+import { copyFileSync as copyFileSync2, existsSync as existsSync9, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname6, join as join11 } from "node:path";
 var EVENT_USER_PROMPT_SUBMIT = "UserPromptSubmit";
 var EVENT_STOP = "Stop";
 function quote(p2) {
@@ -21525,10 +21509,10 @@ function removeHook(settings, event, command) {
 }
 function readSettings(path) {
   if (!existsSync9(path)) return {};
-  return JSON.parse(readFileSync6(path, "utf-8"));
+  return JSON.parse(readFileSync7(path, "utf-8"));
 }
 function writeSettings(path, settings) {
-  const dir = dirname5(path);
+  const dir = dirname6(path);
   if (!existsSync9(dir)) mkdirSync4(dir, { recursive: true });
   let backupPath = "";
   if (existsSync9(path)) {
@@ -21539,11 +21523,11 @@ function writeSettings(path, settings) {
   return backupPath;
 }
 var CLAUDE_BIN = "claude";
-function shellQuote(s) {
+function shellQuote2(s) {
   return /[\s&|<>^()]/.test(s) ? `"${s}"` : s;
 }
 function runClaude(args) {
-  const line = [CLAUDE_BIN, ...args].map(shellQuote).join(" ");
+  const line = [CLAUDE_BIN, ...args].map(shellQuote2).join(" ");
   return spawnSync2(line, { shell: true, encoding: "utf-8" });
 }
 function registerMcp(nodePath, cliScriptPath, dryRun, logger) {
@@ -21594,7 +21578,7 @@ function unregisterMcp(dryRun, logger) {
   return { action: "skipped", detail: "not registered or removal failed" };
 }
 function installClaudeIntegration(opts) {
-  const settingsPath = join10(opts.claudeDir, "settings.json");
+  const settingsPath = join11(opts.claudeDir, "settings.json");
   const settings = readSettings(settingsPath);
   const usCmd = hookCommand(opts.nodePath, opts.cliScriptPath, "user-prompt-submit");
   const stopCmd = hookCommand(opts.nodePath, opts.cliScriptPath, "stop");
@@ -21613,7 +21597,7 @@ function installClaudeIntegration(opts) {
   return { mcp, hooks: { userPromptSubmit, stop }, backupPath };
 }
 function uninstallClaudeIntegration(opts) {
-  const settingsPath = join10(opts.claudeDir, "settings.json");
+  const settingsPath = join11(opts.claudeDir, "settings.json");
   const settings = readSettings(settingsPath);
   const usCmd = hookCommand(opts.nodePath, opts.cliScriptPath, "user-prompt-submit");
   const stopCmd = hookCommand(opts.nodePath, opts.cliScriptPath, "stop");
@@ -21643,11 +21627,6 @@ var KNOWLEDGE_GITIGNORE = [
   "",
   "# Obsidian per-user config: workspace layout, theme, plugin state, cache.",
   ".obsidian/",
-  "",
-  "# community/ is a local cache of shallow-cloned third-party caveat repos",
-  "# (populated by `caveat community add`). Each contains its own .git and is not",
-  "# part of this repo's tracked knowledge.",
-  "community/",
   ""
 ].join("\n");
 async function runInit(ctx, opts = { skipClaude: false, skipShared: false, dryRun: false }) {
@@ -21660,7 +21639,8 @@ async function runInit(ctx, opts = { skipClaude: false, skipShared: false, dryRu
   } else {
     ctx.logger.info(`knowledge repo: ${ctx.paths.knowledgeRepo}`);
   }
-  const gitignorePath = join11(ctx.paths.knowledgeRepo, ".gitignore");
+  migrateLegacyCommunityDir(ctx);
+  const gitignorePath = join12(ctx.paths.knowledgeRepo, ".gitignore");
   if (!existsSync10(gitignorePath)) {
     writeFileSync5(gitignorePath, KNOWLEDGE_GITIGNORE, "utf-8");
     ctx.logger.info(`.gitignore created: ${gitignorePath}`);
@@ -21688,7 +21668,7 @@ async function runInit(ctx, opts = { skipClaude: false, skipShared: false, dryRu
     return;
   }
   const result = installClaudeIntegration({
-    claudeDir: join11(ctx.userHome, ".claude"),
+    claudeDir: join12(ctx.userHome, ".claude"),
     cliScriptPath,
     nodePath: process.execPath,
     dryRun: opts.dryRun,
@@ -21696,6 +21676,28 @@ async function runInit(ctx, opts = { skipClaude: false, skipShared: false, dryRu
   });
   reportInstallResult(ctx, result, opts.dryRun);
 }
+function migrateLegacyCommunityDir(ctx) {
+  const legacy = join12(ctx.paths.knowledgeRepo, "community");
+  const current = ctx.paths.communityDir;
+  if (legacy === current) return;
+  if (!existsSync10(legacy)) return;
+  if (existsSync10(current)) {
+    ctx.logger.warn(
+      `legacy community dir still exists at ${legacy} \u2014 remove manually (new location in use)`
+    );
+    return;
+  }
+  mkdirSync5(current, { recursive: true });
+  for (const entry of readdirSync6(legacy, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    renameSync(join12(legacy, entry.name), join12(current, entry.name));
+  }
+  try {
+    rmdirSync(legacy);
+  } catch {
+  }
+  ctx.logger.info(`migrated legacy community/ \u2192 ${current}`);
+}
 async function subscribeSharedRepo(ctx, db) {
   const url = ctx.config.sharedRepo;
   const validation = validateCommunityUrl(url);
@@ -21706,7 +21708,7 @@ async function subscribeSharedRepo(ctx, db) {
     return;
   }
   const handle = validation.handle;
-  const target = join11(ctx.paths.communityDir, handle);
+  const target = join12(ctx.paths.communityDir, handle);
   if (!existsSync10(target)) {
     if (!existsSync10(ctx.paths.communityDir)) {
       mkdirSync5(ctx.paths.communityDir, { recursive: true });
@@ -21735,7 +21737,7 @@ async function subscribeSharedRepo(ctx, db) {
     for (const entry of readdirSync6(ctx.paths.communityDir, { withFileTypes: true })) {
       if (!entry.isDirectory()) continue;
       const source = `community/${entry.name}`;
-      const root = join11(ctx.paths.communityDir, entry.name, "entries");
+      const root = join12(ctx.paths.communityDir, entry.name, "entries");
       if (!existsSync10(root)) continue;
       const result = scanSource({ db, source, entriesRoot: root });
       ctx.logger.info(`indexed ${source}: +${result.added}`);
@@ -21749,7 +21751,7 @@ function runUninstall(ctx, opts) {
     process.exit(1);
   }
   const result = uninstallClaudeIntegration({
-    claudeDir: join11(ctx.userHome, ".claude"),
+    claudeDir: join12(ctx.userHome, ".claude"),
     cliScriptPath,
     nodePath: process.execPath,
     dryRun: opts.dryRun,
@@ -21787,9 +21789,9 @@ function reportInstallResult(ctx, result, dryRun) {
 
 // src/commands/indexCmd.ts
 import { existsSync as existsSync11, readdirSync as readdirSync7, mkdirSync as mkdirSync6 } from "node:fs";
-import { dirname as dirname6, join as join12 } from "node:path";
+import { dirname as dirname7, join as join13 } from "node:path";
 function runIndex(ctx, opts) {
-  const dbDir = dirname6(ctx.paths.dbPath);
+  const dbDir = dirname7(ctx.paths.dbPath);
   if (!existsSync11(dbDir)) mkdirSync6(dbDir, { recursive: true });
   const db = openDb({ path: ctx.paths.dbPath, logger: ctx.logger });
   try {
@@ -21807,7 +21809,7 @@ function runIndex(ctx, opts) {
       for (const entry of readdirSync7(ctx.paths.communityDir, { withFileTypes: true })) {
         if (!entry.isDirectory()) continue;
         const source = `community/${entry.name}`;
-        const root = join12(ctx.paths.communityDir, entry.name, "entries");
+        const root = join13(ctx.paths.communityDir, entry.name, "entries");
         if (!existsSync11(root)) continue;
         const result = scanSource({ db, source, entriesRoot: root });
         ctx.logger.info(`${source}: +${result.added} ~${result.updated} -${result.deleted}`);
@@ -22582,11 +22584,11 @@ var serve = (options2, listeningListener) => {
 
 // ../web/dist/context.js
 import { homedir as homedir2 } from "node:os";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 function buildWebContext(overrides = {}) {
   const userHome = overrides.userHome ?? homedir2();
   const caveatHome = overrides.caveatHome ?? findCaveatHome(userHome);
-  const userConfigPath = join13(userHome, ".caveatrc.json");
+  const userConfigPath = join14(userHome, ".caveatrc.json");
   const logger = overrides.logger ?? stderrLogger;
   const config3 = loadConfig(userConfigPath);
   const paths = resolvePaths(caveatHome, config3.knowledgeRepo, userHome);
@@ -30314,13 +30316,13 @@ function createDetailRoute(ctx) {
 
 // ../web/dist/routes/community.js
 import { existsSync as existsSync12, readdirSync as readdirSync8, statSync as statSync4 } from "node:fs";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 function listCommunity(communityDir, db) {
   if (!existsSync12(communityDir)) return [];
   const handles = [];
   for (const entry of readdirSync8(communityDir, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
-    const handlePath = join14(communityDir, entry.name);
+    const handlePath = join15(communityDir, entry.name);
     const countRow = db.prepare("SELECT COUNT(*) AS n FROM entries WHERE source = ?").get(`community/${entry.name}`);
     handles.push({
       handle: entry.name,
@@ -44618,11 +44620,11 @@ var StdioServerTransport = class {
 
 // ../mcp/dist/context.js
 import { homedir as homedir3 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 function buildMcpContext(overrides = {}) {
   const userHome = overrides.userHome ?? homedir3();
   const caveatHome = overrides.caveatHome ?? findCaveatHome(userHome);
-  const userConfigPath = join15(userHome, ".caveatrc.json");
+  const userConfigPath = join16(userHome, ".caveatrc.json");
   const logger = overrides.logger ?? stderrLogger;
   const config3 = loadConfig(userConfigPath);
   const paths = resolvePaths(caveatHome, config3.knowledgeRepo, userHome);
@@ -44681,8 +44683,7 @@ var recordInputShape = {
   visibility: visibilitySchema.optional(),
   tags: external_exports.array(external_exports.string()).optional(),
   environment: external_exports.record(external_exports.string(), external_exports.string()).optional(),
-  category: external_exports.string().optional().describe("Directory under entries/ (e.g., gpu, claude-code). Default: misc"),
-  brief_id: external_exports.string().optional()
+  category: external_exports.string().optional().describe("Directory under entries/ (e.g., gpu, claude-code). Default: misc")
 };
 function handleRecord(ctx, args) {
   return recordEntry(args, {
@@ -44729,48 +44730,6 @@ function handleListRecent(ctx, args) {
   return listRecent(ctx.db, args.limit ?? 20);
 }
 
-// ../mcp/dist/tools/nlmBriefFor.js
-var nlmBriefForInputShape = {
-  topic: external_exports.string().min(1),
-  limit: external_exports.number().int().min(1).max(50).optional()
-};
-function handleNlmBriefFor(ctx, args) {
-  return generateBrief(ctx.db, args.topic, args.limit);
-}
-
-// ../mcp/dist/tools/ingestResearch.js
-var ingestResearchInputShape = {
-  title: external_exports.string().min(1),
-  symptom: external_exports.string().min(1),
-  cause: external_exports.string().optional(),
-  resolution: external_exports.string().optional(),
-  evidence: external_exports.array(external_exports.string()).optional(),
-  brief_id: external_exports.string().optional(),
-  tags: external_exports.array(external_exports.string()).optional(),
-  category: external_exports.string().optional()
-};
-function handleIngestResearch(ctx, args) {
-  const evidenceText = args.evidence ? args.evidence.map((line) => `- ${line}`).join("\n") : "";
-  return recordEntry(
-    {
-      title: args.title,
-      symptom: args.symptom,
-      cause: args.cause ?? "",
-      resolution: args.resolution ?? "",
-      evidence: evidenceText,
-      confidence: "tentative",
-      outcome: "resolved",
-      tags: args.tags,
-      category: args.category,
-      brief_id: args.brief_id
-    },
-    {
-      db: ctx.db,
-      entriesRoot: ctx.paths.entriesDir
-    }
-  );
-}
-
 // ../mcp/dist/tools/pull.js
 var pullInputShape = {};
 async function handlePull(ctx, _args = {}) {
@@ -44856,7 +44815,7 @@ function registerAllTools(server, ctx) {
     "caveat_update",
     {
       title: "caveat_update",
-      description: "Patch an existing caveat. Frontmatter shallow-merges (arrays replace). Sections matched by case-insensitive H2 heading. Immutable keys: id, created_at, source_session, source_project, brief_id.",
+      description: "Patch an existing caveat. Frontmatter shallow-merges (arrays replace). Sections matched by case-insensitive H2 heading. Immutable keys: id, created_at, source_session, source_project.",
       inputSchema: updateInputShape
     },
     async (args) => jsonResult(handleUpdate(ctx, args))
@@ -44870,24 +44829,6 @@ function registerAllTools(server, ctx) {
     },
     async (args) => jsonResult(handleListRecent(ctx, args))
   );
-  server.registerTool(
-    "nlm_brief_for",
-    {
-      title: "nlm_brief_for",
-      description: "Generate a NotebookLM research brief for a topic. Returns {brief_id, text}. brief_id can be passed to ingest_research when the NLM output is ready. Stateless \u2014 brief_id is not persisted until ingest_research fires.",
-      inputSchema: nlmBriefForInputShape
-    },
-    async (args) => jsonResult(handleNlmBriefFor(ctx, args))
-  );
-  server.registerTool(
-    "ingest_research",
-    {
-      title: "ingest_research",
-      description: "Create a caveat from NotebookLM research output. Always records with confidence: tentative. Pass brief_id to link back to the originating brief.",
-      inputSchema: ingestResearchInputShape
-    },
-    async (args) => jsonResult(handleIngestResearch(ctx, args))
-  );
   server.registerTool(
     "caveat_pull",
     {
@@ -45121,7 +45062,7 @@ function runCommunityList(ctx) {
 
 // src/index.ts
 var program = new Command();
-program.name("caveat").description("External spec gotcha knowledge base CLI").version("0.5.0");
+program.name("caveat").description("External spec gotcha knowledge base CLI").version(CAVEAT_VERSION);
 program.command("init").description(
   "Initialize ~/.caveatrc.json, ~/.caveat/, subscribe to the shared community DB, and register Claude Code integration"
 ).option("--skip-claude", "skip Claude Code MCP + hook registration", false).option("--skip-shared", "skip subscribing to the shared community DB", false).option("--dry-run", "show planned changes without writing", false).action(async (opts) => {