wiggum-cli 0.4.1 → 0.4.2

package/dist/ai/index.js

@@ -9,7 +9,7 @@ export { formatStackForPrompt, SYSTEM_PROMPT, SYSTEM_PROMPT_AGENTIC, createAnaly
 // Tools for agentic exploration
 export { createExplorationTools, RIPGREP_SKILL, } from './tools.js';
 // New tools (Tavily, Context7)
-export { createTavilySearchTool, canUseTavily, createContext7Tool, canUseContext7, } from './tools/index.js';
+export { createTavilySearchTool, canUseTavily, createContext7Tools, canUseContext7, } from './tools/index.js';
 // Agents - New 4-phase architecture
 export { 
 // Main orchestration

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yBAAyB;AACzB,OAAO,EAIL,QAAQ,EACR,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,mBAAmB;AACnB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,gCAAgC;AAChC,OAAO,EACL,sBAAsB,EACtB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,+BAA+B;AAC/B,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,oCAAoC;AACpC,OAAO;AACL,qBAAqB;AACrB,qBAAqB;AACrB,oBAAoB;AACpB,uBAAuB;AACvB,4BAA4B;AAC5B,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB;AACnB,qCAAqC;AACrC,iBAAiB,EACjB,qBAAqB,EACrB,iCAAiC;AACjC,mBAAmB;AACnB,qBAAqB;AAcrB,8DAA8D;AAC9D,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,cAAc;AACd,OAAO,EAOL,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yBAAyB;AACzB,OAAO,EAIL,QAAQ,EACR,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,mBAAmB;AACnB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,gCAAgC;AAChC,OAAO,EACL,sBAAsB,EACtB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,+BAA+B;AAC/B,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,oCAAoC;AACpC,OAAO;AACL,qBAAqB;AACrB,qBAAqB;AACrB,oBAAoB;AACpB,uBAAuB;AACvB,4BAA4B;AAC5B,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB;AACnB,qCAAqC;AACrC,iBAAiB,EACjB,qBAAqB,EACrB,iCAAiC;AACjC,mBAAmB;AACnB,qBAAqB;AAcrB,8DAA8D;AAC9D,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,cAAc;AACd,OAAO,EAOL,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/ai/tools/context7.d.ts

@@ -1,32 +1,26 @@
 /**
- * Context7 Documentation Lookup Tool
- * Enables documentation lookup for libraries and frameworks
+ * Context7 Documentation Lookup Tools
+ * Uses official @upstash/context7-tools-ai-sdk for proper two-step workflow
  */
 /**
- * Context7 library info
- */
-export interface Context7Library {
-    id: string;
-    name: string;
-    description?: string;
-    codeSnippetCount?: number;
-}
-/**
- * Context7 documentation result
- */
-export interface Context7DocResult {
-    title: string;
-    content: string;
-    codeExamples?: string[];
-}
-/**
- * Create a Context7 documentation lookup tool
+ * Create Context7 tools using official AI SDK integration
+ *
+ * The official tools implement the proper two-step workflow:
+ * 1. resolveLibraryId - finds the correct library ID
+ * 2. queryDocs - queries documentation with specific questions
+ *
  * @param apiKey - Context7 API key
  */
-export declare function createContext7Tool(apiKey: string): import("ai").Tool<{
-    library: string;
-    query: string;
-}, string>;
+export declare function createContext7Tools(apiKey: string): {
+    resolveLibraryId: import("ai").Tool<{
+        query: string;
+        libraryName: string;
+    }, string>;
+    queryDocs: import("ai").Tool<{
+        query: string;
+        libraryId: string;
+    }, string>;
+};
 /**
  * Check if Context7 can be used
  */

package/dist/ai/tools/context7.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context7.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/context7.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM;;;WAwFhD;AA0CD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD"}
+{"version":3,"file":"context7.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/context7.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;EAKjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/ai/tools/context7.js

@@ -1,130 +1,22 @@
 /**
- * Context7 Documentation Lookup Tool
- * Enables documentation lookup for libraries and frameworks
+ * Context7 Documentation Lookup Tools
+ * Uses official @upstash/context7-tools-ai-sdk for proper two-step workflow
  */
-import { tool, zodSchema } from 'ai';
-import { z } from 'zod';
+import { resolveLibraryId as createResolveLibraryIdTool, queryDocs as createQueryDocsTool, } from '@upstash/context7-tools-ai-sdk';
 /**
- * Create a Context7 documentation lookup tool
+ * Create Context7 tools using official AI SDK integration
+ *
+ * The official tools implement the proper two-step workflow:
+ * 1. resolveLibraryId - finds the correct library ID
+ * 2. queryDocs - queries documentation with specific questions
+ *
  * @param apiKey - Context7 API key
  */
-export function createContext7Tool(apiKey) {
-    return tool({
-        description: `Look up documentation for libraries and frameworks.
-Use this to find:
-- API documentation for specific functions
-- Usage examples and patterns
-- Configuration options
-- Best practices from official docs`,
-        inputSchema: zodSchema(z.object({
-            library: z.string().describe('Library name (e.g., "react", "express", "prisma")'),
-            query: z.string().describe('What you want to find in the documentation'),
-        })),
-        execute: async ({ library, query }) => {
-            try {
-                // First, resolve the library ID
-                const resolveResponse = await fetch('https://api.context7.com/v1/resolve-library-id', {
-                    method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                        'Authorization': `Bearer ${apiKey}`,
-                    },
-                    body: JSON.stringify({
-                        libraryName: library,
-                        query: query,
-                    }),
-                });
-                if (!resolveResponse.ok) {
-                    // Try alternative endpoint structure
-                    return await fallbackDocLookup(apiKey, library, query);
-                }
-                const resolveData = await resolveResponse.json();
-                const libraryId = resolveData.libraryId || resolveData.libraries?.[0]?.id;
-                if (!libraryId) {
-                    return `No documentation found for "${library}". Try a different library name.`;
-                }
-                // Query the documentation
-                const queryResponse = await fetch('https://api.context7.com/v1/query-docs', {
-                    method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                        'Authorization': `Bearer ${apiKey}`,
-                    },
-                    body: JSON.stringify({
-                        libraryId,
-                        query,
-                    }),
-                });
-                if (!queryResponse.ok) {
-                    const errorText = await queryResponse.text();
-                    return `Documentation lookup failed: ${queryResponse.status} - ${errorText}`;
-                }
-                const docsData = await queryResponse.json();
-                // Format results
-                const results = [];
-                results.push(`Documentation for ${library}:`);
-                results.push('');
-                if (docsData.results && docsData.results.length > 0) {
-                    for (const doc of docsData.results.slice(0, 3)) {
-                        results.push(`## ${doc.title}`);
-                        results.push(doc.content.substring(0, 500));
-                        if (doc.codeExamples && doc.codeExamples.length > 0) {
-                            results.push('');
-                            results.push('Example:');
-                            results.push('```');
-                            results.push(doc.codeExamples[0].substring(0, 300));
-                            results.push('```');
-                        }
-                        results.push('');
-                    }
-                }
-                else {
-                    results.push(`No specific documentation found for query: "${query}"`);
-                }
-                return results.join('\n');
-            }
-            catch (error) {
-                const errMsg = error instanceof Error ? error.message : String(error);
-                return `Documentation lookup error: ${errMsg}`;
-            }
-        },
-    });
-}
-/**
- * Fallback documentation lookup using alternative approach
- */
-async function fallbackDocLookup(apiKey, library, query) {
-    try {
-        // Try a simpler query format
-        const response = await fetch(`https://api.context7.com/v1/search`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`,
-            },
-            body: JSON.stringify({
-                query: `${library} ${query}`,
-                limit: 5,
-            }),
-        });
-        if (!response.ok) {
-            return `Unable to find documentation for "${library}". The Context7 API may not support this library or the request format has changed.`;
-        }
-        const data = await response.json();
-        if (data.results && data.results.length > 0) {
-            const results = [`Documentation for ${library}:`, ''];
-            for (const item of data.results.slice(0, 3)) {
-                results.push(`## ${item.title}`);
-                results.push(item.content.substring(0, 400));
-                results.push('');
-            }
-            return results.join('\n');
-        }
-        return `No documentation found for "${library}" with query "${query}"`;
-    }
-    catch {
-        return `Documentation lookup for "${library}" failed. Please check your Context7 API key.`;
-    }
+export function createContext7Tools(apiKey) {
+    return {
+        resolveLibraryId: createResolveLibraryIdTool({ apiKey }),
+        queryDocs: createQueryDocsTool({ apiKey }),
+    };
 }
 /**
  * Check if Context7 can be used

package/dist/ai/tools/context7.js.map

@@ -1 +1 @@
-{"version":3,"file":"context7.js","sourceRoot":"","sources":["../../../src/ai/tools/context7.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context7.js","sourceRoot":"","sources":["../../../src/ai/tools/context7.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gBAAgB,IAAI,0BAA0B,EAC9C,SAAS,IAAI,mBAAmB,GACjC,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO;QACL,gBAAgB,EAAE,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;QACxD,SAAS,EAAE,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/dist/ai/tools/index.d.ts

@@ -3,5 +3,5 @@
  * Exports all tools for agent use
  */
 export { createTavilySearchTool, canUseTavily, type TavilySearchResult, } from './tavily.js';
-export { createContext7Tool, canUseContext7, type Context7Library, type Context7DocResult, } from './context7.js';
+export { createContext7Tools, canUseContext7, } from './context7.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ai/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/ai/tools/index.js

@@ -3,5 +3,5 @@
  * Exports all tools for agent use
  */
 export { createTavilySearchTool, canUseTavily, } from './tavily.js';
-export { createContext7Tool, canUseContext7, } from './context7.js';
+export { createContext7Tools, canUseContext7, } from './context7.js';
 //# sourceMappingURL=index.js.map

package/dist/ai/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,YAAY,GAEb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,cAAc,GAGf,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,YAAY,GAEb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/ai/tools/tavily.d.ts

@@ -19,6 +19,7 @@ export declare function createTavilySearchTool(apiKey: string): import("ai").Too
     query: string;
     searchDepth?: "basic" | "advanced" | undefined;
     maxResults?: number | undefined;
+    timeRange?: "day" | "week" | "month" | "year" | undefined;
 }, string>;
 /**
  * Create a function that checks if Tavily search can be performed

package/dist/ai/tools/tavily.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/tavily.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAWD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM;;;;WA8DpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAErD"}
+{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/tavily.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAWD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM;;;;;WAmEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/ai/tools/tavily.js

@@ -10,20 +10,24 @@ import { z } from 'zod';
  */
 export function createTavilySearchTool(apiKey) {
     return tool({
-        description: `Search the web for current best practices, documentation, and recent information.
-Use this to find:
-- Current best practices for technologies
-- Testing patterns and tools
-- Library documentation and examples
-- Recent updates and changes`,
+        description: `Search the web for current information.
+
+USAGE TIPS:
+- Keep queries concise and specific (not conversational)
+- Use timeRange: "year" for recent best practices
+- Break complex research into focused individual searches
+- Good: "Express middleware error handling patterns"
+- Bad: "best practices production 2024 testing documentation"`,
         inputSchema: zodSchema(z.object({
-            query: z.string().describe('Search query - be specific about what you want to find'),
+            query: z.string().describe('Search query - be specific and concise'),
             searchDepth: z.enum(['basic', 'advanced']).optional()
                 .describe('Search depth - use "advanced" for comprehensive results'),
             maxResults: z.number().min(1).max(10).optional()
                 .describe('Maximum number of results (default 5)'),
+            timeRange: z.enum(['day', 'week', 'month', 'year']).optional()
+                .describe('Time filter for results. Use "year" for recent best practices'),
         })),
-        execute: async ({ query, searchDepth, maxResults }) => {
+        execute: async ({ query, searchDepth, maxResults, timeRange }) => {
             try {
                 const response = await fetch('https://api.tavily.com/search', {
                     method: 'POST',
@@ -35,6 +39,7 @@ Use this to find:
                         query,
                         search_depth: searchDepth || 'basic',
                         max_results: maxResults || 5,
+                        ...(timeRange && { time_range: timeRange }),
                         include_answer: true,
                         include_raw_content: false,
                     }),

package/dist/ai/tools/tavily.js.map

@@ -1 +1 @@
-{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../src/ai/tools/tavily.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../src/ai/tools/tavily.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiggum-cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -32,6 +32,7 @@
     "@ai-sdk/openai": "^3.0.12",
     "@braintrust/otel": "^0.2.0",
     "@clack/prompts": "^0.7.0",
+    "@upstash/context7-tools-ai-sdk": "^0.2.1",
     "ai": "^6.0.41",
     "braintrust": "^2.0.2",
     "cfonts": "^3.2.0",

package/src/ai/agents/context-enricher.ts

@@ -15,7 +15,7 @@ import { detectProjectType } from './stack-utils.js';
 /**
  * System prompt for the Context Enricher worker
  */
-const CONTEXT_ENRICHER_SYSTEM_PROMPT = `You are a Context Enricher worker. Your job is to explore specific areas of a codebase and answer specific questions.
+const CONTEXT_ENRICHER_SYSTEM_PROMPT = `You are a Context Enricher worker. Your job is to explore specific areas of a codebase and discover ACTUAL file paths and structures.
 
 ## Your Mission
 Based on the analysis plan, explore the codebase to:
@@ -32,28 +32,48 @@ Based on the analysis plan, explore the codebase to:
 - getPackageInfo: Get package.json info
 
 ## Exploration Strategy
-1. List the areas specified in the plan
-2. Read package.json to understand scripts and dependencies
-3. Search for patterns to answer the specific questions
-4. Identify the project type based on structure
-
-## Project Types
-- MCP Server: Has @modelcontextprotocol dependencies
-- REST API: Express/Fastify/Hono with route handlers
-- React SPA: React with components, no server-side rendering
-- Next.js App: Next.js with app or pages directory
-- CLI Tool: Has bin entry in package.json
-- Library: Published package without app entry
+1. Read package.json FIRST for main/bin entries - these are authoritative entry points
+2. List root directory to discover actual structure (src/, app/, pages/, lib/, cmd/, etc.)
+3. Explore discovered directories to understand their purpose
+4. Search for patterns to answer specific questions
+
+## Project Types & Entry Point Patterns
+- MCP Server: Has @modelcontextprotocol deps → main field or src/index.ts
+- REST API: Express/Fastify/Hono → main field, app.ts, server.ts, or src/
+- Next.js App: next in deps → app/page.tsx, pages/index.tsx, or pages/_app.tsx
+- CLI Tool: Has bin entry in package.json → use the bin paths directly
+- Library: main/module fields → use those paths
+- Python: main.py, app.py, or __main__.py at root
+- Go: main.go or cmd/*/main.go
+
+## CRITICAL: Output Requirements
+- entryPoints: ONLY actual file paths you discovered
+  - NEVER output instructions like "Check package.json..."
+  - NEVER output suggestions like "If exists, use..."
+  - Priority order for discovery:
+    1. package.json "bin" field paths (for CLI tools)
+    2. package.json "main" or "module" field paths
+    3. Framework conventions (app/page.tsx, pages/index.tsx)
+    4. Common patterns you find (index.ts, main.ts, app.ts)
+  - If truly nothing found, use empty array [] - don't guess
+- keyDirectories: ONLY directories that actually exist with their discovered purpose
+  - First list root to find actual directories (don't assume src/ exists)
+  - Map each real directory to its purpose based on file contents
+  - Example: {"src/commands": "CLI commands", "app": "Next.js app router"}
 
 ## Output Format
-After exploration, output ONLY valid JSON:
+Output ONLY valid JSON with discovered facts, not exploration instructions:
 {
-  "entryPoints": ["src/index.ts"],
-  "keyDirectories": {"src/routes": "API routes", "src/components": "UI components"},
+  "entryPoints": ["bin/cli.js", "dist/index.js"],
+  "keyDirectories": {
+    "src": "TypeScript source code",
+    "bin": "CLI entry scripts",
+    "lib": "Compiled output"
+  },
   "namingConventions": "camelCase files, PascalCase components",
   "commands": {"test": "npm test", "build": "npm run build"},
   "answeredQuestions": {"What is the auth strategy?": "NextAuth with JWT"},
-  "projectType": "Next.js App"
+  "projectType": "CLI Tool"
 }`;
 
 /**
@@ -87,7 +107,7 @@ Start by exploring the specified areas, then answer the questions and produce yo
       system: CONTEXT_ENRICHER_SYSTEM_PROMPT,
       prompt,
       tools,
-      stopWhen: stepCountIs(5),
+      stopWhen: stepCountIs(8), // Increased from 5 to allow proper directory exploration
       maxOutputTokens: 3000,
       ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
       experimental_telemetry: {

package/src/ai/agents/evaluator-optimizer.ts

@@ -39,6 +39,55 @@ const optimizerOutputSchema = z.object({
   additionalMcpServers: z.array(z.string()).describe('Additional MCP servers to recommend (empty array if none)'),
 });
 
+/**
+ * Patterns that indicate an entry point is an instruction, not a real path
+ */
+const INVALID_ENTRY_POINT_PATTERNS = [
+  /^check /i,
+  /^if /i,
+  /^open /i,
+  /^look /i,
+  /^search /i,
+  /^find /i,
+  /^inspect /i,
+  /^run /i,
+  /^see /i,
+  /^review /i,
+];
+
+/**
+ * Check if a single entry point looks like an actual file path (not an instruction)
+ */
+function isValidEntryPoint(ep: string): boolean {
+  // Must look like a file path
+  const looksLikePath = ep.includes('/') || ep.includes('.') || ep.startsWith('src') || ep.startsWith('app') || ep.startsWith('pages');
+  // Must not start with instruction words
+  const isNotInstruction = !INVALID_ENTRY_POINT_PATTERNS.some(pattern => pattern.test(ep));
+  return looksLikePath && isNotInstruction;
+}
+
+/**
+ * Check if entry points look like actual file paths (not instructions)
+ */
+function hasValidEntryPoints(entryPoints: string[]): boolean {
+  if (entryPoints.length === 0) return false;
+  return entryPoints.every(isValidEntryPoint);
+}
+
+/**
+ * Filter entry points to only include valid file paths
+ */
+function filterValidEntryPoints(entryPoints: string[]): string[] {
+  return entryPoints.filter(isValidEntryPoint);
+}
+
+/**
+ * Normalize MCP names (strip parenthetical explanations)
+ */
+function normalizeMcpName(name: string): string {
+  return name.split('(')[0].trim().toLowerCase();
+}
+
 /**
  * System prompt for the Evaluator
  */
@@ -58,10 +107,16 @@ Evaluate the analysis result for:
 - 3-4: Incomplete, vague, or partially incorrect
 - 1-2: Poor, missing critical information
 
-## Quality Checks
-- Entry points should identify actual files, not just "src/"
-- Guidelines should be specific (e.g., "Run npm test" not "Test your code")
-- MCP servers should match the detected database and deployment
+## Quality Checks - IMPORTANT
+- Entry points MUST be actual file paths (e.g., "src/index.ts", "src/cli.ts")
+  - FAIL if they contain instructions like "Check", "If", "Open", "Look"
+  - FAIL if they don't look like file paths (no / or . characters)
+- Key directories MUST map actual directories to their purposes
+  - FAIL if only generic entries like {"src": "Source code"}
+- Guidelines MUST be actionable commands, not exploration tasks
+  - Good: "Run npm test", "Check API routes in src/routes"
+  - Bad: "Investigate the codebase", "Look for patterns"
+- MCP servers MUST be single-word identifiers only (no parenthetical explanations)
 
 Be constructive but honest. If it's good, say so. If it needs work, explain why.`;
 
@@ -80,7 +135,13 @@ Based on the evaluation feedback, improve:
 - Keep guidelines to 5-10 words
 - Start with action verbs
 - Be specific to the detected stack
-- Don't remove good content, only add or improve`;
+- Don't remove good content, only add or improve
+
+## MCP Server Names
+- Use ONLY single-word identifiers: "playwright", "supabase", "postgres"
+- NEVER add explanations in parentheses
+- NEVER add descriptions after the name
+- If unsure, omit rather than guess`;
 
 /**
  * Run the Evaluator-Optimizer QA loop
@@ -107,10 +168,11 @@ export async function runEvaluatorOptimizer(
       }
     }
 
-    // Check if quality meets threshold
+    // Check if quality meets threshold (including valid entry point paths)
     if (
       evaluation.qualityScore >= QUALITY_THRESHOLD &&
       evaluation.hasEntryPoints &&
+      hasValidEntryPoints(currentResult.codebaseAnalysis.projectContext.entryPoints) &&
       evaluation.hasImplementationGuidelines
     ) {
       if (verbose) {
@@ -248,16 +310,21 @@ Provide improved guidelines and any additional entry points or MCP servers.`;
           : result.codebaseAnalysis.implementationGuidelines,
         projectContext: {
           ...result.codebaseAnalysis.projectContext,
-          entryPoints: improvements.additionalEntryPoints.length > 0
-            ? [...new Set([...result.codebaseAnalysis.projectContext.entryPoints, ...improvements.additionalEntryPoints])]
-            : result.codebaseAnalysis.projectContext.entryPoints,
+          // Filter invalid entry points (instructions) and merge with new ones
+          entryPoints: filterValidEntryPoints([
+            ...result.codebaseAnalysis.projectContext.entryPoints,
+            ...improvements.additionalEntryPoints,
+          ]).filter((ep, i, arr) => arr.indexOf(ep) === i), // dedupe
         },
       },
       mcpServers: {
         ...result.mcpServers,
         recommended: improvements.additionalMcpServers.length > 0
-          ? [...new Set([...result.mcpServers.recommended, ...improvements.additionalMcpServers])]
-          : result.mcpServers.recommended,
+          ? [...new Set([
+              ...result.mcpServers.recommended.map(normalizeMcpName),
+              ...improvements.additionalMcpServers.map(normalizeMcpName)
+            ])]
+          : result.mcpServers.recommended.map(normalizeMcpName),
       },
     };
 

package/src/ai/agents/mcp-detector.ts

@@ -177,26 +177,33 @@ export function detectRalphMcpServers(stack: DetectedStack): RalphMcpServers {
 /**
  * Convert RalphMcpServers to the legacy McpRecommendations format
  * for backward compatibility with existing code
+ *
+ * Ralph loop essentials only:
+ * - Playwright for E2E testing (always)
+ * - Database MCP if detected (Supabase, Convex, Postgres, etc.)
+ *
+ * Note: filesystem and git are assumed available in Claude Code
  */
 export function convertToLegacyMcpRecommendations(ralphMcp: RalphMcpServers): {
   essential: string[];
   recommended: string[];
 } {
-  const essential: string[] = ['filesystem', 'git'];
+  const essential: string[] = [];
 
-  // Add E2E testing as essential for ralph
+  // Ralph loop essentials only
+  // 1. Playwright for E2E testing (always)
   if (ralphMcp.e2eTesting) {
     essential.push(ralphMcp.e2eTesting);
   }
 
-  // Add database as essential if detected
+  // 2. Database MCP if detected (Supabase, Convex, Postgres, etc.)
   if (ralphMcp.database) {
     essential.push(ralphMcp.database);
   }
 
   return {
     essential,
-    recommended: ralphMcp.additional,
+    recommended: [], // No optional MCPs - keep focused on Ralph loop
   };
 }