@orquentra/codebuddy 2.6.2 → 2.8.0

package/dist/{chunk-QBDJXGG5.js → chunk-EJQVGFH2.js}

@@ -3,10 +3,16 @@ import {
   readHookInput,
   writeStdout
 } from "./chunk-FJOTP632.js";
+import {
+  recordTrace
+} from "./chunk-XL2HLACE.js";
+import {
+  hookRoot
+} from "./chunk-TGFTKWOR.js";
 import {
   extractSymbolTable,
   supportsSymbols
-} from "./chunk-PQK3GKZH.js";
+} from "./chunk-Y7D7PUBE.js";
 
 // src/hooks/pretool.ts
 import { open, stat } from "fs/promises";
@@ -39,6 +45,7 @@ async function decidePreTool(input, env = process.env) {
   const toolInput = input.tool_input ?? {};
   if (input.tool_name === "Grep") return capGrep(toolInput);
   if (input.tool_name === "Read") return guardRead(resolve(input.cwd ?? process.cwd()), toolInput);
+  if (input.tool_name === "Bash") return guardBash(resolve(input.cwd ?? process.cwd()), toolInput);
   return null;
 }
 function capGrep(toolInput) {
@@ -50,10 +57,7 @@ function capGrep(toolInput) {
     }
   };
 }
-async function guardRead(root, toolInput) {
-  if (toolInput.offset !== void 0 || toolInput.limit !== void 0) return null;
-  const filePath = toolInput.file_path;
-  if (typeof filePath !== "string" || !filePath) return null;
+async function largeFile(root, filePath) {
   const absolute = isAbsolute(filePath) ? resolve(filePath) : resolve(root, filePath);
   const rel = relative(root, absolute);
   if (rel === "" || rel === ".." || rel.startsWith(`..${sep}`) || isAbsolute(rel)) return null;
@@ -73,21 +77,71 @@ async function guardRead(root, toolInput) {
   if (lines.at(-1) === "") lines.pop();
   if (lines.length <= TOOL_GUARD.readLines && size <= TOOL_GUARD.readBytes) return null;
   const path = rel.replace(/\\/g, "/");
-  const outline = outlineOf(path, text, lines);
+  return { path, lines: lines.length, size, outline: outlineOf(path, text, lines) };
+}
+async function guardRead(root, toolInput) {
+  if (toolInput.offset !== void 0 || toolInput.limit !== void 0) return null;
+  const filePath = toolInput.file_path;
+  if (typeof filePath !== "string" || !filePath) return null;
+  const file = await largeFile(root, filePath);
+  if (!file) return null;
+  return deny(file, [
+    "Read only the part you need with offset and limit (offset = first line, limit = line count).",
+    "To find specific text, use Grep with output_mode content and -n instead of reading the file.",
+    `To read the whole file anyway, call Read again with limit: ${file.lines}.`
+  ]);
+}
+function deny(file, advice) {
   return {
     hookSpecificOutput: {
       hookEventName: "PreToolUse",
       permissionDecision: "deny",
       permissionDecisionReason: [
-        `CodeBuddy read guard: ${path} is ${lines.length} lines (~${Math.ceil(size / 4)} tokens), too large to read whole.`,
-        `Outline: ${outline.join("; ")}`,
-        "Read only the part you need with offset and limit (offset = first line, limit = line count).",
-        "To find specific text, use Grep with output_mode content and -n instead of reading the file.",
-        `To read the whole file anyway, call Read again with limit: ${lines.length}.`
+        `CodeBuddy read guard: ${file.path} is ${file.lines} lines (~${Math.ceil(file.size / 4)} tokens), too large to read whole.`,
+        `Outline: ${file.outline.join("; ")}`,
+        ...advice
       ].join("\n")
     }
   };
 }
+var WHOLE_FILE_PRINTERS = /* @__PURE__ */ new Set(["cat", "less", "more", "nl", "bat", "batcat"]);
+var SHELL_SYNTAX = /[|;&<>`$(){}*?[\]\n\\]/;
+async function guardBash(root, toolInput) {
+  const command = typeof toolInput.command === "string" ? toolInput.command.trim() : "";
+  if (!command || SHELL_SYNTAX.test(command)) return null;
+  const tokens = (command.match(/"[^"]*"|'[^']*'|\S+/g) ?? []).map(
+    (token) => token.replace(/^(["'])(.*)\1$/, "$2")
+  );
+  while (tokens[0] && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[0])) tokens.shift();
+  const program = (tokens.shift() ?? "").split("/").at(-1) ?? "";
+  const files = [];
+  if (WHOLE_FILE_PRINTERS.has(program)) {
+    for (const token of tokens) if (!token.startsWith("-")) files.push(token);
+  } else if (program === "head" || program === "tail") {
+    let lines = 10;
+    for (let index = 0; index < tokens.length; index += 1) {
+      const token = tokens[index] ?? "";
+      const count = /^-n$|^--lines$/.test(token) ? tokens[++index] : token.match(/^(?:-n|--lines=)\+?(\d+)$/)?.[1] ?? token.match(/^-(\d+)$/)?.[1];
+      if (count !== void 0 && /^\+?\d+$/.test(count)) lines = Number(count.replace("+", ""));
+      else if (token === "-f" || token === "-F" || token === "--follow") return null;
+      else if (!token.startsWith("-")) files.push(token);
+    }
+    if (lines <= TOOL_GUARD.readLines) return null;
+  } else {
+    return null;
+  }
+  for (const filePath of files) {
+    const file = await largeFile(root, filePath);
+    if (file) {
+      return deny(file, [
+        "Read only the part you need with the Read tool (offset = first line, limit = line count) or `sed -n 'START,ENDp' FILE`.",
+        "To find specific text, use Grep with output_mode content and -n instead of printing the file.",
+        `To read the whole file anyway, use Read with limit: ${file.lines}.`
+      ]);
+    }
+  }
+  return null;
+}
 async function readText(path) {
   const handle = await open(path, "r");
   try {
@@ -103,8 +157,12 @@ function outlineOf(path, text, lines) {
     ...entries.slice(0, TOOL_GUARD.outlineEntries),
     `\u2026 ${entries.length - TOOL_GUARD.outlineEntries} more`
   ] : entries;
-  if (supportsSymbols(path)) {
-    const table = extractSymbolTable(text).filter(
+  const all = supportsSymbols(path) ? extractSymbolTable(text, path) : [];
+  if (all[0]?.kind === "heading") {
+    return cap(all.map((heading) => `${heading.signature.slice(0, 80)} L${heading.startLine}`));
+  }
+  if (all.length > 0) {
+    const table = all.filter(
       (symbol) => symbol.endLine - symbol.startLine + 1 >= TOOL_GUARD.outlineMinSymbolLines
     );
     const topLevel = table.filter((symbol) => symbol.kind !== "method");
@@ -117,12 +175,6 @@ function outlineOf(path, text, lines) {
       ];
     }
   }
-  if (/\.mdx?$/i.test(path)) {
-    const headings = lines.flatMap(
-      (line, i) => /^#{1,4}\s+\S/.test(line) ? [`${line.trim().slice(0, 80)} L${i + 1}`] : []
-    );
-    if (headings.length > 0) return cap(headings);
-  }
   const blocks = [];
   for (let start = 1; start <= lines.length; start += TOOL_GUARD.blockLines) {
     blocks.push(`L${start}-${Math.min(lines.length, start + TOOL_GUARD.blockLines - 1)}`);
@@ -133,12 +185,31 @@ function outlineOf(path, text, lines) {
 // src/hooks/pretool-command.ts
 async function runPreToolHookCommand() {
   await failSoft(async () => {
-    const decision = await decidePreTool(await readHookInput());
-    if (decision) await writeStdout(JSON.stringify(decision));
+    const input = await readHookInput();
+    const decision = await decidePreTool(input);
+    if (!decision) return;
+    await writeStdout(JSON.stringify(decision));
+    const reason = decision.hookSpecificOutput.permissionDecisionReason;
+    if (decision.hookSpecificOutput.permissionDecision === "deny" && reason) {
+      const full = Number(reason.match(/\(~(\d+) tokens\)/)?.[1] ?? 0);
+      const outline = Math.ceil(reason.length / 4);
+      await recordTrace(hookRoot(input.cwd), {
+        kind: "guard",
+        name: input.tool_name ?? "tool",
+        ms: 0,
+        ok: true,
+        tokensOut: outline,
+        ...input.session_id ? { session: input.session_id } : {},
+        detail: {
+          file: reason.match(/read guard: (\S+) is/)?.[1] ?? "",
+          avoided: Math.max(0, full - outline)
+        }
+      });
+    }
   });
 }
 
 export {
   runPreToolHookCommand
 };
-//# sourceMappingURL=chunk-QBDJXGG5.js.map
+//# sourceMappingURL=chunk-EJQVGFH2.js.map

package/dist/chunk-EJQVGFH2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/pretool.ts","../src/hooks/pretool-command.ts"],"sourcesContent":["import { open, stat } from \"node:fs/promises\";\nimport { extname, isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { extractSymbolTable, supportsSymbols } from \"../indexer/symbols.js\";\nimport type { HookInput } from \"./runtime.js\";\n\n/**\n * PreToolUse tool guard (Claude Code): cut tool output that would otherwise\n * stay in context for the rest of the session, without touching permissions.\n *\n * - Read of a large file with no range → denied with an outline (symbols or\n *   headings with line ranges) and how to read a range or the whole file.\n *   The model sees the deny reason; any Read with offset/limit passes.\n * - Grep in content mode with no head_limit → the same input plus a limit.\n * - Bash that only prints a large file whole (`cat`, `less`, `head -n 5000`) →\n *   denied the same way; any other command (pipes, builds, tests) passes.\n *\n * Never emits `permissionDecision: \"allow\"`: Claude Code checks permissions on\n * the (possibly rewritten) input as usual. Verified on Claude Code 2.1.287.\n */\n/**\n * Only files whose full read is clearly expensive: below this, an agent that\n * re-reads the whole file after the outline (observed live) costs a turn for\n * nothing.\n */\nexport const TOOL_GUARD = {\n  readLines: 1_000,\n  readBytes: 80_000,\n  /** Symbols shorter than this are noise in an outline (one-line constants). */\n  outlineMinSymbolLines: 3,\n  /** Fewer top-level symbols than this: list class methods too. */\n  minTopLevelEntries: 10,\n  outlineEntries: 40,\n  blockLines: 100,\n  grepHeadLimit: 100,\n} as const;\n\n/** Read renders these itself (images, PDFs, notebooks); never guard them. */\nconst SPECIAL_READ = new Set([\n  \".png\",\n  \".jpg\",\n  \".jpeg\",\n  \".gif\",\n  \".webp\",\n  \".bmp\",\n  \".svg\",\n  \".pdf\",\n  \".ipynb\",\n]);\nconst MAX_GUARD_BYTES = 2_000_000;\n\nexport type PreToolDecision = {\n  hookSpecificOutput: {\n    hookEventName: \"PreToolUse\";\n    permissionDecision?: \"deny\";\n    permissionDecisionReason?: string;\n    updatedInput?: Record<string, unknown>;\n  };\n} | null;\n\nexport async function decidePreTool(\n  input: HookInput,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<PreToolDecision> {\n  if (env.CODEBUDDY_TOOL_GUARD === \"0\") return null;\n  const toolInput = input.tool_input ?? {};\n  if (input.tool_name === \"Grep\") return capGrep(toolInput);\n  if (input.tool_name === \"Read\") return guardRead(resolve(input.cwd ?? process.cwd()), toolInput);\n  if (input.tool_name === \"Bash\") return guardBash(resolve(input.cwd ?? process.cwd()), toolInput);\n  return null;\n}\n\nfunction capGrep(toolInput: Record<string, unknown>): PreToolDecision {\n  if (toolInput.output_mode !== \"content\" || toolInput.head_limit !== undefined) return null;\n  return {\n    hookSpecificOutput: {\n      hookEventName: \"PreToolUse\",\n      updatedInput: { ...toolInput, head_limit: TOOL_GUARD.grepHeadLimit },\n    },\n  };\n}\n\n/** A file inside the repository too large to read whole, with its outline; else null. */\nexport async function largeFile(\n  root: string,\n  filePath: string,\n): Promise<{ path: string; lines: number; size: number; outline: string[] } | null> {\n  const absolute = isAbsolute(filePath) ? resolve(filePath) : resolve(root, filePath);\n  const rel = relative(root, absolute);\n  if (rel === \"\" || rel === \"..\" || rel.startsWith(`..${sep}`) || isAbsolute(rel)) return null;\n  if (SPECIAL_READ.has(extname(absolute).toLowerCase())) return null;\n  let size: number;\n  try {\n    const info = await stat(absolute);\n    if (!info.isFile()) return null;\n    size = info.size;\n  } catch {\n    return null;\n  }\n  if (size > MAX_GUARD_BYTES) return null; // Read refuses huge files itself.\n  const text = await readText(absolute);\n  if (text === null) return null;\n  const lines = text.split(/\\r?\\n/);\n  if (lines.at(-1) === \"\") lines.pop();\n  if (lines.length <= TOOL_GUARD.readLines && size <= TOOL_GUARD.readBytes) return null;\n  const path = rel.replace(/\\\\/g, \"/\");\n  return { path, lines: lines.length, size, outline: outlineOf(path, text, lines) };\n}\n\nasync function guardRead(\n  root: string,\n  toolInput: Record<string, unknown>,\n): Promise<PreToolDecision> {\n  if (toolInput.offset !== undefined || toolInput.limit !== undefined) return null;\n  const filePath = toolInput.file_path;\n  if (typeof filePath !== \"string\" || !filePath) return null;\n  const file = await largeFile(root, filePath);\n  if (!file) return null;\n  return deny(file, [\n    \"Read only the part you need with offset and limit (offset = first line, limit = line count).\",\n    \"To find specific text, use Grep with output_mode content and -n instead of reading the file.\",\n    `To read the whole file anyway, call Read again with limit: ${file.lines}.`,\n  ]);\n}\n\nfunction deny(\n  file: { path: string; lines: number; size: number; outline: string[] },\n  advice: string[],\n): PreToolDecision {\n  return {\n    hookSpecificOutput: {\n      hookEventName: \"PreToolUse\",\n      permissionDecision: \"deny\",\n      permissionDecisionReason: [\n        `CodeBuddy read guard: ${file.path} is ${file.lines} lines (~${Math.ceil(file.size / 4)} tokens), too large to read whole.`,\n        `Outline: ${file.outline.join(\"; \")}`,\n        ...advice,\n      ].join(\"\\n\"),\n    },\n  };\n}\n\n/** Programs that print whole files; `head`/`tail` only when asked for more lines than the guard. */\nconst WHOLE_FILE_PRINTERS = new Set([\"cat\", \"less\", \"more\", \"nl\", \"bat\", \"batcat\"]);\n/**\n * Anything that makes a command more than one plain read: pipes, lists,\n * redirection, substitution, globbing over many files. Such commands are never\n * touched, so builds, tests, pipelines and scripts behave exactly as before.\n */\nconst SHELL_SYNTAX = /[|;&<>`$(){}*?[\\]\\n\\\\]/;\n\n/**\n * Bash that would print a large file whole (`cat src/big.ts`, `head -n 5000 x`).\n * Claude reads files through Bash to get around the Read guard; the output then\n * stays in context for the rest of the session. Only a single plain read\n * command of a file over the Read guard's size is denied, with the same outline\n * and how to read a range; every other command passes untouched.\n */\nasync function guardBash(\n  root: string,\n  toolInput: Record<string, unknown>,\n): Promise<PreToolDecision> {\n  const command = typeof toolInput.command === \"string\" ? toolInput.command.trim() : \"\";\n  if (!command || SHELL_SYNTAX.test(command)) return null;\n  const tokens = (command.match(/\"[^\"]*\"|'[^']*'|\\S+/g) ?? []).map((token) =>\n    token.replace(/^([\"'])(.*)\\1$/, \"$2\"),\n  );\n  // Leading `VAR=value` assignments do not change what runs.\n  while (tokens[0] && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[0])) tokens.shift();\n  const program = (tokens.shift() ?? \"\").split(\"/\").at(-1) ?? \"\";\n  const files: string[] = [];\n  if (WHOLE_FILE_PRINTERS.has(program)) {\n    for (const token of tokens) if (!token.startsWith(\"-\")) files.push(token);\n  } else if (program === \"head\" || program === \"tail\") {\n    let lines = 10;\n    for (let index = 0; index < tokens.length; index += 1) {\n      const token = tokens[index] ?? \"\";\n      const count = /^-n$|^--lines$/.test(token)\n        ? tokens[++index]\n        : (token.match(/^(?:-n|--lines=)\\+?(\\d+)$/)?.[1] ?? token.match(/^-(\\d+)$/)?.[1]);\n      if (count !== undefined && /^\\+?\\d+$/.test(count)) lines = Number(count.replace(\"+\", \"\"));\n      else if (token === \"-f\" || token === \"-F\" || token === \"--follow\") return null;\n      else if (!token.startsWith(\"-\")) files.push(token);\n    }\n    if (lines <= TOOL_GUARD.readLines) return null;\n  } else {\n    return null;\n  }\n  for (const filePath of files) {\n    const file = await largeFile(root, filePath);\n    if (file) {\n      return deny(file, [\n        \"Read only the part you need with the Read tool (offset = first line, limit = line count) or `sed -n 'START,ENDp' FILE`.\",\n        \"To find specific text, use Grep with output_mode content and -n instead of printing the file.\",\n        `To read the whole file anyway, use Read with limit: ${file.lines}.`,\n      ]);\n    }\n  }\n  return null;\n}\n\n/** Whole file as UTF-8 text, or null when it looks binary. */\nasync function readText(path: string): Promise<string | null> {\n  const handle = await open(path, \"r\");\n  try {\n    const content = await handle.readFile();\n    if (content.includes(0)) return null;\n    return content.toString(\"utf8\");\n  } finally {\n    await handle.close();\n  }\n}\n\nfunction outlineOf(path: string, text: string, lines: string[]): string[] {\n  const cap = (entries: string[]) =>\n    entries.length > TOOL_GUARD.outlineEntries\n      ? [\n          ...entries.slice(0, TOOL_GUARD.outlineEntries),\n          `… ${entries.length - TOOL_GUARD.outlineEntries} more`,\n        ]\n      : entries;\n  const all = supportsSymbols(path) ? extractSymbolTable(text, path) : [];\n  if (all[0]?.kind === \"heading\") {\n    return cap(all.map((heading) => `${heading.signature.slice(0, 80)} L${heading.startLine}`));\n  }\n  if (all.length > 0) {\n    const table = all.filter(\n      (symbol) => symbol.endLine - symbol.startLine + 1 >= TOOL_GUARD.outlineMinSymbolLines,\n    );\n    const topLevel = table.filter((symbol) => symbol.kind !== \"method\");\n    // One big class says little on its own; then list its methods (`Class.method`).\n    const symbols = topLevel.length >= TOOL_GUARD.minTopLevelEntries ? topLevel : table;\n    if (symbols.length > 0) {\n      // The symbol table is capped, so say where the outline stops covering the file.\n      const covered = Math.max(...symbols.map((symbol) => symbol.endLine));\n      return [\n        ...cap(symbols.map((s) => `${s.name} L${s.startLine}-${s.endLine}`)),\n        ...(covered < lines.length ? [`not outlined L${covered + 1}-${lines.length}`] : []),\n      ];\n    }\n  }\n  const blocks: string[] = [];\n  for (let start = 1; start <= lines.length; start += TOOL_GUARD.blockLines) {\n    blocks.push(`L${start}-${Math.min(lines.length, start + TOOL_GUARD.blockLines - 1)}`);\n  }\n  return cap(blocks);\n}\n","import { recordTrace } from \"../tracing/log.js\";\nimport { decidePreTool } from \"./pretool.js\";\nimport { hookRoot } from \"./root.js\";\nimport { failSoft, readHookInput, writeStdout } from \"./stdio.js\";\n\n/** `codebuddy hooks pretool`: runs on every Read/Grep, so it loads only its own module. */\nexport async function runPreToolHookCommand(): Promise<void> {\n  await failSoft(async () => {\n    const input = await readHookInput();\n    const decision = await decidePreTool(input);\n    if (!decision) return;\n    await writeStdout(JSON.stringify(decision));\n    const reason = decision.hookSpecificOutput.permissionDecisionReason;\n    if (decision.hookSpecificOutput.permissionDecision === \"deny\" && reason) {\n      // Measured, not modelled: the file the agent did not load whole, minus the\n      // outline it got instead. Shown by `codebuddy dashboard`.\n      const full = Number(reason.match(/\\(~(\\d+) tokens\\)/)?.[1] ?? 0);\n      const outline = Math.ceil(reason.length / 4);\n      await recordTrace(hookRoot(input.cwd), {\n        kind: \"guard\",\n        name: input.tool_name ?? \"tool\",\n        ms: 0,\n        ok: true,\n        tokensOut: outline,\n        ...(input.session_id ? { session: input.session_id } : {}),\n        detail: {\n          file: reason.match(/read guard: (\\S+) is/)?.[1] ?? \"\",\n          avoided: Math.max(0, full - outline),\n        },\n      });\n    }\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-5MQOE4J6.js → chunk-ESZXCZIN.js}

@@ -1,9 +1,9 @@
 import {
   redactLlmKeys
-} from "./chunk-RAJJSCIP.js";
+} from "./chunk-SFMIMLXR.js";
 import {
   writeAtomic
-} from "./chunk-5KZY6OTG.js";
+} from "./chunk-CG5B3LYG.js";
 
 // src/llm/budget.ts
 import { mkdir, readFile } from "fs/promises";
@@ -196,4 +196,4 @@ export {
   coolingDown,
   chatJson
 };
-//# sourceMappingURL=chunk-5MQOE4J6.js.map
+//# sourceMappingURL=chunk-ESZXCZIN.js.map

package/dist/{chunk-J2EAZ4MA.js → chunk-GKNYMNFM.js}

@@ -1,10 +1,10 @@
 import {
   countTokens,
   generateEntityId
-} from "./chunk-XBJQKCLU.js";
+} from "./chunk-CAEPHLHC.js";
 import {
   writeAtomic
-} from "./chunk-5KZY6OTG.js";
+} from "./chunk-CG5B3LYG.js";
 
 // src/savings/tokens.ts
 function estimateTokens(value) {
@@ -262,32 +262,26 @@ function digest(text) {
   return createHash("sha256").update(text).digest("hex");
 }
 
-// src/hooks/root.ts
-import { existsSync } from "fs";
-import { dirname, join as join2, resolve as resolve2 } from "path";
-function hookRoot(cwd, env = process.env) {
-  if (env.CLAUDE_PROJECT_DIR) return resolve2(env.CLAUDE_PROJECT_DIR);
-  const start = resolve2(cwd ?? process.cwd());
-  for (let dir = start; ; dir = dirname(dir)) {
-    if (existsSync(join2(dir, ".codebuddy", "config.json"))) return dir;
-    if (dirname(dir) === dir) return start;
-  }
-}
-
 // src/context/tests.ts
 import { access, readFile as readFile2 } from "fs/promises";
-import { basename, dirname as dirname2, extname, join as join3 } from "path";
+import { basename, dirname, extname, join as join2 } from "path";
 function findCoveringTest(path, paths) {
+  return coveringTestCandidates(path).find((candidate) => paths.has(candidate)) ?? null;
+}
+function coveringTestCandidates(path) {
   const ext = extname(path);
   const stem = basename(path, ext);
-  const dir = dirname2(path);
+  const dir = dirname(path);
   const join22 = (...parts) => parts.filter((part) => part && part !== ".").join("/");
   const mirrored = dir.replace(/^(src|lib|app)(\/|$)/, "");
-  const candidates = ext === ".py" ? [
+  return ext === ".py" ? [
     join22(dir, `test_${stem}.py`),
-    join22("tests", `test_${stem}.py`),
+    join22(dir, `${stem}_test.py`),
     join22(dir, "tests", `test_${stem}.py`),
-    join22(dir, `${stem}_test.py`)
+    // `src/pkg/sub/x.py` → `tests/pkg/sub/test_x.py`, `tests/sub/test_x.py`, `tests/test_x.py`.
+    join22("tests", mirrored, `test_${stem}.py`),
+    join22("tests", mirrored.replace(/^[^/]+\/?/, ""), `test_${stem}.py`),
+    join22("tests", `test_${stem}.py`)
   ] : ext === ".go" ? [join22(dir, `${stem}_test.go`)] : [
     join22(dir, `${stem}.test${ext}`),
     join22(dir, `${stem}.spec${ext}`),
@@ -296,20 +290,23 @@ function findCoveringTest(path, paths) {
     join22("test", mirrored, `${stem}.test${ext}`),
     join22("tests", mirrored, `${stem}.test${ext}`)
   ];
-  return candidates.find((candidate) => paths.has(candidate)) ?? null;
 }
 var NPM_PLACEHOLDER = /no test specified/;
 async function detectTestCommand(repositoryRoot) {
-  const exists = (file) => access(join3(repositoryRoot, file)).then(
+  const exists = (file) => access(join2(repositoryRoot, file)).then(
     () => true,
     () => false
   );
   try {
-    const pkg = JSON.parse(await readFile2(join3(repositoryRoot, "package.json"), "utf8"));
+    const pkg = JSON.parse(await readFile2(join2(repositoryRoot, "package.json"), "utf8"));
     const script = pkg.scripts?.test;
     if (typeof script === "string" && script.trim() && !NPM_PLACEHOLDER.test(script)) {
+      const declared = typeof pkg.packageManager === "string" ? pkg.packageManager.split(/[\s@]/, 1)[0] : "";
+      if (declared === "bun") return "bun run test";
+      if (declared && ["npm", "pnpm", "yarn"].includes(declared)) return `${declared} test`;
       if (await exists("pnpm-lock.yaml")) return "pnpm test";
       if (await exists("yarn.lock")) return "yarn test";
+      if (await exists("bun.lockb") || await exists("bun.lock")) return "bun run test";
       return "npm test";
     }
   } catch {
@@ -326,7 +323,7 @@ export {
   estimateTokens,
   SessionCapsuleLedger,
   findCoveringTest,
-  detectTestCommand,
-  hookRoot
+  coveringTestCandidates,
+  detectTestCommand
 };
-//# sourceMappingURL=chunk-J2EAZ4MA.js.map
+//# sourceMappingURL=chunk-GKNYMNFM.js.map

package/dist/chunk-GKNYMNFM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/savings/tokens.ts","../src/context/session-ledger.ts","../src/context/tests.ts"],"sourcesContent":["import { countTokens } from \"../planner/budget.js\";\n\n/**\n * The one place token counts are computed. Strings use the same deterministic\n * cl100k tokenizer as planner budgets; objects are measured by their JSON\n * serialization, which matches how they travel over MCP.\n */\n\nexport function estimateTokens(value: unknown): number {\n  if (value === undefined || value === null) return 0;\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  if (!text) return 0;\n  return countTokens(text);\n}\n","import { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, rm, stat } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { generateEntityId } from \"../core/ids.js\";\nimport { writeAtomic } from \"../core/markdown-store-fs.js\";\nimport { estimateTokens } from \"../savings/tokens.js\";\n\nconst VERSION = 2;\nconst MAX_CAPSULES = 128;\nconst MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;\nconst MAX_PENDING = 8;\nconst PENDING_MAX_AGE_MS = 24 * 60 * 60 * 1000;\nconst STALE_LOCK_MS = 60_000;\n/** Acknowledged versions kept per section, so switching back to a task reuses them. */\nconst MAX_ACKNOWLEDGED_PER_KEY = 8;\n\ntype LedgerRecord = { hash: string; lastSentAt: string };\n/** A delivery sent to a client that has not yet confirmed receipt. */\ntype PendingDelivery = { createdAt: string; records: Record<string, string> };\n/** One acknowledged version of an `exchange` section: content hash and when it was sent. */\ntype AcknowledgedVersion = { hash: string; sentAt: string };\ntype LedgerFile = {\n  version: 2;\n  updatedAt: string;\n  /** `deliver`/`markSent` capsules (hooks): one current hash per key. */\n  records: Record<string, LedgerRecord>;\n  pending?: Record<string, PendingDelivery>;\n  /** `exchange` sections (MCP): every recently acknowledged version, newest first. */\n  acknowledged?: Record<string, AcknowledgedVersion[]>;\n};\n\nexport type ContextCapsule = { key: string; text: string };\nexport type CapsuleDelivery = {\n  /** Full text of new or changed capsules, in input order. */\n  lines: string[];\n  /** Keys of capsules already sent this session and not resent. */\n  unchanged: string[];\n  full: number;\n  referenced: number;\n  sentTokens: number;\n  avoidedTokens: number;\n};\n\nexport type SectionHash = { key: string; hash: string };\nexport type AcknowledgedExchange = {\n  deliveryId: string;\n  /** Keys whose content the client confirmed receiving and that have not changed. */\n  unchanged: string[];\n  ack: \"none\" | \"accepted\" | \"unknown\";\n};\n\nexport class SessionCapsuleLedger {\n  private readonly directory: string;\n\n  constructor(repositoryRoot = process.cwd()) {\n    this.directory = join(resolve(repositoryRoot), \".codebuddy\", \"cache\", \"session\");\n  }\n\n  async deliver(\n    sessionId: string,\n    capsules: ContextCapsule[],\n    now = new Date(),\n  ): Promise<CapsuleDelivery> {\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      const lines: string[] = [];\n      const unchanged: string[] = [];\n      let full = 0;\n      let referenced = 0;\n      let sentTokens = 0;\n      let avoidedTokens = 0;\n\n      for (const capsule of capsules) {\n        const hash = digest(capsule.text);\n        const existing = ledger.records[capsule.key];\n        if (existing?.hash === hash) {\n          unchanged.push(capsule.key);\n          referenced++;\n          avoidedTokens += estimateTokens(capsule.text);\n        } else {\n          lines.push(capsule.text);\n          full++;\n          sentTokens += estimateTokens(capsule.text);\n        }\n        ledger.records[capsule.key] = { hash, lastSentAt: now.toISOString() };\n      }\n\n      await this.write(path, ledger, now);\n      return { lines, unchanged, full, referenced, sentTokens, avoidedTokens };\n    } finally {\n      await release();\n    }\n  }\n\n  /** Keys of capsules whose current text was already recorded as sent this session. */\n  async seen(\n    sessionId: string,\n    capsules: ContextCapsule[],\n    now = new Date(),\n  ): Promise<Set<string>> {\n    const ledger = await this.read(this.path(sessionId), now);\n    return new Set(\n      capsules\n        .filter((capsule) => ledger.records[capsule.key]?.hash === digest(capsule.text))\n        .map((capsule) => capsule.key),\n    );\n  }\n\n  /**\n   * Record capsules as delivered. Call only after their text actually reached\n   * the client, so capsules that were clipped or failed to write stay unseen\n   * and are delivered by a later prompt.\n   */\n  async markSent(sessionId: string, capsules: ContextCapsule[], now = new Date()): Promise<void> {\n    if (capsules.length === 0) return;\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      for (const capsule of capsules) {\n        ledger.records[capsule.key] = { hash: digest(capsule.text), lastSentAt: now.toISOString() };\n      }\n      await this.write(path, ledger, now);\n    } finally {\n      await release();\n    }\n  }\n\n  /**\n   * Acknowledged delivery for clients that can lose context (MCP). Unlike\n   * `deliver`, sending marks nothing as seen: the sent hashes are held as a\n   * pending delivery until the client echoes its `deliveryId` back as `ack` on\n   * a later call. Only acknowledged, unchanged sections sent within `ttlMs` are\n   * reported unchanged, so a dropped response or a compacted client context\n   * fails safe to a full resend.\n   *\n   * A section keeps its last few acknowledged versions (by content hash), not\n   * just the latest, so returning to an earlier task in the same session does\n   * not resend what the client already holds. `full` means the client lost its\n   * context: every acknowledged version and unconfirmed delivery is forgotten.\n   */\n  async exchange(\n    sessionId: string,\n    sections: SectionHash[],\n    options: {\n      ack?: string;\n      ttlMs: number;\n      /** The client lost its context: nothing acknowledged before this call counts. */\n      full?: boolean;\n      now?: Date;\n      /** Finalize the response before recording hashes of the actual sent sections. */\n      prepare?: (exchange: AcknowledgedExchange) => SectionHash[];\n    },\n  ): Promise<AcknowledgedExchange> {\n    const now = options.now ?? new Date();\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      const path = this.path(sessionId);\n      const ledger = await this.read(path, now);\n      let pending = ledger.pending ?? {};\n      let acknowledged = ledger.acknowledged ?? {};\n\n      let ack: AcknowledgedExchange[\"ack\"] = \"none\";\n      if (options.ack !== undefined) {\n        const confirmed = pending[options.ack];\n        if (confirmed) {\n          for (const [key, hash] of Object.entries(confirmed.records)) {\n            acknowledged[key] = [\n              { hash, sentAt: confirmed.createdAt },\n              ...(acknowledged[key] ?? []).filter((version) => version.hash !== hash),\n            ]\n              .sort((left, right) => right.sentAt.localeCompare(left.sentAt))\n              .slice(0, MAX_ACKNOWLEDGED_PER_KEY);\n          }\n          delete pending[options.ack];\n          ack = \"accepted\";\n        } else {\n          ack = \"unknown\";\n        }\n      }\n      if (options.full) {\n        acknowledged = {};\n        pending = {};\n      }\n\n      const unchanged: string[] = [];\n      const sent: Record<string, string> = {};\n      for (const section of sections) {\n        const held = acknowledged[section.key]?.some((version) => {\n          const age = now.getTime() - Date.parse(version.sentAt);\n          return version.hash === section.hash && age >= 0 && age <= options.ttlMs;\n        });\n        if (held) {\n          unchanged.push(section.key);\n        } else {\n          sent[section.key] = section.hash;\n        }\n      }\n\n      const deliveryId = generateEntityId(\"dlv\", now.getTime());\n      const exchange = { deliveryId, unchanged, ack };\n      const delivered = options.prepare?.(exchange);\n      pending[deliveryId] = {\n        createdAt: now.toISOString(),\n        records: delivered\n          ? Object.fromEntries(delivered.map(({ key, hash }) => [key, hash]))\n          : sent,\n      };\n      ledger.pending = Object.fromEntries(\n        Object.entries(pending)\n          .filter(([, item]) => now.getTime() - Date.parse(item.createdAt) <= PENDING_MAX_AGE_MS)\n          .sort((left, right) => right[1].createdAt.localeCompare(left[1].createdAt))\n          .slice(0, MAX_PENDING),\n      );\n      ledger.acknowledged = Object.fromEntries(\n        Object.entries(acknowledged)\n          .map(([key, versions]): [string, AcknowledgedVersion[]] => [\n            key,\n            versions.filter((version) => now.getTime() - Date.parse(version.sentAt) <= MAX_AGE_MS),\n          ])\n          .filter(([, versions]) => versions.length > 0)\n          .slice(0, MAX_CAPSULES),\n      );\n      await this.write(path, ledger, now);\n      return { deliveryId, unchanged, ack };\n    } finally {\n      await release();\n    }\n  }\n\n  /** Forget everything sent in a session, e.g. after the client compacted its context. */\n  async reset(sessionId: string): Promise<void> {\n    await mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const release = await this.acquire(sessionId);\n    try {\n      await rm(this.path(sessionId), { force: true });\n    } finally {\n      await release();\n    }\n  }\n\n  /** Remove expired disposable state; locked sessions are left for the next pass. */\n  async pruneExpired(now = new Date()): Promise<number> {\n    let removed = 0;\n    for (const entry of await readdir(this.directory).catch(() => [])) {\n      if (!entry.endsWith(\".json\")) continue;\n      const path = join(this.directory, entry);\n      try {\n        await stat(`${path}.lock`);\n        continue;\n      } catch {\n        // No active lock.\n      }\n      try {\n        const metadata = await stat(path);\n        if (now.getTime() - metadata.mtimeMs > MAX_AGE_MS) {\n          await rm(path, { force: true });\n          removed++;\n        }\n      } catch {\n        // Another cleanup may have removed it already.\n      }\n    }\n    return removed;\n  }\n\n  private async write(path: string, ledger: LedgerFile, now: Date): Promise<void> {\n    ledger.updatedAt = now.toISOString();\n    ledger.records = Object.fromEntries(\n      Object.entries(ledger.records)\n        .sort((left, right) => right[1].lastSentAt.localeCompare(left[1].lastSentAt))\n        .slice(0, MAX_CAPSULES),\n    );\n    await writeAtomic(path, `${JSON.stringify(ledger, null, 2)}\\n`);\n  }\n\n  private async read(path: string, now: Date): Promise<LedgerFile> {\n    try {\n      const parsed = JSON.parse(await readFile(path, \"utf8\")) as LedgerFile;\n      if (parsed.version !== VERSION || typeof parsed.records !== \"object\") return empty(now);\n      const records = Object.fromEntries(\n        Object.entries(parsed.records).filter(([, record]) => {\n          const age = now.getTime() - Date.parse(record.lastSentAt);\n          return Number.isFinite(age) && age <= MAX_AGE_MS;\n        }),\n      );\n      const pending =\n        parsed.pending && typeof parsed.pending === \"object\" ? parsed.pending : undefined;\n      const acknowledged =\n        parsed.acknowledged && typeof parsed.acknowledged === \"object\"\n          ? Object.fromEntries(\n              Object.entries(parsed.acknowledged).filter(([, versions]) => Array.isArray(versions)),\n            )\n          : undefined;\n      return {\n        version: VERSION,\n        updatedAt: parsed.updatedAt,\n        records,\n        ...(pending ? { pending } : {}),\n        ...(acknowledged ? { acknowledged } : {}),\n      };\n    } catch {\n      return empty(now);\n    }\n  }\n\n  private path(sessionId: string): string {\n    // The full identity participates in the key. Legacy sanitized filenames\n    // are intentionally ignored, so a fresh session cannot inherit collisions.\n    return join(this.directory, `${digest(sessionId)}.json`);\n  }\n\n  private async acquire(sessionId: string): Promise<() => Promise<void>> {\n    const lock = `${this.path(sessionId)}.lock`;\n    for (let attempt = 0; ; attempt++) {\n      try {\n        await mkdir(lock);\n        return async () => rm(lock, { recursive: true, force: true });\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== \"EEXIST\" || attempt >= 200) throw error;\n        try {\n          const age = Date.now() - (await stat(lock)).mtimeMs;\n          if (age > STALE_LOCK_MS) {\n            await rm(lock, { recursive: true, force: true });\n            continue;\n          }\n        } catch {\n          // The owner may have released the lock between checks.\n        }\n        await new Promise((resolveWait) => setTimeout(resolveWait, 10));\n      }\n    }\n  }\n}\n\nfunction empty(now: Date): LedgerFile {\n  return { version: VERSION, updatedAt: now.toISOString(), records: {} };\n}\n\nfunction digest(text: string): string {\n  return createHash(\"sha256\").update(text).digest(\"hex\");\n}\n","import { access, readFile } from \"node:fs/promises\";\nimport { basename, dirname, extname, join } from \"node:path\";\n\n/**\n * Which test covers a file and how this repo runs its tests, from naming\n * conventions and project markers only. Agents otherwise spend turns finding\n * both; a wrong guess costs one failed command, so first match wins.\n */\nexport function findCoveringTest(path: string, paths: ReadonlySet<string>): string | null {\n  return coveringTestCandidates(path).find((candidate) => paths.has(candidate)) ?? null;\n}\n\n/** Conventional covering-test paths for `path`, most specific first. */\nexport function coveringTestCandidates(path: string): string[] {\n  const ext = extname(path);\n  const stem = basename(path, ext);\n  const dir = dirname(path);\n  const join2 = (...parts: string[]) => parts.filter((part) => part && part !== \".\").join(\"/\");\n  // `src/a/x.ts` mirrors to `test/a/x.test.ts`: drop a leading source root.\n  const mirrored = dir.replace(/^(src|lib|app)(\\/|$)/, \"\");\n  return ext === \".py\"\n    ? [\n        join2(dir, `test_${stem}.py`),\n        join2(dir, `${stem}_test.py`),\n        join2(dir, \"tests\", `test_${stem}.py`),\n        // `src/pkg/sub/x.py` → `tests/pkg/sub/test_x.py`, `tests/sub/test_x.py`, `tests/test_x.py`.\n        join2(\"tests\", mirrored, `test_${stem}.py`),\n        join2(\"tests\", mirrored.replace(/^[^/]+\\/?/, \"\"), `test_${stem}.py`),\n        join2(\"tests\", `test_${stem}.py`),\n      ]\n    : ext === \".go\"\n      ? [join2(dir, `${stem}_test.go`)]\n      : [\n          join2(dir, `${stem}.test${ext}`),\n          join2(dir, `${stem}.spec${ext}`),\n          join2(dir, \"__tests__\", `${stem}.test${ext}`),\n          join2(dir, \"__tests__\", `${stem}${ext}`),\n          join2(\"test\", mirrored, `${stem}.test${ext}`),\n          join2(\"tests\", mirrored, `${stem}.test${ext}`),\n        ];\n}\n\nconst NPM_PLACEHOLDER = /no test specified/;\n\nexport async function detectTestCommand(repositoryRoot: string): Promise<string | null> {\n  const exists = (file: string) =>\n    access(join(repositoryRoot, file)).then(\n      () => true,\n      () => false,\n    );\n  try {\n    const pkg = JSON.parse(await readFile(join(repositoryRoot, \"package.json\"), \"utf8\")) as {\n      scripts?: Record<string, unknown>;\n      packageManager?: unknown;\n    };\n    const script = pkg.scripts?.test;\n    if (typeof script === \"string\" && script.trim() && !NPM_PLACEHOLDER.test(script)) {\n      const declared =\n        typeof pkg.packageManager === \"string\" ? pkg.packageManager.split(/[\\s@]/, 1)[0] : \"\";\n      // `bun test` is Bun's own runner, not the package's test script.\n      if (declared === \"bun\") return \"bun run test\";\n      if (declared && [\"npm\", \"pnpm\", \"yarn\"].includes(declared)) return `${declared} test`;\n      if (await exists(\"pnpm-lock.yaml\")) return \"pnpm test\";\n      if (await exists(\"yarn.lock\")) return \"yarn test\";\n      if ((await exists(\"bun.lockb\")) || (await exists(\"bun.lock\"))) return \"bun run test\";\n      return \"npm test\";\n    }\n  } catch {\n    // No or unreadable package.json: try other ecosystems.\n  }\n  for (const marker of [\"pyproject.toml\", \"pytest.ini\", \"setup.cfg\"]) {\n    if (await exists(marker)) return \"pytest\";\n  }\n  if (await exists(\"go.mod\")) return \"go test ./...\";\n  if (await exists(\"Cargo.toml\")) return \"cargo test\";\n  return null;\n}\n"],"mappings":"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","names":["readFile","join","join2"]}

package/dist/{chunk-5FW3PMNP.js → chunk-GXOML4UZ.js}

@@ -1,11 +1,16 @@
 import {
-  readConfigFile,
+  asksForChangelog
+} from "./chunk-TLWGZVPC.js";
+import {
+  readConfigFile
+} from "./chunk-KNR2P2UY.js";
+import {
   writeAtomic
-} from "./chunk-5KZY6OTG.js";
+} from "./chunk-CG5B3LYG.js";
 
 // src/retrieval/zvec.ts
 import { execFile, spawn } from "child_process";
-import { mkdir, readFile, rm, stat } from "fs/promises";
+import { mkdir, readFile, rm, stat, writeFile } from "fs/promises";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "path";
 var SUPPORTED = /^0\.2\.\d+$/;
 var DEFAULT_TIMEOUT_MS = 1500;
@@ -13,7 +18,18 @@ var READY_CACHE_MS = 10 * 6e4;
 var NOT_READY_CACHE_MS = 3e4;
 var REFRESH_TIMEOUT_MS = 10 * 6e4;
 var DEFAULT_ZVEC_MODEL = "local/potion-code-16m-v2";
-var DOC_GLOBS = ["!**/*.md", "!**/*.mdx", "!docs/**"];
+var DEFAULT_ZVEC_MIN_SCORE = 0.3;
+var DOC_GLOBS = ["!**/*.md", "!**/*.mdx", "!**/*.rst", "!**/*.adoc", "!docs/**"];
+var CHANGELOG_GLOBS = [
+  "!**/CHANGES*",
+  "!**/CHANGELOG*",
+  "!**/HISTORY*",
+  "!**/NEWS*",
+  "!**/RELEASE*",
+  "!**/changelog*",
+  "!**/Changelog*",
+  "!**/ChangeLog*"
+];
 var TEST_GLOBS = [
   "!**/*.test.*",
   "!**/*.spec.*",
@@ -26,6 +42,7 @@ function zvecExcludeGlobs(task) {
   return [
     .../\b(docs?|readme|documentation|markdown)\b/i.test(task) ? [] : DOC_GLOBS,
     .../\b(tests?|spec)\b/i.test(task) ? [] : TEST_GLOBS,
+    ...asksForChangelog(task) ? [] : CHANGELOG_GLOBS,
     ...ALWAYS_EXCLUDED_GLOBS
   ];
 }
@@ -34,14 +51,25 @@ async function zvecCandidates(repositoryRoot, task, options = {}) {
   const root = resolve(repositoryRoot);
   const config = await zvecConfig(root);
   if (!config.enabled) return none("disabled", "zvec-grep not enabled");
-  const run = (args) => runZg(config.binary, args, root, config.timeoutMs);
+  const { deadlineAt } = options;
+  const run = (args) => {
+    const ms = deadlineAt === void 0 ? config.timeoutMs : Math.min(config.timeoutMs, deadlineAt - Date.now());
+    if (ms <= 0) return Promise.resolve({ stdout: "", error: deadlineError() });
+    return runZg(config.binary, args, root, ms);
+  };
+  const missedDeadline = (status) => deadlineAt !== void 0 && status === "timeout" && Date.now() >= deadlineAt - 5;
   const cached = await readCachedReadiness(root, config.binary);
   if (cached !== "ready") {
     if (cached) return cached;
     const readiness = await checkReadiness(run);
-    await markReadiness(root, config.binary, readiness);
+    if (!(readiness && missedDeadline(readiness.status))) {
+      await markReadiness(root, config.binary, readiness);
+    }
     if (readiness) return readiness;
   }
+  if (options.requireServer && !await serverRunning(root, config.binary, run)) {
+    return none("no-server", "no running `zg server` (this path never starts one)");
+  }
   const limit = Math.min(20, Math.max(1, Math.floor(options.limit ?? 10)));
   const chunkLimit = limit * 8;
   const globs = zvecExcludeGlobs(task);
@@ -58,8 +86,9 @@ async function zvecCandidates(repositoryRoot, task, options = {}) {
     ...globs.flatMap((glob) => ["-g", glob])
   ]);
   if (result.error) {
-    await resetZvecCache(root);
-    return fromError(result.error, "zvec-grep query");
+    const failure = fromError(result.error, "zvec-grep query");
+    if (!missedDeadline(failure.status)) await resetZvecCache(root);
+    return failure;
   }
   const hits = parseHits(result.stdout).slice(0, chunkLimit);
   if (hits.length === 0 && /\bzg index\b/.test(result.stdout)) {
@@ -103,6 +132,7 @@ async function zvecCandidates(repositoryRoot, task, options = {}) {
     hits: candidates,
     stale,
     changed,
+    minScore: config.minScore,
     reason: `zvec-grep vector search: ${paths.length} file(s)` + (globs.length > 0 ? "; non-source paths excluded" : "") + (stale > 0 ? `, ${stale} stale hit(s) dropped` : "") + (changed > 0 ? `, ${changed} hit(s) changed since the zg index dropped` : "") + (indexedAt === null ? "; index age unknown, hits unverified (run `codebuddy zvec index`)" : "")
   };
 }
@@ -191,7 +221,11 @@ async function buildZvecIndex(repositoryRoot, options = {}) {
     child.on("close", (exit) => resolveRun(exit ?? 1));
   });
   await resetZvecCache(root);
-  if (code === 0) await markIndexed(root, startedAt);
+  if (code === 0) {
+    await writeFile(join(root, ".zvec-grep", ".gitignore"), "*\n", { flag: "wx" }).catch(() => {
+    });
+    await markIndexed(root, startedAt);
+  }
   return code;
 }
 var NOT_READY = "zvec-grep index missing or not ready; run `codebuddy zvec index`";
@@ -271,7 +305,8 @@ async function zvecConfig(root) {
   return {
     enabled: env !== void 0 ? env === "1" || env === "true" : file.zvec?.enabled ?? false,
     binary: file.zvec?.binary ?? "zg",
-    timeoutMs: file.zvec?.timeoutMs ?? DEFAULT_TIMEOUT_MS
+    timeoutMs: file.zvec?.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    minScore: file.zvec?.minScore ?? DEFAULT_ZVEC_MIN_SCORE
   };
 }
 function runZg(binary, args, cwd, timeoutMs, signal) {
@@ -296,6 +331,35 @@ function runZg(binary, args, cwd, timeoutMs, signal) {
     );
   });
 }
+function deadlineError() {
+  return Object.assign(new Error("hook deadline reached"), { code: "ETIMEDOUT" });
+}
+function serverPath(root) {
+  return join(root, ".codebuddy", "cache", "zvec-server.json");
+}
+async function serverRunning(root, binary, run) {
+  try {
+    const cached = JSON.parse(await readFile(serverPath(root), "utf8"));
+    const age = Date.now() - (cached.checkedAt ?? 0);
+    if (cached.binary === binary && age >= 0 && age <= NOT_READY_CACHE_MS) {
+      return cached.running === true;
+    }
+  } catch {
+  }
+  const status = await run(["server", "status"]);
+  if (status.error?.code === "ETIMEDOUT") return false;
+  const running = !status.error && /^Server: ready\b/m.test(status.stdout);
+  try {
+    await mkdir(dirname(serverPath(root)), { recursive: true, mode: 448 });
+    await writeAtomic(
+      serverPath(root),
+      `${JSON.stringify({ binary, checkedAt: Date.now(), running })}
+`
+    );
+  } catch {
+  }
+  return running;
+}
 function fromError(error, what) {
   if (error.code === "ENOENT") return none("not-installed", "zvec-grep (`zg`) not found on PATH");
   if (error.code === "ETIMEDOUT") return none("timeout", `${what} timed out`);
@@ -313,6 +377,7 @@ function toRepoRelative(root, path) {
 
 export {
   DEFAULT_ZVEC_MODEL,
+  DEFAULT_ZVEC_MIN_SCORE,
   zvecExcludeGlobs,
   zvecCandidates,
   refreshZvecIndex,
@@ -321,4 +386,4 @@ export {
   zvecStatus,
   buildZvecIndex
 };
-//# sourceMappingURL=chunk-5FW3PMNP.js.map
+//# sourceMappingURL=chunk-GXOML4UZ.js.map