opencode-codebase-index 0.9.0 → 0.11.0

package/README.md

@@ -575,7 +575,8 @@ Zero-config by default (uses `auto` mode). Customize in `.opencode/codebase-inde
     "rrfK": 60,                               // RRF smoothing constant
     "rerankTopN": 20,                         // Deterministic rerank depth
     "contextLines": 0,                        // Extra lines before/after match
-    "routingHints": true                      // Runtime nudges for local discovery/definition queries
+    "routingHints": true,                     // Runtime nudges for local discovery/definition queries
+    "routingHintRole": "system"              // system | developer (message role used for hints)
   },
   "reranker": {
     "enabled": false,
@@ -646,6 +647,7 @@ String values in `codebase-index.json` can reference environment variables with
 | `rerankTopN` | `20` | Deterministic rerank depth cap. Applies lightweight name/path/chunk-type rerank to top-N only |
 | `contextLines` | `0` | Extra lines to include before/after each match |
 | `routingHints` | `true` | Inject lightweight runtime hints for local conceptual discovery and definition lookups. Set to `false` to disable plugin-side routing nudges. |
+| `routingHintRole` | `"system"` | Message role used when injecting routing hints: `"system"` (default) or `"developer"`. |
 | **reranker** | | Optional second-stage model reranker for the top candidate pool |
 | `enabled` | `false` | Turn external reranking on/off |
 | `provider` | `"custom"` | Hosted shortcuts: `cohere`, `jina`, or `custom` |
@@ -676,7 +678,7 @@ These warnings improve observability but do **not** change the recovery behavior
 ### Retrieval ranking behavior
 
 - `codebase_search` and `codebase_peek` use the hybrid path: semantic + keyword retrieval → fusion (`fusionStrategy`) → deterministic rerank (`rerankTopN`) → optional external reranker (`reranker`) → filtering.
-- When `search.routingHints` is enabled (default), the plugin adds tiny per-turn runtime hints for local conceptual discovery and definition queries. Conceptual discovery is nudged toward `codebase_peek` / `codebase_search`, while definition questions are nudged toward `implementation_lookup`. Exact identifier and unrelated operational tasks are left alone.
+- When `search.routingHints` is enabled (default), the plugin adds tiny per-turn runtime hints for local conceptual discovery and definition queries. Conceptual discovery is nudged toward `codebase_peek` / `codebase_search`, while definition questions are nudged toward `implementation_lookup`. Exact identifier and unrelated operational tasks are left alone. Set `search.routingHintRole` to `"developer"` if your client/runtime expects developer-role guidance instead of system-role guidance.
 - `find_similar` stays semantic-only: semantic retrieval + deterministic rerank only (no keyword retrieval, no RRF).
 - For compatibility rollbacks, set `search.fusionStrategy` to `"weighted"` to use the legacy weighted fusion path.
 - When enabled, the external reranker sees path metadata plus a bounded on-disk code snippet for each candidate so it can distinguish real implementations from docs/tests more reliably.

package/dist/cli.cjs

@@ -8,7 +8,11 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -794,7 +798,8 @@ function getDefaultSearchConfig() {
     rrfK: 60,
     rerankTopN: 20,
     contextLines: 0,
-    routingHints: true
+    routingHints: true,
+    routingHintRole: "system"
   };
 }
 function getDefaultRerankerBaseUrl(provider) {
@@ -915,7 +920,8 @@ function parseConfig(raw) {
     rrfK: typeof rawSearch.rrfK === "number" ? Math.max(1, Math.floor(rawSearch.rrfK)) : defaultSearch.rrfK,
     rerankTopN: typeof rawSearch.rerankTopN === "number" ? Math.min(200, Math.max(0, Math.floor(rawSearch.rerankTopN))) : defaultSearch.rerankTopN,
     contextLines: typeof rawSearch.contextLines === "number" ? Math.min(50, Math.max(0, rawSearch.contextLines)) : defaultSearch.contextLines,
-    routingHints: typeof rawSearch.routingHints === "boolean" ? rawSearch.routingHints : defaultSearch.routingHints
+    routingHints: typeof rawSearch.routingHints === "boolean" ? rawSearch.routingHints : defaultSearch.routingHints,
+    routingHintRole: rawSearch.routingHintRole === "developer" || rawSearch.routingHintRole === "system" ? rawSearch.routingHintRole : defaultSearch.routingHintRole
   };
   const rawDebug = input.debug && typeof input.debug === "object" ? input.debug : {};
   const debug = {
@@ -2497,6 +2503,8 @@ var BaseEmbeddingProvider = class {
     this.credentials = credentials;
     this.modelInfo = modelInfo;
   }
+  credentials;
+  modelInfo;
   async embedQuery(query) {
     const result = await this.embedBatch([query]);
     return {
@@ -4237,17 +4245,17 @@ var Database = class {
     if (edges.length === 0) return;
     this.inner.upsertCallEdgesBatch(edges);
   }
-  getCallers(targetName, branch) {
+  getCallers(targetName, branch, callTypeFilter) {
     this.throwIfClosed();
-    return this.inner.getCallers(targetName, branch);
+    return this.inner.getCallers(targetName, branch, callTypeFilter ?? null);
   }
-  getCallersWithContext(targetName, branch) {
+  getCallersWithContext(targetName, branch, callTypeFilter) {
     this.throwIfClosed();
-    return this.inner.getCallersWithContext(targetName, branch);
+    return this.inner.getCallersWithContext(targetName, branch, callTypeFilter ?? null);
   }
-  getCallees(symbolId, branch) {
+  getCallees(symbolId, branch, callTypeFilter) {
     this.throwIfClosed();
-    return this.inner.getCallees(symbolId, branch);
+    return this.inner.getCallees(symbolId, branch, callTypeFilter ?? null);
   }
   deleteCallEdgesByFile(filePath) {
     this.throwIfClosed();
@@ -4257,6 +4265,10 @@ var Database = class {
     this.throwIfClosed();
     this.inner.resolveCallEdge(edgeId, toSymbolId);
   }
+  findShortestPath(fromName, toName, branch, maxDepth) {
+    this.throwIfClosed();
+    return this.inner.findShortestPath(fromName, toName, branch, maxDepth ?? null);
+  }
   addSymbolsToBranch(branch, symbolIds) {
     this.throwIfClosed();
     this.inner.addSymbolsToBranch(branch, symbolIds);
@@ -7055,6 +7067,7 @@ var Indexer = class {
           targetName: site.calleeName,
           toSymbolId: void 0,
           callType: site.callType,
+          confidence: site.confidence,
           line: site.line,
           col: site.column,
           isResolved: false
@@ -8174,12 +8187,12 @@ var Indexer = class {
       })
     );
   }
-  async getCallers(targetName) {
+  async getCallers(targetName, callTypeFilter) {
     const { database } = await this.ensureInitialized();
     const seen = /* @__PURE__ */ new Set();
     const results = [];
     for (const branchKey of this.getBranchCatalogKeys()) {
-      for (const edge of database.getCallersWithContext(targetName, branchKey)) {
+      for (const edge of database.getCallersWithContext(targetName, branchKey, callTypeFilter)) {
         if (!seen.has(edge.id)) {
           seen.add(edge.id);
           results.push(edge);
@@ -8188,12 +8201,12 @@ var Indexer = class {
     }
     return results;
   }
-  async getCallees(symbolId) {
+  async getCallees(symbolId, callTypeFilter) {
     const { database } = await this.ensureInitialized();
     const seen = /* @__PURE__ */ new Set();
     const results = [];
     for (const branchKey of this.getBranchCatalogKeys()) {
-      for (const edge of database.getCallees(symbolId, branchKey)) {
+      for (const edge of database.getCallees(symbolId, branchKey, callTypeFilter)) {
         if (!seen.has(edge.id)) {
           seen.add(edge.id);
           results.push(edge);
@@ -8202,6 +8215,17 @@ var Indexer = class {
     }
     return results;
   }
+  async findCallPath(fromName, toName, maxDepth) {
+    const { database } = await this.ensureInitialized();
+    let shortest = [];
+    for (const branchKey of this.getBranchCatalogKeys()) {
+      const path18 = database.findShortestPath(fromName, toName, branchKey, maxDepth);
+      if (path18.length > 0 && (shortest.length === 0 || path18.length < shortest.length)) {
+        shortest = path18;
+      }
+    }
+    return shortest;
+  }
   async close() {
     await this.database?.close();
     this.database = null;
@@ -9977,11 +10001,12 @@ ${formatted.join("\n\n")}` }] };
   );
   server.tool(
     "call_graph",
-    "Query the call graph to find callers or callees of a function/method. Use to understand code flow and dependencies.",
+    "Query the call graph to find callers or callees of a function/method. Use to understand code flow and dependencies. Supports relationship types: Call, MethodCall, Constructor, Import, Inherits, Implements.",
     {
       name: import_zod2.z.string().describe("Function or method name to query"),
       direction: import_zod2.z.enum(["callers", "callees"]).default("callers").describe("Direction: 'callers' finds who calls this function, 'callees' finds what this function calls"),
-      symbolId: import_zod2.z.string().optional().describe("Symbol ID (required for 'callees' direction)")
+      symbolId: import_zod2.z.string().optional().describe("Symbol ID (required for 'callees' direction)"),
+      relationshipType: import_zod2.z.enum(["Call", "MethodCall", "Constructor", "Import", "Inherits", "Implements"]).optional().describe("Filter by relationship type. Omit to show all.")
     },
     async (args) => {
       await runtime.ensureInitialized();
@@ -9990,26 +10015,52 @@ ${formatted.join("\n\n")}` }] };
         if (!args.symbolId) {
           return { content: [{ type: "text", text: "Error: 'symbolId' is required when direction is 'callees'." }] };
         }
-        const callees = await indexer.getCallees(args.symbolId);
+        const callees = await indexer.getCallees(args.symbolId, args.relationshipType);
         if (callees.length === 0) {
-          return { content: [{ type: "text", text: `No callees found for symbol ${args.symbolId}.` }] };
+          return { content: [{ type: "text", text: `No callees found for symbol ${args.symbolId}${args.relationshipType ? ` with type ${args.relationshipType}` : ""}.` }] };
         }
-        const formatted2 = callees.map(
-          (e, i) => `[${i + 1}] \u2192 ${e.targetName} (${e.callType}) at line ${e.line}${e.isResolved ? ` [resolved: ${e.toSymbolId}]` : " [unresolved]"}`
-        );
+        const formatted2 = callees.map((e, i) => {
+          const conf = e.confidence !== "Direct" ? ` [${e.confidence.toLowerCase()}]` : "";
+          return `[${i + 1}] \u2192 ${e.targetName} (${e.callType})${conf} at line ${e.line}${e.isResolved ? ` [resolved: ${e.toSymbolId}]` : " [unresolved]"}`;
+        });
         return { content: [{ type: "text", text: `Callees (${callees.length}):
 
 ${formatted2.join("\n")}` }] };
       }
-      const callers = await indexer.getCallers(args.name);
+      const callers = await indexer.getCallers(args.name, args.relationshipType);
       if (callers.length === 0) {
-        return { content: [{ type: "text", text: `No callers found for "${args.name}".` }] };
+        return { content: [{ type: "text", text: `No callers found for "${args.name}"${args.relationshipType ? ` with type ${args.relationshipType}` : ""}.` }] };
       }
-      const formatted = callers.map(
-        (e, i) => `[${i + 1}] \u2190 from ${e.fromSymbolName ?? "<unknown>"} in ${e.fromSymbolFilePath ?? "<unknown file>"} [${e.fromSymbolId}] (${e.callType}) at line ${e.line}${e.isResolved ? " [resolved]" : " [unresolved]"}`
-      );
+      const formatted = callers.map((e, i) => {
+        const conf = e.confidence !== "Direct" ? ` [${e.confidence.toLowerCase()}]` : "";
+        return `[${i + 1}] \u2190 from ${e.fromSymbolName ?? "<unknown>"} in ${e.fromSymbolFilePath ?? "<unknown file>"} [${e.fromSymbolId}] (${e.callType})${conf} at line ${e.line}${e.isResolved ? " [resolved]" : " [unresolved]"}`;
+      });
       return { content: [{ type: "text", text: `"${args.name}" is called by ${callers.length} function(s):
 
+${formatted.join("\n")}` }] };
+    }
+  );
+  server.tool(
+    "call_graph_path",
+    "Find the shortest connection path between two symbols in the call graph. Returns the chain of calls connecting them.",
+    {
+      from: import_zod2.z.string().describe("Source function/method name (starting point)"),
+      to: import_zod2.z.string().describe("Target function/method name (destination)"),
+      maxDepth: import_zod2.z.number().optional().default(10).describe("Maximum traversal depth (default: 10)")
+    },
+    async (args) => {
+      await runtime.ensureInitialized();
+      const indexer = runtime.getIndexer();
+      const path18 = await indexer.findCallPath(args.from, args.to, args.maxDepth);
+      if (path18.length === 0) {
+        return { content: [{ type: "text", text: `No path found between "${args.from}" and "${args.to}". They may be in disconnected components, or the call graph index needs updating.` }] };
+      }
+      const formatted = path18.map((hop, i) => {
+        const prefix = i === 0 ? "[start]" : `--${hop.callType}-->`;
+        const location = hop.filePath ? ` (${hop.filePath}:${hop.line})` : "";
+        return `${prefix} ${hop.symbolName}${location}`;
+      });
+      return { content: [{ type: "text", text: `Path (${path18.length} hops):
 ${formatted.join("\n")}` }] };
     }
   );
@@ -10088,9 +10139,8 @@ async function main() {
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
 }
-main().catch((error) => {
-  const message = error instanceof Error ? error.message : String(error);
-  console.error(`Fatal: ${message}`);
+main().catch((_error) => {
+  console.error("Fatal: failed to start MCP server (check config and network)");
   process.exit(1);
 });
 //# sourceMappingURL=cli.cjs.map