wiggum-cli 0.2.6 → 0.3.1

package/dist/ai/agents/orchestrator.js

@@ -0,0 +1,181 @@
+/**
+ * Orchestrator Agent
+ * Coordinates the multi-agent analysis and merges results
+ */
+import { isReasoningModel } from '../providers.js';
+import { logger } from '../../utils/logger.js';
+import { parseJsonSafe } from '../../utils/json-repair.js';
+import { getTracedAI } from '../../utils/tracing.js';
+/**
+ * System prompt for the Orchestrator
+ */
+const ORCHESTRATOR_SYSTEM_PROMPT = `You are an Orchestrator agent that merges analysis results into final recommendations.
+
+Your job is to:
+1. Review the codebase analysis and stack research
+2. Recommend appropriate MCP servers for the stack
+3. Produce a final merged recommendation
+
+## MCP Server Selection Guidelines
+Based on the detected stack, recommend these MCP servers:
+
+**Always Essential:**
+- filesystem: For file operations (all projects)
+- git: For version control (all projects)
+
+**By Project Type:**
+- MCP Server: memory (for context)
+- REST API: fetch (external APIs), postgres/sqlite (databases)
+- React/Next.js: fetch (data fetching), memory (state persistence)
+- CLI Tool: filesystem (primary), memory (caching)
+- Library: git (versioning)
+
+**By Technology:**
+- Docker in use → docker MCP server
+- PostgreSQL → postgres MCP server
+- SQLite → sqlite MCP server
+- AWS services → aws-kb-retrieval MCP server
+- GitHub workflows → github MCP server
+
+## Output Format
+Output ONLY valid JSON:
+{
+  "mcpServers": {
+    "essential": ["filesystem", "git"],
+    "recommended": ["docker", "postgres"]
+  }
+}`;
+/**
+ * Run the Orchestrator to merge results and recommend MCP servers
+ */
+export async function runOrchestrator(model, modelId, input, verbose = false) {
+    const prompt = createOrchestratorPrompt(input);
+    try {
+        const { generateText } = getTracedAI();
+        const result = await generateText({
+            model,
+            system: ORCHESTRATOR_SYSTEM_PROMPT,
+            prompt,
+            maxOutputTokens: 1000,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.2 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: { agent: 'orchestrator', projectType: input.codebaseAnalysis.projectContext.projectType },
+            },
+        });
+        const mcpServers = parseMcpRecommendations(result.text, input.stack, verbose);
+        return mcpServers;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Orchestrator error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Return default recommendations based on project type
+        return getDefaultMcpRecommendations(input.codebaseAnalysis.projectContext.projectType, input.stack);
+    }
+}
+/**
+ * Create the orchestrator prompt
+ */
+function createOrchestratorPrompt(input) {
+    const { codebaseAnalysis, stackResearch, stack } = input;
+    // Summarize the stack
+    const stackSummary = [];
+    if (stack.framework)
+        stackSummary.push(`Framework: ${stack.framework.name}`);
+    if (stack.database)
+        stackSummary.push(`Database: ${stack.database.name}`);
+    if (stack.orm)
+        stackSummary.push(`ORM: ${stack.orm.name}`);
+    if (stack.deployment?.length)
+        stackSummary.push(`Deployment: ${stack.deployment.map(d => d.name).join(', ')}`);
+    if (stack.mcp?.isProject)
+        stackSummary.push('This is an MCP Server project');
+    return `Analyze these results and recommend MCP servers:
+
+## Project Type
+${codebaseAnalysis.projectContext.projectType}
+
+## Detected Stack
+${stackSummary.join('\n') || 'Unknown'}
+
+## Testing Tools Identified
+${stackResearch.testingTools.join(', ') || 'None identified'}
+
+## Debugging Tools
+${stackResearch.debuggingTools.join(', ') || 'None identified'}
+
+Based on this analysis, recommend essential and optional MCP servers.
+Output as JSON with "mcpServers" containing "essential" and "recommended" arrays.`;
+}
+/**
+ * Parse MCP recommendations from orchestrator response
+ */
+function parseMcpRecommendations(text, stack, verbose) {
+    if (!text || text.trim() === '') {
+        return getDefaultMcpRecommendations('Unknown', stack);
+    }
+    // Use safe JSON parser with repair capabilities
+    const parsed = parseJsonSafe(text);
+    if (!parsed) {
+        if (verbose) {
+            logger.warn('Orchestrator: Failed to parse JSON response');
+        }
+        return getDefaultMcpRecommendations('Unknown', stack);
+    }
+    if (parsed.mcpServers) {
+        return {
+            essential: parsed.mcpServers.essential || ['filesystem', 'git'],
+            recommended: parsed.mcpServers.recommended || [],
+        };
+    }
+    return getDefaultMcpRecommendations('Unknown', stack);
+}
+/**
+ * Get default MCP recommendations based on project type and stack
+ */
+function getDefaultMcpRecommendations(projectType, stack) {
+    const essential = ['filesystem', 'git'];
+    const recommended = [];
+    // Add based on project type
+    const lowerType = projectType.toLowerCase();
+    if (lowerType.includes('mcp')) {
+        recommended.push('memory');
+    }
+    if (lowerType.includes('api') || lowerType.includes('server')) {
+        recommended.push('fetch');
+    }
+    // Add based on detected stack
+    if (stack.database) {
+        const dbName = stack.database.name.toLowerCase();
+        if (dbName.includes('postgres')) {
+            recommended.push('postgres');
+        }
+        else if (dbName.includes('sqlite')) {
+            recommended.push('sqlite');
+        }
+    }
+    if (stack.deployment?.some(d => d.name.toLowerCase().includes('docker'))) {
+        recommended.push('docker');
+    }
+    // Add from existing MCP recommendations in stack
+    if (stack.mcp?.recommended) {
+        for (const rec of stack.mcp.recommended) {
+            if (!essential.includes(rec) && !recommended.includes(rec)) {
+                recommended.push(rec);
+            }
+        }
+    }
+    return { essential, recommended };
+}
+/**
+ * Merge all agent results into a final MultiAgentAnalysis
+ */
+export function mergeAgentResults(codebaseAnalysis, stackResearch, mcpServers) {
+    return {
+        codebaseAnalysis,
+        stackResearch,
+        mcpServers,
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/ai/agents/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/ai/agents/orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,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,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCjC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,OAAe,EACf,KAAwB,EACxB,UAAmB,KAAK;IAExB,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,KAAK;YACL,MAAM,EAAE,0BAA0B;YAClC,MAAM;YACN,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,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,cAAc,CAAC,WAAW,EAAE;aACpG;SACF,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9E,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,uDAAuD;QACvD,OAAO,4BAA4B,CAAC,KAAK,CAAC,gBAAgB,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,KAAwB;IACxD,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAEzD,sBAAsB;IACtB,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,SAAS;QAAE,YAAY,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,QAAQ;QAAE,YAAY,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,GAAG;QAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM;QAAE,YAAY,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/G,IAAI,KAAK,CAAC,GAAG,EAAE,SAAS;QAAE,YAAY,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE7E,OAAO;;;EAGP,gBAAgB,CAAC,cAAc,CAAC,WAAW;;;EAG3C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;;;EAGpC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB;;;EAG1D,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB;;;kFAGoB,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,IAAY,EACZ,KAAoB,EACpB,OAAgB;IAEhB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO,4BAA4B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,aAAa,CAAsC,IAAI,CAAC,CAAC;IAExE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,4BAA4B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;YAC/D,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE;SACjD,CAAC;IACJ,CAAC;IAED,OAAO,4BAA4B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,4BAA4B,CAAC,WAAmB,EAAE,KAAoB;IAC7E,MAAM,SAAS,GAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,4BAA4B;IAC5B,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAE5C,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,8BAA8B;IAC9B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACzE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,iDAAiD;IACjD,IAAI,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3D,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAkC,EAClC,aAA4B,EAC5B,UAA8B;IAE9B,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/ai/agents/stack-researcher.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stack Researcher Agent
+ * Researches best practices and tools for the detected stack
+ * Gracefully degrades when optional services are unavailable
+ */
+import { type LanguageModel } from 'ai';
+import type { StackResearch, StackResearcherInput } from './types.js';
+/**
+ * Run the Stack Researcher agent
+ */
+export declare function runStackResearcher(model: LanguageModel, modelId: string, input: StackResearcherInput, options: {
+    tavilyApiKey?: string;
+    context7ApiKey?: string;
+}, verbose?: boolean): Promise<StackResearch | null>;
+//# sourceMappingURL=stack-researcher.d.ts.map

package/dist/ai/agents/stack-researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-researcher.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/stack-researcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAa,MAAM,IAAI,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAmKzF;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiD/B"}

package/dist/ai/agents/stack-researcher.js

@@ -0,0 +1,269 @@
+/**
+ * Stack Researcher Agent
+ * Researches best practices and tools for the detected stack
+ * Gracefully degrades when optional services are unavailable
+ */
+import { stepCountIs } from 'ai';
+import { createTavilySearchTool } from '../tools/tavily.js';
+import { createContext7Tool } from '../tools/context7.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';
+/**
+ * System prompt for Stack Researcher with tools
+ */
+const STACK_RESEARCHER_WITH_TOOLS_PROMPT = `You are a Stack Researcher agent with access to web search and documentation lookup tools.
+
+## Your Mission
+Research the detected technology stack to find:
+1. Current best practices
+2. Common anti-patterns to avoid
+3. Testing tools and patterns
+4. Debugging approaches
+5. Useful documentation links
+
+## Tools Available
+- tavilySearch: Search the web for current best practices and patterns
+- context7Lookup: Look up library documentation
+
+## Research Strategy
+1. Search for "[technology] best practices 2024"
+2. Search for "[project type] testing patterns"
+3. Look up documentation for key dependencies
+4. Search for "[framework] anti-patterns"
+
+## Output Format
+After research, output ONLY valid JSON with this structure:
+{
+  "bestPractices": [
+    "Use TypeScript strict mode",
+    "Implement proper error boundaries"
+  ],
+  "antiPatterns": [
+    "Don't use any type",
+    "Avoid prop drilling"
+  ],
+  "testingTools": [
+    "npx vitest",
+    "npx playwright test"
+  ],
+  "debuggingTools": [
+    "React DevTools",
+    "DEBUG=* npm run dev"
+  ],
+  "documentationHints": [
+    "React docs: react.dev",
+    "Vitest: vitest.dev"
+  ],
+  "researchMode": "full"
+}
+
+Keep each item concise (5-15 words max). Max 5 items per array.`;
+/**
+ * System prompt for Stack Researcher without tools (knowledge-only)
+ */
+const STACK_RESEARCHER_KNOWLEDGE_ONLY_PROMPT = `You are a Stack Researcher agent. You don't have web access, so rely on your training knowledge.
+
+## Your Mission
+Based on your knowledge, provide:
+1. Best practices for the detected technologies
+2. Common anti-patterns to avoid
+3. Testing tools commonly used with this stack
+4. Debugging approaches
+5. Documentation hints
+
+## Important Notes
+- Be explicit about what you're confident about vs uncertain
+- Focus on well-established practices from your training
+- Mention if something might be outdated
+
+## Output Format
+Output ONLY valid JSON with this structure:
+{
+  "bestPractices": [
+    "Use TypeScript strict mode",
+    "Implement proper error boundaries"
+  ],
+  "antiPatterns": [
+    "Don't use any type",
+    "Avoid prop drilling"
+  ],
+  "testingTools": [
+    "npm test",
+    "npx vitest"
+  ],
+  "debuggingTools": [
+    "console.log debugging",
+    "Node.js inspector"
+  ],
+  "documentationHints": [
+    "Check official docs for updates",
+    "Framework docs: [URL]"
+  ],
+  "researchMode": "knowledge-only"
+}
+
+Keep each item concise (5-15 words max). Max 5 items per array.
+Note: Research mode should reflect that you're using training knowledge only.`;
+/**
+ * Create the research prompt based on stack and project type
+ */
+function createResearchPrompt(stack, projectType, hasTools) {
+    const technologies = [];
+    // Collect all detected technologies
+    if (stack.framework)
+        technologies.push(stack.framework.name);
+    if (stack.testing?.unit)
+        technologies.push(stack.testing.unit.name);
+    if (stack.testing?.e2e)
+        technologies.push(stack.testing.e2e.name);
+    if (stack.orm)
+        technologies.push(stack.orm.name);
+    if (stack.database)
+        technologies.push(stack.database.name);
+    if (stack.stateManagement)
+        technologies.push(stack.stateManagement.name);
+    if (stack.auth)
+        technologies.push(stack.auth.name);
+    if (stack.mcp?.isProject)
+        technologies.push('MCP Server');
+    const techList = technologies.length > 0 ? technologies.join(', ') : 'Unknown stack';
+    if (hasTools) {
+        return `Research best practices for this stack:
+
+Project Type: ${projectType}
+Technologies: ${techList}
+
+Use the available tools to search for:
+1. Current best practices for ${projectType} projects
+2. Testing patterns for ${techList}
+3. Common anti-patterns to avoid
+
+Then produce your research findings as JSON.`;
+    }
+    return `Based on your knowledge, provide best practices for this stack:
+
+Project Type: ${projectType}
+Technologies: ${techList}
+
+Provide:
+1. Best practices for ${projectType} projects
+2. Testing tools commonly used with ${techList}
+3. Anti-patterns to avoid
+4. Debugging approaches
+
+Output your findings as JSON. Be clear this is based on training knowledge.`;
+}
+/**
+ * Determine research mode based on capabilities
+ */
+function getResearchMode(capabilities) {
+    if (capabilities.hasTavily && capabilities.hasContext7)
+        return 'full';
+    if (capabilities.hasTavily)
+        return 'web-only';
+    if (capabilities.hasContext7)
+        return 'docs-only';
+    return 'knowledge-only';
+}
+/**
+ * Run the Stack Researcher agent
+ */
+export async function runStackResearcher(model, modelId, input, options, verbose = false) {
+    const tools = {};
+    // Add tools based on available keys
+    if (options.tavilyApiKey) {
+        tools.tavilySearch = createTavilySearchTool(options.tavilyApiKey);
+    }
+    if (options.context7ApiKey) {
+        tools.context7Lookup = createContext7Tool(options.context7ApiKey);
+    }
+    const hasTools = Object.keys(tools).length > 0;
+    const researchMode = getResearchMode(input.capabilities);
+    if (verbose) {
+        logger.info(`Stack Researcher running in ${researchMode} mode`);
+    }
+    const systemPrompt = hasTools
+        ? STACK_RESEARCHER_WITH_TOOLS_PROMPT
+        : STACK_RESEARCHER_KNOWLEDGE_ONLY_PROMPT;
+    const prompt = createResearchPrompt(input.stack, input.projectType, hasTools);
+    try {
+        const { generateText } = getTracedAI();
+        const result = await generateText({
+            model,
+            system: systemPrompt,
+            prompt,
+            ...(hasTools ? { tools, stopWhen: stepCountIs(8) } : {}),
+            maxOutputTokens: 2000,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: { agent: 'stack-researcher', researchMode, projectType: input.projectType },
+            },
+        });
+        // Parse the response
+        const research = parseStackResearch(result.text, result.steps, researchMode, verbose);
+        return research;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Stack Researcher error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return null;
+    }
+}
+/**
+ * Parse the stack research from agent response
+ */
+function parseStackResearch(text, steps, researchMode, 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('Stack Researcher: No text output found');
+        }
+        return getDefaultStackResearch(researchMode);
+    }
+    // Use safe JSON parser with repair capabilities
+    const parsed = parseJsonSafe(textToParse);
+    if (!parsed) {
+        if (verbose) {
+            logger.warn('Stack Researcher: Failed to parse JSON response');
+        }
+        return getDefaultStackResearch(researchMode);
+    }
+    // Build result with defaults for missing fields
+    return {
+        bestPractices: parsed.bestPractices || [],
+        antiPatterns: parsed.antiPatterns || [],
+        testingTools: parsed.testingTools || [],
+        debuggingTools: parsed.debuggingTools || [],
+        documentationHints: parsed.documentationHints || [],
+        researchMode: researchMode,
+    };
+}
+/**
+ * Get default stack research when parsing fails
+ */
+function getDefaultStackResearch(researchMode) {
+    return {
+        bestPractices: ['Follow project conventions', 'Write tests for new code'],
+        antiPatterns: ['Avoid skipping tests', 'Don\'t ignore type errors'],
+        testingTools: ['npm test'],
+        debuggingTools: ['console.log', 'debugger statement'],
+        documentationHints: ['Check package.json for dependencies'],
+        researchMode,
+    };
+}
+//# sourceMappingURL=stack-researcher.js.map

package/dist/ai/agents/stack-researcher.js.map

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

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

@@ -0,0 +1,123 @@
+/**
+ * Agent Types and Interfaces
+ * Defines the structure for multi-agent analysis
+ */
+import type { ScanResult, DetectedStack } from '../../scanner/types.js';
+/**
+ * Codebase analysis result from the Codebase Analyst agent
+ */
+export interface CodebaseAnalysis {
+    /** Project structure and context */
+    projectContext: {
+        /** Key entry point files */
+        entryPoints: string[];
+        /** Important directories and their purposes */
+        keyDirectories: Record<string, string>;
+        /** Naming conventions used */
+        namingConventions?: string;
+        /** The primary project type (MCP Server, REST API, React SPA, CLI, Library) */
+        projectType: string;
+    };
+    /** Detected commands from package.json */
+    commands: {
+        test?: string;
+        lint?: string;
+        typecheck?: string;
+        build?: string;
+        dev?: string;
+        format?: string;
+    };
+    /** Short, actionable implementation guidelines */
+    implementationGuidelines: string[];
+    /** Additional technologies that may have been missed */
+    possibleMissedTechnologies?: string[];
+}
+/**
+ * Stack research result from the Stack Researcher agent
+ */
+export interface StackResearch {
+    /** Best practices for the detected stack */
+    bestPractices: string[];
+    /** Anti-patterns to avoid */
+    antiPatterns: string[];
+    /** Technology-specific testing tools */
+    testingTools: string[];
+    /** Technology-specific debugging tools */
+    debuggingTools: string[];
+    /** Documentation hints and links */
+    documentationHints: string[];
+    /** Whether research was performed with tools or knowledge-only */
+    researchMode: 'full' | 'web-only' | 'docs-only' | 'knowledge-only';
+}
+/**
+ * MCP server recommendations
+ */
+export interface McpRecommendations {
+    /** Essential MCP servers for this stack */
+    essential: string[];
+    /** Recommended but optional MCP servers */
+    recommended: string[];
+}
+/**
+ * Combined result from all agents
+ */
+export interface MultiAgentAnalysis {
+    /** Codebase analysis from the Codebase Analyst */
+    codebaseAnalysis: CodebaseAnalysis;
+    /** Stack research from the Stack Researcher */
+    stackResearch: StackResearch;
+    /** MCP server recommendations (merged from both agents) */
+    mcpServers: McpRecommendations;
+}
+/**
+ * Agent capabilities based on available API keys
+ */
+export interface AgentCapabilities {
+    /** Tavily web search available */
+    hasTavily: boolean;
+    /** Context7 documentation lookup available */
+    hasContext7: boolean;
+}
+/**
+ * Options for running agents
+ */
+export interface AgentOptions {
+    /** Tavily API key (optional) */
+    tavilyApiKey?: string;
+    /** Context7 API key (optional) */
+    context7ApiKey?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Input for the Codebase Analyst agent
+ */
+export interface CodebaseAnalystInput {
+    /** The scan result from the scanner */
+    scanResult: ScanResult;
+    /** Project root directory */
+    projectRoot: string;
+}
+/**
+ * Input for the Stack Researcher agent
+ */
+export interface StackResearcherInput {
+    /** The detected stack */
+    stack: DetectedStack;
+    /** The identified project type */
+    projectType: string;
+    /** Agent capabilities */
+    capabilities: AgentCapabilities;
+}
+/**
+ * Input for the Orchestrator agent
+ */
+export interface OrchestratorInput {
+    /** Codebase analysis result */
+    codebaseAnalysis: CodebaseAnalysis;
+    /** Stack research result */
+    stackResearch: StackResearch;
+    /** The detected stack */
+    stack: DetectedStack;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,cAAc,EAAE;QACd,4BAA4B;QAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,+CAA+C;QAC/C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,8BAA8B;QAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,+EAA+E;QAC/E,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,0CAA0C;IAC1C,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kDAAkD;IAClD,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,wDAAwD;IACxD,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kEAAkE;IAClE,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,+CAA+C;IAC/C,aAAa,EAAE,aAAa,CAAC;IAC7B,2DAA2D;IAC3D,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,4BAA4B;IAC5B,aAAa,EAAE,aAAa,CAAC;IAC7B,yBAAyB;IACzB,KAAK,EAAE,aAAa,CAAC;CACtB"}

package/dist/ai/agents/types.js

@@ -0,0 +1,6 @@
+/**
+ * Agent Types and Interfaces
+ * Defines the structure for multi-agent analysis
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ai/agents/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}