wiggum-cli 0.5.0 → 0.5.1

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;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,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,4CAA4C,CAAC;IACnH,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,YAAY,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,mCAAmC,CAAC,CAAC;IACvG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,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;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,gCAAgC;AAChC,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,MAAM,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC;IACjL,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,YAAY,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,mCAAmC,CAAC,CAAC;IACvG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/spinner.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Custom Spinner with Shimmer Effect, Timer, and Token Tracking
+ * Inspired by Claude Code's loading experience
+ */
+export interface ShimmerSpinnerOptions {
+    /** Enable shimmer effect (default: true) */
+    shimmer?: boolean;
+    /** Show elapsed time (default: true) */
+    showTimer?: boolean;
+    /** Show token usage (default: false) */
+    showTokens?: boolean;
+    /** Spinner style (default: 'shimmer') */
+    style?: 'shimmer' | 'braille' | 'dots';
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Custom spinner with shimmer effect, timer, and token tracking
+ */
+export declare class ShimmerSpinner {
+    private message;
+    private isRunning;
+    private intervalId;
+    private frameIndex;
+    private startTime;
+    private tokens;
+    private options;
+    private frames;
+    constructor(options?: ShimmerSpinnerOptions);
+    /**
+     * Start the spinner with a message
+     */
+    start(message: string): void;
+    /**
+     * Update the spinner message
+     */
+    update(message: string): void;
+    /**
+     * Update token usage (adds to existing)
+     */
+    updateTokens(usage: TokenUsage): void;
+    /**
+     * Set token usage directly
+     */
+    setTokens(usage: TokenUsage): void;
+    /**
+     * Render the spinner
+     */
+    private render;
+    /**
+     * Stop the spinner with a final message
+     */
+    stop(finalMessage?: string): void;
+    /**
+     * Stop with error
+     */
+    fail(message?: string): void;
+    /**
+     * Get elapsed time in milliseconds
+     */
+    getElapsed(): number;
+    /**
+     * Get current token usage
+     */
+    getTokens(): TokenUsage;
+}
+/**
+ * Create a shimmer spinner instance
+ */
+export declare function createShimmerSpinner(options?: ShimmerSpinnerOptions): ShimmerSpinner;
+//# sourceMappingURL=spinner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,MAAM,CAAmE;IACjF,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAW;gBAEb,OAAO,GAAE,qBAA0B;IAuB/C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB5B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQrC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,OAAO,CAAC,MAAM;IAgCd;;OAEG;IACH,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IA4BjC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAsB5B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,IAAI,UAAU;CAGxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAEpF"}

package/dist/utils/spinner.js

@@ -0,0 +1,208 @@
+/**
+ * Custom Spinner with Shimmer Effect, Timer, and Token Tracking
+ * Inspired by Claude Code's loading experience
+ */
+import { simpson } from './colors.js';
+/**
+ * Shimmer frames for the spinner animation
+ * Creates a wave-like effect similar to Claude Code
+ */
+const SHIMMER_FRAMES = [
+    '░▒▓█▓▒░',
+    '▒▓█▓▒░░',
+    '▓█▓▒░░▒',
+    '█▓▒░░▒▓',
+    '▓▒░░▒▓█',
+    '▒░░▒▓█▓',
+    '░░▒▓█▓▒',
+    '░▒▓█▓▒░',
+];
+/**
+ * Braille spinner frames (alternative style)
+ */
+const BRAILLE_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/**
+ * Dots spinner frames
+ */
+const DOTS_FRAMES = ['⠁', '⠂', '⠄', '⡀', '⢀', '⠠', '⠐', '⠈'];
+/**
+ * Format milliseconds to human-readable time
+ */
+function formatTime(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes > 0) {
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * Format token count with commas
+ */
+function formatTokens(tokens) {
+    return tokens.toLocaleString();
+}
+/**
+ * Custom spinner with shimmer effect, timer, and token tracking
+ */
+export class ShimmerSpinner {
+    message = '';
+    isRunning = false;
+    intervalId = null;
+    frameIndex = 0;
+    startTime = 0;
+    tokens = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    options;
+    frames;
+    constructor(options = {}) {
+        this.options = {
+            shimmer: options.shimmer ?? true,
+            showTimer: options.showTimer ?? true,
+            showTokens: options.showTokens ?? false,
+            style: options.style ?? 'shimmer',
+        };
+        // Select frames based on style
+        switch (this.options.style) {
+            case 'braille':
+                this.frames = BRAILLE_FRAMES;
+                break;
+            case 'dots':
+                this.frames = DOTS_FRAMES;
+                break;
+            case 'shimmer':
+            default:
+                this.frames = SHIMMER_FRAMES;
+                break;
+        }
+    }
+    /**
+     * Start the spinner with a message
+     */
+    start(message) {
+        this.message = message;
+        this.isRunning = true;
+        this.startTime = Date.now();
+        this.frameIndex = 0;
+        // Clear line and hide cursor
+        process.stdout.write('\x1B[?25l');
+        this.render();
+        this.intervalId = setInterval(() => {
+            this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+            this.render();
+        }, 80);
+    }
+    /**
+     * Update the spinner message
+     */
+    update(message) {
+        this.message = message;
+    }
+    /**
+     * Update token usage (adds to existing)
+     */
+    updateTokens(usage) {
+        this.tokens = {
+            inputTokens: this.tokens.inputTokens + usage.inputTokens,
+            outputTokens: this.tokens.outputTokens + usage.outputTokens,
+            totalTokens: this.tokens.totalTokens + usage.totalTokens,
+        };
+    }
+    /**
+     * Set token usage directly
+     */
+    setTokens(usage) {
+        this.tokens = usage;
+    }
+    /**
+     * Render the spinner
+     */
+    render() {
+        if (!this.isRunning)
+            return;
+        const elapsed = Date.now() - this.startTime;
+        const frame = this.frames[this.frameIndex];
+        let line = '';
+        // Shimmer/spinner frame
+        if (this.options.shimmer && this.options.style === 'shimmer') {
+            line += simpson.yellow(frame) + ' ';
+        }
+        else {
+            line += simpson.yellow(frame) + ' ';
+        }
+        // Message
+        line += this.message;
+        // Timer
+        if (this.options.showTimer) {
+            line += simpson.brown(` [${formatTime(elapsed)}]`);
+        }
+        // Tokens
+        if (this.options.showTokens && this.tokens.totalTokens > 0) {
+            line += simpson.pink(` (${formatTokens(this.tokens.totalTokens)} tokens)`);
+        }
+        // Clear line and write
+        process.stdout.write('\r\x1B[K' + line);
+    }
+    /**
+     * Stop the spinner with a final message
+     */
+    stop(finalMessage) {
+        this.isRunning = false;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        const elapsed = Date.now() - this.startTime;
+        // Build final line
+        let line = '';
+        line += simpson.yellow('✓') + ' ';
+        line += finalMessage || this.message;
+        if (this.options.showTimer) {
+            line += simpson.brown(` [${formatTime(elapsed)}]`);
+        }
+        if (this.options.showTokens && this.tokens.totalTokens > 0) {
+            line += simpson.pink(` (${formatTokens(this.tokens.totalTokens)} tokens)`);
+        }
+        // Clear line, show cursor, print final
+        process.stdout.write('\r\x1B[K' + line + '\n');
+        process.stdout.write('\x1B[?25h');
+    }
+    /**
+     * Stop with error
+     */
+    fail(message) {
+        this.isRunning = false;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        const elapsed = Date.now() - this.startTime;
+        let line = '';
+        line += simpson.pink('✗') + ' ';
+        line += message || this.message;
+        if (this.options.showTimer) {
+            line += simpson.brown(` [${formatTime(elapsed)}]`);
+        }
+        process.stdout.write('\r\x1B[K' + line + '\n');
+        process.stdout.write('\x1B[?25h');
+    }
+    /**
+     * Get elapsed time in milliseconds
+     */
+    getElapsed() {
+        return Date.now() - this.startTime;
+    }
+    /**
+     * Get current token usage
+     */
+    getTokens() {
+        return { ...this.tokens };
+    }
+}
+/**
+ * Create a shimmer spinner instance
+ */
+export function createShimmerSpinner(options) {
+    return new ShimmerSpinner(options);
+}
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiggum-cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",

package/src/ai/agents/codebase-analyzer.ts

@@ -8,7 +8,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { stepCountIs, type LanguageModel } from 'ai';
 import type { ScanResult } from '../../scanner/types.js';
-import type { MultiAgentAnalysis, CodebaseAnalysis, StackResearch, RalphMcpServers } from './types.js';
+import type { MultiAgentAnalysis, CodebaseAnalysis, StackResearch, RalphMcpServers, TokenUsage } from './types.js';
 import { createExplorationTools } from '../tools.js';
 import { isReasoningModel } from '../providers.js';
 import { logger } from '../../utils/logger.js';
@@ -193,8 +193,15 @@ After exploring, output your complete analysis as JSON.`;
     // Detect MCP servers (pure function)
     const mcpServers = detectRalphMcpServers(stack, analyzerOutput.projectType);
 
+    // Capture token usage from AI response
+    const tokenUsage = result.usage ? {
+      inputTokens: result.usage.inputTokens ?? 0,
+      outputTokens: result.usage.outputTokens ?? 0,
+      totalTokens: result.usage.totalTokens ?? 0,
+    } : undefined;
+
     // Build full MultiAgentAnalysis
-    return buildMultiAgentAnalysis(analyzerOutput, mcpServers, input);
+    return buildMultiAgentAnalysis(analyzerOutput, mcpServers, input, tokenUsage);
   } catch (error) {
     if (verbose) {
       logger.error(`Codebase Analyzer error: ${error instanceof Error ? error.message : String(error)}`);
@@ -270,7 +277,8 @@ function parseAnalyzerOutput(
 function buildMultiAgentAnalysis(
   output: AnalyzerOutput,
   mcpServers: RalphMcpServers,
-  input: CodebaseAnalyzerInput
+  input: CodebaseAnalyzerInput,
+  tokenUsage?: TokenUsage
 ): MultiAgentAnalysis {
   const derivedCommands = deriveCommandsFromScripts(input.scanResult.projectRoot);
 
@@ -316,6 +324,7 @@ function buildMultiAgentAnalysis(
     codebaseAnalysis,
     stackResearch,
     mcpServers: convertToLegacyMcpRecommendations(mcpServers),
+    tokenUsage,
   };
 }
 

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

@@ -33,22 +33,25 @@ describe('detectRalphMcpServers', () => {
       expect(result.e2eTesting).toBe('playwright');
     });
 
-    it('returns mcp-inspector for MCP projects via stack.mcp.isProject', () => {
+    it('returns undefined for MCP projects (use npx @modelcontextprotocol/inspector)', () => {
       const stack = createStack({
         mcp: { isProject: true },
       });
       const result = detectRalphMcpServers(stack);
-      expect(result.e2eTesting).toBe('mcp-inspector');
+      // MCP Inspector is an npx tool, not an MCP server
+      expect(result.e2eTesting).toBeUndefined();
     });
 
-    it('returns mcp-inspector for MCP projects via projectType parameter', () => {
+    it('returns undefined for MCP projects via projectType parameter', () => {
       const result = detectRalphMcpServers(createStack(), 'MCP Server');
-      expect(result.e2eTesting).toBe('mcp-inspector');
+      // MCP Inspector is an npx tool, not an MCP server
+      expect(result.e2eTesting).toBeUndefined();
     });
 
-    it('returns mcp-inspector when projectType contains "mcp" (case-insensitive)', () => {
+    it('returns undefined when projectType contains "mcp" (case-insensitive)', () => {
       const result = detectRalphMcpServers(createStack(), 'mcp tool');
-      expect(result.e2eTesting).toBe('mcp-inspector');
+      // MCP Inspector is an npx tool, not an MCP server
+      expect(result.e2eTesting).toBeUndefined();
     });
 
     it('returns playwright for Next.js projects', () => {
@@ -81,7 +84,8 @@ describe('detectRalphMcpServers', () => {
         framework: detection('Next.js'),
       });
       const result = detectRalphMcpServers(stack);
-      expect(result.e2eTesting).toBe('mcp-inspector');
+      // MCP Inspector is an npx tool, not an MCP server - no E2E MCP for MCP projects
+      expect(result.e2eTesting).toBeUndefined();
     });
   });
 
@@ -313,6 +317,25 @@ describe('convertToLegacyMcpRecommendations', () => {
     expect(result.essential).toContain('playwright');
   });
 
+  it('returns empty essential when e2eTesting is undefined (MCP projects)', () => {
+    const result = convertToLegacyMcpRecommendations({
+      e2eTesting: undefined,
+      additional: [],
+    });
+    // MCP projects use npx @modelcontextprotocol/inspector, not an MCP server
+    expect(result.essential).toEqual([]);
+  });
+
+  it('only includes database in essential for MCP projects', () => {
+    const result = convertToLegacyMcpRecommendations({
+      e2eTesting: undefined,
+      database: 'supabase',
+      additional: [],
+    });
+    // MCP projects use npx inspector for testing, but still get database MCP
+    expect(result.essential).toEqual(['supabase']);
+  });
+
   it('includes database in essential when detected', () => {
     const result = convertToLegacyMcpRecommendations({
       e2eTesting: 'playwright',

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

@@ -66,13 +66,15 @@ const SERVICE_MCP_MAP: Record<string, string> = {
  * Detect ralph-essential MCP servers from the stack
  *
  * Ralph loop essentials:
- * - For MCP Server projects: mcp-inspector for testing
- * - For web apps with E2E: playwright for E2E testing
+ * - For web apps with E2E: playwright MCP server for E2E testing
  * - Database MCP: If database is detected
  * - Additional MCPs based on services and deployment
+ *
+ * Note: MCP Inspector is a debugging TOOL (npx @modelcontextprotocol/inspector),
+ * NOT an MCP server. It should be mentioned in implementation guidelines, not here.
  */
 export function detectRalphMcpServers(stack: DetectedStack, projectType?: string): RalphMcpServers {
-  // Determine appropriate E2E testing tool based on project type
+  // Determine appropriate E2E testing MCP based on project type
   const isMcpProject = stack.mcp?.isProject || projectType?.toLowerCase().includes('mcp');
   const isWebApp = stack.framework?.name?.toLowerCase().includes('next') ||
                    stack.framework?.name?.toLowerCase().includes('react') ||
@@ -81,12 +83,13 @@ export function detectRalphMcpServers(stack: DetectedStack, projectType?: string
                    stack.framework?.name?.toLowerCase().includes('nuxt') ||
                    stack.framework?.name?.toLowerCase().includes('remix');
 
-  // Choose E2E testing tool based on project type
-  let e2eTesting: string;
+  // Choose E2E testing MCP based on project type
+  // Note: MCP projects don't need an E2E testing MCP server - they use npx @modelcontextprotocol/inspector
+  let e2eTesting: string | undefined;
   if (isMcpProject) {
-    e2eTesting = 'mcp-inspector'; // MCP projects use MCP Inspector
+    e2eTesting = undefined; // MCP projects use npx inspector (not an MCP server)
   } else if (isWebApp) {
-    e2eTesting = 'playwright'; // Web apps use Playwright
+    e2eTesting = 'playwright'; // Web apps use Playwright MCP
   } else {
     e2eTesting = 'playwright'; // Default to Playwright for CLI/other projects
   }

package/src/ai/agents/types.ts

@@ -82,8 +82,8 @@ export interface TechResearchResult {
 export interface RalphMcpServers {
   /** Database MCP server if applicable */
   database?: string;
-  /** E2E testing MCP (always playwright for ralph) */
-  e2eTesting: string;
+  /** E2E testing MCP (playwright for web apps, undefined for MCP projects) */
+  e2eTesting?: string;
   /** Any additional recommended MCPs */
   additional: string[];
 }
@@ -178,6 +178,15 @@ export interface McpRecommendations {
 /**
  * Combined result from all agents
  */
+/**
+ * Token usage from AI calls
+ */
+export interface TokenUsage {
+  inputTokens: number;
+  outputTokens: number;
+  totalTokens: number;
+}
+
 export interface MultiAgentAnalysis {
   /** Codebase analysis from the Codebase Analyst */
   codebaseAnalysis: CodebaseAnalysis;
@@ -185,6 +194,8 @@ export interface MultiAgentAnalysis {
   stackResearch: StackResearch;
   /** MCP server recommendations (merged from both agents) */
   mcpServers: McpRecommendations;
+  /** Token usage from AI calls */
+  tokenUsage?: TokenUsage;
 }
 
 /**