@wrongstack/tools 0.316.2 → 0.317.2

package/dist/{chunk-DA4KNE2H.js → chunk-TFEGJDH5.js}

@@ -1,15 +1,15 @@
 import {
   parseFilesContent
-} from "./chunk-IYK7XGDZ.js";
+} from "./chunk-JJQB6R7Y.js";
 import {
   INDEXABLE_EXTENSIONS,
   LANG_FAMILY_ENTRIES,
   detectLang,
   languageFamily
-} from "./chunk-TEBQ4VPZ.js";
+} from "./chunk-YOHO4DVT.js";
 import {
   loadGitignoreMatcher
-} from "./chunk-LIJQMYYX.js";
+} from "./chunk-ELFFQ4RU.js";
 
 // src/codebase-index/circuit-breaker.ts
 var CircuitOpenError = class extends Error {
@@ -99,13 +99,59 @@ var K1 = 1.5;
 var B = 0.75;
 var TOKENISE_RE = new RegExp("[^\\p{L}\\p{N}$']", "gu");
 function tokenise(text) {
-  return text.replace(TOKENISE_RE, " ").toLowerCase().trim().split(/\s+/).filter(Boolean);
+  if (!text) return [];
+  const cleaned = text.replace(TOKENISE_RE, " ").toLowerCase().trim();
+  if (!cleaned) return [];
+  return cleaned.split(/\s+/);
 }
+var SPLIT_CANDIDATE_RE = /[A-Z_\d-]/;
 function splitName(name) {
+  if (!name || !SPLIT_CANDIDATE_RE.test(name)) return name;
   return name.replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([\p{L}])(\d)/gu, "$1 $2").replace(/(\d)([\p{L}])/gu, "$1 $2").replace(/[_-]+/g, " ").trim();
 }
+var FTS_SIGNATURE_MAX_CHARS = 300;
+function ftsSignature(signature) {
+  if (!signature) return "";
+  const bodyStart = declarationBodyStart(signature);
+  const header = bodyStart === -1 ? signature : signature.slice(0, bodyStart);
+  return header.slice(0, FTS_SIGNATURE_MAX_CHARS);
+}
+function declarationBodyStart(s) {
+  let parenDepth = 0;
+  let paramsClosed = false;
+  let i = 0;
+  while (i < s.length) {
+    const ch = s[i];
+    if (!paramsClosed) {
+      if (ch === "(") parenDepth++;
+      else if (ch === ")") {
+        parenDepth = Math.max(0, parenDepth - 1);
+        if (parenDepth === 0) paramsClosed = true;
+      }
+      i++;
+      continue;
+    }
+    if (ch === "{") {
+      let j = i - 1;
+      while (j >= 0 && /\s/.test(s[j] ?? "")) j--;
+      if (s[j] === ":") {
+        let braceDepth = 1;
+        i++;
+        while (i < s.length && braceDepth > 0) {
+          if (s[i] === "{") braceDepth++;
+          else if (s[i] === "}") braceDepth--;
+          i++;
+        }
+        continue;
+      }
+      return i;
+    }
+    i++;
+  }
+  return -1;
+}
 function buildIndexableText(name, signature, docComment) {
-  return [splitName(name), name, signature, docComment].filter(Boolean).join(" ");
+  return [splitName(name), name, ftsSignature(signature), docComment].filter(Boolean).join(" ");
 }
 function buildBm25Index(docs) {
   const documents = docs.map((d) => {
@@ -189,7 +235,7 @@ var SCHEMA_VERSION = 5;
 // src/codebase-index/writer-helpers.ts
 import { resolveWstackPaths } from "@wrongstack/core/utils";
 function escapeLike(value) {
-  return value.replace(/[\\%_]/g, (char) => `\\${char}`);
+  return /[\\%_]/.test(value) ? value.replace(/[\\%_]/g, (char) => `\\${char}`) : value;
 }
 function ladderChunkSizes(total, max) {
   if (total <= 0) return [];
@@ -214,8 +260,22 @@ function padToInBucket(values) {
   while (padded.length < target) padded.push(padded[0]);
   return padded;
 }
+var PLACEHOLDER_BUCKETS = {
+  1: "?",
+  2: "?,?",
+  4: "?,?,?,?",
+  8: "?,?,?,?,?,?,?,?",
+  16: "?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?",
+  32: "?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?",
+  64: "?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?",
+  128: Array.from({ length: 128 }, () => "?").join(","),
+  256: Array.from({ length: 256 }, () => "?").join(","),
+  512: Array.from({ length: 512 }, () => "?").join(","),
+  1024: Array.from({ length: 1024 }, () => "?").join(",")
+};
 function placeholders(count) {
-  return Array.from({ length: count }, () => "?").join(",");
+  if (count <= 0) return "";
+  return PLACEHOLDER_BUCKETS[count] ?? Array.from({ length: count }, () => "?").join(",");
 }
 function inListChunks(total, max) {
   if (total <= 0) return [];
@@ -224,7 +284,8 @@ function inListChunks(total, max) {
   return ladderChunkSizes(total, powMax);
 }
 function posixIndexPath(file) {
-  return file.replace(/\\/g, "/").replace(/^\.\//, "");
+  const p = file.includes("\\") ? file.replace(/\\/g, "/") : file;
+  return p.startsWith("./") ? p.slice(2) : p;
 }
 function indexedFileMatchSql(column = "file") {
   return `(${column} = ? OR replace(${column}, '\\', '/') = ? OR replace(${column}, '\\', '/') LIKE ? ESCAPE '\\')`;
@@ -373,11 +434,13 @@ function isLockError(err) {
   if (typeof code === "number" && (code === 5 || code === 6)) return true;
   return /SQLITE_(BUSY|LOCKED)/.test(err.message);
 }
+var SLEEP_BUFFER;
 function sleepSync(ms) {
   try {
-    const sab = new SharedArrayBuffer(4);
-    const view = new Int32Array(sab);
-    Atomics.wait(view, 0, 0, ms);
+    if (!SLEEP_BUFFER) {
+      SLEEP_BUFFER = new Int32Array(new SharedArrayBuffer(4));
+    }
+    Atomics.wait(SLEEP_BUFFER, 0, 0, ms);
   } catch {
   }
 }
@@ -410,19 +473,12 @@ var NGRAM_SIZE = 3;
 function embedText(text) {
   const vec = new Float32Array(VECTOR_DIMENSIONS);
   const normalized = text.toLowerCase().trim();
-  if (normalized.length < NGRAM_SIZE) {
-    const padded = ` ${normalized} `.slice(0, Math.max(NGRAM_SIZE, normalized.length + 2));
-    for (let i = 0; i <= padded.length - NGRAM_SIZE; i++) {
-      const ngram = padded.slice(i, i + NGRAM_SIZE);
-      const bucket = hashNgram(ngram) % VECTOR_DIMENSIONS;
-      vec[bucket] += 1;
-    }
-  } else {
-    for (let i = 0; i <= normalized.length - NGRAM_SIZE; i++) {
-      const ngram = normalized.slice(i, i + NGRAM_SIZE);
-      const bucket = hashNgram(ngram) % VECTOR_DIMENSIONS;
-      vec[bucket] += 1;
-    }
+  if (normalized.length === 0) return vec;
+  const target = normalized.length < NGRAM_SIZE ? ` ${normalized} `.slice(0, Math.max(NGRAM_SIZE, normalized.length + 2)) : normalized;
+  for (let i = 0; i <= target.length - NGRAM_SIZE; i++) {
+    const ngram = target.slice(i, i + NGRAM_SIZE);
+    const bucket = hashNgram(ngram) % VECTOR_DIMENSIONS;
+    vec[bucket] += 1;
   }
   let norm = 0;
   for (let i = 0; i < VECTOR_DIMENSIONS; i++) {
@@ -456,11 +512,12 @@ function encodeVector(vec) {
   return Buffer.from(vec.buffer, vec.byteOffset, vec.byteLength);
 }
 function decodeVector(buf) {
-  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
-  const copy = new Float32Array(buf.byteLength / 4);
-  for (let i = 0; i < copy.length; i++) {
-    copy[i] = view.getFloat32(i * 4, true);
+  if (buf.byteLength === 0) return new Float32Array(0);
+  if (buf.byteLength % 4 !== 0) {
+    throw new Error(`decodeVector: invalid vector byteLength ${buf.byteLength} (must be a multiple of 4)`);
   }
+  const copy = new Float32Array(buf.byteLength / 4);
+  new Uint8Array(copy.buffer).set(buf);
   return copy;
 }
 function reciprocalRankFusion(bm25Ranks, vectorRanks, k = RRF_K) {
@@ -483,9 +540,11 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 var DB_FILE = "index.db";
 function getAllIndexableWithStatement(stmt) {
-  return stmt("SELECT id, text FROM symbols").all().map(
-    ({ id, text }) => ({ id, text })
-  );
+  const rows = stmt("SELECT id, name, signature, doc_comment FROM symbols").all();
+  return rows.map((row) => ({
+    id: row.id,
+    text: buildIndexableText(row.name, row.signature, row.doc_comment)
+  }));
 }
 function getMaxSymbolIdWithStatement(stmt) {
   const rows = stmt("SELECT MAX(id) AS m FROM symbols").all();
@@ -560,6 +619,16 @@ function getIndexDbSizeBytes(indexDir) {
 }
 
 // src/codebase-index/writer-bulk-insert.ts
+var ROW_PLACEHOLDERS_CACHE = /* @__PURE__ */ new Map();
+function getRowPlaceholders(rowTemplate, count) {
+  const key = `${rowTemplate}\0${count}`;
+  let result = ROW_PLACEHOLDERS_CACHE.get(key);
+  if (result === void 0) {
+    result = Array.from({ length: count }, () => rowTemplate).join(", ");
+    ROW_PLACEHOLDERS_CACHE.set(key, result);
+  }
+  return result;
+}
 function bulkInsertSymbolsWithStatement(stmt, maxSqlVars, rows) {
   if (rows.length === 0) return;
   const ladder = ladderChunkSizes(rows.length, Math.max(1, Math.floor(maxSqlVars / 12)));
@@ -567,9 +636,12 @@ function bulkInsertSymbolsWithStatement(stmt, maxSqlVars, rows) {
   for (const take of ladder) {
     const chunk = rows.slice(cursor, cursor + take);
     cursor += take;
-    const placeholders2 = chunk.map(() => "(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").join(", ");
+    const placeholders2 = getRowPlaceholders(
+      "(?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+      chunk.length
+    );
     const insert = stmt(
-      `INSERT INTO symbols(id, lang, kind, name, file, line, col, signature, doc_comment, scope, text)
+      `INSERT INTO symbols(id, lang, kind, name, file, line, col, signature, doc_comment, scope)
        VALUES ${placeholders2}`
     );
     const binds = [];
@@ -584,8 +656,7 @@ function bulkInsertSymbolsWithStatement(stmt, maxSqlVars, rows) {
         r.col,
         r.signature,
         r.docComment,
-        r.scope,
-        r.text
+        r.scope
       );
     }
     insert.run(...binds);
@@ -598,7 +669,7 @@ function bulkInsertFtsWithStatement(stmt, maxSqlVars, ftsAvailable, rows) {
   for (const take of ladder) {
     const chunk = rows.slice(cursor, cursor + take);
     cursor += take;
-    const placeholders2 = chunk.map(() => "(?, ?)").join(", ");
+    const placeholders2 = getRowPlaceholders("(?, ?)", chunk.length);
     const insert = stmt(`INSERT INTO symbols_fts(rowid, text) VALUES ${placeholders2}`);
     const binds = [];
     for (const r of chunk) binds.push(r.id, r.text);
@@ -612,7 +683,7 @@ function bulkInsertVectorsWithStatement(stmt, maxSqlVars, rows) {
   for (const take of ladder) {
     const chunk = rows.slice(cursor, cursor + take);
     cursor += take;
-    const placeholders2 = chunk.map(() => "(?, ?)").join(", ");
+    const placeholders2 = getRowPlaceholders("(?, ?)", chunk.length);
     const insert = stmt(`INSERT INTO symbol_vectors(symbol_id, vector) VALUES ${placeholders2}`);
     const binds = [];
     for (const r of chunk) binds.push(r.id, r.vector);
@@ -626,7 +697,10 @@ function bulkInsertRefsWithStatement(stmt, maxSqlVars, refs) {
   for (const take of ladder) {
     const chunk = refs.slice(cursor, cursor + take);
     cursor += take;
-    const placeholders2 = chunk.map(() => "(?, ?, ?, ?, ?, ?, ?, ?)").join(", ");
+    const placeholders2 = getRowPlaceholders(
+      "(?, ?, ?, ?, ?, ?, ?, ?)",
+      chunk.length
+    );
     const insert = stmt(
       `INSERT INTO refs(from_id, to_name, to_id, call_type, line, lang, module, to_file)
        VALUES ${placeholders2}`
@@ -652,7 +726,7 @@ function bulkInsertRefsWithStatement(stmt, maxSqlVars, refs) {
 import * as fs2 from "node:fs/promises";
 import * as path2 from "node:path";
 function toPortablePath(file) {
-  return file.replace(/\\/g, "/");
+  return file.includes("\\") ? file.replace(/\\/g, "/") : file;
 }
 async function readTextIfPresent(file) {
   try {
@@ -956,9 +1030,16 @@ function createPackageLabeller(stored) {
 function buildPackageGraphNodes(fileCounts, files, packageOf) {
   const pkgNodes = /* @__PURE__ */ new Map();
   const fileToPkg = /* @__PURE__ */ new Map();
+  const getOrSetPkg = (file) => {
+    let pkg = fileToPkg.get(file);
+    if (pkg === void 0) {
+      pkg = packageOf(file);
+      fileToPkg.set(file, pkg);
+    }
+    return pkg;
+  };
   for (const { file, n } of fileCounts) {
-    const pkg = packageOf(file);
-    fileToPkg.set(file, pkg);
+    const pkg = getOrSetPkg(file);
     const node = pkgNodes.get(pkg);
     if (node) {
       node.symbolCount = (node.symbolCount ?? 0) + n;
@@ -974,8 +1055,7 @@ function buildPackageGraphNodes(fileCounts, files, packageOf) {
     }
   }
   for (const { file } of files) {
-    const pkg = packageOf(file);
-    fileToPkg.set(file, pkg);
+    const pkg = getOrSetPkg(file);
     const node = pkgNodes.get(pkg);
     if (node) {
       node.fileCount = (node.fileCount ?? 0) + 1;
@@ -1007,9 +1087,11 @@ function buildFileGraphNodeState(pkgSyms, localFiles, packageOf) {
   const ensureFileNode = (file) => {
     if (fileNodes.has(file)) return;
     const stats = fileStats.get(file);
+    const lastSlash = Math.max(file.lastIndexOf("/"), file.lastIndexOf("\\"));
+    const label = lastSlash === -1 ? file : file.slice(lastSlash + 1);
     fileNodes.set(file, {
       id: `file:${file}`,
-      label: file.replace(/\\/g, "/").split("/").pop() ?? file,
+      label,
       kind: "file",
       package: packageOf(file),
       file,
@@ -1024,17 +1106,25 @@ function buildFileGraphNodeState(pkgSyms, localFiles, packageOf) {
   return { fileNodes, symToFile, fileStats, ensureFileNode };
 }
 function buildSymbolGraphNodes(symById, relatedIds, localFiles, packageOf) {
-  const local = new Set(
-    [...typeof localFiles === "string" ? [localFiles] : localFiles].map(
-      (file) => file.replace(/\\/g, "/")
-    )
-  );
-  const isLocal = (file) => local.has(file.replace(/\\/g, "/"));
-  return [...relatedIds].map((id) => symById.get(id)).filter((symbol) => symbol !== void 0).sort((a, b) => {
-    const aExternal = isLocal(a.file) ? 0 : 1;
-    const bExternal = isLocal(b.file) ? 0 : 1;
+  const rawSet = typeof localFiles === "string" ? [localFiles] : localFiles;
+  const local = /* @__PURE__ */ new Set();
+  for (const f of rawSet) {
+    local.add(f.includes("\\") ? f.replace(/\\/g, "/") : f);
+  }
+  const isLocal = (file) => local.has(file.includes("\\") ? file.replace(/\\/g, "/") : file);
+  const matched = [];
+  for (const id of relatedIds) {
+    const s = symById.get(id);
+    if (s) {
+      matched.push({ ...s, isExt: !isLocal(s.file) });
+    }
+  }
+  matched.sort((a, b) => {
+    const aExternal = a.isExt ? 1 : 0;
+    const bExternal = b.isExt ? 1 : 0;
     return aExternal - bExternal || a.file.localeCompare(b.file) || a.line - b.line || a.id - b.id;
-  }).map((s) => ({
+  });
+  return matched.map((s) => ({
     id: `sym:${s.id}`,
     label: s.name,
     kind: "symbol",
@@ -1046,7 +1136,7 @@ function buildSymbolGraphNodes(symById, relatedIds, localFiles, packageOf) {
     line: s.line,
     signature: s.signature,
     scope: s.scope,
-    external: !isLocal(s.file)
+    external: s.isExt
   }));
 }
 function addWeightedEdge(edgeMap, source, target, callType, weight) {
@@ -1092,7 +1182,7 @@ function mapWriterRefRow(row) {
     line: row.line,
     // `lang`/`module`/`to_file` are absent from the narrower column lists some
     // queries select; `undefined` keeps those rows valid Refs.
-    lang: row.lang || void 0,
+    lang: row.lang ?? void 0,
     module: row.module ?? void 0,
     toFile: row.to_file ?? void 0
   };
@@ -1102,9 +1192,10 @@ function mapWriterRefRow(row) {
 var MAX_SQL_VARS = 900;
 function chunkedIdQuery(stmt, ids, buildSql, extraArgs = []) {
   const results = [];
+  let cursor = 0;
   for (const take of inListChunks(ids.length, MAX_SQL_VARS)) {
-    const chunk = padToInBucket(ids.slice(0, take));
-    ids = ids.slice(take);
+    const chunk = padToInBucket(ids.slice(cursor, cursor + take));
+    cursor += take;
     const sql = buildSql(placeholders(chunk.length));
     results.push(...stmt(sql).all(...chunk, ...extraArgs));
   }
@@ -1112,9 +1203,10 @@ function chunkedIdQuery(stmt, ids, buildSql, extraArgs = []) {
 }
 function chunkedIdScalar(stmt, ids, buildSql, extraArgs = []) {
   let total = 0;
+  let cursor = 0;
   for (const take of inListChunks(ids.length, MAX_SQL_VARS)) {
-    const chunk = padToInBucket(ids.slice(0, take));
-    ids = ids.slice(take);
+    const chunk = padToInBucket(ids.slice(cursor, cursor + take));
+    cursor += take;
     const sql = buildSql(placeholders(chunk.length));
     const rows = stmt(sql).all(...chunk, ...extraArgs);
     total += rows[0]?.n ?? 0;
@@ -1666,8 +1758,7 @@ function commitBatchWithStatement(stmtFn, maxSqlVars, ftsAvailable, vectorsAvail
         col: s.col,
         signature: s.signature,
         docComment: s.docComment,
-        scope: s.scope,
-        text: s.text
+        scope: s.scope
       });
       if (ftsAvailable) {
         ftsRows.push({
@@ -1679,7 +1770,7 @@ function commitBatchWithStatement(stmtFn, maxSqlVars, ftsAvailable, vectorsAvail
         vectorRows.push({
           id,
           vector: encodeVector(
-            embedText(s.text || buildIndexableText(s.name, s.signature, s.docComment))
+            embedText(buildIndexableText(s.name, s.signature, s.docComment))
           )
         });
       }
@@ -1773,8 +1864,7 @@ var CORE_TABLES_SQL = `
     col INTEGER NOT NULL,
     signature TEXT NOT NULL DEFAULT '',
     doc_comment TEXT NOT NULL DEFAULT '',
-    scope TEXT NOT NULL DEFAULT '',
-    text TEXT NOT NULL DEFAULT ''
+    scope TEXT NOT NULL DEFAULT ''
     );
 `;
 var FILE_INDEX_SQL = [
@@ -1849,7 +1939,11 @@ function getNamespaceDeclarationsWithStatement(stmtFn) {
 }
 function getFilePackagesWithStatement(stmtFn) {
   const rows = stmtFn("SELECT file, package FROM files WHERE package != ''").all();
-  return new Map(rows.map((row) => [row.file, row.package]));
+  const map = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    map.set(row.file, row.package);
+  }
+  return map;
 }
 function getUnresolvedImportsWithStatement(stmtFn, maxSqlVars, onlyFiles) {
   const base = `SELECT DISTINCT s.file AS fromFile, r.lang AS lang, r.module AS module
@@ -2064,8 +2158,15 @@ function buildWriterSearchWhere(query, filter) {
   }
   if (query.trim()) {
     const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
-    conditions.push(`(${tokens.map(() => "text LIKE ? ESCAPE '\\'").join(" OR ")})`);
-    for (const token of tokens) values.push(`%${escapeLike(token)}%`);
+    conditions.push(
+      `(${tokens.map(
+        () => "(name LIKE ? ESCAPE '\\' OR signature LIKE ? ESCAPE '\\' OR doc_comment LIKE ? ESCAPE '\\')"
+      ).join(" OR ")})`
+    );
+    for (const token of tokens) {
+      const like = `%${escapeLike(token)}%`;
+      values.push(like, like, like);
+    }
   }
   return { where: conditions.length ? `WHERE ${conditions.join(" AND ")}` : "", values };
 }
@@ -2142,8 +2243,11 @@ function searchRankedWithStatement(stmtFn, searchFn, ftsAvailable, vectorsAvaila
   const conditions = ["symbols_fts MATCH ?"];
   const values = [match];
   for (const shortTok of shortTokens) {
-    conditions.push("s.text LIKE ? ESCAPE '\\'");
-    values.push(`%${escapeLike(shortTok)}%`);
+    const like = `%${escapeLike(shortTok)}%`;
+    conditions.push(
+      "(s.name LIKE ? ESCAPE '\\' OR s.signature LIKE ? ESCAPE '\\' OR s.doc_comment LIKE ? ESCAPE '\\')"
+    );
+    values.push(like, like, like);
   }
   if (effectiveKind) {
     conditions.push("s.kind = ?");
@@ -2442,11 +2546,11 @@ var IndexStore = class _IndexStore {
       }
     ];
     for (const { table, columns } of expected) {
-      const present = new Set(
-        this.db.prepare(`PRAGMA table_info(${table})`).all().flatMap(
-          (row) => typeof row.name === "string" ? [row.name] : []
-        )
-      );
+      const rows = this.db.prepare(`PRAGMA table_info(${table})`).all();
+      const present = /* @__PURE__ */ new Set();
+      for (const row of rows) {
+        if (typeof row.name === "string") present.add(row.name);
+      }
       if (present.size === 0) continue;
       for (const [name, type] of columns) {
         if (present.has(name)) continue;
@@ -2454,6 +2558,31 @@ var IndexStore = class _IndexStore {
       }
     }
   }
+  /**
+   * P4: `symbols.text` duplicated name + signature + doc_comment (~19 MB on
+   * the live index) and is derived on demand now. In-place DROP COLUMN — no
+   * SCHEMA_VERSION bump, so no wipe-and-reparse. Best-effort: a busy or
+   * SQLite-without-DROP-COLUMN open leaves the column in place, where new
+   * inserts simply default it to '' and the next open retries.
+   */
+  dropDeprecatedSymbolsColumns() {
+    if (this.getMetadata(_IndexStore.SYMBOLS_TEXT_DROPPED_KEY) !== void 0) return;
+    const present = new Set(
+      this.db.prepare("PRAGMA table_info(symbols)").all().flatMap(
+        (row) => typeof row.name === "string" ? [row.name] : []
+      )
+    );
+    if (present.size === 0) return;
+    if (!present.has("text")) {
+      this.setMetadata(_IndexStore.SYMBOLS_TEXT_DROPPED_KEY, "1");
+      return;
+    }
+    try {
+      this.db.exec("ALTER TABLE symbols DROP COLUMN text");
+      this.setMetadata(_IndexStore.SYMBOLS_TEXT_DROPPED_KEY, "1");
+    } catch {
+    }
+  }
   initSchema() {
     this.db.exec(METADATA_TABLE_SQL);
     const storedRows = this.stmt("SELECT value FROM metadata WHERE key = ?").all("version");
@@ -2479,6 +2608,7 @@ var IndexStore = class _IndexStore {
     this.db.exec(CORE_TABLES_SQL);
     this.db.exec(REFS_TABLE_SQL);
     this.repairMissingColumns();
+    this.dropDeprecatedSymbolsColumns();
     for (const sql of FILE_INDEX_SQL) this.db.exec(sql);
     for (const sql of SYMBOL_INDEX_SQL) this.db.exec(sql);
     for (const sql of REFS_INDEX_SQL) this.db.exec(sql);
@@ -2538,6 +2668,10 @@ var IndexStore = class _IndexStore {
   }
   static NEXT_SYMBOL_ID_KEY = "next_symbol_id";
   static MAX_SQL_VARS = 900;
+  /** P2: persisted FTS-mutation churn counter — see {@link optimizeFtsIfNeeded}. */
+  static FTS_CHURN_KEY = "fts_churn_since_maintain";
+  /** P4: one-shot marker that the deprecated symbols.text column is gone. */
+  static SYMBOLS_TEXT_DROPPED_KEY = "symbols_text_dropped";
   ensureNextSymbolIdSeeded() {
     const existing = this.stmt("SELECT value FROM metadata WHERE key = ?").get(
       _IndexStore.NEXT_SYMBOL_ID_KEY
@@ -2608,8 +2742,7 @@ var IndexStore = class _IndexStore {
             col: s.col,
             signature: s.signature,
             docComment: s.docComment,
-            scope: s.scope,
-            text: s.text
+            scope: s.scope
           });
           if (this.ftsAvailable) {
             ftsRows.push({ id, text: buildIndexableText(s.name, s.signature, s.docComment) });
@@ -2618,7 +2751,7 @@ var IndexStore = class _IndexStore {
             vectorRows.push({
               id,
               vector: encodeVector(
-                embedText(s.text || buildIndexableText(s.name, s.signature, s.docComment))
+                embedText(buildIndexableText(s.name, s.signature, s.docComment))
               )
             });
           }
@@ -2638,6 +2771,7 @@ var IndexStore = class _IndexStore {
             vectorRows
           );
         }
+        this.recordFtsChurn(symbols.length);
         this.commitWriteTransaction(ownsTransaction);
         return result;
       } catch (err) {
@@ -2662,7 +2796,10 @@ var IndexStore = class _IndexStore {
             "DELETE FROM symbol_vectors WHERE symbol_id IN (SELECT id FROM symbols WHERE file = ?)"
           ).run(file);
         }
-        this.stmt("DELETE FROM symbols WHERE file = ?").run(file);
+        const deletedChanges = Number(
+          this.stmt("DELETE FROM symbols WHERE file = ?").run(file).changes
+        );
+        this.recordFtsChurn(deletedChanges);
         this.resolveRefsForNamesUnsafe(affectedNames);
         this.commitWriteTransaction(ownsTransaction);
       } catch (error) {
@@ -2690,7 +2827,10 @@ var IndexStore = class _IndexStore {
         this.stmt("DELETE FROM refs WHERE from_id IN (SELECT id FROM symbols WHERE file = ?)").run(
           file
         );
-        this.stmt("DELETE FROM symbols WHERE file = ?").run(file);
+        const deletedChanges = Number(
+          this.stmt("DELETE FROM symbols WHERE file = ?").run(file).changes
+        );
+        this.recordFtsChurn(deletedChanges);
         this.stmt("DELETE FROM files WHERE file = ?").run(file);
         this.resolveRefsForNamesUnsafe(affectedNames);
         this.commitWriteTransaction(ownsTransaction);
@@ -2859,6 +2999,19 @@ var IndexStore = class _IndexStore {
     return this.runWithRetry(() => {
       const ownsTransaction = this.beginWriteTransaction();
       try {
+        const owned = options.deleteForFiles?.length ?? 0;
+        let churnRows = entries.reduce((sum, e) => sum + e.symbols.length, 0);
+        if (owned > 0) {
+          let cursor = 0;
+          for (const take of inListChunks(owned, Math.floor(_IndexStore.MAX_SQL_VARS / 4))) {
+            const bucket = options.deleteForFiles.slice(cursor, cursor + take);
+            cursor += take;
+            const row = this.stmt(
+              `SELECT COUNT(*) AS n FROM symbols WHERE file IN (${placeholders(bucket.length)})`
+            ).get(...bucket);
+            churnRows += Number(row?.n ?? 0);
+          }
+        }
         const result = commitBatchWithStatement(
           (sql) => this.stmt(sql),
           _IndexStore.MAX_SQL_VARS,
@@ -2870,6 +3023,7 @@ var IndexStore = class _IndexStore {
           entries,
           options
         );
+        this.recordFtsChurn(churnRows);
         this.commitWriteTransaction(ownsTransaction);
         return result;
       } catch (err) {
@@ -2910,7 +3064,10 @@ var IndexStore = class _IndexStore {
         this.stmt("DELETE FROM refs WHERE from_id IN (SELECT id FROM symbols WHERE file = ?)").run(
           meta.file
         );
-        this.stmt("DELETE FROM symbols WHERE file = ?").run(meta.file);
+        const deletedChanges = Number(
+          this.stmt("DELETE FROM symbols WHERE file = ?").run(meta.file).changes
+        );
+        this.recordFtsChurn(deletedChanges);
         this.stmt(
           `INSERT INTO files(file, lang, mtime_ms, content_hash, symbol_count, last_indexed)
            VALUES (?, ?, ?, ?, ?, ?)
@@ -2942,6 +3099,54 @@ var IndexStore = class _IndexStore {
     } catch {
     }
   }
+  /**
+   * P2: churn-gated FTS5 segment maintenance.
+   *
+   * FTS5 postings only compact when FTS5 itself merges them: every delete
+   * leaves tombstone postings in the segments, and neither VACUUM nor
+   * `PRAGMA optimize` reclaims them. Measured on the live index (2026-08-30):
+   * one delete+reinsert cycle grew symbols_fts_data 174.9→212.8 MB, while the
+   * FTS5 'optimize'/'rebuild' merge resets it (rebuild: 212.9→28.2 MB in
+   * 1.26 s for 131k rows). 'optimize' is the recurring command — an
+   * incremental merge that discards deleted docs — and only runs once churn
+   * crosses the gate, so a clean index never pays for it.
+   *
+   * Follows the {@link checkpointWal} contract: best-effort, returns whether
+   * it ran, safe to call from the daemon's single-threaded idle path.
+   */
+  optimizeFtsIfNeeded(options = {}) {
+    if (!this.ftsAvailable) return false;
+    try {
+      const minChurnRatio = options.minChurnRatio ?? 0.1;
+      const minChurnRows = options.minChurnRows ?? 5e3;
+      const churn = Number(this.getMetadata(_IndexStore.FTS_CHURN_KEY) ?? "0") || 0;
+      const liveRows = Number(
+        this.stmt("SELECT COUNT(*) AS n FROM symbols").get()?.n ?? 0
+      );
+      if (churn < Math.max(minChurnRows, liveRows * minChurnRatio)) return false;
+      this.runWithRetry(() => {
+        this.stmt(`INSERT INTO symbols_fts(symbols_fts) VALUES('optimize')`).run();
+      });
+      this.setMetadata(_IndexStore.FTS_CHURN_KEY, "0");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Best-effort churn bookkeeping for {@link optimizeFtsIfNeeded}. Counts the
+   * FTS rows a mutation inserts or deletes so the maintenance gate can fire
+   * after real churn, not on a timer. Persisted in metadata so the counter
+   * survives store open/close cycles in the daemon pool.
+   */
+  recordFtsChurn(rows) {
+    if (rows <= 0 || !this.ftsAvailable) return;
+    try {
+      const current = Number(this.getMetadata(_IndexStore.FTS_CHURN_KEY) ?? "0") || 0;
+      this.setMetadata(_IndexStore.FTS_CHURN_KEY, String(current + rows));
+    } catch {
+    }
+  }
   /**
    * P4.14: best-effort WAL checkpoint for idle-time maintenance.
    *
@@ -3069,15 +3274,11 @@ function rotl64(x, n) {
   const v = x & MASK64;
   return (v << BigInt(n) | v >> BigInt(64 - n)) & MASK64;
 }
-function readU64LE(buf, off) {
-  let v = 0n;
-  for (let i = 7; i >= 0; i--) {
-    v = v << 8n | BigInt(buf[off + i] ?? 0);
-  }
-  return v & MASK64;
+function readU64LE(view, off) {
+  return view.getBigUint64(off, true);
 }
-function readU32LE(buf, off) {
-  return (BigInt(buf[off] ?? 0) | BigInt(buf[off + 1] ?? 0) << 8n | BigInt(buf[off + 2] ?? 0) << 16n | BigInt(buf[off + 3] ?? 0) << 24n) & MASK64;
+function readU32LE(view, off) {
+  return BigInt(view.getUint32(off, true));
 }
 function xxh64Round(acc, lane) {
   return mul64(rotl64(acc + mul64(lane, PRIME64_2) & MASK64, 31), PRIME64_1);
@@ -3087,6 +3288,7 @@ function xxh64MergeRound(acc, val) {
 }
 function xxhash64Hex(buf, explicitLen) {
   const length = explicitLen ?? buf.length;
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
   let h;
   let off = 0;
   if (length >= 32) {
@@ -3096,10 +3298,10 @@ function xxhash64Hex(buf, explicitLen) {
     let v4 = 0n - PRIME64_1 & MASK64;
     const end32 = length - 32;
     while (off <= end32) {
-      v1 = xxh64Round(v1, readU64LE(buf, off));
-      v2 = xxh64Round(v2, readU64LE(buf, off + 8));
-      v3 = xxh64Round(v3, readU64LE(buf, off + 16));
-      v4 = xxh64Round(v4, readU64LE(buf, off + 24));
+      v1 = xxh64Round(v1, readU64LE(view, off));
+      v2 = xxh64Round(v2, readU64LE(view, off + 8));
+      v3 = xxh64Round(v3, readU64LE(view, off + 16));
+      v4 = xxh64Round(v4, readU64LE(view, off + 24));
       off += 32;
     }
     h = rotl64(v1, 1) + rotl64(v2, 7) + rotl64(v3, 12) + rotl64(v4, 18) & MASK64;
@@ -3112,12 +3314,12 @@ function xxhash64Hex(buf, explicitLen) {
   }
   h = h + BigInt(length) & MASK64;
   while (off + 8 <= length) {
-    const k1 = xxh64Round(0n, readU64LE(buf, off));
+    const k1 = xxh64Round(0n, readU64LE(view, off));
     h = mul64(rotl64(h ^ k1, 27), PRIME64_1) + PRIME64_4 & MASK64;
     off += 8;
   }
   if (off + 4 <= length) {
-    h = mul64(rotl64(h ^ mul64(readU32LE(buf, off), PRIME64_1), 23), PRIME64_2) + PRIME64_3 & MASK64;
+    h = mul64(rotl64(h ^ mul64(readU32LE(view, off), PRIME64_1), 23), PRIME64_2) + PRIME64_3 & MASK64;
     off += 4;
   }
   while (off < length) {
@@ -3191,8 +3393,10 @@ var ModuleResolver = class {
     for (const { name, file } of namespaces) {
       const lang = detectLang(file);
       if (!lang) continue;
-      const key = `${languageFamily(lang)}:${normalizeNamespace(name)}`;
-      if (normalizeNamespace(name) && !this.byNamespace.has(key)) {
+      const norm = normalizeNamespace(name);
+      if (!norm) continue;
+      const key = `${languageFamily(lang)}:${norm}`;
+      if (!this.byNamespace.has(key)) {
         this.byNamespace.set(key, file);
       }
     }
@@ -3620,7 +3824,7 @@ var ParserWorkerPool = class {
    */
   async reparseInline(batch, orphaned, workerId) {
     try {
-      const { parseFileContent } = await import("./parser-dispatch-QH4XPGG6.js");
+      const { parseFileContent } = await import("./parser-dispatch-X62UWXJS.js");
       for (const item of orphaned) {
         if (batch.settled) return;
         try {
@@ -4409,4 +4613,4 @@ export {
   incomingCallsService,
   outgoingCallsService
 };
-//# sourceMappingURL=chunk-DA4KNE2H.js.map
+//# sourceMappingURL=chunk-TFEGJDH5.js.map