wiggum-cli 0.2.6 → 0.3.1

package/dist/utils/json-repair.js

@@ -0,0 +1,103 @@
+/**
+ * JSON Repair Utility
+ * Fixes common JSON syntax errors from AI responses
+ */
+/**
+ * Attempt to repair malformed JSON from AI responses
+ */
+export function repairJson(text) {
+    let json = text;
+    // Remove any leading/trailing whitespace
+    json = json.trim();
+    // Remove trailing commas before ] or }
+    json = json.replace(/,(\s*[\]}])/g, '$1');
+    // Fix missing commas between array elements or object properties
+    // Pattern: value followed by newline and another value without comma
+    json = json.replace(/("|\d|true|false|null|\]|\})(\s*\n\s*)("|\[|\{)/g, '$1,$2$3');
+    // Fix single quotes to double quotes (but not inside strings)
+    // This is a simplified approach - may not work for all cases
+    json = json.replace(/'/g, '"');
+    // Remove JavaScript-style comments
+    json = json.replace(/\/\/.*$/gm, '');
+    json = json.replace(/\/\*[\s\S]*?\*\//g, '');
+    // Fix unquoted keys (simple cases)
+    json = json.replace(/(\{|\,)\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*:/g, '$1"$2":');
+    // Remove any text before the first { or [
+    const firstBrace = json.indexOf('{');
+    const firstBracket = json.indexOf('[');
+    let startIndex = -1;
+    if (firstBrace !== -1 && firstBracket !== -1) {
+        startIndex = Math.min(firstBrace, firstBracket);
+    }
+    else if (firstBrace !== -1) {
+        startIndex = firstBrace;
+    }
+    else if (firstBracket !== -1) {
+        startIndex = firstBracket;
+    }
+    if (startIndex > 0) {
+        json = json.substring(startIndex);
+    }
+    // Remove any text after the last } or ]
+    const lastBrace = json.lastIndexOf('}');
+    const lastBracket = json.lastIndexOf(']');
+    let endIndex = -1;
+    if (lastBrace !== -1 && lastBracket !== -1) {
+        endIndex = Math.max(lastBrace, lastBracket);
+    }
+    else if (lastBrace !== -1) {
+        endIndex = lastBrace;
+    }
+    else if (lastBracket !== -1) {
+        endIndex = lastBracket;
+    }
+    if (endIndex !== -1 && endIndex < json.length - 1) {
+        json = json.substring(0, endIndex + 1);
+    }
+    return json;
+}
+/**
+ * Parse JSON with repair attempts
+ * Tries to fix common issues before parsing
+ */
+export function parseJsonSafe(text) {
+    // First try parsing as-is
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // Try with repairs
+    }
+    // Try repairing the JSON
+    try {
+        const repaired = repairJson(text);
+        return JSON.parse(repaired);
+    }
+    catch {
+        // Repair failed
+    }
+    // Last resort: try to extract JSON from markdown code blocks
+    const jsonMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (jsonMatch) {
+        try {
+            const repaired = repairJson(jsonMatch[1]);
+            return JSON.parse(repaired);
+        }
+        catch {
+            // Still failed
+        }
+    }
+    // Try finding a JSON object
+    const objectMatch = text.match(/\{[\s\S]*\}/);
+    if (objectMatch) {
+        try {
+            const repaired = repairJson(objectMatch[0]);
+            return JSON.parse(repaired);
+        }
+        catch {
+            // Still failed
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=json-repair.js.map

package/dist/utils/json-repair.js.map

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

package/dist/utils/tracing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Braintrust Tracing Utility
+ * Provides AI call tracing for debugging and analysis
+ */
+import * as ai from 'ai';
+export { traced, currentSpan, wrapTraced } from 'braintrust';
+export declare function initTracing(): void;
+/**
+ * Check if tracing is enabled
+ */
+export declare function isTracingEnabled(): boolean;
+/**
+ * Get wrapped AI SDK functions for automatic tracing
+ * Falls back to original functions if tracing not available
+ */
+export declare function getTracedAI(): typeof ai;
+/**
+ * Wrap a function with tracing
+ * No-op if tracing is not enabled
+ */
+export declare function maybeTraced<T extends (...args: unknown[]) => unknown>(fn: T, options?: {
+    type?: string;
+    name?: string;
+}): T;
+//# sourceMappingURL=tracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/utils/tracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7D,wBAAgB,WAAW,IAAI,IAAI,CAkBlC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,cAS1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACnE,EAAE,EAAE,CAAC,EACL,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,CAAC,CAUH"}

package/dist/utils/tracing.js

@@ -0,0 +1,64 @@
+/**
+ * Braintrust Tracing Utility
+ * Provides AI call tracing for debugging and analysis
+ */
+import { initLogger, wrapAISDK } from 'braintrust';
+import * as ai from 'ai';
+// Re-export traced utilities
+export { traced, currentSpan, wrapTraced } from 'braintrust';
+/**
+ * Initialize Braintrust logger if API key is available
+ */
+let loggerInitialized = false;
+export function initTracing() {
+    if (loggerInitialized)
+        return;
+    const apiKey = process.env.BRAINTRUST_API_KEY;
+    if (!apiKey) {
+        // Silently skip tracing if no API key
+        return;
+    }
+    try {
+        initLogger({
+            apiKey,
+            projectName: process.env.BRAINTRUST_PROJECT_NAME || 'wiggum-cli',
+        });
+        loggerInitialized = true;
+    }
+    catch {
+        // Silently fail if tracing can't be initialized
+    }
+}
+/**
+ * Check if tracing is enabled
+ */
+export function isTracingEnabled() {
+    return !!process.env.BRAINTRUST_API_KEY;
+}
+/**
+ * Get wrapped AI SDK functions for automatic tracing
+ * Falls back to original functions if tracing not available
+ */
+export function getTracedAI() {
+    initTracing();
+    if (isTracingEnabled()) {
+        return wrapAISDK(ai);
+    }
+    // Return original AI SDK functions if tracing not enabled
+    return ai;
+}
+/**
+ * Wrap a function with tracing
+ * No-op if tracing is not enabled
+ */
+export function maybeTraced(fn, options = {}) {
+    if (!isTracingEnabled()) {
+        return fn;
+    }
+    const { wrapTraced } = require('braintrust');
+    return wrapTraced(fn, {
+        type: options.type || 'function',
+        name: options.name || fn.name || 'anonymous',
+    });
+}
+//# sourceMappingURL=tracing.js.map

package/dist/utils/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/utils/tracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,6BAA6B;AAC7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B,MAAM,UAAU,WAAW;IACzB,IAAI,iBAAiB;QAAE,OAAO;IAE9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,sCAAsC;QACtC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,UAAU,CAAC;YACT,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,YAAY;SACjE,CAAC,CAAC;QACH,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,WAAW,EAAE,CAAC;IAEd,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,0DAA0D;IAC1D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,EAAK,EACL,UAA4C,EAAE;IAE9C,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,EAAE,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,UAAU;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,WAAW;KAC7C,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "wiggum-cli",
-  "version": "0.2.6",
+  "version": "0.3.1",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "ralph": "./bin/ralph.js"
+    "wiggum": "./bin/ralph.js"
   },
   "scripts": {
     "build": "tsc && npm run copy-templates",
@@ -23,13 +23,15 @@
     "code-generation",
     "tech-stack-detection"
   ],
-  "author": "Ralph CLI Contributors",
+  "author": "Wiggum CLI Contributors",
   "license": "MIT",
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.15",
     "@ai-sdk/openai": "^3.0.12",
+    "@braintrust/otel": "^0.2.0",
     "@clack/prompts": "^0.7.0",
     "ai": "^6.0.41",
+    "braintrust": "^2.0.2",
     "cfonts": "^3.2.0",
     "commander": "^12.1.0",
     "picocolors": "^1.0.0",

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

@@ -0,0 +1,169 @@
+/**
+ * Codebase Analyst Agent
+ * Explores the codebase to understand its structure and patterns
+ */
+
+import { stepCountIs, type LanguageModel } from 'ai';
+import type { CodebaseAnalysis, CodebaseAnalystInput } from './types.js';
+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';
+
+/**
+ * System prompt for the Codebase Analyst agent
+ */
+const CODEBASE_ANALYST_SYSTEM_PROMPT = `You are a Codebase Analyst agent. Your job is to thoroughly explore a codebase and produce a structured analysis.
+
+## Your Mission
+Explore the codebase to understand:
+1. Project structure and entry points
+2. Key directories and their purposes
+3. Naming conventions
+4. Available commands (from package.json)
+5. The primary project type
+
+## Exploration Strategy
+1. First, list the root directory to understand project structure
+2. Read package.json to understand scripts and dependencies
+3. Search for key patterns: entry points, routes, components
+4. Identify the PROJECT TYPE:
+   - 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
+
+## Tools Available
+- searchCode: Search using ripgrep patterns
+- readFile: Read file contents
+- listDirectory: List directory structure
+- getPackageInfo: Get package.json info
+
+## Output Format
+After exploration, output ONLY valid JSON with this exact structure:
+{
+  "projectContext": {
+    "entryPoints": ["src/index.ts"],
+    "keyDirectories": {"src/routes": "API routes"},
+    "namingConventions": "camelCase files, PascalCase components",
+    "projectType": "MCP Server"
+  },
+  "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"
+  ],
+  "possibleMissedTechnologies": ["Redis"]
+}
+
+Keep each guideline to 5-10 words max. Max 7 guidelines.`;
+
+/**
+ * Run the Codebase Analyst agent
+ */
+export async function runCodebaseAnalyst(
+  model: LanguageModel,
+  modelId: string,
+  input: CodebaseAnalystInput,
+  verbose: boolean = false
+): Promise<CodebaseAnalysis | null> {
+  const tools = createExplorationTools(input.projectRoot);
+
+  const prompt = `Analyze this codebase and produce a structured analysis.
+
+Project: ${input.projectRoot}
+
+Start by exploring the directory structure and package.json, then produce your analysis as JSON.`;
+
+  try {
+    const { generateText } = getTracedAI();
+
+    const result = await generateText({
+      model,
+      system: CODEBASE_ANALYST_SYSTEM_PROMPT,
+      prompt,
+      tools,
+      stopWhen: stepCountIs(12),
+      maxOutputTokens: 3000,
+      ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+      experimental_telemetry: {
+        isEnabled: true,
+        metadata: { agent: 'codebase-analyst', projectRoot: input.projectRoot },
+      },
+    });
+
+    // Extract JSON from response
+    const analysis = parseCodebaseAnalysis(result.text, result.steps, verbose);
+    return analysis;
+  } catch (error) {
+    if (verbose) {
+      logger.error(`Codebase Analyst error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return null;
+  }
+}
+
+/**
+ * Parse the codebase analysis from agent response
+ */
+function parseCodebaseAnalysis(
+  text: string,
+  steps: Array<{ text?: string }> | undefined,
+  verbose: boolean
+): CodebaseAnalysis | null {
+  // Try to get text from the result or steps
+  let textToParse = text;
+
+  if (!textToParse || textToParse.trim() === '') {
+    // Look through steps for text content
+    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('Codebase Analyst: No text output found');
+    }
+    return null;
+  }
+
+  // Use safe JSON parser with repair capabilities
+  const parsed = parseJsonSafe<CodebaseAnalysis>(textToParse);
+
+  if (!parsed) {
+    if (verbose) {
+      logger.warn('Codebase Analyst: Failed to parse JSON response');
+      logger.warn(`Response preview: ${textToParse.substring(0, 200)}...`);
+    }
+    return null;
+  }
+
+  // Validate required fields
+  if (!parsed.projectContext || !parsed.commands) {
+    if (verbose) {
+      logger.warn('Codebase Analyst: Missing required fields in response');
+    }
+    return null;
+  }
+
+  // Ensure projectType is set
+  if (!parsed.projectContext.projectType) {
+    parsed.projectContext.projectType = 'Unknown';
+  }
+
+  return parsed;
+}

package/src/ai/agents/index.ts

@@ -0,0 +1,147 @@
+/**
+ * Agents Index
+ * Exports all agent types and functions
+ */
+
+// Types
+export type {
+  CodebaseAnalysis,
+  StackResearch,
+  McpRecommendations,
+  MultiAgentAnalysis,
+  AgentCapabilities,
+  AgentOptions,
+  CodebaseAnalystInput,
+  StackResearcherInput,
+  OrchestratorInput,
+} from './types.js';
+
+// Agents
+export { runCodebaseAnalyst } from './codebase-analyst.js';
+export { runStackResearcher } from './stack-researcher.js';
+export { runOrchestrator, mergeAgentResults } from './orchestrator.js';
+
+// Re-export for convenience
+import type { LanguageModel } from 'ai';
+import type { ScanResult, DetectedStack } from '../../scanner/types.js';
+import type {
+  MultiAgentAnalysis,
+  AgentCapabilities,
+  AgentOptions,
+} from './types.js';
+import { runCodebaseAnalyst } from './codebase-analyst.js';
+import { runStackResearcher } from './stack-researcher.js';
+import { runOrchestrator, mergeAgentResults } from './orchestrator.js';
+import { logger } from '../../utils/logger.js';
+
+/**
+ * Run the full multi-agent analysis pipeline
+ */
+export async function runMultiAgentAnalysis(
+  model: LanguageModel,
+  modelId: string,
+  scanResult: ScanResult,
+  options: AgentOptions = {}
+): Promise<MultiAgentAnalysis | null> {
+  const { tavilyApiKey, context7ApiKey, verbose = false } = options;
+
+  // Determine capabilities
+  const capabilities: AgentCapabilities = {
+    hasTavily: !!tavilyApiKey,
+    hasContext7: !!context7ApiKey,
+  };
+
+  if (verbose) {
+    logger.info('Starting multi-agent analysis...');
+    logger.info(`Capabilities: Tavily=${capabilities.hasTavily}, Context7=${capabilities.hasContext7}`);
+  }
+
+  // Run Codebase Analyst
+  if (verbose) {
+    logger.info('Running Codebase Analyst...');
+  }
+
+  const codebaseAnalysis = await runCodebaseAnalyst(
+    model,
+    modelId,
+    {
+      scanResult,
+      projectRoot: scanResult.projectRoot,
+    },
+    verbose
+  );
+
+  if (!codebaseAnalysis) {
+    if (verbose) {
+      logger.warn('Codebase Analyst failed, using defaults');
+    }
+    return null;
+  }
+
+  // Run Stack Researcher
+  if (verbose) {
+    logger.info('Running Stack Researcher...');
+  }
+
+  const stackResearch = await runStackResearcher(
+    model,
+    modelId,
+    {
+      stack: scanResult.stack,
+      projectType: codebaseAnalysis.projectContext.projectType,
+      capabilities,
+    },
+    { tavilyApiKey, context7ApiKey },
+    verbose
+  );
+
+  if (!stackResearch) {
+    if (verbose) {
+      logger.warn('Stack Researcher failed, using defaults');
+    }
+    // Continue with defaults - stack research is optional
+  }
+
+  // Run Orchestrator to merge results
+  if (verbose) {
+    logger.info('Running Orchestrator...');
+  }
+
+  const mcpServers = await runOrchestrator(
+    model,
+    modelId,
+    {
+      codebaseAnalysis,
+      stackResearch: stackResearch || getDefaultStackResearch(),
+      stack: scanResult.stack,
+    },
+    verbose
+  );
+
+  // Merge all results
+  const finalResult = mergeAgentResults(
+    codebaseAnalysis,
+    stackResearch || getDefaultStackResearch(),
+    mcpServers
+  );
+
+  if (verbose) {
+    logger.info('Multi-agent analysis complete');
+  }
+
+  return finalResult;
+}
+
+/**
+ * Get default stack research when agent fails
+ */
+function getDefaultStackResearch() {
+  return {
+    bestPractices: ['Follow project conventions'],
+    antiPatterns: ['Avoid skipping tests'],
+    testingTools: ['npm test'],
+    debuggingTools: ['console.log'],
+    documentationHints: ['Check official docs'],
+    researchMode: 'knowledge-only' as const,
+  };
+}