opencode-codebase-index 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -657,6 +657,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 +804,8 @@ function getDefaultSearchConfig() {
     rrfK: 60,
     rerankTopN: 20,
     contextLines: 0,
-    routingHints: true
+    routingHints: true,
+    routingHintRole: "system"
   };
 }
 function getDefaultRerankerBaseUrl(provider) {
@@ -924,7 +926,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 +1249,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 +2334,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 +2343,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 +3443,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 +3458,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 +3599,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 +3607,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 +3615,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 +3658,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 +3672,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 +3680,7 @@ function pTimeout(promise, options) {
     timer = customTimers.setTimeout.call(void 0, () => {
       if (fallback) {
         try {
-          resolve11(fallback());
+          resolve12(fallback());
         } catch (error) {
           reject(error);
         }
@@ -3651,7 +3690,7 @@ function pTimeout(promise, options) {
         promise.cancel();
       }
       if (message === false) {
-        resolve11();
+        resolve12();
       } else if (message instanceof Error) {
         reject(message);
       } else {
@@ -4053,7 +4092,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 +4132,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 +4320,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 +4612,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 +4620,7 @@ async function onAttemptFailure({ error, attemptNumber, retriesConsumed, startTi
       };
       const timeoutToken = setTimeout(() => {
         options.signal?.removeEventListener("abort", onAbort);
-        resolve11();
+        resolve12();
       }, finalDelay);
       if (options.unref) {
         timeoutToken.unref?.();
@@ -9161,7 +9200,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(
@@ -10485,39 +10524,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);
+  defaultProjectRoot = projectRoot;
+  const indexer = new Indexer(projectRoot, config);
+  indexerMap.set(projectRoot, indexer);
 }
-function getSharedIndexer() {
-  return getIndexer();
-}
-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 +10573,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 +10592,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 +10625,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 +10634,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 +10643,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 +10662,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 +10689,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 +10713,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 +10735,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,
@@ -10706,8 +10752,8 @@ var call_graph = (0, import_plugin.tool)({
     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)")
   },
-  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.";
@@ -10736,10 +10782,11 @@ var add_knowledge_base = (0, import_plugin.tool)({
   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 +10828,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 +10852,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 +10864,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 +10882,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 +10891,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 +10914,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.`;
@@ -11216,10 +11265,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 +11283,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 +11321,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: {
@@ -11274,8 +11345,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 +11370,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() {