caveat-cli 0.14.2 → 0.14.4

package/README.md

@@ -1,6 +1,6 @@
 # caveat-cli
 
-External spec gotcha knowledge base CLI — markdown + SQLite FTS5 + MCP server + Claude Code hooks. Personal / group knowledge tool, no central shared DB.
+Long-term memory CLI for Claude Code and Codex — markdown + SQLite FTS5 + MCP server + agent hooks. Personal / group knowledge tool, no central shared DB.
 
 **Source / full docs**: https://github.com/kitepon-rgb/Caveat
 
@@ -8,17 +8,28 @@ External spec gotcha knowledge base CLI — markdown + SQLite FTS5 + MCP server
 
 ```sh
 npm install -g caveat-cli
-caveat init
+caveat init                          # Claude Code MCP + hooks
+caveat codex-hook install            # optional: native Codex hooks
 ```
 
-`caveat init` (idempotent, `--dry-run` supported) does 3 things:
+`caveat init` (idempotent, `--dry-run` supported) does the Claude Code setup:
 
 1. Scaffolds `~/.caveat/own/` (your personal knowledge repo) + `~/.caveat/index/caveat.db`
 2. Registers the MCP server with Claude Code (`claude mcp add --scope user`)
-3. Merges `UserPromptSubmit` / `Stop` hooks into `~/.claude/settings.json` (existing entries preserved, backup written before any change)
+3. Merges `UserPromptSubmit` / `PostToolUse` / `PostToolUseFailure` / `Stop` hooks into `~/.claude/settings.json` (existing entries preserved, backup written before any change)
 
 Opt-out: `--skip-claude`. `caveat uninstall` reverses the Claude Code changes without touching `~/.caveat/`. **No central DB is auto-subscribed** — add knowledge sources explicitly with `caveat community add`.
 
+For Codex, run `caveat codex-hook diagnostics` first if you want a health check,
+then `caveat codex-hook install`. It registers Caveat-owned
+`UserPromptSubmit`, `PostToolUse`, and `Stop` entries in `~/.codex/hooks.json`
+and enables Codex's native hook runtime.
+
+With either host enabled, Caveat surfaces matching entries at three moments:
+before prompts, after failed tools, and after struggle-heavy sessions. Stop
+reminders are queued for the next context-capable hook tick so the agent's final
+answer is not cluttered by hook output.
+
 ## Basic usage
 
 ```sh
@@ -31,6 +42,7 @@ caveat community remove <handle>    # unsubscribe + purge db rows
 caveat pull                         # community pull + re-index everything
 caveat serve                        # http://localhost:4242 read-only portal
 caveat uninstall                    # reverse `caveat init` Claude integration
+caveat codex-hook diagnostics       # inspect Codex hook availability/install state
 ```
 
 ## Sharing with a team
@@ -51,6 +63,10 @@ Exposed to Claude Code via the MCP server that `caveat init` registers:
 
 Claude can autonomously pull subscribed-repo updates (safe, idempotent). Recording / updating writes to your local `~/.caveat/own/` only — sharing is done by you via `git push` to your group repo.
 
+Codex uses native hooks rather than MCP for automatic surfacing. The optional
+`codex-sidecar` commands remain available for bounded second opinions, review,
+risk-check, and isolated work.
+
 ## Pointing at a different knowledge repo
 
 If you want `~/.caveat/own/` to live elsewhere (e.g. a git-tracked directory you sync to a team repo), override in `~/.caveatrc.json`:
@@ -63,7 +79,8 @@ If you want `~/.caveat/own/` to live elsewhere (e.g. a git-tracked directory you
 
 - Node 22.5+ (for built-in `node:sqlite`)
 - `git` for `caveat community add` / `caveat community pull`
-- Claude Code installed if you want MCP / hooks integration. Without it, `caveat init --skip-claude` still provisions local state.
+- Claude Code installed if you want Claude MCP / hooks integration. Without it, `caveat init --skip-claude` still provisions local state.
+- Codex installed if you want native Codex hooks via `caveat codex-hook install`.
 
 ## License
 

package/dist/{chunk-CSXD73IX.js → chunk-EH3S6X6X.js}

@@ -14404,7 +14404,9 @@ function findCaveatsForPrompt(db, prompt, opts = {}) {
         entry = {
           groups: /* @__PURE__ */ new Set(),
           symptomTokens: /* @__PURE__ */ new Set(),
+          topicalTokens: /* @__PURE__ */ new Set(),
           symptomLower: typeof row.symptom_text === "string" && row.symptom_text.length > 0 ? row.symptom_text.toLowerCase() : null,
+          topicalLower: typeof row.topical_text === "string" && row.topical_text.length > 0 ? row.topical_text.toLowerCase() : null,
           row
         };
         perEntry.set(row.rowid, entry);
@@ -14413,6 +14415,9 @@ function findCaveatsForPrompt(db, prompt, opts = {}) {
       if (entry.symptomLower !== null && tokenAppearsIn(tokLower, entry.symptomLower)) {
         entry.symptomTokens.add(tokLower);
       }
+      if (entry.topicalLower !== null && tokenAppearsIn(tokLower, entry.topicalLower)) {
+        entry.topicalTokens.add(tokLower);
+      }
     }
   }
   const validDfs = [...tokenDf.entries()].filter(([, df]) => df > 0);
@@ -14421,9 +14426,10 @@ function findCaveatsForPrompt(db, prompt, opts = {}) {
   for (const [, df] of validDfs) if (df < minDf) minDf = df;
   const rareTokens = new Set(validDfs.filter(([, df]) => df === minDf).map(([t2]) => t2));
   const limit = opts.limit ?? DEFAULT_REMINDER_HIT_LIMIT;
-  return [...perEntry.values()].filter(({ groups, symptomTokens }) => {
+  return [...perEntry.values()].filter(({ groups, symptomTokens, topicalTokens }) => {
     if (groups.size < minMatches) return false;
-    for (const t2 of symptomTokens) if (rareTokens.has(t2)) return true;
+    if (symptomTokens.size === 0) return false;
+    for (const t2 of topicalTokens) if (rareTokens.has(t2)) return true;
     return false;
   }).sort((a, b2) => b2.groups.size - a.groups.size).slice(0, limit).map(({ row }) => toSearchResult2(row));
 }
@@ -15312,4 +15318,4 @@ strip-bom-string/index.js:
 js-yaml/dist/js-yaml.mjs:
   (*! js-yaml 4.1.1 https://github.com/nodeca/js-yaml @license MIT *)
 */
-//# sourceMappingURL=chunk-CSXD73IX.js.map
+//# sourceMappingURL=chunk-EH3S6X6X.js.map