@coderule/mcp 1.7.0 → 1.7.1

package/dist/mcp-cli.js

@@ -1929,13 +1929,7 @@ function createMcpServer({
     "check",
     {
       title: "Coderule Indexing Status",
-      description: `Check the current state of the code indexer. Returns repository info, file states (clean/dirty/hashing/missing), queue metrics, latest snapshot details, and service health.
-
-Use this tool to:
-- Debug why queries are failing or returning no results
-- Verify the indexer is ready before querying
-- Check which repository is currently indexed
-- Monitor indexing progress`,
+      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,
@@ -1956,40 +1950,36 @@ Use this tool to:
     "query",
     {
       title: "Semantic Code Retrieval",
-      description: `Graph-based RAG for semantic code search across the indexed codebase.
-
-\u{1F6A8} CRITICAL: Use this tool FIRST before any code modification, bug fix, feature addition, or architecture exploration.
+      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).
 
-QUERY STRATEGY:
-Use keyword-rich technical terms, NOT natural language questions.
+STRATEGY: Use space-separated technical keywords that describe what you're looking for.
 
-\u2705 GOOD: "JWT authentication middleware token validation security handler FastAPI"
-\u2705 GOOD: "file indexing worker celery queue job AST parser embedding chunker"
-\u2705 GOOD: "database schema SQLAlchemy model migration table column relationship"
+\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: "How does authentication work?"
-\u274C BAD: "Show me the login code"
+\u274C BAD EXAMPLES:
+- "How does authentication work?" (natural language question)
+- "Show me the login code" (conversational)
+- "auth" (too vague, needs more context)
 
 RETRIEVAL MECHANISM:
-- Seeds: Semantic similarity via embeddings (~6 initial matches)
-- Flood: Graph propagation through AST relationships (imports, calls, inheritance)
-- Neighbors: Adjacent code chunks for context
-- Calls: Function call relationships
+Combines multiple strategies: Seeds (semantic similarity), Flood (AST graph propagation through imports/calls/inheritance), Neighbors (adjacent chunks), and Calls (function relationships).
 
-Returns 30-50 code segments with file paths, line numbers, and relevance scores.
-
-DEFAULT BUDGET: 10,000 tokens (sufficient for most tasks)
-
-WHEN TO USE:
+WHEN TO USE THIS TOOL:
 - Before modifying ANY existing code
 - Understanding system architecture
-- Finding related implementations
-- Locating tests or examples
+- Finding related implementations or patterns
+- Locating tests or usage examples
 - Bug investigation
-- Feature implementation planning`,
-      inputSchema: {
-        query: z.string().min(1, "Query text is required"),
-        budgetTokens: z.number().int().positive().optional().describe("Token budget for retrieval (default 10000)")
+- 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,