caveat-cli 0.16.3 → 0.17.0

package/dist/index.js

@@ -3,6 +3,7 @@ import { createRequire as __caveat_createRequire } from 'node:module';
 const require = __caveat_createRequire(import.meta.url);
 import {
   AUTO_SYNC_DEBOUNCE_MS,
+  AUTO_SYNC_RECORD_DEBOUNCE_MS,
   CAVEAT_AUTO_SYNC_ENV,
   KNOWLEDGE_GITIGNORE,
   PublishScanError,
@@ -66,11 +67,12 @@ import {
   struggleSearchText,
   syncOwn,
   toolErrorReminderText,
+  triggerAutoSync,
   updateEntry,
   userPromptSubmitReminderText,
   writeDigestMarker,
   writeUserConfigPatch
-} from "./chunk-PD5E6TFL.js";
+} from "./chunk-7FEOFAMA.js";
 
 // ../../node_modules/.pnpm/ajv@8.18.0/node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -8288,7 +8290,7 @@ function runStats(ctx) {
 
 // src/commands/serve.ts
 async function runServe(opts) {
-  const { startServer } = await import("./server-ZMIRSFMH.js");
+  const { startServer } = await import("./server-STR2EAWZ.js");
   const { port, host } = startServer({ port: opts.port });
   process.stdout.write(`[caveat] web portal: http://${host}:${port}/
 `);
@@ -32361,6 +32363,21 @@ var StdioServerTransport = class {
 // ../mcp/dist/context.js
 import { homedir as homedir2 } from "node:os";
 import { join as join9 } from "node:path";
+
+// ../mcp/dist/autoSyncTrigger.js
+function triggerAutoSyncAfterWrite(caveatHome, logger) {
+  try {
+    triggerAutoSync({
+      caveatHome,
+      cliScript: process.argv[1] ?? "",
+      debounceMs: AUTO_SYNC_RECORD_DEBOUNCE_MS
+    });
+  } catch (err) {
+    logger.warn(`auto sync trigger failed: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+
+// ../mcp/dist/context.js
 function buildMcpContext(overrides = {}) {
   const userHome = overrides.userHome ?? homedir2();
   const caveatHome = overrides.caveatHome ?? findCaveatHome(userHome);
@@ -32369,7 +32386,8 @@ function buildMcpContext(overrides = {}) {
   const config2 = loadConfig(userConfigPath);
   const paths = resolvePaths(caveatHome, config2.knowledgeRepo, userHome);
   const db = openDb({ path: paths.dbPath, logger });
-  return { caveatHome, userHome, userConfigPath, config: config2, paths, logger, db };
+  const onEntryWritten = overrides.onEntryWritten ?? (() => triggerAutoSyncAfterWrite(caveatHome, logger));
+  return { caveatHome, userHome, userConfigPath, config: config2, paths, logger, db, onEntryWritten };
 }
 
 // ../mcp/dist/tools/search.js
@@ -32452,10 +32470,12 @@ var recordInputShape = {
   category: external_exports.string().optional().describe("Directory under entries/ (e.g., gpu, claude-code). Default: misc")
 };
 function handleRecord(ctx, args) {
-  return recordEntry(args, {
+  const result = recordEntry(args, {
     db: ctx.db,
     entriesRoot: ctx.paths.entriesDir
   });
+  ctx.onEntryWritten();
+  return result;
 }
 
 // ../mcp/dist/tools/update.js
@@ -32492,11 +32512,13 @@ function handleUpdate(ctx, args) {
   if (source !== "own") {
     throw new Error("community \u30A8\u30F3\u30C8\u30EA\u306F\u8CFC\u8AAD\u7269\u3067\u3059; \u7DE8\u96C6\u306F\u4E0A\u6D41\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044");
   }
-  return updateEntry(args.id, args.patch, {
+  const result = updateEntry(args.id, args.patch, {
     db: ctx.db,
     entriesRoot: ctx.paths.entriesDir,
     source
   });
+  ctx.onEntryWritten();
+  return result;
 }
 
 // ../mcp/dist/tools/listRecent.js
@@ -32666,10 +32688,10 @@ async function runMcpServer() {
 }
 
 // src/commands/hookCmd.ts
-import { spawn as spawn3 } from "node:child_process";
+import { spawn as spawn2 } from "node:child_process";
 import {
   chmodSync,
-  existsSync as existsSync10,
+  existsSync as existsSync9,
   lstatSync,
   mkdtempSync as mkdtempSync2,
   mkdirSync as mkdirSync5,
@@ -32680,7 +32702,7 @@ import {
   writeFileSync as writeFileSync5
 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { basename, dirname as dirname6, join as join12 } from "node:path";
+import { basename, dirname as dirname6, join as join11 } from "node:path";
 import { createHash, randomBytes } from "node:crypto";
 
 // src/autoReindexTrigger.ts
@@ -32707,25 +32729,12 @@ function maybeTriggerAutoReindex(ctx) {
 }
 
 // src/autoSyncTrigger.ts
-import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync9, statSync as statSync3 } from "node:fs";
-import { join as join11 } from "node:path";
-function maybeTriggerAutoSync(ctx) {
-  if (process.env[CAVEAT_AUTO_SYNC_ENV] === "off") return;
-  const statePath = join11(ctx.caveatHome, "sync", ".last-autosync.json");
-  const debounceMs = Number(process.env.CAVEAT_AUTO_SYNC_DEBOUNCE_MS ?? AUTO_SYNC_DEBOUNCE_MS);
-  try {
-    if (existsSync9(statePath) && Date.now() - statSync3(statePath).mtimeMs < debounceMs) return;
-  } catch {
-  }
-  const cliScript = process.argv[1];
-  if (!cliScript) throw new Error("current Caveat CLI script path is unavailable");
-  const child = spawn2(
-    process.execPath,
-    [...process.execArgv, "--disable-warning=ExperimentalWarning", cliScript, "hook", "autosync"],
-    { detached: true, stdio: "ignore", windowsHide: true }
-  );
-  child.unref();
+function maybeTriggerAutoSync(ctx, debounceMs = AUTO_SYNC_DEBOUNCE_MS) {
+  triggerAutoSync({
+    caveatHome: ctx.caveatHome,
+    cliScript: process.argv[1] ?? "",
+    debounceMs
+  });
 }
 
 // src/commands/hookCmd.ts
@@ -32783,7 +32792,7 @@ function searchCaveatsSafely(input) {
   let hits;
   try {
     const ctx = buildContextSafely();
-    if (!ctx || !existsSync10(ctx.paths.dbPath)) return [];
+    if (!ctx || !existsSync9(ctx.paths.dbPath)) return [];
     caveatHome = ctx.caveatHome;
     db = openDb({ path: ctx.paths.dbPath });
     const searchOptions = {
@@ -32891,7 +32900,7 @@ function stopSignalKey(signals, related) {
   return createHash("sha256").update(body).digest("hex");
 }
 function stopStatePath(caveatHome, sessionId) {
-  return join12(caveatHome, CLAUDE_STOP_STATE_DIR, `${sanitizeClaudeStateId(sessionId)}.txt`);
+  return join11(caveatHome, CLAUDE_STOP_STATE_DIR, `${sanitizeClaudeStateId(sessionId)}.txt`);
 }
 function wasStopReminderQueued(caveatHome, sessionId, key) {
   const path = stopStatePath(caveatHome, sessionId);
@@ -32903,7 +32912,7 @@ function wasStopReminderQueued(caveatHome, sessionId, key) {
 }
 function markStopReminderQueued(caveatHome, sessionId, key) {
   const path = stopStatePath(caveatHome, sessionId);
-  mkdirSync5(join12(caveatHome, CLAUDE_STOP_STATE_DIR), { recursive: true });
+  mkdirSync5(join11(caveatHome, CLAUDE_STOP_STATE_DIR), { recursive: true });
   writeFileSync5(path, key, "utf-8");
 }
 function queueStopForSession(sessionId, signals, related) {
@@ -32989,9 +32998,9 @@ function spawnWorker(job) {
   try {
     root = workerRoot();
     sweepStaleWorkerDirs(Date.now(), root);
-    workDir = mkdtempSync2(join12(root, "job-"));
+    workDir = mkdtempSync2(join11(root, "job-"));
     chmodSync(workDir, 448);
-    workFile = join12(workDir, `${randomBytes(4).toString("hex")}.json`);
+    workFile = join11(workDir, `${randomBytes(4).toString("hex")}.json`);
     writeFileSync5(workFile, JSON.stringify({ ...job, schemaVersion: "caveat-worker-job/v2" }), { encoding: "utf-8", mode: 384, flag: "wx" });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -33006,7 +33015,7 @@ function spawnWorker(job) {
     return;
   }
   try {
-    const child = spawn3(
+    const child = spawn2(
       process.execPath,
       ["--disable-warning=ExperimentalWarning", cliScript, "hook", "worker", workFile],
       { detached: true, stdio: "ignore", windowsHide: true }
@@ -33089,7 +33098,7 @@ function sweepStaleWorkerDirs(now = Date.now(), root = workerRoot()) {
   }
   for (const entry of entries) {
     if (!entry.startsWith("job-")) continue;
-    const path = join12(root, entry);
+    const path = join11(root, entry);
     try {
       if (!isOwnedWorkerDir(path, root)) continue;
       const stat = lstatSync(path);
@@ -33101,12 +33110,12 @@ function sweepStaleWorkerDirs(now = Date.now(), root = workerRoot()) {
   }
 }
 function workerRoot(base = tmpdir2()) {
-  const root = join12(base, WORKER_ROOT);
+  const root = join11(base, WORKER_ROOT);
   mkdirSync5(root, { recursive: true, mode: 448 });
   const stat = lstatSync(root);
   const uid = typeof process.getuid === "function" ? process.getuid() : void 0;
   if (!stat.isDirectory() || stat.isSymbolicLink() || !hasPrivateOwnership(stat, uid)) throw new Error("worker root is unsafe");
-  const marker = join12(root, WORKER_MARKER);
+  const marker = join11(root, WORKER_MARKER);
   try {
     writeFileSync5(marker, "caveat-worker/v1\n", { mode: 384, flag: "wx" });
   } catch (error51) {
@@ -33119,7 +33128,7 @@ function workerRoot(base = tmpdir2()) {
 function isStaleWorkerJobDir(path) {
   const entries = readdirSync2(path);
   if (entries.length !== 1 || !entries[0].endsWith(".json")) return false;
-  const file2 = join12(path, entries[0]);
+  const file2 = join11(path, entries[0]);
   const stat = lstatSync(file2);
   const uid = typeof process.getuid === "function" ? process.getuid() : void 0;
   if (!stat.isFile() || stat.isSymbolicLink() || !hasPrivateOwnership(stat, uid)) return false;
@@ -33145,7 +33154,7 @@ function isKnownStaleWorkerJob(value) {
 }
 function writeLastReindex(caveatHome, value) {
   try {
-    writeFileSync5(join12(caveatHome, "index", ".last-reindex.json"), JSON.stringify(value), "utf-8");
+    writeFileSync5(join11(caveatHome, "index", ".last-reindex.json"), JSON.stringify(value), "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     process.stderr.write(`[caveat:hook] reindex status write error: ${msg}
@@ -33161,7 +33170,7 @@ async function runReindexWorker() {
     return;
   }
   const ctx = buildContextSafely();
-  if (!ctx || !existsSync10(ctx.paths.dbPath)) {
+  if (!ctx || !existsSync9(ctx.paths.dbPath)) {
     process.stderr.write("[caveat:hook] auto reindex skipped: index database does not exist\n");
     return;
   }
@@ -33229,7 +33238,7 @@ function buildToolErrorReminder(job, hits) {
   const mode = hookCodexSidecarMode();
   if (mode === "off") return base;
   const projectRoot = process.cwd();
-  const hasSidecarConfig = existsSync10(join12(projectRoot, ".codex-sidecar.yml"));
+  const hasSidecarConfig = existsSync9(join11(projectRoot, ".codex-sidecar.yml"));
   if (mode === "auto" && !hasSidecarConfig) return base;
   const advisory = runCodexSidecarAdvisory({
     searchText: job.failureText,
@@ -33265,7 +33274,7 @@ function buildStopReminder(signals, related) {
   const mode = hookCodexSidecarMode();
   if (mode === "off") return base;
   const projectRoot = process.cwd();
-  const hasSidecarConfig = existsSync10(join12(projectRoot, ".codex-sidecar.yml"));
+  const hasSidecarConfig = existsSync9(join11(projectRoot, ".codex-sidecar.yml"));
   if (mode === "auto" && !hasSidecarConfig) return base;
   const advisory = runCodexSidecarAdvisory({
     searchText: struggleSearchText(signals),
@@ -33408,10 +33417,10 @@ async function runHook(name, arg) {
 }
 
 // src/commands/codexHookCmd.ts
-import { spawn as spawn4, spawnSync as spawnSync5 } from "node:child_process";
-import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync6, unlinkSync, writeFileSync as writeFileSync6 } from "node:fs";
+import { spawn as spawn3, spawnSync as spawnSync5 } from "node:child_process";
+import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync6, unlinkSync, writeFileSync as writeFileSync6 } from "node:fs";
 import { homedir as homedir3, tmpdir as tmpdir3 } from "node:os";
-import { join as join13 } from "node:path";
+import { join as join12 } from "node:path";
 import { createHash as createHash2, randomBytes as randomBytes2 } from "node:crypto";
 var silentLogger2 = {
   info: () => {
@@ -33463,7 +33472,7 @@ function searchCaveatsSafely2(input) {
   let hits;
   try {
     const ctx = buildContextSafely2();
-    if (!ctx || !existsSync11(ctx.paths.dbPath)) return [];
+    if (!ctx || !existsSync10(ctx.paths.dbPath)) return [];
     caveatHome = ctx.caveatHome;
     db = openDb({ path: ctx.paths.dbPath });
     const searchOptions = {
@@ -33547,7 +33556,7 @@ function processExitCodeFromText(text) {
   return m ? Number(m[1]) : null;
 }
 function transcriptToolOutput(transcriptPath, toolUseId) {
-  if (!transcriptPath || !toolUseId || !existsSync11(transcriptPath)) return null;
+  if (!transcriptPath || !toolUseId || !existsSync10(transcriptPath)) return null;
   let raw = "";
   try {
     raw = readFileSync6(transcriptPath, "utf-8");
@@ -33699,7 +33708,7 @@ function stopSignalKey2(signals, related) {
   return createHash2("sha256").update(body).digest("hex");
 }
 function stopStatePath2(caveatHome, sessionId) {
-  return join13(caveatHome, CODEX_STOP_STATE_DIR, `${sanitizeCodexStateId(sessionId)}.txt`);
+  return join12(caveatHome, CODEX_STOP_STATE_DIR, `${sanitizeCodexStateId(sessionId)}.txt`);
 }
 function wasStopReminderQueued2(caveatHome, sessionId, key) {
   const path = stopStatePath2(caveatHome, sessionId);
@@ -33711,7 +33720,7 @@ function wasStopReminderQueued2(caveatHome, sessionId, key) {
 }
 function markStopReminderQueued2(caveatHome, sessionId, key) {
   const path = stopStatePath2(caveatHome, sessionId);
-  mkdirSync6(join13(caveatHome, CODEX_STOP_STATE_DIR), { recursive: true });
+  mkdirSync6(join12(caveatHome, CODEX_STOP_STATE_DIR), { recursive: true });
   writeFileSync6(path, key, "utf-8");
 }
 function queueStopForSession2(sessionId, signals, related) {
@@ -33806,7 +33815,7 @@ async function runCodexWorker(workFile) {
   await processCodexWorkerJob(job);
   process.exit(0);
 }
-function runDiagnostics(codexHome = process.env.CODEX_HOME ?? join13(homedir3(), ".codex")) {
+function runDiagnostics(codexHome = process.env.CODEX_HOME ?? join12(homedir3(), ".codex")) {
   const features = spawnSync5("codex", ["features", "list"], {
     encoding: "utf-8",
     maxBuffer: 1024 * 1024,
@@ -33915,9 +33924,9 @@ async function runCodexHook(name, arg) {
 }
 
 // src/commands/pull.ts
-import { existsSync as existsSync12 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 async function runPull(ctx) {
-  const hasCommunityDir = existsSync12(ctx.paths.communityDir);
+  const hasCommunityDir = existsSync11(ctx.paths.communityDir);
   if (!hasCommunityDir) {
     ctx.logger.info(
       "no community repos yet \u2014 add one with `caveat community add <github-url>`."
@@ -34019,7 +34028,7 @@ async function runSync(ctx, opts, dependencies = {}) {
 import { spawnSync as spawnSync6 } from "node:child_process";
 import { closeSync, constants as constants3, fstatSync, lstatSync as lstatSync2, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync3, openSync, readSync as readSync2, realpathSync as realpathSync5, rmSync as rmSync3, writeFileSync as writeFileSync7 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
-import { basename as basename2, dirname as dirname7, join as join14 } from "node:path";
+import { basename as basename2, dirname as dirname7, join as join13 } from "node:path";
 import { cwd, exit } from "node:process";
 function runCodexSidecarDiagnostics(logger, opts) {
   const plan = buildCodexSidecarDiagnosticsCommand({
@@ -34051,8 +34060,8 @@ function runCodexSidecarWithCaveats(ctx, workflow, prompt, opts) {
     process.stdout.write(JSON.stringify({ status: "skipped", decision }, null, 2) + "\n");
     exit(0);
   }
-  const contextDir = mkdtempSync3(join14(tmpdir4(), "caveat-sidecar-context-"));
-  const contextFile = join14(contextDir, "context.json");
+  const contextDir = mkdtempSync3(join13(tmpdir4(), "caveat-sidecar-context-"));
+  const contextFile = join13(contextDir, "context.json");
   let status2 = 1;
   try {
     const blocks = collectCaveatContextBlocks(ctx, {
@@ -34304,8 +34313,8 @@ function runCommunityRemove(ctx, handle, opts) {
 
 // src/commands/factoryDiagnostics.ts
 import { execFileSync } from "node:child_process";
-import { existsSync as existsSync13, readFileSync as readFileSync7 } from "node:fs";
-import { join as join15 } from "node:path";
+import { existsSync as existsSync12, readFileSync as readFileSync7 } from "node:fs";
+import { join as join14 } from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import { parse as parseToml2 } from "smol-toml";
 var status = (ok, reason) => ({ status: ok ? "ready" : "not_ready", reason_code: ok ? "ready" : reason });
@@ -34317,8 +34326,8 @@ function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function claudeRegistration(home, nodePath, cliScriptPath) {
-  const path = join15(home, ".claude.json");
-  if (!existsSync13(path)) return status(false, "not_registered");
+  const path = join14(home, ".claude.json");
+  if (!existsSync12(path)) return status(false, "not_registered");
   try {
     const value = JSON.parse(readFileSync7(path, "utf8"));
     if (!isRecord2(value) || !isRecord2(value.mcpServers)) return status(false, "not_registered");
@@ -34329,7 +34338,7 @@ function claudeRegistration(home, nodePath, cliScriptPath) {
 }
 function claudeHooks(home, nodePath, cliScriptPath) {
   try {
-    const settings = JSON.parse(readFileSync7(join15(home, ".claude", "settings.json"), "utf8"));
+    const settings = JSON.parse(readFileSync7(join14(home, ".claude", "settings.json"), "utf8"));
     const present = (event, subcommand) => settings.hooks?.[event]?.some((entry) => entry.hooks?.some((item) => typeof item.command === "string" && isCanonicalCaveatClaudeHookCommand(item.command, subcommand, nodePath, cliScriptPath))) ?? false;
     return { user_prompt_submit: hook(present("UserPromptSubmit", "user-prompt-submit")), post_tool_use: hook(present("PostToolUse", "post-tool-use")), post_tool_use_failure: hook(present("PostToolUseFailure", "post-tool-use")), stop: hook(present("Stop", "stop")) };
   } catch {
@@ -34351,7 +34360,7 @@ function strictSearchSchema(db) {
   return columns.map((column) => `${column.name}:${column.hidden}`).join(",") === "id:0,title:0,body:0,tags:0,entries_fts:1,rank:1";
 }
 function database(path) {
-  if (!existsSync13(path)) return { status: "not_ready", reason_code: "missing", schema_version: null, supported_schema_version: 3, migration_status: "unverified" };
+  if (!existsSync12(path)) return { status: "not_ready", reason_code: "missing", schema_version: null, supported_schema_version: 3, migration_status: "unverified" };
   try {
     const db = new DatabaseSync(path, { readOnly: true });
     try {
@@ -34376,8 +34385,8 @@ function database(path) {
   }
 }
 function codexFeature(codexHome) {
-  const path = join15(codexHome, "config.toml");
-  if (!existsSync13(path)) return status(false, "feature_disabled");
+  const path = join14(codexHome, "config.toml");
+  if (!existsSync12(path)) return status(false, "feature_disabled");
   try {
     const config2 = parseToml2(readFileSync7(path, "utf8"));
     if (!isRecord2(config2.features)) return status(false, "feature_disabled");
@@ -34388,7 +34397,7 @@ function codexFeature(codexHome) {
   }
 }
 function codexHooks(codexHome, nodePath, cliScriptPath) {
-  const value = JSON.parse(readFileSync7(join15(codexHome, "hooks.json"), "utf8"));
+  const value = JSON.parse(readFileSync7(join14(codexHome, "hooks.json"), "utf8"));
   if (!isRecord2(value) || !isRecord2(value.hooks)) throw Error("config_unreadable");
   const hooks = value.hooks;
   const present = (event, subcommand) => Array.isArray(hooks[event]) && hooks[event].some((entry) => isRecord2(entry) && Array.isArray(entry.hooks) && entry.hooks.some((item) => isRecord2(item) && typeof item.command === "string" && isCanonicalCaveatCodexHookCommand(item.command, subcommand, nodePath, cliScriptPath)));
@@ -34423,7 +34432,7 @@ function sync(own) {
     return unverified("upstream_unavailable");
   }
 }
-function factoryDiagnostics(ctx, codexHome = process.env.CODEX_HOME ?? join15(ctx.userHome, ".codex")) {
+function factoryDiagnostics(ctx, codexHome = process.env.CODEX_HOME ?? join14(ctx.userHome, ".codex")) {
   const nodePath = process.execPath;
   const cliScriptPath = process.argv[1] ?? "";
   const db = database(ctx.paths.dbPath);