opencode-codebase-index 0.22.4 → 0.23.0

package/dist/cli.js

@@ -491,7 +491,7 @@ var require_ignore = __commonJS({
       //   path matching.
       // - check `string` either `MODE_IGNORE` or `MODE_CHECK_IGNORE`
       // @returns {TestResult} true if a file is ignored
-      test(path31, checkUnignored, mode) {
+      test(path33, checkUnignored, mode) {
         let ignored = false;
         let unignored = false;
         let matchedRule;
@@ -500,7 +500,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule[mode].test(path31);
+          const matched = rule[mode].test(path33);
           if (!matched) {
             return;
           }
@@ -521,17 +521,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path31, originalPath, doThrow) => {
-      if (!isString(path31)) {
+    var checkPath = (path33, originalPath, doThrow) => {
+      if (!isString(path33)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path31) {
+      if (!path33) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path31)) {
+      if (checkPath.isNotRelative(path33)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -540,7 +540,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path31) => REGEX_TEST_INVALID_PATH.test(path31);
+    var isNotRelative = (path33) => REGEX_TEST_INVALID_PATH.test(path33);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore2 = class {
@@ -570,19 +570,19 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
-        const path31 = originalPath && checkPath.convert(originalPath);
+        const path33 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path31,
+          path33,
           originalPath,
           this._strictPathCheck ? throwError : RETURN_FALSE
         );
-        return this._t(path31, cache, checkUnignored, slices);
+        return this._t(path33, cache, checkUnignored, slices);
       }
-      checkIgnore(path31) {
-        if (!REGEX_TEST_TRAILING_SLASH.test(path31)) {
-          return this.test(path31);
+      checkIgnore(path33) {
+        if (!REGEX_TEST_TRAILING_SLASH.test(path33)) {
+          return this.test(path33);
         }
-        const slices = path31.split(SLASH2).filter(Boolean);
+        const slices = path33.split(SLASH2).filter(Boolean);
         slices.pop();
         if (slices.length) {
           const parent = this._t(
@@ -595,18 +595,18 @@ var require_ignore = __commonJS({
             return parent;
           }
         }
-        return this._rules.test(path31, false, MODE_CHECK_IGNORE);
+        return this._rules.test(path33, false, MODE_CHECK_IGNORE);
       }
-      _t(path31, cache, checkUnignored, slices) {
-        if (path31 in cache) {
-          return cache[path31];
+      _t(path33, cache, checkUnignored, slices) {
+        if (path33 in cache) {
+          return cache[path33];
         }
         if (!slices) {
-          slices = path31.split(SLASH2).filter(Boolean);
+          slices = path33.split(SLASH2).filter(Boolean);
         }
         slices.pop();
         if (!slices.length) {
-          return cache[path31] = this._rules.test(path31, checkUnignored, MODE_IGNORE);
+          return cache[path33] = this._rules.test(path33, checkUnignored, MODE_IGNORE);
         }
         const parent = this._t(
           slices.join(SLASH2) + SLASH2,
@@ -614,29 +614,29 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache[path31] = parent.ignored ? parent : this._rules.test(path31, checkUnignored, MODE_IGNORE);
+        return cache[path33] = parent.ignored ? parent : this._rules.test(path33, checkUnignored, MODE_IGNORE);
       }
-      ignores(path31) {
-        return this._test(path31, this._ignoreCache, false).ignored;
+      ignores(path33) {
+        return this._test(path33, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path31) => !this.ignores(path31);
+        return (path33) => !this.ignores(path33);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path31) {
-        return this._test(path31, this._testCache, true);
+      test(path33) {
+        return this._test(path33, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore2(options);
-    var isPathValid = (path31) => checkPath(path31 && checkPath.convert(path31), path31, RETURN_FALSE);
+    var isPathValid = (path33) => checkPath(path33 && checkPath.convert(path33), path33, RETURN_FALSE);
     var setupWindows = () => {
       const makePosix = (str) => /^\\\\\?\\/.test(str) || /["<>|\u0000-\u001F]+/u.test(str) ? str : str.replace(/\\/g, "/");
       checkPath.convert = makePosix;
       const REGEX_TEST_WINDOWS_PATH_ABSOLUTE = /^[a-z]:\//i;
-      checkPath.isNotRelative = (path31) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path31) || isNotRelative(path31);
+      checkPath.isNotRelative = (path33) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path33) || isNotRelative(path33);
     };
     if (
       // Detect `process` so that it can run in browsers.
@@ -655,7 +655,7 @@ var require_ignore = __commonJS({
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { realpathSync as realpathSync6, writeFileSync as writeFileSync6 } from "fs";
 import * as os8 from "os";
-import * as path30 from "path";
+import * as path32 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/config/constants.ts
@@ -1165,9 +1165,9 @@ import { mkdirSync, readFileSync, writeFileSync } from "fs";
 import * as path from "path";
 
 // src/eval/report-formatters.ts
-function assertFiniteNumber(value, path31) {
+function assertFiniteNumber(value, path33) {
   if (typeof value !== "number" || Number.isNaN(value) || !Number.isFinite(value)) {
-    throw new Error(`${path31} must be a finite number`);
+    throw new Error(`${path33} must be a finite number`);
   }
   return value;
 }
@@ -1439,7 +1439,7 @@ function pTimeout(promise, options) {
   } = options;
   let timer;
   let abortHandler;
-  const wrappedPromise = new Promise((resolve18, reject) => {
+  const wrappedPromise = new Promise((resolve20, reject) => {
     if (typeof milliseconds !== "number" || Math.sign(milliseconds) !== 1) {
       throw new TypeError(`Expected \`milliseconds\` to be a positive number, got \`${milliseconds}\``);
     }
@@ -1453,7 +1453,7 @@ function pTimeout(promise, options) {
       };
       signal.addEventListener("abort", abortHandler, { once: true });
     }
-    promise.then(resolve18, reject);
+    promise.then(resolve20, reject);
     if (milliseconds === Number.POSITIVE_INFINITY) {
       return;
     }
@@ -1461,7 +1461,7 @@ function pTimeout(promise, options) {
     timer = customTimers.setTimeout.call(void 0, () => {
       if (fallback) {
         try {
-          resolve18(fallback());
+          resolve20(fallback());
         } catch (error) {
           reject(error);
         }
@@ -1471,7 +1471,7 @@ function pTimeout(promise, options) {
         promise.cancel();
       }
       if (message === false) {
-        resolve18();
+        resolve20();
       } else if (message instanceof Error) {
         reject(message);
       } else {
@@ -1873,7 +1873,7 @@ var PQueue = class extends import_index.default {
       // Assign unique ID if not provided
       id: options.id ?? (this.#idAssigner++).toString()
     };
-    return new Promise((resolve18, reject) => {
+    return new Promise((resolve20, reject) => {
       const taskSymbol = /* @__PURE__ */ Symbol(`task-${options.id}`);
       let cleanupQueueAbortHandler = () => void 0;
       const run = async () => {
@@ -1913,7 +1913,7 @@ var PQueue = class extends import_index.default {
             })]);
           }
           const result = await operation;
-          resolve18(result);
+          resolve20(result);
           this.emit("completed", result);
         } catch (error) {
           reject(error);
@@ -2101,13 +2101,13 @@ var PQueue = class extends import_index.default {
     });
   }
   async #onEvent(event, filter) {
-    return new Promise((resolve18) => {
+    return new Promise((resolve20) => {
       const listener = () => {
         if (filter && !filter()) {
           return;
         }
         this.off(event, listener);
-        resolve18();
+        resolve20();
       };
       this.on(event, listener);
     });
@@ -2393,7 +2393,7 @@ async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTi
   const finalDelay = Math.min(delayTime, remainingTime);
   options.signal?.throwIfAborted();
   if (finalDelay > 0) {
-    await new Promise((resolve18, reject) => {
+    await new Promise((resolve20, reject) => {
       const onAbort = () => {
         clearTimeout(timeoutToken);
         options.signal?.removeEventListener("abort", onAbort);
@@ -2401,7 +2401,7 @@ async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTi
       };
       const timeoutToken = setTimeout(() => {
         options.signal?.removeEventListener("abort", onAbort);
-        resolve18();
+        resolve20();
       }, finalDelay);
       if (options.unref) {
         timeoutToken.unref?.();
@@ -3207,85 +3207,6 @@ function createEmbeddingProvider(configuredProviderInfo) {
   }
 }
 
-// src/rerank/index.ts
-function createReranker(config) {
-  if (!config.enabled) {
-    return new NoOpReranker();
-  }
-  return new SiliconFlowReranker(config);
-}
-var NoOpReranker = class {
-  isAvailable() {
-    return false;
-  }
-  async rerank(_query, documents, _topN) {
-    return {
-      results: documents.map((_, index) => ({ index, relevanceScore: 0 }))
-    };
-  }
-};
-var SiliconFlowReranker = class {
-  config;
-  constructor(config) {
-    this.config = config;
-  }
-  isAvailable() {
-    return this.config.enabled && !!this.config.baseUrl && !!this.config.model;
-  }
-  async rerank(query, documents, topN) {
-    if (documents.length === 0) {
-      return { results: [] };
-    }
-    const headers = {
-      "Content-Type": "application/json"
-    };
-    if (this.config.apiKey) {
-      headers["Authorization"] = `Bearer ${this.config.apiKey}`;
-    }
-    const baseUrl = this.config.baseUrl;
-    if (!baseUrl) {
-      throw new Error("Reranker baseUrl is required. Configure reranker.baseUrl in your codebase-index.json.");
-    }
-    const timeoutMs = this.config.timeoutMs ?? 3e4;
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-      const response = await fetch(`${baseUrl}/rerank`, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({
-          model: this.config.model,
-          query,
-          documents,
-          top_n: topN ?? this.config.topN ?? 20,
-          return_documents: false
-        }),
-        signal: controller.signal
-      });
-      clearTimeout(timeout);
-      if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(`Rerank API error: ${response.status} - ${errorText}`);
-      }
-      const data = await response.json();
-      return {
-        results: data.results.map((r) => ({
-          index: r.index,
-          relevanceScore: r.relevance_score,
-          document: r.document?.text
-        })),
-        tokensUsed: data.meta?.tokens?.input_tokens
-      };
-    } catch (error) {
-      clearTimeout(timeout);
-      if (error instanceof Error && error.name === "AbortError") {
-        throw new Error(`Rerank API request timed out after ${timeoutMs}ms`);
-      }
-      throw error;
-    }
-  }
-};
-
 // src/utils/files.ts
 var import_ignore = __toESM(require_ignore(), 1);
 import { existsSync as existsSync2, readFileSync as readFileSync3, promises as fsPromises } from "fs";
@@ -3447,8 +3368,8 @@ async function* walkDirectory(dir, projectRoot, includePatterns, excludePatterns
     if (entry.isDirectory()) {
       subdirs.push({ fullPath, relativePath });
     } else if (entry.isFile()) {
-      const stat4 = await fsPromises.stat(fullPath);
-      if (stat4.size > maxFileSize) {
+      const stat5 = await fsPromises.stat(fullPath);
+      if (stat5.size > maxFileSize) {
         skipped.push({ path: relativePath, reason: "too_large" });
         continue;
       }
@@ -3466,7 +3387,7 @@ async function* walkDirectory(dir, projectRoot, includePatterns, excludePatterns
         }
       }
       if (matched) {
-        filesInDir.push({ path: fullPath, size: stat4.size });
+        filesInDir.push({ path: fullPath, size: stat5.size });
       }
     }
   }
@@ -3523,8 +3444,8 @@ async function collectFiles(projectRoot, includePatterns, excludePatterns, maxFi
     }
     for (const resolvedKbRoot of normalizedRoots) {
       try {
-        const stat4 = await fsPromises.stat(resolvedKbRoot);
-        if (!stat4.isDirectory()) {
+        const stat5 = await fsPromises.stat(resolvedKbRoot);
+        if (!stat5.isDirectory()) {
           skipped.push({ path: resolvedKbRoot, reason: "excluded" });
           continue;
         }
@@ -4850,11 +4771,11 @@ function resolveGitDir(repoRoot) {
     return null;
   }
   try {
-    const stat4 = statSync2(gitPath);
-    if (stat4.isDirectory()) {
+    const stat5 = statSync2(gitPath);
+    if (stat5.isDirectory()) {
       return gitPath;
     }
-    if (stat4.isFile()) {
+    if (stat5.isFile()) {
       const content = readFileSync5(gitPath, "utf-8").trim();
       const match = content.match(/^gitdir:\s*(.+)$/);
       if (match) {
@@ -5359,8 +5280,8 @@ async function isWorktreeRegistered(projectRoot, worktreePath) {
   return false;
 }
 function isPathWithinRoot(filePath, rootPath) {
-  const relative12 = path9.relative(path9.resolve(rootPath), path9.resolve(filePath));
-  return relative12 === "" || !relative12.startsWith(`..${path9.sep}`) && relative12 !== ".." && !path9.isAbsolute(relative12);
+  const relative14 = path9.relative(path9.resolve(rootPath), path9.resolve(filePath));
+  return relative14 === "" || !relative14.startsWith(`..${path9.sep}`) && relative14 !== ".." && !path9.isAbsolute(relative14);
 }
 async function pruneExactMissingWorktreeRegistration(projectRoot, worktreePath) {
   if (await pathExists(worktreePath)) return false;
@@ -5918,11 +5839,11 @@ function normalizeFiles(rawFiles, projectRoot) {
   for (const raw of rawFiles) {
     if (raw.length === 0) continue;
     const absolute = path11.resolve(root, raw);
-    const relative12 = path11.relative(root, absolute);
-    if (path11.isAbsolute(raw) || relative12 === ".." || relative12.startsWith(`..${path11.sep}`) || path11.isAbsolute(relative12)) {
+    const relative14 = path11.relative(root, absolute);
+    if (path11.isAbsolute(raw) || relative14 === ".." || relative14.startsWith(`..${path11.sep}`) || path11.isAbsolute(relative14)) {
       throw new Error(`Changed file escapes the project root: ${JSON.stringify(raw)}`);
     }
-    const cleaned = relative12.startsWith(`.${path11.sep}`) ? relative12.slice(2) : relative12;
+    const cleaned = relative14.startsWith(`.${path11.sep}`) ? relative14.slice(2) : relative14;
     if (!seen.has(cleaned)) {
       seen.add(cleaned);
       result.push(cleaned);
@@ -6259,7 +6180,7 @@ function analyzeQueryIntent(query) {
 }
 function isTestPath(filePath) {
   const normalized = normalizePath(filePath);
-  return /(?:^|\/)(?:test|tests|__tests__|spec|specs)(?:\/|$)/u.test(normalized) || /\.(?:test|spec)\.[^/]+$/u.test(normalized);
+  return /(?:^|\/)(?:test|tests|__tests__|spec|specs)(?:\/|$)/u.test(normalized) || /(?:\.(?:test|spec)|_(?:test|spec))\.[^/]+$/u.test(normalized) || /(?:^|\/)(?:test|spec)_[^/]+\.[^/]+$/u.test(normalized);
 }
 function isFixturePath(filePath) {
   const normalized = normalizePath(filePath);
@@ -6666,7 +6587,8 @@ function rankHybridResults(query, semanticResults, keywordResults, options) {
       return cached;
     }
   }
-  const overfetchLimit = Math.max(options.limit * 4, options.limit);
+  const overfetchFactor = prioritizeSourcePaths ? 12 : 4;
+  const overfetchLimit = Math.max(options.limit * overfetchFactor, options.limit);
   const fused = options.fusionStrategy === "rrf" ? fuseResultsRrf(semanticResults, keywordResults, options.rrfK, overfetchLimit) : fuseResultsWeighted(semanticResults, keywordResults, options.hybridWeight, overfetchLimit);
   const rerankPoolLimit = Math.max(overfetchLimit, options.rerankTopN * 3, options.limit * 6);
   const rerankPool = fused.slice(0, rerankPoolLimit);
@@ -7052,6 +6974,29 @@ function extractPrimaryIdentifierQueryHint(query) {
   const best = codeTerms.find((term) => term.length >= 6);
   return best ?? null;
 }
+function pathSegmentsForAffinityMatch(filePath) {
+  const normalizedPath3 = normalizeRankingText(filePath).replace(/\\/g, "/");
+  const segments = normalizedPath3.split("/").filter((segment) => segment.length > 0);
+  if (segments.length === 0) {
+    return [];
+  }
+  const basename8 = segments[segments.length - 1] ?? "";
+  const basenameWithoutExt = basename8.replace(/\.[^/.]+$/u, "");
+  const normalizedSegments = segments.map((segment) => segment.toLowerCase());
+  return Array.from(/* @__PURE__ */ new Set([
+    ...normalizedSegments,
+    basenameWithoutExt.toLowerCase()
+  ]));
+}
+function hasModuleAffinity(filePath, exactIdentifierVariants) {
+  const haystack = pathSegmentsForAffinityMatch(filePath);
+  return exactIdentifierVariants.some((variant) => {
+    if (!variant || variant.length < 2) {
+      return false;
+    }
+    return haystack.includes(variant);
+  });
+}
 var FILE_PATH_HINT_EXTENSIONS = [
   "ts",
   "tsx",
@@ -7127,10 +7072,13 @@ function buildDeterministicIdentifierPass(query, candidates, limit, prioritizeSo
   ).map((candidate) => {
     const nameLower = (candidate.metadata.name ?? "").toLowerCase();
     const pathLower = candidate.metadata.filePath.toLowerCase();
-    let maxMatch = 0;
-    const nameMatchesPrimary = primaryVariants.some(
+    const exactIdentifierVariants = primaryVariants.filter((value) => value.length >= 2);
+    const exactMatch = exactIdentifierVariants.some(
       (variant) => nameLower === variant || nameLower.replace(/[^a-z0-9]/g, "") === variant.replace(/[^a-z0-9]/g, "")
     );
+    let maxMatch = 0;
+    const nameMatchesPrimary = exactMatch;
+    const pathAffinity = exactMatch ? hasModuleAffinity(candidate.metadata.filePath, exactIdentifierVariants) : false;
     const pathMatchesFileHint = filePathHint ? pathMatchesHint(candidate.metadata.filePath, filePathHint) : false;
     for (const hint of hints) {
       const variants = normalizeIdentifierVariants(hint);
@@ -7151,12 +7099,17 @@ function buildDeterministicIdentifierPass(query, candidates, limit, prioritizeSo
       candidate,
       maxMatch,
       pathMatchesFileHint,
-      nameMatchesPrimary
+      nameMatchesPrimary,
+      pathAffinity
     };
   }).filter((entry) => entry.maxMatch >= 0.7).sort((a, b) => {
     const aAnchored = a.pathMatchesFileHint && a.nameMatchesPrimary ? 1 : 0;
     const bAnchored = b.pathMatchesFileHint && b.nameMatchesPrimary ? 1 : 0;
     if (aAnchored !== bAnchored) return bAnchored - aAnchored;
+    if (a.nameMatchesPrimary !== b.nameMatchesPrimary) {
+      return b.nameMatchesPrimary ? 1 : -1;
+    }
+    if (a.pathAffinity !== b.pathAffinity) return b.pathAffinity ? 1 : -1;
     if (b.maxMatch !== a.maxMatch) return b.maxMatch - a.maxMatch;
     if (b.candidate.score !== a.candidate.score) return b.candidate.score - a.candidate.score;
     return a.candidate.id.localeCompare(b.candidate.id);
@@ -8547,7 +8500,6 @@ var Indexer = class _Indexer {
   database = null;
   provider = null;
   configuredProviderInfo = null;
-  reranker = null;
   fileHashCache = /* @__PURE__ */ new Map();
   fileHashCachePath = "";
   failedBatchesPath = "";
@@ -8707,7 +8659,6 @@ var Indexer = class _Indexer {
     this.database = null;
     this.provider = null;
     this.configuredProviderInfo = null;
-    this.reranker = null;
     this.indexCompatibility = null;
     this.initializationMode = "none";
     this.readIssues = [];
@@ -9437,7 +9388,7 @@ var Indexer = class _Indexer {
       await options.queue.onSizeLessThan(Math.max(1, options.providerRateLimits.concurrency));
       const task = options.queue.add(async () => {
         if (options.rateLimitState.backoffMs > 0) {
-          await new Promise((resolve18) => setTimeout(resolve18, options.rateLimitState.backoffMs));
+          await new Promise((resolve20) => setTimeout(resolve20, options.rateLimitState.backoffMs));
         }
         try {
           const embeddingResult = await pRetry(
@@ -10004,15 +9955,6 @@ var Indexer = class _Indexer {
       rerankerEnabled: this.config.reranker?.enabled ?? false
     });
     this.provider = createEmbeddingProvider(this.configuredProviderInfo);
-    if (this.config.reranker?.enabled) {
-      this.reranker = createReranker(this.config.reranker);
-      if (this.reranker.isAvailable()) {
-        this.logger.info("Reranker initialized", {
-          model: this.config.reranker.model,
-          baseUrl: this.config.reranker.baseUrl
-        });
-      }
-    }
     const dimensions = this.configuredProviderInfo.modelInfo.dimensions;
     const storePath = path15.join(this.indexPath, "vectors");
     const vectorMetadataPath = `${storePath}.meta.json`;
@@ -11417,6 +11359,7 @@ var Indexer = class _Indexer {
     const filterByBranch = options?.filterByBranch ?? true;
     const sourceIntent = options?.definitionIntent === true || classifyQueryIntentRaw(query) === "source";
     const identifierHints = extractIdentifierHints(query);
+    const candidateLimit = maxResults * (sourceIntent ? 12 : 4);
     this.logger.search("debug", "Starting search", {
       query,
       maxResults,
@@ -11453,7 +11396,7 @@ var Indexer = class _Indexer {
     const semanticCandidates = embedding ? this.searchSemanticCandidates(
       store,
       embedding,
-      maxResults * 4,
+      candidateLimit,
       branchChunkIds,
       shouldPrefilterByBranch
     ) : [];
@@ -11461,7 +11404,7 @@ var Indexer = class _Indexer {
     const keywordStartTime = performance2.now();
     const keywordCandidates = await this.keywordSearch(
       query,
-      maxResults * 4,
+      candidateLimit,
       store,
       invertedIndex,
       branchChunkIds,
@@ -12219,9 +12162,9 @@ var Indexer = class _Indexer {
     this.requireReadableComponents(readIssues, "database");
     let shortest = [];
     for (const branchKey of this.getBranchCatalogKeys()) {
-      const path31 = database.findShortestPath(fromName, toName, branchKey, maxDepth);
-      if (path31.length > 0 && (shortest.length === 0 || path31.length < shortest.length)) {
-        shortest = path31;
+      const path33 = database.findShortestPath(fromName, toName, branchKey, maxDepth);
+      if (path33.length > 0 && (shortest.length === 0 || path33.length < shortest.length)) {
+        shortest = path33;
       }
     }
     return shortest.map((hop) => this.resolveFilePathRecord(hop));
@@ -12269,13 +12212,13 @@ var Indexer = class _Indexer {
         }
       }
       if (!found) continue;
-      const path31 = [];
+      const path33 = [];
       let currentSymbolId = toSymbolId;
       while (true) {
         const symbol = symbolsById.get(currentSymbolId);
         if (!symbol) break;
         const parent = parentBySymbolId.get(currentSymbolId);
-        path31.push({
+        path33.push({
           symbolId: symbol.id,
           symbolName: symbol.name,
           filePath: symbol.filePath,
@@ -12285,9 +12228,9 @@ var Indexer = class _Indexer {
         if (!parent) break;
         currentSymbolId = parent.parentId;
       }
-      path31.reverse();
-      if (path31.length > 0 && (shortest.length === 0 || path31.length < shortest.length)) {
-        shortest = path31;
+      path33.reverse();
+      if (path33.length > 0 && (shortest.length === 0 || path33.length < shortest.length)) {
+        shortest = path33;
       }
     }
     return shortest.map((hop) => this.resolveFilePathRecord(hop));
@@ -12623,7 +12566,6 @@ var Indexer = class _Indexer {
     this.store = null;
     this.invertedIndex = null;
     this.provider = null;
-    this.reranker = null;
     this.configuredProviderInfo = null;
     this.indexCompatibility = null;
     this.initializationMode = "none";
@@ -12937,8 +12879,8 @@ function formatExactSearchHandoff(results) {
 }
 function formatContextEvidence(result, index) {
   const symbol = result.name ? ` ${JSON.stringify(compactEvidenceValue(result.name, 80))}` : "";
-  const path31 = compactEvidenceValue(result.filePath, 120);
-  return `[${index}] ${result.chunkType}${symbol} in ${path31}:${result.startLine}-${result.endLine} (score ${result.score.toFixed(2)})`;
+  const path33 = compactEvidenceValue(result.filePath, 120);
+  return `[${index}] ${result.chunkType}${symbol} in ${path33}:${result.startLine}-${result.endLine} (score ${result.score.toFixed(2)})`;
 }
 function formatContextPack(heading, selected, candidateCount, duplicateCount, limitOmittedCount, budgetOmittedCount, includeExactSearchHandoff) {
   const lines = selected.map((result, index) => formatContextEvidence(result, index + 1));
@@ -13592,7 +13534,7 @@ function getErrorMessage4(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function runCommand(file, args, options) {
-  return new Promise((resolve18, reject) => {
+  return new Promise((resolve20, reject) => {
     childProcess.execFile(
       file,
       args,
@@ -13602,7 +13544,7 @@ function runCommand(file, args, options) {
           reject(error);
           return;
         }
-        resolve18(stdout);
+        resolve20(stdout);
       }
     );
   });
@@ -13747,10 +13689,10 @@ function safeFailureMessage(error) {
 }
 function cancellableDelay(delayMs, signal) {
   if (signal.aborted) return Promise.reject(new AutoIndexCancelledError());
-  return new Promise((resolve18, reject) => {
+  return new Promise((resolve20, reject) => {
     const timer = setTimeout(() => {
       signal.removeEventListener("abort", onAbort);
-      resolve18();
+      resolve20();
     }, delayMs);
     timer.unref?.();
     const onAbort = () => {
@@ -13762,15 +13704,15 @@ function cancellableDelay(delayMs, signal) {
 }
 function withTimeout(promise, timeoutMs) {
   if (timeoutMs <= 0) return Promise.resolve(void 0);
-  return new Promise((resolve18) => {
-    const timer = setTimeout(() => resolve18(void 0), timeoutMs);
+  return new Promise((resolve20) => {
+    const timer = setTimeout(() => resolve20(void 0), timeoutMs);
     timer.unref?.();
     void promise.then((value) => {
       clearTimeout(timer);
-      resolve18(value);
+      resolve20(value);
     }, () => {
       clearTimeout(timer);
-      resolve18(void 0);
+      resolve20(void 0);
     });
   });
 }
@@ -14152,17 +14094,17 @@ var AutoIndexCoordinator = class {
     }
   }
   waitForBatteryRetry(delayMs) {
-    return new Promise((resolve18) => {
+    return new Promise((resolve20) => {
       const timer = setTimeout(() => {
         if (this.batteryRetryTimer === timer) {
           this.batteryRetryTimer = null;
           this.resolveBatteryRetry = null;
         }
-        resolve18();
+        resolve20();
       }, delayMs);
       timer.unref?.();
       this.batteryRetryTimer = timer;
-      this.resolveBatteryRetry = resolve18;
+      this.resolveBatteryRetry = resolve20;
     });
   }
   cancelBatteryRetry() {
@@ -14170,9 +14112,9 @@ var AutoIndexCoordinator = class {
       clearTimeout(this.batteryRetryTimer);
       this.batteryRetryTimer = null;
     }
-    const resolve18 = this.resolveBatteryRetry;
+    const resolve20 = this.resolveBatteryRetry;
     this.resolveBatteryRetry = null;
-    resolve18?.();
+    resolve20?.();
   }
   finishBatteryCheck(batteryCheck) {
     if (this.batteryCheck !== batteryCheck) return;
@@ -14847,12 +14789,12 @@ async function getCallGraphPath(projectRoot, host, from, to, maxDepth, fromFileP
   if (fromResolution.status !== "resolved" || toResolution.status !== "resolved") {
     return { from: fromResolution, to: toResolution, path: [] };
   }
-  const path31 = await indexer.findCallPathBySymbolIds(
+  const path33 = await indexer.findCallPathBySymbolIds(
     fromResolution.symbolId,
     toResolution.symbolId,
     maxDepth
   );
-  return { from: fromResolution, to: toResolution, path: path31 };
+  return { from: fromResolution, to: toResolution, path: path33 };
 }
 async function runIndexCodebase(projectRoot, host, args, onProgress) {
   const root = getProjectRoot(projectRoot, host);
@@ -15477,7 +15419,7 @@ async function resolveCodebaseContextUnmeasured(projectRoot, host, input) {
   const directory = input.directory ?? void 0;
   const tokenBudget = input.tokenBudget ?? void 0;
   if (from && to) {
-    const path31 = await getCallGraphPath(
+    const path33 = await getCallGraphPath(
       projectRoot,
       host,
       from,
@@ -15486,25 +15428,25 @@ async function resolveCodebaseContextUnmeasured(projectRoot, host, input) {
       fromFilePath,
       toFilePath
     );
-    const pathText = formatCallGraphPathResult(path31);
-    if (path31.path.length > 0) {
+    const pathText = formatCallGraphPathResult(path33);
+    if (path33.path.length > 0) {
       const fitted2 = fitTextToContextBudget(
         pathText,
         tokenBudget
       );
       return {
         text: fitted2.text,
-        details: fittedDetails("path", fitted2, path31.path.length)
+        details: fittedDetails("path", fitted2, path33.path.length)
       };
     }
-    if (path31.from.status !== "resolved" || path31.to.status !== "resolved") {
+    if (path33.from.status !== "resolved" || path33.to.status !== "resolved") {
       const fitted2 = fitTextToContextBudget(pathText, tokenBudget);
       return {
         text: fitted2.text,
         details: fittedDetails("path", fitted2, 0)
       };
     }
-    const resolvedFrom = path31.from;
+    const resolvedFrom = path33.from;
     const { callers } = await getCallGraphData(projectRoot, host, {
       name: to,
       direction: "callers",
@@ -15981,9 +15923,9 @@ function getRelevantEvidence(query) {
     });
   }
   if (query.expected.acceptableFiles) {
-    for (const path31 of query.expected.acceptableFiles) {
+    for (const path33 of query.expected.acceptableFiles) {
       legacyEvidence.push({
-        path: path31,
+        path: path33,
         ...query.expected.symbol !== void 0 ? { symbol: query.expected.symbol } : {},
         relevance: 1
       });
@@ -16480,68 +16422,68 @@ function isStringArray4(value) {
 function isNonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
-function asPositiveNumber(value, path31) {
+function asPositiveNumber(value, path33) {
   if (typeof value !== "number" || Number.isNaN(value) || value < 0) {
-    throw new Error(`${path31} must be a non-negative number`);
+    throw new Error(`${path33} must be a non-negative number`);
   }
   return value;
 }
-function parseQueryType(value, path31) {
+function parseQueryType(value, path33) {
   if (value === "definition" || value === "implementation-intent" || value === "similarity" || value === "keyword-heavy" || value === "conceptual") {
     return value;
   }
   throw new Error(
-    `${path31} must be one of: definition, implementation-intent, similarity, keyword-heavy, conceptual`
+    `${path33} must be one of: definition, implementation-intent, similarity, keyword-heavy, conceptual`
   );
 }
-function parseExpectedRoute(value, path31) {
+function parseExpectedRoute(value, path33) {
   if (value === void 0) return void 0;
   if (value === "search" || value === "definition") return value;
-  throw new Error(`${path31} must be one of: search, definition`);
+  throw new Error(`${path33} must be one of: search, definition`);
 }
-function parseExpectedOutcome(value, path31) {
+function parseExpectedOutcome(value, path33) {
   if (value === void 0) return void 0;
   if (value === "results" || value === "no-results") {
     return value;
   }
-  throw new Error(`${path31} must be one of: results, no-results`);
+  throw new Error(`${path33} must be one of: results, no-results`);
 }
-function parseRecoveryExpectation(value, path31) {
+function parseRecoveryExpectation(value, path33) {
   if (value === void 0) return void 0;
   if (value === "none" || value === "filter-relaxed") {
     return value;
   }
-  throw new Error(`${path31} must be one of: none, filter-relaxed`);
+  throw new Error(`${path33} must be one of: none, filter-relaxed`);
 }
-function parseQueryDifficulty(value, path31) {
+function parseQueryDifficulty(value, path33) {
   if (value === void 0) return void 0;
   if (value === "easy" || value === "medium" || value === "hard") {
     return value;
   }
-  throw new Error(`${path31} must be one of: easy, medium, hard`);
+  throw new Error(`${path33} must be one of: easy, medium, hard`);
 }
-function parseQueryTags(value, path31) {
+function parseQueryTags(value, path33) {
   if (value === void 0) return void 0;
   if (!isStringArray4(value) || value.some((tag) => tag.trim().length === 0)) {
-    throw new Error(`${path31} must be an array of non-empty strings`);
+    throw new Error(`${path33} must be an array of non-empty strings`);
   }
   if (value.length > 16) {
-    throw new Error(`${path31} must contain at most 16 tags`);
+    throw new Error(`${path33} must contain at most 16 tags`);
   }
   return value;
 }
-function parseQueryArgs(value, path31) {
+function parseQueryArgs(value, path33) {
   if (value === void 0) return void 0;
   if (!isRecord3(value)) {
-    throw new Error(`${path31} must be an object`);
-  }
-  const symbol = parseStringOrUndefined(value.symbol, `${path31}.symbol`);
-  const filePath = parseStringOrUndefined(value.filePath, `${path31}.filePath`);
-  const fileType = parseStringOrUndefined(value.fileType, `${path31}.fileType`);
-  const directory = parseStringOrUndefined(value.directory, `${path31}.directory`);
-  const callerLimit = parsePositiveIntegerOrUndefined(value.callerLimit, `${path31}.callerLimit`);
-  const calleeLimit = parsePositiveIntegerOrUndefined(value.calleeLimit, `${path31}.calleeLimit`);
-  const tokenBudget = parsePositiveIntegerOrUndefined(value.tokenBudget, `${path31}.tokenBudget`);
+    throw new Error(`${path33} must be an object`);
+  }
+  const symbol = parseStringOrUndefined(value.symbol, `${path33}.symbol`);
+  const filePath = parseStringOrUndefined(value.filePath, `${path33}.filePath`);
+  const fileType = parseStringOrUndefined(value.fileType, `${path33}.fileType`);
+  const directory = parseStringOrUndefined(value.directory, `${path33}.directory`);
+  const callerLimit = parsePositiveIntegerOrUndefined(value.callerLimit, `${path33}.callerLimit`);
+  const calleeLimit = parsePositiveIntegerOrUndefined(value.calleeLimit, `${path33}.calleeLimit`);
+  const tokenBudget = parsePositiveIntegerOrUndefined(value.tokenBudget, `${path33}.tokenBudget`);
   return {
     ...symbol !== void 0 ? { symbol } : {},
     ...filePath !== void 0 ? { filePath } : {},
@@ -16552,50 +16494,50 @@ function parseQueryArgs(value, path31) {
     ...tokenBudget !== void 0 ? { tokenBudget } : {}
   };
 }
-function parsePositiveIntegerOrUndefined(value, path31) {
+function parsePositiveIntegerOrUndefined(value, path33) {
   if (value === void 0 || value === null) return void 0;
   if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
-    throw new Error(`${path31} must be a positive integer`);
+    throw new Error(`${path33} must be a positive integer`);
   }
   return value;
 }
 var SEMVER_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-function parseSemanticVersion(value, path31) {
+function parseSemanticVersion(value, path33) {
   if (!isNonEmptyString(value)) {
-    throw new Error(`${path31} must be a non-empty string`);
+    throw new Error(`${path33} must be a non-empty string`);
   }
   if (!SEMVER_VERSION_PATTERN.test(value)) {
-    throw new Error(`${path31} must be a valid semantic version (MAJOR.MINOR.PATCH)`);
+    throw new Error(`${path33} must be a valid semantic version (MAJOR.MINOR.PATCH)`);
   }
   return value;
 }
-function parseRetrievalMode(value, path31) {
+function parseRetrievalMode(value, path33) {
   if (value === void 0 || value === "search") return "search";
   if (value === "context" || value === "edit-context") return value;
-  throw new Error(`${path31} must be one of: search, context, edit-context`);
+  throw new Error(`${path33} must be one of: search, context, edit-context`);
 }
-function parseStringOrUndefined(value, path31) {
+function parseStringOrUndefined(value, path33) {
   if (value === void 0 || value === null) return void 0;
   if (!isNonEmptyString(value)) {
-    throw new Error(`${path31} must be a non-empty string`);
+    throw new Error(`${path33} must be a non-empty string`);
   }
   return value;
 }
-function parseGradedEvidence(value, path31) {
+function parseGradedEvidence(value, path33) {
   if (value === void 0) return [];
   if (!Array.isArray(value)) {
-    throw new Error(`${path31} must be an array`);
+    throw new Error(`${path33} must be an array`);
   }
   return value.map((entry, index) => {
     if (!isRecord3(entry)) {
-      throw new Error(`${path31}[${index}] must be an object`);
+      throw new Error(`${path33}[${index}] must be an object`);
     }
-    const evidencePath = parseStringOrUndefined(entry.path, `${path31}[${index}].path`);
+    const evidencePath = parseStringOrUndefined(entry.path, `${path33}[${index}].path`);
     if (evidencePath === void 0) {
-      throw new Error(`${path31}[${index}].path is required`);
+      throw new Error(`${path33}[${index}].path is required`);
     }
-    const symbol = parseStringOrUndefined(entry.symbol, `${path31}[${index}].symbol`);
-    const relevance = parseEvidenceRelevance(entry.relevance, `${path31}[${index}].relevance`);
+    const symbol = parseStringOrUndefined(entry.symbol, `${path33}[${index}].symbol`);
+    const relevance = parseEvidenceRelevance(entry.relevance, `${path33}[${index}].relevance`);
     return {
       path: evidencePath,
       ...symbol !== void 0 ? { symbol } : {},
@@ -16603,27 +16545,27 @@ function parseGradedEvidence(value, path31) {
     };
   });
 }
-function parseEvidenceRelevance(value, path31) {
+function parseEvidenceRelevance(value, path33) {
   if (value === void 0) {
-    throw new Error(`${path31} is required`);
+    throw new Error(`${path33} is required`);
   }
   if (value !== 1 && value !== 2 && value !== 3) {
-    throw new Error(`${path31} must be 1, 2, or 3`);
+    throw new Error(`${path33} must be 1, 2, or 3`);
   }
   return value;
 }
-function parseExpectedGraphNeighbor(value, path31) {
+function parseExpectedGraphNeighbor(value, path33) {
   if (value === void 0) return void 0;
   if (!isRecord3(value)) {
-    throw new Error(`${path31} must be an object`);
+    throw new Error(`${path33} must be an object`);
   }
   if (value.direction !== "caller" && value.direction !== "callee") {
-    throw new Error(`${path31}.direction must be one of: caller, callee`);
+    throw new Error(`${path33}.direction must be one of: caller, callee`);
   }
-  const filePath = parseStringOrUndefined(value.filePath, `${path31}.filePath`);
-  const symbol = parseStringOrUndefined(value.symbol, `${path31}.symbol`);
+  const filePath = parseStringOrUndefined(value.filePath, `${path33}.filePath`);
+  const symbol = parseStringOrUndefined(value.symbol, `${path33}.symbol`);
   if (filePath === void 0 && symbol === void 0) {
-    throw new Error(`${path31} must include filePath or symbol`);
+    throw new Error(`${path33} must include filePath or symbol`);
   }
   return {
     direction: value.direction,
@@ -16631,9 +16573,9 @@ function parseExpectedGraphNeighbor(value, path31) {
     ...symbol !== void 0 ? { symbol } : {}
   };
 }
-function parseExpected(input, path31) {
+function parseExpected(input, path33) {
   if (!isRecord3(input)) {
-    throw new Error(`${path31} must be an object`);
+    throw new Error(`${path33} must be an object`);
   }
   const filePathRaw = input.filePath;
   const acceptableFilesRaw = input.acceptableFiles;
@@ -16644,29 +16586,29 @@ function parseExpected(input, path31) {
   const recoveryExpectationRaw = input.recoveryExpectation;
   const gradedEvidenceRaw = input.gradedEvidence;
   const graphNeighborRaw = input.graphNeighbor;
-  const filePath = parseStringOrUndefined(filePathRaw, `${path31}.filePath`);
+  const filePath = parseStringOrUndefined(filePathRaw, `${path33}.filePath`);
   const acceptableFiles = isStringArray4(acceptableFilesRaw) ? acceptableFilesRaw : void 0;
-  const gradedEvidence = parseGradedEvidence(gradedEvidenceRaw, `${path31}.gradedEvidence`);
-  const graphNeighbor = parseExpectedGraphNeighbor(graphNeighborRaw, `${path31}.graphNeighbor`);
-  const expectedOutcome = parseExpectedOutcome(expectedOutcomeRaw, `${path31}.expectedOutcome`);
+  const gradedEvidence = parseGradedEvidence(gradedEvidenceRaw, `${path33}.gradedEvidence`);
+  const graphNeighbor = parseExpectedGraphNeighbor(graphNeighborRaw, `${path33}.graphNeighbor`);
+  const expectedOutcome = parseExpectedOutcome(expectedOutcomeRaw, `${path33}.expectedOutcome`);
   if (expectedOutcome !== "no-results" && !filePath && (!acceptableFiles || acceptableFiles.length === 0) && gradedEvidence.length === 0) {
     throw new Error(
-      `${path31} must include expected.filePath, expected.acceptableFiles, or expected.gradedEvidence`
+      `${path33} must include expected.filePath, expected.acceptableFiles, or expected.gradedEvidence`
     );
   }
   if (acceptableFilesRaw !== void 0 && !isStringArray4(acceptableFilesRaw)) {
-    throw new Error(`${path31}.acceptableFiles must be an array of strings`);
+    throw new Error(`${path33}.acceptableFiles must be an array of strings`);
   }
   if (symbolRaw !== void 0 && typeof symbolRaw !== "string") {
-    throw new Error(`${path31}.symbol must be a string when provided`);
+    throw new Error(`${path33}.symbol must be a string when provided`);
   }
   if (branchRaw !== void 0 && typeof branchRaw !== "string") {
-    throw new Error(`${path31}.branch must be a string when provided`);
+    throw new Error(`${path33}.branch must be a string when provided`);
   }
-  const expectedRoute = parseExpectedRoute(expectedRouteRaw, `${path31}.expectedRoute`);
+  const expectedRoute = parseExpectedRoute(expectedRouteRaw, `${path33}.expectedRoute`);
   const recoveryExpectation = parseRecoveryExpectation(
     recoveryExpectationRaw,
-    `${path31}.recoveryExpectation`
+    `${path33}.recoveryExpectation`
   );
   return {
     filePath,
@@ -16680,13 +16622,13 @@ function parseExpected(input, path31) {
     ...graphNeighbor !== void 0 ? { graphNeighbor } : {}
   };
 }
-function parseQueryLanguage(value, path31) {
-  return parseStringOrUndefined(value, path31);
+function parseQueryLanguage(value, path33) {
+  return parseStringOrUndefined(value, path33);
 }
 function parseQuery(input, index) {
-  const path31 = `queries[${index}]`;
+  const path33 = `queries[${index}]`;
   if (!isRecord3(input)) {
-    throw new Error(`${path31} must be an object`);
+    throw new Error(`${path33} must be an object`);
   }
   const id = input.id;
   const query = input.query;
@@ -16698,21 +16640,21 @@ function parseQuery(input, index) {
   const tags = input.tags;
   const args = input.args;
   if (typeof id !== "string" || id.trim().length === 0) {
-    throw new Error(`${path31}.id must be a non-empty string`);
+    throw new Error(`${path33}.id must be a non-empty string`);
   }
   if (typeof query !== "string" || query.trim().length === 0) {
-    throw new Error(`${path31}.query must be a non-empty string`);
+    throw new Error(`${path33}.query must be a non-empty string`);
   }
   return {
     id,
     query,
-    queryType: parseQueryType(queryType, `${path31}.queryType`),
-    retrievalMode: parseRetrievalMode(retrievalMode, `${path31}.retrievalMode`),
-    language: parseQueryLanguage(language, `${path31}.language`),
-    difficulty: parseQueryDifficulty(difficulty, `${path31}.difficulty`),
-    args: parseQueryArgs(args, `${path31}.args`),
-    tags: parseQueryTags(tags, `${path31}.tags`),
-    expected: parseExpected(expected, `${path31}.expected`)
+    queryType: parseQueryType(queryType, `${path33}.queryType`),
+    retrievalMode: parseRetrievalMode(retrievalMode, `${path33}.retrievalMode`),
+    language: parseQueryLanguage(language, `${path33}.language`),
+    difficulty: parseQueryDifficulty(difficulty, `${path33}.difficulty`),
+    args: parseQueryArgs(args, `${path33}.args`),
+    tags: parseQueryTags(tags, `${path33}.tags`),
+    expected: parseExpected(expected, `${path33}.expected`)
   };
 }
 function parseGoldenDataset(raw, sourceLabel) {
@@ -17678,7 +17620,7 @@ async function executeCallGraph(projectRoot, host, args) {
   return { text: formatCallGraphResult(await getCallGraphData(projectRoot, host, args)) };
 }
 async function executeCallGraphPath(projectRoot, host, args) {
-  const path31 = await getCallGraphPath(
+  const path33 = await getCallGraphPath(
     projectRoot,
     host,
     args.from,
@@ -17687,7 +17629,7 @@ async function executeCallGraphPath(projectRoot, host, args) {
     args.fromFilePath,
     args.toFilePath
   );
-  return { text: formatCallGraphPathResult(path31) };
+  return { text: formatCallGraphPathResult(path33) };
 }
 async function executeCodeCommunities(projectRoot, host, args) {
   const result = await getCodeCommunities(projectRoot, host, args);
@@ -18174,7 +18116,7 @@ function createMcpServer(projectRoot, config, host) {
 }
 
 // src/watcher/file-watcher.ts
-import { existsSync as existsSync15 } from "fs";
+import { existsSync as existsSync15, statSync as statSync6 } from "fs";
 
 // node_modules/chokidar/index.js
 import { EventEmitter as EventEmitter2 } from "events";
@@ -18266,7 +18208,7 @@ var ReaddirpStream = class extends Readable {
     this._directoryFilter = normalizeFilter(opts.directoryFilter);
     const statMethod = opts.lstat ? lstat : stat;
     if (wantBigintFsStats) {
-      this._stat = (path31) => statMethod(path31, { bigint: true });
+      this._stat = (path33) => statMethod(path33, { bigint: true });
     } else {
       this._stat = statMethod;
     }
@@ -18291,8 +18233,8 @@ var ReaddirpStream = class extends Readable {
         const par = this.parent;
         const fil = par && par.files;
         if (fil && fil.length > 0) {
-          const { path: path31, depth } = par;
-          const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path31));
+          const { path: path33, depth } = par;
+          const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path33));
           const awaited = await Promise.all(slice);
           for (const entry of awaited) {
             if (!entry)
@@ -18332,20 +18274,20 @@ var ReaddirpStream = class extends Readable {
       this.reading = false;
     }
   }
-  async _exploreDir(path31, depth) {
+  async _exploreDir(path33, depth) {
     let files;
     try {
-      files = await readdir(path31, this._rdOptions);
+      files = await readdir(path33, this._rdOptions);
     } catch (error) {
       this._onError(error);
     }
-    return { files, depth, path: path31 };
+    return { files, depth, path: path33 };
   }
-  async _formatEntry(dirent, path31) {
+  async _formatEntry(dirent, path33) {
     let entry;
     const basename8 = this._isDirent ? dirent.name : dirent;
     try {
-      const fullPath = presolve(pjoin(path31, basename8));
+      const fullPath = presolve(pjoin(path33, basename8));
       entry = { path: prelative(this._root, fullPath), fullPath, basename: basename8 };
       entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
     } catch (err) {
@@ -18745,16 +18687,16 @@ var delFromSet = (main, prop, item) => {
 };
 var isEmptySet = (val) => val instanceof Set ? val.size === 0 : !val;
 var FsWatchInstances = /* @__PURE__ */ new Map();
-function createFsWatchInstance(path31, options, listener, errHandler, emitRaw) {
+function createFsWatchInstance(path33, options, listener, errHandler, emitRaw) {
   const handleEvent = (rawEvent, evPath) => {
-    listener(path31);
-    emitRaw(rawEvent, evPath, { watchedPath: path31 });
-    if (evPath && path31 !== evPath) {
-      fsWatchBroadcast(sp.resolve(path31, evPath), KEY_LISTENERS, sp.join(path31, evPath));
+    listener(path33);
+    emitRaw(rawEvent, evPath, { watchedPath: path33 });
+    if (evPath && path33 !== evPath) {
+      fsWatchBroadcast(sp.resolve(path33, evPath), KEY_LISTENERS, sp.join(path33, evPath));
     }
   };
   try {
-    return fs_watch(path31, {
+    return fs_watch(path33, {
       persistent: options.persistent
     }, handleEvent);
   } catch (error) {
@@ -18770,12 +18712,12 @@ var fsWatchBroadcast = (fullPath, listenerType, val1, val2, val3) => {
     listener(val1, val2, val3);
   });
 };
-var setFsWatchListener = (path31, fullPath, options, handlers) => {
+var setFsWatchListener = (path33, fullPath, options, handlers) => {
   const { listener, errHandler, rawEmitter } = handlers;
   let cont = FsWatchInstances.get(fullPath);
   let watcher;
   if (!options.persistent) {
-    watcher = createFsWatchInstance(path31, options, listener, errHandler, rawEmitter);
+    watcher = createFsWatchInstance(path33, options, listener, errHandler, rawEmitter);
     if (!watcher)
       return;
     return watcher.close.bind(watcher);
@@ -18786,7 +18728,7 @@ var setFsWatchListener = (path31, fullPath, options, handlers) => {
     addAndConvert(cont, KEY_RAW, rawEmitter);
   } else {
     watcher = createFsWatchInstance(
-      path31,
+      path33,
       options,
       fsWatchBroadcast.bind(null, fullPath, KEY_LISTENERS),
       errHandler,
@@ -18801,7 +18743,7 @@ var setFsWatchListener = (path31, fullPath, options, handlers) => {
         cont.watcherUnusable = true;
       if (isWindows && error.code === "EPERM") {
         try {
-          const fd = await open(path31, "r");
+          const fd = await open(path33, "r");
           await fd.close();
           broadcastErr(error);
         } catch (err) {
@@ -18832,7 +18774,7 @@ var setFsWatchListener = (path31, fullPath, options, handlers) => {
   };
 };
 var FsWatchFileInstances = /* @__PURE__ */ new Map();
-var setFsWatchFileListener = (path31, fullPath, options, handlers) => {
+var setFsWatchFileListener = (path33, fullPath, options, handlers) => {
   const { listener, rawEmitter } = handlers;
   let cont = FsWatchFileInstances.get(fullPath);
   const copts = cont && cont.options;
@@ -18854,7 +18796,7 @@ var setFsWatchFileListener = (path31, fullPath, options, handlers) => {
         });
         const currmtime = curr.mtimeMs;
         if (curr.size !== prev.size || currmtime > prev.mtimeMs || currmtime === 0) {
-          foreach(cont.listeners, (listener2) => listener2(path31, curr));
+          foreach(cont.listeners, (listener2) => listener2(path33, curr));
         }
       })
     };
@@ -18884,13 +18826,13 @@ var NodeFsHandler = class {
    * @param listener on fs change
    * @returns closer for the watcher instance
    */
-  _watchWithNodeFs(path31, listener) {
+  _watchWithNodeFs(path33, listener) {
     const opts = this.fsw.options;
-    const directory = sp.dirname(path31);
-    const basename8 = sp.basename(path31);
+    const directory = sp.dirname(path33);
+    const basename8 = sp.basename(path33);
     const parent = this.fsw._getWatchedDir(directory);
     parent.add(basename8);
-    const absolutePath = sp.resolve(path31);
+    const absolutePath = sp.resolve(path33);
     const options = {
       persistent: opts.persistent
     };
@@ -18900,12 +18842,12 @@ var NodeFsHandler = class {
     if (opts.usePolling) {
       const enableBin = opts.interval !== opts.binaryInterval;
       options.interval = enableBin && isBinaryPath(basename8) ? opts.binaryInterval : opts.interval;
-      closer = setFsWatchFileListener(path31, absolutePath, options, {
+      closer = setFsWatchFileListener(path33, absolutePath, options, {
         listener,
         rawEmitter: this.fsw._emitRaw
       });
     } else {
-      closer = setFsWatchListener(path31, absolutePath, options, {
+      closer = setFsWatchListener(path33, absolutePath, options, {
         listener,
         errHandler: this._boundHandleError,
         rawEmitter: this.fsw._emitRaw
@@ -18927,7 +18869,7 @@ var NodeFsHandler = class {
     let prevStats = stats;
     if (parent.has(basename8))
       return;
-    const listener = async (path31, newStats) => {
+    const listener = async (path33, newStats) => {
       if (!this.fsw._throttle(THROTTLE_MODE_WATCH, file, 5))
         return;
       if (!newStats || newStats.mtimeMs === 0) {
@@ -18941,11 +18883,11 @@ var NodeFsHandler = class {
             this.fsw._emit(EV.CHANGE, file, newStats2);
           }
           if ((isMacos || isLinux || isFreeBSD) && prevStats.ino !== newStats2.ino) {
-            this.fsw._closeFile(path31);
+            this.fsw._closeFile(path33);
             prevStats = newStats2;
             const closer2 = this._watchWithNodeFs(file, listener);
             if (closer2)
-              this.fsw._addPathCloser(path31, closer2);
+              this.fsw._addPathCloser(path33, closer2);
           } else {
             prevStats = newStats2;
           }
@@ -18977,7 +18919,7 @@ var NodeFsHandler = class {
    * @param item basename of this item
    * @returns true if no more processing is needed for this entry.
    */
-  async _handleSymlink(entry, directory, path31, item) {
+  async _handleSymlink(entry, directory, path33, item) {
     if (this.fsw.closed) {
       return;
     }
@@ -18987,7 +18929,7 @@ var NodeFsHandler = class {
       this.fsw._incrReadyCount();
       let linkPath;
       try {
-        linkPath = await fsrealpath(path31);
+        linkPath = await fsrealpath(path33);
       } catch (e) {
         this.fsw._emitReady();
         return true;
@@ -18997,12 +18939,12 @@ var NodeFsHandler = class {
       if (dir.has(item)) {
         if (this.fsw._symlinkPaths.get(full) !== linkPath) {
           this.fsw._symlinkPaths.set(full, linkPath);
-          this.fsw._emit(EV.CHANGE, path31, entry.stats);
+          this.fsw._emit(EV.CHANGE, path33, entry.stats);
         }
       } else {
         dir.add(item);
         this.fsw._symlinkPaths.set(full, linkPath);
-        this.fsw._emit(EV.ADD, path31, entry.stats);
+        this.fsw._emit(EV.ADD, path33, entry.stats);
       }
       this.fsw._emitReady();
       return true;
@@ -19032,9 +18974,9 @@ var NodeFsHandler = class {
         return;
       }
       const item = entry.path;
-      let path31 = sp.join(directory, item);
+      let path33 = sp.join(directory, item);
       current.add(item);
-      if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path31, item)) {
+      if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path33, item)) {
         return;
       }
       if (this.fsw.closed) {
@@ -19043,11 +18985,11 @@ var NodeFsHandler = class {
       }
       if (item === target || !target && !previous.has(item)) {
         this.fsw._incrReadyCount();
-        path31 = sp.join(dir, sp.relative(dir, path31));
-        this._addToNodeFs(path31, initialAdd, wh, depth + 1);
+        path33 = sp.join(dir, sp.relative(dir, path33));
+        this._addToNodeFs(path33, initialAdd, wh, depth + 1);
       }
     }).on(EV.ERROR, this._boundHandleError);
-    return new Promise((resolve18, reject) => {
+    return new Promise((resolve20, reject) => {
       if (!stream)
         return reject();
       stream.once(STR_END, () => {
@@ -19056,7 +18998,7 @@ var NodeFsHandler = class {
           return;
         }
         const wasThrottled = throttler ? throttler.clear() : false;
-        resolve18(void 0);
+        resolve20(void 0);
         previous.getChildren().filter((item) => {
           return item !== directory && !current.has(item);
         }).forEach((item) => {
@@ -19113,13 +19055,13 @@ var NodeFsHandler = class {
    * @param depth Child path actually targeted for watch
    * @param target Child path actually targeted for watch
    */
-  async _addToNodeFs(path31, initialAdd, priorWh, depth, target) {
+  async _addToNodeFs(path33, initialAdd, priorWh, depth, target) {
     const ready = this.fsw._emitReady;
-    if (this.fsw._isIgnored(path31) || this.fsw.closed) {
+    if (this.fsw._isIgnored(path33) || this.fsw.closed) {
       ready();
       return false;
     }
-    const wh = this.fsw._getWatchHelpers(path31);
+    const wh = this.fsw._getWatchHelpers(path33);
     if (priorWh) {
       wh.filterPath = (entry) => priorWh.filterPath(entry);
       wh.filterDir = (entry) => priorWh.filterDir(entry);
@@ -19135,8 +19077,8 @@ var NodeFsHandler = class {
       const follow = this.fsw.options.followSymlinks;
       let closer;
       if (stats.isDirectory()) {
-        const absPath = sp.resolve(path31);
-        const targetPath = follow ? await fsrealpath(path31) : path31;
+        const absPath = sp.resolve(path33);
+        const targetPath = follow ? await fsrealpath(path33) : path33;
         if (this.fsw.closed)
           return;
         closer = await this._handleDir(wh.watchPath, stats, initialAdd, depth, target, wh, targetPath);
@@ -19146,29 +19088,29 @@ var NodeFsHandler = class {
           this.fsw._symlinkPaths.set(absPath, targetPath);
         }
       } else if (stats.isSymbolicLink()) {
-        const targetPath = follow ? await fsrealpath(path31) : path31;
+        const targetPath = follow ? await fsrealpath(path33) : path33;
         if (this.fsw.closed)
           return;
         const parent = sp.dirname(wh.watchPath);
         this.fsw._getWatchedDir(parent).add(wh.watchPath);
         this.fsw._emit(EV.ADD, wh.watchPath, stats);
-        closer = await this._handleDir(parent, stats, initialAdd, depth, path31, wh, targetPath);
+        closer = await this._handleDir(parent, stats, initialAdd, depth, path33, wh, targetPath);
         if (this.fsw.closed)
           return;
         if (targetPath !== void 0) {
-          this.fsw._symlinkPaths.set(sp.resolve(path31), targetPath);
+          this.fsw._symlinkPaths.set(sp.resolve(path33), targetPath);
         }
       } else {
         closer = this._handleFile(wh.watchPath, stats, initialAdd);
       }
       ready();
       if (closer)
-        this.fsw._addPathCloser(path31, closer);
+        this.fsw._addPathCloser(path33, closer);
       return false;
     } catch (error) {
       if (this.fsw._handleError(error)) {
         ready();
-        return path31;
+        return path33;
       }
     }
   }
@@ -19200,35 +19142,35 @@ function createPattern(matcher) {
       if (matcher.path === string)
         return true;
       if (matcher.recursive) {
-        const relative12 = sp2.relative(matcher.path, string);
-        if (!relative12) {
+        const relative14 = sp2.relative(matcher.path, string);
+        if (!relative14) {
           return false;
         }
-        return !relative12.startsWith("..") && !sp2.isAbsolute(relative12);
+        return !relative14.startsWith("..") && !sp2.isAbsolute(relative14);
       }
       return false;
     };
   }
   return () => false;
 }
-function normalizePath3(path31) {
-  if (typeof path31 !== "string")
+function normalizePath3(path33) {
+  if (typeof path33 !== "string")
     throw new Error("string expected");
-  path31 = sp2.normalize(path31);
-  path31 = path31.replace(/\\/g, "/");
+  path33 = sp2.normalize(path33);
+  path33 = path33.replace(/\\/g, "/");
   let prepend = false;
-  if (path31.startsWith("//"))
+  if (path33.startsWith("//"))
     prepend = true;
-  path31 = path31.replace(DOUBLE_SLASH_RE, "/");
+  path33 = path33.replace(DOUBLE_SLASH_RE, "/");
   if (prepend)
-    path31 = "/" + path31;
-  return path31;
+    path33 = "/" + path33;
+  return path33;
 }
 function matchPatterns(patterns, testString, stats) {
-  const path31 = normalizePath3(testString);
+  const path33 = normalizePath3(testString);
   for (let index = 0; index < patterns.length; index++) {
     const pattern = patterns[index];
-    if (pattern(path31, stats)) {
+    if (pattern(path33, stats)) {
       return true;
     }
   }
@@ -19266,19 +19208,19 @@ var toUnix = (string) => {
   }
   return str;
 };
-var normalizePathToUnix = (path31) => toUnix(sp2.normalize(toUnix(path31)));
-var normalizeIgnored = (cwd = "") => (path31) => {
-  if (typeof path31 === "string") {
-    return normalizePathToUnix(sp2.isAbsolute(path31) ? path31 : sp2.join(cwd, path31));
+var normalizePathToUnix = (path33) => toUnix(sp2.normalize(toUnix(path33)));
+var normalizeIgnored = (cwd = "") => (path33) => {
+  if (typeof path33 === "string") {
+    return normalizePathToUnix(sp2.isAbsolute(path33) ? path33 : sp2.join(cwd, path33));
   } else {
-    return path31;
+    return path33;
   }
 };
-var getAbsolutePath = (path31, cwd) => {
-  if (sp2.isAbsolute(path31)) {
-    return path31;
+var getAbsolutePath = (path33, cwd) => {
+  if (sp2.isAbsolute(path33)) {
+    return path33;
   }
-  return sp2.join(cwd, path31);
+  return sp2.join(cwd, path33);
 };
 var EMPTY_SET = Object.freeze(/* @__PURE__ */ new Set());
 var DirEntry = class {
@@ -19343,10 +19285,10 @@ var WatchHelper = class {
   dirParts;
   followSymlinks;
   statMethod;
-  constructor(path31, follow, fsw) {
+  constructor(path33, follow, fsw) {
     this.fsw = fsw;
-    const watchPath = path31;
-    this.path = path31 = path31.replace(REPLACER_RE, "");
+    const watchPath = path33;
+    this.path = path33 = path33.replace(REPLACER_RE, "");
     this.watchPath = watchPath;
     this.fullWatchPath = sp2.resolve(watchPath);
     this.dirParts = [];
@@ -19486,20 +19428,20 @@ var FSWatcher = class extends EventEmitter2 {
     this._closePromise = void 0;
     let paths = unifyPaths(paths_);
     if (cwd) {
-      paths = paths.map((path31) => {
-        const absPath = getAbsolutePath(path31, cwd);
+      paths = paths.map((path33) => {
+        const absPath = getAbsolutePath(path33, cwd);
         return absPath;
       });
     }
-    paths.forEach((path31) => {
-      this._removeIgnoredPath(path31);
+    paths.forEach((path33) => {
+      this._removeIgnoredPath(path33);
     });
     this._userIgnored = void 0;
     if (!this._readyCount)
       this._readyCount = 0;
     this._readyCount += paths.length;
-    Promise.all(paths.map(async (path31) => {
-      const res = await this._nodeFsHandler._addToNodeFs(path31, !_internal, void 0, 0, _origAdd);
+    Promise.all(paths.map(async (path33) => {
+      const res = await this._nodeFsHandler._addToNodeFs(path33, !_internal, void 0, 0, _origAdd);
       if (res)
         this._emitReady();
       return res;
@@ -19521,17 +19463,17 @@ var FSWatcher = class extends EventEmitter2 {
       return this;
     const paths = unifyPaths(paths_);
     const { cwd } = this.options;
-    paths.forEach((path31) => {
-      if (!sp2.isAbsolute(path31) && !this._closers.has(path31)) {
+    paths.forEach((path33) => {
+      if (!sp2.isAbsolute(path33) && !this._closers.has(path33)) {
         if (cwd)
-          path31 = sp2.join(cwd, path31);
-        path31 = sp2.resolve(path31);
+          path33 = sp2.join(cwd, path33);
+        path33 = sp2.resolve(path33);
       }
-      this._closePath(path31);
-      this._addIgnoredPath(path31);
-      if (this._watched.has(path31)) {
+      this._closePath(path33);
+      this._addIgnoredPath(path33);
+      if (this._watched.has(path33)) {
         this._addIgnoredPath({
-          path: path31,
+          path: path33,
           recursive: true
         });
       }
@@ -19595,38 +19537,38 @@ var FSWatcher = class extends EventEmitter2 {
    * @param stats arguments to be passed with event
    * @returns the error if defined, otherwise the value of the FSWatcher instance's `closed` flag
    */
-  async _emit(event, path31, stats) {
+  async _emit(event, path33, stats) {
     if (this.closed)
       return;
     const opts = this.options;
     if (isWindows)
-      path31 = sp2.normalize(path31);
+      path33 = sp2.normalize(path33);
     if (opts.cwd)
-      path31 = sp2.relative(opts.cwd, path31);
-    const args = [path31];
+      path33 = sp2.relative(opts.cwd, path33);
+    const args = [path33];
     if (stats != null)
       args.push(stats);
     const awf = opts.awaitWriteFinish;
     let pw;
-    if (awf && (pw = this._pendingWrites.get(path31))) {
+    if (awf && (pw = this._pendingWrites.get(path33))) {
       pw.lastChange = /* @__PURE__ */ new Date();
       return this;
     }
     if (opts.atomic) {
       if (event === EVENTS.UNLINK) {
-        this._pendingUnlinks.set(path31, [event, ...args]);
+        this._pendingUnlinks.set(path33, [event, ...args]);
         setTimeout(() => {
-          this._pendingUnlinks.forEach((entry, path32) => {
+          this._pendingUnlinks.forEach((entry, path34) => {
             this.emit(...entry);
             this.emit(EVENTS.ALL, ...entry);
-            this._pendingUnlinks.delete(path32);
+            this._pendingUnlinks.delete(path34);
           });
         }, typeof opts.atomic === "number" ? opts.atomic : 100);
         return this;
       }
-      if (event === EVENTS.ADD && this._pendingUnlinks.has(path31)) {
+      if (event === EVENTS.ADD && this._pendingUnlinks.has(path33)) {
         event = EVENTS.CHANGE;
-        this._pendingUnlinks.delete(path31);
+        this._pendingUnlinks.delete(path33);
       }
     }
     if (awf && (event === EVENTS.ADD || event === EVENTS.CHANGE) && this._readyEmitted) {
@@ -19644,16 +19586,16 @@ var FSWatcher = class extends EventEmitter2 {
           this.emitWithAll(event, args);
         }
       };
-      this._awaitWriteFinish(path31, awf.stabilityThreshold, event, awfEmit);
+      this._awaitWriteFinish(path33, awf.stabilityThreshold, event, awfEmit);
       return this;
     }
     if (event === EVENTS.CHANGE) {
-      const isThrottled = !this._throttle(EVENTS.CHANGE, path31, 50);
+      const isThrottled = !this._throttle(EVENTS.CHANGE, path33, 50);
       if (isThrottled)
         return this;
     }
     if (opts.alwaysStat && stats === void 0 && (event === EVENTS.ADD || event === EVENTS.ADD_DIR || event === EVENTS.CHANGE)) {
-      const fullPath = opts.cwd ? sp2.join(opts.cwd, path31) : path31;
+      const fullPath = opts.cwd ? sp2.join(opts.cwd, path33) : path33;
       let stats2;
       try {
         stats2 = await stat3(fullPath);
@@ -19684,23 +19626,23 @@ var FSWatcher = class extends EventEmitter2 {
    * @param timeout duration of time to suppress duplicate actions
    * @returns tracking object or false if action should be suppressed
    */
-  _throttle(actionType, path31, timeout) {
+  _throttle(actionType, path33, timeout) {
     if (!this._throttled.has(actionType)) {
       this._throttled.set(actionType, /* @__PURE__ */ new Map());
     }
     const action = this._throttled.get(actionType);
     if (!action)
       throw new Error("invalid throttle");
-    const actionPath = action.get(path31);
+    const actionPath = action.get(path33);
     if (actionPath) {
       actionPath.count++;
       return false;
     }
     let timeoutObject;
     const clear = () => {
-      const item = action.get(path31);
+      const item = action.get(path33);
       const count = item ? item.count : 0;
-      action.delete(path31);
+      action.delete(path33);
       clearTimeout(timeoutObject);
       if (item)
         clearTimeout(item.timeoutObject);
@@ -19708,7 +19650,7 @@ var FSWatcher = class extends EventEmitter2 {
     };
     timeoutObject = setTimeout(clear, timeout);
     const thr = { timeoutObject, clear, count: 0 };
-    action.set(path31, thr);
+    action.set(path33, thr);
     return thr;
   }
   _incrReadyCount() {
@@ -19722,44 +19664,44 @@ var FSWatcher = class extends EventEmitter2 {
    * @param event
    * @param awfEmit Callback to be called when ready for event to be emitted.
    */
-  _awaitWriteFinish(path31, threshold, event, awfEmit) {
+  _awaitWriteFinish(path33, threshold, event, awfEmit) {
     const awf = this.options.awaitWriteFinish;
     if (typeof awf !== "object")
       return;
     const pollInterval = awf.pollInterval;
     let timeoutHandler;
-    let fullPath = path31;
-    if (this.options.cwd && !sp2.isAbsolute(path31)) {
-      fullPath = sp2.join(this.options.cwd, path31);
+    let fullPath = path33;
+    if (this.options.cwd && !sp2.isAbsolute(path33)) {
+      fullPath = sp2.join(this.options.cwd, path33);
     }
     const now2 = /* @__PURE__ */ new Date();
     const writes = this._pendingWrites;
     function awaitWriteFinishFn(prevStat) {
       statcb(fullPath, (err, curStat) => {
-        if (err || !writes.has(path31)) {
+        if (err || !writes.has(path33)) {
           if (err && err.code !== "ENOENT")
             awfEmit(err);
           return;
         }
         const now3 = Number(/* @__PURE__ */ new Date());
         if (prevStat && curStat.size !== prevStat.size) {
-          writes.get(path31).lastChange = now3;
+          writes.get(path33).lastChange = now3;
         }
-        const pw = writes.get(path31);
+        const pw = writes.get(path33);
         const df = now3 - pw.lastChange;
         if (df >= threshold) {
-          writes.delete(path31);
+          writes.delete(path33);
           awfEmit(void 0, curStat);
         } else {
           timeoutHandler = setTimeout(awaitWriteFinishFn, pollInterval, curStat);
         }
       });
     }
-    if (!writes.has(path31)) {
-      writes.set(path31, {
+    if (!writes.has(path33)) {
+      writes.set(path33, {
         lastChange: now2,
         cancelWait: () => {
-          writes.delete(path31);
+          writes.delete(path33);
           clearTimeout(timeoutHandler);
           return event;
         }
@@ -19770,8 +19712,8 @@ var FSWatcher = class extends EventEmitter2 {
   /**
    * Determines whether user has asked to ignore this path.
    */
-  _isIgnored(path31, stats) {
-    if (this.options.atomic && DOT_RE.test(path31))
+  _isIgnored(path33, stats) {
+    if (this.options.atomic && DOT_RE.test(path33))
       return true;
     if (!this._userIgnored) {
       const { cwd } = this.options;
@@ -19781,17 +19723,17 @@ var FSWatcher = class extends EventEmitter2 {
       const list = [...ignoredPaths.map(normalizeIgnored(cwd)), ...ignored];
       this._userIgnored = anymatch(list, void 0);
     }
-    return this._userIgnored(path31, stats);
+    return this._userIgnored(path33, stats);
   }
-  _isntIgnored(path31, stat4) {
-    return !this._isIgnored(path31, stat4);
+  _isntIgnored(path33, stat5) {
+    return !this._isIgnored(path33, stat5);
   }
   /**
    * Provides a set of common helpers and properties relating to symlink handling.
    * @param path file or directory pattern being watched
    */
-  _getWatchHelpers(path31) {
-    return new WatchHelper(path31, this.options.followSymlinks, this);
+  _getWatchHelpers(path33) {
+    return new WatchHelper(path33, this.options.followSymlinks, this);
   }
   // Directory helpers
   // -----------------
@@ -19823,63 +19765,63 @@ var FSWatcher = class extends EventEmitter2 {
    * @param item      base path of item/directory
    */
   _remove(directory, item, isDirectory) {
-    const path31 = sp2.join(directory, item);
-    const fullPath = sp2.resolve(path31);
-    isDirectory = isDirectory != null ? isDirectory : this._watched.has(path31) || this._watched.has(fullPath);
-    if (!this._throttle("remove", path31, 100))
+    const path33 = sp2.join(directory, item);
+    const fullPath = sp2.resolve(path33);
+    isDirectory = isDirectory != null ? isDirectory : this._watched.has(path33) || this._watched.has(fullPath);
+    if (!this._throttle("remove", path33, 100))
       return;
     if (!isDirectory && this._watched.size === 1) {
       this.add(directory, item, true);
     }
-    const wp = this._getWatchedDir(path31);
+    const wp = this._getWatchedDir(path33);
     const nestedDirectoryChildren = wp.getChildren();
-    nestedDirectoryChildren.forEach((nested) => this._remove(path31, nested));
+    nestedDirectoryChildren.forEach((nested) => this._remove(path33, nested));
     const parent = this._getWatchedDir(directory);
     const wasTracked = parent.has(item);
     parent.remove(item);
     if (this._symlinkPaths.has(fullPath)) {
       this._symlinkPaths.delete(fullPath);
     }
-    let relPath = path31;
+    let relPath = path33;
     if (this.options.cwd)
-      relPath = sp2.relative(this.options.cwd, path31);
+      relPath = sp2.relative(this.options.cwd, path33);
     if (this.options.awaitWriteFinish && this._pendingWrites.has(relPath)) {
       const event = this._pendingWrites.get(relPath).cancelWait();
       if (event === EVENTS.ADD)
         return;
     }
-    this._watched.delete(path31);
+    this._watched.delete(path33);
     this._watched.delete(fullPath);
     const eventName = isDirectory ? EVENTS.UNLINK_DIR : EVENTS.UNLINK;
-    if (wasTracked && !this._isIgnored(path31))
-      this._emit(eventName, path31);
-    this._closePath(path31);
+    if (wasTracked && !this._isIgnored(path33))
+      this._emit(eventName, path33);
+    this._closePath(path33);
   }
   /**
    * Closes all watchers for a path
    */
-  _closePath(path31) {
-    this._closeFile(path31);
-    const dir = sp2.dirname(path31);
-    this._getWatchedDir(dir).remove(sp2.basename(path31));
+  _closePath(path33) {
+    this._closeFile(path33);
+    const dir = sp2.dirname(path33);
+    this._getWatchedDir(dir).remove(sp2.basename(path33));
   }
   /**
    * Closes only file-specific watchers
    */
-  _closeFile(path31) {
-    const closers = this._closers.get(path31);
+  _closeFile(path33) {
+    const closers = this._closers.get(path33);
     if (!closers)
       return;
     closers.forEach((closer) => closer());
-    this._closers.delete(path31);
+    this._closers.delete(path33);
   }
-  _addPathCloser(path31, closer) {
+  _addPathCloser(path33, closer) {
     if (!closer)
       return;
-    let list = this._closers.get(path31);
+    let list = this._closers.get(path33);
     if (!list) {
       list = [];
-      this._closers.set(path31, list);
+      this._closers.set(path33, list);
     }
     list.push(closer);
   }
@@ -19909,12 +19851,291 @@ function watch(paths, options = {}) {
 var chokidar_default = { watch, FSWatcher };
 
 // src/watcher/file-watcher.ts
+import * as path28 from "path";
+
+// src/watcher/native-recursive-watcher.ts
+import { watch as watch2 } from "fs";
 import * as path26 from "path";
+var NativeRecursiveWatcher = class {
+  constructor(root, onChange, options = {}) {
+    this.root = root;
+    this.onChange = onChange;
+    this.watchFactory = options.watchFactory ?? this.defaultWatchFactory;
+    this.onError = options.onError;
+  }
+  root;
+  onChange;
+  watcher = null;
+  listenerToken = 0;
+  watchFactory;
+  onError;
+  start() {
+    if (this.watcher) return;
+    const token = ++this.listenerToken;
+    const listener = (_eventType, filename) => {
+      if (this.watcher === null || this.listenerToken !== token) return;
+      const absolutePath = this.toAbsolutePath(filename);
+      const nextResult = this.onChange(absolutePath);
+      if (nextResult instanceof Promise) {
+        void nextResult.catch((error) => {
+          console.error("[codebase-index] Error handling native watcher event:", error);
+        });
+      }
+    };
+    const watcher = this.watchFactory(this.root, listener, {
+      persistent: true,
+      recursive: true
+    });
+    watcher.on?.("error", (error) => {
+      if (this.watcher === watcher && this.listenerToken === token) {
+        this.onError?.(error);
+      }
+    });
+    this.watcher = watcher;
+  }
+  async stop() {
+    const watcher = this.watcher;
+    this.watcher = null;
+    this.listenerToken += 1;
+    if (!watcher) return;
+    await watcher.close();
+  }
+  toAbsolutePath(filename) {
+    if (filename == null) return null;
+    const normalizedFilename = typeof filename === "string" ? filename : filename.toString();
+    const absolutePath = path26.resolve(this.root, normalizedFilename);
+    const relativePath = path26.relative(this.root, absolutePath);
+    const outsideRoot = relativePath === ".." || relativePath.startsWith(`..${path26.sep}`) || path26.isAbsolute(relativePath);
+    return outsideRoot ? null : absolutePath;
+  }
+  defaultWatchFactory = (root, listener, options) => watch2(root, options, listener);
+};
+
+// src/watcher/snapshot.ts
+import * as fsPromises4 from "fs/promises";
+import * as path27 from "path";
+async function buildFileSnapshotScan(projectRoot, config, configPaths = []) {
+  const normalizedProjectRoot = path27.resolve(projectRoot);
+  const ignoreFilter = createIgnoreFilter(normalizedProjectRoot);
+  const includePatterns = [...config.include, ...config.additionalInclude ?? []];
+  const maxDepth = config.indexing?.maxDepth ?? -1;
+  const snapshot = /* @__PURE__ */ new Map();
+  const unreadablePrefixes = /* @__PURE__ */ new Set();
+  const includeFile = async (filePath) => {
+    const normalizedPath3 = path27.resolve(filePath);
+    if (!shouldIncludeFile(normalizedPath3, normalizedProjectRoot, includePatterns, config.exclude, ignoreFilter)) return;
+    const stat5 = await readStatIfFile(normalizedPath3, unreadablePrefixes);
+    if (stat5) snapshot.set(normalizedPath3, { size: stat5.size, mtimeMs: stat5.mtimeMs });
+  };
+  const walk = async (directoryPath, depth) => {
+    let entries;
+    try {
+      entries = await fsPromises4.readdir(directoryPath, { withFileTypes: true });
+    } catch (error) {
+      if (isMissingFsError(error)) return;
+      if (isPermissionFsError(error)) {
+        unreadablePrefixes.add(path27.resolve(directoryPath));
+        return;
+      }
+      throw error;
+    }
+    for (const entry of entries) {
+      const fullPath = path27.join(directoryPath, entry.name);
+      const relativePath = path27.relative(normalizedProjectRoot, fullPath);
+      if (entry.isDirectory()) {
+        if (hasFilteredPathSegment(relativePath, path27.sep) || isRestrictedDirectory(relativePath, path27.sep)) continue;
+        if (ignoreFilter.ignores(relativePath)) continue;
+        if (maxDepth === -1 || depth < maxDepth) await walk(fullPath, depth + 1);
+      } else if (entry.isFile()) {
+        await includeFile(fullPath);
+      }
+    }
+  };
+  await walk(normalizedProjectRoot, 0);
+  await includeExplicitConfigPaths(snapshot, unreadablePrefixes, configPaths);
+  return { entries: snapshot, unreadablePrefixes };
+}
+async function buildFileSnapshotForPathScan(projectRoot, config, configPaths, targetPath) {
+  const normalizedProjectRoot = path27.resolve(projectRoot);
+  const normalizedTargetPath = path27.resolve(targetPath);
+  if (!isWithinPath(normalizedProjectRoot, normalizedTargetPath)) {
+    return { entries: /* @__PURE__ */ new Map(), unreadablePrefixes: /* @__PURE__ */ new Set() };
+  }
+  const ignoreFilter = createIgnoreFilter(normalizedProjectRoot);
+  const includePatterns = [...config.include, ...config.additionalInclude ?? []];
+  const maxDepth = config.indexing?.maxDepth ?? -1;
+  const explicitConfigPaths = new Set(configPaths.map((configPath) => path27.resolve(configPath)));
+  const snapshot = /* @__PURE__ */ new Map();
+  const unreadablePrefixes = /* @__PURE__ */ new Set();
+  const includeFile = async (filePath) => {
+    const normalizedPath3 = path27.resolve(filePath);
+    if (!explicitConfigPaths.has(normalizedPath3) && !shouldIncludeFile(
+      normalizedPath3,
+      normalizedProjectRoot,
+      includePatterns,
+      config.exclude,
+      ignoreFilter
+    )) return;
+    const stat5 = await readStatIfFile(normalizedPath3, unreadablePrefixes);
+    if (stat5) snapshot.set(normalizedPath3, { size: stat5.size, mtimeMs: stat5.mtimeMs });
+  };
+  const walk = async (directoryPath, depth) => {
+    let entries;
+    try {
+      entries = await fsPromises4.readdir(directoryPath, { withFileTypes: true });
+    } catch (error) {
+      if (isMissingFsError(error)) return;
+      if (isPermissionFsError(error)) {
+        unreadablePrefixes.add(path27.resolve(directoryPath));
+        return;
+      }
+      throw error;
+    }
+    for (const entry of entries) {
+      const fullPath = path27.join(directoryPath, entry.name);
+      const relativePath = path27.relative(normalizedProjectRoot, fullPath);
+      if (entry.isDirectory()) {
+        if (hasFilteredPathSegment(relativePath, path27.sep) || isRestrictedDirectory(relativePath, path27.sep)) continue;
+        if (ignoreFilter.ignores(relativePath)) continue;
+        if (maxDepth === -1 || depth < maxDepth) await walk(fullPath, depth + 1);
+      } else if (entry.isFile()) {
+        await includeFile(fullPath);
+      }
+    }
+  };
+  const targetStat = await readStatIfFile(normalizedTargetPath, unreadablePrefixes);
+  if (targetStat) await includeFile(normalizedTargetPath);
+  else await walk(normalizedTargetPath, 0);
+  await includeExplicitConfigPathsInPath(snapshot, unreadablePrefixes, configPaths, normalizedTargetPath);
+  return { entries: snapshot, unreadablePrefixes };
+}
+function completeFileSnapshot(previous, scan) {
+  const completed = new Map(scan.entries);
+  for (const unreadablePrefix of scan.unreadablePrefixes) {
+    for (const [entryPath, entry] of previous) {
+      if (isWithinPath(unreadablePrefix, entryPath) && !completed.has(entryPath)) completed.set(entryPath, entry);
+    }
+  }
+  return completed;
+}
+async function includeExplicitConfigPaths(snapshot, unreadablePrefixes, configPaths) {
+  for (const configPath of [...new Set(configPaths.map((value) => path27.resolve(value)))]) {
+    if (snapshot.has(configPath)) continue;
+    const stat5 = await readStatIfFile(configPath, unreadablePrefixes);
+    if (stat5) snapshot.set(configPath, { size: stat5.size, mtimeMs: stat5.mtimeMs });
+  }
+}
+async function includeExplicitConfigPathsInPath(snapshot, unreadablePrefixes, configPaths, targetPath) {
+  await includeExplicitConfigPaths(
+    snapshot,
+    unreadablePrefixes,
+    configPaths.filter((configPath) => isWithinPath(targetPath, path27.resolve(configPath)))
+  );
+}
+function isWithinPath(parentPath, childPath) {
+  const relativePath = path27.relative(parentPath, childPath);
+  return relativePath === "" || !relativePath.startsWith(`..${path27.sep}`) && relativePath !== ".." && !path27.isAbsolute(relativePath);
+}
+async function readStatIfFile(filePath, unreadablePrefixes) {
+  try {
+    const stat5 = await fsPromises4.stat(filePath);
+    return stat5.isFile() ? stat5 : null;
+  } catch (error) {
+    if (isMissingFsError(error)) return null;
+    if (isPermissionFsError(error)) {
+      unreadablePrefixes.add(path27.resolve(filePath));
+      return null;
+    }
+    throw error;
+  }
+}
+function isMissingFsError(error) {
+  return error instanceof Error && ["ENOENT", "ENOTDIR"].includes(error.code ?? "");
+}
+function isPermissionFsError(error) {
+  return error instanceof Error && ["EACCES", "EPERM"].includes(error.code ?? "");
+}
+var diffTypeOrder = { add: 0, change: 1, unlink: 2 };
+function diffFileSnapshots(previous, current, forcedChanges = /* @__PURE__ */ new Set()) {
+  const changes = [];
+  for (const [filePath, previousEntry] of previous) {
+    const currentEntry = current.get(filePath);
+    if (!currentEntry) changes.push({ type: "unlink", path: filePath });
+    else if (forcedChanges.has(filePath) || currentEntry.size !== previousEntry.size || currentEntry.mtimeMs !== previousEntry.mtimeMs) {
+      changes.push({ type: "change", path: filePath });
+    }
+  }
+  for (const [filePath] of current) {
+    if (!previous.has(filePath)) changes.push({ type: "add", path: filePath });
+  }
+  return changes.sort((left, right) => left.path.localeCompare(right.path) || diffTypeOrder[left.type] - diffTypeOrder[right.type]);
+}
+
+// src/watcher/snapshot-reconciler.ts
+var FileSnapshotReconciler = class {
+  constructor(projectRoot, config, configPaths) {
+    this.projectRoot = projectRoot;
+    this.config = config;
+    this.configPaths = configPaths;
+  }
+  projectRoot;
+  config;
+  configPaths;
+  snapshot = null;
+  reconciliationTail = Promise.resolve();
+  async initialize() {
+    this.snapshot = (await buildFileSnapshotScan(this.projectRoot, this.config, this.configPaths)).entries;
+  }
+  async reconcile(invalidations = []) {
+    if (this.snapshot === null) {
+      throw new Error("FileSnapshotReconciler is not initialized. Call initialize() before reconcile().");
+    }
+    const reconciliation = this.reconciliationTail.then(async () => {
+      const previousSnapshot = this.snapshot;
+      if (previousSnapshot === null) {
+        throw new Error("FileSnapshotReconciler is not initialized. Call initialize() before reconcile().");
+      }
+      const normalizedInvalidations = invalidations.map((invalidation) => typeof invalidation === "string" || invalidation === null ? { path: invalidation, forceChange: false } : { path: invalidation.path, forceChange: invalidation.forceChange === true });
+      const scopedPaths = normalizedInvalidations.map((invalidation) => invalidation.path).filter((filePath) => filePath !== null);
+      const scan = scopedPaths.length === 0 || scopedPaths.length !== normalizedInvalidations.length ? await buildFileSnapshotScan(this.projectRoot, this.config, this.configPaths) : await this.reconcilePaths(previousSnapshot, scopedPaths);
+      const nextSnapshot = completeFileSnapshot(previousSnapshot, scan);
+      const forcedChanges = new Set(normalizedInvalidations.filter((invalidation) => invalidation.path !== null && invalidation.forceChange).map((invalidation) => invalidation.path));
+      const changes = diffFileSnapshots(previousSnapshot, nextSnapshot, forcedChanges);
+      this.snapshot = nextSnapshot;
+      return changes;
+    });
+    this.reconciliationTail = reconciliation.then(() => void 0, () => void 0);
+    return reconciliation;
+  }
+  async reconcilePaths(previousSnapshot, invalidatedPaths) {
+    const scopes = this.getScopes(invalidatedPaths);
+    const entries = new Map(previousSnapshot);
+    const unreadablePrefixes = /* @__PURE__ */ new Set();
+    for (const scope of scopes) {
+      for (const previousPath of entries.keys()) {
+        if (isWithinPath(scope, previousPath)) entries.delete(previousPath);
+      }
+      const scopedScan = await buildFileSnapshotForPathScan(this.projectRoot, this.config, this.configPaths, scope);
+      for (const [filePath, entry] of scopedScan.entries) entries.set(filePath, entry);
+      for (const unreadablePrefix of scopedScan.unreadablePrefixes) unreadablePrefixes.add(unreadablePrefix);
+    }
+    return { entries, unreadablePrefixes };
+  }
+  getScopes(invalidatedPaths) {
+    const uniquePaths = [...new Set(invalidatedPaths)].sort((left, right) => left.length - right.length);
+    return uniquePaths.filter((candidate, index) => !uniquePaths.slice(0, index).some(
+      (ancestor) => isWithinPath(ancestor, candidate)
+    ));
+  }
+};
+
+// src/watcher/file-watcher.ts
 var FileWatcher = class {
   watcher = null;
   projectRoot;
   config;
   configPath;
+  backend;
   projectConfigPaths;
   pendingChanges = /* @__PURE__ */ new Map();
   debounceTimer = null;
@@ -19924,44 +20145,74 @@ var FileWatcher = class {
   resolveReady = null;
   pollingFallbackAttempted = false;
   pendingClose = null;
+  startupReadySignals = 1;
+  nativeWatcher = null;
+  nativeReconciler = null;
+  nativeSetupGeneration = 0;
+  nativeStarting = false;
+  nativeInitializing = false;
+  nativeReconcileTimer = null;
+  nativeInvalidatedPaths = /* @__PURE__ */ new Map();
+  configPathStates = /* @__PURE__ */ new Map();
   constructor(projectRoot, config, host, options = {}) {
     this.projectRoot = projectRoot;
     this.config = config;
+    this.backend = options.backend ?? "auto";
     this.configPath = options.configPath;
     this.projectConfigPaths = options.configPath ? [options.configPath] : getProjectConfigCandidatePaths(projectRoot, host);
   }
   start(handler) {
-    if (this.watcher) {
+    if (this.watcher || this.nativeWatcher || this.nativeStarting) {
       return;
     }
     this.onChanges = handler;
     this.pollingFallbackAttempted = false;
     this.resetReady();
+    if (this.shouldUseNativeWatcher()) {
+      if (this.hasExternalConfigWatchTarget()) {
+        this.setStartupReadySignals(2);
+        this.startExternalConfigWatcher();
+      }
+      this.nativeStarting = true;
+      void this.createNativeWatcher();
+      return;
+    }
     this.createWatcher();
   }
   resetReady() {
-    this.readyPromise = new Promise((resolve18) => {
-      this.resolveReady = resolve18;
+    this.readyPromise = new Promise((resolve20) => {
+      this.resolveReady = resolve20;
     });
+    this.startupReadySignals = 1;
   }
-  createWatcher(usePolling = false) {
-    const ignoreFilter = createIgnoreFilter(this.projectRoot);
-    let watchTargets = this.projectRoot;
-    if (this.configPath) {
-      watchTargets = [this.projectRoot, this.configPath];
-    } else {
-      const externalConfigTargets = this.projectConfigPaths.filter((projectConfigPath) => {
-        const relativeConfigPath = path26.relative(this.projectRoot, projectConfigPath);
-        return this.isOutsideProjectPath(relativeConfigPath);
-      }).map((projectConfigPath) => existsSync15(projectConfigPath) ? projectConfigPath : this.getNearestExistingDirectory(path26.dirname(projectConfigPath)));
-      const uniqueExternalConfigTargets = [...new Set(externalConfigTargets)];
-      if (uniqueExternalConfigTargets.length > 0) {
-        watchTargets = [this.projectRoot, ...uniqueExternalConfigTargets];
-      }
+  setStartupReadySignals(expectedSignals) {
+    if (!this.readyPromise) {
+      return;
     }
+    this.startupReadySignals = Math.max(0, expectedSignals);
+  }
+  reportStartupReadySignal() {
+    if (!this.readyPromise || !this.resolveReady) {
+      return;
+    }
+    if (this.startupReadySignals <= 0) {
+      return;
+    }
+    this.startupReadySignals -= 1;
+    if (this.startupReadySignals !== 0) {
+      return;
+    }
+    this.resolveReady();
+    this.resolveReady = null;
+  }
+  createWatcher(watchTargets, usePolling = false, reportsStartupReady = true) {
+    let reportedStartupReady = false;
+    this.configPathStates = this.getConfigPathStates();
+    const ignoreFilter = createIgnoreFilter(this.projectRoot);
+    const resolvedWatchTargets = watchTargets ?? this.getFullChokidarWatchTargets();
     const watcherOptions = {
       ignored: (filePath) => {
-        const relativePath = path26.relative(this.projectRoot, filePath);
+        const relativePath = path28.relative(this.projectRoot, filePath);
         if (!relativePath) return false;
         if (this.isProjectConfigPathOrAncestor(relativePath)) {
           return false;
@@ -19969,10 +20220,10 @@ var FileWatcher = class {
         if (this.isOutsideProjectPath(relativePath)) {
           return true;
         }
-        if (hasFilteredPathSegment(relativePath, path26.sep)) {
+        if (hasFilteredPathSegment(relativePath, path28.sep)) {
           return true;
         }
-        if (isRestrictedDirectory(relativePath, path26.sep)) {
+        if (isRestrictedDirectory(relativePath, path28.sep)) {
           return true;
         }
         if (ignoreFilter.ignores(relativePath)) {
@@ -20005,10 +20256,13 @@ var FileWatcher = class {
       watcher = new FSWatcher(watcherOptions);
     }
     this.watcher = watcher;
-    watcher.once("ready", () => {
+    watcher.on("ready", () => {
       if (this.watcher !== watcher) return;
-      this.resolveReady?.();
-      this.resolveReady = null;
+      this.reconcileConfigPathStates();
+      if (reportsStartupReady) {
+        this.reportStartupReadySignal();
+        reportedStartupReady = true;
+      }
     });
     watcher.on("error", (error) => {
       const err = error instanceof Error ? error : null;
@@ -20022,10 +20276,13 @@ var FileWatcher = class {
           console.error("[codebase-index] Failed to close exhausted file watcher:", closeError);
         });
         if (this.onChanges) {
+          const replacementReportsStartupReady = reportsStartupReady || reportedStartupReady;
           if (!this.resolveReady) {
             this.resetReady();
+          } else if (reportedStartupReady) {
+            this.startupReadySignals += 1;
           }
-          this.createWatcher(true);
+          this.createWatcher(resolvedWatchTargets, true, replacementReportsStartupReady);
         } else {
           this.watcher = null;
         }
@@ -20036,13 +20293,166 @@ var FileWatcher = class {
     watcher.on("add", (filePath) => this.handleChange(watcher, "add", filePath));
     watcher.on("change", (filePath) => this.handleChange(watcher, "change", filePath));
     watcher.on("unlink", (filePath) => this.handleChange(watcher, "unlink", filePath));
-    watcher.add(watchTargets);
+    watcher.add(resolvedWatchTargets);
+  }
+  shouldUseNativeWatcher() {
+    if (this.backend === "chokidar") {
+      return false;
+    }
+    return true;
+  }
+  getFullChokidarWatchTargets() {
+    if (this.configPath) {
+      return [this.projectRoot, this.configPath];
+    }
+    const externalConfigTargets = this.getExternalConfigWatchTargets();
+    if (externalConfigTargets.length === 0) {
+      return this.projectRoot;
+    }
+    return [this.projectRoot, ...externalConfigTargets];
+  }
+  getExternalConfigWatchTargets() {
+    return [...new Set(
+      this.projectConfigPaths.filter((projectConfigPath) => {
+        const relativeConfigPath = path28.relative(this.projectRoot, projectConfigPath);
+        return this.isOutsideProjectPath(relativeConfigPath);
+      }).map((projectConfigPath) => {
+        if (existsSync15(projectConfigPath)) {
+          return projectConfigPath;
+        }
+        return this.getNearestExistingDirectory(path28.dirname(projectConfigPath));
+      })
+    )];
+  }
+  hasExternalConfigWatchTarget() {
+    return this.getExternalConfigWatchTargets().length > 0;
+  }
+  startExternalConfigWatcher(usePolling = false) {
+    const externalTargets = this.getExternalConfigWatchTargets();
+    if (externalTargets.length === 0) {
+      return;
+    }
+    this.createWatcher(externalTargets, usePolling);
+  }
+  async createNativeWatcher() {
+    const generation = ++this.nativeSetupGeneration;
+    const reconciler = new FileSnapshotReconciler(this.projectRoot, this.config, this.projectConfigPaths);
+    const watcher = new NativeRecursiveWatcher(
+      this.projectRoot,
+      (filePath) => this.scheduleNativeReconciliation(generation, filePath),
+      { onError: (error) => void this.fallbackFromNativeWatcher(generation, error) }
+    );
+    this.nativeReconciler = reconciler;
+    this.nativeWatcher = watcher;
+    this.nativeInitializing = true;
+    try {
+      watcher.start();
+      if (!this.isCurrentNativeSetup(generation)) {
+        await watcher.stop();
+        return;
+      }
+      await reconciler.initialize();
+      if (!this.isCurrentNativeSetup(generation) || this.nativeWatcher !== watcher) {
+        await watcher.stop();
+        return;
+      }
+      this.nativeStarting = false;
+      this.nativeInitializing = false;
+      await this.reconcileNativeWatcherWithPendingInvalidations(generation);
+      this.reportStartupReadySignal();
+    } catch (error) {
+      if (!this.isCurrentNativeSetup(generation)) return;
+      this.nativeInitializing = false;
+      if (this.nativeWatcher) {
+        await this.fallbackFromNativeWatcher(generation, error);
+        return;
+      }
+      this.nativeStarting = false;
+      const externalWatcher = this.watcher;
+      this.watcher = null;
+      this.nativeReconciler = null;
+      await externalWatcher?.close();
+      console.warn("[codebase-index] Native recursive watcher unavailable; using Chokidar fallback.", error);
+      this.setStartupReadySignals(1);
+      this.createWatcher();
+    }
+  }
+  isCurrentNativeSetup(generation) {
+    return this.nativeSetupGeneration === generation && this.onChanges !== null;
+  }
+  scheduleNativeReconciliation(generation, filePath) {
+    if (!this.isCurrentNativeSetup(generation)) return;
+    const requiresFullReconciliation = filePath === path28.join(this.projectRoot, ".gitignore");
+    const invalidatedPath = requiresFullReconciliation ? null : filePath;
+    this.nativeInvalidatedPaths.set(invalidatedPath, invalidatedPath !== null);
+    if (this.nativeReconcileTimer) {
+      clearTimeout(this.nativeReconcileTimer);
+    }
+    this.nativeReconcileTimer = setTimeout(() => {
+      this.nativeReconcileTimer = null;
+      void this.reconcileNativeWatcherFromQueue(generation);
+    }, 100);
+  }
+  reconcileNativeWatcherFromQueue(generation) {
+    if (!this.isCurrentNativeSetup(generation) || this.nativeInitializing) return;
+    const invalidatedPaths = this.popNativeInvalidations();
+    if (invalidatedPaths.length === 0) return;
+    void this.reconcileNativeWatcher(generation, invalidatedPaths);
+  }
+  async reconcileNativeWatcher(generation, invalidatedPaths) {
+    if (!this.isCurrentNativeSetup(generation) || !this.nativeReconciler) return;
+    try {
+      const reconciler = this.nativeReconciler;
+      const changes = await reconciler.reconcile(invalidatedPaths);
+      if (!this.isCurrentNativeSetup(generation) || this.nativeReconciler !== reconciler) return;
+      this.recordChanges(changes);
+    } catch (error) {
+      await this.fallbackFromNativeWatcher(generation, error);
+    }
+  }
+  async reconcileNativeWatcherWithPendingInvalidations(generation) {
+    const invalidatedPaths = this.popNativeInvalidations();
+    if (invalidatedPaths.length === 0) return;
+    await this.reconcileNativeWatcher(generation, invalidatedPaths);
+  }
+  popNativeInvalidations() {
+    if (this.nativeInvalidatedPaths.size === 0) return [];
+    const invalidations = [...this.nativeInvalidatedPaths].map(([invalidatedPath, forceChange]) => ({
+      path: invalidatedPath,
+      forceChange
+    }));
+    this.nativeInvalidatedPaths.clear();
+    return invalidations;
+  }
+  async fallbackFromNativeWatcher(generation, error) {
+    if (!this.isCurrentNativeSetup(generation)) return;
+    const watcher = this.nativeWatcher;
+    const externalWatcher = this.watcher;
+    this.nativeWatcher = null;
+    this.watcher = null;
+    this.nativeReconciler = null;
+    this.nativeStarting = false;
+    this.nativeInitializing = false;
+    this.nativeSetupGeneration += 1;
+    if (this.nativeReconcileTimer) {
+      clearTimeout(this.nativeReconcileTimer);
+      this.nativeReconcileTimer = null;
+    }
+    this.nativeInvalidatedPaths.clear();
+    this.setStartupReadySignals(1);
+    console.warn("[codebase-index] Native recursive watcher failed; using Chokidar fallback.", error);
+    await watcher?.stop();
+    await externalWatcher?.close();
+    if (this.onChanges) {
+      this.createWatcher();
+    }
   }
   handleChange(watcher, type, filePath) {
     if (this.watcher !== watcher) {
       return;
     }
     if (this.isProjectConfigPath(filePath)) {
+      this.updateConfigPathState(filePath);
       this.pendingChanges.set(filePath, type);
       this.scheduleFlush();
       return;
@@ -20057,27 +20467,33 @@ var FileWatcher = class {
     )) {
       return;
     }
-    this.pendingChanges.set(filePath, type);
+    this.recordChanges([{ path: filePath, type }]);
+  }
+  recordChanges(changes) {
+    if (changes.length === 0) return;
+    for (const change of changes) {
+      this.pendingChanges.set(change.path, change.type);
+    }
     this.scheduleFlush();
   }
   isProjectConfigPath(filePath) {
-    const relativePath = path26.relative(this.projectRoot, filePath);
-    const normalizedRelativePath = path26.normalize(relativePath);
+    const relativePath = path28.relative(this.projectRoot, filePath);
+    const normalizedRelativePath = path28.normalize(relativePath);
     return this.getProjectConfigRelativePaths().some((configPath) => configPath === normalizedRelativePath);
   }
   isProjectConfigPathOrAncestor(relativePath) {
-    const normalizedRelativePath = path26.normalize(relativePath);
+    const normalizedRelativePath = path28.normalize(relativePath);
     return this.getProjectConfigRelativePaths().some(
-      (configPath) => configPath === normalizedRelativePath || configPath.startsWith(`${normalizedRelativePath}${path26.sep}`)
+      (configPath) => configPath === normalizedRelativePath || configPath.startsWith(`${normalizedRelativePath}${path28.sep}`)
     );
   }
   isOutsideProjectPath(relativePath) {
-    return relativePath === ".." || relativePath.startsWith(`..${path26.sep}`) || path26.isAbsolute(relativePath);
+    return relativePath === ".." || relativePath.startsWith(`..${path28.sep}`) || path28.isAbsolute(relativePath);
   }
   getNearestExistingDirectory(directoryPath) {
     let candidate = directoryPath;
     while (!existsSync15(candidate)) {
-      const parent = path26.dirname(candidate);
+      const parent = path28.dirname(candidate);
       if (parent === candidate) break;
       candidate = parent;
     }
@@ -20085,9 +20501,51 @@ var FileWatcher = class {
   }
   getProjectConfigRelativePaths() {
     return this.projectConfigPaths.map(
-      (configPath) => path26.normalize(path26.relative(this.projectRoot, configPath))
+      (configPath) => path28.normalize(path28.relative(this.projectRoot, configPath))
     );
   }
+  getConfigPathStates() {
+    const states = /* @__PURE__ */ new Map();
+    for (const configPath of this.projectConfigPaths) {
+      const state = this.getConfigPathState(configPath);
+      if (state) states.set(configPath, state);
+    }
+    return states;
+  }
+  getConfigPathState(configPath) {
+    try {
+      const stats = statSync6(configPath);
+      return stats.isFile() ? { mtimeMs: stats.mtimeMs, size: stats.size } : void 0;
+    } catch (error) {
+      void error;
+      return void 0;
+    }
+  }
+  updateConfigPathState(configPath) {
+    const state = this.getConfigPathState(configPath);
+    if (state) {
+      this.configPathStates.set(configPath, state);
+    } else {
+      this.configPathStates.delete(configPath);
+    }
+  }
+  reconcileConfigPathStates() {
+    const nextStates = this.getConfigPathStates();
+    const changes = [];
+    for (const configPath of this.projectConfigPaths) {
+      const previous = this.configPathStates.get(configPath);
+      const next = nextStates.get(configPath);
+      if (!previous && next) {
+        changes.push({ path: configPath, type: "add" });
+      } else if (previous && !next) {
+        changes.push({ path: configPath, type: "unlink" });
+      } else if (previous && next && (previous.size !== next.size || previous.mtimeMs !== next.mtimeMs)) {
+        changes.push({ path: configPath, type: "change" });
+      }
+    }
+    this.configPathStates = nextStates;
+    this.recordChanges(changes);
+  }
   scheduleFlush() {
     if (this.debounceTimer) {
       clearTimeout(this.debounceTimer);
@@ -20101,7 +20559,7 @@ var FileWatcher = class {
       return;
     }
     const changes = Array.from(this.pendingChanges.entries()).map(
-      ([path31, type]) => ({ path: path31, type })
+      ([path33, type]) => ({ path: path33, type })
     );
     this.pendingChanges.clear();
     try {
@@ -20115,20 +20573,31 @@ var FileWatcher = class {
       clearTimeout(this.debounceTimer);
       this.debounceTimer = null;
     }
+    if (this.nativeReconcileTimer) {
+      clearTimeout(this.nativeReconcileTimer);
+      this.nativeReconcileTimer = null;
+    }
+    this.nativeInvalidatedPaths.clear();
     const watcher = this.watcher;
+    const nativeWatcher = this.nativeWatcher;
     const pendingClose = this.pendingClose;
     const resolveReady = this.resolveReady;
     this.watcher = null;
+    this.nativeWatcher = null;
+    this.nativeReconciler = null;
+    this.nativeStarting = false;
+    this.nativeInitializing = false;
+    this.nativeSetupGeneration += 1;
     this.pendingClose = null;
     this.resolveReady = null;
     this.readyPromise = null;
     this.pendingChanges.clear();
     this.onChanges = null;
-    await Promise.all([watcher?.close(), pendingClose]);
+    await Promise.all([watcher?.close(), nativeWatcher?.stop(), pendingClose]);
     resolveReady?.();
   }
   isRunning() {
-    return this.watcher !== null;
+    return this.watcher !== null || this.nativeWatcher !== null || this.nativeStarting;
   }
   async waitUntilReady() {
     await (this.readyPromise ?? Promise.resolve());
@@ -20136,7 +20605,7 @@ var FileWatcher = class {
 };
 
 // src/watcher/git-head-watcher.ts
-import * as path27 from "path";
+import * as path29 from "path";
 var GitHeadWatcher = class {
   watcher = null;
   projectRoot;
@@ -20158,13 +20627,13 @@ var GitHeadWatcher = class {
       this.readyPromise = Promise.resolve();
       return;
     }
-    this.readyPromise = new Promise((resolve18) => {
-      this.resolveReady = resolve18;
+    this.readyPromise = new Promise((resolve20) => {
+      this.resolveReady = resolve20;
     });
     this.onBranchChange = handler;
     this.currentBranch = getCurrentBranch(this.projectRoot);
     const headPath = getHeadPath(this.projectRoot);
-    const refsPath = path27.join(this.projectRoot, ".git", "refs", "heads");
+    const refsPath = path29.join(this.projectRoot, ".git", "refs", "heads");
     this.watcher = chokidar_default.watch([headPath, refsPath], {
       persistent: true,
       ignoreInitial: true,
@@ -20300,7 +20769,7 @@ function getConfigPaths(projectRoot, host, options) {
 
 // src/tools/visualize/activity.ts
 import { execFileSync } from "child_process";
-import * as path28 from "path";
+import * as path30 from "path";
 function attachRecentActivity(data, projectRoot) {
   const activity = readGitActivity(projectRoot);
   const changes = activity.size > 0 ? buildGitChanges(data, activity, projectRoot) : buildGraphChanges(data);
@@ -20462,7 +20931,7 @@ function normalizePath4(filePath) {
   return filePath.replace(/\\/g, "/");
 }
 function toGitRelativePath(projectRoot, filePath) {
-  const relativePath = path28.isAbsolute(filePath) ? path28.relative(projectRoot, filePath) : filePath;
+  const relativePath = path30.isAbsolute(filePath) ? path30.relative(projectRoot, filePath) : filePath;
   return normalizePath4(relativePath);
 }
 
@@ -20720,7 +21189,7 @@ render();
 }
 
 // src/tools/visualize/transform.ts
-import * as path29 from "path";
+import * as path31 from "path";
 
 // src/tools/visualize/modules.ts
 var MAX_MODULES = 18;
@@ -20853,8 +21322,8 @@ function compactModules(prefixToNodes) {
 function deriveModules(nodes) {
   const initial = /* @__PURE__ */ new Map();
   for (const node of nodes) {
-    const relative12 = stripToProjectRelative(node.filePath);
-    const prefix = modulePrefixFromRelativePath(relative12);
+    const relative14 = stripToProjectRelative(node.filePath);
+    const prefix = modulePrefixFromRelativePath(relative14);
     if (!initial.has(prefix)) initial.set(prefix, []);
     initial.get(prefix)?.push(node);
   }
@@ -20980,7 +21449,7 @@ function transformForVisualization(symbols, edges, options = {}) {
     filePath: s.filePath,
     kind: s.kind,
     line: s.startLine,
-    directory: path29.dirname(s.filePath),
+    directory: path31.dirname(s.filePath),
     moduleId: "",
     moduleLabel: ""
   }));
@@ -21008,9 +21477,9 @@ function parseArgs(argv) {
   let host = "opencode";
   for (let i = 2; i < argv.length; i++) {
     if (argv[i] === "--project" && argv[i + 1]) {
-      project = path30.resolve(argv[++i]);
+      project = path32.resolve(argv[++i]);
     } else if (argv[i] === "--config" && argv[i + 1]) {
-      config = path30.resolve(argv[++i]);
+      config = path32.resolve(argv[++i]);
     } else if (argv[i] === "--host" && argv[i + 1]) {
       host = parseHostMode(argv[++i]);
     } else if (argv[i] === "--host") {
@@ -21037,7 +21506,7 @@ function parseIndexArgs(argv, cwd) {
       if (!arg.startsWith("--project=")) {
         i += 1;
       }
-      project = path30.resolve(cwd, value);
+      project = path32.resolve(cwd, value);
       continue;
     }
     if (arg === "--config" || arg.startsWith("--config=")) {
@@ -21048,7 +21517,7 @@ function parseIndexArgs(argv, cwd) {
       if (!arg.startsWith("--config=")) {
         i += 1;
       }
-      config = path30.resolve(cwd, value);
+      config = path32.resolve(cwd, value);
       continue;
     }
     if (arg === "--host" || arg.startsWith("--host=")) {
@@ -21114,7 +21583,7 @@ function parseVisualizeArgs(argv, cwd) {
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (arg === "--project" && argv[i + 1]) {
-      project = path30.resolve(argv[++i]);
+      project = path32.resolve(argv[++i]);
     } else if (arg === "--max" && argv[i + 1]) {
       maxNodes = Number(argv[++i]);
     } else if (arg.startsWith("--max=") || arg.startsWith("max=")) {
@@ -21151,7 +21620,7 @@ async function handleVisualizeCommand(argv, cwd) {
       console.error("No connected symbols found. Retry with: npm run visualize -- orphans");
       return 1;
     }
-    const outputPath = path30.join(os8.tmpdir(), `call-graph-${Date.now()}.html`);
+    const outputPath = path32.join(os8.tmpdir(), `call-graph-${Date.now()}.html`);
     writeFileSync6(outputPath, generateVisualizationHtml(vizData), "utf-8");
     console.log(`Temporal call graph visualization generated: ${outputPath}`);
     console.log(`Nodes: ${vizData.nodes.length} | Edges: ${vizData.edges.length}`);
@@ -21183,8 +21652,60 @@ async function runMcpCli(argv) {
   const config = parseConfig(rawConfig);
   const server = createMcpServer(args.project, config, args.host);
   const transport = new StdioServerTransport();
-  await server.connect(transport);
   let watcher = null;
+  let shutdownPromise;
+  const onServerClose = server.server.onclose;
+  const shutdown = () => {
+    if (shutdownPromise) return shutdownPromise;
+    process.stdin.removeListener("end", requestShutdown);
+    process.stdin.removeListener("close", requestShutdown);
+    process.removeListener("SIGHUP", requestShutdown);
+    process.removeListener("SIGINT", requestShutdown);
+    process.removeListener("SIGTERM", requestShutdown);
+    server.server.onclose = onServerClose;
+    shutdownPromise = (async () => {
+      let exitCode = 0;
+      try {
+        await watcher?.stop();
+      } catch (error) {
+        exitCode = 1;
+        console.error("Failed to stop MCP file watcher cleanly:", error);
+      }
+      try {
+        await stopAutoIndex(args.project, args.host);
+      } catch (error) {
+        exitCode = 1;
+        console.error("Failed to stop automatic indexing cleanly:", error);
+      }
+      try {
+        await server.close();
+      } catch (error) {
+        exitCode = 1;
+        console.error("Failed to close MCP server cleanly:", error);
+      }
+      process.exit(exitCode);
+    })();
+    return shutdownPromise;
+  };
+  const requestShutdown = () => {
+    void shutdown();
+  };
+  server.server.onclose = () => {
+    try {
+      onServerClose?.();
+    } finally {
+      requestShutdown();
+    }
+  };
+  process.stdin.once("end", requestShutdown);
+  process.stdin.once("close", requestShutdown);
+  process.once("SIGINT", requestShutdown);
+  if (process.platform !== "win32") {
+    process.once("SIGHUP", requestShutdown);
+    process.once("SIGTERM", requestShutdown);
+  }
+  await server.connect(transport);
+  if (shutdownPromise) return;
   const isHomeDir = isHomeDirectory(args.project);
   const isValidProject = !isHomeDir && (!config.indexing.requireProjectMarker || hasProjectMarker(args.project));
   if (config.indexing.watchFiles && isValidProject) {
@@ -21196,26 +21717,6 @@ async function runMcpCli(argv) {
       args.config ? { configPath: args.config } : {}
     );
   }
-  let shuttingDown = false;
-  const shutdown = async () => {
-    if (shuttingDown) return;
-    shuttingDown = true;
-    try {
-      await watcher?.stop();
-      await stopAutoIndex(args.project, args.host);
-      await server.close();
-      process.exit(0);
-    } catch (error) {
-      console.error("Failed to stop MCP server cleanly:", error);
-      process.exit(1);
-    }
-  };
-  process.on("SIGINT", () => {
-    void shutdown();
-  });
-  process.on("SIGTERM", () => {
-    void shutdown();
-  });
 }
 function printIndexProgress(onProgress, title, metadata) {
   const details = Object.entries(metadata).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => `${key}=${isSensitiveKey(key) ? "[REDACTED]" : String(value)}`).join(" ");