@wrongstack/tools 0.296.3 → 0.297.0

package/dist/builtin.js

@@ -479,6 +479,7 @@ var init_process_registry = __esm({
       }
       /** Get all tracked processes. */
       list() {
+        this._pruneAllStale();
         return Array.from(this.processes.values());
       }
       /** Get processes filtered by name (e.g. 'bash', 'exec'). */
@@ -509,6 +510,7 @@ var init_process_registry = __esm({
        * Combined stats for observability — used by /ps and the TUI status bar.
        */
       stats() {
+        this._pruneAllStale();
         return {
           activeCount: this.activeCount,
           backgroundCount: this.activeBackgroundCount,
@@ -748,6 +750,19 @@ var init_process_registry = __esm({
           this.processes.delete(pid);
         }
       }
+      /**
+       * Remove every stale entry, not just one PID. `list()`/`stats()` — the
+       * surfaces the TUI status bar and `/ps` poll — must prune too: a child
+       * whose 'close' event never fires (e.g. Windows grandchildren holding stdio
+       * open) would otherwise linger in the registry until someone looks up its
+       * exact PID, and PID reuse meanwhile makes `get()`/`kill()` target the
+       * wrong process. RAM-leak audit 2026-07-31, MEDIUM.
+       */
+      _pruneAllStale() {
+        for (const [pid, entry] of this.processes) {
+          if (this._isStaleEntry(entry)) this.processes.delete(pid);
+        }
+      }
     };
   }
 });
@@ -4893,16 +4908,16 @@ var init_legacy_bridge = __esm({
 });
 
 // src/codebase-index/languages.ts
-import * as path14 from "node:path";
+import * as path18 from "node:path";
 function detectLang(file) {
-  const base = path14.basename(file);
+  const base = path18.basename(file);
   const lowerBase = base.toLowerCase();
   if (lowerBase.endsWith(".d.ts") || lowerBase.endsWith(".d.mts") || lowerBase.endsWith(".d.cts")) {
     return "ts";
   }
   const special = SPECIAL_FILENAMES[lowerBase];
   if (special) return special;
-  const ext = path14.extname(base).toLowerCase();
+  const ext = path18.extname(base).toLowerCase();
   if (!ext) return null;
   return EXT_TO_LANG[ext] ?? null;
 }
@@ -5238,10 +5253,10 @@ __export(go_parser_exports, {
   detectLang: () => detectLang,
   parseSymbols: () => parseSymbols2
 });
-import { spawn as spawn4 } from "node:child_process";
-import * as os5 from "node:os";
-import * as path15 from "node:path";
-import * as fs10 from "node:fs/promises";
+import { spawn as spawn5 } from "node:child_process";
+import * as os6 from "node:os";
+import * as path19 from "node:path";
+import * as fs14 from "node:fs/promises";
 async function parseSymbols2(opts) {
   const { file, content, lang } = opts;
   try {
@@ -5313,16 +5328,16 @@ async function syncGoParse(filePath, content, lang) {
   try {
     let scriptPath = _cachedGoScriptPath;
     if (!scriptPath) {
-      const tmpDir = await fs10.mkdtemp(path15.join(os5.tmpdir(), "ws-go-parse-"));
-      scriptPath = path15.join(tmpDir, "parse.go");
-      await fs10.writeFile(scriptPath, GO_PARSE_SCRIPT, "utf8");
+      const tmpDir = await fs14.mkdtemp(path19.join(os6.tmpdir(), "ws-go-parse-"));
+      scriptPath = path19.join(tmpDir, "parse.go");
+      await fs14.writeFile(scriptPath, GO_PARSE_SCRIPT, "utf8");
       _cachedGoScriptPath = scriptPath;
     }
     const goBinary = resolveWin32Command("go");
     const goResult = await new Promise(
       (resolve16, reject) => {
         let settled = false;
-        const proc = spawn4(goBinary, ["run", scriptPath], {
+        const proc = spawn5(goBinary, ["run", scriptPath], {
           stdio: ["pipe", "pipe", "pipe"],
           windowsHide: true
         });
@@ -5925,10 +5940,10 @@ __export(py_parser_exports, {
   detectLang: () => detectLang,
   parseSymbols: () => parseSymbols4
 });
-import { spawn as spawn5 } from "node:child_process";
-import * as fs11 from "node:fs/promises";
-import * as os6 from "node:os";
-import * as path16 from "node:path";
+import { spawn as spawn6 } from "node:child_process";
+import * as fs15 from "node:fs/promises";
+import * as os7 from "node:os";
+import * as path20 from "node:path";
 async function parseSymbols4(opts) {
   const { file, content, lang } = opts;
   try {
@@ -5950,7 +5965,7 @@ async function resolvePython() {
 function commandIsAvailable(command) {
   return new Promise((resolve16) => {
     let settled = false;
-    const proc = spawn5(command, ["--version"], {
+    const proc = spawn6(command, ["--version"], {
       stdio: "ignore",
       windowsHide: true
     });
@@ -5972,7 +5987,7 @@ function commandIsAvailable(command) {
 function spawnPyParser(pyBinary, scriptPath, filePath, content) {
   return new Promise((resolve16, reject) => {
     let settled = false;
-    const proc = spawn5(pyBinary, [scriptPath, filePath], {
+    const proc = spawn6(pyBinary, [scriptPath, filePath], {
       stdio: ["pipe", "pipe", "pipe"],
       windowsHide: true
     });
@@ -6006,10 +6021,10 @@ function spawnPyParser(pyBinary, scriptPath, filePath, content) {
 async function syncPyParse(filePath, content, lang) {
   try {
     if (!_cachedScriptPath) {
-      const tmpDir = path16.join(os6.tmpdir(), "ws-py-parse");
-      await fs11.mkdir(tmpDir, { recursive: true });
-      _cachedScriptPath = path16.join(tmpDir, "parse.py");
-      await fs11.writeFile(_cachedScriptPath, PY_PARSE_SCRIPT, "utf8");
+      const tmpDir = path20.join(os7.tmpdir(), "ws-py-parse");
+      await fs15.mkdir(tmpDir, { recursive: true });
+      _cachedScriptPath = path20.join(tmpDir, "parse.py");
+      await fs15.writeFile(_cachedScriptPath, PY_PARSE_SCRIPT, "utf8");
     }
     cachedPyBinary ??= resolvePython();
     const pyBinary = await cachedPyBinary;
@@ -6263,10 +6278,10 @@ __export(rs_parser_exports, {
   detectLang: () => detectLang,
   parseSymbols: () => parseSymbols5
 });
-import { expectDefined as expectDefined2 } from "@wrongstack/core/utils";
-import { execFile, spawn as spawn6 } from "node:child_process";
-import * as fs12 from "node:fs/promises";
-import * as path17 from "node:path";
+import { expectDefined as expectDefined3 } from "@wrongstack/core/utils";
+import { execFile, spawn as spawn7 } from "node:child_process";
+import * as fs16 from "node:fs/promises";
+import * as path21 from "node:path";
 async function parseSymbols5(opts) {
   const { file, content, lang } = opts;
   const nativeAvailable = await checkNativeParser();
@@ -6288,7 +6303,7 @@ function checkNativeParser() {
   nativeParserAvailability ??= (async () => {
     try {
       await probe("rustc", ["--version"]);
-      const toolsDir = path17.join(process.cwd(), "tools");
+      const toolsDir = path21.join(process.cwd(), "tools");
       await probe(
         "cargo",
         [
@@ -6297,7 +6312,7 @@ function checkNativeParser() {
           "--format-version",
           "1",
           "--manifest-path",
-          path17.join(toolsDir, "Cargo.toml")
+          path21.join(toolsDir, "Cargo.toml")
         ]
       );
       return true;
@@ -6309,17 +6324,17 @@ function checkNativeParser() {
 }
 async function tryNativeParse(file, content) {
   try {
-    const toolsDir = path17.join(process.cwd(), "tools");
-    const crateDir = path17.join(toolsDir, "syn-parser");
-    const tmpFile = path17.join(crateDir, "src", "input.rs");
-    await fs12.writeFile(tmpFile, content, "utf8");
+    const toolsDir = path21.join(process.cwd(), "tools");
+    const crateDir = path21.join(toolsDir, "syn-parser");
+    const tmpFile = path21.join(crateDir, "src", "input.rs");
+    await fs16.writeFile(tmpFile, content, "utf8");
     const cargoBinary = resolveWin32Command("cargo");
     const result = await new Promise(
       (resolve16, reject) => {
         let settled = false;
-        const proc = spawn6(
+        const proc = spawn7(
           cargoBinary,
-          ["run", "--manifest-path", path17.join(toolsDir, "Cargo.toml")],
+          ["run", "--manifest-path", path21.join(toolsDir, "Cargo.toml")],
           {
             cwd: process.cwd(),
             stdio: ["pipe", "pipe", "pipe"],
@@ -6378,7 +6393,7 @@ function regexParse(opts) {
     let hi = lineOffsets2.length - 1;
     while (lo < hi) {
       const mid = lo + hi + 1 >>> 1;
-      if (expectDefined2(lineOffsets2[mid]) <= offset) lo = mid;
+      if (expectDefined3(lineOffsets2[mid]) <= offset) lo = mid;
       else hi = mid - 1;
     }
     return lo + 1;
@@ -6390,7 +6405,7 @@ function regexParse(opts) {
   for (const pattern of RS_PATTERNS) {
     pattern.regex.lastIndex = 0;
     for (let match = pattern.regex.exec(content); match !== null; match = pattern.regex.exec(content)) {
-      const name = expectDefined2(match[1]);
+      const name = expectDefined3(match[1]);
       const offset = match.index ?? 0;
       const line = lineFromOffset(offset);
       const col = offset - (lineOffsets2[line - 1] ?? 0);
@@ -6447,8 +6462,8 @@ __export(json_parser_exports, {
   detectLang: () => detectLang,
   parseSymbols: () => parseSymbols6
 });
-import { expectDefined as expectDefined3 } from "@wrongstack/core/utils";
-import * as path18 from "node:path";
+import { expectDefined as expectDefined4 } from "@wrongstack/core/utils";
+import * as path22 from "node:path";
 function parseSymbols6(opts) {
   const { file, content, lang } = opts;
   try {
@@ -6460,7 +6475,7 @@ function parseSymbols6(opts) {
 function regexParse2(opts) {
   const { file, content, lang } = opts;
   const symbols = [];
-  const basename12 = path18.basename(file).toLowerCase();
+  const basename12 = path22.basename(file).toLowerCase();
   const isPackageJson = basename12 === "package.json";
   const isTsconfig = basename12 === "tsconfig.json" || basename12 === "tsconfig.build.json";
   const isJsonSchema = content.includes("$schema") || content.includes("$id") || content.includes("$ref");
@@ -6475,22 +6490,22 @@ function regexParse2(opts) {
     let hi = lineOffsets2.length - 1;
     while (lo < hi) {
       const mid = lo + hi + 1 >>> 1;
-      if (expectDefined3(lineOffsets2[mid]) <= offset) lo = mid;
+      if (expectDefined4(lineOffsets2[mid]) <= offset) lo = mid;
       else hi = mid - 1;
     }
     return lo + 1;
   }
   const rootMatch = content.match(/^\s*\{/m);
   if (rootMatch) {
-    const offset = expectDefined3(rootMatch.index);
+    const offset = expectDefined4(rootMatch.index);
     const line = lineFromOffset(offset);
     symbols.push(
       makeSymbol({
-        name: path18.basename(file),
+        name: path22.basename(file),
         kind: "object",
         line,
         col: 0,
-        signature: `"${path18.basename(file)}" = { ... }`,
+        signature: `"${path22.basename(file)}" = { ... }`,
         file,
         lang
       })
@@ -6498,7 +6513,7 @@ function regexParse2(opts) {
   }
   const topLevelKeyRegex = /^\s*"([^"]+)"\s*:/gm;
   for (let match = topLevelKeyRegex.exec(content); match !== null; match = topLevelKeyRegex.exec(content)) {
-    const key = expectDefined3(match[1]);
+    const key = expectDefined4(match[1]);
     const offset = match.index ?? 0;
     const line = lineFromOffset(offset);
     const col = offset - (lineOffsets2[line - 1] ?? 0);
@@ -6545,7 +6560,7 @@ function regexParse2(opts) {
   const defsRegex = /"\$defs"\s*:|"\$defs"\s*:/g;
   const defsMatch = defsRegex.exec(content);
   if (defsMatch !== null) {
-    const offset = expectDefined3(defsMatch.index);
+    const offset = expectDefined4(defsMatch.index);
     const line = lineFromOffset(offset);
     symbols.push(
       makeSymbol({
@@ -6570,7 +6585,7 @@ function regexParse2(opts) {
     for (let match = pat.exec(content); match !== null; match = pat.exec(content)) {
       const offset = match.index ?? 0;
       const line = lineFromOffset(offset);
-      const key = match[0]?.match(/"([^"]+)"/)?.[1] ?? expectDefined3(match[0]);
+      const key = match[0]?.match(/"([^"]+)"/)?.[1] ?? expectDefined4(match[0]);
       symbols.push(
         makeSymbol({
           name: key,
@@ -6589,12 +6604,12 @@ function regexParse2(opts) {
 function extractPackageScripts(content, symbols, file, lang, lineOffsets2, lineFromOffset) {
   const scriptsBlockRegex = /"scripts"\s*:\s*\{([^}]+)\}/g;
   for (let match = scriptsBlockRegex.exec(content); match !== null; match = scriptsBlockRegex.exec(content)) {
-    const blockContent = expectDefined3(match[0]);
+    const blockContent = expectDefined4(match[0]);
     const blockOffset = match.index ?? 0;
     const scriptKeyRegex = /"(\w[\w-]*)"\s*:/g;
     for (let scriptMatch = scriptKeyRegex.exec(blockContent); scriptMatch !== null; scriptMatch = scriptKeyRegex.exec(blockContent)) {
-      const key = expectDefined3(scriptMatch[1]);
-      const keyOffset = blockOffset + expectDefined3(scriptMatch.index);
+      const key = expectDefined4(scriptMatch[1]);
+      const keyOffset = blockOffset + expectDefined4(scriptMatch.index);
       const line = lineFromOffset(keyOffset);
       symbols.push(
         makeSymbol({
@@ -6613,12 +6628,12 @@ function extractPackageScripts(content, symbols, file, lang, lineOffsets2, lineF
 function extractCompilerOptions(content, symbols, file, lang, lineOffsets2, parentLine, lineFromOffset) {
   const optsBlockRegex = /"compilerOptions"\s*:\s*\{([^}]+)\}/g;
   for (let match = optsBlockRegex.exec(content); match !== null; match = optsBlockRegex.exec(content)) {
-    const blockContent = expectDefined3(match[0]);
+    const blockContent = expectDefined4(match[0]);
     const blockOffset = match.index ?? 0;
     const optKeyRegex = /"(\w[\w]*)"\s*:/g;
     for (let optMatch = optKeyRegex.exec(blockContent); optMatch !== null; optMatch = optKeyRegex.exec(blockContent)) {
-      const key = expectDefined3(optMatch[1]);
-      const keyOffset = blockOffset + expectDefined3(optMatch.index);
+      const key = expectDefined4(optMatch[1]);
+      const keyOffset = blockOffset + expectDefined4(optMatch.index);
       const line = lineFromOffset(keyOffset);
       if (line <= parentLine) continue;
       symbols.push(
@@ -6663,7 +6678,7 @@ __export(yaml_parser_exports, {
   detectLang: () => detectLang,
   parseSymbols: () => parseSymbols7
 });
-import { expectDefined as expectDefined4, truncate } from "@wrongstack/core/utils";
+import { expectDefined as expectDefined5, truncate } from "@wrongstack/core/utils";
 function parseSymbols7(opts) {
   const { file, content, lang } = opts;
   try {
@@ -6685,14 +6700,14 @@ function regexParse3(opts) {
     let hi = lineOffsets2.length - 1;
     while (lo < hi) {
       const mid = lo + hi + 1 >>> 1;
-      if (expectDefined4(lineOffsets2[mid]) <= offset) lo = mid;
+      if (expectDefined5(lineOffsets2[mid]) <= offset) lo = mid;
       else hi = mid - 1;
     }
     return lo + 1;
   }
   const anchorRegex = /&(\w[\w-]*)/g;
   for (let match = anchorRegex.exec(content); match !== null; match = anchorRegex.exec(content)) {
-    const name = expectDefined4(match[1]);
+    const name = expectDefined5(match[1]);
     const offset = match.index ?? 0;
     const line = lineFromOffset(offset);
     const col = offset - (lineOffsets2[line - 1] ?? 0);
@@ -6710,7 +6725,7 @@ function regexParse3(opts) {
   }
   const aliasRegex = /\*(\w[\w-]*)/g;
   for (let match = aliasRegex.exec(content); match !== null; match = aliasRegex.exec(content)) {
-    const name = expectDefined4(match[1]);
+    const name = expectDefined5(match[1]);
     const offset = match.index ?? 0;
     const line = lineFromOffset(offset);
     const col = offset - (lineOffsets2[line - 1] ?? 0);
@@ -6745,7 +6760,7 @@ function regexParse3(opts) {
   }
   const listItemRegex = /^-(\s+)([^:#\s][^:#\s]*)\s*:/gm;
   for (let match = listItemRegex.exec(content); match !== null; match = listItemRegex.exec(content)) {
-    const key = expectDefined4(match[2]);
+    const key = expectDefined5(match[2]);
     const offset = match.index ?? 0;
     const line = lineFromOffset(offset);
     const col = offset - (lineOffsets2[line - 1] ?? 0);
@@ -6765,7 +6780,7 @@ function regexParse3(opts) {
   }
   const blockScalarRegex = /^(\s*)([^:#\s][^:#\s]*)\s*:\s*[|>](\s|$)/gm;
   for (let match = blockScalarRegex.exec(content); match !== null; match = blockScalarRegex.exec(content)) {
-    const key = expectDefined4(match[2]);
+    const key = expectDefined5(match[2]);
     const offset = match.index ?? 0;
     const line = lineFromOffset(offset);
     const col = offset - (lineOffsets2[line - 1] ?? 0);
@@ -9770,10 +9785,12 @@ var browserTools = [
 for (const tool of browserTools) tool.icon = "web";
 for (const tool of browserTools) tool.timeoutMs ??= 6e4;
 
-// src/codebase-index/background-indexer.ts
-import * as fs18 from "node:fs";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
-import { Worker } from "node:worker_threads";
+// src/codebase-index/project-server-client.ts
+import { spawn as spawn4 } from "node:child_process";
+import * as fs12 from "node:fs";
+import * as net3 from "node:net";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { checkUnixSocketPath } from "@wrongstack/core/utils";
 
 // src/codebase-index/circuit-breaker.ts
 var CircuitOpenError = class extends Error {
@@ -9855,117 +9872,18 @@ var IndexCircuitBreaker = class {
 };
 var indexCircuitBreaker = new IndexCircuitBreaker();
 
-// src/codebase-index/indexer.ts
-import { expectDefined as expectDefined6 } from "@wrongstack/core/utils";
-import { execFile as execFile2 } from "node:child_process";
-import * as fs15 from "node:fs/promises";
-import { availableParallelism } from "node:os";
-import * as path22 from "node:path";
-import {
-  DEFAULT_WALK_IGNORE_DIRS,
-  indexParallelBatchSize,
-  isFrugalPerf
-} from "@wrongstack/core/utils";
-
-// src/codebase-index/gitignore.ts
-import * as fs9 from "node:fs/promises";
-import * as path13 from "node:path";
-import { compileGlob } from "@wrongstack/core/utils";
-function globBody(glob) {
-  return compileGlob(glob).source.replace(/^\^/, "").replace(/\$$/, "");
-}
-function compileGitignore(lines) {
-  const rules = [];
-  for (const raw of lines) {
-    let line = raw.replace(/\r$/, "");
-    if (!line.trim() || line.trimStart().startsWith("#")) continue;
-    line = line.trim();
-    let negated = false;
-    if (line.startsWith("!")) {
-      negated = true;
-      line = line.slice(1);
-    }
-    let dirOnly = false;
-    if (line.endsWith("/")) {
-      dirOnly = true;
-      line = line.slice(0, -1);
-    }
-    if (!line) continue;
-    const anchored = line.startsWith("/") || line.includes("/");
-    if (line.startsWith("/")) line = line.slice(1);
-    const body = globBody(line);
-    const prefix = anchored ? "^" : "(?:^|.*/)";
-    rules.push({
-      eqOrUnder: new RegExp(`${prefix}${body}(?:/.*)?$`),
-      under: new RegExp(`${prefix}${body}/.*$`),
-      negated,
-      dirOnly
-    });
-  }
-  return (relPath, isDir) => {
-    const p = relPath.replace(/\\/g, "/").replace(/^\/+/, "");
-    let ignored = false;
-    for (const r of rules) {
-      const re = r.dirOnly && !isDir ? r.under : r.eqOrUnder;
-      if (re.test(p)) ignored = !r.negated;
-    }
-    return ignored;
-  };
-}
-async function loadGitignoreMatcher(projectRoot) {
-  let lines = [];
-  try {
-    const raw = await fs9.readFile(path13.join(projectRoot, ".gitignore"), "utf8");
-    lines = raw.split("\n");
-  } catch {
-  }
-  return compileGitignore(lines);
-}
-
-// src/codebase-index/indexer.ts
-init_languages2();
-
-// src/codebase-index/parser-dispatch.ts
-async function parseFileContent(file, content, lang) {
-  switch (lang) {
-    case "ts":
-    case "tsx":
-    case "js":
-    case "jsx": {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_ts_parser(), ts_parser_exports));
-      return parseSymbols8({ file, content, lang });
-    }
-    case "go": {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_go_parser(), go_parser_exports));
-      return parseSymbols8({ file, content, lang: "go" });
-    }
-    case "py": {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_py_parser(), py_parser_exports));
-      return parseSymbols8({ file, content, lang: "py" });
-    }
-    case "rs": {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_rs_parser(), rs_parser_exports));
-      return parseSymbols8({ file, content, lang: "rs" });
-    }
-    case "json": {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_json_parser(), json_parser_exports));
-      return parseSymbols8({ file, content, lang: "json" });
-    }
-    case "yaml": {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_yaml_parser(), yaml_parser_exports));
-      return parseSymbols8({ file, content, lang: "yaml" });
-    }
-    default: {
-      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_generic_parser(), generic_parser_exports));
-      return parseSymbols8({ file, content, lang });
-    }
-  }
-}
+// src/codebase-index/project-server-endpoint.ts
+import { createHash as createHash4 } from "node:crypto";
+import * as fs11 from "node:fs";
+import * as os5 from "node:os";
+import * as path16 from "node:path";
+import { fileURLToPath } from "node:url";
+import { assertUnixSocketPathWithinLimit } from "@wrongstack/core/utils";
 
 // src/codebase-index/writer.ts
-import { expectDefined as expectDefined5 } from "@wrongstack/core/utils";
-import * as fs14 from "node:fs";
-import * as path21 from "node:path";
+import { expectDefined as expectDefined2 } from "@wrongstack/core/utils";
+import * as fs10 from "node:fs";
+import * as path15 from "node:path";
 
 // src/codebase-index/bm25.ts
 var K1 = 1.5;
@@ -10160,8 +10078,8 @@ function runSqliteWithRetry(fn) {
 }
 
 // src/codebase-index/writer-admin.ts
-import * as fs13 from "node:fs";
-import * as path19 from "node:path";
+import * as fs9 from "node:fs";
+import * as path13 from "node:path";
 var DB_FILE = "index.db";
 function getAllIndexableWithStatement(stmt) {
   return stmt("SELECT id, text FROM symbols").all().map(({ id, text }) => ({ id, text }));
@@ -10220,7 +10138,7 @@ function getAllFileMetasWithStatement(stmt) {
 }
 function getIndexDbSizeBytes(indexDir) {
   try {
-    return fs13.statSync(path19.join(indexDir, DB_FILE)).size;
+    return fs9.statSync(path13.join(indexDir, DB_FILE)).size;
   } catch {
     return 0;
   }
@@ -10287,7 +10205,7 @@ function bulkInsertRefsWithStatement(stmt, maxSqlVars, refs) {
 }
 
 // src/codebase-index/writer-graph-helpers.ts
-import * as path20 from "node:path";
+import * as path14 from "node:path";
 function derivePackage(filePath) {
   const f = filePath.replace(/\\/g, "/");
   const pkgsIdx = f.indexOf("/packages/");
@@ -10402,16 +10320,16 @@ function buildSymbolGraphNodes(symById, relatedIds, fileFilter) {
 function resolveRelativeImport(fromFile, moduleName, indexedFiles) {
   if (!moduleName.startsWith(".")) return void 0;
   const normalizedFrom = fromFile.replace(/\\/g, "/");
-  const absolute = path20.posix.normalize(
-    path20.posix.join(path20.posix.dirname(normalizedFrom), moduleName)
+  const absolute = path14.posix.normalize(
+    path14.posix.join(path14.posix.dirname(normalizedFrom), moduleName)
   );
-  const extension = path20.posix.extname(absolute);
+  const extension = path14.posix.extname(absolute);
   const base = extension ? absolute.slice(0, -extension.length) : absolute;
   const candidates = [
     absolute,
     ...[".ts", ".tsx", ".js", ".jsx", ".mts", ".cts"].map((ext) => `${base}${ext}`),
-    ...[".ts", ".tsx", ".js", ".jsx"].map((ext) => path20.posix.join(absolute, `index${ext}`)),
-    ...[".ts", ".tsx", ".js", ".jsx"].map((ext) => path20.posix.join(base, `index${ext}`))
+    ...[".ts", ".tsx", ".js", ".jsx"].map((ext) => path14.posix.join(absolute, `index${ext}`)),
+    ...[".ts", ".tsx", ".js", ".jsx"].map((ext) => path14.posix.join(base, `index${ext}`))
   ];
   const indexedByPortablePath = new Map(
     [...indexedFiles].map((file) => [file.replace(/\\/g, "/").toLocaleLowerCase(), file])
@@ -10927,9 +10845,9 @@ var IndexStore = class _IndexStore {
   }
   constructor(projectRoot, opts = {}) {
     this.indexDir = resolveIndexDir(projectRoot, opts.indexDir);
-    fs14.mkdirSync(this.indexDir, { recursive: true });
+    fs10.mkdirSync(this.indexDir, { recursive: true });
     const Database = loadDatabaseSync();
-    this.db = new Database(path21.join(this.indexDir, DB_FILE2));
+    this.db = new Database(path15.join(this.indexDir, DB_FILE2));
     applyIndexStorePragmas(this.db);
     this.initSchema();
   }
@@ -11344,13 +11262,13 @@ var IndexStore = class _IndexStore {
       if (rankDiff !== 0) return rankDiff;
       const scoreDiff = b.score - a.score;
       if (scoreDiff !== 0) return scoreDiff;
-      const left = expectDefined5(candidateById.get(a.id));
-      const right = expectDefined5(candidateById.get(b.id));
+      const left = expectDefined2(candidateById.get(a.id));
+      const right = expectDefined2(candidateById.get(b.id));
       return left.name.localeCompare(right.name) || left.file.localeCompare(right.file) || left.line - right.line || left.col - right.col || left.id - right.id;
     });
     const qTokens = tokenise(query);
     const results = scored.slice(0, limit).map(({ id, score }) => {
-      const c = expectDefined5(candidateById.get(id));
+      const c = expectDefined2(candidateById.get(id));
       return { ...c, score, snippet: bm25.extractSnippet(id, qTokens) };
     });
     return { results, total: candidates.length };
@@ -11764,1134 +11682,1274 @@ var indexStorePool = new StorePool(
   (projectRoot, opts) => new IndexStore(projectRoot, opts)
 );
 
-// src/codebase-index/indexer.ts
-var YIELD_EVERY_N = 50;
-function resolveParallelBatch() {
-  return indexParallelBatchSize(availableParallelism());
-}
-function yieldEventLoop() {
-  return new Promise((resolve16) => setImmediate(resolve16));
+// src/codebase-index/project-server-endpoint.ts
+var PROJECT_INDEX_SERVER_PROTOCOL_VERSION = 1;
+var PROJECT_INDEX_SERVER_METADATA_FILE = "server.json";
+var PROJECT_INDEX_SERVER_SOCKET_DIR = `wsci-v${PROJECT_INDEX_SERVER_PROTOCOL_VERSION}`;
+var buildIdCache;
+function projectIndexServerBuildId(entrypoint) {
+  const file = entrypoint instanceof URL || entrypoint.startsWith("file:") ? fileURLToPath(entrypoint) : path16.resolve(entrypoint);
+  try {
+    const stat17 = fs11.statSync(file);
+    if (buildIdCache?.file === file && buildIdCache.mtimeMs === stat17.mtimeMs && buildIdCache.size === stat17.size) {
+      return buildIdCache.buildId;
+    }
+    const buildId = createHash4("sha256").update(fs11.readFileSync(file)).digest("hex").slice(0, 24);
+    buildIdCache = { file, mtimeMs: stat17.mtimeMs, size: stat17.size, buildId };
+    return buildId;
+  } catch {
+    return `unreadable:${path16.basename(file)}`;
+  }
 }
-function throwIfAborted(signal) {
-  if (!signal?.aborted) return;
-  if (signal.reason instanceof Error) throw signal.reason;
-  throw new Error(typeof signal.reason === "string" ? signal.reason : "Indexing cancelled");
+function normalizeLocalPath(value) {
+  const resolved = path16.resolve(value);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }
-function isAbortError(err) {
-  return err instanceof DOMException && err.name === "AbortError";
+function projectIndexServerKey(projectRoot, indexDir) {
+  const resolvedIndexDir = normalizeLocalPath(resolveIndexDir(projectRoot, indexDir));
+  return createHash4("sha256").update(resolvedIndexDir).digest("hex").slice(0, 24);
 }
-var DEFAULT_IGNORE = DEFAULT_WALK_IGNORE_DIRS;
-var DEFAULT_IGNORE_FILES = /* @__PURE__ */ new Set(["package-lock.json", "pnpm-lock.yaml", "pnpm-lock.yml"]);
-var INDEXABLE_EXTENSION_SET = new Set(INDEXABLE_EXTENSIONS);
-var MAX_INDEX_FILE_BYTES = 5 * 1024 * 1024;
-var MAX_GIT_FILE_LIST_BYTES = 64 * 1024 * 1024;
-function isWithinProject(projectRoot, file) {
-  const rel = path22.relative(projectRoot, file);
-  return rel !== "" && !rel.startsWith(`..${path22.sep}`) && rel !== ".." && !path22.isAbsolute(rel);
+function projectIndexServerEndpoint(projectRoot, indexDir) {
+  const key = projectIndexServerKey(projectRoot, indexDir);
+  if (process.platform === "win32") {
+    return `\\\\.\\pipe\\wrongstack-codebase-index-v${PROJECT_INDEX_SERVER_PROTOCOL_VERSION}-${key}`;
+  }
+  return path16.join(os5.tmpdir(), PROJECT_INDEX_SERVER_SOCKET_DIR, `${key}.sock`);
 }
-function isMissingPathError(err) {
-  const code = err?.code;
-  return code === "ENOENT" || code === "ENOTDIR";
+function projectIndexServerMetadataPath(projectRoot, indexDir) {
+  return path16.join(
+    path16.resolve(resolveIndexDir(projectRoot, indexDir)),
+    PROJECT_INDEX_SERVER_METADATA_FILE
+  );
 }
-function normalizeComparablePath(value) {
-  const resolved = path22.resolve(value);
-  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+
+// src/codebase-index/project-server-protocol.ts
+var PROJECT_INDEX_SERVER_MAX_FRAME_CHARS = 64 * 1024 * 1024;
+function encodeProjectServerMessage(message) {
+  return `${JSON.stringify(message)}
+`;
 }
-function gitOutput(projectRoot, args) {
-  return new Promise((resolve16, reject) => {
-    execFile2(
-      "git",
-      ["-C", projectRoot, ...args],
-      {
-        encoding: "buffer",
-        maxBuffer: MAX_GIT_FILE_LIST_BYTES,
-        windowsHide: true
-      },
-      (error, stdout) => {
-        if (error) reject(error);
-        else resolve16(Buffer.isBuffer(stdout) ? stdout : Buffer.from(stdout));
-      }
-    );
-  });
-}
-async function findGitSourceFiles(projectRoot, ignore, signal) {
-  try {
-    throwIfAborted(signal);
-    const topLevel = (await gitOutput(projectRoot, ["rev-parse", "--show-toplevel"])).toString("utf8").trim();
-    if (normalizeComparablePath(topLevel) !== normalizeComparablePath(projectRoot)) return null;
-    throwIfAborted(signal);
-    const ignoreSet = /* @__PURE__ */ new Set([...DEFAULT_IGNORE, ...ignore]);
-    const [output, statusOutput] = await Promise.all([
-      gitOutput(projectRoot, ["ls-files", "--cached", "--others", "--exclude-standard", "-z"]),
-      gitOutput(projectRoot, [
-        "status",
-        "--porcelain=v1",
-        "-z",
-        "--untracked-files=all",
-        "--ignored=no"
-      ])
-    ]);
-    throwIfAborted(signal);
-    const dirty = /* @__PURE__ */ new Set();
-    const deleted = /* @__PURE__ */ new Set();
-    const statusRecords = statusOutput.toString("utf8").split("\0");
-    for (let i = 0; i < statusRecords.length; i++) {
-      const record = statusRecords[i];
-      if (!record) continue;
-      const status = record.slice(0, 2);
-      const changedPath = path22.resolve(projectRoot, record.slice(3));
-      dirty.add(changedPath);
-      if (status.includes("D")) deleted.add(changedPath);
-      if (status.includes("R") || status.includes("C")) {
-        const source = statusRecords[++i];
-        if (source) dirty.add(path22.resolve(projectRoot, source));
+
+// src/codebase-index/project-server-client.ts
+var CONNECT_ATTEMPT_TIMEOUT_MS = 750;
+var SERVER_START_TIMEOUT_MS = 1e4;
+var SERVER_CONTROL_TIMEOUT_MS = 5e3;
+var SERVER_HEALTH_TIMEOUT_MS = 3e3;
+var SERVER_HEARTBEAT_INTERVAL_MS = 1e4;
+var StaleProjectIndexServerError = class extends Error {
+  constructor(message, pid) {
+    super(message);
+    this.pid = pid;
+  }
+  pid;
+  name = "StaleProjectIndexServerError";
+};
+var connectionStates = /* @__PURE__ */ new Map();
+var connectionStateListeners = /* @__PURE__ */ new Set();
+var latestConnectionState = {
+  status: "offline",
+  connected: false
+};
+function resolveProjectIndexDaemonAvailability(projectRoot, indexDir) {
+  if (process.env["WRONGSTACK_INDEX_INLINE"] || process.env["WRONGSTACK_INDEX_SERVER"] === "0") {
+    return { kind: "inline-requested" };
+  }
+  let builtUrl = null;
+  for (const rel of ["./project-server.js", "./codebase-index/project-server.js"]) {
+    try {
+      const url = new URL(rel, import.meta.url);
+      if (url.protocol === "file:" && fs12.existsSync(fileURLToPath2(url))) {
+        builtUrl = url;
+        break;
       }
+    } catch {
     }
-    const files = [];
-    for (const relative12 of output.toString("utf8").split("\0")) {
-      if (!relative12) continue;
-      const portable = relative12.replace(/\\/g, "/");
-      if (portable.split("/").some((segment) => ignoreSet.has(segment)) || DEFAULT_IGNORE_FILES.has(path22.posix.basename(portable))) {
-        continue;
-      }
-      const full = path22.resolve(projectRoot, relative12);
-      if (deleted.has(full)) continue;
-      const ext = path22.extname(relative12).toLowerCase();
-      if (INDEXABLE_EXTENSION_SET.has(ext) || detectLang(full) !== null) files.push(full);
+  }
+  if (builtUrl === null) return { kind: "missing-build" };
+  if (projectRoot !== void 0) {
+    const endpoint = projectIndexServerEndpoint(projectRoot, indexDir);
+    const check = checkUnixSocketPath(endpoint);
+    if (!check.ok) {
+      return {
+        kind: "endpoint-invalid",
+        endpoint,
+        byteLength: check.byteLength,
+        maxBytes: check.maxBytes
+      };
     }
-    return {
-      files,
-      trustedUnchanged: new Set(files.filter((file) => !dirty.has(file)))
-    };
-  } catch {
-    return null;
   }
+  return { kind: "available", url: builtUrl };
 }
-async function findSourceFiles(projectRoot, ignore, isGitIgnored, signal) {
-  const gitFiles = await findGitSourceFiles(projectRoot, ignore, signal);
-  if (gitFiles) {
+function resolveProjectServerUrl() {
+  const availability = resolveProjectIndexDaemonAvailability();
+  return availability.kind === "available" ? availability.url : null;
+}
+function projectIndexServerExpectedBuildId() {
+  const override = process.env["WRONGSTACK_INDEX_SERVER_BUILD_ID"]?.trim();
+  if (override) return override;
+  const url = resolveProjectServerUrl();
+  return url ? projectIndexServerBuildId(url) : null;
+}
+function isProjectIndexServerAvailable() {
+  return resolveProjectServerUrl() !== null;
+}
+function publishConnectionState(endpoint, state) {
+  connectionStates.set(endpoint, state);
+  latestConnectionState = state;
+  for (const listener of connectionStateListeners) listener(state);
+}
+function getProjectIndexServerConnectionState(projectRoot, indexDir) {
+  if (projectRoot) {
+    const endpoint = projectIndexServerEndpoint(projectRoot, indexDir);
+    const existing = connectionStates.get(endpoint);
+    if (existing) return existing;
+    if (!isProjectIndexServerAvailable()) {
+      return { status: "unavailable", connected: false };
+    }
     return {
-      files: gitFiles.files,
-      complete: true,
-      errors: [],
-      trustedUnchanged: gitFiles.trustedUnchanged
+      status: "offline",
+      connected: false,
+      projectRoot,
+      indexDir,
+      endpoint
     };
   }
-  const results = [];
-  const errors = [];
-  let complete = true;
-  const ignoreSet = /* @__PURE__ */ new Set([...DEFAULT_IGNORE, ...ignore]);
-  const indexableExts = new Set(INDEXABLE_EXTENSIONS);
-  let dirCount = 0;
-  const walk = async (dir) => {
-    throwIfAborted(signal);
-    if (dirCount > 0 && dirCount % YIELD_EVERY_N === 0) {
-      await yieldEventLoop();
-      throwIfAborted(signal);
-    }
-    let entries;
-    try {
-      entries = await fs15.readdir(dir, { withFileTypes: true });
-    } catch (err) {
-      complete = false;
-      errors.push(`scan error: ${dir}: ${err instanceof Error ? err.message : String(err)}`);
-      return;
-    }
-    dirCount++;
-    for (const e of entries) {
-      if (ignoreSet.has(e.name)) continue;
-      const full = path22.join(dir, e.name);
-      const rel = path22.relative(projectRoot, full).replace(/\\/g, "/");
-      if (e.isDirectory()) {
-        if (isGitIgnored(rel, true)) continue;
-        await walk(full);
-      } else if (e.isFile()) {
-        if (DEFAULT_IGNORE_FILES.has(e.name) || isGitIgnored(rel, false)) continue;
-        const ext = path22.extname(e.name).toLowerCase();
-        if (indexableExts.has(ext) || detectLang(full) !== null) {
-          results.push(full);
-        }
-      }
-    }
-  };
-  await walk(projectRoot);
-  return { files: results, complete, errors };
+  if (latestConnectionState.endpoint) return latestConnectionState;
+  if (!isProjectIndexServerAvailable()) return { status: "unavailable", connected: false };
+  return latestConnectionState;
 }
-function assignRefsToSymbols2(refs, symbols) {
-  if (refs.length === 0 || symbols.length === 0) return [];
-  const ordered = [...symbols].sort((a, b) => a.line - b.line || a.col - b.col || a.id - b.id);
-  const seen = /* @__PURE__ */ new Set();
-  const assigned = [];
-  for (const ref of refs) {
-    let owner2;
-    for (const symbol of ordered) {
-      if (symbol.line > ref.line) break;
-      owner2 = symbol;
-    }
-    if (!owner2 && ref.callType === "import") owner2 = ordered[0];
-    if (!owner2 || owner2.id <= 0) continue;
-    const key = `${owner2.id}:${ref.toName}:${ref.callType}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-    assigned.push({ ...ref, fromId: owner2.id });
-  }
-  return assigned;
+function onProjectIndexServerConnectionStateChange(listener) {
+  connectionStateListeners.add(listener);
+  return () => connectionStateListeners.delete(listener);
 }
-async function runIndexerWithStore(store, opts) {
-  const { projectRoot, langs, ignore = [], signal } = opts;
-  const relationGraphVersion = "2";
-  const refResolutionVersion = "2";
-  const force = (opts.force ?? false) || store.getMetadata("relation_graph_version") !== relationGraphVersion;
-  const needsFullRefResolution = force || store.getMetadata("ref_resolution_version") !== refResolutionVersion;
-  const startMs = Date.now();
-  const errors = [];
-  const langStats = {};
-  let filesIndexed = 0;
-  let symbolsIndexed = 0;
-  const isGitIgnored = await loadGitignoreMatcher(projectRoot);
-  let files;
-  let discoveredFiles = null;
-  let discoveryComplete = true;
-  let trustedUnchanged;
-  if (opts.files && opts.files.length > 0) {
-    files = opts.files.map((f) => path22.resolve(projectRoot, f)).filter((f) => {
-      if (!isWithinProject(projectRoot, f)) return false;
-      const rel = path22.relative(projectRoot, f).replace(/\\/g, "/");
-      return !rel.split("/").some((seg) => DEFAULT_IGNORE.includes(seg)) && !DEFAULT_IGNORE_FILES.has(path22.basename(f)) && !isGitIgnored(rel, false);
-    });
-  } else {
-    const discovery = await findSourceFiles(projectRoot, ignore, isGitIgnored, signal);
-    files = discovery.files;
-    errors.push(...discovery.errors);
-    discoveryComplete = discovery.complete;
-    discoveredFiles = new Set(files);
-    trustedUnchanged = discovery.trustedUnchanged;
+function remoteError(message, name) {
+  if (name === "LockError") return new LockError(message);
+  if (name === "IndexTimeoutError") return new IndexTimeoutError(message);
+  const error = new Error(message);
+  if (name && name !== "Error") error.name = name;
+  return error;
+}
+function isProjectIndexServerHealth(value) {
+  if (!value || typeof value !== "object") return false;
+  const health = value;
+  const memory = health.memory && typeof health.memory === "object" ? health.memory : void 0;
+  const activity = health.activity && typeof health.activity === "object" ? health.activity : void 0;
+  return typeof health.checkedAt === "number" && typeof health.uptimeMs === "number" && typeof memory?.rss === "number" && typeof memory.heapUsed === "number" && typeof memory.heapTotal === "number" && typeof memory.external === "number" && typeof health.clients === "number" && typeof health.activeRequests === "number" && typeof health.activeWrites === "number" && typeof health.queuedWrites === "number" && typeof health.pendingExternalFiles === "number" && typeof health.watchingExternal === "boolean" && typeof activity?.indexing === "boolean" && typeof activity.currentFile === "number" && typeof activity.totalFiles === "number" && typeof activity.generation === "number";
+}
+function delay(ms) {
+  return new Promise((resolve16) => {
+    const timer = setTimeout(resolve16, ms);
+    timer.unref?.();
+  });
+}
+function cancellationError(signal) {
+  return signal.reason instanceof Error ? signal.reason : new Error("Indexing cancelled");
+}
+var ProjectServerConnection = class {
+  constructor(projectRoot, indexDir, endpoint) {
+    this.projectRoot = projectRoot;
+    this.indexDir = indexDir;
+    this.endpoint = endpoint;
+    this.transition("offline");
   }
-  if (langs && langs.length > 0) {
-    const langSet = new Set(langs);
-    files = files.filter((f) => {
-      const lang = detectLang(f);
-      return lang ? langSet.has(lang) : false;
+  projectRoot;
+  indexDir;
+  endpoint;
+  socket = null;
+  buffer = "";
+  info = null;
+  activity = null;
+  health = null;
+  healthCheck = null;
+  connecting = null;
+  connectResolve = null;
+  connectReject = null;
+  nextId = 1;
+  pending = /* @__PURE__ */ new Map();
+  transition(status, options = {}) {
+    const previous = connectionStates.get(this.endpoint);
+    const pid = options.pid ?? (status === "connected" ? this.info?.pid : void 0);
+    const lastError = options.error === void 0 ? status === "error" || status === "degraded" || status === "unresponsive" ? previous?.lastError : void 0 : options.error instanceof Error ? options.error.message : String(options.error);
+    publishConnectionState(this.endpoint, {
+      status,
+      connected: status === "connected" || status === "degraded" || status === "unresponsive",
+      projectRoot: this.projectRoot,
+      indexDir: this.indexDir,
+      endpoint: this.endpoint,
+      pid,
+      lastError,
+      ...this.activity ? { activity: this.activity } : {},
+      ...this.health ? { health: this.health } : {}
     });
   }
-  if (force) store.clearAll();
-  const existingMeta = /* @__PURE__ */ new Map();
-  if (!force) {
-    for (const meta of store.getAllFileMetas()) existingMeta.set(meta.file, meta);
+  isConnected() {
+    return this.socket !== null && !this.socket.destroyed && this.info !== null;
   }
-  const totalFilesForProgress = files.length;
-  let filesPreSkipped = 0;
-  if (!force && trustedUnchanged) {
-    files = files.filter((file) => {
-      const meta = existingMeta.get(file);
-      if (!meta || !trustedUnchanged.has(file)) return true;
-      langStats[meta.lang] = (langStats[meta.lang] ?? 0) + meta.symbolCount;
-      symbolsIndexed += meta.symbolCount;
-      filesIndexed++;
-      filesPreSkipped++;
-      return false;
-    });
-    if (filesPreSkipped > 0) opts.onProgress?.(filesPreSkipped, totalFilesForProgress);
+  /** Safe LRU candidate: no request, connect, or health probe is in flight. */
+  isEvictable() {
+    return this.pending.size === 0 && this.connecting === null && this.healthCheck === null;
   }
-  const parallelBatch = resolveParallelBatch();
-  let filesSinceLastYield = 0;
-  for (let batchStart = 0; batchStart < files.length; batchStart += parallelBatch) {
-    const batchEnd = Math.min(batchStart + parallelBatch, files.length);
-    const batchFiles = files.slice(batchStart, batchEnd);
-    opts.onProgress?.(filesPreSkipped + batchEnd, totalFilesForProgress);
-    filesSinceLastYield += batchFiles.length;
-    if (filesSinceLastYield >= YIELD_EVERY_N) {
-      filesSinceLastYield = 0;
-      await yieldEventLoop();
-      if (isFrugalPerf()) {
-        await new Promise((r) => setTimeout(r, 8));
-      }
-      throwIfAborted(signal);
+  async checkHealth(spawnIfMissing = false, timeoutMs = SERVER_HEALTH_TIMEOUT_MS) {
+    await this.ensureConnected(spawnIfMissing);
+    if (this.healthCheck) return this.healthCheck;
+    const startedAt = Date.now();
+    this.healthCheck = this.request({ type: "ping" }, { timeoutMs }).then((server) => {
+      const now = Date.now();
+      this.health = {
+        status: "healthy",
+        checkedAt: now,
+        lastHealthyAt: now,
+        latencyMs: Math.max(0, now - startedAt),
+        missedHeartbeats: 0,
+        ...isProjectIndexServerHealth(server) ? { server } : {}
+      };
+      this.transition("connected", { pid: this.info?.pid });
+      return this.health;
+    }).catch((error) => {
+      if (!this.isConnected()) throw error;
+      if ((this.health?.lastHealthyAt ?? 0) > startedAt) return this.health;
+      const missedHeartbeats = (this.health?.missedHeartbeats ?? 0) + 1;
+      const status = missedHeartbeats >= 3 ? "unresponsive" : "degraded";
+      this.health = {
+        status,
+        checkedAt: Date.now(),
+        lastHealthyAt: this.health?.lastHealthyAt ?? null,
+        latencyMs: null,
+        missedHeartbeats,
+        ...this.health?.server ? { server: this.health.server } : {}
+      };
+      this.transition(status, { pid: this.info?.pid, error });
+      return this.health;
+    }).finally(() => {
+      this.healthCheck = null;
+    });
+    return this.healthCheck;
+  }
+  markResponsive() {
+    const now = Date.now();
+    this.health = {
+      status: "healthy",
+      checkedAt: now,
+      lastHealthyAt: now,
+      latencyMs: this.health?.latencyMs ?? null,
+      missedHeartbeats: 0,
+      ...this.health?.server ? { server: this.health.server } : {}
+    };
+  }
+  async call(op, args, options) {
+    if (options.signal?.aborted) throw cancellationError(options.signal);
+    await this.ensureConnected(true);
+    if (options.signal?.aborted) throw cancellationError(options.signal);
+    return this.request({ type: "request", op, args }, options);
+  }
+  async shutdownRemote(reason) {
+    try {
+      await this.ensureConnected(false);
+    } catch {
+      return { stopped: false, reason: "not-running" };
     }
-    const statOpts = signal ? { signal } : {};
-    const statReadParse = await Promise.allSettled(
-      batchFiles.map(
-        async (file) => {
-          let stat17;
-          try {
-            stat17 = await fs15.stat(file, statOpts);
-          } catch (e) {
-            if (isAbortError(e)) throw e;
-            return {
-              file,
-              stat: null,
-              lang: "",
-              parsed: null,
-              error: `stat error: ${e instanceof Error ? e.message : String(e)}`,
-              missing: isMissingPathError(e)
-            };
-          }
-          if (!stat17.isFile()) return { file, stat: stat17, lang: "", parsed: null };
-          const lang = detectLang(file);
-          if (!lang) return { file, stat: stat17, lang: "", parsed: null };
-          if (stat17.size > MAX_INDEX_FILE_BYTES) {
-            return {
-              file,
-              stat: stat17,
-              lang,
-              parsed: null,
-              error: `file too large (${stat17.size} bytes; max ${MAX_INDEX_FILE_BYTES})`
-            };
-          }
-          const meta = existingMeta.get(file);
-          if (!force && meta && meta.mtimeMs === Math.floor(stat17.mtimeMs)) {
-            return { file, stat: stat17, lang, parsed: null, skippedMeta: meta };
-          }
-          let content;
-          try {
-            content = await fs15.readFile(file, { encoding: "utf8", signal });
-          } catch (e) {
-            if (isAbortError(e)) throw e;
-            return {
-              file,
-              stat: stat17,
-              lang,
-              parsed: null,
-              error: `read error: ${e instanceof Error ? e.message : String(e)}`
-            };
-          }
-          let parsed;
-          try {
-            parsed = await parseFileContent(file, content, lang);
-          } catch (e) {
-            return {
-              file,
-              stat: stat17,
-              lang,
-              parsed: null,
-              error: `parse error: ${e instanceof Error ? e.message : String(e)}`
-            };
-          }
-          return { file, stat: stat17, lang, parsed, content };
-        }
-      )
+    const pid = this.info?.pid;
+    try {
+      this.transition("stopping", { pid });
+      await this.request(
+        { type: "shutdown", reason },
+        { timeoutMs: SERVER_CONTROL_TIMEOUT_MS }
+      );
+      return { stopped: true, pid };
+    } catch (error) {
+      const forceKilled = this.forceKillKnownServer();
+      return {
+        stopped: forceKilled,
+        pid,
+        reason: forceKilled ? `force-killed after graceful shutdown failed: ${error instanceof Error ? error.message : String(error)}` : error instanceof Error ? error.message : String(error)
+      };
+    } finally {
+      this.close();
+    }
+  }
+  async configure(watchExternal, debounceMs) {
+    await this.ensureConnected(true);
+    const startedAt = Date.now();
+    const result = await this.request(
+      { type: "configure", watchExternal, debounceMs },
+      { timeoutMs: SERVER_CONTROL_TIMEOUT_MS }
     );
-    const batchEntries = [];
-    const deleteForFiles = [];
-    for (let fi = 0; fi < statReadParse.length; fi++) {
-      const settled = statReadParse[fi];
-      const file = expectDefined6(batchFiles[fi]);
-      if (settled.status === "rejected") {
-        const err = settled.reason;
-        if (err instanceof Error && isAbortError(err)) throw err;
-        errors.push(`batch error: ${file}: ${err instanceof Error ? err.message : String(err)}`);
-        continue;
+    if (isProjectIndexServerHealth(result.health)) {
+      const now = Date.now();
+      this.health = {
+        status: "healthy",
+        checkedAt: now,
+        lastHealthyAt: now,
+        latencyMs: Math.max(0, now - startedAt),
+        missedHeartbeats: 0,
+        server: result.health
+      };
+      this.transition("connected", { pid: this.info?.pid });
+    }
+  }
+  close() {
+    const socket = this.socket;
+    this.socket = null;
+    this.info = null;
+    this.activity = null;
+    this.health = null;
+    this.connectReject?.(new Error("codebase-index client disconnected"));
+    this.connectResolve = null;
+    this.connectReject = null;
+    if (socket && !socket.destroyed) socket.destroy();
+    this.rejectPending(new Error("codebase-index client disconnected"));
+    this.transition("offline");
+    maybeStopHeartbeatLoop();
+  }
+  request(message, options) {
+    const socket = this.socket;
+    if (!socket || socket.destroyed) {
+      return Promise.reject(new Error("codebase-index server connection is not available"));
+    }
+    const id = this.nextId++;
+    return new Promise((resolve16, reject) => {
+      const timer = setTimeout(() => {
+        const entry = this.pending.get(id);
+        if (!entry) return;
+        this.pending.delete(id);
+        this.write({ type: "cancel", id });
+        const error = new IndexTimeoutError(
+          `Index ${message.type === "request" ? message.op : message.type} exceeded its ${options.timeoutMs}ms watchdog timeout`
+        );
+        this.cleanupPending(entry);
+        entry.reject(error);
+      }, options.timeoutMs);
+      timer.unref?.();
+      const signal = options.signal;
+      const onAbort = signal ? () => {
+        const entry = this.pending.get(id);
+        if (!entry) return;
+        this.pending.delete(id);
+        this.write({ type: "cancel", id });
+        this.cleanupPending(entry);
+        entry.reject(cancellationError(signal));
+      } : void 0;
+      this.pending.set(id, {
+        resolve: resolve16,
+        reject,
+        timer,
+        signal,
+        onAbort,
+        onProgress: options.onProgress
+      });
+      if (signal && onAbort) {
+        signal.addEventListener("abort", onAbort, { once: true });
+        if (signal.aborted) {
+          onAbort();
+          return;
+        }
       }
-      const result = settled.value;
-      if (result.error) {
-        if (result.missing) store.deleteFile(file);
-        errors.push(`${file}: ${result.error}`);
-        continue;
+      this.write({ ...message, id });
+    });
+  }
+  async ensureConnected(spawnIfMissing) {
+    if (this.socket && !this.socket.destroyed && this.info) return;
+    if (this.connecting) return this.connecting;
+    this.transition("connecting");
+    this.connecting = this.connectWithElection(spawnIfMissing).catch((error) => {
+      this.transition("error", { error });
+      throw error;
+    }).finally(() => {
+      this.connecting = null;
+    });
+    return this.connecting;
+  }
+  async connectWithElection(spawnIfMissing) {
+    const deadline = Date.now() + (spawnIfMissing ? SERVER_START_TIMEOUT_MS : CONNECT_ATTEMPT_TIMEOUT_MS);
+    let spawned = false;
+    let staleAttempts = 0;
+    let lastError = new Error("codebase-index server unavailable");
+    while (Date.now() < deadline) {
+      try {
+        await this.connectOnce();
+        return;
+      } catch (error) {
+        lastError = error;
+        if (error instanceof StaleProjectIndexServerError) {
+          staleAttempts++;
+          if (!spawnIfMissing) break;
+          if (staleAttempts >= 3) this.forceKillServer(error.pid);
+          spawned = false;
+          await delay(100);
+          continue;
+        }
       }
-      const { stat: stat17, lang, parsed } = result;
-      if (result.skippedMeta) {
-        langStats[lang] = (langStats[lang] ?? 0) + result.skippedMeta.symbolCount;
-        symbolsIndexed += result.skippedMeta.symbolCount;
-        filesIndexed++;
-        continue;
+      if (!spawnIfMissing) break;
+      if (!spawned) {
+        this.spawnDetachedServer();
+        spawned = true;
       }
-      if (!lang || !parsed) {
-        if (lang) {
-          store.upsertFile({
-            file,
-            lang,
-            mtimeMs: Math.floor(stat17.mtimeMs),
-            symbolCount: 0,
-            lastIndexed: Date.now()
-          });
-          filesIndexed++;
+      await delay(75);
+    }
+    throw lastError;
+  }
+  connectOnce() {
+    this.socket?.destroy();
+    this.socket = null;
+    this.info = null;
+    this.activity = null;
+    this.health = null;
+    this.buffer = "";
+    return new Promise((resolve16, reject) => {
+      const socket = net3.createConnection(this.endpoint);
+      this.socket = socket;
+      socket.setEncoding("utf8");
+      const timer = setTimeout(() => {
+        reject(new Error("codebase-index server handshake timed out"));
+        socket.destroy();
+      }, CONNECT_ATTEMPT_TIMEOUT_MS);
+      timer.unref?.();
+      const finishResolve = () => {
+        clearTimeout(timer);
+        this.connectResolve = null;
+        this.connectReject = null;
+        resolve16();
+      };
+      const finishReject = (error) => {
+        clearTimeout(timer);
+        this.connectResolve = null;
+        this.connectReject = null;
+        reject(error);
+      };
+      this.connectResolve = finishResolve;
+      this.connectReject = finishReject;
+      socket.on("data", (chunk) => this.onData(socket, chunk));
+      socket.on("error", (error) => {
+        if (!this.info) finishReject(error);
+      });
+      socket.on("close", () => this.onClose(socket));
+    });
+  }
+  onData(socket, chunk) {
+    if (socket !== this.socket) return;
+    this.buffer += chunk;
+    while (true) {
+      const newline = this.buffer.indexOf("\n");
+      if (newline < 0) {
+        if (this.buffer.length > PROJECT_INDEX_SERVER_MAX_FRAME_CHARS) {
+          socket.destroy(new Error("codebase-index server response exceeds the IPC limit"));
         }
-        continue;
+        return;
       }
-      if (parsed.symbols.length === 0) {
-        store.replaceEmptyFile({
-          file,
-          lang,
-          mtimeMs: Math.floor(stat17.mtimeMs),
-          symbolCount: 0,
-          lastIndexed: Date.now()
-        });
-        filesIndexed++;
-        continue;
+      if (newline > PROJECT_INDEX_SERVER_MAX_FRAME_CHARS) {
+        socket.destroy(new Error("codebase-index server response exceeds the IPC limit"));
+        return;
       }
-      batchEntries.push({
-        file,
-        lang,
-        symbols: parsed.symbols,
-        refs: parsed.refs ?? [],
-        mtimeMs: Math.floor(stat17.mtimeMs),
-        symbolCount: parsed.symbols.length
-      });
-      deleteForFiles.push(file);
+      const line = this.buffer.slice(0, newline);
+      this.buffer = this.buffer.slice(newline + 1);
+      if (!line) continue;
+      let message;
+      try {
+        message = JSON.parse(line);
+      } catch {
+        socket.destroy(new Error("invalid codebase-index server response"));
+        return;
+      }
+      this.onMessage(message);
     }
-    if (batchEntries.length > 0) {
+  }
+  onMessage(message) {
+    if (message.type === "hello") {
+      if (message.protocolVersion !== PROJECT_INDEX_SERVER_PROTOCOL_VERSION) {
+        this.rejectStaleServer(
+          message,
+          `codebase-index protocol mismatch: client=${PROJECT_INDEX_SERVER_PROTOCOL_VERSION}, server=${message.protocolVersion}`
+        );
+        return;
+      }
+      const expectedBuildId = projectIndexServerExpectedBuildId();
+      if (expectedBuildId && message.buildId !== expectedBuildId) {
+        this.rejectStaleServer(
+          message,
+          `codebase-index build mismatch: client=${expectedBuildId}, server=${message.buildId ?? "legacy"}`
+        );
+        return;
+      }
+      this.info = message;
+      this.markResponsive();
+      this.transition("connected", { pid: message.pid });
+      ensureHeartbeatLoop();
+      this.connectResolve?.();
+      return;
+    }
+    if (message.type === "index-state") {
+      this.activity = message.state;
+      this.markResponsive();
+      this.transition("connected", { pid: this.info?.pid });
+      return;
+    }
+    const entry = this.pending.get(message.id);
+    if (!entry) return;
+    this.markResponsive();
+    const status = connectionStates.get(this.endpoint)?.status;
+    if (status === "degraded" || status === "unresponsive") {
+      this.transition("connected", { pid: this.info?.pid });
+    }
+    if (message.type === "progress") {
+      entry.onProgress?.(message.current, message.total);
+      return;
+    }
+    this.pending.delete(message.id);
+    this.cleanupPending(entry);
+    if (message.ok) entry.resolve(message.result);
+    else entry.reject(remoteError(message.error, message.errorName));
+  }
+  onClose(socket) {
+    if (socket !== this.socket) return;
+    const wasConnected = this.info !== null;
+    this.socket = null;
+    this.info = null;
+    this.activity = null;
+    this.health = null;
+    const error = new Error("codebase-index server connection closed");
+    this.connectReject?.(error);
+    this.connectResolve = null;
+    this.connectReject = null;
+    this.rejectPending(error);
+    if (wasConnected) this.transition("error", { error });
+    maybeStopHeartbeatLoop();
+  }
+  cleanupPending(entry) {
+    clearTimeout(entry.timer);
+    if (entry.signal && entry.onAbort) {
+      entry.signal.removeEventListener("abort", entry.onAbort);
+    }
+  }
+  rejectPending(error) {
+    const entries = [...this.pending.values()];
+    this.pending.clear();
+    for (const entry of entries) {
+      this.cleanupPending(entry);
+      entry.reject(error);
+    }
+  }
+  write(message) {
+    const socket = this.socket;
+    if (socket && !socket.destroyed) socket.write(encodeProjectServerMessage(message));
+  }
+  rejectStaleServer(message, reason) {
+    const socket = this.socket;
+    if (socket && !socket.destroyed) {
+      socket.write(
+        encodeProjectServerMessage({
+          type: "shutdown",
+          id: 0,
+          reason: "stale-build-replacement"
+        })
+      );
+      const timer = setTimeout(() => socket.destroy(), 25);
+      timer.unref?.();
+    }
+    this.connectReject?.(new StaleProjectIndexServerError(reason, message.pid));
+  }
+  spawnDetachedServer() {
+    const url = resolveProjectServerUrl();
+    if (!url) throw new Error("built codebase-index project server is unavailable");
+    if (process.platform !== "win32") {
       try {
-        store.commitBatch(batchEntries, { deleteForFiles });
-        for (const entry of batchEntries) {
-          const count = entry.symbols.length;
-          symbolsIndexed += count;
-          langStats[entry.lang] = (langStats[entry.lang] ?? 0) + count;
-          filesIndexed++;
-        }
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        errors.push(`commitBatch failed: ${message} \u2014 falling back to per-file writes`);
-        for (const entry of batchEntries) {
-          try {
-            store.deleteRefsForFile(entry.file);
-            store.deleteSymbolsForFile(entry.file);
-            const symbolsWithIds = store.insertSymbols(entry.symbols);
-            symbolsIndexed += symbolsWithIds.length;
-            langStats[entry.lang] = (langStats[entry.lang] ?? 0) + symbolsWithIds.length;
-            filesIndexed++;
-            if (entry.refs.length > 0 && symbolsWithIds.length > 0) {
-              const fallbackBatch = assignRefsToSymbols2(entry.refs, symbolsWithIds);
-              if (fallbackBatch.length > 0) store.insertRefsBatch(fallbackBatch);
-            }
-            store.resolveRefsForNames([
-              ...entry.symbols.map((symbol) => symbol.name),
-              ...entry.refs.map((ref) => ref.toName)
-            ]);
-            store.upsertFile({
-              file: entry.file,
-              lang: entry.lang,
-              mtimeMs: entry.mtimeMs,
-              symbolCount: entry.symbolCount,
-              lastIndexed: Date.now()
-            });
-          } catch (innerErr) {
-            errors.push(
-              `fallback write failed: ${entry.file}: ${innerErr instanceof Error ? innerErr.message : String(innerErr)}`
-            );
-          }
-        }
+        fs12.rmSync(this.endpoint, { force: true });
+      } catch {
       }
     }
+    const args = [fileURLToPath2(url), "--project-root", this.projectRoot];
+    if (this.indexDir) args.push("--index-dir", this.indexDir);
+    const child = spawn4(process.execPath, args, {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true,
+      env: process.env
+    });
+    child.unref();
   }
-  if (discoveredFiles && discoveryComplete) {
-    for (const [file_] of existingMeta) {
-      if (!discoveredFiles.has(file_)) {
-        store.deleteFile(file_);
+  forceKillKnownServer() {
+    const pid = this.info?.pid;
+    return pid ? this.forceKillServer(pid) : false;
+  }
+  forceKillServer(pid) {
+    if (pid === process.pid) return false;
+    try {
+      process.kill(pid);
+      const metadataPath = projectIndexServerMetadataPath(this.projectRoot, this.indexDir);
+      try {
+        const metadata = JSON.parse(fs12.readFileSync(metadataPath, "utf8"));
+        if (metadata.pid === pid) fs12.rmSync(metadataPath, { force: true });
+      } catch {
       }
+      return true;
+    } catch {
+      return false;
     }
   }
-  if (needsFullRefResolution) store.resolveRefs();
-  store.setMetadata("ref_resolution_version", refResolutionVersion);
-  store.setMetadata("relation_graph_version", relationGraphVersion);
-  if (!opts.files || filesIndexed >= 50) store.optimize();
-  store.setLastIndexed(Date.now());
-  if (!opts.files) store.compactIfNeeded();
-  const durationMs = Date.now() - startMs;
-  return {
-    filesIndexed,
-    symbolsIndexed,
-    langStats,
-    durationMs,
-    errors
+};
+var connections = /* @__PURE__ */ new Map();
+var MAX_CACHED_CONNECTIONS = 8;
+var heartbeatTimer;
+function forgetConnection(endpoint, connection) {
+  if (connections.get(endpoint) === connection) connections.delete(endpoint);
+  connection.close();
+  connectionStates.delete(endpoint);
+  if (latestConnectionState.endpoint !== endpoint) return;
+  latestConnectionState = [...connectionStates.values()].at(-1) ?? {
+    status: isProjectIndexServerAvailable() ? "offline" : "unavailable",
+    connected: false
   };
 }
-
-// src/codebase-index/index-service.ts
-async function indexService(args, hooks = {}) {
-  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
-  try {
-    return await runIndexerWithStore(store, {
-      projectRoot: args.projectRoot,
-      indexDir: args.indexDir,
-      files: args.files,
-      force: args.force,
-      langs: args.langs,
-      ignore: args.ignore,
-      signal: hooks.signal,
-      onProgress: hooks.onProgress
-    });
-  } finally {
-    indexStorePool.release(store);
-  }
-}
-function searchService(args) {
-  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
-  try {
-    return store.searchRanked(
-      args.query,
-      {
-        kind: args.kind,
-        lang: args.lang,
-        file: args.file,
-        lspKind: args.lspKind
-      },
-      args.limit
-    );
-  } finally {
-    indexStorePool.release(store);
+function trimConnectionCache(protectedConnection) {
+  if (connections.size <= MAX_CACHED_CONNECTIONS) return;
+  for (const [endpoint, connection] of connections) {
+    if (connections.size <= MAX_CACHED_CONNECTIONS) break;
+    if (connection === protectedConnection || !connection.isEvictable()) continue;
+    forgetConnection(endpoint, connection);
   }
 }
-function statsService(args) {
-  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
-  try {
-    return store.getStats();
-  } finally {
-    indexStorePool.release(store);
-  }
+function ensureHeartbeatLoop() {
+  if (heartbeatTimer) return;
+  heartbeatTimer = setInterval(() => {
+    for (const connection of connections.values()) {
+      if (connection.isConnected()) void connection.checkHealth(false).catch(() => {
+      });
+    }
+  }, SERVER_HEARTBEAT_INTERVAL_MS);
+  heartbeatTimer.unref?.();
 }
-function packageGraphService(args) {
-  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
-  try {
-    return store.getPackageGraph();
-  } finally {
-    indexStorePool.release(store);
-  }
+function maybeStopHeartbeatLoop() {
+  if (!heartbeatTimer) return;
+  if ([...connections.values()].some((connection) => connection.isConnected())) return;
+  clearInterval(heartbeatTimer);
+  heartbeatTimer = void 0;
 }
-function fileGraphService(args) {
-  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
-  try {
-    return store.getFileGraph(args.packageFilter);
-  } finally {
-    indexStorePool.release(store);
+function connectionFor(projectRoot, indexDir) {
+  const endpoint = projectIndexServerEndpoint(projectRoot, indexDir);
+  let connection = connections.get(endpoint);
+  if (!connection) {
+    connection = new ProjectServerConnection(projectRoot, indexDir, endpoint);
+    connections.set(endpoint, connection);
+  } else {
+    connections.delete(endpoint);
+    connections.set(endpoint, connection);
   }
+  trimConnectionCache(connection);
+  return connection;
 }
-function symbolGraphService(args) {
-  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
-  try {
-    return store.getSymbolGraph(args.fileFilter);
-  } finally {
-    indexStorePool.release(store);
-  }
+function callProjectIndexServer(op, args, options) {
+  return connectionFor(args.projectRoot, args.indexDir).call(op, args, options);
 }
 
-// src/codebase-index/project-server-client.ts
-import { spawn as spawn7 } from "node:child_process";
-import * as fs17 from "node:fs";
-import * as net3 from "node:net";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+// src/codebase-index/background-indexer.ts
+import * as fs18 from "node:fs";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+import { Worker } from "node:worker_threads";
 
-// src/codebase-index/project-server-endpoint.ts
-import { createHash as createHash4 } from "node:crypto";
-import * as fs16 from "node:fs";
-import * as os7 from "node:os";
+// src/codebase-index/indexer.ts
+import { expectDefined as expectDefined6 } from "@wrongstack/core/utils";
+import { execFile as execFile2 } from "node:child_process";
+import * as fs17 from "node:fs/promises";
+import { availableParallelism } from "node:os";
 import * as path23 from "node:path";
-import { fileURLToPath } from "node:url";
-var PROJECT_INDEX_SERVER_PROTOCOL_VERSION = 1;
-var PROJECT_INDEX_SERVER_METADATA_FILE = "server.json";
-var buildIdCache;
-function projectIndexServerBuildId(entrypoint) {
-  const file = entrypoint instanceof URL || entrypoint.startsWith("file:") ? fileURLToPath(entrypoint) : path23.resolve(entrypoint);
-  try {
-    const stat17 = fs16.statSync(file);
-    if (buildIdCache?.file === file && buildIdCache.mtimeMs === stat17.mtimeMs && buildIdCache.size === stat17.size) {
-      return buildIdCache.buildId;
-    }
-    const buildId = createHash4("sha256").update(fs16.readFileSync(file)).digest("hex").slice(0, 24);
-    buildIdCache = { file, mtimeMs: stat17.mtimeMs, size: stat17.size, buildId };
-    return buildId;
-  } catch {
-    return `unreadable:${path23.basename(file)}`;
-  }
-}
-function normalizeLocalPath(value) {
-  const resolved = path23.resolve(value);
-  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
-}
-function projectIndexServerKey(projectRoot, indexDir) {
-  const resolvedIndexDir = normalizeLocalPath(resolveIndexDir(projectRoot, indexDir));
-  return createHash4("sha256").update(resolvedIndexDir).digest("hex").slice(0, 24);
+import {
+  DEFAULT_WALK_IGNORE_DIRS,
+  indexParallelBatchSize,
+  isFrugalPerf
+} from "@wrongstack/core/utils";
+
+// src/codebase-index/gitignore.ts
+import * as fs13 from "node:fs/promises";
+import * as path17 from "node:path";
+import { compileGlob } from "@wrongstack/core/utils";
+function globBody(glob) {
+  return compileGlob(glob).source.replace(/^\^/, "").replace(/\$$/, "");
 }
-function projectIndexServerEndpoint(projectRoot, indexDir) {
-  const key = projectIndexServerKey(projectRoot, indexDir);
-  if (process.platform === "win32") {
-    return `\\\\.\\pipe\\wrongstack-codebase-index-v${PROJECT_INDEX_SERVER_PROTOCOL_VERSION}-${key}`;
+function compileGitignore(lines) {
+  const rules = [];
+  for (const raw of lines) {
+    let line = raw.replace(/\r$/, "");
+    if (!line.trim() || line.trimStart().startsWith("#")) continue;
+    line = line.trim();
+    let negated = false;
+    if (line.startsWith("!")) {
+      negated = true;
+      line = line.slice(1);
+    }
+    let dirOnly = false;
+    if (line.endsWith("/")) {
+      dirOnly = true;
+      line = line.slice(0, -1);
+    }
+    if (!line) continue;
+    const anchored = line.startsWith("/") || line.includes("/");
+    if (line.startsWith("/")) line = line.slice(1);
+    const body = globBody(line);
+    const prefix = anchored ? "^" : "(?:^|.*/)";
+    rules.push({
+      eqOrUnder: new RegExp(`${prefix}${body}(?:/.*)?$`),
+      under: new RegExp(`${prefix}${body}/.*$`),
+      negated,
+      dirOnly
+    });
   }
-  return path23.join(
-    os7.tmpdir(),
-    `wrongstack-codebase-index-v${PROJECT_INDEX_SERVER_PROTOCOL_VERSION}`,
-    `${key}.sock`
-  );
+  return (relPath, isDir) => {
+    const p = relPath.replace(/\\/g, "/").replace(/^\/+/, "");
+    let ignored = false;
+    for (const r of rules) {
+      const re = r.dirOnly && !isDir ? r.under : r.eqOrUnder;
+      if (re.test(p)) ignored = !r.negated;
+    }
+    return ignored;
+  };
 }
-function projectIndexServerMetadataPath(projectRoot, indexDir) {
-  return path23.join(
-    path23.resolve(resolveIndexDir(projectRoot, indexDir)),
-    PROJECT_INDEX_SERVER_METADATA_FILE
-  );
+async function loadGitignoreMatcher(projectRoot) {
+  let lines = [];
+  try {
+    const raw = await fs13.readFile(path17.join(projectRoot, ".gitignore"), "utf8");
+    lines = raw.split("\n");
+  } catch {
+  }
+  return compileGitignore(lines);
 }
 
-// src/codebase-index/project-server-protocol.ts
-var PROJECT_INDEX_SERVER_MAX_FRAME_CHARS = 64 * 1024 * 1024;
-function encodeProjectServerMessage(message) {
-  return `${JSON.stringify(message)}
-`;
-}
+// src/codebase-index/indexer.ts
+init_languages2();
 
-// src/codebase-index/project-server-client.ts
-var CONNECT_ATTEMPT_TIMEOUT_MS = 750;
-var SERVER_START_TIMEOUT_MS = 1e4;
-var SERVER_CONTROL_TIMEOUT_MS = 5e3;
-var SERVER_HEALTH_TIMEOUT_MS = 3e3;
-var SERVER_HEARTBEAT_INTERVAL_MS = 1e4;
-var StaleProjectIndexServerError = class extends Error {
-  constructor(message, pid) {
-    super(message);
-    this.pid = pid;
-  }
-  pid;
-  name = "StaleProjectIndexServerError";
-};
-var connectionStates = /* @__PURE__ */ new Map();
-var connectionStateListeners = /* @__PURE__ */ new Set();
-var latestConnectionState = {
-  status: "offline",
-  connected: false
-};
-function resolveProjectIndexDaemonAvailability() {
-  if (process.env["WRONGSTACK_INDEX_INLINE"] || process.env["WRONGSTACK_INDEX_SERVER"] === "0") {
-    return { kind: "inline-requested" };
-  }
-  for (const rel of ["./project-server.js", "./codebase-index/project-server.js"]) {
-    try {
-      const url = new URL(rel, import.meta.url);
-      if (url.protocol === "file:" && fs17.existsSync(fileURLToPath2(url))) {
-        return { kind: "available", url };
-      }
-    } catch {
+// src/codebase-index/parser-dispatch.ts
+async function parseFileContent(file, content, lang) {
+  switch (lang) {
+    case "ts":
+    case "tsx":
+    case "js":
+    case "jsx": {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_ts_parser(), ts_parser_exports));
+      return parseSymbols8({ file, content, lang });
+    }
+    case "go": {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_go_parser(), go_parser_exports));
+      return parseSymbols8({ file, content, lang: "go" });
+    }
+    case "py": {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_py_parser(), py_parser_exports));
+      return parseSymbols8({ file, content, lang: "py" });
+    }
+    case "rs": {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_rs_parser(), rs_parser_exports));
+      return parseSymbols8({ file, content, lang: "rs" });
+    }
+    case "json": {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_json_parser(), json_parser_exports));
+      return parseSymbols8({ file, content, lang: "json" });
+    }
+    case "yaml": {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_yaml_parser(), yaml_parser_exports));
+      return parseSymbols8({ file, content, lang: "yaml" });
+    }
+    default: {
+      const { parseSymbols: parseSymbols8 } = await Promise.resolve().then(() => (init_generic_parser(), generic_parser_exports));
+      return parseSymbols8({ file, content, lang });
     }
   }
-  return { kind: "missing-build" };
-}
-function resolveProjectServerUrl() {
-  const availability = resolveProjectIndexDaemonAvailability();
-  return availability.kind === "available" ? availability.url : null;
-}
-function projectIndexServerExpectedBuildId() {
-  const override = process.env["WRONGSTACK_INDEX_SERVER_BUILD_ID"]?.trim();
-  if (override) return override;
-  const url = resolveProjectServerUrl();
-  return url ? projectIndexServerBuildId(url) : null;
-}
-function isProjectIndexServerAvailable() {
-  return resolveProjectServerUrl() !== null;
 }
-function publishConnectionState(endpoint, state) {
-  connectionStates.set(endpoint, state);
-  latestConnectionState = state;
-  for (const listener of connectionStateListeners) listener(state);
+
+// src/codebase-index/indexer.ts
+var YIELD_EVERY_N = 50;
+function resolveParallelBatch() {
+  return indexParallelBatchSize(availableParallelism());
 }
-function getProjectIndexServerConnectionState(projectRoot, indexDir) {
-  if (projectRoot) {
-    const endpoint = projectIndexServerEndpoint(projectRoot, indexDir);
-    const existing = connectionStates.get(endpoint);
-    if (existing) return existing;
-    if (!isProjectIndexServerAvailable()) {
-      return { status: "unavailable", connected: false };
-    }
-    return {
-      status: "offline",
-      connected: false,
-      projectRoot,
-      indexDir,
-      endpoint
-    };
-  }
-  if (latestConnectionState.endpoint) return latestConnectionState;
-  if (!isProjectIndexServerAvailable()) return { status: "unavailable", connected: false };
-  return latestConnectionState;
+function yieldEventLoop() {
+  return new Promise((resolve16) => setImmediate(resolve16));
 }
-function onProjectIndexServerConnectionStateChange(listener) {
-  connectionStateListeners.add(listener);
-  return () => connectionStateListeners.delete(listener);
+function throwIfAborted(signal) {
+  if (!signal?.aborted) return;
+  if (signal.reason instanceof Error) throw signal.reason;
+  throw new Error(typeof signal.reason === "string" ? signal.reason : "Indexing cancelled");
 }
-function remoteError(message, name) {
-  if (name === "LockError") return new LockError(message);
-  if (name === "IndexTimeoutError") return new IndexTimeoutError(message);
-  const error = new Error(message);
-  if (name && name !== "Error") error.name = name;
-  return error;
+function isAbortError(err) {
+  return err instanceof DOMException && err.name === "AbortError";
 }
-function isProjectIndexServerHealth(value) {
-  if (!value || typeof value !== "object") return false;
-  const health = value;
-  const memory = health.memory && typeof health.memory === "object" ? health.memory : void 0;
-  const activity = health.activity && typeof health.activity === "object" ? health.activity : void 0;
-  return typeof health.checkedAt === "number" && typeof health.uptimeMs === "number" && typeof memory?.rss === "number" && typeof memory.heapUsed === "number" && typeof memory.heapTotal === "number" && typeof memory.external === "number" && typeof health.clients === "number" && typeof health.activeRequests === "number" && typeof health.activeWrites === "number" && typeof health.queuedWrites === "number" && typeof health.pendingExternalFiles === "number" && typeof health.watchingExternal === "boolean" && typeof activity?.indexing === "boolean" && typeof activity.currentFile === "number" && typeof activity.totalFiles === "number" && typeof activity.generation === "number";
+var DEFAULT_IGNORE = DEFAULT_WALK_IGNORE_DIRS;
+var DEFAULT_IGNORE_FILES = /* @__PURE__ */ new Set(["package-lock.json", "pnpm-lock.yaml", "pnpm-lock.yml"]);
+var INDEXABLE_EXTENSION_SET = new Set(INDEXABLE_EXTENSIONS);
+var MAX_INDEX_FILE_BYTES = 5 * 1024 * 1024;
+var MAX_GIT_FILE_LIST_BYTES = 64 * 1024 * 1024;
+function isWithinProject(projectRoot, file) {
+  const rel = path23.relative(projectRoot, file);
+  return rel !== "" && !rel.startsWith(`..${path23.sep}`) && rel !== ".." && !path23.isAbsolute(rel);
 }
-function delay(ms) {
-  return new Promise((resolve16) => {
-    const timer = setTimeout(resolve16, ms);
-    timer.unref?.();
-  });
+function isMissingPathError(err) {
+  const code = err?.code;
+  return code === "ENOENT" || code === "ENOTDIR";
 }
-function cancellationError(signal) {
-  return signal.reason instanceof Error ? signal.reason : new Error("Indexing cancelled");
+function normalizeComparablePath(value) {
+  const resolved = path23.resolve(value);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }
-var ProjectServerConnection = class {
-  constructor(projectRoot, indexDir, endpoint) {
-    this.projectRoot = projectRoot;
-    this.indexDir = indexDir;
-    this.endpoint = endpoint;
-    this.transition("offline");
-  }
-  projectRoot;
-  indexDir;
-  endpoint;
-  socket = null;
-  buffer = "";
-  info = null;
-  activity = null;
-  health = null;
-  healthCheck = null;
-  connecting = null;
-  connectResolve = null;
-  connectReject = null;
-  nextId = 1;
-  pending = /* @__PURE__ */ new Map();
-  transition(status, options = {}) {
-    const previous = connectionStates.get(this.endpoint);
-    const pid = options.pid ?? (status === "connected" ? this.info?.pid : void 0);
-    const lastError = options.error === void 0 ? status === "error" || status === "degraded" || status === "unresponsive" ? previous?.lastError : void 0 : options.error instanceof Error ? options.error.message : String(options.error);
-    publishConnectionState(this.endpoint, {
-      status,
-      connected: status === "connected" || status === "degraded" || status === "unresponsive",
-      projectRoot: this.projectRoot,
-      indexDir: this.indexDir,
-      endpoint: this.endpoint,
-      pid,
-      lastError,
-      ...this.activity ? { activity: this.activity } : {},
-      ...this.health ? { health: this.health } : {}
-    });
-  }
-  isConnected() {
-    return this.socket !== null && !this.socket.destroyed && this.info !== null;
-  }
-  async checkHealth(spawnIfMissing = false, timeoutMs = SERVER_HEALTH_TIMEOUT_MS) {
-    await this.ensureConnected(spawnIfMissing);
-    if (this.healthCheck) return this.healthCheck;
-    const startedAt = Date.now();
-    this.healthCheck = this.request({ type: "ping" }, { timeoutMs }).then((server) => {
-      const now = Date.now();
-      this.health = {
-        status: "healthy",
-        checkedAt: now,
-        lastHealthyAt: now,
-        latencyMs: Math.max(0, now - startedAt),
-        missedHeartbeats: 0,
-        ...isProjectIndexServerHealth(server) ? { server } : {}
-      };
-      this.transition("connected", { pid: this.info?.pid });
-      return this.health;
-    }).catch((error) => {
-      if (!this.isConnected()) throw error;
-      if ((this.health?.lastHealthyAt ?? 0) > startedAt) return this.health;
-      const missedHeartbeats = (this.health?.missedHeartbeats ?? 0) + 1;
-      const status = missedHeartbeats >= 3 ? "unresponsive" : "degraded";
-      this.health = {
-        status,
-        checkedAt: Date.now(),
-        lastHealthyAt: this.health?.lastHealthyAt ?? null,
-        latencyMs: null,
-        missedHeartbeats,
-        ...this.health?.server ? { server: this.health.server } : {}
-      };
-      this.transition(status, { pid: this.info?.pid, error });
-      return this.health;
-    }).finally(() => {
-      this.healthCheck = null;
-    });
-    return this.healthCheck;
-  }
-  markResponsive() {
-    const now = Date.now();
-    this.health = {
-      status: "healthy",
-      checkedAt: now,
-      lastHealthyAt: now,
-      latencyMs: this.health?.latencyMs ?? null,
-      missedHeartbeats: 0,
-      ...this.health?.server ? { server: this.health.server } : {}
+function gitOutput(projectRoot, args) {
+  return new Promise((resolve16, reject) => {
+    execFile2(
+      "git",
+      ["-C", projectRoot, ...args],
+      {
+        encoding: "buffer",
+        maxBuffer: MAX_GIT_FILE_LIST_BYTES,
+        windowsHide: true
+      },
+      (error, stdout) => {
+        if (error) reject(error);
+        else resolve16(Buffer.isBuffer(stdout) ? stdout : Buffer.from(stdout));
+      }
+    );
+  });
+}
+async function findGitSourceFiles(projectRoot, ignore, signal) {
+  try {
+    throwIfAborted(signal);
+    const topLevel = (await gitOutput(projectRoot, ["rev-parse", "--show-toplevel"])).toString("utf8").trim();
+    if (normalizeComparablePath(topLevel) !== normalizeComparablePath(projectRoot)) return null;
+    throwIfAborted(signal);
+    const ignoreSet = /* @__PURE__ */ new Set([...DEFAULT_IGNORE, ...ignore]);
+    const [output, statusOutput] = await Promise.all([
+      gitOutput(projectRoot, ["ls-files", "--cached", "--others", "--exclude-standard", "-z"]),
+      gitOutput(projectRoot, [
+        "status",
+        "--porcelain=v1",
+        "-z",
+        "--untracked-files=all",
+        "--ignored=no"
+      ])
+    ]);
+    throwIfAborted(signal);
+    const dirty = /* @__PURE__ */ new Set();
+    const deleted = /* @__PURE__ */ new Set();
+    const statusRecords = statusOutput.toString("utf8").split("\0");
+    for (let i = 0; i < statusRecords.length; i++) {
+      const record = statusRecords[i];
+      if (!record) continue;
+      const status = record.slice(0, 2);
+      const changedPath = path23.resolve(projectRoot, record.slice(3));
+      dirty.add(changedPath);
+      if (status.includes("D")) deleted.add(changedPath);
+      if (status.includes("R") || status.includes("C")) {
+        const source = statusRecords[++i];
+        if (source) dirty.add(path23.resolve(projectRoot, source));
+      }
+    }
+    const files = [];
+    for (const relative12 of output.toString("utf8").split("\0")) {
+      if (!relative12) continue;
+      const portable = relative12.replace(/\\/g, "/");
+      if (portable.split("/").some((segment) => ignoreSet.has(segment)) || DEFAULT_IGNORE_FILES.has(path23.posix.basename(portable))) {
+        continue;
+      }
+      const full = path23.resolve(projectRoot, relative12);
+      if (deleted.has(full)) continue;
+      const ext = path23.extname(relative12).toLowerCase();
+      if (INDEXABLE_EXTENSION_SET.has(ext) || detectLang(full) !== null) files.push(full);
+    }
+    return {
+      files,
+      trustedUnchanged: new Set(files.filter((file) => !dirty.has(file)))
     };
+  } catch {
+    return null;
   }
-  async call(op, args, options) {
-    if (options.signal?.aborted) throw cancellationError(options.signal);
-    await this.ensureConnected(true);
-    if (options.signal?.aborted) throw cancellationError(options.signal);
-    return this.request({ type: "request", op, args }, options);
+}
+async function findSourceFiles(projectRoot, ignore, isGitIgnored, signal) {
+  const gitFiles = await findGitSourceFiles(projectRoot, ignore, signal);
+  if (gitFiles) {
+    return {
+      files: gitFiles.files,
+      complete: true,
+      errors: [],
+      trustedUnchanged: gitFiles.trustedUnchanged
+    };
   }
-  async shutdownRemote(reason) {
-    try {
-      await this.ensureConnected(false);
-    } catch {
-      return { stopped: false, reason: "not-running" };
+  const results = [];
+  const errors = [];
+  let complete = true;
+  const ignoreSet = /* @__PURE__ */ new Set([...DEFAULT_IGNORE, ...ignore]);
+  const indexableExts = new Set(INDEXABLE_EXTENSIONS);
+  let dirCount = 0;
+  const walk = async (dir) => {
+    throwIfAborted(signal);
+    if (dirCount > 0 && dirCount % YIELD_EVERY_N === 0) {
+      await yieldEventLoop();
+      throwIfAborted(signal);
     }
-    const pid = this.info?.pid;
+    let entries;
     try {
-      this.transition("stopping", { pid });
-      await this.request(
-        { type: "shutdown", reason },
-        { timeoutMs: SERVER_CONTROL_TIMEOUT_MS }
-      );
-      return { stopped: true, pid };
-    } catch (error) {
-      const forceKilled = this.forceKillKnownServer();
-      return {
-        stopped: forceKilled,
-        pid,
-        reason: forceKilled ? `force-killed after graceful shutdown failed: ${error instanceof Error ? error.message : String(error)}` : error instanceof Error ? error.message : String(error)
-      };
-    } finally {
-      this.close();
+      entries = await fs17.readdir(dir, { withFileTypes: true });
+    } catch (err) {
+      complete = false;
+      errors.push(`scan error: ${dir}: ${err instanceof Error ? err.message : String(err)}`);
+      return;
     }
-  }
-  async configure(watchExternal, debounceMs) {
-    await this.ensureConnected(true);
-    const startedAt = Date.now();
-    const result = await this.request(
-      { type: "configure", watchExternal, debounceMs },
-      { timeoutMs: SERVER_CONTROL_TIMEOUT_MS }
-    );
-    if (isProjectIndexServerHealth(result.health)) {
-      const now = Date.now();
-      this.health = {
-        status: "healthy",
-        checkedAt: now,
-        lastHealthyAt: now,
-        latencyMs: Math.max(0, now - startedAt),
-        missedHeartbeats: 0,
-        server: result.health
-      };
-      this.transition("connected", { pid: this.info?.pid });
+    dirCount++;
+    for (const e of entries) {
+      if (ignoreSet.has(e.name)) continue;
+      const full = path23.join(dir, e.name);
+      const rel = path23.relative(projectRoot, full).replace(/\\/g, "/");
+      if (e.isDirectory()) {
+        if (isGitIgnored(rel, true)) continue;
+        await walk(full);
+      } else if (e.isFile()) {
+        if (DEFAULT_IGNORE_FILES.has(e.name) || isGitIgnored(rel, false)) continue;
+        const ext = path23.extname(e.name).toLowerCase();
+        if (indexableExts.has(ext) || detectLang(full) !== null) {
+          results.push(full);
+        }
+      }
+    }
+  };
+  await walk(projectRoot);
+  return { files: results, complete, errors };
+}
+function assignRefsToSymbols2(refs, symbols) {
+  if (refs.length === 0 || symbols.length === 0) return [];
+  const ordered = [...symbols].sort((a, b) => a.line - b.line || a.col - b.col || a.id - b.id);
+  const seen = /* @__PURE__ */ new Set();
+  const assigned = [];
+  for (const ref of refs) {
+    let owner2;
+    for (const symbol of ordered) {
+      if (symbol.line > ref.line) break;
+      owner2 = symbol;
     }
+    if (!owner2 && ref.callType === "import") owner2 = ordered[0];
+    if (!owner2 || owner2.id <= 0) continue;
+    const key = `${owner2.id}:${ref.toName}:${ref.callType}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    assigned.push({ ...ref, fromId: owner2.id });
   }
-  close() {
-    const socket = this.socket;
-    this.socket = null;
-    this.info = null;
-    this.activity = null;
-    this.health = null;
-    this.connectReject?.(new Error("codebase-index client disconnected"));
-    this.connectResolve = null;
-    this.connectReject = null;
-    if (socket && !socket.destroyed) socket.destroy();
-    this.rejectPending(new Error("codebase-index client disconnected"));
-    this.transition("offline");
-    maybeStopHeartbeatLoop();
+  return assigned;
+}
+async function runIndexerWithStore(store, opts) {
+  const { projectRoot, langs, ignore = [], signal } = opts;
+  const relationGraphVersion = "2";
+  const refResolutionVersion = "2";
+  const force = (opts.force ?? false) || store.getMetadata("relation_graph_version") !== relationGraphVersion;
+  const needsFullRefResolution = force || store.getMetadata("ref_resolution_version") !== refResolutionVersion;
+  const startMs = Date.now();
+  const errors = [];
+  const langStats = {};
+  let filesIndexed = 0;
+  let symbolsIndexed = 0;
+  const isGitIgnored = await loadGitignoreMatcher(projectRoot);
+  let files;
+  let discoveredFiles = null;
+  let discoveryComplete = true;
+  let trustedUnchanged;
+  if (opts.files && opts.files.length > 0) {
+    files = opts.files.map((f) => path23.resolve(projectRoot, f)).filter((f) => {
+      if (!isWithinProject(projectRoot, f)) return false;
+      const rel = path23.relative(projectRoot, f).replace(/\\/g, "/");
+      return !rel.split("/").some((seg) => DEFAULT_IGNORE.includes(seg)) && !DEFAULT_IGNORE_FILES.has(path23.basename(f)) && !isGitIgnored(rel, false);
+    });
+  } else {
+    const discovery = await findSourceFiles(projectRoot, ignore, isGitIgnored, signal);
+    files = discovery.files;
+    errors.push(...discovery.errors);
+    discoveryComplete = discovery.complete;
+    discoveredFiles = new Set(files);
+    trustedUnchanged = discovery.trustedUnchanged;
   }
-  request(message, options) {
-    const socket = this.socket;
-    if (!socket || socket.destroyed) {
-      return Promise.reject(new Error("codebase-index server connection is not available"));
-    }
-    const id = this.nextId++;
-    return new Promise((resolve16, reject) => {
-      const timer = setTimeout(() => {
-        const entry = this.pending.get(id);
-        if (!entry) return;
-        this.pending.delete(id);
-        this.write({ type: "cancel", id });
-        const error = new IndexTimeoutError(
-          `Index ${message.type === "request" ? message.op : message.type} exceeded its ${options.timeoutMs}ms watchdog timeout`
-        );
-        this.cleanupPending(entry);
-        entry.reject(error);
-      }, options.timeoutMs);
-      timer.unref?.();
-      const signal = options.signal;
-      const onAbort = signal ? () => {
-        const entry = this.pending.get(id);
-        if (!entry) return;
-        this.pending.delete(id);
-        this.write({ type: "cancel", id });
-        this.cleanupPending(entry);
-        entry.reject(cancellationError(signal));
-      } : void 0;
-      this.pending.set(id, {
-        resolve: resolve16,
-        reject,
-        timer,
-        signal,
-        onAbort,
-        onProgress: options.onProgress
-      });
-      if (signal && onAbort) {
-        signal.addEventListener("abort", onAbort, { once: true });
-        if (signal.aborted) {
-          onAbort();
-          return;
-        }
-      }
-      this.write({ ...message, id });
+  if (langs && langs.length > 0) {
+    const langSet = new Set(langs);
+    files = files.filter((f) => {
+      const lang = detectLang(f);
+      return lang ? langSet.has(lang) : false;
     });
   }
-  async ensureConnected(spawnIfMissing) {
-    if (this.socket && !this.socket.destroyed && this.info) return;
-    if (this.connecting) return this.connecting;
-    this.transition("connecting");
-    this.connecting = this.connectWithElection(spawnIfMissing).catch((error) => {
-      this.transition("error", { error });
-      throw error;
-    }).finally(() => {
-      this.connecting = null;
+  if (force) store.clearAll();
+  const existingMeta = /* @__PURE__ */ new Map();
+  if (!force) {
+    for (const meta of store.getAllFileMetas()) existingMeta.set(meta.file, meta);
+  }
+  const totalFilesForProgress = files.length;
+  let filesPreSkipped = 0;
+  if (!force && trustedUnchanged) {
+    files = files.filter((file) => {
+      const meta = existingMeta.get(file);
+      if (!meta || !trustedUnchanged.has(file)) return true;
+      langStats[meta.lang] = (langStats[meta.lang] ?? 0) + meta.symbolCount;
+      symbolsIndexed += meta.symbolCount;
+      filesIndexed++;
+      filesPreSkipped++;
+      return false;
     });
-    return this.connecting;
+    if (filesPreSkipped > 0) opts.onProgress?.(filesPreSkipped, totalFilesForProgress);
   }
-  async connectWithElection(spawnIfMissing) {
-    const deadline = Date.now() + (spawnIfMissing ? SERVER_START_TIMEOUT_MS : CONNECT_ATTEMPT_TIMEOUT_MS);
-    let spawned = false;
-    let staleAttempts = 0;
-    let lastError = new Error("codebase-index server unavailable");
-    while (Date.now() < deadline) {
-      try {
-        await this.connectOnce();
-        return;
-      } catch (error) {
-        lastError = error;
-        if (error instanceof StaleProjectIndexServerError) {
-          staleAttempts++;
-          if (!spawnIfMissing) break;
-          if (staleAttempts >= 3) this.forceKillServer(error.pid);
-          spawned = false;
-          await delay(100);
-          continue;
+  const parallelBatch = resolveParallelBatch();
+  let filesSinceLastYield = 0;
+  for (let batchStart = 0; batchStart < files.length; batchStart += parallelBatch) {
+    const batchEnd = Math.min(batchStart + parallelBatch, files.length);
+    const batchFiles = files.slice(batchStart, batchEnd);
+    opts.onProgress?.(filesPreSkipped + batchEnd, totalFilesForProgress);
+    filesSinceLastYield += batchFiles.length;
+    if (filesSinceLastYield >= YIELD_EVERY_N) {
+      filesSinceLastYield = 0;
+      await yieldEventLoop();
+      if (isFrugalPerf()) {
+        await new Promise((r) => setTimeout(r, 8));
+      }
+      throwIfAborted(signal);
+    }
+    const statOpts = signal ? { signal } : {};
+    const statReadParse = await Promise.allSettled(
+      batchFiles.map(
+        async (file) => {
+          let stat17;
+          try {
+            stat17 = await fs17.stat(file, statOpts);
+          } catch (e) {
+            if (isAbortError(e)) throw e;
+            return {
+              file,
+              stat: null,
+              lang: "",
+              parsed: null,
+              error: `stat error: ${e instanceof Error ? e.message : String(e)}`,
+              missing: isMissingPathError(e)
+            };
+          }
+          if (!stat17.isFile()) return { file, stat: stat17, lang: "", parsed: null };
+          const lang = detectLang(file);
+          if (!lang) return { file, stat: stat17, lang: "", parsed: null };
+          if (stat17.size > MAX_INDEX_FILE_BYTES) {
+            return {
+              file,
+              stat: stat17,
+              lang,
+              parsed: null,
+              error: `file too large (${stat17.size} bytes; max ${MAX_INDEX_FILE_BYTES})`
+            };
+          }
+          const meta = existingMeta.get(file);
+          if (!force && meta && meta.mtimeMs === Math.floor(stat17.mtimeMs)) {
+            return { file, stat: stat17, lang, parsed: null, skippedMeta: meta };
+          }
+          let content;
+          try {
+            content = await fs17.readFile(file, { encoding: "utf8", signal });
+          } catch (e) {
+            if (isAbortError(e)) throw e;
+            return {
+              file,
+              stat: stat17,
+              lang,
+              parsed: null,
+              error: `read error: ${e instanceof Error ? e.message : String(e)}`
+            };
+          }
+          let parsed;
+          try {
+            parsed = await parseFileContent(file, content, lang);
+          } catch (e) {
+            return {
+              file,
+              stat: stat17,
+              lang,
+              parsed: null,
+              error: `parse error: ${e instanceof Error ? e.message : String(e)}`
+            };
+          }
+          return { file, stat: stat17, lang, parsed, content };
         }
+      )
+    );
+    const batchEntries = [];
+    const deleteForFiles = [];
+    for (let fi = 0; fi < statReadParse.length; fi++) {
+      const settled = statReadParse[fi];
+      const file = expectDefined6(batchFiles[fi]);
+      if (settled.status === "rejected") {
+        const err = settled.reason;
+        if (err instanceof Error && isAbortError(err)) throw err;
+        errors.push(`batch error: ${file}: ${err instanceof Error ? err.message : String(err)}`);
+        continue;
       }
-      if (!spawnIfMissing) break;
-      if (!spawned) {
-        this.spawnDetachedServer();
-        spawned = true;
+      const result = settled.value;
+      if (result.error) {
+        if (result.missing) store.deleteFile(file);
+        errors.push(`${file}: ${result.error}`);
+        continue;
       }
-      await delay(75);
-    }
-    throw lastError;
-  }
-  connectOnce() {
-    this.socket?.destroy();
-    this.socket = null;
-    this.info = null;
-    this.activity = null;
-    this.health = null;
-    this.buffer = "";
-    return new Promise((resolve16, reject) => {
-      const socket = net3.createConnection(this.endpoint);
-      this.socket = socket;
-      socket.setEncoding("utf8");
-      const timer = setTimeout(() => {
-        reject(new Error("codebase-index server handshake timed out"));
-        socket.destroy();
-      }, CONNECT_ATTEMPT_TIMEOUT_MS);
-      timer.unref?.();
-      const finishResolve = () => {
-        clearTimeout(timer);
-        this.connectResolve = null;
-        this.connectReject = null;
-        resolve16();
-      };
-      const finishReject = (error) => {
-        clearTimeout(timer);
-        this.connectResolve = null;
-        this.connectReject = null;
-        reject(error);
-      };
-      this.connectResolve = finishResolve;
-      this.connectReject = finishReject;
-      socket.on("data", (chunk) => this.onData(socket, chunk));
-      socket.on("error", (error) => {
-        if (!this.info) finishReject(error);
+      const { stat: stat17, lang, parsed } = result;
+      if (result.skippedMeta) {
+        langStats[lang] = (langStats[lang] ?? 0) + result.skippedMeta.symbolCount;
+        symbolsIndexed += result.skippedMeta.symbolCount;
+        filesIndexed++;
+        continue;
+      }
+      if (!lang || !parsed) {
+        if (lang) {
+          store.upsertFile({
+            file,
+            lang,
+            mtimeMs: Math.floor(stat17.mtimeMs),
+            symbolCount: 0,
+            lastIndexed: Date.now()
+          });
+          filesIndexed++;
+        }
+        continue;
+      }
+      if (parsed.symbols.length === 0) {
+        store.replaceEmptyFile({
+          file,
+          lang,
+          mtimeMs: Math.floor(stat17.mtimeMs),
+          symbolCount: 0,
+          lastIndexed: Date.now()
+        });
+        filesIndexed++;
+        continue;
+      }
+      batchEntries.push({
+        file,
+        lang,
+        symbols: parsed.symbols,
+        refs: parsed.refs ?? [],
+        mtimeMs: Math.floor(stat17.mtimeMs),
+        symbolCount: parsed.symbols.length
       });
-      socket.on("close", () => this.onClose(socket));
-    });
-  }
-  onData(socket, chunk) {
-    if (socket !== this.socket) return;
-    this.buffer += chunk;
-    while (true) {
-      const newline = this.buffer.indexOf("\n");
-      if (newline < 0) {
-        if (this.buffer.length > PROJECT_INDEX_SERVER_MAX_FRAME_CHARS) {
-          socket.destroy(new Error("codebase-index server response exceeds the IPC limit"));
+      deleteForFiles.push(file);
+    }
+    if (batchEntries.length > 0) {
+      try {
+        store.commitBatch(batchEntries, { deleteForFiles });
+        for (const entry of batchEntries) {
+          const count = entry.symbols.length;
+          symbolsIndexed += count;
+          langStats[entry.lang] = (langStats[entry.lang] ?? 0) + count;
+          filesIndexed++;
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push(`commitBatch failed: ${message} \u2014 falling back to per-file writes`);
+        for (const entry of batchEntries) {
+          try {
+            store.deleteRefsForFile(entry.file);
+            store.deleteSymbolsForFile(entry.file);
+            const symbolsWithIds = store.insertSymbols(entry.symbols);
+            symbolsIndexed += symbolsWithIds.length;
+            langStats[entry.lang] = (langStats[entry.lang] ?? 0) + symbolsWithIds.length;
+            filesIndexed++;
+            if (entry.refs.length > 0 && symbolsWithIds.length > 0) {
+              const fallbackBatch = assignRefsToSymbols2(entry.refs, symbolsWithIds);
+              if (fallbackBatch.length > 0) store.insertRefsBatch(fallbackBatch);
+            }
+            store.resolveRefsForNames([
+              ...entry.symbols.map((symbol) => symbol.name),
+              ...entry.refs.map((ref) => ref.toName)
+            ]);
+            store.upsertFile({
+              file: entry.file,
+              lang: entry.lang,
+              mtimeMs: entry.mtimeMs,
+              symbolCount: entry.symbolCount,
+              lastIndexed: Date.now()
+            });
+          } catch (innerErr) {
+            errors.push(
+              `fallback write failed: ${entry.file}: ${innerErr instanceof Error ? innerErr.message : String(innerErr)}`
+            );
+          }
         }
-        return;
-      }
-      if (newline > PROJECT_INDEX_SERVER_MAX_FRAME_CHARS) {
-        socket.destroy(new Error("codebase-index server response exceeds the IPC limit"));
-        return;
-      }
-      const line = this.buffer.slice(0, newline);
-      this.buffer = this.buffer.slice(newline + 1);
-      if (!line) continue;
-      let message;
-      try {
-        message = JSON.parse(line);
-      } catch {
-        socket.destroy(new Error("invalid codebase-index server response"));
-        return;
       }
-      this.onMessage(message);
     }
   }
-  onMessage(message) {
-    if (message.type === "hello") {
-      if (message.protocolVersion !== PROJECT_INDEX_SERVER_PROTOCOL_VERSION) {
-        this.rejectStaleServer(
-          message,
-          `codebase-index protocol mismatch: client=${PROJECT_INDEX_SERVER_PROTOCOL_VERSION}, server=${message.protocolVersion}`
-        );
-        return;
-      }
-      const expectedBuildId = projectIndexServerExpectedBuildId();
-      if (expectedBuildId && message.buildId !== expectedBuildId) {
-        this.rejectStaleServer(
-          message,
-          `codebase-index build mismatch: client=${expectedBuildId}, server=${message.buildId ?? "legacy"}`
-        );
-        return;
+  if (discoveredFiles && discoveryComplete) {
+    for (const [file_] of existingMeta) {
+      if (!discoveredFiles.has(file_)) {
+        store.deleteFile(file_);
       }
-      this.info = message;
-      this.markResponsive();
-      this.transition("connected", { pid: message.pid });
-      ensureHeartbeatLoop();
-      this.connectResolve?.();
-      return;
-    }
-    if (message.type === "index-state") {
-      this.activity = message.state;
-      this.markResponsive();
-      this.transition("connected", { pid: this.info?.pid });
-      return;
-    }
-    const entry = this.pending.get(message.id);
-    if (!entry) return;
-    this.markResponsive();
-    const status = connectionStates.get(this.endpoint)?.status;
-    if (status === "degraded" || status === "unresponsive") {
-      this.transition("connected", { pid: this.info?.pid });
-    }
-    if (message.type === "progress") {
-      entry.onProgress?.(message.current, message.total);
-      return;
-    }
-    this.pending.delete(message.id);
-    this.cleanupPending(entry);
-    if (message.ok) entry.resolve(message.result);
-    else entry.reject(remoteError(message.error, message.errorName));
-  }
-  onClose(socket) {
-    if (socket !== this.socket) return;
-    const wasConnected = this.info !== null;
-    this.socket = null;
-    this.info = null;
-    this.activity = null;
-    this.health = null;
-    const error = new Error("codebase-index server connection closed");
-    this.connectReject?.(error);
-    this.connectResolve = null;
-    this.connectReject = null;
-    this.rejectPending(error);
-    if (wasConnected) this.transition("error", { error });
-    maybeStopHeartbeatLoop();
-  }
-  cleanupPending(entry) {
-    clearTimeout(entry.timer);
-    if (entry.signal && entry.onAbort) {
-      entry.signal.removeEventListener("abort", entry.onAbort);
-    }
-  }
-  rejectPending(error) {
-    const entries = [...this.pending.values()];
-    this.pending.clear();
-    for (const entry of entries) {
-      this.cleanupPending(entry);
-      entry.reject(error);
-    }
-  }
-  write(message) {
-    const socket = this.socket;
-    if (socket && !socket.destroyed) socket.write(encodeProjectServerMessage(message));
-  }
-  rejectStaleServer(message, reason) {
-    const socket = this.socket;
-    if (socket && !socket.destroyed) {
-      socket.write(
-        encodeProjectServerMessage({
-          type: "shutdown",
-          id: 0,
-          reason: "stale-build-replacement"
-        })
-      );
-      const timer = setTimeout(() => socket.destroy(), 25);
-      timer.unref?.();
     }
-    this.connectReject?.(new StaleProjectIndexServerError(reason, message.pid));
   }
-  spawnDetachedServer() {
-    const url = resolveProjectServerUrl();
-    if (!url) throw new Error("built codebase-index project server is unavailable");
-    if (process.platform !== "win32") {
-      try {
-        fs17.rmSync(this.endpoint, { force: true });
-      } catch {
-      }
-    }
-    const args = [fileURLToPath2(url), "--project-root", this.projectRoot];
-    if (this.indexDir) args.push("--index-dir", this.indexDir);
-    const child = spawn7(process.execPath, args, {
-      detached: true,
-      stdio: "ignore",
-      windowsHide: true,
-      env: process.env
+  if (needsFullRefResolution) store.resolveRefs();
+  store.setMetadata("ref_resolution_version", refResolutionVersion);
+  store.setMetadata("relation_graph_version", relationGraphVersion);
+  if (!opts.files || filesIndexed >= 50) store.optimize();
+  store.setLastIndexed(Date.now());
+  if (!opts.files) store.compactIfNeeded();
+  const durationMs = Date.now() - startMs;
+  return {
+    filesIndexed,
+    symbolsIndexed,
+    langStats,
+    durationMs,
+    errors
+  };
+}
+
+// src/codebase-index/index-service.ts
+async function indexService(args, hooks = {}) {
+  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
+  try {
+    return await runIndexerWithStore(store, {
+      projectRoot: args.projectRoot,
+      indexDir: args.indexDir,
+      files: args.files,
+      force: args.force,
+      langs: args.langs,
+      ignore: args.ignore,
+      signal: hooks.signal,
+      onProgress: hooks.onProgress
     });
-    child.unref();
+  } finally {
+    indexStorePool.release(store);
   }
-  forceKillKnownServer() {
-    const pid = this.info?.pid;
-    return pid ? this.forceKillServer(pid) : false;
+}
+function searchService(args) {
+  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
+  try {
+    return store.searchRanked(
+      args.query,
+      {
+        kind: args.kind,
+        lang: args.lang,
+        file: args.file,
+        lspKind: args.lspKind
+      },
+      args.limit
+    );
+  } finally {
+    indexStorePool.release(store);
   }
-  forceKillServer(pid) {
-    if (pid === process.pid) return false;
-    try {
-      process.kill(pid);
-      const metadataPath = projectIndexServerMetadataPath(this.projectRoot, this.indexDir);
-      try {
-        const metadata = JSON.parse(fs17.readFileSync(metadataPath, "utf8"));
-        if (metadata.pid === pid) fs17.rmSync(metadataPath, { force: true });
-      } catch {
-      }
-      return true;
-    } catch {
-      return false;
-    }
+}
+function statsService(args) {
+  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
+  try {
+    return store.getStats();
+  } finally {
+    indexStorePool.release(store);
   }
-};
-var connections = /* @__PURE__ */ new Map();
-var heartbeatTimer;
-function ensureHeartbeatLoop() {
-  if (heartbeatTimer) return;
-  heartbeatTimer = setInterval(() => {
-    for (const connection of connections.values()) {
-      if (connection.isConnected()) void connection.checkHealth(false).catch(() => {
-      });
-    }
-  }, SERVER_HEARTBEAT_INTERVAL_MS);
-  heartbeatTimer.unref?.();
 }
-function maybeStopHeartbeatLoop() {
-  if (!heartbeatTimer) return;
-  if ([...connections.values()].some((connection) => connection.isConnected())) return;
-  clearInterval(heartbeatTimer);
-  heartbeatTimer = void 0;
+function packageGraphService(args) {
+  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
+  try {
+    return store.getPackageGraph();
+  } finally {
+    indexStorePool.release(store);
+  }
 }
-function connectionFor(projectRoot, indexDir) {
-  const endpoint = projectIndexServerEndpoint(projectRoot, indexDir);
-  let connection = connections.get(endpoint);
-  if (!connection) {
-    connection = new ProjectServerConnection(projectRoot, indexDir, endpoint);
-    connections.set(endpoint, connection);
+function fileGraphService(args) {
+  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
+  try {
+    return store.getFileGraph(args.packageFilter);
+  } finally {
+    indexStorePool.release(store);
   }
-  return connection;
 }
-function callProjectIndexServer(op, args, options) {
-  return connectionFor(args.projectRoot, args.indexDir).call(op, args, options);
+function symbolGraphService(args) {
+  const store = indexStorePool.acquire(args.projectRoot, { indexDir: args.indexDir });
+  try {
+    return store.getSymbolGraph(args.fileFilter);
+  } finally {
+    indexStorePool.release(store);
+  }
 }
 
 // src/codebase-index/background-indexer.ts
@@ -13002,8 +13060,17 @@ function terminateWorker(reason) {
   if (w) void w.terminate().catch(() => {
   });
 }
+var warnedInvalidEndpoints = /* @__PURE__ */ new Set();
+function warnEndpointInvalidOnce(availability) {
+  if (warnedInvalidEndpoints.has(availability.endpoint)) return;
+  warnedInvalidEndpoints.add(availability.endpoint);
+  process.stderr.write(
+    `codebase-index: socket path is ${availability.byteLength} bytes, over this platform's ${availability.maxBytes}-byte sun_path limit (${availability.endpoint}). Subsequent calls will reject until TMPDIR is shortened to restore the shared daemon.
+`
+  );
+}
 function callIndexOp(op, args, opts) {
-  const availability = resolveProjectIndexDaemonAvailability();
+  const availability = resolveProjectIndexDaemonAvailability(args.projectRoot, args.indexDir);
   if (availability.kind === "available") {
     return callProjectIndexServer(op, args, opts);
   }
@@ -13014,6 +13081,14 @@ function callIndexOp(op, args, opts) {
       )
     );
   }
+  if (availability.kind === "endpoint-invalid") {
+    warnEndpointInvalidOnce(availability);
+    return Promise.reject(
+      new Error(
+        `codebase-index: socket path is ${availability.byteLength} bytes, over this platform's ${availability.maxBytes}-byte sun_path limit (${availability.endpoint}). Set a shorter TMPDIR to relocate the shared daemon, or set WRONGSTACK_INDEX_INLINE=1 to explicitly opt into a process-local index.`
+      )
+    );
+  }
   const w = ensureWorker();
   if (!w) return callInline(op, args, opts);
   if (opts.signal?.aborted) {