wiggum-cli 0.3.2 → 0.4.1

package/README.md

@@ -253,10 +253,12 @@ wiggum init --provider anthropic
 
 ### AI Analysis Features
 
-Wiggum's multi-agent system provides:
-- **Codebase Analyst:** Explores project structure, entry points, and patterns
-- **Stack Researcher:** Finds best practices, testing tools, and anti-patterns
-- **Orchestrator:** Merges results and recommends MCP servers
+Wiggum uses a 4-phase multi-agent architecture:
+
+1. **Planning Orchestrator:** Creates a focused analysis plan based on the detected stack
+2. **Parallel Workers:** Context Enricher explores the codebase while Tech Researchers gather best practices (runs concurrently)
+3. **Synthesis:** Merges worker results and detects essential MCP servers (Playwright, database)
+4. **Evaluator-Optimizer:** QA loop that validates and improves the analysis (max 2 iterations)
 
 ## Configuration
 

package/dist/ai/agents/codebase-analyst.d.ts

@@ -1,6 +1,9 @@
 /**
  * Codebase Analyst Agent
  * Explores the codebase to understand its structure and patterns
+ *
+ * @deprecated Use runContextEnricher from context-enricher.ts instead.
+ * This agent is kept for backward compatibility.
  */
 import { type LanguageModel } from 'ai';
 import type { CodebaseAnalysis, CodebaseAnalystInput } from './types.js';

package/dist/ai/agents/codebase-analyst.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codebase-analyst.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/codebase-analyst.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA8DzE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAmClC"}
+{"version":3,"file":"codebase-analyst.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/codebase-analyst.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA8DzE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAmClC"}

package/dist/ai/agents/codebase-analyst.js

@@ -1,6 +1,9 @@
 /**
  * Codebase Analyst Agent
  * Explores the codebase to understand its structure and patterns
+ *
+ * @deprecated Use runContextEnricher from context-enricher.ts instead.
+ * This agent is kept for backward compatibility.
  */
 import { stepCountIs } from 'ai';
 import { createExplorationTools } from '../tools.js';

package/dist/ai/agents/codebase-analyst.js.map

@@ -1 +1 @@
-{"version":3,"file":"codebase-analyst.js","sourceRoot":"","sources":["../../../src/ai/agents/codebase-analyst.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codebase-analyst.js","sourceRoot":"","sources":["../../../src/ai/agents/codebase-analyst.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAsB,MAAM,IAAI,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD;;GAEG;AACH,MAAM,8BAA8B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAkDkB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAoB,EACpB,OAAe,EACf,KAA2B,EAC3B,UAAmB,KAAK;IAExB,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG;;WAEN,KAAK,CAAC,WAAW;;iGAEqE,CAAC;IAEhG,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,KAAK;YACL,MAAM,EAAE,8BAA8B;YACtC,MAAM;YACN,KAAK;YACL,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;YACzB,eAAe,EAAE,IAAI;YACrB,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;YAC1D,sBAAsB,EAAE;gBACtB,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;aACxE;SACF,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,IAAY,EACZ,KAA2C,EAC3C,OAAgB;IAEhB,2CAA2C;IAC3C,IAAI,WAAW,GAAG,IAAI,CAAC;IAEvB,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9C,sCAAsC;QACtC,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;gBACxB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,aAAa,CAAmB,WAAW,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,qBAAqB,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC/C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,WAAW,GAAG,SAAS,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/ai/agents/context-enricher.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Context Enricher Worker (Phase 2)
+ * Explores the codebase to gather enriched context based on the analysis plan
+ */
+import { type LanguageModel } from 'ai';
+import type { ContextEnricherInput, EnrichedContext } from './types.js';
+/**
+ * Run the Context Enricher worker
+ */
+export declare function runContextEnricher(model: LanguageModel, modelId: string, input: ContextEnricherInput, verbose?: boolean): Promise<EnrichedContext>;
+//# sourceMappingURL=context-enricher.d.ts.map

package/dist/ai/agents/context-enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-enricher.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/context-enricher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoDxE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,eAAe,CAAC,CAoD1B"}

package/dist/ai/agents/context-enricher.js

@@ -0,0 +1,163 @@
+/**
+ * Context Enricher Worker (Phase 2)
+ * Explores the codebase to gather enriched context based on the analysis plan
+ */
+import { stepCountIs } from 'ai';
+import { createExplorationTools } from '../tools.js';
+import { isReasoningModel } from '../providers.js';
+import { logger } from '../../utils/logger.js';
+import { parseJsonSafe } from '../../utils/json-repair.js';
+import { getTracedAI } from '../../utils/tracing.js';
+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.
+
+## Your Mission
+Based on the analysis plan, explore the codebase to:
+1. Identify entry points and key files
+2. Understand directory structure and purposes
+3. Detect naming conventions
+4. Find available commands (from package.json)
+5. Answer the specific questions provided
+
+## Tools Available
+- searchCode: Search using ripgrep patterns
+- readFile: Read file contents
+- listDirectory: List directory structure
+- 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
+
+## Output Format
+After exploration, output ONLY valid JSON:
+{
+  "entryPoints": ["src/index.ts"],
+  "keyDirectories": {"src/routes": "API routes", "src/components": "UI components"},
+  "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"
+}`;
+/**
+ * Run the Context Enricher worker
+ */
+export async function runContextEnricher(model, modelId, input, verbose = false) {
+    const tools = createExplorationTools(input.scanResult.projectRoot);
+    const prompt = `Explore this codebase and gather enriched context.
+
+Project: ${input.scanResult.projectRoot}
+
+## Areas to Explore
+${input.areasToExplore.map(a => `- ${a}`).join('\n')}
+
+## Questions to Answer
+${input.questionsToAnswer.map(q => `- ${q}`).join('\n')}
+
+Start by exploring the specified areas, then answer the questions and produce your analysis as JSON.`;
+    try {
+        const { generateText } = getTracedAI();
+        const result = await generateText({
+            model,
+            system: CONTEXT_ENRICHER_SYSTEM_PROMPT,
+            prompt,
+            tools,
+            stopWhen: stepCountIs(5),
+            maxOutputTokens: 3000,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    agent: 'context-enricher',
+                    projectRoot: input.scanResult.projectRoot,
+                    areasCount: input.areasToExplore.length,
+                    questionsCount: input.questionsToAnswer.length,
+                },
+            },
+        });
+        // Parse the response
+        const context = parseEnrichedContext(result.text, result.steps, verbose);
+        if (verbose) {
+            logger.info(`Context Enricher: Found ${context.entryPoints.length} entry points, answered ${Object.keys(context.answeredQuestions).length} questions`);
+        }
+        return context;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Context Enricher error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return getDefaultEnrichedContext(input);
+    }
+}
+/**
+ * Parse the enriched context from agent response
+ */
+function parseEnrichedContext(text, steps, verbose) {
+    // Try to get text from the result or steps
+    let textToParse = text;
+    if (!textToParse || textToParse.trim() === '') {
+        const stepsList = steps || [];
+        for (let i = stepsList.length - 1; i >= 0; i--) {
+            const step = stepsList[i];
+            if (step.text && step.text.trim() !== '') {
+                textToParse = step.text;
+                break;
+            }
+        }
+    }
+    if (!textToParse || textToParse.trim() === '') {
+        if (verbose) {
+            logger.warn('Context Enricher: No text output found');
+        }
+        return getDefaultEnrichedContext();
+    }
+    // Use safe JSON parser with repair capabilities
+    const parsed = parseJsonSafe(textToParse);
+    if (!parsed) {
+        if (verbose) {
+            logger.warn('Context Enricher: Failed to parse JSON response');
+        }
+        return getDefaultEnrichedContext();
+    }
+    // Build result with defaults for missing fields
+    return {
+        entryPoints: parsed.entryPoints || ['src/index.ts'],
+        keyDirectories: parsed.keyDirectories || { src: 'Source code' },
+        namingConventions: parsed.namingConventions || 'camelCase',
+        commands: parsed.commands || { build: 'npm run build' },
+        answeredQuestions: parsed.answeredQuestions || {},
+        projectType: parsed.projectType || 'Unknown',
+    };
+}
+/**
+ * Get default enriched context when parsing fails
+ */
+function getDefaultEnrichedContext(input) {
+    const projectType = detectProjectType(input?.scanResult.stack);
+    return {
+        entryPoints: ['src/index.ts'],
+        keyDirectories: { src: 'Source code' },
+        namingConventions: 'camelCase',
+        commands: {
+            test: 'npm test',
+            build: 'npm run build',
+            dev: 'npm run dev',
+        },
+        answeredQuestions: {},
+        projectType,
+    };
+}
+//# sourceMappingURL=context-enricher.js.map

package/dist/ai/agents/context-enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-enricher.js","sourceRoot":"","sources":["../../../src/ai/agents/context-enricher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAsB,MAAM,IAAI,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,MAAM,8BAA8B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCrC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAoB,EACpB,OAAe,EACf,KAA2B,EAC3B,UAAmB,KAAK;IAExB,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG;;WAEN,KAAK,CAAC,UAAU,CAAC,WAAW;;;EAGrC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGlD,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;qGAE8C,CAAC;IAEpG,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,KAAK;YACL,MAAM,EAAE,8BAA8B;YACtC,MAAM;YACN,KAAK;YACL,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;YACxB,eAAe,EAAE,IAAI;YACrB,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;YAC1D,sBAAsB,EAAE;gBACtB,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE;oBACR,KAAK,EAAE,kBAAkB;oBACzB,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW;oBACzC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM;oBACvC,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,MAAM;iBAC/C;aACF;SACF,CAAC,CAAC;QAEH,qBAAqB;QACrB,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEzE,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,WAAW,CAAC,MAAM,2BAA2B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC;QACzJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,IAAY,EACZ,KAA2C,EAC3C,OAAgB;IAEhB,2CAA2C;IAC3C,IAAI,WAAW,GAAG,IAAI,CAAC;IAEvB,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;gBACxB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,yBAAyB,EAAE,CAAC;IACrC,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,aAAa,CAA2B,WAAW,CAAC,CAAC;IAEpE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,yBAAyB,EAAE,CAAC;IACrC,CAAC;IAED,gDAAgD;IAChD,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC,cAAc,CAAC;QACnD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE;QAC/D,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,WAAW;QAC1D,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE;QACvD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,EAAE;QACjD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS;KAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,KAA4B;IAC7D,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAE/D,OAAO;QACL,WAAW,EAAE,CAAC,cAAc,CAAC;QAC7B,cAAc,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE;QACtC,iBAAiB,EAAE,WAAW;QAC9B,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,eAAe;YACtB,GAAG,EAAE,aAAa;SACnB;QACD,iBAAiB,EAAE,EAAE;QACrB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/ai/agents/evaluator-optimizer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Evaluator-Optimizer Agent (Phase 4)
+ * QA loop that validates and improves the analysis result
+ * Max 2 iterations to ensure quality without endless loops
+ */
+import { type LanguageModel } from 'ai';
+import type { ScanResult } from '../../scanner/types.js';
+import type { MultiAgentAnalysis } from './types.js';
+/**
+ * Run the Evaluator-Optimizer QA loop
+ */
+export declare function runEvaluatorOptimizer(model: LanguageModel, modelId: string, result: MultiAgentAnalysis, scanResult: ScanResult, maxIterations?: number, verbose?: boolean): Promise<MultiAgentAnalysis>;
+//# sourceMappingURL=evaluator-optimizer.d.ts.map

package/dist/ai/agents/evaluator-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-optimizer.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/evaluator-optimizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAC;AA2EvE;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,UAAU,EACtB,aAAa,GAAE,MAAU,EACzB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAqC7B"}

package/dist/ai/agents/evaluator-optimizer.js

@@ -0,0 +1,231 @@
+/**
+ * Evaluator-Optimizer Agent (Phase 4)
+ * QA loop that validates and improves the analysis result
+ * Max 2 iterations to ensure quality without endless loops
+ */
+import { z } from 'zod';
+import { isReasoningModel } from '../providers.js';
+import { logger } from '../../utils/logger.js';
+import { getTracedAI } from '../../utils/tracing.js';
+/**
+ * Quality threshold for passing evaluation (1-10 scale)
+ * Results with score >= this value skip optimization
+ */
+const QUALITY_THRESHOLD = 7;
+/**
+ * Schema for evaluation output
+ */
+const evaluationSchema = z.object({
+    qualityScore: z.number().min(1).max(10).describe('Overall quality score from 1-10'),
+    hasEntryPoints: z.boolean().describe('Whether entry points are identified'),
+    hasImplementationGuidelines: z.boolean().describe('Whether implementation guidelines are provided'),
+    hasRelevantMcpServers: z.boolean().describe('Whether relevant MCP servers are recommended'),
+    specificIssues: z.array(z.string()).describe('Specific issues found in the analysis'),
+    improvementSuggestions: z.array(z.string()).describe('Suggestions for improving the analysis'),
+});
+/**
+ * Schema for optimizer output
+ */
+const optimizerOutputSchema = z.object({
+    improvedGuidelines: z.array(z.string()).describe('Improved implementation guidelines'),
+    additionalEntryPoints: z.array(z.string()).describe('Additional entry points to add (empty array if none)'),
+    additionalMcpServers: z.array(z.string()).describe('Additional MCP servers to recommend (empty array if none)'),
+});
+/**
+ * System prompt for the Evaluator
+ */
+const EVALUATOR_SYSTEM_PROMPT = `You are a QA Evaluator for AI-generated codebase analysis.
+
+## Your Mission
+Evaluate the analysis result for:
+1. Completeness - Are all important areas covered?
+2. Accuracy - Do the recommendations match the detected stack?
+3. Actionability - Are the guidelines specific and useful?
+4. MCP relevance - Are the right MCP servers recommended?
+
+## Scoring Guidelines
+- 9-10: Excellent, comprehensive, highly actionable
+- 7-8: Good, covers main areas, useful guidelines
+- 5-6: Adequate but missing some important details
+- 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
+
+Be constructive but honest. If it's good, say so. If it needs work, explain why.`;
+/**
+ * System prompt for the Optimizer
+ */
+const OPTIMIZER_SYSTEM_PROMPT = `You are an Optimizer that improves AI-generated codebase analysis based on evaluation feedback.
+
+## Your Mission
+Based on the evaluation feedback, improve:
+1. Implementation guidelines - make them more specific and actionable
+2. Entry points - add any obvious ones that were missed
+3. MCP servers - add any that would be useful
+
+## Guidelines for Improvement
+- 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`;
+/**
+ * Run the Evaluator-Optimizer QA loop
+ */
+export async function runEvaluatorOptimizer(model, modelId, result, scanResult, maxIterations = 2, verbose = false) {
+    let currentResult = result;
+    let iterations = 0;
+    while (iterations < maxIterations) {
+        // Evaluate current result
+        const evaluation = await evaluateResult(model, modelId, currentResult, scanResult, verbose);
+        if (verbose) {
+            logger.info(`Evaluator (iteration ${iterations + 1}): Score ${evaluation.qualityScore}/10`);
+            if (evaluation.specificIssues.length > 0) {
+                logger.info(`Issues: ${evaluation.specificIssues.join(', ')}`);
+            }
+        }
+        // Check if quality meets threshold
+        if (evaluation.qualityScore >= QUALITY_THRESHOLD &&
+            evaluation.hasEntryPoints &&
+            evaluation.hasImplementationGuidelines) {
+            if (verbose) {
+                logger.info('Evaluator: Quality threshold met, skipping optimization');
+            }
+            break;
+        }
+        // Optimize based on feedback
+        if (verbose) {
+            logger.info('Evaluator: Running optimizer to improve result');
+        }
+        currentResult = await optimizeResult(model, modelId, currentResult, evaluation, verbose);
+        iterations++;
+    }
+    return currentResult;
+}
+/**
+ * Evaluate the analysis result
+ */
+async function evaluateResult(model, modelId, result, scanResult, verbose) {
+    const prompt = `Evaluate this codebase analysis:
+
+## Analysis Result
+Project Type: ${result.codebaseAnalysis.projectContext.projectType}
+Entry Points: ${result.codebaseAnalysis.projectContext.entryPoints.join(', ') || 'None'}
+Key Directories: ${Object.keys(result.codebaseAnalysis.projectContext.keyDirectories).join(', ') || 'None'}
+Guidelines: ${result.codebaseAnalysis.implementationGuidelines.length} items
+- ${result.codebaseAnalysis.implementationGuidelines.slice(0, 3).join('\n- ')}
+MCP Essential: ${result.mcpServers.essential.join(', ')}
+MCP Recommended: ${result.mcpServers.recommended.join(', ') || 'None'}
+
+## Original Project Context
+Framework: ${scanResult.stack.framework?.name || 'Unknown'}
+Database: ${scanResult.stack.database?.name || 'None detected'}
+Testing: ${scanResult.stack.testing?.unit?.name || 'None detected'}
+
+Evaluate the quality and completeness of this analysis.`;
+    try {
+        const { generateObject } = getTracedAI();
+        const { object: evaluation } = await generateObject({
+            model,
+            schema: evaluationSchema,
+            system: EVALUATOR_SYSTEM_PROMPT,
+            prompt,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.2 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    agent: 'evaluator',
+                    projectType: result.codebaseAnalysis.projectContext.projectType,
+                },
+            },
+        });
+        return evaluation;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Evaluator error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Return a passing evaluation on error to avoid blocking
+        return {
+            qualityScore: 7,
+            hasEntryPoints: result.codebaseAnalysis.projectContext.entryPoints.length > 0,
+            hasImplementationGuidelines: result.codebaseAnalysis.implementationGuidelines.length > 0,
+            hasRelevantMcpServers: result.mcpServers.essential.length > 0,
+            specificIssues: [],
+            improvementSuggestions: [],
+        };
+    }
+}
+/**
+ * Optimize the result based on evaluation feedback
+ */
+async function optimizeResult(model, modelId, result, evaluation, verbose) {
+    const prompt = `Improve this codebase analysis based on the evaluation feedback.
+
+## Current Analysis
+Project Type: ${result.codebaseAnalysis.projectContext.projectType}
+Entry Points: ${result.codebaseAnalysis.projectContext.entryPoints.join(', ')}
+Current Guidelines:
+${result.codebaseAnalysis.implementationGuidelines.map(g => `- ${g}`).join('\n')}
+
+## Evaluation Feedback
+Score: ${evaluation.qualityScore}/10
+Issues: ${evaluation.specificIssues.join(', ') || 'None'}
+Suggestions: ${evaluation.improvementSuggestions.join(', ') || 'None'}
+
+Provide improved guidelines and any additional entry points or MCP servers.`;
+    try {
+        const { generateObject } = getTracedAI();
+        const { object: improvements } = await generateObject({
+            model,
+            schema: optimizerOutputSchema,
+            system: OPTIMIZER_SYSTEM_PROMPT,
+            prompt,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    agent: 'optimizer',
+                    previousScore: evaluation.qualityScore,
+                },
+            },
+        });
+        // Apply improvements to the result
+        const improved = {
+            ...result,
+            codebaseAnalysis: {
+                ...result.codebaseAnalysis,
+                implementationGuidelines: improvements.improvedGuidelines.length > 0
+                    ? improvements.improvedGuidelines
+                    : result.codebaseAnalysis.implementationGuidelines,
+                projectContext: {
+                    ...result.codebaseAnalysis.projectContext,
+                    entryPoints: improvements.additionalEntryPoints.length > 0
+                        ? [...new Set([...result.codebaseAnalysis.projectContext.entryPoints, ...improvements.additionalEntryPoints])]
+                        : result.codebaseAnalysis.projectContext.entryPoints,
+                },
+            },
+            mcpServers: {
+                ...result.mcpServers,
+                recommended: improvements.additionalMcpServers.length > 0
+                    ? [...new Set([...result.mcpServers.recommended, ...improvements.additionalMcpServers])]
+                    : result.mcpServers.recommended,
+            },
+        };
+        if (verbose) {
+            logger.info(`Optimizer: Updated ${improvements.improvedGuidelines.length} guidelines`);
+        }
+        return improved;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Optimizer error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Return original result on error
+        return result;
+    }
+}
+//# sourceMappingURL=evaluator-optimizer.js.map

package/dist/ai/agents/evaluator-optimizer.js.map

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

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

@@ -1,8 +1,21 @@
 /**
  * Agents Index
- * Exports all agent types and functions
+ * Multi-agent analysis with Orchestrator-Worker + Evaluator-Optimizer pattern
+ *
+ * Architecture:
+ * Phase 1: Planning Orchestrator (creates analysis plan)
+ * Phase 2: Parallel Workers (context enricher + tech researchers)
+ * Phase 3: Synthesis (merge results + MCP detection)
+ * Phase 4: Evaluator-Optimizer (QA loop)
  */
-export type { CodebaseAnalysis, StackResearch, McpRecommendations, MultiAgentAnalysis, AgentCapabilities, AgentOptions, CodebaseAnalystInput, StackResearcherInput, OrchestratorInput, } from './types.js';
+export type { AnalysisPlan, EnrichedContext, TechResearchResult, RalphMcpServers, EvaluationResult, ContextEnricherInput, TechResearcherInput, SynthesisInput, ProgressCallback, CodebaseAnalysis, StackResearch, McpRecommendations, MultiAgentAnalysis, AgentCapabilities, AgentOptions, CodebaseAnalystInput, StackResearcherInput, OrchestratorInput, } from './types.js';
+export { runPlanningOrchestrator } from './planning-orchestrator.js';
+export { runContextEnricher } from './context-enricher.js';
+export { runTechResearcher, runTechResearchPool } from './tech-researcher.js';
+export { detectRalphMcpServers, convertToLegacyMcpRecommendations } from './mcp-detector.js';
+export { runSynthesisAgent } from './synthesis-agent.js';
+export { runEvaluatorOptimizer } from './evaluator-optimizer.js';
+export { detectProjectType } from './stack-utils.js';
 export { runCodebaseAnalyst } from './codebase-analyst.js';
 export { runStackResearcher } from './stack-researcher.js';
 export { runOrchestrator, mergeAgentResults } from './orchestrator.js';
@@ -10,7 +23,12 @@ import type { LanguageModel } from 'ai';
 import type { ScanResult } from '../../scanner/types.js';
 import type { MultiAgentAnalysis, AgentOptions } from './types.js';
 /**
- * Run the full multi-agent analysis pipeline
+ * Run the full multi-agent analysis pipeline (new architecture)
+ *
+ * Phase 1: Planning Orchestrator - Creates focused analysis plan
+ * Phase 2: Parallel Workers - Context enricher + tech researchers run concurrently
+ * Phase 3: Synthesis - Merges results + detects MCPs
+ * Phase 4: Evaluator-Optimizer - QA loop (max 2 iterations)
  */
 export declare function runMultiAgentAnalysis(model: LanguageModel, modelId: string, scanResult: ScanResult, options?: AgentOptions): Promise<MultiAgentAnalysis | null>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EACV,kBAAkB,EAElB,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAyFpC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAEV,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAEhB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAElB,YAAY,EAEb,MAAM,YAAY,CAAC;AAUpB;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA8HpC"}