wiggum-cli 0.1.0

package/dist/ai/enhancer.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Module
+ * Main export for AI-enhanced analysis functionality
+ */
+export { type AIProvider, type ProviderConfig, getModel, hasApiKey, getAvailableProvider, getApiKeyEnvVar, } from './providers.js';
+export { formatStackForPrompt, SYSTEM_PROMPT, createAnalysisPrompt, createValidationPrompt, createRecommendationsPrompt, } from './prompts.js';
+export { type FrameworkInsights, type ArchitecturalPattern, type CodingConvention, type McpRecommendation, type AdditionalDetections, type AIAnalysisResult, type EnhancedScanResult, type EnhancerOptions, AIEnhancer, enhanceWithAI, formatAIAnalysis, } from './enhancer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,QAAQ,EACR,SAAS,EACT,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,11 @@
+/**
+ * AI Module
+ * Main export for AI-enhanced analysis functionality
+ */
+// Provider configuration
+export { getModel, hasApiKey, getAvailableProvider, getApiKeyEnvVar, } from './providers.js';
+// Analysis prompts
+export { formatStackForPrompt, SYSTEM_PROMPT, createAnalysisPrompt, createValidationPrompt, createRecommendationsPrompt, } from './prompts.js';
+// AI enhancer
+export { AIEnhancer, enhanceWithAI, formatAIAnalysis, } from './enhancer.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yBAAyB;AACzB,OAAO,EAGL,QAAQ,EACR,SAAS,EACT,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,mBAAmB;AACnB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,cAAc;AACd,OAAO,EASL,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/ai/prompts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AI Analysis Prompts
+ * Defines prompts for codebase analysis and enhancement
+ */
+import type { ScanResult, DetectedStack } from '../scanner/types.js';
+/**
+ * Format the detected stack for inclusion in prompts
+ */
+export declare function formatStackForPrompt(stack: DetectedStack): string;
+/**
+ * System prompt for codebase analysis
+ */
+export declare const SYSTEM_PROMPT = "You are an expert software architect analyzing a codebase to provide insights for AI-assisted development.\n\nYour role is to:\n1. Analyze the detected tech stack and provide deeper insights\n2. Identify architectural patterns and coding conventions\n3. Suggest improvements to the detection results\n4. Recommend MCP servers that would benefit this project\n5. Generate custom prompt suggestions for AI coding assistants\n\nBe concise and actionable. Focus on practical insights that help developers work more effectively with AI tools.\n\nRespond in valid JSON format only.";
+/**
+ * Create the codebase analysis prompt
+ */
+export declare function createAnalysisPrompt(scanResult: ScanResult): string;
+/**
+ * Prompt for validating and improving scanner results
+ */
+export declare function createValidationPrompt(scanResult: ScanResult): string;
+/**
+ * Prompt for generating stack-specific recommendations
+ */
+export declare function createRecommendationsPrompt(scanResult: ScanResult): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ai/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAErE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA4EjE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,okBAWS,CAAC;AAEpC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA8CnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA2BrE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA0B1E"}

package/dist/ai/prompts.js

@@ -0,0 +1,201 @@
+/**
+ * AI Analysis Prompts
+ * Defines prompts for codebase analysis and enhancement
+ */
+/**
+ * Format the detected stack for inclusion in prompts
+ */
+export function formatStackForPrompt(stack) {
+    const sections = [];
+    // Core
+    if (stack.framework) {
+        const variant = stack.framework.variant ? ` (${stack.framework.variant})` : '';
+        sections.push(`Framework: ${stack.framework.name}${variant}`);
+    }
+    if (stack.packageManager) {
+        sections.push(`Package Manager: ${stack.packageManager.name}`);
+    }
+    if (stack.testing?.unit) {
+        sections.push(`Unit Testing: ${stack.testing.unit.name}`);
+    }
+    if (stack.testing?.e2e) {
+        sections.push(`E2E Testing: ${stack.testing.e2e.name}`);
+    }
+    if (stack.styling) {
+        sections.push(`Styling: ${stack.styling.name}`);
+    }
+    // Data Layer
+    if (stack.database) {
+        sections.push(`Database: ${stack.database.name}`);
+    }
+    if (stack.orm) {
+        sections.push(`ORM: ${stack.orm.name}`);
+    }
+    if (stack.api && stack.api.length > 0) {
+        sections.push(`API Patterns: ${stack.api.map(a => a.name).join(', ')}`);
+    }
+    // Frontend
+    if (stack.stateManagement) {
+        sections.push(`State Management: ${stack.stateManagement.name}`);
+    }
+    if (stack.uiComponents && stack.uiComponents.length > 0) {
+        sections.push(`UI Components: ${stack.uiComponents.map(u => u.name).join(', ')}`);
+    }
+    if (stack.formHandling && stack.formHandling.length > 0) {
+        sections.push(`Form Handling: ${stack.formHandling.map(f => f.name).join(', ')}`);
+    }
+    // Services
+    if (stack.auth) {
+        sections.push(`Auth: ${stack.auth.name}`);
+    }
+    if (stack.analytics && stack.analytics.length > 0) {
+        sections.push(`Analytics: ${stack.analytics.map(a => a.name).join(', ')}`);
+    }
+    if (stack.payments) {
+        sections.push(`Payments: ${stack.payments.name}`);
+    }
+    if (stack.email) {
+        sections.push(`Email: ${stack.email.name}`);
+    }
+    // Infrastructure
+    if (stack.deployment && stack.deployment.length > 0) {
+        sections.push(`Deployment: ${stack.deployment.map(d => d.name).join(', ')}`);
+    }
+    if (stack.monorepo) {
+        sections.push(`Monorepo: ${stack.monorepo.name}`);
+    }
+    // MCP
+    if (stack.mcp) {
+        if (stack.mcp.isProject) {
+            sections.push('MCP: This is an MCP server project');
+        }
+        if (stack.mcp.detected && stack.mcp.detected.length > 0) {
+            sections.push(`MCP Servers: ${stack.mcp.detected.map(m => m.name).join(', ')}`);
+        }
+    }
+    return sections.join('\n');
+}
+/**
+ * System prompt for codebase analysis
+ */
+export const SYSTEM_PROMPT = `You are an expert software architect analyzing a codebase to provide insights for AI-assisted development.
+
+Your role is to:
+1. Analyze the detected tech stack and provide deeper insights
+2. Identify architectural patterns and coding conventions
+3. Suggest improvements to the detection results
+4. Recommend MCP servers that would benefit this project
+5. Generate custom prompt suggestions for AI coding assistants
+
+Be concise and actionable. Focus on practical insights that help developers work more effectively with AI tools.
+
+Respond in valid JSON format only.`;
+/**
+ * Create the codebase analysis prompt
+ */
+export function createAnalysisPrompt(scanResult) {
+    const stackInfo = formatStackForPrompt(scanResult.stack);
+    return `Analyze this codebase and provide enhanced insights.
+
+Project Root: ${scanResult.projectRoot}
+
+Detected Stack:
+${stackInfo || 'No technologies detected'}
+
+Based on this stack, provide analysis in the following JSON format:
+{
+  "frameworkInsights": {
+    "variant": "more specific variant if detectable (e.g., 'app-router', 'pages-router', 'spa', 'ssr')",
+    "confidence": "high/medium/low",
+    "notes": "any additional observations about framework usage"
+  },
+  "architecturalPatterns": [
+    {
+      "pattern": "pattern name",
+      "confidence": "high/medium/low",
+      "evidence": "why you think this pattern is used"
+    }
+  ],
+  "codingConventions": [
+    {
+      "convention": "convention name",
+      "suggestion": "how to follow this convention"
+    }
+  ],
+  "recommendedMcpServers": [
+    {
+      "name": "server name",
+      "reason": "why this would be useful"
+    }
+  ],
+  "customPromptSuggestions": [
+    "Specific prompt suggestions tailored to this codebase"
+  ],
+  "additionalDetections": {
+    "possibleMissed": ["technologies that might be in use but weren't detected"],
+    "refinements": ["suggestions to improve existing detections"]
+  }
+}
+
+Only include sections where you have meaningful insights. Keep responses focused and actionable.`;
+}
+/**
+ * Prompt for validating and improving scanner results
+ */
+export function createValidationPrompt(scanResult) {
+    const stackInfo = formatStackForPrompt(scanResult.stack);
+    return `Review and validate these scanner detection results for accuracy.
+
+Detected Stack:
+${stackInfo || 'No technologies detected'}
+
+For each detection, assess if it seems accurate based on common project patterns.
+Identify any likely false positives or missing detections.
+
+Respond in JSON format:
+{
+  "validations": [
+    {
+      "technology": "name",
+      "status": "confirmed/uncertain/likely-false-positive",
+      "notes": "explanation if uncertain or false positive"
+    }
+  ],
+  "likelyMissed": [
+    {
+      "technology": "name",
+      "reason": "why this might be in use"
+    }
+  ]
+}`;
+}
+/**
+ * Prompt for generating stack-specific recommendations
+ */
+export function createRecommendationsPrompt(scanResult) {
+    const stackInfo = formatStackForPrompt(scanResult.stack);
+    return `Based on this tech stack, provide specific recommendations for AI-assisted development.
+
+Detected Stack:
+${stackInfo || 'No technologies detected'}
+
+Provide recommendations in JSON format:
+{
+  "mcpServers": [
+    {
+      "name": "server identifier",
+      "priority": "high/medium/low",
+      "reason": "why this is recommended"
+    }
+  ],
+  "aiToolingTips": [
+    "Tips for working with AI tools on this codebase"
+  ],
+  "contextSuggestions": [
+    "Important context an AI should know about this stack"
+  ]
+}
+
+Focus on practical, actionable recommendations.`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

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

package/dist/ai/providers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AI Provider Configuration
+ * Configures AI providers (Anthropic, OpenAI, OpenRouter) for the enhancer
+ */
+import type { LanguageModel } from 'ai';
+/**
+ * Supported AI providers
+ */
+export type AIProvider = 'anthropic' | 'openai' | 'openrouter';
+/**
+ * Provider configuration result
+ */
+export interface ProviderConfig {
+    model: LanguageModel;
+    provider: AIProvider;
+    modelId: string;
+}
+/**
+ * Check if an API key is available for a provider
+ */
+export declare function hasApiKey(provider: AIProvider): boolean;
+/**
+ * Get a configured AI model for the specified provider
+ */
+export declare function getModel(provider?: AIProvider): ProviderConfig;
+/**
+ * Get the first available provider with an API key
+ * Checks in order: anthropic, openai, openrouter
+ */
+export declare function getAvailableProvider(): AIProvider | null;
+/**
+ * Get the environment variable name for a provider's API key
+ */
+export declare function getApiKeyEnvVar(provider: AIProvider): string;
+//# sourceMappingURL=providers.d.ts.map

package/dist/ai/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/ai/providers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAGvD;AAmBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,GAAE,UAAwB,GAAG,cAAc,CA0C3E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,GAAG,IAAI,CAUxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAE5D"}

package/dist/ai/providers.js

@@ -0,0 +1,104 @@
+/**
+ * AI Provider Configuration
+ * Configures AI providers (Anthropic, OpenAI, OpenRouter) for the enhancer
+ */
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createOpenAI } from '@ai-sdk/openai';
+/**
+ * Environment variable names for each provider
+ */
+const API_KEY_ENV_VARS = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    openrouter: 'OPENROUTER_API_KEY',
+};
+/**
+ * Default models for each provider
+ * Using fast/cost-effective models for speed
+ */
+const DEFAULT_MODELS = {
+    anthropic: 'claude-sonnet-4-20250514',
+    openai: 'gpt-4o-mini',
+    openrouter: 'anthropic/claude-3.5-sonnet',
+};
+/**
+ * Check if an API key is available for a provider
+ */
+export function hasApiKey(provider) {
+    const envVar = API_KEY_ENV_VARS[provider];
+    return !!process.env[envVar];
+}
+/**
+ * Get the API key for a provider
+ * @throws Error if API key is not set
+ */
+function getApiKey(provider) {
+    const envVar = API_KEY_ENV_VARS[provider];
+    const apiKey = process.env[envVar];
+    if (!apiKey) {
+        throw new Error(`API key not found. Set ${envVar} environment variable to use ${provider} provider.`);
+    }
+    return apiKey;
+}
+/**
+ * Get a configured AI model for the specified provider
+ */
+export function getModel(provider = 'anthropic') {
+    const modelId = DEFAULT_MODELS[provider];
+    switch (provider) {
+        case 'anthropic': {
+            const anthropic = createAnthropic({
+                apiKey: getApiKey('anthropic'),
+            });
+            return {
+                model: anthropic(modelId),
+                provider,
+                modelId,
+            };
+        }
+        case 'openai': {
+            const openai = createOpenAI({
+                apiKey: getApiKey('openai'),
+            });
+            return {
+                model: openai(modelId),
+                provider,
+                modelId,
+            };
+        }
+        case 'openrouter': {
+            // OpenRouter uses OpenAI-compatible API
+            const openrouter = createOpenAI({
+                apiKey: getApiKey('openrouter'),
+                baseURL: 'https://openrouter.ai/api/v1',
+            });
+            return {
+                model: openrouter(modelId),
+                provider,
+                modelId,
+            };
+        }
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+/**
+ * Get the first available provider with an API key
+ * Checks in order: anthropic, openai, openrouter
+ */
+export function getAvailableProvider() {
+    const providers = ['anthropic', 'openai', 'openrouter'];
+    for (const provider of providers) {
+        if (hasApiKey(provider)) {
+            return provider;
+        }
+    }
+    return null;
+}
+/**
+ * Get the environment variable name for a provider's API key
+ */
+export function getApiKeyEnvVar(provider) {
+    return API_KEY_ENV_VARS[provider];
+}
+//# sourceMappingURL=providers.js.map

package/dist/ai/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/ai/providers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAiB9C;;GAEG;AACH,MAAM,gBAAgB,GAA+B;IACnD,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE,gBAAgB;IACxB,UAAU,EAAE,oBAAoB;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,cAAc,GAA+B;IACjD,SAAS,EAAE,0BAA0B;IACrC,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,6BAA6B;CAC1C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAoB;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,QAAoB;IACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,gCAAgC,QAAQ,YAAY,CACrF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAuB,WAAW;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEzC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,SAAS,GAAG,eAAe,CAAC;gBAChC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC;aAC/B,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;gBACzB,QAAQ;gBACR,OAAO;aACR,CAAC;QACJ,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,YAAY,CAAC;gBAC1B,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC;aAC5B,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;gBACtB,QAAQ;gBACR,OAAO;aACR,CAAC;QACJ,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,wCAAwC;YACxC,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC9B,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC;gBAC/B,OAAO,EAAE,8BAA8B;aACxC,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC1B,QAAQ;gBACR,OAAO;aACR,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEtE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAoB;IAClD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * Set up and configure the CLI
+ */
+export declare function createCli(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAoOnC"}

package/dist/cli.js

@@ -0,0 +1,196 @@
+import { Command } from 'commander';
+import { displayHeader } from './utils/header.js';
+import { initCommand } from './commands/init.js';
+import { runCommand } from './commands/run.js';
+import { monitorCommand } from './commands/monitor.js';
+import { newCommand } from './commands/new.js';
+import { logger } from './utils/logger.js';
+/**
+ * Set up and configure the CLI
+ */
+export function createCli() {
+    const program = new Command();
+    program
+        .name('ralph')
+        .description('AI-powered feature development loop CLI.\n\n' +
+        'Ralph auto-detects your tech stack and generates an intelligent\n' +
+        'development environment for AI-driven feature implementation.')
+        .version('0.1.0')
+        .hook('preAction', () => {
+        displayHeader();
+    })
+        .addHelpText('after', `
+Examples:
+  $ ralph init                    Initialize Ralph in your project
+  $ ralph init --ai               Initialize with AI-enhanced analysis
+  $ ralph new my-feature          Create a new feature specification
+  $ ralph run my-feature          Run the feature development loop
+  $ ralph monitor my-feature      Monitor progress in real-time
+
+Documentation:
+  https://github.com/your-org/ralph-cli#readme
+`);
+    // ralph init
+    program
+        .command('init')
+        .description('Initialize Ralph in the current project.\n\n' +
+        'Scans your codebase to detect the tech stack (framework, testing,\n' +
+        'database, auth, etc.) and generates configuration files in .ralph/')
+        .option('--ai', 'Enable AI-enhanced analysis for deeper project insights')
+        .option('--provider <name>', 'AI provider to use (anthropic, openai, openrouter)', 'anthropic')
+        .option('-y, --yes', 'Accept defaults and skip all confirmation prompts')
+        .addHelpText('after', `
+Examples:
+  $ ralph init                           Basic initialization
+  $ ralph init --ai                      With AI-enhanced analysis (Anthropic)
+  $ ralph init --ai --provider openai    With OpenAI provider
+  $ ralph init --yes                     Non-interactive mode
+
+Environment Variables:
+  ANTHROPIC_API_KEY    Required for --ai with anthropic provider
+  OPENAI_API_KEY       Required for --ai with openai provider
+  OPENROUTER_API_KEY   Required for --ai with openrouter provider
+`)
+        .action(async (options) => {
+        try {
+            await initCommand(options);
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+    // ralph run <feature>
+    program
+        .command('run <feature>')
+        .description('Run the feature development loop for a specific feature.\n\n' +
+        'Executes the AI-driven implementation workflow using the feature\n' +
+        'spec in .ralph/specs/<feature>.md')
+        .option('--worktree', 'Use git worktree for isolation (enables parallel execution of multiple features)')
+        .option('--resume', 'Resume an interrupted loop (reuses existing branch and worktree)')
+        .option('--model <model>', 'Claude model to use for implementation (opus, sonnet)')
+        .option('--max-iterations <n>', 'Maximum number of implementation iterations (default: 50)', parseInt)
+        .option('--max-e2e-attempts <n>', 'Maximum E2E test retry attempts before giving up (default: 3)', parseInt)
+        .addHelpText('after', `
+Examples:
+  $ ralph run user-auth                     Run the user-auth feature
+  $ ralph run payment --worktree            Run in isolated worktree
+  $ ralph run payment --resume              Resume interrupted session
+  $ ralph run my-feature --model opus       Use Claude Opus model
+  $ ralph run my-feature --max-iterations 30 --max-e2e-attempts 5
+
+Notes:
+  - Create a feature spec first with: ralph new <feature>
+  - The spec file should be at: .ralph/specs/<feature>.md
+  - Use --worktree to run multiple features in parallel
+`)
+        .action(async (feature, options) => {
+        try {
+            const runOptions = {
+                worktree: options.worktree,
+                resume: options.resume,
+                model: options.model,
+                maxIterations: options.maxIterations,
+                maxE2eAttempts: options.maxE2eAttempts,
+            };
+            await runCommand(feature, runOptions);
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+    // ralph monitor <feature>
+    program
+        .command('monitor <feature>')
+        .description('Launch the monitoring dashboard for a feature.\n\n' +
+        'Displays real-time progress including iteration count, phase,\n' +
+        'task completion, token usage, and E2E test status.')
+        .option('--bash', 'Use the bash script monitor instead of the built-in dashboard')
+        .option('--python', 'Use the Python TUI monitor (if available)')
+        .option('--interval <seconds>', 'Dashboard refresh interval in seconds (default: 5)', parseInt, 5)
+        .addHelpText('after', `
+Examples:
+  $ ralph monitor my-feature              Monitor with built-in dashboard
+  $ ralph monitor my-feature --interval 2 Refresh every 2 seconds
+  $ ralph monitor my-feature --bash       Use bash script monitor
+
+Dashboard Shows:
+  - Current phase (Planning, Implementation, E2E Testing, etc.)
+  - Iteration progress
+  - Task completion status
+  - Token usage (input/output)
+  - Git branch information
+`)
+        .action(async (feature, options) => {
+        try {
+            const monitorOptions = {
+                bash: options.bash,
+                python: options.python,
+                interval: options.interval,
+            };
+            await monitorCommand(feature, monitorOptions);
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+    // ralph new <feature>
+    program
+        .command('new <feature>')
+        .description('Create a new feature specification from template.\n\n' +
+        'Generates a markdown spec file with sections for requirements,\n' +
+        'acceptance criteria, technical notes, and more.')
+        .option('-e, --edit', 'Open the spec in your editor after creation')
+        .option('--editor <editor>', 'Editor command to use (defaults to $EDITOR or "code")')
+        .option('-y, --yes', 'Skip confirmation prompts')
+        .option('-f, --force', 'Overwrite existing spec file without prompting')
+        .addHelpText('after', `
+Examples:
+  $ ralph new user-dashboard              Create spec with prompts
+  $ ralph new user-dashboard --edit       Create and open in editor
+  $ ralph new user-dashboard -e --editor vim  Open in vim
+  $ ralph new user-dashboard --yes        Skip confirmations
+  $ ralph new user-dashboard --force      Overwrite if exists
+
+Output:
+  Creates: .ralph/specs/<feature>.md
+
+Template includes sections for:
+  - Purpose and user stories
+  - Functional and non-functional requirements
+  - Technical notes and dependencies
+  - Visual requirements (for UI features)
+  - API endpoints
+  - Acceptance criteria
+`)
+        .action(async (feature, options) => {
+        try {
+            const newOptions = {
+                edit: options.edit,
+                editor: options.editor,
+                yes: options.yes,
+                force: options.force,
+            };
+            await newCommand(feature, newOptions);
+        }
+        catch (error) {
+            handleCommandError(error);
+        }
+    });
+    return program;
+}
+/**
+ * Handle command errors with user-friendly output
+ */
+function handleCommandError(error) {
+    if (error instanceof Error) {
+        logger.error(error.message);
+        if (process.env.DEBUG) {
+            console.error(error.stack);
+        }
+    }
+    else {
+        logger.error(String(error));
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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