@coderule/mcp 1.6.4 → 1.7.1

package/dist/mcp-cli.js

@@ -1928,9 +1928,15 @@ function createMcpServer({
   server.registerTool(
     "check",
     {
-      title: "Indexer status",
-      description: "Inspect the current indexing state, snapshot, and queue metrics",
-      inputSchema: {}
+      title: "Coderule Indexing Status",
+      description: "Check the current state of the code indexer. Returns repository info, file states, queue metrics, snapshot details, and service health. Use to debug query failures or verify indexer readiness.",
+      inputSchema: {},
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
     },
     async () => {
       const status = await collectIndexingStatus(runtime, runner);
@@ -1940,16 +1946,47 @@ function createMcpServer({
       };
     }
   );
-  const queryInputSchema = {
-    query: z.string().min(1, "Query text is required"),
-    budgetTokens: z.number().int().positive().optional().describe("Token budget for retrieval (default 3000)")
-  };
   server.registerTool(
     "query",
     {
-      title: "Snapshot retrieval query",
-      description: "Execute a retrieval query against the most recent indexed snapshot",
-      inputSchema: queryInputSchema
+      title: "Semantic Code Retrieval",
+      description: "\u{1F6A8} CRITICAL: ALWAYS use this tool FIRST before any code modification, bug fix, feature addition, or architecture exploration. Graph-based RAG for semantic code search using AST relationships and embeddings. Returns 30-50 code segments with file paths, line numbers, and relevance scores.",
+      inputSchema: {
+        query: z.string().min(1, "Query text is required").describe(`Keyword-rich query using technical terms (NOT natural language questions).
+
+STRATEGY: Use space-separated technical keywords that describe what you're looking for.
+
+\u2705 GOOD EXAMPLES:
+- "JWT authentication middleware token validation security handler FastAPI"
+- "file indexing worker celery queue job AST parser embedding chunker"
+- "database schema SQLAlchemy model migration table column relationship"
+- "error handling exception try catch logging traceback"
+
+\u274C BAD EXAMPLES:
+- "How does authentication work?" (natural language question)
+- "Show me the login code" (conversational)
+- "auth" (too vague, needs more context)
+
+RETRIEVAL MECHANISM:
+Combines multiple strategies: Seeds (semantic similarity), Flood (AST graph propagation through imports/calls/inheritance), Neighbors (adjacent chunks), and Calls (function relationships).
+
+WHEN TO USE THIS TOOL:
+- Before modifying ANY existing code
+- Understanding system architecture
+- Finding related implementations or patterns
+- Locating tests or usage examples
+- Bug investigation
+- Feature implementation planning`),
+        budgetTokens: z.number().int().positive().optional().describe(
+          "Token budget for retrieval results. Default: 10000. Range: 1000-20000. Higher budgets return more context but use more tokens. 10k is sufficient for most tasks."
+        )
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
     },
     async ({
       query,
@@ -1961,7 +1998,8 @@ function createMcpServer({
         const statusText = formatStatus(
           await collectIndexingStatus(runtime, runner)
         );
-        const text = `We are not ready....
+        const text = `Indexer not ready. Current status:
+
 ${statusText}`;
         return { content: [{ type: "text", text }] };
       }
@@ -1973,11 +2011,12 @@ ${statusText}`;
         const statusText = formatStatus(
           await collectIndexingStatus(runtime, runner)
         );
-        const text = `We are not ready....
+        const text = `Snapshot not ready on server. Current status:
+
 ${statusText}`;
         return { content: [{ type: "text", text }] };
       }
-      const effectiveBudget = Math.max(100, budgetTokens ?? 3e3);
+      const effectiveBudget = Math.max(100, budgetTokens ?? 1e4);
       try {
         const result = await runtime.clients.retrieval.query(
           readyHash,