opencode-codebase-index 0.9.0 → 0.11.0

package/dist/index.cjs

@@ -7,7 +7,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 __export = (target, all) => {
   for (var name in all)
@@ -657,6 +661,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
+var os6 = __toESM(require("os"), 1);
 var path17 = __toESM(require("path"), 1);
 var import_url2 = require("url");
 
@@ -803,7 +808,8 @@ function getDefaultSearchConfig() {
     rrfK: 60,
     rerankTopN: 20,
     contextLines: 0,
-    routingHints: true
+    routingHints: true,
+    routingHintRole: "system"
   };
 }
 function getDefaultRerankerBaseUrl(provider) {
@@ -924,7 +930,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 = {
@@ -1246,6 +1253,32 @@ function hasFilteredPathSegment(relativePath, separator = path4.sep) {
     (part) => isHiddenPathSegment(part) || isBuildPathSegment(part)
   );
 }
+var RESTRICTED_DIRECTORIES = /* @__PURE__ */ new Set([
+  // macOS
+  "library",
+  "applications",
+  "system",
+  "volumes",
+  "private",
+  "cores",
+  // Linux
+  "proc",
+  "sys",
+  "dev",
+  "run",
+  "snap",
+  // Windows
+  "windows",
+  "programdata",
+  "program files",
+  "program files (x86)",
+  "$recycle.bin"
+]);
+function isRestrictedDirectory(relativePath, separator = path4.sep) {
+  const firstSegment = relativePath.split(separator)[0];
+  if (!firstSegment) return false;
+  return RESTRICTED_DIRECTORIES.has(firstSegment.toLowerCase());
+}
 
 // src/config/rebase.ts
 function isWithinRoot(rootDir, targetPath) {
@@ -2305,7 +2338,7 @@ var NodeFsHandler = class {
         this._addToNodeFs(path18, initialAdd, wh, depth + 1);
       }
     }).on(EV.ERROR, this._boundHandleError);
-    return new Promise((resolve11, reject) => {
+    return new Promise((resolve12, reject) => {
       if (!stream)
         return reject();
       stream.once(STR_END, () => {
@@ -2314,7 +2347,7 @@ var NodeFsHandler = class {
           return;
         }
         const wasThrottled = throttler ? throttler.clear() : false;
-        resolve11(void 0);
+        resolve12(void 0);
         previous.getChildren().filter((item) => {
           return item !== directory && !current.has(item);
         }).forEach((item) => {
@@ -3414,6 +3447,9 @@ var FileWatcher = class {
         if (hasFilteredPathSegment(relativePath, path8.sep)) {
           return true;
         }
+        if (isRestrictedDirectory(relativePath, path8.sep)) {
+          return true;
+        }
         if (ignoreFilter.ignores(relativePath)) {
           return true;
         }
@@ -3426,6 +3462,13 @@ var FileWatcher = class {
         pollInterval: 100
       }
     });
+    this.watcher.on("error", (error) => {
+      const err = error instanceof Error ? error : null;
+      if (err?.code === "EPERM" || err?.code === "EACCES") {
+        return;
+      }
+      console.error("[codebase-index] Watcher error:", err?.message ?? error);
+    });
     this.watcher.on("add", (filePath) => this.handleChange("add", filePath));
     this.watcher.on("change", (filePath) => this.handleChange("change", filePath));
     this.watcher.on("unlink", (filePath) => this.handleChange("unlink", filePath));
@@ -3560,7 +3603,7 @@ var GitHeadWatcher = class {
 };
 
 // src/watcher/index.ts
-function createWatcherWithIndexer(getIndexer2, projectRoot, config) {
+function createWatcherWithIndexer(getIndexer, projectRoot, config) {
   const fileWatcher = new FileWatcher(projectRoot, config);
   fileWatcher.start(async (changes) => {
     const hasAddOrChange = changes.some(
@@ -3568,7 +3611,7 @@ function createWatcherWithIndexer(getIndexer2, projectRoot, config) {
     );
     const hasDelete = changes.some((c) => c.type === "unlink");
     if (hasAddOrChange || hasDelete) {
-      await getIndexer2().index();
+      await getIndexer().index();
     }
   });
   let gitWatcher = null;
@@ -3576,7 +3619,7 @@ function createWatcherWithIndexer(getIndexer2, projectRoot, config) {
     gitWatcher = new GitHeadWatcher(projectRoot);
     gitWatcher.start(async (oldBranch, newBranch) => {
       console.log(`Branch changed: ${oldBranch ?? "(none)"} -> ${newBranch}`);
-      await getIndexer2().index();
+      await getIndexer().index();
     });
   }
   return {
@@ -3619,7 +3662,7 @@ function pTimeout(promise, options) {
   } = options;
   let timer;
   let abortHandler;
-  const wrappedPromise = new Promise((resolve11, reject) => {
+  const wrappedPromise = new Promise((resolve12, reject) => {
     if (typeof milliseconds !== "number" || Math.sign(milliseconds) !== 1) {
       throw new TypeError(`Expected \`milliseconds\` to be a positive number, got \`${milliseconds}\``);
     }
@@ -3633,7 +3676,7 @@ function pTimeout(promise, options) {
       };
       signal.addEventListener("abort", abortHandler, { once: true });
     }
-    promise.then(resolve11, reject);
+    promise.then(resolve12, reject);
     if (milliseconds === Number.POSITIVE_INFINITY) {
       return;
     }
@@ -3641,7 +3684,7 @@ function pTimeout(promise, options) {
     timer = customTimers.setTimeout.call(void 0, () => {
       if (fallback) {
         try {
-          resolve11(fallback());
+          resolve12(fallback());
         } catch (error) {
           reject(error);
         }
@@ -3651,7 +3694,7 @@ function pTimeout(promise, options) {
         promise.cancel();
       }
       if (message === false) {
-        resolve11();
+        resolve12();
       } else if (message instanceof Error) {
         reject(message);
       } else {
@@ -4053,7 +4096,7 @@ var PQueue = class extends import_index.default {
       // Assign unique ID if not provided
       id: options.id ?? (this.#idAssigner++).toString()
     };
-    return new Promise((resolve11, reject) => {
+    return new Promise((resolve12, reject) => {
       const taskSymbol = /* @__PURE__ */ Symbol(`task-${options.id}`);
       let cleanupQueueAbortHandler = () => void 0;
       const run = async () => {
@@ -4093,7 +4136,7 @@ var PQueue = class extends import_index.default {
             })]);
           }
           const result = await operation;
-          resolve11(result);
+          resolve12(result);
           this.emit("completed", result);
         } catch (error) {
           reject(error);
@@ -4281,13 +4324,13 @@ var PQueue = class extends import_index.default {
     });
   }
   async #onEvent(event, filter) {
-    return new Promise((resolve11) => {
+    return new Promise((resolve12) => {
       const listener = () => {
         if (filter && !filter()) {
           return;
         }
         this.off(event, listener);
-        resolve11();
+        resolve12();
       };
       this.on(event, listener);
     });
@@ -4573,7 +4616,7 @@ async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTi
   const finalDelay = Math.min(delayTime, remainingTime);
   options.signal?.throwIfAborted();
   if (finalDelay > 0) {
-    await new Promise((resolve11, reject) => {
+    await new Promise((resolve12, reject) => {
       const onAbort = () => {
         clearTimeout(timeoutToken);
         options.signal?.removeEventListener("abort", onAbort);
@@ -4581,7 +4624,7 @@ async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTi
       };
       const timeoutToken = setTimeout(() => {
         options.signal?.removeEventListener("abort", onAbort);
-        resolve11();
+        resolve12();
       }, finalDelay);
       if (options.unref) {
         timeoutToken.unref?.();
@@ -4822,6 +4865,8 @@ var BaseEmbeddingProvider = class {
     this.credentials = credentials;
     this.modelInfo = modelInfo;
   }
+  credentials;
+  modelInfo;
   async embedQuery(query) {
     const result = await this.embedBatch([query]);
     return {
@@ -6370,17 +6415,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();
@@ -6390,6 +6435,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);
@@ -9017,6 +9066,7 @@ var Indexer = class {
           targetName: site.calleeName,
           toSymbolId: void 0,
           callType: site.callType,
+          confidence: site.confidence,
           line: site.line,
           col: site.column,
           isResolved: false
@@ -9161,7 +9211,7 @@ var Indexer = class {
     for (const requestBatch of requestBatches) {
       queue.add(async () => {
         if (rateLimitBackoffMs > 0) {
-          await new Promise((resolve11) => setTimeout(resolve11, rateLimitBackoffMs));
+          await new Promise((resolve12) => setTimeout(resolve12, rateLimitBackoffMs));
         }
         try {
           const result = await pRetry(
@@ -10136,12 +10186,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);
@@ -10150,12 +10200,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);
@@ -10164,6 +10214,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;
@@ -10485,39 +10546,45 @@ function ensureStringArray(value) {
   return Array.isArray(value) ? value : [];
 }
 var z = import_plugin.tool.schema;
-var sharedIndexer = null;
-var sharedProjectRoot = "";
+var indexerMap = /* @__PURE__ */ new Map();
+var defaultProjectRoot = "";
 function initializeTools(projectRoot, config) {
-  sharedProjectRoot = projectRoot;
-  sharedIndexer = new Indexer(projectRoot, config);
-}
-function getSharedIndexer() {
-  return getIndexer();
+  defaultProjectRoot = projectRoot;
+  const indexer = new Indexer(projectRoot, config);
+  indexerMap.set(projectRoot, indexer);
 }
-function refreshIndexerFromConfig() {
-  if (!sharedProjectRoot) {
+function refreshIndexerForDirectory(projectRoot) {
+  if (!projectRoot) {
     throw new Error("Codebase index tools not initialized. Plugin may not be loaded correctly.");
   }
-  sharedIndexer = new Indexer(sharedProjectRoot, parseConfig(loadRuntimeConfig(sharedProjectRoot)));
+  const indexer = new Indexer(projectRoot, parseConfig(loadRuntimeConfig(projectRoot)));
+  indexerMap.set(projectRoot, indexer);
 }
-function shouldForceLocalizeProjectIndex() {
-  const currentConfig = parseConfig(loadRuntimeConfig(sharedProjectRoot));
+function shouldForceLocalizeProjectIndex(projectRoot) {
+  const currentConfig = parseConfig(loadRuntimeConfig(projectRoot));
   if (currentConfig.scope !== "project") {
     return false;
   }
-  const localIndexPath = path15.join(sharedProjectRoot, ".opencode", "index");
-  const mainRepoRoot = resolveWorktreeMainRepoRoot(sharedProjectRoot);
+  const localIndexPath = path15.join(projectRoot, ".opencode", "index");
+  const mainRepoRoot = resolveWorktreeMainRepoRoot(projectRoot);
   if (!mainRepoRoot) {
     return false;
   }
   const inheritedIndexPath = path15.join(mainRepoRoot, ".opencode", "index");
   return !(0, import_fs9.existsSync)(localIndexPath) && (0, import_fs9.existsSync)(inheritedIndexPath);
 }
-function getIndexer() {
-  if (!sharedIndexer) {
+function getIndexerForProject(directory) {
+  const projectRoot = directory || defaultProjectRoot;
+  if (!projectRoot) {
     throw new Error("Codebase index tools not initialized. Plugin may not be loaded correctly.");
   }
-  return sharedIndexer;
+  let indexer = indexerMap.get(projectRoot);
+  if (!indexer) {
+    const config = parseConfig(loadRuntimeConfig(projectRoot));
+    indexer = new Indexer(projectRoot, config);
+    indexerMap.set(projectRoot, indexer);
+  }
+  return indexer;
 }
 var codebase_peek = (0, import_plugin.tool)({
   description: "Quick lookup of code locations by meaning. Returns only metadata (file, line, name, type) WITHOUT code content. Use this first to find WHERE code is, then use Read tool to examine specific files. Saves tokens by not returning full code blocks. Best for: discovery, navigation, finding multiple related locations.",
@@ -10528,8 +10595,8 @@ var codebase_peek = (0, import_plugin.tool)({
     directory: z.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
     chunkType: z.enum(["function", "class", "method", "interface", "type", "enum", "struct", "impl", "trait", "module", "other"]).optional().describe("Filter by code chunk type")
   },
-  async execute(args) {
-    const indexer = getIndexer();
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const results = await indexer.search(args.query, args.limit ?? 10, {
       fileType: args.fileType,
       directory: args.directory,
@@ -10547,16 +10614,17 @@ var index_codebase = (0, import_plugin.tool)({
     verbose: z.boolean().optional().default(false).describe("Show detailed info about skipped files and parsing failures")
   },
   async execute(args, context) {
-    let indexer = getIndexer();
+    const projectRoot = context?.worktree || defaultProjectRoot;
+    let indexer = getIndexerForProject(projectRoot);
     if (args.estimateOnly) {
       const estimate = await indexer.estimateCost();
       return formatCostEstimate(estimate);
     }
     if (args.force) {
-      if (shouldForceLocalizeProjectIndex()) {
-        materializeLocalProjectConfig(sharedProjectRoot, loadProjectConfigLayer(sharedProjectRoot));
-        refreshIndexerFromConfig();
-        indexer = getIndexer();
+      if (shouldForceLocalizeProjectIndex(projectRoot)) {
+        materializeLocalProjectConfig(projectRoot, loadProjectConfigLayer(projectRoot));
+        refreshIndexerForDirectory(projectRoot);
+        indexer = getIndexerForProject(projectRoot);
       }
       await indexer.clearIndex();
     }
@@ -10579,8 +10647,8 @@ var index_codebase = (0, import_plugin.tool)({
 var index_status = (0, import_plugin.tool)({
   description: "Check the status of the codebase index. Shows whether the codebase is indexed, how many chunks are stored, and the embedding provider being used.",
   args: {},
-  async execute() {
-    const indexer = getIndexer();
+  async execute(_args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const status = await indexer.getStatus();
     return formatStatus(status);
   }
@@ -10588,8 +10656,8 @@ var index_status = (0, import_plugin.tool)({
 var index_health_check = (0, import_plugin.tool)({
   description: "Check index health and remove stale entries from deleted files. Run this to clean up the index after files have been deleted.",
   args: {},
-  async execute() {
-    const indexer = getIndexer();
+  async execute(_args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const result = await indexer.healthCheck();
     return formatHealthCheck(result);
   }
@@ -10597,8 +10665,8 @@ var index_health_check = (0, import_plugin.tool)({
 var index_metrics = (0, import_plugin.tool)({
   description: "Get metrics and performance statistics for the codebase index. Shows indexing stats, search timings, cache hit rates, and API usage. Requires debug.enabled=true and debug.metrics=true in config.",
   args: {},
-  async execute() {
-    const indexer = getIndexer();
+  async execute(_args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const logger = indexer.getLogger();
     if (!logger.isEnabled()) {
       return 'Debug mode is disabled. Enable it in your config:\n\n```json\n{\n  "debug": {\n    "enabled": true,\n    "metrics": true\n  }\n}\n```';
@@ -10616,8 +10684,8 @@ var index_logs = (0, import_plugin.tool)({
     category: z.enum(["search", "embedding", "cache", "gc", "branch", "general"]).optional().describe("Filter by log category"),
     level: z.enum(["error", "warn", "info", "debug"]).optional().describe("Filter by minimum log level")
   },
-  async execute(args) {
-    const indexer = getIndexer();
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const logger = indexer.getLogger();
     if (!logger.isEnabled()) {
       return 'Debug mode is disabled. Enable it in your config:\n\n```json\n{\n  "debug": {\n    "enabled": true\n  }\n}\n```';
@@ -10643,8 +10711,8 @@ var find_similar = (0, import_plugin.tool)({
     chunkType: z.enum(["function", "class", "method", "interface", "type", "enum", "struct", "impl", "trait", "module", "other"]).optional().describe("Filter by code chunk type"),
     excludeFile: z.string().optional().describe("Exclude results from this file path (useful when searching for duplicates of code from a specific file)")
   },
-  async execute(args) {
-    const indexer = getIndexer();
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const results = await indexer.findSimilar(args.code, args.limit, {
       fileType: args.fileType,
       directory: args.directory,
@@ -10667,8 +10735,8 @@ var codebase_search = (0, import_plugin.tool)({
     chunkType: z.enum(["function", "class", "method", "interface", "type", "enum", "struct", "impl", "trait", "module", "other"]).optional().describe("Filter by code chunk type"),
     contextLines: z.number().optional().describe("Number of extra lines to include before/after each match (default: 0)")
   },
-  async execute(args) {
-    const indexer = getIndexer();
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const results = await indexer.search(args.query, args.limit ?? 5, {
       fileType: args.fileType,
       directory: args.directory,
@@ -10689,8 +10757,8 @@ var implementation_lookup = (0, import_plugin.tool)({
     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();
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     const results = await indexer.search(args.query, args.limit ?? 5, {
       fileType: args.fileType,
       directory: args.directory,
@@ -10700,46 +10768,72 @@ var implementation_lookup = (0, import_plugin.tool)({
   }
 });
 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.",
+  description: "Query the call graph to find callers or callees of a function/method. Use to understand code flow and dependencies between functions. Supports relationship types: Call, MethodCall, Constructor, Import, Inherits, Implements.",
   args: {
     name: z.string().describe("Function or method name to query"),
     direction: z.enum(["callers", "callees"]).default("callers").describe("Direction: 'callers' finds who calls this function, 'callees' finds what this function calls"),
-    symbolId: z.string().optional().describe("Symbol ID (required for 'callees' direction, returned by previous call_graph queries)")
+    symbolId: z.string().optional().describe("Symbol ID (required for 'callees' direction, returned by previous call_graph queries)"),
+    relationshipType: z.enum(["Call", "MethodCall", "Constructor", "Import", "Inherits", "Implements"]).optional().describe("Filter by relationship type. Omit to show all.")
   },
-  async execute(args) {
-    const indexer = getIndexer();
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
     if (args.direction === "callees") {
       if (!args.symbolId) {
         return "Error: 'symbolId' is required when direction is 'callees'. First use direction='callers' to find the symbol ID.";
       }
-      const callees = await indexer.getCallees(args.symbolId);
+      const callees = await indexer.getCallees(args.symbolId, args.relationshipType);
       if (callees.length === 0) {
-        return `No callees found for symbol ${args.symbolId}. The function may not call any other tracked functions.`;
+        return `No callees found for symbol ${args.symbolId}${args.relationshipType ? ` with type ${args.relationshipType}` : ""}. The function may not call any other tracked functions.`;
       }
-      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 formatted2.join("\n");
     }
-    const callers = await indexer.getCallers(args.name);
+    const callers = await indexer.getCallers(args.name, args.relationshipType);
     if (callers.length === 0) {
-      return `No callers found for "${args.name}". It may not be called by any tracked function, or the index needs updating.`;
+      return `No callers found for "${args.name}"${args.relationshipType ? ` with type ${args.relationshipType}` : ""}. It may not be called by any tracked function, or the index needs updating.`;
     }
-    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 formatted.join("\n");
   }
 });
+var call_graph_path = (0, import_plugin.tool)({
+  description: "Find the shortest connection path between two symbols in the call graph. Given a source and target function/method name, returns the chain of calls connecting them.",
+  args: {
+    from: z.string().describe("Source function/method name (starting point)"),
+    to: z.string().describe("Target function/method name (destination)"),
+    maxDepth: z.number().optional().default(10).describe("Maximum traversal depth (default: 10)")
+  },
+  async execute(args, context) {
+    const indexer = getIndexerForProject(context?.worktree);
+    const path18 = await indexer.findCallPath(args.from, args.to, args.maxDepth);
+    if (path18.length === 0) {
+      return `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 `Path (${path18.length} hops):
+${formatted.join("\n")}`;
+  }
+});
 var add_knowledge_base = (0, import_plugin.tool)({
   description: "Add a folder as a knowledge base to the semantic search index. The folder will be indexed alongside the main project code. Supports absolute paths or relative paths (relative to the project root).",
   args: {
     path: z.string().describe("Path to the folder to add as a knowledge base (absolute or relative to project root)")
   },
-  async execute(args) {
+  async execute(args, context) {
+    const projectRoot = context?.worktree || defaultProjectRoot;
     const inputPath = args.path.trim();
     const normalizedPath = path15.resolve(
-      path15.isAbsolute(inputPath) ? inputPath : resolveKnowledgeBasePath(inputPath, sharedProjectRoot)
+      path15.isAbsolute(inputPath) ? inputPath : resolveKnowledgeBasePath(inputPath, projectRoot)
     );
     if (!(0, import_fs9.existsSync)(normalizedPath)) {
       return `Error: Directory does not exist: ${normalizedPath}`;
@@ -10781,21 +10875,21 @@ var add_knowledge_base = (0, import_plugin.tool)({
     } catch (error) {
       return `Error: Cannot access directory: ${normalizedPath} - ${error instanceof Error ? error.message : String(error)}`;
     }
-    const config = loadEditableConfig(sharedProjectRoot);
+    const config = loadEditableConfig(projectRoot);
     const knowledgeBases = ensureStringArray(config.knowledgeBases);
-    const alreadyExists = hasMatchingKnowledgeBasePath(knowledgeBases, normalizedPath, sharedProjectRoot);
+    const alreadyExists = hasMatchingKnowledgeBasePath(knowledgeBases, normalizedPath, projectRoot);
     if (alreadyExists) {
       return `Knowledge base already configured: ${normalizedPath}`;
     }
     knowledgeBases.push(normalizedPath);
     config.knowledgeBases = knowledgeBases;
-    saveConfig(sharedProjectRoot, config);
-    refreshIndexerFromConfig();
+    saveConfig(projectRoot, config);
+    refreshIndexerForDirectory(projectRoot);
     let result = `${normalizedPath}
 `;
     result += `Total knowledge bases: ${knowledgeBases.length}
 `;
-    result += `Config saved to: ${getConfigPath(sharedProjectRoot)}
+    result += `Config saved to: ${getConfigPath(projectRoot)}
 `;
     result += `
 Run /index to rebuild the index with the new knowledge base.`;
@@ -10805,8 +10899,9 @@ Run /index to rebuild the index with the new knowledge base.`;
 var list_knowledge_bases = (0, import_plugin.tool)({
   description: "List all configured knowledge base folders that are indexed alongside the main project.",
   args: {},
-  async execute() {
-    const config = loadRuntimeConfig(sharedProjectRoot);
+  async execute(_args, context) {
+    const projectRoot = context?.worktree || defaultProjectRoot;
+    const config = loadRuntimeConfig(projectRoot);
     const knowledgeBases = ensureStringArray(config.knowledgeBases);
     if (knowledgeBases.length === 0) {
       return "No knowledge bases configured. Use add_knowledge_base to add folders.";
@@ -10816,7 +10911,7 @@ var list_knowledge_bases = (0, import_plugin.tool)({
 `;
     for (let i = 0; i < knowledgeBases.length; i++) {
       const kb = knowledgeBases[i];
-      const resolvedPath = resolveKnowledgeBasePath(kb, sharedProjectRoot);
+      const resolvedPath = resolveKnowledgeBasePath(kb, projectRoot);
       const exists = (0, import_fs9.existsSync)(resolvedPath);
       result += `[${i + 1}] ${kb}
 `;
@@ -10834,7 +10929,7 @@ var list_knowledge_bases = (0, import_plugin.tool)({
       }
       result += "\n";
     }
-    result += `Config file: ${getConfigPath(sharedProjectRoot)}`;
+    result += `Config file: ${getConfigPath(projectRoot)}`;
     return result;
   }
 });
@@ -10843,14 +10938,15 @@ var remove_knowledge_base = (0, import_plugin.tool)({
   args: {
     path: z.string().describe("Path of the knowledge base to remove (must match the configured path exactly)")
   },
-  async execute(args) {
+  async execute(args, context) {
+    const projectRoot = context?.worktree || defaultProjectRoot;
     const inputPath = args.path.trim();
-    const config = loadEditableConfig(sharedProjectRoot);
+    const config = loadEditableConfig(projectRoot);
     const knowledgeBases = ensureStringArray(config.knowledgeBases);
     if (knowledgeBases.length === 0) {
       return "No knowledge bases configured.";
     }
-    const index = findKnowledgeBasePathIndex(knowledgeBases, inputPath, sharedProjectRoot);
+    const index = findKnowledgeBasePathIndex(knowledgeBases, inputPath, projectRoot);
     if (index === -1) {
       let result2 = `Knowledge base not found: ${inputPath}
 
@@ -10865,14 +10961,14 @@ var remove_knowledge_base = (0, import_plugin.tool)({
     }
     const removed = knowledgeBases.splice(index, 1)[0];
     config.knowledgeBases = knowledgeBases;
-    saveConfig(sharedProjectRoot, config);
-    refreshIndexerFromConfig();
+    saveConfig(projectRoot, config);
+    refreshIndexerForDirectory(projectRoot);
     let result = `Removed: ${removed}
 
 `;
     result += `Remaining knowledge bases: ${knowledgeBases.length}
 `;
-    result += `Config saved to: ${getConfigPath(sharedProjectRoot)}
+    result += `Config saved to: ${getConfigPath(projectRoot)}
 `;
     result += `
 Run /index to rebuild the index without the removed knowledge base.`;
@@ -11159,6 +11255,8 @@ var RoutingHintController = class {
     this.getStatus = getStatus;
     this.maxSessions = maxSessions;
   }
+  getStatus;
+  maxSessions;
   sessionState = /* @__PURE__ */ new Map();
   observeUserMessage(sessionID, parts) {
     const assessment = assessRoutingIntent(extractUserText(parts));
@@ -11216,10 +11314,16 @@ var RoutingHintController = class {
 
 // src/index.ts
 var import_meta2 = {};
-var activeWatcher = null;
-function replaceActiveWatcher(nextWatcher) {
-  activeWatcher?.stop();
-  activeWatcher = nextWatcher;
+var activeWatchers = /* @__PURE__ */ new Map();
+function replaceActiveWatcher(projectRoot, nextWatcher) {
+  const existing = activeWatchers.get(projectRoot);
+  if (existing) {
+    existing.stop();
+    activeWatchers.delete(projectRoot);
+  }
+  if (nextWatcher) {
+    activeWatchers.set(projectRoot, nextWatcher);
+  }
 }
 function getCommandsDir() {
   let currentDir = process.cwd();
@@ -11228,21 +11332,37 @@ function getCommandsDir() {
   }
   return path17.join(currentDir, "..", "commands");
 }
-var plugin = async ({ directory }) => {
+function appendRoutingHints(output, hints, preferredRole) {
+  const preferredBucket = preferredRole === "developer" ? output.developer : output.system;
+  if (Array.isArray(preferredBucket)) {
+    preferredBucket.push(...hints);
+    return;
+  }
+  if (Array.isArray(output.system)) {
+    output.system.push(...hints);
+  }
+}
+var plugin = async ({ directory, worktree }) => {
   try {
-    const projectRoot = directory;
+    const projectRoot = worktree || directory;
     const rawConfig = loadMergedConfig(projectRoot);
     const config = parseConfig(rawConfig);
     initializeTools(projectRoot, config);
-    const indexer = getSharedIndexer();
-    const routingHints = config.search.routingHints ? new RoutingHintController(() => indexer.getStatus()) : null;
-    const isValidProject = !config.indexing.requireProjectMarker || hasProjectMarker(projectRoot);
-    if (!isValidProject) {
+    const getProjectIndexer = () => getIndexerForProject(projectRoot);
+    const routingHints = config.search.routingHints ? new RoutingHintController(() => getProjectIndexer().getStatus()) : null;
+    const isHomeDir = path17.resolve(projectRoot) === path17.resolve(os6.homedir());
+    const isValidProject = !isHomeDir && (!config.indexing.requireProjectMarker || hasProjectMarker(projectRoot));
+    if (isHomeDir) {
+      console.warn(
+        `[codebase-index] Refusing to watch or index home directory "${projectRoot}". Open a specific project directory instead.`
+      );
+    } else if (!isValidProject) {
       console.warn(
         `[codebase-index] Skipping file watching and auto-indexing: no project marker found in "${projectRoot}". Set "indexing.requireProjectMarker": false in config to override.`
       );
     }
     if (config.indexing.autoIndex && isValidProject) {
+      const indexer = getProjectIndexer();
       indexer.initialize().then(() => {
         indexer.index().catch(() => {
         });
@@ -11250,9 +11370,9 @@ var plugin = async ({ directory }) => {
       });
     }
     if (config.indexing.watchFiles && isValidProject) {
-      replaceActiveWatcher(createWatcherWithIndexer(getSharedIndexer, projectRoot, config));
+      replaceActiveWatcher(projectRoot, createWatcherWithIndexer(getProjectIndexer, projectRoot, config));
     } else {
-      replaceActiveWatcher(null);
+      replaceActiveWatcher(projectRoot, null);
     }
     return {
       tool: {
@@ -11265,6 +11385,7 @@ var plugin = async ({ directory }) => {
         index_logs,
         find_similar,
         call_graph,
+        call_graph_path,
         implementation_lookup,
         add_knowledge_base,
         list_knowledge_bases,
@@ -11274,8 +11395,18 @@ var plugin = async ({ directory }) => {
         routingHints?.observeUserMessage(input.sessionID, output.parts);
       },
       async "experimental.chat.system.transform"(input, output) {
+        if (config.search.routingHintRole !== "system") {
+          return;
+        }
         const hints = await routingHints?.getSystemHints(input.sessionID) ?? [];
-        output.system.push(...hints);
+        appendRoutingHints(output, hints, "system");
+      },
+      async "experimental.chat.developer.transform"(input, output) {
+        if (config.search.routingHintRole !== "developer") {
+          return;
+        }
+        const hints = await routingHints?.getSystemHints(input.sessionID) ?? [];
+        appendRoutingHints(output, hints, "developer");
       },
       async "tool.execute.after"(input) {
         routingHints?.markToolUsed(input.sessionID, input.tool);
@@ -11289,8 +11420,8 @@ var plugin = async ({ directory }) => {
         }
       }
     };
-  } catch (error) {
-    console.error("[codebase-index] Failed to initialize plugin:", error);
+  } catch {
+    console.error("[codebase-index] Failed to initialize plugin (check config and network)");
     return {
       tool: void 0,
       async config() {