wiggum-cli 0.2.1 → 0.2.3

package/dist/utils/colors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Simpson Color Palette
+ * Custom ANSI color utilities for the CLI
+ */
+/**
+ * Simpson color palette hex values
+ */
+export declare const SIMPSON_COLORS: {
+    readonly blue: "#2f64d6";
+    readonly yellow: "#f8db27";
+    readonly brown: "#9c5b01";
+    readonly white: "#ffffff";
+    readonly pink: "#ff81c1";
+};
+/**
+ * Simpson color functions for terminal output
+ */
+export declare const simpson: {
+    yellow: (text: string) => string;
+    blue: (text: string) => string;
+    brown: (text: string) => string;
+    white: (text: string) => string;
+    pink: (text: string) => string;
+};
+/**
+ * Box drawing characters
+ */
+export declare const box: {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+};
+/**
+ * Draw a horizontal line
+ */
+export declare function drawLine(width?: number): string;
+/**
+ * Draw a box around text
+ */
+export declare function drawBox(text: string, padding?: number): string;
+/**
+ * Section header with horizontal lines
+ */
+export declare function sectionHeader(title: string): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AA8BX;;GAEG;AACH,eAAO,MAAM,OAAO;mBACH,MAAM,KAAG,MAAM;iBACjB,MAAM,KAAG,MAAM;kBACd,MAAM,KAAG,MAAM;kBACf,MAAM,KAAG,MAAM;iBAChB,MAAM,KAAG,MAAM;CAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;CAOf,CAAC;AAEF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,MAAM,CASjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/dist/utils/colors.js

@@ -0,0 +1,85 @@
+/**
+ * Simpson Color Palette
+ * Custom ANSI color utilities for the CLI
+ */
+/**
+ * Simpson color palette hex values
+ */
+export const SIMPSON_COLORS = {
+    blue: '#2f64d6',
+    yellow: '#f8db27',
+    brown: '#9c5b01',
+    white: '#ffffff',
+    pink: '#ff81c1',
+};
+/**
+ * Convert hex to RGB
+ */
+function hexToRgb(hex) {
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    if (!result) {
+        return { r: 255, g: 255, b: 255 };
+    }
+    return {
+        r: parseInt(result[1], 16),
+        g: parseInt(result[2], 16),
+        b: parseInt(result[3], 16),
+    };
+}
+/**
+ * Create ANSI escape code for foreground color from hex
+ */
+function fgHex(hex) {
+    const { r, g, b } = hexToRgb(hex);
+    return `\x1b[38;2;${r};${g};${b}m`;
+}
+/**
+ * Reset ANSI escape code
+ */
+const reset = '\x1b[0m';
+/**
+ * Simpson color functions for terminal output
+ */
+export const simpson = {
+    yellow: (text) => `${fgHex(SIMPSON_COLORS.yellow)}${text}${reset}`,
+    blue: (text) => `${fgHex(SIMPSON_COLORS.blue)}${text}${reset}`,
+    brown: (text) => `${fgHex(SIMPSON_COLORS.brown)}${text}${reset}`,
+    white: (text) => `${fgHex(SIMPSON_COLORS.white)}${text}${reset}`,
+    pink: (text) => `${fgHex(SIMPSON_COLORS.pink)}${text}${reset}`,
+};
+/**
+ * Box drawing characters
+ */
+export const box = {
+    topLeft: '┌',
+    topRight: '┐',
+    bottomLeft: '└',
+    bottomRight: '┘',
+    horizontal: '─',
+    vertical: '│',
+};
+/**
+ * Draw a horizontal line
+ */
+export function drawLine(width = 50) {
+    return simpson.brown(box.horizontal.repeat(width));
+}
+/**
+ * Draw a box around text
+ */
+export function drawBox(text, padding = 1) {
+    const paddedText = ' '.repeat(padding) + text + ' '.repeat(padding);
+    const width = paddedText.length;
+    const top = simpson.brown(box.topLeft + box.horizontal.repeat(width) + box.topRight);
+    const middle = simpson.brown(box.vertical) + paddedText + simpson.brown(box.vertical);
+    const bottom = simpson.brown(box.bottomLeft + box.horizontal.repeat(width) + box.bottomRight);
+    return `${top}\n${middle}\n${bottom}`;
+}
+/**
+ * Section header with horizontal lines
+ */
+export function sectionHeader(title) {
+    const line = drawLine(50);
+    return `\n${line}\n${simpson.yellow(title)}\n${line}`;
+}
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

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

package/dist/utils/header.d.ts

@@ -1,5 +1,9 @@
 /**
- * Display the RALPH ASCII header in Simpson yellow
+ * Display the RALPH ASCII header with welcome box
  */
 export declare function displayHeader(): void;
+/**
+ * Display a minimal header (for subcommands)
+ */
+export declare function displayMinimalHeader(): void;
 //# sourceMappingURL=header.d.ts.map

package/dist/utils/header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/utils/header.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CASpC"}
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/utils/header.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAgBpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/utils/header.js

@@ -1,15 +1,30 @@
 import cfonts from 'cfonts';
+import { simpson, drawBox, SIMPSON_COLORS } from './colors.js';
 /**
- * Display the RALPH ASCII header in Simpson yellow
+ * Display the RALPH ASCII header with welcome box
  */
 export function displayHeader() {
-    cfonts.say('RALPH', {
+    // Welcome box like Claude Code
+    const welcomeText = simpson.pink('*') + ' Welcome to ' + simpson.yellow('Ralph') + '🍩';
+    console.log('');
+    console.log(drawBox(welcomeText, 2));
+    console.log('');
+    // ASCII art logo in Simpson yellow
+    cfonts.say('WIGGUM CLI', {
         font: 'block',
-        colors: ['#FED90F'],
+        colors: [SIMPSON_COLORS.yellow],
         letterSpacing: 1,
         lineHeight: 1,
-        space: true,
+        space: false,
         maxLength: 0,
     });
 }
+/**
+ * Display a minimal header (for subcommands)
+ */
+export function displayMinimalHeader() {
+    console.log('');
+    console.log(simpson.yellow('Ralph') + simpson.brown(' │ ') + 'AI-powered loop development');
+    console.log('');
+}
 //# sourceMappingURL=header.js.map

package/dist/utils/header.js.map

@@ -1 +1 @@
-{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/utils/header.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE;QAClB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/utils/header.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,+BAA+B;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,mCAAmC;IACnC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE;QACvB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC;QAC/B,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,6BAA6B,CAAC,CAAC;IAC5F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiggum-cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,8 @@
     "ai": "^6.0.41",
     "cfonts": "^3.2.0",
     "commander": "^12.1.0",
-    "picocolors": "^1.0.0"
+    "picocolors": "^1.0.0",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",

package/src/ai/enhancer.ts

@@ -3,64 +3,61 @@
  * Uses AI to analyze the codebase for deeper insights
  */
 
-import { generateText } from 'ai';
+import { generateText, stepCountIs } from 'ai';
 import type { ScanResult, DetectedStack, DetectionResult } from '../scanner/types.js';
 import { getModel, type AIProvider, hasApiKey, getApiKeyEnvVar } from './providers.js';
-import { SYSTEM_PROMPT, createAnalysisPrompt } from './prompts.js';
+import { SYSTEM_PROMPT, SYSTEM_PROMPT_AGENTIC, createAnalysisPrompt } from './prompts.js';
+import { createExplorationTools } from './tools.js';
 import { logger } from '../utils/logger.js';
 
 /**
- * Framework insights from AI analysis
+ * Project context from AI analysis - key structure information
  */
-export interface FrameworkInsights {
-  variant?: string;
-  confidence: 'high' | 'medium' | 'low';
-  notes?: string;
+export interface ProjectContext {
+  /** Key entry point files */
+  entryPoints?: string[];
+  /** Important directories and their purposes */
+  keyDirectories?: Record<string, string>;
+  /** Naming conventions used in the project */
+  namingConventions?: string;
 }
 
 /**
- * Architectural pattern detected by AI
+ * Detected commands from package.json scripts or common patterns
  */
-export interface ArchitecturalPattern {
-  pattern: string;
-  confidence: 'high' | 'medium' | 'low';
-  evidence: string;
+export interface DetectedCommands {
+  test?: string;
+  lint?: string;
+  typecheck?: string;
+  build?: string;
+  dev?: string;
+  format?: string;
 }
 
 /**
- * Coding convention detected by AI
+ * MCP server recommendations (categorized)
  */
-export interface CodingConvention {
-  convention: string;
-  suggestion: string;
+export interface McpRecommendations {
+  /** Essential MCP servers for this stack */
+  essential?: string[];
+  /** Recommended but optional MCP servers */
+  recommended?: string[];
 }
 
 /**
- * MCP server recommendation
- */
-export interface McpRecommendation {
-  name: string;
-  reason: string;
-}
-
-/**
- * Additional detection suggestions
- */
-export interface AdditionalDetections {
-  possibleMissed?: string[];
-  refinements?: string[];
-}
-
-/**
- * AI analysis result
+ * AI analysis result - focused on actionable outputs
  */
 export interface AIAnalysisResult {
-  frameworkInsights?: FrameworkInsights;
-  architecturalPatterns?: ArchitecturalPattern[];
-  codingConventions?: CodingConvention[];
-  recommendedMcpServers?: McpRecommendation[];
-  customPromptSuggestions?: string[];
-  additionalDetections?: AdditionalDetections;
+  /** Project structure and context */
+  projectContext?: ProjectContext;
+  /** Detected commands from package.json */
+  commands?: DetectedCommands;
+  /** Short, actionable implementation guidelines */
+  implementationGuidelines?: string[];
+  /** MCP server recommendations */
+  mcpServers?: McpRecommendations;
+  /** Additional technologies that may have been missed */
+  possibleMissedTechnologies?: string[];
 }
 
 /**
@@ -80,6 +77,8 @@ export interface EnhancerOptions {
   provider?: AIProvider;
   model?: string;
   verbose?: boolean;
+  /** Use agentic mode with tools for deeper codebase exploration */
+  agentic?: boolean;
 }
 
 /**
@@ -119,37 +118,24 @@ function applyEnhancements(
 ): DetectedStack {
   const enhanced = { ...stack };
 
-  // Enhance framework detection with AI insights
-  if (analysis.frameworkInsights && enhanced.framework) {
-    // If AI detected a more specific variant with high confidence
-    if (
-      analysis.frameworkInsights.variant &&
-      analysis.frameworkInsights.confidence === 'high'
-    ) {
-      enhanced.framework = {
-        ...enhanced.framework,
-        variant: analysis.frameworkInsights.variant,
-        evidence: [
-          ...enhanced.framework.evidence,
-          `AI: ${analysis.frameworkInsights.notes || 'variant detected'}`,
+  // Enhance MCP recommendations from AI analysis
+  if (analysis.mcpServers) {
+    const aiRecommended = [
+      ...(analysis.mcpServers.essential || []),
+      ...(analysis.mcpServers.recommended || []),
+    ];
+
+    if (aiRecommended.length > 0) {
+      enhanced.mcp = {
+        ...enhanced.mcp,
+        recommended: [
+          ...(enhanced.mcp?.recommended || []),
+          ...aiRecommended.filter(r => !enhanced.mcp?.recommended?.includes(r)),
         ],
       };
     }
   }
 
-  // Enhance MCP recommendations
-  if (analysis.recommendedMcpServers && analysis.recommendedMcpServers.length > 0) {
-    const aiRecommended = analysis.recommendedMcpServers.map(r => r.name);
-
-    enhanced.mcp = {
-      ...enhanced.mcp,
-      recommended: [
-        ...(enhanced.mcp?.recommended || []),
-        ...aiRecommended.filter(r => !enhanced.mcp?.recommended?.includes(r)),
-      ],
-    };
-  }
-
   return enhanced;
 }
 
@@ -161,11 +147,13 @@ export class AIEnhancer {
   private provider: AIProvider;
   private model?: string;
   private verbose: boolean;
+  private agentic: boolean;
 
   constructor(options: EnhancerOptions = {}) {
     this.provider = options.provider || 'anthropic';
     this.model = options.model;
     this.verbose = options.verbose || false;
+    this.agentic = options.agentic || false;
   }
 
   /**
@@ -202,22 +190,20 @@ export class AIEnhancer {
 
       if (this.verbose) {
         logger.info(`Using AI provider: ${provider} (${modelId})`);
+        if (this.agentic) {
+          logger.info('Agentic mode enabled - AI will explore the codebase with tools');
+        }
       }
 
-      // Create the analysis prompt
-      const prompt = createAnalysisPrompt(scanResult);
-
-      // Call the AI model
-      const { text } = await generateText({
-        model,
-        system: SYSTEM_PROMPT,
-        prompt,
-        maxOutputTokens: 2000,
-        temperature: 0.3, // Lower temperature for more consistent output
-      });
+      let analysis: AIAnalysisResult | null;
 
-      // Parse the response
-      const analysis = parseAIResponse(text);
+      if (this.agentic) {
+        // Agentic mode: use tools to explore codebase
+        analysis = await this.enhanceAgentic(model, scanResult);
+      } else {
+        // Simple mode: just analyze detected stack
+        analysis = await this.enhanceSimple(model, scanResult);
+      }
 
       if (!analysis) {
         return {
@@ -250,6 +236,80 @@ export class AIEnhancer {
       };
     }
   }
+
+  /**
+   * Simple enhancement mode - analyze detected stack without tools
+   */
+  private async enhanceSimple(
+    model: ReturnType<typeof getModel>['model'],
+    scanResult: ScanResult
+  ): Promise<AIAnalysisResult | null> {
+    const prompt = createAnalysisPrompt(scanResult);
+
+    const { text } = await generateText({
+      model,
+      system: SYSTEM_PROMPT,
+      prompt,
+      maxOutputTokens: 2000,
+      temperature: 0.3,
+    });
+
+    return parseAIResponse(text);
+  }
+
+  /**
+   * Agentic enhancement mode - use tools to explore codebase
+   */
+  private async enhanceAgentic(
+    model: ReturnType<typeof getModel>['model'],
+    scanResult: ScanResult
+  ): Promise<AIAnalysisResult | null> {
+    const tools = createExplorationTools(scanResult.projectRoot);
+
+    const prompt = `Analyze this codebase and produce configuration for AI-assisted development.
+
+Project: ${scanResult.projectRoot}
+
+Start by exploring the codebase structure, then produce your analysis.
+When done exploring, output your final analysis as valid JSON matching this structure:
+
+{
+  "projectContext": {
+    "entryPoints": ["src/index.ts"],
+    "keyDirectories": {"src/routes": "API routes"},
+    "namingConventions": "camelCase files, PascalCase components"
+  },
+  "commands": {
+    "test": "npm test",
+    "lint": "npm run lint",
+    "build": "npm run build",
+    "dev": "npm run dev"
+  },
+  "implementationGuidelines": [
+    "Run npm test after changes",
+    "Use Zod for validation"
+  ],
+  "mcpServers": {
+    "essential": ["filesystem", "git"],
+    "recommended": ["docker"]
+  },
+  "possibleMissedTechnologies": ["Redis"]
+}`;
+
+    // Use agentic loop - AI will call tools until it has enough info
+    // stopWhen: stepCountIs(10) allows up to 10 tool-calling steps
+    const { text } = await generateText({
+      model,
+      system: SYSTEM_PROMPT_AGENTIC,
+      prompt,
+      tools,
+      stopWhen: stepCountIs(10),
+      maxOutputTokens: 4000,
+      temperature: 0.3,
+    });
+
+    return parseAIResponse(text);
+  }
 }
 
 /**
@@ -269,85 +329,73 @@ export async function enhanceWithAI(
 export function formatAIAnalysis(analysis: AIAnalysisResult): string {
   const lines: string[] = [];
 
-  lines.push('=== AI Analysis ===');
-  lines.push('');
+  // Project context
+  if (analysis.projectContext) {
+    const ctx = analysis.projectContext;
 
-  // Framework insights
-  if (analysis.frameworkInsights) {
-    lines.push('Framework Insights:');
-    if (analysis.frameworkInsights.variant) {
-      lines.push(`  Variant: ${analysis.frameworkInsights.variant}`);
-    }
-    lines.push(`  Confidence: ${analysis.frameworkInsights.confidence}`);
-    if (analysis.frameworkInsights.notes) {
-      lines.push(`  Notes: ${analysis.frameworkInsights.notes}`);
+    if (ctx.entryPoints && ctx.entryPoints.length > 0) {
+      lines.push('Entry Points:');
+      for (const entry of ctx.entryPoints) {
+        lines.push(`  ${entry}`);
+      }
+      lines.push('');
     }
-    lines.push('');
-  }
 
-  // Architectural patterns
-  if (analysis.architecturalPatterns && analysis.architecturalPatterns.length > 0) {
-    lines.push('Architectural Patterns:');
-    for (const pattern of analysis.architecturalPatterns) {
-      lines.push(`  - ${pattern.pattern} [${pattern.confidence}]`);
-      lines.push(`    Evidence: ${pattern.evidence}`);
+    if (ctx.keyDirectories && Object.keys(ctx.keyDirectories).length > 0) {
+      lines.push('Key Directories:');
+      for (const [dir, purpose] of Object.entries(ctx.keyDirectories)) {
+        lines.push(`  ${dir} → ${purpose}`);
+      }
+      lines.push('');
     }
-    lines.push('');
-  }
 
-  // Coding conventions
-  if (analysis.codingConventions && analysis.codingConventions.length > 0) {
-    lines.push('Coding Conventions:');
-    for (const convention of analysis.codingConventions) {
-      lines.push(`  - ${convention.convention}`);
-      lines.push(`    Suggestion: ${convention.suggestion}`);
+    if (ctx.namingConventions) {
+      lines.push(`Naming: ${ctx.namingConventions}`);
+      lines.push('');
     }
-    lines.push('');
   }
 
-  // MCP recommendations
-  if (analysis.recommendedMcpServers && analysis.recommendedMcpServers.length > 0) {
-    lines.push('Recommended MCP Servers:');
-    for (const server of analysis.recommendedMcpServers) {
-      lines.push(`  - ${server.name}`);
-      lines.push(`    Reason: ${server.reason}`);
+  // Detected commands
+  if (analysis.commands) {
+    const cmds = analysis.commands;
+    const cmdList = Object.entries(cmds).filter(([_, v]) => v);
+
+    if (cmdList.length > 0) {
+      lines.push('Commands:');
+      for (const [name, cmd] of cmdList) {
+        lines.push(`  ${name}: ${cmd}`);
+      }
+      lines.push('');
     }
-    lines.push('');
   }
 
-  // Custom prompt suggestions
-  if (analysis.customPromptSuggestions && analysis.customPromptSuggestions.length > 0) {
-    lines.push('Custom Prompt Suggestions:');
-    for (const suggestion of analysis.customPromptSuggestions) {
-      lines.push(`  - ${suggestion}`);
+  // Implementation guidelines (the most important part)
+  if (analysis.implementationGuidelines && analysis.implementationGuidelines.length > 0) {
+    lines.push('Implementation Guidelines:');
+    for (const guideline of analysis.implementationGuidelines) {
+      lines.push(`  • ${guideline}`);
     }
     lines.push('');
   }
 
-  // Additional detections
-  if (analysis.additionalDetections) {
-    if (
-      analysis.additionalDetections.possibleMissed &&
-      analysis.additionalDetections.possibleMissed.length > 0
-    ) {
-      lines.push('Possibly Missed Technologies:');
-      for (const tech of analysis.additionalDetections.possibleMissed) {
-        lines.push(`  - ${tech}`);
-      }
-      lines.push('');
+  // MCP servers
+  if (analysis.mcpServers) {
+    if (analysis.mcpServers.essential && analysis.mcpServers.essential.length > 0) {
+      lines.push(`MCP (essential): ${analysis.mcpServers.essential.join(', ')}`);
     }
-
-    if (
-      analysis.additionalDetections.refinements &&
-      analysis.additionalDetections.refinements.length > 0
-    ) {
-      lines.push('Detection Refinements:');
-      for (const refinement of analysis.additionalDetections.refinements) {
-        lines.push(`  - ${refinement}`);
-      }
+    if (analysis.mcpServers.recommended && analysis.mcpServers.recommended.length > 0) {
+      lines.push(`MCP (optional): ${analysis.mcpServers.recommended.join(', ')}`);
+    }
+    if (analysis.mcpServers.essential?.length || analysis.mcpServers.recommended?.length) {
       lines.push('');
     }
   }
 
+  // Possibly missed technologies (brief)
+  if (analysis.possibleMissedTechnologies && analysis.possibleMissedTechnologies.length > 0) {
+    lines.push(`May also use: ${analysis.possibleMissedTechnologies.join(', ')}`);
+    lines.push('');
+  }
+
   return lines.join('\n');
 }

package/src/ai/index.ts

@@ -17,18 +17,23 @@ export {
 export {
   formatStackForPrompt,
   SYSTEM_PROMPT,
+  SYSTEM_PROMPT_AGENTIC,
   createAnalysisPrompt,
   createValidationPrompt,
   createRecommendationsPrompt,
 } from './prompts.js';
 
+// Tools for agentic exploration
+export {
+  createExplorationTools,
+  RIPGREP_SKILL,
+} from './tools.js';
+
 // AI enhancer
 export {
-  type FrameworkInsights,
-  type ArchitecturalPattern,
-  type CodingConvention,
-  type McpRecommendation,
-  type AdditionalDetections,
+  type ProjectContext,
+  type DetectedCommands,
+  type McpRecommendations,
   type AIAnalysisResult,
   type EnhancedScanResult,
   type EnhancerOptions,