token-goat 2.9.28 → 2.9.30

package/dist/{token-goat-chunk-M56BWPBN.mjs → token-goat-chunk-VL3YIFHZ.mjs}

@@ -1,24 +1,28 @@
 import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
-import {
-  registerReset
-} from "./token-goat-chunk-EEIDFMEM.mjs";
 import {
   Database
-} from "./token-goat-chunk-OSUFN2FV.mjs";
+} from "./token-goat-chunk-XB5KKOCG.mjs";
+import {
+  registerReset
+} from "./token-goat-chunk-YZAAZU2S.mjs";
 import {
-  SYMBOL_BODY_CHAR_CAP,
   countContentLines,
-  dataDir,
   ensureDirSync,
-  escapeRegExp,
+  escapeRegExp
+} from "./token-goat-chunk-GOLEOXZP.mjs";
+import {
   foldCase,
   foldPath,
   sleepSync
-} from "./token-goat-chunk-L45ZQRT7.mjs";
+} from "./token-goat-chunk-AM5V6GSX.mjs";
 import {
   safeJoin
-} from "./token-goat-chunk-NMTKNYGF.mjs";
+} from "./token-goat-chunk-FNFBKLRD.mjs";
+import {
+  SYMBOL_BODY_CHAR_CAP,
+  dataDir
+} from "./token-goat-chunk-VES7EL7O.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -389,6 +393,13 @@ function scalaCharLiteralLength(line, index) {
   return line[index + 1] !== void 0 && line[index + 1] !== "'" && line[index + 2] === "'" ? 3 : 0;
 }
 function stripStringLiterals(line, opts = {}) {
+  const stringFrame = (idx, delim) => {
+    const quote = line[idx];
+    const prev = line[idx - 1] ?? "";
+    const bareBraceHole = quote === '"' && (idx > 0 && prev === "$" || idx > 1 && prev === "@" && line[idx - 2] === "$" || idx > 1 && prev === "$" && line[idx - 2] === "@");
+    const plain = opts.interpolatorPrefix === true && !/[A-Za-z0-9_]/.test(prev) || opts.singleQuoteHoles === true && prev === "r" && !/[A-Za-z0-9_$]/.test(line[idx - 2] ?? "");
+    return { kind: "string", quote: delim, bareBraceHole, plain };
+  };
   const openDelim = (idx) => {
     const q = line[idx];
     if (opts.tripleQuotes && line[idx + 1] === q && line[idx + 2] === q) return q + q + q;
@@ -413,9 +424,8 @@ function stripStringLiterals(line, opts = {}) {
         continue;
       }
       if (ch === '"' || ch === "'") {
-        const bareBraceHole = ch === '"' && i > 0 && line[i - 1] === "$";
         const delim = openDelim(i);
-        stack.push({ kind: "string", quote: delim, bareBraceHole });
+        stack.push(stringFrame(i, delim));
         out += delim;
         i += delim.length;
         continue;
@@ -425,15 +435,35 @@ function stripStringLiterals(line, opts = {}) {
       continue;
     }
     if (top.kind === "hole") {
+      if (top.paren === true && (ch === "(" || ch === ")")) {
+        if (ch === "(") {
+          top.depth++;
+          out += ch;
+        } else {
+          if (top.depth > 0) {
+            top.depth--;
+            out += ch;
+          } else {
+            stack.pop();
+            out += " ";
+          }
+        }
+        i++;
+        continue;
+      }
+      if (top.paren === true && (ch === "{" || ch === "}")) {
+        out += ch;
+        i++;
+        continue;
+      }
       if (opts.symbolLiterals === true && ch === "'" && scalaCharLiteralLength(line, i) === 0) {
         out += ch;
         i++;
         continue;
       }
       if (ch === '"' || ch === "'") {
-        const bareBraceHole = ch === '"' && i > 0 && line[i - 1] === "$";
         const delim = openDelim(i);
-        stack.push({ kind: "string", quote: delim, bareBraceHole });
+        stack.push(stringFrame(i, delim));
         out += delim;
         i += delim.length;
         continue;
@@ -458,6 +488,12 @@ function stripStringLiterals(line, opts = {}) {
       i++;
       continue;
     }
+    if (opts.swiftInterpolation === true && top.quote === '"' && ch === "\\" && line[i + 1] === "(") {
+      stack.push({ kind: "hole", depth: 0, paren: true });
+      out += "  ";
+      i += 2;
+      continue;
+    }
     if (ch === "\\" && i + 1 < line.length && line[i + 1] !== "\n") {
       out += "  ";
       i += 2;
@@ -469,7 +505,7 @@ function stripStringLiterals(line, opts = {}) {
       i += top.quote.length;
       continue;
     }
-    if (top.quote === '"') {
+    if (!top.plain && (top.quote === '"' || opts.singleQuoteHoles === true && top.quote[0] === "'")) {
       if (top.bareBraceHole && ch === "{") {
         if (line[i + 1] === "{") {
           out += "  ";
@@ -1180,12 +1216,21 @@ function findMatchingBraceEndLine(content, openBraceIndex, totalLines, lineIndex
   const rRaw = opts?.rRawStrings === true;
   const tripleDelims = tripleQuoteDelimiters(opts);
   const lineString = opts?.lineStringPrefix;
+  const interpolation = opts?.interpolation;
+  let interpolated = false;
   let depth = 0;
   let quote = null;
   let verbatim = false;
   for (let i = openBraceIndex; i < content.length; i++) {
     const ch = content[i];
     if (quote !== null) {
+      if (interpolated && interpolation !== void 0) {
+        const past = skipInterpolationAt(content, i, content.length, interpolation);
+        if (past !== null) {
+          i = past - 1;
+          continue;
+        }
+      }
       if (verbatim) {
         if (ch === quote) {
           if (content[i + 1] === quote) {
@@ -1248,6 +1293,7 @@ function findMatchingBraceEndLine(content, openBraceIndex, totalLines, lineIndex
     if (ch === '"' || ch === "'" || backtick && ch === "`") {
       quote = ch;
       verbatim = escapes === "csharp" && ch === '"' && opensCsharpVerbatimString(content, i);
+      interpolated = interpolation !== void 0 && opensInterpolatedString(content, i, interpolation);
       continue;
     }
     if (ch === "{") depth++;
@@ -1281,6 +1327,7 @@ function assignBraceBlockSpans(symbols, content, opts = {}) {
     rawStringQuotes: opts.rawStringQuotes ?? false,
     tripleSingleQuote: opts.tripleSingleQuote ?? false,
     tripleQuoteRunClose: opts.tripleQuoteRunClose ?? "last",
+    ...opts.interpolation === void 0 ? {} : { interpolation: opts.interpolation },
     ...blockComment === void 0 ? {} : { blockComment, nestedBlockComments },
     ...lineStringPrefix === void 0 ? {} : { lineStringPrefix },
     ...opts.lineCommentExceptions === void 0 ? {} : { lineCommentExceptions: opts.lineCommentExceptions }
@@ -1288,6 +1335,18 @@ function assignBraceBlockSpans(symbols, content, opts = {}) {
   return symbols.map((sym) => {
     if (sym.lineEnd !== sym.lineStart) return sym;
     const nextStart = starts.find((s) => s > sym.lineStart);
+    if (opts.expressionBodies === true) {
+      const arrowLast = Math.min(nextStart !== void 0 ? nextStart - 1 : totalLines, sym.lineStart + BRACE_SEARCH_MAX_LINES);
+      const arrowEnd = findArrowBodyEndLine(scanContent, lineIndex, sym.lineStart, arrowLast);
+      if (arrowEnd !== null) {
+        return arrowEnd <= sym.lineStart ? withWholeLineBody(sym, lines) : { ...sym, lineEnd: arrowEnd, body: lines.slice(sym.lineStart - 1, arrowEnd).join("\n") };
+      }
+    } else if (opts.expressionBodies === "kotlin") {
+      const eqEnd = findKotlinEqualsBodyEndLine(scanContent, lineIndex, sym.lineStart, nextStart !== void 0 ? nextStart - 1 : totalLines);
+      if (eqEnd !== null) {
+        return eqEnd <= sym.lineStart ? withWholeLineBody(sym, lines) : { ...sym, lineEnd: eqEnd, body: lines.slice(sym.lineStart - 1, eqEnd).join("\n") };
+      }
+    }
     const lastSearchLine = Math.min(nextStart !== void 0 ? nextStart - 1 : totalLines, sym.lineStart + BRACE_SEARCH_MAX_LINES);
     const openIndex = findBlockOpenBrace(scanContent, lineIndex, sym.lineStart, lastSearchLine, lineCommentPrefix, scanOpts);
     if (openIndex === null) return sym;
@@ -1299,11 +1358,304 @@ function assignBraceBlockSpans(symbols, content, opts = {}) {
       lineCommentPrefix,
       scanOpts
     );
-    if (endLine <= sym.lineStart) return sym;
+    if (endLine === sym.lineStart) return withWholeLineBody(sym, lines);
+    if (endLine < sym.lineStart) return sym;
     return { ...sym, lineEnd: endLine, body: lines.slice(sym.lineStart - 1, endLine).join("\n") };
   });
 }
+function withWholeLineBody(sym, lines) {
+  const line = lines[sym.lineStart - 1];
+  if (line === void 0 || sym.body.includes("{") || !line.includes("{")) return sym;
+  return { ...sym, body: line.trimEnd() };
+}
 var BRACE_SEARCH_MAX_LINES = 10;
+function skipCsharpInterpolationHole(content, i, to) {
+  let depth = 0;
+  for (let k = i; k < to; k++) {
+    const lit = skipCsharpLiteral(content, k, to);
+    if (lit !== null) {
+      k = lit - 1;
+      continue;
+    }
+    const ch = content[k];
+    if (ch === "{") depth++;
+    else if (ch === "}" && --depth === 0) return k + 1;
+  }
+  return to;
+}
+function skipCsharpLiteral(content, i, to) {
+  const first = content[i];
+  if (first === "'") {
+    if (content[i + 1] === "\\") {
+      const close = content.indexOf("'", i + 3);
+      return close === -1 || close >= to ? null : close + 1;
+    }
+    return content[i + 2] === "'" ? i + 3 : null;
+  }
+  let j = i;
+  while ((content[j] === "$" || content[j] === "@") && j - i < 3) j++;
+  if (content[j] !== '"') return null;
+  const prefix = content.slice(i, j);
+  if (j > i && /[A-Za-z0-9_]/.test(content[i - 1] ?? "")) return null;
+  const interpolated = prefix.includes("$");
+  const verbatim = prefix.includes("@");
+  const run = quoteRunLength(content, j);
+  if (run >= 3) {
+    const end = skipRawStringQuotes(content, j + run, run);
+    return end === -1 ? to : end;
+  }
+  for (let k = j + 1; k < to; k++) {
+    const ch = content[k];
+    if (ch === void 0) break;
+    if (verbatim) {
+      if (ch === '"') {
+        if (content[k + 1] === '"') {
+          k++;
+          continue;
+        }
+        return k + 1;
+      }
+    } else if (ch === "\\") {
+      k++;
+      continue;
+    } else if (ch === '"') return k + 1;
+    if (interpolated) {
+      if (ch === "{") {
+        if (content[k + 1] === "{") {
+          k++;
+          continue;
+        }
+        k = skipCsharpInterpolationHole(content, k, to) - 1;
+      }
+    }
+  }
+  return to;
+}
+function findArrowBodyEndLine(content, lineIndex, startLine, lastSearchLine) {
+  const from = lineIndex[startLine - 1];
+  if (from === void 0) return null;
+  const to = lineIndex[lastSearchLine] ?? content.length;
+  let depth = 0;
+  let seenArrow = false;
+  for (let i = from; i < to; i++) {
+    const ch = content[i];
+    if (ch === void 0) break;
+    if (ch === "/" && content[i + 1] === "/") {
+      while (i + 1 < to && content[i + 1] !== "\n") i++;
+      continue;
+    }
+    if (ch === "/" && content[i + 1] === "*") {
+      const end = content.indexOf("*/", i + 2);
+      if (end === -1) return null;
+      i = end + 1;
+      continue;
+    }
+    const lit = skipCsharpLiteral(content, i, to);
+    if (lit !== null) {
+      i = lit - 1;
+      continue;
+    }
+    if (ch === "(" || ch === "[") depth++;
+    else if (ch === ")" || ch === "]") {
+      if (depth > 0) depth--;
+    } else if (ch === "=" && content[i + 1] === ">" && depth === 0) {
+      seenArrow = true;
+      i++;
+    } else if (ch === "{") {
+      if (!seenArrow && depth === 0) return null;
+      depth++;
+    } else if (ch === "}") {
+      if (depth === 0) return null;
+      depth--;
+    } else if (ch === ";" && depth === 0) {
+      if (!seenArrow) return null;
+      let line = startLine;
+      for (let k = from; k < i; k++) if (content[k] === "\n") line++;
+      return line;
+    }
+  }
+  return null;
+}
+function skipKotlinTemplateHole(content, i, to) {
+  let depth = 0;
+  for (let k = i; k < to; k++) {
+    const lit = skipKotlinLiteral(content, k, to);
+    if (lit !== null) {
+      k = lit - 1;
+      continue;
+    }
+    const ch = content[k];
+    if (ch === "{") depth++;
+    else if (ch === "}" && --depth === 0) return k + 1;
+  }
+  return to;
+}
+function skipKotlinLiteral(content, i, to) {
+  const first = content[i];
+  if (first === "'") {
+    for (let k = i + 1; k < to && content[k] !== "\n"; k++) {
+      if (content[k] === "\\") {
+        k++;
+        continue;
+      }
+      if (content[k] === "'") return k + 1;
+    }
+    return null;
+  }
+  if (first !== '"') return null;
+  const triple = content.startsWith('"""', i);
+  for (let k = i + (triple ? 3 : 1); k < to; k++) {
+    const ch = content[k];
+    if (triple) {
+      if (ch === '"' && content.startsWith('"""', k)) {
+        k += 3;
+        while (content[k] === '"') k++;
+        return k;
+      }
+    } else if (ch === "\\") {
+      k++;
+      continue;
+    } else if (ch === '"') return k + 1;
+    else if (ch === "\n") return k;
+    if (ch === "$" && content[k + 1] === "{") k = skipKotlinTemplateHole(content, k + 1, to) - 1;
+  }
+  return to;
+}
+function opensInterpolatedString(content, i, lang) {
+  const q = content[i];
+  const prev = content[i - 1] ?? "";
+  if (lang === "csharp") return q === '"' && (prev === "$" || prev === "@" && content[i - 2] === "$");
+  if (lang === "scala") return q === '"' && /[A-Za-z0-9_]/.test(prev);
+  if (lang === "dart") return !(prev === "r" && !/[A-Za-z0-9_$]/.test(content[i - 2] ?? ""));
+  return q === '"';
+}
+function skipInterpolationAt(content, i, to, lang) {
+  const ch = content[i];
+  if (lang === "swift") return ch === "\\" && content[i + 1] === "(" ? skipInterpolationHole(content, i + 1, to, lang) : null;
+  if (lang === "csharp") {
+    if (ch !== "{") return null;
+    return content[i + 1] === "{" ? i + 2 : skipInterpolationHole(content, i, to, lang);
+  }
+  return ch === "$" && content[i + 1] === "{" ? skipInterpolationHole(content, i + 1, to, lang) : null;
+}
+function skipInterpolationHole(content, i, to, lang) {
+  const open = content[i];
+  const close = open === "(" ? ")" : "}";
+  let depth = 0;
+  for (let k = i; k < to; k++) {
+    const lit = skipNestedLiteral(content, k, to, lang);
+    if (lit !== null) {
+      k = lit - 1;
+      continue;
+    }
+    const ch = content[k];
+    if (ch === open) depth++;
+    else if (ch === close && --depth === 0) return k + 1;
+  }
+  return to;
+}
+function skipNestedLiteral(content, i, to, lang) {
+  const ch = content[i];
+  if (lang === "csharp") return skipCsharpLiteral(content, i, to);
+  if (lang === "kotlin") return skipKotlinLiteral(content, i, to);
+  if (ch === "'" && lang === "scala") {
+    const len = scalaCharLiteralLength(content, i);
+    return len > 0 ? i + len : null;
+  }
+  if (ch !== '"' && !(ch === "'" && lang === "dart")) return null;
+  return skipInterpolatedString(content, i, to, lang, opensInterpolatedString(content, i, lang));
+}
+function skipInterpolatedString(content, i, to, lang, interpolated) {
+  const q = content[i];
+  if (content.startsWith(q + q + q, i)) {
+    const end = content.indexOf(q + q + q, i + 3);
+    return end === -1 || end >= to ? to : end + 3;
+  }
+  for (let k = i + 1; k < to; k++) {
+    const ch = content[k];
+    if (ch === "\n") return k;
+    if (interpolated) {
+      const past = skipInterpolationAt(content, k, to, lang);
+      if (past !== null) {
+        k = past - 1;
+        continue;
+      }
+    }
+    if (ch === "\\") {
+      k++;
+      continue;
+    }
+    if (ch === q) return k + 1;
+  }
+  return to;
+}
+function kotlinBodyContinues(content, lastSig, ifParenClosedAt, nextLineFrom) {
+  const c = content[lastSig];
+  const prev = content[lastSig - 1];
+  if (lastSig === ifParenClosedAt) return true;
+  if (c !== void 0 && "=*/%&|,.:".includes(c)) return true;
+  if ((c === "+" || c === "-") && prev !== c) return true;
+  if (c === ">" && prev === "-") return true;
+  if (/(?:^|[^A-Za-z0-9_])else$/.test(content.slice(Math.max(0, lastSig - 4), lastSig + 1))) return true;
+  const rest = content.slice(nextLineFrom);
+  const next = /^(?:[ \t\r]*(?:\/\/[^\n]*)?\n)*[ \t]*(\.|\?\.|\?:|&&|\|\||else\b|as\b|catch\b|finally\b)/.exec(rest);
+  return next !== null;
+}
+function findKotlinEqualsBodyEndLine(content, lineIndex, startLine, lastLine) {
+  const from = lineIndex[startLine - 1];
+  if (from === void 0) return null;
+  const to = lineIndex[lastLine] ?? content.length;
+  let depth = 0;
+  let seenEq = false;
+  let line = startLine;
+  let lastSig = -1;
+  let ifParenClosedAt = -1;
+  const ifParens = [];
+  for (let i = from; i < to; i++) {
+    const ch = content[i];
+    if (ch === void 0) break;
+    if (ch === "\n") {
+      if (depth === 0) {
+        if (!seenEq) return null;
+        if (!kotlinBodyContinues(content, lastSig, ifParenClosedAt, i + 1)) return line;
+      }
+      line++;
+      continue;
+    }
+    if (ch === " " || ch === "	" || ch === "\r") continue;
+    if (ch === "/" && content[i + 1] === "/") {
+      while (i + 1 < to && content[i + 1] !== "\n") i++;
+      continue;
+    }
+    if (ch === "/" && content[i + 1] === "*") {
+      const end = content.indexOf("*/", i + 2);
+      if (end === -1) return null;
+      for (let k = i; k < end; k++) if (content[k] === "\n") line++;
+      i = end + 1;
+      continue;
+    }
+    const lit = skipKotlinLiteral(content, i, to);
+    if (lit !== null) {
+      for (let k = i; k < lit; k++) if (content[k] === "\n") line++;
+      lastSig = lit - 1;
+      i = lit - 1;
+      continue;
+    }
+    lastSig = i;
+    if (ch === "(" || ch === "[" || ch === "{") {
+      if (ch === "{" && !seenEq && depth === 0) return null;
+      ifParens.push(ch === "(" && /\bif\s*$/.test(content.slice(Math.max(from, i - 8), i)));
+      depth++;
+    } else if (ch === ")" || ch === "]" || ch === "}") {
+      if (depth === 0) return null;
+      depth--;
+      if (ifParens.pop() === true) ifParenClosedAt = i;
+    } else if (ch === "=" && !seenEq && depth === 0 && !"=!<>".includes(content[i - 1] ?? " ") && content[i + 1] !== "=") {
+      seenEq = true;
+    }
+  }
+  return seenEq && depth === 0 ? line : null;
+}
 function maskMultilineStrings(content, lang) {
   let state = null;
   const parts = [];
@@ -1333,6 +1685,8 @@ function findBlockOpenBrace(content, lineIndex, startLine, lastSearchLine, lineC
   const from = lineIndex[startLine - 1];
   if (from === void 0) return null;
   const to = lineIndex[lastSearchLine] ?? content.length;
+  const interpolation = opts?.interpolation;
+  let interpolated = false;
   let quote = null;
   let parenDepth = 0;
   let linesSeen = 0;
@@ -1342,6 +1696,13 @@ function findBlockOpenBrace(content, lineIndex, startLine, lastSearchLine, lineC
     const ch = content[i];
     if (ch === void 0) break;
     if (quote !== null) {
+      if (interpolated && interpolation !== void 0) {
+        const past = skipInterpolationAt(content, i, to, interpolation);
+        if (past !== null) {
+          i = past - 1;
+          continue;
+        }
+      }
       if (verbatim) {
         if (ch === quote) {
           if (content[i + 1] === quote) {
@@ -1408,6 +1769,7 @@ function findBlockOpenBrace(content, lineIndex, startLine, lastSearchLine, lineC
     if (ch === '"' || ch === "'") {
       quote = ch;
       verbatim = stringEscapes === "csharp" && ch === '"' && opensCsharpVerbatimString(content, i);
+      interpolated = interpolation !== void 0 && opensInterpolatedString(content, i, interpolation);
       continue;
     }
     if (ch === "(" || ch === "[") parenDepth++;
@@ -1972,7 +2334,7 @@ CREATE INDEX IF NOT EXISTS idx_symbols_file ON symbols(file_path);
 CREATE INDEX IF NOT EXISTS idx_symbols_name_kind ON symbols(name, kind);
 CREATE INDEX IF NOT EXISTS idx_symbols_file_folded ON symbols(TG_LOWER(file_path));
 CREATE INDEX IF NOT EXISTS idx_symbols_file_name_folded ON symbols(TG_LOWER(file_path), name);
--- Partial index backing checkSymbolBodySize (cli_doctor.ts), which every SessionStart hook runs.
+-- Partial index backing checkSymbolBodySize (symbol_body_probe.ts), which every SessionStart hook runs.
 -- Its predicate cannot be served by any index above, so the check had to read the whole symbols
 -- table -- 226 MB / 231324 rows here, 229 ms per session start, and the early-exit LIMIT 1 never
 -- fires on a healthy index because there is nothing to find. Indexing the *violating* rows only
@@ -1980,7 +2342,7 @@ CREATE INDEX IF NOT EXISTS idx_symbols_file_name_folded ON symbols(TG_LOWER(file
 -- ms, 4 KB on disk, and no measurable insert cost (-0.2%, within noise, over 40000 real rows),
 -- because SQLite evaluates the predicate and skips the b-tree write for every row under the cap.
 -- SQLite uses a partial index only where the query's WHERE implies the index's, so the probe in
--- cli_doctor.ts spells its comparison the same way and against the same constant. That makes the
+-- symbol_body_probe.ts spells its comparison the same way and against the same constant. That makes the
 -- threshold part of the stored schema -- see SYMBOL_BODY_CHAR_CAP in constants.ts for what
 -- changing it requires. A query with a lower threshold correctly gets a full scan instead, so no
 -- other reader can be served stale rows by this index.
@@ -2076,7 +2438,11 @@ CREATE INDEX IF NOT EXISTS idx_cache_recall_type ON cache_recall(cache_type);
 -- picked and averaging fabrications into a measured rate is how 174 of bash_redirect's 698 rows
 -- came to hold its efficacy down to 0.86% when the observed figure was 1.15%. calls_remaining is
 -- the countdown of subsequent tool-use events still eligible to resolve this row before it is
--- considered timed out. displayed=0 marks a detection that never reached the agent -- auto-
+-- considered timed out. A displayed, observable row with resolved=0 is pending: nothing has
+-- scored it yet. Nothing sweeps these on a clock, so a session that ends mid-window leaves its
+-- rows pending for good, and efficacy and suppression count only resolved rows -- counting a
+-- pending one as not acted on is what muted bash_redirect at 1 in 11 when its scored rows stood
+-- at 1 in 6. displayed=0 marks a detection that never reached the agent -- auto-
 -- suppressed, or declined by a hint's own net-benefit gate -- recorded so the ledger can answer
 -- how often a hint fired at all, which it previously could not: a suppressed detection left no
 -- trace, so a fully-muted category was indistinguishable from one that had stopped triggering.
@@ -2313,7 +2679,7 @@ function runMigrations(conn, fromVersion, toVersion) {
   }
 }
 var WAL_SWITCH_DEADLINE_MS = 15e3;
-function enableWalWithRetry(conn, budgetMs = WAL_SWITCH_DEADLINE_MS) {
+function enableWalWithRetry(conn, budgetMs = WAL_SWITCH_DEADLINE_MS, stopOn) {
   const deadline = Date.now() + budgetMs;
   let lastError;
   for (; ; ) {
@@ -2323,55 +2689,147 @@ function enableWalWithRetry(conn, budgetMs = WAL_SWITCH_DEADLINE_MS) {
       lastError = new Error(`got: ${String(mode)}`);
     } catch (e) {
       lastError = e;
+      if (isDamagedDatabaseError(e) || stopOn?.(e) === true) throw walSwitchError(e);
     }
     try {
       if (String(conn.pragma("journal_mode", { simple: true })).toLowerCase() === "wal") return;
     } catch {
     }
-    if (Date.now() >= deadline) {
-      throw new Error(`db: failed to enable WAL mode (${lastError instanceof Error ? lastError.message : String(lastError)})`);
-    }
+    if (Date.now() >= deadline) throw walSwitchError(lastError);
     sleepSync(25);
   }
 }
-function initConnection(conn) {
+function isDamagedDatabaseError(e) {
+  const code = e?.code;
+  return typeof code === "string" && /^SQLITE_(?:NOTADB|CORRUPT)/.test(code);
+}
+function walSwitchError(lastError) {
+  return new Error(`db: failed to enable WAL mode (${lastError instanceof Error ? lastError.message : String(lastError)})`, { cause: lastError });
+}
+function initConnection(conn, walStopOn) {
   conn.pragma("busy_timeout = 15000");
-  enableWalWithRetry(conn);
+  enableWalWithRetry(conn, WAL_SWITCH_DEADLINE_MS, walStopOn);
   conn.pragma("synchronous = NORMAL");
   conn.pragma("cache_size = -32000");
   conn.pragma("temp_store = MEMORY");
   conn.pragma("mmap_size = 134217728");
-  conn.function(
-    "TG_LOWER",
-    { deterministic: true },
-    (value) => value === null ? null : foldCase(String(value))
-  );
+  registerTgLower(conn);
   const storedVersion = Number(conn.pragma("user_version", { simple: true }));
-  if (storedVersion > SCHEMA_VERSION) {
-    throw new Error(
-      `db: index schema version ${storedVersion} is newer than this token-goat build supports (expected ${SCHEMA_VERSION}). Update token-goat, or delete the stale index database and let it rebuild.`
-    );
-  }
+  if (storedVersion > SCHEMA_VERSION) throw newerSchemaError(storedVersion);
   conn.exec(SCHEMA_SQL);
   try {
     conn.exec(FTS_SQL);
   } catch {
   }
-  try {
-    const sqliteVec = _require("sqlite-vec");
-    sqliteVec.load(conn);
-    conn.exec(
-      `CREATE VIRTUAL TABLE IF NOT EXISTS chunk_vectors USING vec0(
+  if (loadSqliteVec(conn)) {
+    try {
+      conn.exec(
+        `CREATE VIRTUAL TABLE IF NOT EXISTS chunk_vectors USING vec0(
          embedding float[384]
        );`
-    );
-  } catch {
+      );
+    } catch {
+    }
   }
   if (storedVersion < SCHEMA_VERSION) {
     runMigrations(conn, storedVersion, SCHEMA_VERSION);
     conn.pragma(`user_version = ${SCHEMA_VERSION}`);
   }
 }
+function newerSchemaError(storedVersion) {
+  return new Error(
+    `db: index schema version ${storedVersion} is newer than this token-goat build supports (expected ${SCHEMA_VERSION}). Update token-goat, or delete the stale index database and let it rebuild.`
+  );
+}
+function registerTgLower(conn) {
+  conn.function(
+    "TG_LOWER",
+    { deterministic: true },
+    (value) => value === null ? null : foldCase(String(value))
+  );
+}
+function loadSqliteVec(conn) {
+  try {
+    const sqliteVec = _require("sqlite-vec");
+    sqliteVec.load(conn);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var _readOnlyFallback;
+var _readOnlyConnections = /* @__PURE__ */ new Map();
+function allowReadOnlyIndex(onFirstUse) {
+  _readOnlyFallback = { onFirstUse, used: false };
+}
+function isReadOnlyDb(dbPath) {
+  if (_readOnlyFallback === void 0) return false;
+  try {
+    getDb(dbPath);
+  } catch {
+    return false;
+  }
+  return _readOnlyConnections.has(connectionKey(dbPath).key);
+}
+var WRITE_ACCESS_SQLITE_CODE_RE = /^SQLITE_(?:CANTOPEN|READONLY|PERM|IOERR_ACCESS|IOERR_SHMOPEN)/;
+var WRITE_ACCESS_FS_CODES = /* @__PURE__ */ new Set(["EACCES", "EPERM", "EROFS"]);
+function isWriteAccessError(e) {
+  for (let cur = e, depth = 0; cur instanceof Error && depth < 4; cur = cur.cause, depth++) {
+    const code = cur.code;
+    if (typeof code === "string" && (WRITE_ACCESS_SQLITE_CODE_RE.test(code) || WRITE_ACCESS_FS_CODES.has(code))) return true;
+  }
+  return false;
+}
+function writeRefusal(resolved) {
+  let fd;
+  try {
+    fd = fs2.openSync(resolved, "r+");
+  } catch (e) {
+    return isWriteAccessError(e) ? e : void 0;
+  }
+  fs2.closeSync(fd);
+  return void 0;
+}
+function openReadOnlyAt(resolved, immutable) {
+  const conn = new Database(resolved, { readonly: true, fileMustExist: true, immutable });
+  try {
+    conn.pragma("busy_timeout = 15000");
+    return { conn, storedVersion: Number(conn.pragma("user_version", { simple: true })) };
+  } catch (e) {
+    try {
+      conn.close();
+    } catch {
+    }
+    throw e;
+  }
+}
+function openIndexReadOnly(resolved) {
+  let opened;
+  try {
+    opened = openReadOnlyAt(resolved, false);
+  } catch (e) {
+    if (!isWriteAccessError(e)) throw e;
+    opened = openReadOnlyAt(resolved, true);
+  }
+  const { conn, storedVersion } = opened;
+  try {
+    if (storedVersion > SCHEMA_VERSION) throw newerSchemaError(storedVersion);
+    if (storedVersion < SCHEMA_VERSION) {
+      throw new Error(
+        `db: index schema version ${storedVersion} predates this token-goat build (expected ${SCHEMA_VERSION}) and cannot be upgraded without write access. Run token-goat once where its data directory is writable.`
+      );
+    }
+    registerTgLower(conn);
+    loadSqliteVec(conn);
+  } catch (e) {
+    try {
+      conn.close();
+    } catch {
+    }
+    throw e;
+  }
+  return conn;
+}
 function resolveDbPath(dbPath) {
   if (path2.isAbsolute(dbPath)) return dbPath;
   if (dbPath.includes("/") || dbPath.includes("\\")) return path2.resolve(dbPath);
@@ -2385,35 +2843,75 @@ function getDb(dbPath) {
   const { resolved, key } = connectionKey(dbPath);
   const existing = _connections.get(key);
   if (existing !== void 0) return existing;
+  const fallback = _readOnlyFallback;
+  if (fallback !== void 0) {
+    const readOnly = _readOnlyConnections.get(key);
+    if (readOnly !== void 0) return readOnly;
+    const refused = writeRefusal(resolved);
+    if (refused !== void 0) return openReadOnlyFallback(resolved, key, fallback, refused);
+  }
   const dir = path2.dirname(resolved);
   try {
     ensureDirSync(dir);
   } catch (e) {
     if (e.code !== "EEXIST" || !fs2.existsSync(dir)) throw e;
   }
-  const conn = new Database(resolved);
+  let conn;
   try {
-    initConnection(conn);
+    conn = new Database(resolved);
+    initConnection(conn, fallback !== void 0 ? isWriteAccessError : void 0);
   } catch (e) {
     try {
-      conn.close();
+      conn?.close();
     } catch {
     }
+    if (fallback !== void 0 && isWriteAccessError(e)) return openReadOnlyFallback(resolved, key, fallback, e);
     throw e;
   }
   _connections.set(key, conn);
   return conn;
 }
-function closeAllDbs() {
-  for (const conn of _connections.values()) {
+function openReadOnlyFallback(resolved, key, fallback, writeError) {
+  let conn;
+  try {
+    conn = openIndexReadOnly(resolved);
+  } catch (e) {
+    throw isWriteAccessError(e) || !fs2.existsSync(resolved) ? writeError : e;
+  }
+  _readOnlyConnections.set(key, conn);
+  if (!fallback.used) {
+    fallback.used = true;
+    fallback.onFirstUse();
+  }
+  return conn;
+}
+function closeDb(dbPath) {
+  const { key } = connectionKey(dbPath);
+  for (const cache of [_connections, _readOnlyConnections]) {
+    const conn = cache.get(key);
+    if (conn === void 0) continue;
     try {
       conn.close();
     } catch {
     }
+    cache.delete(key);
+  }
+}
+function closeAllDbs() {
+  for (const cache of [_connections, _readOnlyConnections]) {
+    for (const conn of cache.values()) {
+      try {
+        conn.close();
+      } catch {
+      }
+    }
+    cache.clear();
   }
-  _connections.clear();
 }
-registerReset(closeAllDbs);
+registerReset(closeAllDbs, { perRequest: true });
+registerReset(() => {
+  _readOnlyFallback = void 0;
+}, { perRequest: true });
 
 export {
   precedingDocComment,
@@ -2470,5 +2968,8 @@ export {
   unsupportedLanguageName,
   isDotenvPath,
   redactIfDotenv,
-  getDb
+  allowReadOnlyIndex,
+  isReadOnlyDb,
+  getDb,
+  closeDb
 };