opencode-codebase-index 0.1.8 → 0.1.11

package/dist/index.js

@@ -491,7 +491,7 @@ var require_ignore = __commonJS({
       //   path matching.
       // - check `string` either `MODE_IGNORE` or `MODE_CHECK_IGNORE`
       // @returns {TestResult} true if a file is ignored
-      test(path9, checkUnignored, mode) {
+      test(path7, checkUnignored, mode) {
         let ignored = false;
         let unignored = false;
         let matchedRule;
@@ -500,7 +500,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule[mode].test(path9);
+          const matched = rule[mode].test(path7);
           if (!matched) {
             return;
           }
@@ -521,17 +521,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path9, originalPath, doThrow) => {
-      if (!isString(path9)) {
+    var checkPath = (path7, originalPath, doThrow) => {
+      if (!isString(path7)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path9) {
+      if (!path7) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path9)) {
+      if (checkPath.isNotRelative(path7)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -540,7 +540,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path9) => REGEX_TEST_INVALID_PATH.test(path9);
+    var isNotRelative = (path7) => REGEX_TEST_INVALID_PATH.test(path7);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore2 = class {
@@ -570,19 +570,19 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
-        const path9 = originalPath && checkPath.convert(originalPath);
+        const path7 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path9,
+          path7,
           originalPath,
           this._strictPathCheck ? throwError : RETURN_FALSE
         );
-        return this._t(path9, cache, checkUnignored, slices);
+        return this._t(path7, cache, checkUnignored, slices);
       }
-      checkIgnore(path9) {
-        if (!REGEX_TEST_TRAILING_SLASH.test(path9)) {
-          return this.test(path9);
+      checkIgnore(path7) {
+        if (!REGEX_TEST_TRAILING_SLASH.test(path7)) {
+          return this.test(path7);
         }
-        const slices = path9.split(SLASH2).filter(Boolean);
+        const slices = path7.split(SLASH2).filter(Boolean);
         slices.pop();
         if (slices.length) {
           const parent = this._t(
@@ -595,18 +595,18 @@ var require_ignore = __commonJS({
             return parent;
           }
         }
-        return this._rules.test(path9, false, MODE_CHECK_IGNORE);
+        return this._rules.test(path7, false, MODE_CHECK_IGNORE);
       }
-      _t(path9, cache, checkUnignored, slices) {
-        if (path9 in cache) {
-          return cache[path9];
+      _t(path7, cache, checkUnignored, slices) {
+        if (path7 in cache) {
+          return cache[path7];
         }
         if (!slices) {
-          slices = path9.split(SLASH2).filter(Boolean);
+          slices = path7.split(SLASH2).filter(Boolean);
         }
         slices.pop();
         if (!slices.length) {
-          return cache[path9] = this._rules.test(path9, checkUnignored, MODE_IGNORE);
+          return cache[path7] = this._rules.test(path7, checkUnignored, MODE_IGNORE);
         }
         const parent = this._t(
           slices.join(SLASH2) + SLASH2,
@@ -614,29 +614,29 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache[path9] = parent.ignored ? parent : this._rules.test(path9, checkUnignored, MODE_IGNORE);
+        return cache[path7] = parent.ignored ? parent : this._rules.test(path7, checkUnignored, MODE_IGNORE);
       }
-      ignores(path9) {
-        return this._test(path9, this._ignoreCache, false).ignored;
+      ignores(path7) {
+        return this._test(path7, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path9) => !this.ignores(path9);
+        return (path7) => !this.ignores(path7);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path9) {
-        return this._test(path9, this._testCache, true);
+      test(path7) {
+        return this._test(path7, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore2(options);
-    var isPathValid = (path9) => checkPath(path9 && checkPath.convert(path9), path9, RETURN_FALSE);
+    var isPathValid = (path7) => checkPath(path7 && checkPath.convert(path7), path7, 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 = (path9) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path9) || isNotRelative(path9);
+      checkPath.isNotRelative = (path7) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path7) || isNotRelative(path7);
     };
     if (
       // Detect `process` so that it can run in browsers.
@@ -652,8 +652,8 @@ var require_ignore = __commonJS({
 });
 
 // src/index.ts
-import { existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
-import * as path8 from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import * as path6 from "path";
 
 // src/config/schema.ts
 var DEFAULT_INCLUDE = [
@@ -688,6 +688,8 @@ function getDefaultIndexingConfig() {
     autoIndex: false,
     watchFiles: true,
     maxFileSize: 1048576,
+    maxChunksPerFile: 100,
+    semanticOnly: false,
     retries: 3,
     retryDelayMs: 1e3
   };
@@ -721,6 +723,8 @@ function parseConfig(raw) {
     autoIndex: typeof rawIndexing.autoIndex === "boolean" ? rawIndexing.autoIndex : defaultIndexing.autoIndex,
     watchFiles: typeof rawIndexing.watchFiles === "boolean" ? rawIndexing.watchFiles : defaultIndexing.watchFiles,
     maxFileSize: typeof rawIndexing.maxFileSize === "number" ? rawIndexing.maxFileSize : defaultIndexing.maxFileSize,
+    maxChunksPerFile: typeof rawIndexing.maxChunksPerFile === "number" ? Math.max(1, rawIndexing.maxChunksPerFile) : defaultIndexing.maxChunksPerFile,
+    semanticOnly: typeof rawIndexing.semanticOnly === "boolean" ? rawIndexing.semanticOnly : defaultIndexing.semanticOnly,
     retries: typeof rawIndexing.retries === "number" ? rawIndexing.retries : defaultIndexing.retries,
     retryDelayMs: typeof rawIndexing.retryDelayMs === "number" ? rawIndexing.retryDelayMs : defaultIndexing.retryDelayMs
   };
@@ -802,8 +806,8 @@ function getDefaultModelForProvider(provider) {
 }
 
 // src/indexer/index.ts
-import { existsSync as existsSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync3, promises as fsPromises2 } from "fs";
-import * as path6 from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync, promises as fsPromises2 } from "fs";
+import * as path4 from "path";
 
 // node_modules/eventemitter3/index.mjs
 var import_index = __toESM(require_eventemitter3(), 1);
@@ -1874,7 +1878,7 @@ function getGitHubCopilotCredentials() {
   if (!copilotAuth || copilotAuth.type !== "oauth") {
     return null;
   }
-  const baseUrl = copilotAuth.enterpriseUrl ? `https://copilot-api.${copilotAuth.enterpriseUrl.replace(/^https?:\/\//, "").replace(/\/$/, "")}` : "https://api.githubcopilot.com";
+  const baseUrl = copilotAuth.enterpriseUrl ? `https://copilot-api.${copilotAuth.enterpriseUrl.replace(/^https?:\/\//, "").replace(/\/$/, "")}` : "https://models.github.ai";
   return {
     provider: "github-copilot",
     baseUrl,
@@ -1949,9 +1953,6 @@ function getProviderDisplayName(provider) {
 }
 
 // src/embeddings/provider.ts
-import { readFileSync as readFileSync2, writeFileSync } from "fs";
-import * as path2 from "path";
-import * as os2 from "os";
 function createEmbeddingProvider(credentials, modelInfo) {
   switch (credentials.provider) {
     case "github-copilot":
@@ -1966,56 +1967,16 @@ function createEmbeddingProvider(credentials, modelInfo) {
       throw new Error(`Unsupported embedding provider: ${credentials.provider}`);
   }
 }
-var COPILOT_HEADERS = {
-  "User-Agent": "GitHubCopilotChat/0.35.0",
-  "Editor-Version": "vscode/1.107.0",
-  "Editor-Plugin-Version": "copilot-chat/0.35.0",
-  "Copilot-Integration-Id": "vscode-chat",
-  "Openai-Intent": "conversation-edits"
-};
 var GitHubCopilotEmbeddingProvider = class {
   constructor(credentials, modelInfo) {
     this.credentials = credentials;
     this.modelInfo = modelInfo;
-    this.accessToken = credentials.accessToken || "";
-    this.tokenExpires = credentials.tokenExpires || 0;
   }
-  accessToken;
-  tokenExpires;
-  async ensureValidToken() {
-    if (this.accessToken && this.tokenExpires > Date.now()) {
-      return this.accessToken;
-    }
+  getToken() {
     if (!this.credentials.refreshToken) {
-      throw new Error("No refresh token available for GitHub Copilot");
-    }
-    const response = await fetch("https://api.github.com/copilot_internal/v2/token", {
-      headers: {
-        Accept: "application/json",
-        Authorization: `Bearer ${this.credentials.refreshToken}`,
-        ...COPILOT_HEADERS
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`Token refresh failed: ${response.status}`);
-    }
-    const tokenData = await response.json();
-    this.accessToken = tokenData.token;
-    this.tokenExpires = tokenData.expires_at * 1e3 - 5 * 60 * 1e3;
-    this.persistToken(tokenData.token, this.tokenExpires);
-    return this.accessToken;
-  }
-  persistToken(token, expires) {
-    try {
-      const authPath = path2.join(os2.homedir(), ".local", "share", "opencode", "auth.json");
-      const authData = JSON.parse(readFileSync2(authPath, "utf-8"));
-      if (authData["github-copilot"]) {
-        authData["github-copilot"].access = token;
-        authData["github-copilot"].expires = expires;
-        writeFileSync(authPath, JSON.stringify(authData, null, 2));
-      }
-    } catch {
+      throw new Error("No OAuth token available for GitHub");
     }
+    return this.credentials.refreshToken;
   }
   async embed(text) {
     const result = await this.embedBatch([text]);
@@ -2025,16 +1986,17 @@ var GitHubCopilotEmbeddingProvider = class {
     };
   }
   async embedBatch(texts) {
-    const token = await this.ensureValidToken();
-    const response = await fetch(`${this.credentials.baseUrl}/embeddings`, {
+    const token = this.getToken();
+    const response = await fetch(`${this.credentials.baseUrl}/inference/embeddings`, {
       method: "POST",
       headers: {
         Authorization: `Bearer ${token}`,
         "Content-Type": "application/json",
-        ...COPILOT_HEADERS
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28"
       },
       body: JSON.stringify({
-        model: this.modelInfo.model,
+        model: `openai/${this.modelInfo.model}`,
         input: texts
       })
     });
@@ -2183,8 +2145,8 @@ var OllamaEmbeddingProvider = class {
 
 // src/utils/files.ts
 var import_ignore = __toESM(require_ignore(), 1);
-import { existsSync as existsSync2, readFileSync as readFileSync3, promises as fsPromises } from "fs";
-import * as path3 from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync2, promises as fsPromises } from "fs";
+import * as path2 from "path";
 function createIgnoreFilter(projectRoot) {
   const ig = (0, import_ignore.default)();
   const defaultIgnores = [
@@ -2201,15 +2163,15 @@ function createIgnoreFilter(projectRoot) {
     ".opencode"
   ];
   ig.add(defaultIgnores);
-  const gitignorePath = path3.join(projectRoot, ".gitignore");
+  const gitignorePath = path2.join(projectRoot, ".gitignore");
   if (existsSync2(gitignorePath)) {
-    const gitignoreContent = readFileSync3(gitignorePath, "utf-8");
+    const gitignoreContent = readFileSync2(gitignorePath, "utf-8");
     ig.add(gitignoreContent);
   }
   return ig;
 }
 function shouldIncludeFile(filePath, projectRoot, includePatterns, excludePatterns, ignoreFilter) {
-  const relativePath = path3.relative(projectRoot, filePath);
+  const relativePath = path2.relative(projectRoot, filePath);
   if (ignoreFilter.ignores(relativePath)) {
     return false;
   }
@@ -2233,8 +2195,8 @@ function matchGlob(filePath, pattern) {
 async function* walkDirectory(dir, projectRoot, includePatterns, excludePatterns, ignoreFilter, maxFileSize, skipped) {
   const entries = await fsPromises.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = path3.join(dir, entry.name);
-    const relativePath = path3.relative(projectRoot, fullPath);
+    const fullPath = path2.join(dir, entry.name);
+    const relativePath = path2.relative(projectRoot, fullPath);
     if (ignoreFilter.ignores(relativePath)) {
       if (entry.isFile()) {
         skipped.push({ path: relativePath, reason: "gitignore" });
@@ -2357,12 +2319,12 @@ function padRight(str, length) {
 }
 
 // src/native/index.ts
-import * as path4 from "path";
-import * as os3 from "os";
+import * as path3 from "path";
+import * as os2 from "os";
 import { fileURLToPath } from "url";
 function getNativeBinding() {
-  const platform2 = os3.platform();
-  const arch2 = os3.arch();
+  const platform2 = os2.platform();
+  const arch2 = os2.arch();
   let bindingName;
   if (platform2 === "darwin" && arch2 === "arm64") {
     bindingName = "codebase-index-native.darwin-arm64.node";
@@ -2379,15 +2341,15 @@ function getNativeBinding() {
   }
   let currentDir;
   if (typeof import.meta !== "undefined" && import.meta.url) {
-    currentDir = path4.dirname(fileURLToPath(import.meta.url));
+    currentDir = path3.dirname(fileURLToPath(import.meta.url));
   } else if (typeof __dirname !== "undefined") {
     currentDir = __dirname;
   } else {
     currentDir = process.cwd();
   }
   const isDevMode = currentDir.includes("/src/native");
-  const packageRoot = isDevMode ? path4.resolve(currentDir, "../..") : path4.resolve(currentDir, "..");
-  const nativePath = path4.join(packageRoot, "native", bindingName);
+  const packageRoot = isDevMode ? path3.resolve(currentDir, "../..") : path3.resolve(currentDir, "..");
+  const nativePath = path3.join(packageRoot, "native", bindingName);
   return __require(nativePath);
 }
 var native = getNativeBinding();
@@ -2662,139 +2624,39 @@ function generateChunkId(filePath, chunk) {
 function generateChunkHash(chunk) {
   return hashContent(chunk.content);
 }
-
-// src/indexer/inverted-index.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
-import * as path5 from "path";
 var InvertedIndex = class {
-  indexPath;
-  termToChunks = /* @__PURE__ */ new Map();
-  chunkTokens = /* @__PURE__ */ new Map();
-  totalTokenCount = 0;
+  inner;
   constructor(indexPath) {
-    this.indexPath = path5.join(indexPath, "inverted-index.json");
+    this.inner = new native.InvertedIndex(indexPath);
   }
   load() {
-    if (!existsSync3(this.indexPath)) {
-      return;
-    }
-    try {
-      const content = readFileSync4(this.indexPath, "utf-8");
-      const data = JSON.parse(content);
-      for (const [term, chunkIds] of Object.entries(data.termToChunks)) {
-        this.termToChunks.set(term, new Set(chunkIds));
-      }
-      for (const [chunkId, tokens] of Object.entries(data.chunkTokens)) {
-        const tokenMap = new Map(Object.entries(tokens).map(([k, v]) => [k, v]));
-        this.chunkTokens.set(chunkId, tokenMap);
-        for (const count of tokenMap.values()) {
-          this.totalTokenCount += count;
-        }
-      }
-    } catch {
-      this.termToChunks.clear();
-      this.chunkTokens.clear();
-      this.totalTokenCount = 0;
-    }
+    this.inner.load();
   }
   save() {
-    const data = {
-      termToChunks: {},
-      chunkTokens: {},
-      avgDocLength: this.getAvgDocLength()
-    };
-    for (const [term, chunkIds] of this.termToChunks) {
-      data.termToChunks[term] = Array.from(chunkIds);
-    }
-    for (const [chunkId, tokens] of this.chunkTokens) {
-      data.chunkTokens[chunkId] = Object.fromEntries(tokens);
-    }
-    writeFileSync2(this.indexPath, JSON.stringify(data));
+    this.inner.save();
   }
   addChunk(chunkId, content) {
-    const tokens = this.tokenize(content);
-    const termFreq = /* @__PURE__ */ new Map();
-    for (const token of tokens) {
-      termFreq.set(token, (termFreq.get(token) || 0) + 1);
-      const chunks = this.termToChunks.get(token) || /* @__PURE__ */ new Set();
-      chunks.add(chunkId);
-      this.termToChunks.set(token, chunks);
-    }
-    this.chunkTokens.set(chunkId, termFreq);
-    this.totalTokenCount += tokens.length;
+    this.inner.addChunk(chunkId, content);
   }
   removeChunk(chunkId) {
-    const tokens = this.chunkTokens.get(chunkId);
-    if (!tokens) return;
-    for (const [token, count] of tokens) {
-      this.totalTokenCount -= count;
-      const chunks = this.termToChunks.get(token);
-      if (chunks) {
-        chunks.delete(chunkId);
-        if (chunks.size === 0) {
-          this.termToChunks.delete(token);
-        }
-      }
-    }
-    this.chunkTokens.delete(chunkId);
+    return this.inner.removeChunk(chunkId);
   }
-  search(query) {
-    const queryTokens = this.tokenize(query);
-    if (queryTokens.length === 0) {
-      return /* @__PURE__ */ new Map();
-    }
-    const candidateChunks = /* @__PURE__ */ new Set();
-    for (const token of queryTokens) {
-      const chunks = this.termToChunks.get(token);
-      if (chunks) {
-        for (const chunkId of chunks) {
-          candidateChunks.add(chunkId);
-        }
-      }
-    }
-    const scores = /* @__PURE__ */ new Map();
-    const k1 = 1.2;
-    const b = 0.75;
-    const N = this.chunkTokens.size;
-    const avgDocLength = this.getAvgDocLength();
-    for (const chunkId of candidateChunks) {
-      const termFreq = this.chunkTokens.get(chunkId);
-      if (!termFreq) continue;
-      const docLength = Array.from(termFreq.values()).reduce((a, b2) => a + b2, 0);
-      let score = 0;
-      for (const term of queryTokens) {
-        const tf = termFreq.get(term) || 0;
-        if (tf === 0) continue;
-        const df = this.termToChunks.get(term)?.size || 0;
-        const idf = Math.log((N - df + 0.5) / (df + 0.5) + 1);
-        const tfNorm = tf * (k1 + 1) / (tf + k1 * (1 - b + b * (docLength / avgDocLength)));
-        score += idf * tfNorm;
-      }
-      scores.set(chunkId, score);
-    }
-    const maxScore = Math.max(...scores.values(), 1);
-    for (const [chunkId, score] of scores) {
-      scores.set(chunkId, score / maxScore);
+  search(query, limit) {
+    const results = this.inner.search(query, limit ?? 100);
+    const map = /* @__PURE__ */ new Map();
+    for (const r of results) {
+      map.set(r.chunkId, r.score);
     }
-    return scores;
+    return map;
   }
   hasChunk(chunkId) {
-    return this.chunkTokens.has(chunkId);
+    return this.inner.hasChunk(chunkId);
   }
   clear() {
-    this.termToChunks.clear();
-    this.chunkTokens.clear();
-    this.totalTokenCount = 0;
+    this.inner.clear();
   }
   getDocumentCount() {
-    return this.chunkTokens.size;
-  }
-  getAvgDocLength() {
-    const count = this.chunkTokens.size;
-    return count > 0 ? this.totalTokenCount / count : 100;
-  }
-  tokenize(text) {
-    return text.toLowerCase().replace(/[^\w\s]/g, " ").split(/\s+/).filter((t) => t.length > 2);
+    return this.inner.documentCount();
   }
 };
 
@@ -2809,23 +2671,25 @@ var Indexer = class {
   detectedProvider = null;
   fileHashCache = /* @__PURE__ */ new Map();
   fileHashCachePath = "";
+  failedBatchesPath = "";
   constructor(projectRoot, config) {
     this.projectRoot = projectRoot;
     this.config = config;
     this.indexPath = this.getIndexPath();
-    this.fileHashCachePath = path6.join(this.indexPath, "file-hashes.json");
+    this.fileHashCachePath = path4.join(this.indexPath, "file-hashes.json");
+    this.failedBatchesPath = path4.join(this.indexPath, "failed-batches.json");
   }
   getIndexPath() {
     if (this.config.scope === "global") {
       const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-      return path6.join(homeDir, ".opencode", "global-index");
+      return path4.join(homeDir, ".opencode", "global-index");
     }
-    return path6.join(this.projectRoot, ".opencode", "index");
+    return path4.join(this.projectRoot, ".opencode", "index");
   }
   loadFileHashCache() {
     try {
-      if (existsSync4(this.fileHashCachePath)) {
-        const data = readFileSync5(this.fileHashCachePath, "utf-8");
+      if (existsSync3(this.fileHashCachePath)) {
+        const data = readFileSync3(this.fileHashCachePath, "utf-8");
         const parsed = JSON.parse(data);
         this.fileHashCache = new Map(Object.entries(parsed));
       }
@@ -2838,7 +2702,38 @@ var Indexer = class {
     for (const [k, v] of this.fileHashCache) {
       obj[k] = v;
     }
-    writeFileSync3(this.fileHashCachePath, JSON.stringify(obj));
+    writeFileSync(this.fileHashCachePath, JSON.stringify(obj));
+  }
+  loadFailedBatches() {
+    try {
+      if (existsSync3(this.failedBatchesPath)) {
+        const data = readFileSync3(this.failedBatchesPath, "utf-8");
+        return JSON.parse(data);
+      }
+    } catch {
+      return [];
+    }
+    return [];
+  }
+  saveFailedBatches(batches) {
+    if (batches.length === 0) {
+      if (existsSync3(this.failedBatchesPath)) {
+        fsPromises2.unlink(this.failedBatchesPath).catch(() => {
+        });
+      }
+      return;
+    }
+    writeFileSync(this.failedBatchesPath, JSON.stringify(batches, null, 2));
+  }
+  addFailedBatch(batch, error) {
+    const existing = this.loadFailedBatches();
+    existing.push({
+      chunks: batch,
+      error,
+      attemptCount: 1,
+      lastAttempt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    this.saveFailedBatches(existing);
   }
   async initialize() {
     this.detectedProvider = await detectEmbeddingProvider(this.config.embeddingProvider);
@@ -2853,13 +2748,14 @@ var Indexer = class {
     );
     await fsPromises2.mkdir(this.indexPath, { recursive: true });
     const dimensions = this.detectedProvider.modelInfo.dimensions;
-    const storePath = path6.join(this.indexPath, "vectors");
+    const storePath = path4.join(this.indexPath, "vectors");
     this.store = new VectorStore(storePath, dimensions);
-    const indexFilePath = path6.join(this.indexPath, "vectors.usearch");
-    if (existsSync4(indexFilePath)) {
+    const indexFilePath = path4.join(this.indexPath, "vectors.usearch");
+    if (existsSync3(indexFilePath)) {
       this.store.load();
     }
-    this.invertedIndex = new InvertedIndex(this.indexPath);
+    const invertedIndexPath = path4.join(this.indexPath, "inverted-index.json");
+    this.invertedIndex = new InvertedIndex(invertedIndexPath);
     this.invertedIndex.load();
   }
   async ensureInitialized() {
@@ -2958,14 +2854,22 @@ var Indexer = class {
     for (const parsed of parsedFiles) {
       currentFilePaths.add(parsed.path);
       if (parsed.chunks.length === 0) {
-        const relativePath = path6.relative(this.projectRoot, parsed.path);
+        const relativePath = path4.relative(this.projectRoot, parsed.path);
         stats.parseFailures.push(relativePath);
       }
+      let fileChunkCount = 0;
       for (const chunk of parsed.chunks) {
+        if (fileChunkCount >= this.config.indexing.maxChunksPerFile) {
+          break;
+        }
+        if (this.config.indexing.semanticOnly && chunk.chunkType === "other") {
+          continue;
+        }
         const id = generateChunkId(parsed.path, chunk);
         const contentHash = generateChunkHash(chunk);
         currentChunkIds.add(id);
         if (existingChunks.get(id) === contentHash) {
+          fileChunkCount++;
           continue;
         }
         const text = createEmbeddingText(chunk, parsed.path);
@@ -2979,6 +2883,7 @@ var Indexer = class {
           hash: contentHash
         };
         pendingChunks.push({ id, text, content: chunk.content, metadata });
+        fileChunkCount++;
       }
     }
     let removedCount = 0;
@@ -3068,6 +2973,7 @@ var Indexer = class {
           });
         } catch (error) {
           stats.failedChunks += batch.length;
+          this.addFailedBatch(batch, String(error));
           console.error(`Failed to embed batch after retries: ${error}`);
         }
       });
@@ -3085,6 +2991,9 @@ var Indexer = class {
     this.fileHashCache = currentFileHashes;
     this.saveFileHashCache();
     stats.durationMs = Date.now() - startTime;
+    if (stats.failedChunks > 0) {
+      stats.failedBatchesPath = this.failedBatchesPath;
+    }
     onProgress?.({
       phase: "complete",
       filesProcessed: files.length,
@@ -3230,7 +3139,7 @@ var Indexer = class {
     const removedFilePaths = [];
     let removedCount = 0;
     for (const [filePath, chunkKeys] of filePathsToChunkKeys) {
-      if (!existsSync4(filePath)) {
+      if (!existsSync3(filePath)) {
         for (const key of chunkKeys) {
           store.remove(key);
           invertedIndex.removeChunk(key);
@@ -3245,6 +3154,58 @@ var Indexer = class {
     }
     return { removed: removedCount, filePaths: removedFilePaths };
   }
+  async retryFailedBatches() {
+    const { store, provider, invertedIndex } = await this.ensureInitialized();
+    const failedBatches = this.loadFailedBatches();
+    if (failedBatches.length === 0) {
+      return { succeeded: 0, failed: 0, remaining: 0 };
+    }
+    let succeeded = 0;
+    let failed = 0;
+    const stillFailing = [];
+    for (const batch of failedBatches) {
+      try {
+        const result = await pRetry(
+          async () => {
+            const texts = batch.chunks.map((c) => c.text);
+            return provider.embedBatch(texts);
+          },
+          {
+            retries: this.config.indexing.retries,
+            minTimeout: this.config.indexing.retryDelayMs
+          }
+        );
+        const items = batch.chunks.map((chunk, idx) => ({
+          id: chunk.id,
+          vector: result.embeddings[idx],
+          metadata: chunk.metadata
+        }));
+        store.addBatch(items);
+        for (const chunk of batch.chunks) {
+          invertedIndex.removeChunk(chunk.id);
+          invertedIndex.addChunk(chunk.id, chunk.content);
+        }
+        succeeded += batch.chunks.length;
+      } catch (error) {
+        failed += batch.chunks.length;
+        stillFailing.push({
+          ...batch,
+          attemptCount: batch.attemptCount + 1,
+          lastAttempt: (/* @__PURE__ */ new Date()).toISOString(),
+          error: String(error)
+        });
+      }
+    }
+    this.saveFailedBatches(stillFailing);
+    if (succeeded > 0) {
+      store.save();
+      invertedIndex.save();
+    }
+    return { succeeded, failed, remaining: stillFailing.length };
+  }
+  getFailedBatchesCount() {
+    return this.loadFailedBatches().length;
+  }
 };
 
 // node_modules/chokidar/index.js
@@ -3337,7 +3298,7 @@ var ReaddirpStream = class extends Readable {
     this._directoryFilter = normalizeFilter(opts.directoryFilter);
     const statMethod = opts.lstat ? lstat : stat;
     if (wantBigintFsStats) {
-      this._stat = (path9) => statMethod(path9, { bigint: true });
+      this._stat = (path7) => statMethod(path7, { bigint: true });
     } else {
       this._stat = statMethod;
     }
@@ -3362,8 +3323,8 @@ var ReaddirpStream = class extends Readable {
         const par = this.parent;
         const fil = par && par.files;
         if (fil && fil.length > 0) {
-          const { path: path9, depth } = par;
-          const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path9));
+          const { path: path7, depth } = par;
+          const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path7));
           const awaited = await Promise.all(slice);
           for (const entry of awaited) {
             if (!entry)
@@ -3403,20 +3364,20 @@ var ReaddirpStream = class extends Readable {
       this.reading = false;
     }
   }
-  async _exploreDir(path9, depth) {
+  async _exploreDir(path7, depth) {
     let files;
     try {
-      files = await readdir(path9, this._rdOptions);
+      files = await readdir(path7, this._rdOptions);
     } catch (error) {
       this._onError(error);
     }
-    return { files, depth, path: path9 };
+    return { files, depth, path: path7 };
   }
-  async _formatEntry(dirent, path9) {
+  async _formatEntry(dirent, path7) {
     let entry;
     const basename3 = this._isDirent ? dirent.name : dirent;
     try {
-      const fullPath = presolve(pjoin(path9, basename3));
+      const fullPath = presolve(pjoin(path7, basename3));
       entry = { path: prelative(this._root, fullPath), fullPath, basename: basename3 };
       entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
     } catch (err) {
@@ -3816,16 +3777,16 @@ var delFromSet = (main, prop, item) => {
 };
 var isEmptySet = (val) => val instanceof Set ? val.size === 0 : !val;
 var FsWatchInstances = /* @__PURE__ */ new Map();
-function createFsWatchInstance(path9, options, listener, errHandler, emitRaw) {
+function createFsWatchInstance(path7, options, listener, errHandler, emitRaw) {
   const handleEvent = (rawEvent, evPath) => {
-    listener(path9);
-    emitRaw(rawEvent, evPath, { watchedPath: path9 });
-    if (evPath && path9 !== evPath) {
-      fsWatchBroadcast(sp.resolve(path9, evPath), KEY_LISTENERS, sp.join(path9, evPath));
+    listener(path7);
+    emitRaw(rawEvent, evPath, { watchedPath: path7 });
+    if (evPath && path7 !== evPath) {
+      fsWatchBroadcast(sp.resolve(path7, evPath), KEY_LISTENERS, sp.join(path7, evPath));
     }
   };
   try {
-    return fs_watch(path9, {
+    return fs_watch(path7, {
       persistent: options.persistent
     }, handleEvent);
   } catch (error) {
@@ -3841,12 +3802,12 @@ var fsWatchBroadcast = (fullPath, listenerType, val1, val2, val3) => {
     listener(val1, val2, val3);
   });
 };
-var setFsWatchListener = (path9, fullPath, options, handlers) => {
+var setFsWatchListener = (path7, fullPath, options, handlers) => {
   const { listener, errHandler, rawEmitter } = handlers;
   let cont = FsWatchInstances.get(fullPath);
   let watcher;
   if (!options.persistent) {
-    watcher = createFsWatchInstance(path9, options, listener, errHandler, rawEmitter);
+    watcher = createFsWatchInstance(path7, options, listener, errHandler, rawEmitter);
     if (!watcher)
       return;
     return watcher.close.bind(watcher);
@@ -3857,7 +3818,7 @@ var setFsWatchListener = (path9, fullPath, options, handlers) => {
     addAndConvert(cont, KEY_RAW, rawEmitter);
   } else {
     watcher = createFsWatchInstance(
-      path9,
+      path7,
       options,
       fsWatchBroadcast.bind(null, fullPath, KEY_LISTENERS),
       errHandler,
@@ -3872,7 +3833,7 @@ var setFsWatchListener = (path9, fullPath, options, handlers) => {
         cont.watcherUnusable = true;
       if (isWindows && error.code === "EPERM") {
         try {
-          const fd = await open(path9, "r");
+          const fd = await open(path7, "r");
           await fd.close();
           broadcastErr(error);
         } catch (err) {
@@ -3903,7 +3864,7 @@ var setFsWatchListener = (path9, fullPath, options, handlers) => {
   };
 };
 var FsWatchFileInstances = /* @__PURE__ */ new Map();
-var setFsWatchFileListener = (path9, fullPath, options, handlers) => {
+var setFsWatchFileListener = (path7, fullPath, options, handlers) => {
   const { listener, rawEmitter } = handlers;
   let cont = FsWatchFileInstances.get(fullPath);
   const copts = cont && cont.options;
@@ -3925,7 +3886,7 @@ var setFsWatchFileListener = (path9, fullPath, options, handlers) => {
         });
         const currmtime = curr.mtimeMs;
         if (curr.size !== prev.size || currmtime > prev.mtimeMs || currmtime === 0) {
-          foreach(cont.listeners, (listener2) => listener2(path9, curr));
+          foreach(cont.listeners, (listener2) => listener2(path7, curr));
         }
       })
     };
@@ -3955,13 +3916,13 @@ var NodeFsHandler = class {
    * @param listener on fs change
    * @returns closer for the watcher instance
    */
-  _watchWithNodeFs(path9, listener) {
+  _watchWithNodeFs(path7, listener) {
     const opts = this.fsw.options;
-    const directory = sp.dirname(path9);
-    const basename3 = sp.basename(path9);
+    const directory = sp.dirname(path7);
+    const basename3 = sp.basename(path7);
     const parent = this.fsw._getWatchedDir(directory);
     parent.add(basename3);
-    const absolutePath = sp.resolve(path9);
+    const absolutePath = sp.resolve(path7);
     const options = {
       persistent: opts.persistent
     };
@@ -3971,12 +3932,12 @@ var NodeFsHandler = class {
     if (opts.usePolling) {
       const enableBin = opts.interval !== opts.binaryInterval;
       options.interval = enableBin && isBinaryPath(basename3) ? opts.binaryInterval : opts.interval;
-      closer = setFsWatchFileListener(path9, absolutePath, options, {
+      closer = setFsWatchFileListener(path7, absolutePath, options, {
         listener,
         rawEmitter: this.fsw._emitRaw
       });
     } else {
-      closer = setFsWatchListener(path9, absolutePath, options, {
+      closer = setFsWatchListener(path7, absolutePath, options, {
         listener,
         errHandler: this._boundHandleError,
         rawEmitter: this.fsw._emitRaw
@@ -3998,7 +3959,7 @@ var NodeFsHandler = class {
     let prevStats = stats;
     if (parent.has(basename3))
       return;
-    const listener = async (path9, newStats) => {
+    const listener = async (path7, newStats) => {
       if (!this.fsw._throttle(THROTTLE_MODE_WATCH, file, 5))
         return;
       if (!newStats || newStats.mtimeMs === 0) {
@@ -4012,11 +3973,11 @@ var NodeFsHandler = class {
             this.fsw._emit(EV.CHANGE, file, newStats2);
           }
           if ((isMacos || isLinux || isFreeBSD) && prevStats.ino !== newStats2.ino) {
-            this.fsw._closeFile(path9);
+            this.fsw._closeFile(path7);
             prevStats = newStats2;
             const closer2 = this._watchWithNodeFs(file, listener);
             if (closer2)
-              this.fsw._addPathCloser(path9, closer2);
+              this.fsw._addPathCloser(path7, closer2);
           } else {
             prevStats = newStats2;
           }
@@ -4048,7 +4009,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, path9, item) {
+  async _handleSymlink(entry, directory, path7, item) {
     if (this.fsw.closed) {
       return;
     }
@@ -4058,7 +4019,7 @@ var NodeFsHandler = class {
       this.fsw._incrReadyCount();
       let linkPath;
       try {
-        linkPath = await fsrealpath(path9);
+        linkPath = await fsrealpath(path7);
       } catch (e) {
         this.fsw._emitReady();
         return true;
@@ -4068,12 +4029,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, path9, entry.stats);
+          this.fsw._emit(EV.CHANGE, path7, entry.stats);
         }
       } else {
         dir.add(item);
         this.fsw._symlinkPaths.set(full, linkPath);
-        this.fsw._emit(EV.ADD, path9, entry.stats);
+        this.fsw._emit(EV.ADD, path7, entry.stats);
       }
       this.fsw._emitReady();
       return true;
@@ -4103,9 +4064,9 @@ var NodeFsHandler = class {
         return;
       }
       const item = entry.path;
-      let path9 = sp.join(directory, item);
+      let path7 = sp.join(directory, item);
       current.add(item);
-      if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path9, item)) {
+      if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path7, item)) {
         return;
       }
       if (this.fsw.closed) {
@@ -4114,8 +4075,8 @@ var NodeFsHandler = class {
       }
       if (item === target || !target && !previous.has(item)) {
         this.fsw._incrReadyCount();
-        path9 = sp.join(dir, sp.relative(dir, path9));
-        this._addToNodeFs(path9, initialAdd, wh, depth + 1);
+        path7 = sp.join(dir, sp.relative(dir, path7));
+        this._addToNodeFs(path7, initialAdd, wh, depth + 1);
       }
     }).on(EV.ERROR, this._boundHandleError);
     return new Promise((resolve4, reject) => {
@@ -4184,13 +4145,13 @@ var NodeFsHandler = class {
    * @param depth Child path actually targeted for watch
    * @param target Child path actually targeted for watch
    */
-  async _addToNodeFs(path9, initialAdd, priorWh, depth, target) {
+  async _addToNodeFs(path7, initialAdd, priorWh, depth, target) {
     const ready = this.fsw._emitReady;
-    if (this.fsw._isIgnored(path9) || this.fsw.closed) {
+    if (this.fsw._isIgnored(path7) || this.fsw.closed) {
       ready();
       return false;
     }
-    const wh = this.fsw._getWatchHelpers(path9);
+    const wh = this.fsw._getWatchHelpers(path7);
     if (priorWh) {
       wh.filterPath = (entry) => priorWh.filterPath(entry);
       wh.filterDir = (entry) => priorWh.filterDir(entry);
@@ -4206,8 +4167,8 @@ var NodeFsHandler = class {
       const follow = this.fsw.options.followSymlinks;
       let closer;
       if (stats.isDirectory()) {
-        const absPath = sp.resolve(path9);
-        const targetPath = follow ? await fsrealpath(path9) : path9;
+        const absPath = sp.resolve(path7);
+        const targetPath = follow ? await fsrealpath(path7) : path7;
         if (this.fsw.closed)
           return;
         closer = await this._handleDir(wh.watchPath, stats, initialAdd, depth, target, wh, targetPath);
@@ -4217,29 +4178,29 @@ var NodeFsHandler = class {
           this.fsw._symlinkPaths.set(absPath, targetPath);
         }
       } else if (stats.isSymbolicLink()) {
-        const targetPath = follow ? await fsrealpath(path9) : path9;
+        const targetPath = follow ? await fsrealpath(path7) : path7;
         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, path9, wh, targetPath);
+        closer = await this._handleDir(parent, stats, initialAdd, depth, path7, wh, targetPath);
         if (this.fsw.closed)
           return;
         if (targetPath !== void 0) {
-          this.fsw._symlinkPaths.set(sp.resolve(path9), targetPath);
+          this.fsw._symlinkPaths.set(sp.resolve(path7), targetPath);
         }
       } else {
         closer = this._handleFile(wh.watchPath, stats, initialAdd);
       }
       ready();
       if (closer)
-        this.fsw._addPathCloser(path9, closer);
+        this.fsw._addPathCloser(path7, closer);
       return false;
     } catch (error) {
       if (this.fsw._handleError(error)) {
         ready();
-        return path9;
+        return path7;
       }
     }
   }
@@ -4282,24 +4243,24 @@ function createPattern(matcher) {
   }
   return () => false;
 }
-function normalizePath(path9) {
-  if (typeof path9 !== "string")
+function normalizePath(path7) {
+  if (typeof path7 !== "string")
     throw new Error("string expected");
-  path9 = sp2.normalize(path9);
-  path9 = path9.replace(/\\/g, "/");
+  path7 = sp2.normalize(path7);
+  path7 = path7.replace(/\\/g, "/");
   let prepend = false;
-  if (path9.startsWith("//"))
+  if (path7.startsWith("//"))
     prepend = true;
-  path9 = path9.replace(DOUBLE_SLASH_RE, "/");
+  path7 = path7.replace(DOUBLE_SLASH_RE, "/");
   if (prepend)
-    path9 = "/" + path9;
-  return path9;
+    path7 = "/" + path7;
+  return path7;
 }
 function matchPatterns(patterns, testString, stats) {
-  const path9 = normalizePath(testString);
+  const path7 = normalizePath(testString);
   for (let index = 0; index < patterns.length; index++) {
     const pattern = patterns[index];
-    if (pattern(path9, stats)) {
+    if (pattern(path7, stats)) {
       return true;
     }
   }
@@ -4337,19 +4298,19 @@ var toUnix = (string) => {
   }
   return str;
 };
-var normalizePathToUnix = (path9) => toUnix(sp2.normalize(toUnix(path9)));
-var normalizeIgnored = (cwd = "") => (path9) => {
-  if (typeof path9 === "string") {
-    return normalizePathToUnix(sp2.isAbsolute(path9) ? path9 : sp2.join(cwd, path9));
+var normalizePathToUnix = (path7) => toUnix(sp2.normalize(toUnix(path7)));
+var normalizeIgnored = (cwd = "") => (path7) => {
+  if (typeof path7 === "string") {
+    return normalizePathToUnix(sp2.isAbsolute(path7) ? path7 : sp2.join(cwd, path7));
   } else {
-    return path9;
+    return path7;
   }
 };
-var getAbsolutePath = (path9, cwd) => {
-  if (sp2.isAbsolute(path9)) {
-    return path9;
+var getAbsolutePath = (path7, cwd) => {
+  if (sp2.isAbsolute(path7)) {
+    return path7;
   }
-  return sp2.join(cwd, path9);
+  return sp2.join(cwd, path7);
 };
 var EMPTY_SET = Object.freeze(/* @__PURE__ */ new Set());
 var DirEntry = class {
@@ -4414,10 +4375,10 @@ var WatchHelper = class {
   dirParts;
   followSymlinks;
   statMethod;
-  constructor(path9, follow, fsw) {
+  constructor(path7, follow, fsw) {
     this.fsw = fsw;
-    const watchPath = path9;
-    this.path = path9 = path9.replace(REPLACER_RE, "");
+    const watchPath = path7;
+    this.path = path7 = path7.replace(REPLACER_RE, "");
     this.watchPath = watchPath;
     this.fullWatchPath = sp2.resolve(watchPath);
     this.dirParts = [];
@@ -4557,20 +4518,20 @@ var FSWatcher = class extends EventEmitter2 {
     this._closePromise = void 0;
     let paths = unifyPaths(paths_);
     if (cwd) {
-      paths = paths.map((path9) => {
-        const absPath = getAbsolutePath(path9, cwd);
+      paths = paths.map((path7) => {
+        const absPath = getAbsolutePath(path7, cwd);
         return absPath;
       });
     }
-    paths.forEach((path9) => {
-      this._removeIgnoredPath(path9);
+    paths.forEach((path7) => {
+      this._removeIgnoredPath(path7);
     });
     this._userIgnored = void 0;
     if (!this._readyCount)
       this._readyCount = 0;
     this._readyCount += paths.length;
-    Promise.all(paths.map(async (path9) => {
-      const res = await this._nodeFsHandler._addToNodeFs(path9, !_internal, void 0, 0, _origAdd);
+    Promise.all(paths.map(async (path7) => {
+      const res = await this._nodeFsHandler._addToNodeFs(path7, !_internal, void 0, 0, _origAdd);
       if (res)
         this._emitReady();
       return res;
@@ -4592,17 +4553,17 @@ var FSWatcher = class extends EventEmitter2 {
       return this;
     const paths = unifyPaths(paths_);
     const { cwd } = this.options;
-    paths.forEach((path9) => {
-      if (!sp2.isAbsolute(path9) && !this._closers.has(path9)) {
+    paths.forEach((path7) => {
+      if (!sp2.isAbsolute(path7) && !this._closers.has(path7)) {
         if (cwd)
-          path9 = sp2.join(cwd, path9);
-        path9 = sp2.resolve(path9);
+          path7 = sp2.join(cwd, path7);
+        path7 = sp2.resolve(path7);
       }
-      this._closePath(path9);
-      this._addIgnoredPath(path9);
-      if (this._watched.has(path9)) {
+      this._closePath(path7);
+      this._addIgnoredPath(path7);
+      if (this._watched.has(path7)) {
         this._addIgnoredPath({
-          path: path9,
+          path: path7,
           recursive: true
         });
       }
@@ -4666,38 +4627,38 @@ var FSWatcher = class extends EventEmitter2 {
    * @param stats arguments to be passed with event
    * @returns the error if defined, otherwise the value of the FSWatcher instance's `closed` flag
    */
-  async _emit(event, path9, stats) {
+  async _emit(event, path7, stats) {
     if (this.closed)
       return;
     const opts = this.options;
     if (isWindows)
-      path9 = sp2.normalize(path9);
+      path7 = sp2.normalize(path7);
     if (opts.cwd)
-      path9 = sp2.relative(opts.cwd, path9);
-    const args = [path9];
+      path7 = sp2.relative(opts.cwd, path7);
+    const args = [path7];
     if (stats != null)
       args.push(stats);
     const awf = opts.awaitWriteFinish;
     let pw;
-    if (awf && (pw = this._pendingWrites.get(path9))) {
+    if (awf && (pw = this._pendingWrites.get(path7))) {
       pw.lastChange = /* @__PURE__ */ new Date();
       return this;
     }
     if (opts.atomic) {
       if (event === EVENTS.UNLINK) {
-        this._pendingUnlinks.set(path9, [event, ...args]);
+        this._pendingUnlinks.set(path7, [event, ...args]);
         setTimeout(() => {
-          this._pendingUnlinks.forEach((entry, path10) => {
+          this._pendingUnlinks.forEach((entry, path8) => {
             this.emit(...entry);
             this.emit(EVENTS.ALL, ...entry);
-            this._pendingUnlinks.delete(path10);
+            this._pendingUnlinks.delete(path8);
           });
         }, typeof opts.atomic === "number" ? opts.atomic : 100);
         return this;
       }
-      if (event === EVENTS.ADD && this._pendingUnlinks.has(path9)) {
+      if (event === EVENTS.ADD && this._pendingUnlinks.has(path7)) {
         event = EVENTS.CHANGE;
-        this._pendingUnlinks.delete(path9);
+        this._pendingUnlinks.delete(path7);
       }
     }
     if (awf && (event === EVENTS.ADD || event === EVENTS.CHANGE) && this._readyEmitted) {
@@ -4715,16 +4676,16 @@ var FSWatcher = class extends EventEmitter2 {
           this.emitWithAll(event, args);
         }
       };
-      this._awaitWriteFinish(path9, awf.stabilityThreshold, event, awfEmit);
+      this._awaitWriteFinish(path7, awf.stabilityThreshold, event, awfEmit);
       return this;
     }
     if (event === EVENTS.CHANGE) {
-      const isThrottled = !this._throttle(EVENTS.CHANGE, path9, 50);
+      const isThrottled = !this._throttle(EVENTS.CHANGE, path7, 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, path9) : path9;
+      const fullPath = opts.cwd ? sp2.join(opts.cwd, path7) : path7;
       let stats2;
       try {
         stats2 = await stat3(fullPath);
@@ -4755,23 +4716,23 @@ var FSWatcher = class extends EventEmitter2 {
    * @param timeout duration of time to suppress duplicate actions
    * @returns tracking object or false if action should be suppressed
    */
-  _throttle(actionType, path9, timeout) {
+  _throttle(actionType, path7, 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(path9);
+    const actionPath = action.get(path7);
     if (actionPath) {
       actionPath.count++;
       return false;
     }
     let timeoutObject;
     const clear = () => {
-      const item = action.get(path9);
+      const item = action.get(path7);
       const count = item ? item.count : 0;
-      action.delete(path9);
+      action.delete(path7);
       clearTimeout(timeoutObject);
       if (item)
         clearTimeout(item.timeoutObject);
@@ -4779,7 +4740,7 @@ var FSWatcher = class extends EventEmitter2 {
     };
     timeoutObject = setTimeout(clear, timeout);
     const thr = { timeoutObject, clear, count: 0 };
-    action.set(path9, thr);
+    action.set(path7, thr);
     return thr;
   }
   _incrReadyCount() {
@@ -4793,44 +4754,44 @@ var FSWatcher = class extends EventEmitter2 {
    * @param event
    * @param awfEmit Callback to be called when ready for event to be emitted.
    */
-  _awaitWriteFinish(path9, threshold, event, awfEmit) {
+  _awaitWriteFinish(path7, threshold, event, awfEmit) {
     const awf = this.options.awaitWriteFinish;
     if (typeof awf !== "object")
       return;
     const pollInterval = awf.pollInterval;
     let timeoutHandler;
-    let fullPath = path9;
-    if (this.options.cwd && !sp2.isAbsolute(path9)) {
-      fullPath = sp2.join(this.options.cwd, path9);
+    let fullPath = path7;
+    if (this.options.cwd && !sp2.isAbsolute(path7)) {
+      fullPath = sp2.join(this.options.cwd, path7);
     }
     const now = /* @__PURE__ */ new Date();
     const writes = this._pendingWrites;
     function awaitWriteFinishFn(prevStat) {
       statcb(fullPath, (err, curStat) => {
-        if (err || !writes.has(path9)) {
+        if (err || !writes.has(path7)) {
           if (err && err.code !== "ENOENT")
             awfEmit(err);
           return;
         }
         const now2 = Number(/* @__PURE__ */ new Date());
         if (prevStat && curStat.size !== prevStat.size) {
-          writes.get(path9).lastChange = now2;
+          writes.get(path7).lastChange = now2;
         }
-        const pw = writes.get(path9);
+        const pw = writes.get(path7);
         const df = now2 - pw.lastChange;
         if (df >= threshold) {
-          writes.delete(path9);
+          writes.delete(path7);
           awfEmit(void 0, curStat);
         } else {
           timeoutHandler = setTimeout(awaitWriteFinishFn, pollInterval, curStat);
         }
       });
     }
-    if (!writes.has(path9)) {
-      writes.set(path9, {
+    if (!writes.has(path7)) {
+      writes.set(path7, {
         lastChange: now,
         cancelWait: () => {
-          writes.delete(path9);
+          writes.delete(path7);
           clearTimeout(timeoutHandler);
           return event;
         }
@@ -4841,8 +4802,8 @@ var FSWatcher = class extends EventEmitter2 {
   /**
    * Determines whether user has asked to ignore this path.
    */
-  _isIgnored(path9, stats) {
-    if (this.options.atomic && DOT_RE.test(path9))
+  _isIgnored(path7, stats) {
+    if (this.options.atomic && DOT_RE.test(path7))
       return true;
     if (!this._userIgnored) {
       const { cwd } = this.options;
@@ -4852,17 +4813,17 @@ var FSWatcher = class extends EventEmitter2 {
       const list = [...ignoredPaths.map(normalizeIgnored(cwd)), ...ignored];
       this._userIgnored = anymatch(list, void 0);
     }
-    return this._userIgnored(path9, stats);
+    return this._userIgnored(path7, stats);
   }
-  _isntIgnored(path9, stat4) {
-    return !this._isIgnored(path9, stat4);
+  _isntIgnored(path7, stat4) {
+    return !this._isIgnored(path7, stat4);
   }
   /**
    * Provides a set of common helpers and properties relating to symlink handling.
    * @param path file or directory pattern being watched
    */
-  _getWatchHelpers(path9) {
-    return new WatchHelper(path9, this.options.followSymlinks, this);
+  _getWatchHelpers(path7) {
+    return new WatchHelper(path7, this.options.followSymlinks, this);
   }
   // Directory helpers
   // -----------------
@@ -4894,63 +4855,63 @@ var FSWatcher = class extends EventEmitter2 {
    * @param item      base path of item/directory
    */
   _remove(directory, item, isDirectory) {
-    const path9 = sp2.join(directory, item);
-    const fullPath = sp2.resolve(path9);
-    isDirectory = isDirectory != null ? isDirectory : this._watched.has(path9) || this._watched.has(fullPath);
-    if (!this._throttle("remove", path9, 100))
+    const path7 = sp2.join(directory, item);
+    const fullPath = sp2.resolve(path7);
+    isDirectory = isDirectory != null ? isDirectory : this._watched.has(path7) || this._watched.has(fullPath);
+    if (!this._throttle("remove", path7, 100))
       return;
     if (!isDirectory && this._watched.size === 1) {
       this.add(directory, item, true);
     }
-    const wp = this._getWatchedDir(path9);
+    const wp = this._getWatchedDir(path7);
     const nestedDirectoryChildren = wp.getChildren();
-    nestedDirectoryChildren.forEach((nested) => this._remove(path9, nested));
+    nestedDirectoryChildren.forEach((nested) => this._remove(path7, 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 = path9;
+    let relPath = path7;
     if (this.options.cwd)
-      relPath = sp2.relative(this.options.cwd, path9);
+      relPath = sp2.relative(this.options.cwd, path7);
     if (this.options.awaitWriteFinish && this._pendingWrites.has(relPath)) {
       const event = this._pendingWrites.get(relPath).cancelWait();
       if (event === EVENTS.ADD)
         return;
     }
-    this._watched.delete(path9);
+    this._watched.delete(path7);
     this._watched.delete(fullPath);
     const eventName = isDirectory ? EVENTS.UNLINK_DIR : EVENTS.UNLINK;
-    if (wasTracked && !this._isIgnored(path9))
-      this._emit(eventName, path9);
-    this._closePath(path9);
+    if (wasTracked && !this._isIgnored(path7))
+      this._emit(eventName, path7);
+    this._closePath(path7);
   }
   /**
    * Closes all watchers for a path
    */
-  _closePath(path9) {
-    this._closeFile(path9);
-    const dir = sp2.dirname(path9);
-    this._getWatchedDir(dir).remove(sp2.basename(path9));
+  _closePath(path7) {
+    this._closeFile(path7);
+    const dir = sp2.dirname(path7);
+    this._getWatchedDir(dir).remove(sp2.basename(path7));
   }
   /**
    * Closes only file-specific watchers
    */
-  _closeFile(path9) {
-    const closers = this._closers.get(path9);
+  _closeFile(path7) {
+    const closers = this._closers.get(path7);
     if (!closers)
       return;
     closers.forEach((closer) => closer());
-    this._closers.delete(path9);
+    this._closers.delete(path7);
   }
-  _addPathCloser(path9, closer) {
+  _addPathCloser(path7, closer) {
     if (!closer)
       return;
-    let list = this._closers.get(path9);
+    let list = this._closers.get(path7);
     if (!list) {
       list = [];
-      this._closers.set(path9, list);
+      this._closers.set(path7, list);
     }
     list.push(closer);
   }
@@ -4980,7 +4941,7 @@ function watch(paths, options = {}) {
 var chokidar_default = { watch, FSWatcher };
 
 // src/watcher/index.ts
-import * as path7 from "path";
+import * as path5 from "path";
 var FileWatcher = class {
   watcher = null;
   projectRoot;
@@ -5001,7 +4962,7 @@ var FileWatcher = class {
     const ignoreFilter = createIgnoreFilter(this.projectRoot);
     this.watcher = chokidar_default.watch(this.projectRoot, {
       ignored: (filePath) => {
-        const relativePath = path7.relative(this.projectRoot, filePath);
+        const relativePath = path5.relative(this.projectRoot, filePath);
         if (!relativePath) return false;
         if (ignoreFilter.ignores(relativePath)) {
           return true;
@@ -5045,7 +5006,7 @@ var FileWatcher = class {
       return;
     }
     const changes = Array.from(this.pendingChanges.entries()).map(
-      ([path9, type]) => ({ path: path9, type })
+      ([path7, type]) => ({ path: path7, type })
     );
     this.pendingChanges.clear();
     try {
@@ -5237,10 +5198,10 @@ function formatStatus(status) {
 
 // src/index.ts
 function loadPluginConfig(projectRoot) {
-  const configPath = path8.join(projectRoot, ".opencode", "codebase-index.json");
+  const configPath = path6.join(projectRoot, ".opencode", "codebase-index.json");
   try {
-    if (existsSync5(configPath)) {
-      const content = readFileSync6(configPath, "utf-8");
+    if (existsSync4(configPath)) {
+      const content = readFileSync4(configPath, "utf-8");
       return JSON.parse(content);
     }
   } catch {
@@ -5269,6 +5230,39 @@ var plugin = async ({ directory }) => {
       index_codebase,
       index_status,
       index_health_check
+    },
+    async config(cfg) {
+      cfg.command = cfg.command ?? {};
+      cfg.command["search"] = {
+        description: "Search codebase by meaning using semantic search",
+        template: `Use the \`codebase_search\` tool to find code related to: $ARGUMENTS
+
+If the index doesn't exist yet, run \`index_codebase\` first.
+
+Return the most relevant results with file paths and line numbers.`
+      };
+      cfg.command["find"] = {
+        description: "Find code using hybrid approach (semantic + grep)",
+        template: `Find code related to: $ARGUMENTS
+
+Strategy:
+1. First use \`codebase_search\` to find semantically related code
+2. From the results, identify specific function/class names
+3. Use grep to find all occurrences of those identifiers
+4. Combine findings into a comprehensive answer
+
+If the semantic index doesn't exist, run \`index_codebase\` first.`
+      };
+      cfg.command["index"] = {
+        description: "Index the codebase for semantic search",
+        template: `Run the \`index_codebase\` tool to create or update the semantic search index.
+
+Show progress and final statistics including:
+- Number of files processed
+- Number of chunks indexed
+- Tokens used
+- Duration`
+      };
     }
   };
 };