npm - open-codebase-index - Versions diffs - 0.22.5 → 0.23.0 - Mend

open-codebase-index 0.22.5 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/.claude-plugin/marketplace.json +1 -1
package/.claude-plugin/plugin.json +1 -1
package/.codex-plugin/plugin.json +1 -1
package/dist/cli.cjs +949 -479
package/dist/cli.cjs.map +1 -1
package/dist/cli.js +950 -480
package/dist/cli.js.map +1 -1
package/dist/index.cjs +854 -395
package/dist/index.cjs.map +1 -1
package/dist/index.js +855 -396
package/dist/index.js.map +1 -1
package/dist/pi-extension.cjs +6 -95
package/dist/pi-extension.cjs.map +1 -1
package/dist/pi-extension.js +6 -95
package/dist/pi-extension.js.map +1 -1
package/native/codebase-index-native.darwin-arm64.node +0 -0
package/native/codebase-index-native.darwin-x64.node +0 -0
package/native/codebase-index-native.linux-arm64-gnu.node +0 -0
package/native/codebase-index-native.linux-x64-gnu.node +0 -0
package/native/codebase-index-native.win32-x64-msvc.node +0 -0
package/package.json +3 -1

package/dist/cli.cjs CHANGED Viewed

@@ -496,7 +496,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;
@@ -505,7 +505,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;
           }
@@ -526,17 +526,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}"`,
@@ -545,7 +545,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 {
@@ -575,19 +575,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(
@@ -600,18 +600,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,
@@ -619,29 +619,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.
@@ -669,7 +669,7 @@ module.exports = __toCommonJS(cli_exports);
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var import_fs20 = require("fs");
 var os8 = __toESM(require("os"), 1);
-var path30 = __toESM(require("path"), 1);
+var path32 = __toESM(require("path"), 1);
 var import_url = require("url");
 // src/config/constants.ts
@@ -1179,9 +1179,9 @@ var import_fs = require("fs");
 var path = __toESM(require("path"), 1);
 // 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;
 }
@@ -1453,7 +1453,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}\``);
     }
@@ -1467,7 +1467,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;
     }
@@ -1475,7 +1475,7 @@ function pTimeout(promise, options) {
     timer = customTimers.setTimeout.call(void 0, () => {
       if (fallback) {
         try {
-          resolve18(fallback());
+          resolve20(fallback());
         } catch (error) {
           reject(error);
         }
@@ -1485,7 +1485,7 @@ function pTimeout(promise, options) {
         promise.cancel();
       }
       if (message === false) {
-        resolve18();
+        resolve20();
       } else if (message instanceof Error) {
         reject(message);
       } else {
@@ -1887,7 +1887,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 () => {
@@ -1927,7 +1927,7 @@ var PQueue = class extends import_index.default {
             })]);
           }
           const result = await operation;
-          resolve18(result);
+          resolve20(result);
           this.emit("completed", result);
         } catch (error) {
           reject(error);
@@ -2115,13 +2115,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);
     });
@@ -2407,7 +2407,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);
@@ -2415,7 +2415,7 @@ async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTi
       };
       const timeoutToken = setTimeout(() => {
         options.signal?.removeEventListener("abort", onAbort);
-        resolve18();
+        resolve20();
       }, finalDelay);
       if (options.unref) {
         timeoutToken.unref?.();
@@ -3221,85 +3221,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);
 var import_fs3 = require("fs");
@@ -3461,8 +3382,8 @@ async function* walkDirectory(dir, projectRoot, includePatterns, excludePatterns
     if (entry.isDirectory()) {
       subdirs.push({ fullPath, relativePath });
     } else if (entry.isFile()) {
-      const stat4 = await import_fs3.promises.stat(fullPath);
-      if (stat4.size > maxFileSize) {
+      const stat5 = await import_fs3.promises.stat(fullPath);
+      if (stat5.size > maxFileSize) {
         skipped.push({ path: relativePath, reason: "too_large" });
         continue;
       }
@@ -3480,7 +3401,7 @@ async function* walkDirectory(dir, projectRoot, includePatterns, excludePatterns
         }
       }
       if (matched) {
-        filesInDir.push({ path: fullPath, size: stat4.size });
+        filesInDir.push({ path: fullPath, size: stat5.size });
       }
     }
   }
@@ -3537,8 +3458,8 @@ async function collectFiles(projectRoot, includePatterns, excludePatterns, maxFi
     }
     for (const resolvedKbRoot of normalizedRoots) {
       try {
-        const stat4 = await import_fs3.promises.stat(resolvedKbRoot);
-        if (!stat4.isDirectory()) {
+        const stat5 = await import_fs3.promises.stat(resolvedKbRoot);
+        if (!stat5.isDirectory()) {
           skipped.push({ path: resolvedKbRoot, reason: "excluded" });
           continue;
         }
@@ -4865,11 +4786,11 @@ function resolveGitDir(repoRoot) {
     return null;
   }
   try {
-    const stat4 = (0, import_fs5.statSync)(gitPath);
-    if (stat4.isDirectory()) {
+    const stat5 = (0, import_fs5.statSync)(gitPath);
+    if (stat5.isDirectory()) {
       return gitPath;
     }
-    if (stat4.isFile()) {
+    if (stat5.isFile()) {
       const content = (0, import_fs5.readFileSync)(gitPath, "utf-8").trim();
       const match = content.match(/^gitdir:\s*(.+)$/);
       if (match) {
@@ -5374,8 +5295,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;
@@ -5933,11 +5854,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);
@@ -6274,7 +6195,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);
@@ -6681,7 +6602,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);
@@ -8583,7 +8505,6 @@ var Indexer = class _Indexer {
   database = null;
   provider = null;
   configuredProviderInfo = null;
-  reranker = null;
   fileHashCache = /* @__PURE__ */ new Map();
   fileHashCachePath = "";
   failedBatchesPath = "";
@@ -8743,7 +8664,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 = [];
@@ -9473,7 +9393,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(
@@ -10040,15 +9960,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`;
@@ -11453,6 +11364,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,
@@ -11489,7 +11401,7 @@ var Indexer = class _Indexer {
     const semanticCandidates = embedding ? this.searchSemanticCandidates(
       store,
       embedding,
-      maxResults * 4,
+      candidateLimit,
       branchChunkIds,
       shouldPrefilterByBranch
     ) : [];
@@ -11497,7 +11409,7 @@ var Indexer = class _Indexer {
     const keywordStartTime = import_perf_hooks.performance.now();
     const keywordCandidates = await this.keywordSearch(
       query,
-      maxResults * 4,
+      candidateLimit,
       store,
       invertedIndex,
       branchChunkIds,
@@ -12255,9 +12167,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));
@@ -12305,13 +12217,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,
@@ -12321,9 +12233,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));
@@ -12659,7 +12571,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";
@@ -12973,8 +12884,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));
@@ -13628,7 +13539,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,
@@ -13638,7 +13549,7 @@ function runCommand(file, args, options) {
           reject(error);
           return;
         }
-        resolve18(stdout);
+        resolve20(stdout);
       }
     );
   });
@@ -13783,10 +13694,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 = () => {
@@ -13798,15 +13709,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);
     });
   });
 }
@@ -14188,17 +14099,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() {
@@ -14206,9 +14117,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;
@@ -14883,12 +14794,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);
@@ -15513,7 +15424,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,
@@ -15522,25 +15433,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",
@@ -16017,9 +15928,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
       });
@@ -16516,68 +16427,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 } : {},
@@ -16588,50 +16499,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 } : {},
@@ -16639,27 +16550,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,
@@ -16667,9 +16578,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;
@@ -16680,29 +16591,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,
@@ -16716,13 +16627,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;
@@ -16734,21 +16645,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) {
@@ -17715,7 +17626,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,
@@ -17724,7 +17635,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);
@@ -18303,7 +18214,7 @@ var ReaddirpStream = class extends import_node_stream.Readable {
     this._directoryFilter = normalizeFilter(opts.directoryFilter);
     const statMethod = opts.lstat ? import_promises.lstat : import_promises.stat;
     if (wantBigintFsStats) {
-      this._stat = (path31) => statMethod(path31, { bigint: true });
+      this._stat = (path33) => statMethod(path33, { bigint: true });
     } else {
       this._stat = statMethod;
     }
@@ -18328,8 +18239,8 @@ var ReaddirpStream = class extends import_node_stream.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)
@@ -18369,20 +18280,20 @@ var ReaddirpStream = class extends import_node_stream.Readable {
       this.reading = false;
     }
   }
-  async _exploreDir(path31, depth) {
+  async _exploreDir(path33, depth) {
     let files;
     try {
-      files = await (0, import_promises.readdir)(path31, this._rdOptions);
+      files = await (0, import_promises.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 = (0, import_node_path.resolve)((0, import_node_path.join)(path31, basename8));
+      const fullPath = (0, import_node_path.resolve)((0, import_node_path.join)(path33, basename8));
       entry = { path: (0, import_node_path.relative)(this._root, fullPath), fullPath, basename: basename8 };
       entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
     } catch (err) {
@@ -18782,16 +18693,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 (0, import_node_fs.watch)(path31, {
+    return (0, import_node_fs.watch)(path33, {
       persistent: options.persistent
     }, handleEvent);
   } catch (error) {
@@ -18807,12 +18718,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);
@@ -18823,7 +18734,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,
@@ -18838,7 +18749,7 @@ var setFsWatchListener = (path31, fullPath, options, handlers) => {
         cont.watcherUnusable = true;
       if (isWindows && error.code === "EPERM") {
         try {
-          const fd = await (0, import_promises2.open)(path31, "r");
+          const fd = await (0, import_promises2.open)(path33, "r");
           await fd.close();
           broadcastErr(error);
         } catch (err) {
@@ -18869,7 +18780,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;
@@ -18891,7 +18802,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));
         }
       })
     };
@@ -18921,13 +18832,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
     };
@@ -18937,12 +18848,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
@@ -18964,7 +18875,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) {
@@ -18978,11 +18889,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;
           }
@@ -19014,7 +18925,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;
     }
@@ -19024,7 +18935,7 @@ var NodeFsHandler = class {
       this.fsw._incrReadyCount();
       let linkPath;
       try {
-        linkPath = await (0, import_promises2.realpath)(path31);
+        linkPath = await (0, import_promises2.realpath)(path33);
       } catch (e) {
         this.fsw._emitReady();
         return true;
@@ -19034,12 +18945,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;
@@ -19069,9 +18980,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) {
@@ -19080,11 +18991,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, () => {
@@ -19093,7 +19004,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) => {
@@ -19150,13 +19061,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);
@@ -19172,8 +19083,8 @@ var NodeFsHandler = class {
       const follow = this.fsw.options.followSymlinks;
       let closer;
       if (stats.isDirectory()) {
-        const absPath = sp.resolve(path31);
-        const targetPath = follow ? await (0, import_promises2.realpath)(path31) : path31;
+        const absPath = sp.resolve(path33);
+        const targetPath = follow ? await (0, import_promises2.realpath)(path33) : path33;
         if (this.fsw.closed)
           return;
         closer = await this._handleDir(wh.watchPath, stats, initialAdd, depth, target, wh, targetPath);
@@ -19183,29 +19094,29 @@ var NodeFsHandler = class {
           this.fsw._symlinkPaths.set(absPath, targetPath);
         }
       } else if (stats.isSymbolicLink()) {
-        const targetPath = follow ? await (0, import_promises2.realpath)(path31) : path31;
+        const targetPath = follow ? await (0, import_promises2.realpath)(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;
       }
     }
   }
@@ -19237,35 +19148,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;
     }
   }
@@ -19303,19 +19214,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 {
@@ -19380,10 +19291,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 = [];
@@ -19523,20 +19434,20 @@ var FSWatcher = class extends import_node_events.EventEmitter {
     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;
@@ -19558,17 +19469,17 @@ var FSWatcher = class extends import_node_events.EventEmitter {
       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
         });
       }
@@ -19632,38 +19543,38 @@ var FSWatcher = class extends import_node_events.EventEmitter {
    * @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) {
@@ -19681,16 +19592,16 @@ var FSWatcher = class extends import_node_events.EventEmitter {
           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 (0, import_promises3.stat)(fullPath);
@@ -19721,23 +19632,23 @@ var FSWatcher = class extends import_node_events.EventEmitter {
    * @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);
@@ -19745,7 +19656,7 @@ var FSWatcher = class extends import_node_events.EventEmitter {
     };
     timeoutObject = setTimeout(clear, timeout);
     const thr = { timeoutObject, clear, count: 0 };
-    action.set(path31, thr);
+    action.set(path33, thr);
     return thr;
   }
   _incrReadyCount() {
@@ -19759,44 +19670,44 @@ var FSWatcher = class extends import_node_events.EventEmitter {
    * @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) {
       (0, import_node_fs2.stat)(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;
         }
@@ -19807,8 +19718,8 @@ var FSWatcher = class extends import_node_events.EventEmitter {
   /**
    * 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;
@@ -19818,17 +19729,17 @@ var FSWatcher = class extends import_node_events.EventEmitter {
       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
   // -----------------
@@ -19860,63 +19771,63 @@ var FSWatcher = class extends import_node_events.EventEmitter {
    * @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);
   }
@@ -19946,12 +19857,291 @@ function watch(paths, options = {}) {
 var chokidar_default = { watch, FSWatcher };
 // src/watcher/file-watcher.ts
+var path28 = __toESM(require("path"), 1);
+// src/watcher/native-recursive-watcher.ts
+var import_node_fs3 = require("fs");
 var path26 = __toESM(require("path"), 1);
+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) => (0, import_node_fs3.watch)(root, options, listener);
+};
+// src/watcher/snapshot.ts
+var fsPromises4 = __toESM(require("fs/promises"), 1);
+var path27 = __toESM(require("path"), 1);
+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;
@@ -19961,44 +20151,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) => (0, import_fs19.existsSync)(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;
@@ -20006,10 +20226,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)) {
@@ -20042,10 +20262,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;
@@ -20059,10 +20282,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;
         }
@@ -20073,13 +20299,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 ((0, import_fs19.existsSync)(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;
@@ -20094,27 +20473,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 (!(0, import_fs19.existsSync)(candidate)) {
-      const parent = path26.dirname(candidate);
+      const parent = path28.dirname(candidate);
       if (parent === candidate) break;
       candidate = parent;
     }
@@ -20122,9 +20507,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 = (0, import_fs19.statSync)(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);
@@ -20138,7 +20565,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 {
@@ -20152,20 +20579,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());
@@ -20173,7 +20611,7 @@ var FileWatcher = class {
 };
 // src/watcher/git-head-watcher.ts
-var path27 = __toESM(require("path"), 1);
+var path29 = __toESM(require("path"), 1);
 var GitHeadWatcher = class {
   watcher = null;
   projectRoot;
@@ -20195,13 +20633,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,
@@ -20337,7 +20775,7 @@ function getConfigPaths(projectRoot, host, options) {
 // src/tools/visualize/activity.ts
 var import_child_process5 = require("child_process");
-var path28 = __toESM(require("path"), 1);
+var path30 = __toESM(require("path"), 1);
 function attachRecentActivity(data, projectRoot) {
   const activity = readGitActivity(projectRoot);
   const changes = activity.size > 0 ? buildGitChanges(data, activity, projectRoot) : buildGraphChanges(data);
@@ -20499,7 +20937,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);
 }
@@ -20757,7 +21195,7 @@ render();
 }
 // src/tools/visualize/transform.ts
-var path29 = __toESM(require("path"), 1);
+var path31 = __toESM(require("path"), 1);
 // src/tools/visualize/modules.ts
 var MAX_MODULES = 18;
@@ -20890,8 +21328,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);
   }
@@ -21017,7 +21455,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: ""
   }));
@@ -21045,9 +21483,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") {
@@ -21074,7 +21512,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=")) {
@@ -21085,7 +21523,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=")) {
@@ -21151,7 +21589,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=")) {
@@ -21188,7 +21626,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`);
     (0, import_fs20.writeFileSync)(outputPath, generateVisualizationHtml(vizData), "utf-8");
     console.log(`Temporal call graph visualization generated: ${outputPath}`);
     console.log(`Nodes: ${vizData.nodes.length} | Edges: ${vizData.edges.length}`);
@@ -21220,8 +21658,60 @@ async function runMcpCli(argv) {
   const config = parseConfig(rawConfig);
   const server = createMcpServer(args.project, config, args.host);
   const transport = new import_stdio.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) {
@@ -21233,26 +21723,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(" ");