feat: gate routing hints with search config

Author: Helweg

src/config/schema.ts

@@ -47,6 +47,7 @@ export interface SearchConfig {
   rrfK: number;
   rerankTopN: number;
   contextLines: number;
+  routingHints: boolean;
 }
 
 export type RerankerProvider = "cohere" | "jina" | "custom";
@@ -161,6 +162,7 @@ function getDefaultSearchConfig(): SearchConfig {
     rrfK: 60,
     rerankTopN: 20,
     contextLines: 0,
+    routingHints: true,
   };
 }
 
@@ -277,6 +279,7 @@ export function parseConfig(raw: unknown): ParsedCodebaseIndexConfig {
     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,
   };
 
   const rawDebug = (input.debug && typeof input.debug === "object" ? input.debug : {}) as Record<string, unknown>;

src/index.ts

@@ -23,6 +23,7 @@ import {
   initializeTools,
 } from "./tools/index.js";
 import { loadCommandsFromDirectory } from "./commands/loader.js";
+import { RoutingHintController } from "./routing-hints.js";
 import { hasProjectMarker } from "./utils/files.js";
 
 function getCommandsDir(): string {
@@ -44,6 +45,9 @@ const plugin: Plugin = async ({ directory }) => {
     initializeTools(projectRoot, config);
 
     const indexer = new Indexer(projectRoot, config);
+    const routingHints = config.search.routingHints
+      ? new RoutingHintController(() => indexer.getStatus())
+      : null;
 
     const isValidProject = !config.indexing.requireProjectMarker || hasProjectMarker(projectRoot);
 
@@ -81,6 +85,19 @@ const plugin: Plugin = async ({ directory }) => {
         remove_knowledge_base,
       },
 
+      async "chat.message"(input, output) {
+        routingHints?.observeUserMessage(input.sessionID, output.parts);
+      },
+
+      async "experimental.chat.system.transform"(input, output) {
+        const hints = await routingHints?.getSystemHints(input.sessionID) ?? [];
+        output.system.push(...hints);
+      },
+
+      async "tool.execute.after"(input) {
+        routingHints?.markToolUsed(input.sessionID, input.tool);
+      },
+
       async config(cfg) {
         cfg.command = cfg.command ?? {};
 

tests/config.test.ts

@@ -289,6 +289,16 @@ describe("config schema", () => {
         expect(config.search.fusionStrategy).toBe("rrf");
         expect(config.search.rrfK).toBe(60);
         expect(config.search.rerankTopN).toBe(20);
+        expect(config.search.routingHints).toBe(true);
+      });
+
+      it("should parse routingHints boolean", () => {
+        expect(parseConfig({ search: { routingHints: false } }).search.routingHints).toBe(false);
+        expect(parseConfig({ search: { routingHints: true } }).search.routingHints).toBe(true);
+      });
+
+      it("should fallback routingHints to default for invalid values", () => {
+        expect(parseConfig({ search: { routingHints: "nope" } }).search.routingHints).toBe(true);
       });
 
       it("should fallback fusionStrategy to default for invalid values", () => {