opencode-codebase-index 0.5.2 → 0.6.0

package/dist/index.cjs

@@ -33,7 +33,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 
 // node_modules/eventemitter3/index.js
 var require_eventemitter3 = __commonJS({
-  "node_modules/eventemitter3/index.js"(exports2, module2) {
+  "node_modules/eventemitter3/index.js"(exports2, module3) {
     "use strict";
     var has = Object.prototype.hasOwnProperty;
     var prefix = "~";
@@ -187,15 +187,15 @@ var require_eventemitter3 = __commonJS({
     EventEmitter3.prototype.addListener = EventEmitter3.prototype.on;
     EventEmitter3.prefixed = prefix;
     EventEmitter3.EventEmitter = EventEmitter3;
-    if ("undefined" !== typeof module2) {
-      module2.exports = EventEmitter3;
+    if ("undefined" !== typeof module3) {
+      module3.exports = EventEmitter3;
     }
   }
 });
 
 // node_modules/ignore/index.js
 var require_ignore = __commonJS({
-  "node_modules/ignore/index.js"(exports2, module2) {
+  "node_modules/ignore/index.js"(exports2, module3) {
     "use strict";
     function makeArray(subject) {
       return Array.isArray(subject) ? subject : [subject];
@@ -644,10 +644,10 @@ var require_ignore = __commonJS({
     ) {
       setupWindows();
     }
-    module2.exports = factory;
+    module3.exports = factory;
     factory.default = factory;
-    module2.exports.isPathValid = isPathValid;
-    define(module2.exports, /* @__PURE__ */ Symbol.for("setupWindows"), setupWindows);
+    module3.exports.isPathValid = isPathValid;
+    define(module3.exports, /* @__PURE__ */ Symbol.for("setupWindows"), setupWindows);
   }
 });
 
@@ -668,7 +668,7 @@ var DEFAULT_INCLUDE = [
   "**/*.{py,pyi}",
   "**/*.{go,rs,java,kt,scala}",
   "**/*.{c,cpp,cc,h,hpp}",
-  "**/*.{rb,php,swift}",
+  "**/*.{rb,php,inc,swift}",
   "**/*.{vue,svelte,astro}",
   "**/*.{sql,graphql,proto}",
   "**/*.{yaml,yml,toml}",
@@ -2929,6 +2929,7 @@ function initializeLogger(config) {
 // src/native/index.ts
 var path3 = __toESM(require("path"), 1);
 var os2 = __toESM(require("os"), 1);
+var module2 = __toESM(require("module"), 1);
 var import_url = require("url");
 var import_meta = {};
 function getNativeBinding() {
@@ -2949,17 +2950,22 @@ function getNativeBinding() {
     throw new Error(`Unsupported platform: ${platform2}-${arch2}`);
   }
   let currentDir;
+  let requireTarget;
   if (typeof import_meta !== "undefined" && import_meta.url) {
     currentDir = path3.dirname((0, import_url.fileURLToPath)(import_meta.url));
+    requireTarget = import_meta.url;
   } else if (typeof __dirname !== "undefined") {
     currentDir = __dirname;
+    requireTarget = __filename;
   } else {
     currentDir = process.cwd();
+    requireTarget = path3.join(currentDir, "index.js");
   }
   const isDevMode = currentDir.includes("/src/native");
   const packageRoot = isDevMode ? path3.resolve(currentDir, "../..") : path3.resolve(currentDir, "..");
   const nativePath = path3.join(packageRoot, "native", bindingName);
-  return require(nativePath);
+  const require2 = module2.createRequire(requireTarget);
+  return require2(nativePath);
 }
 var native = getNativeBinding();
 function parseFiles(files) {
@@ -3441,7 +3447,36 @@ var Database = class {
 // src/git/index.ts
 var import_fs3 = require("fs");
 var path4 = __toESM(require("path"), 1);
-var import_child_process = require("child_process");
+function readPackedRefs(gitDir) {
+  const packedRefsPath = path4.join(gitDir, "packed-refs");
+  if (!(0, import_fs3.existsSync)(packedRefsPath)) {
+    return [];
+  }
+  try {
+    return (0, import_fs3.readFileSync)(packedRefsPath, "utf-8").split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#") && !line.startsWith("^"));
+  } catch {
+    return [];
+  }
+}
+function resolveCommonGitDir(gitDir) {
+  const commonDirPath = path4.join(gitDir, "commondir");
+  if (!(0, import_fs3.existsSync)(commonDirPath)) {
+    return gitDir;
+  }
+  try {
+    const raw = (0, import_fs3.readFileSync)(commonDirPath, "utf-8").trim();
+    if (!raw) {
+      return gitDir;
+    }
+    const resolved = path4.isAbsolute(raw) ? raw : path4.resolve(gitDir, raw);
+    if ((0, import_fs3.existsSync)(resolved)) {
+      return resolved;
+    }
+  } catch {
+    return gitDir;
+  }
+  return gitDir;
+}
 function resolveGitDir(repoRoot) {
   const gitPath = path4.join(repoRoot, ".git");
   if (!(0, import_fs3.existsSync)(gitPath)) {
@@ -3495,37 +3530,20 @@ function getCurrentBranch(repoRoot) {
 }
 function getBaseBranch(repoRoot) {
   const gitDir = resolveGitDir(repoRoot);
+  const refStoreDir = gitDir ? resolveCommonGitDir(gitDir) : null;
   const candidates = ["main", "master", "develop", "trunk"];
-  if (gitDir) {
+  if (refStoreDir) {
     for (const candidate of candidates) {
-      const refPath = path4.join(gitDir, "refs", "heads", candidate);
+      const refPath = path4.join(refStoreDir, "refs", "heads", candidate);
       if ((0, import_fs3.existsSync)(refPath)) {
         return candidate;
       }
-      const packedRefsPath = path4.join(gitDir, "packed-refs");
-      if ((0, import_fs3.existsSync)(packedRefsPath)) {
-        try {
-          const content = (0, import_fs3.readFileSync)(packedRefsPath, "utf-8");
-          if (content.includes(`refs/heads/${candidate}`)) {
-            return candidate;
-          }
-        } catch {
-        }
+      const packedRefs = readPackedRefs(refStoreDir);
+      if (packedRefs.some((line) => line.endsWith(` refs/heads/${candidate}`))) {
+        return candidate;
       }
     }
   }
-  try {
-    const result = (0, import_child_process.execSync)("git remote show origin", {
-      cwd: repoRoot,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"]
-    });
-    const match = result.match(/HEAD branch: (.+)/);
-    if (match) {
-      return match[1].trim();
-    }
-  } catch {
-  }
   return getCurrentBranch(repoRoot) ?? "main";
 }
 function getBranchOrDefault(repoRoot) {
@@ -3543,7 +3561,7 @@ function getHeadPath(repoRoot) {
 }
 
 // src/indexer/index.ts
-var CALL_GRAPH_LANGUAGES = /* @__PURE__ */ new Set(["typescript", "tsx", "javascript", "jsx", "python", "go", "rust"]);
+var CALL_GRAPH_LANGUAGES = /* @__PURE__ */ new Set(["typescript", "tsx", "javascript", "jsx", "python", "go", "rust", "php"]);
 var CALL_GRAPH_SYMBOL_CHUNK_TYPES = /* @__PURE__ */ new Set([
   "function_declaration",
   "function",
@@ -3564,7 +3582,8 @@ var CALL_GRAPH_SYMBOL_CHUNK_TYPES = /* @__PURE__ */ new Set([
   "struct_item",
   "enum_item",
   "trait_item",
-  "mod_item"
+  "mod_item",
+  "trait_declaration"
 ]);
 function float32ArrayToBuffer(arr) {
   const float32 = new Float32Array(arr);
@@ -3946,8 +3965,8 @@ function stripFilePathHint(query) {
   const stripped = query.replace(FILE_PATH_HINT_SUFFIX_REGEX, "").trim();
   return stripped.length > 0 ? stripped : query;
 }
-function buildDeterministicIdentifierPass(query, candidates, limit) {
-  if (classifyQueryIntentRaw(query) !== "source") {
+function buildDeterministicIdentifierPass(query, candidates, limit, prioritizeSourcePaths = classifyQueryIntentRaw(query) === "source") {
+  if (!prioritizeSourcePaths) {
     return [];
   }
   const primary = extractPrimaryIdentifierQueryHint(query);
@@ -4163,9 +4182,8 @@ function rankHybridResults(query, semanticResults, keywordResults, options) {
   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);
-  const intent = classifyQueryIntentRaw(query);
   return rerankResults(query, rerankPool, options.rerankTopN, {
-    prioritizeSourcePaths: intent === "source"
+    prioritizeSourcePaths: options.prioritizeSourcePaths ?? classifyQueryIntentRaw(query) === "source"
   });
 }
 function rankSemanticOnlyResults(query, semanticResults, options) {
@@ -4175,11 +4193,11 @@ function rankSemanticOnlyResults(query, semanticResults, options) {
     prioritizeSourcePaths: options.prioritizeSourcePaths ?? false
   });
 }
-function promoteIdentifierMatches(query, combined, semanticCandidates, keywordCandidates, database, branchChunkIds) {
+function promoteIdentifierMatches(query, combined, semanticCandidates, keywordCandidates, database, branchChunkIds, prioritizeSourcePaths = classifyQueryIntentRaw(query) === "source") {
   if (combined.length === 0) {
     return combined;
   }
-  if (classifyQueryIntentRaw(query) !== "source") {
+  if (!prioritizeSourcePaths) {
     return combined;
   }
   const identifierHints = extractIdentifierHints(query);
@@ -4269,8 +4287,8 @@ function promoteIdentifierMatches(query, combined, semanticCandidates, keywordCa
   const remainder = combined.filter((candidate) => !promotedIds.has(candidate.id));
   return [...promoted, ...remainder];
 }
-function buildSymbolDefinitionLane(query, database, branchChunkIds, limit, fallbackCandidates) {
-  if (classifyQueryIntentRaw(query) !== "source") {
+function buildSymbolDefinitionLane(query, database, branchChunkIds, limit, fallbackCandidates, prioritizeSourcePaths = classifyQueryIntentRaw(query) === "source") {
+  if (!prioritizeSourcePaths) {
     return [];
   }
   const identifierHints = extractIdentifierHints(query);
@@ -4415,8 +4433,8 @@ function buildSymbolDefinitionLane(query, database, branchChunkIds, limit, fallb
   const withFallback = Array.from(symbolCandidates.values()).sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
   return withFallback.slice(0, Math.max(limit * 2, limit));
 }
-function buildIdentifierDefinitionLane(query, candidates, limit) {
-  if (classifyQueryIntentRaw(query) !== "source") {
+function buildIdentifierDefinitionLane(query, candidates, limit, prioritizeSourcePaths = classifyQueryIntentRaw(query) === "source") {
+  if (!prioritizeSourcePaths) {
     return [];
   }
   const primaryHint = extractPrimaryIdentifierQueryHint(query);
@@ -5348,6 +5366,7 @@ var Indexer = class {
     const rrfK = this.config.search.rrfK;
     const rerankTopN = this.config.search.rerankTopN;
     const filterByBranch = options?.filterByBranch ?? true;
+    const sourceIntent = options?.definitionIntent === true || classifyQueryIntentRaw(query) === "source";
     this.logger.search("debug", "Starting search", {
       query,
       maxResults,
@@ -5399,7 +5418,8 @@ var Indexer = class {
       rrfK,
       rerankTopN,
       limit: maxResults,
-      hybridWeight
+      hybridWeight,
+      prioritizeSourcePaths: sourceIntent
     });
     const fusionMs = import_perf_hooks.performance.now() - fusionStartTime;
     const rescued = promoteIdentifierMatches(
@@ -5408,30 +5428,33 @@ var Indexer = class {
       semanticCandidates,
       keywordCandidates,
       database,
-      branchChunkIds
+      branchChunkIds,
+      sourceIntent
     );
     const union = unionCandidates(semanticCandidates, keywordCandidates);
     const deterministicIdentifierLane = buildDeterministicIdentifierPass(
       query,
       union,
-      maxResults
+      maxResults,
+      sourceIntent
     );
     const identifierLane = buildIdentifierDefinitionLane(
       query,
       union,
-      maxResults
+      maxResults,
+      sourceIntent
     );
     const symbolLane = buildSymbolDefinitionLane(
       query,
       database,
       branchChunkIds,
       maxResults,
-      union
+      union,
+      sourceIntent
     );
     const prePrimaryLane = mergeTieredResults(deterministicIdentifierLane, identifierLane, maxResults * 4);
     const primaryLane = mergeTieredResults(prePrimaryLane, symbolLane, maxResults * 4);
     const tiered = mergeTieredResults(primaryLane, rescued, maxResults * 4);
-    const sourceIntent = classifyQueryIntentRaw(query) === "source";
     const hasCodeHints = extractCodeTermHints(query).length > 0 || extractIdentifierHints(query).length > 0;
     const baseFiltered = tiered.filter((r) => {
       if (r.score < this.config.search.minScore) return false;
@@ -7877,6 +7900,22 @@ function formatLogs(logs) {
     return `[${l.timestamp}] [${l.level.toUpperCase()}] [${l.category}] ${l.message}${dataStr}`;
   }).join("\n");
 }
+function formatDefinitionLookup(results, query) {
+  if (results.length === 0) {
+    return `No definition found for "${query}". Try codebase_search for broader discovery, or verify the symbol name.`;
+  }
+  const formatted = results.map((r, idx) => {
+    const header2 = r.name ? `[${idx + 1}] ${r.chunkType} "${r.name}" in ${r.filePath}:${r.startLine}-${r.endLine}` : `[${idx + 1}] ${r.chunkType} in ${r.filePath}:${r.startLine}-${r.endLine}`;
+    return `${header2} (score: ${r.score.toFixed(2)})
+\`\`\`
+${truncateContent(r.content)}
+\`\`\``;
+  });
+  const header = results.length === 1 ? `Definition found for "${query}":` : `Found ${results.length} definition candidates for "${query}":`;
+  return `${header}
+
+${formatted.join("\n\n")}`;
+}
 function formatSearchResults(results, scoreFormat = "similarity") {
   const formatted = results.map((r, idx) => {
     const header = r.name ? `[${idx + 1}] ${r.chunkType} "${r.name}" in ${r.filePath}:${r.startLine}-${r.endLine}` : `[${idx + 1}] ${r.chunkType} in ${r.filePath}:${r.startLine}-${r.endLine}`;
@@ -8062,6 +8101,24 @@ var codebase_search = (0, import_plugin.tool)({
 ${formatSearchResults(results, "score")}`;
   }
 });
+var implementation_lookup = (0, import_plugin.tool)({
+  description: "Jump to symbol definition. Find WHERE something is defined. Returns the authoritative source location(s) for a function, class, method, type, or variable. Prefers real implementation files over tests, docs, examples, and fixtures. Use when you need the definition site, not all usages.",
+  args: {
+    query: z.string().describe("Symbol name or natural language description (e.g., 'validateToken', 'where is the payment handler defined')"),
+    limit: z.number().optional().default(5).describe("Maximum number of results"),
+    fileType: z.string().optional().describe("Filter by file extension (e.g., 'ts', 'py')"),
+    directory: z.string().optional().describe("Filter by directory path (e.g., 'src/utils')")
+  },
+  async execute(args) {
+    const indexer = getIndexer();
+    const results = await indexer.search(args.query, args.limit ?? 5, {
+      fileType: args.fileType,
+      directory: args.directory,
+      definitionIntent: true
+    });
+    return formatDefinitionLookup(results, args.query);
+  }
+});
 var call_graph = (0, import_plugin.tool)({
   description: "Query the call graph to find callers or callees of a function/method. Use to understand code flow and dependencies between functions.",
   args: {
@@ -8203,7 +8260,8 @@ var plugin = async ({ directory }) => {
       index_metrics,
       index_logs,
       find_similar,
-      call_graph
+      call_graph,
+      implementation_lookup
     },
     async config(cfg) {
       cfg.command = cfg.command ?? {};