erosolar-cli 2.0.4 → 2.1.1

package/dist/core/productTestHarness.js

@@ -0,0 +1,345 @@
+/**
+ * Comprehensive Product Test Harness
+ *
+ * This module provides extensive testing capabilities similar to human product testing,
+ * including runtime creation, execution, and validation of code.
+ */
+import { spawn } from 'node:child_process';
+import { writeFileSync, readFileSync, mkdirSync, existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+/**
+ * Product Test Harness - Comprehensive testing like a human QA engineer
+ */
+export class ProductTestHarness {
+    scenarios = [];
+    results = [];
+    /**
+     * Add a test scenario
+     */
+    addScenario(scenario) {
+        this.scenarios.push(scenario);
+    }
+    /**
+     * Add multiple scenarios
+     */
+    addScenarios(scenarios) {
+        this.scenarios.push(...scenarios);
+    }
+    /**
+     * Run all test scenarios
+     */
+    async runAll() {
+        this.results = [];
+        for (const scenario of this.scenarios) {
+            const result = await this.runScenario(scenario);
+            this.results.push(result);
+        }
+        const passed = this.results.filter(r => r.passed).length;
+        const failed = this.results.length - passed;
+        return {
+            passed,
+            failed,
+            total: this.results.length,
+            results: this.results,
+            summary: this.generateSummary(),
+        };
+    }
+    /**
+     * Run a single test scenario
+     */
+    async runScenario(scenario) {
+        const startTime = Date.now();
+        let result;
+        try {
+            // Setup
+            if (scenario.setup) {
+                await scenario.setup();
+            }
+            // Execute with timeout
+            const timeout = scenario.timeout ?? 30000; // 30s default
+            const executePromise = scenario.execute();
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('Test timeout exceeded')), timeout);
+            });
+            result = await Promise.race([executePromise, timeoutPromise]);
+        }
+        catch (error) {
+            result = {
+                scenario: scenario.name,
+                passed: false,
+                duration: Date.now() - startTime,
+                output: '',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        finally {
+            // Teardown
+            if (scenario.teardown) {
+                try {
+                    await scenario.teardown();
+                }
+                catch (error) {
+                    // Log teardown errors but don't fail the test
+                    console.error(`Teardown error for ${scenario.name}:`, error);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Generate test summary
+     */
+    generateSummary() {
+        const passed = this.results.filter(r => r.passed).length;
+        const failed = this.results.length - passed;
+        const totalDuration = this.results.reduce((sum, r) => sum + r.duration, 0);
+        let summary = `\n${'='.repeat(60)}\n`;
+        summary += `TEST SUMMARY\n`;
+        summary += `${'='.repeat(60)}\n`;
+        summary += `Total Tests: ${this.results.length}\n`;
+        summary += `Passed: ${passed} ✓\n`;
+        summary += `Failed: ${failed} ✗\n`;
+        summary += `Success Rate: ${((passed / this.results.length) * 100).toFixed(1)}%\n`;
+        summary += `Total Duration: ${totalDuration}ms\n`;
+        summary += `${'='.repeat(60)}\n`;
+        if (failed > 0) {
+            summary += `\nFailed Tests:\n`;
+            this.results.filter(r => !r.passed).forEach(r => {
+                summary += `  ✗ ${r.scenario}\n`;
+                if (r.error) {
+                    summary += `    Error: ${r.error}\n`;
+                }
+            });
+        }
+        return summary;
+    }
+    /**
+     * Clear all scenarios and results
+     */
+    clear() {
+        this.scenarios = [];
+        this.results = [];
+    }
+}
+/**
+ * Create an isolated runtime environment for testing
+ */
+export function createRuntimeEnvironment(id) {
+    const envId = id ?? `test_${Date.now()}_${Math.random().toString(36).substring(7)}`;
+    const workDir = join(tmpdir(), 'erosolar-test-env', envId);
+    // Create work directory
+    if (!existsSync(workDir)) {
+        mkdirSync(workDir, { recursive: true });
+    }
+    const env = {
+        workDir,
+        cleanup: () => {
+            try {
+                if (existsSync(workDir)) {
+                    rmSync(workDir, { recursive: true, force: true });
+                }
+            }
+            catch (error) {
+                console.error(`Failed to cleanup runtime environment ${envId}:`, error);
+            }
+        },
+        execute: async (code, language) => {
+            const startTime = Date.now();
+            // Prepare execution based on language
+            let command;
+            let args;
+            let scriptPath;
+            if (language === 'typescript') {
+                // For TypeScript, write to file and use ts-node
+                scriptPath = join(workDir, 'script.ts');
+                writeFileSync(scriptPath, code);
+                command = 'npx';
+                args = ['ts-node', scriptPath];
+            }
+            else if (language === 'node') {
+                scriptPath = join(workDir, 'script.js');
+                writeFileSync(scriptPath, code);
+                command = 'node';
+                args = [scriptPath];
+            }
+            else {
+                // bash
+                scriptPath = join(workDir, 'script.sh');
+                writeFileSync(scriptPath, code);
+                command = 'bash';
+                args = [scriptPath];
+            }
+            return new Promise((resolve) => {
+                let stdout = '';
+                let stderr = '';
+                const proc = spawn(command, args, {
+                    cwd: workDir,
+                    env: { ...process.env },
+                });
+                proc.stdout?.on('data', (data) => {
+                    stdout += data.toString();
+                });
+                proc.stderr?.on('data', (data) => {
+                    stderr += data.toString();
+                });
+                proc.on('error', (error) => {
+                    resolve({
+                        stdout,
+                        stderr,
+                        exitCode: 1,
+                        duration: Date.now() - startTime,
+                        error,
+                    });
+                });
+                proc.on('close', (exitCode) => {
+                    resolve({
+                        stdout,
+                        stderr,
+                        exitCode: exitCode ?? 0,
+                        duration: Date.now() - startTime,
+                    });
+                });
+            });
+        },
+        writeFile: (path, content) => {
+            const fullPath = join(workDir, path);
+            const dir = join(fullPath, '..');
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(fullPath, content);
+        },
+        readFile: (path) => {
+            const fullPath = join(workDir, path);
+            return readFileSync(fullPath, 'utf-8');
+        },
+        fileExists: (path) => {
+            const fullPath = join(workDir, path);
+            return existsSync(fullPath);
+        },
+    };
+    return env;
+}
+/**
+ * Common test scenarios generator
+ */
+export class TestScenarioGenerator {
+    /**
+     * Generate basic functionality tests
+     */
+    static generateBasicTests(functionName, testCases) {
+        return testCases.map((testCase, index) => ({
+            name: `${functionName}_test_${index + 1}`,
+            description: testCase.description,
+            execute: async () => {
+                const passed = testCase.input === testCase.expected;
+                return {
+                    scenario: testCase.description,
+                    passed,
+                    duration: 0,
+                    output: `Expected: ${testCase.expected}, Got: ${testCase.input}`,
+                    metrics: {
+                        assertions: [{
+                                name: 'equality_check',
+                                passed,
+                                expected: testCase.expected,
+                                actual: testCase.input,
+                            }],
+                    },
+                };
+            },
+        }));
+    }
+    /**
+     * Generate edge case tests
+     */
+    static generateEdgeCaseTests(functionCode) {
+        const scenarios = [];
+        // Test with null/undefined
+        scenarios.push({
+            name: 'null_input_test',
+            description: 'Test function behavior with null input',
+            execute: async () => {
+                const env = createRuntimeEnvironment();
+                try {
+                    const testCode = `
+            ${functionCode}
+            const result = testFunction(null);
+            console.log(JSON.stringify(result));
+          `;
+                    const result = await env.execute(testCode, 'node');
+                    return {
+                        scenario: 'null_input_test',
+                        passed: result.exitCode === 0,
+                        duration: result.duration,
+                        output: result.stdout,
+                        error: result.stderr,
+                    };
+                }
+                finally {
+                    env.cleanup();
+                }
+            },
+        });
+        // Test with empty values
+        scenarios.push({
+            name: 'empty_input_test',
+            description: 'Test function behavior with empty input',
+            execute: async () => {
+                const env = createRuntimeEnvironment();
+                try {
+                    const testCode = `
+            ${functionCode}
+            const result = testFunction('');
+            console.log(JSON.stringify(result));
+          `;
+                    const result = await env.execute(testCode, 'node');
+                    return {
+                        scenario: 'empty_input_test',
+                        passed: result.exitCode === 0,
+                        duration: result.duration,
+                        output: result.stdout,
+                        error: result.stderr,
+                    };
+                }
+                finally {
+                    env.cleanup();
+                }
+            },
+        });
+        return scenarios;
+    }
+    /**
+     * Generate performance tests
+     */
+    static generatePerformanceTest(name, code, maxDurationMs) {
+        return {
+            name: `${name}_performance`,
+            description: `Performance test: should complete within ${maxDurationMs}ms`,
+            execute: async () => {
+                const env = createRuntimeEnvironment();
+                try {
+                    const result = await env.execute(code, 'node');
+                    const passed = result.duration < maxDurationMs && result.exitCode === 0;
+                    return {
+                        scenario: `${name}_performance`,
+                        passed,
+                        duration: result.duration,
+                        output: result.stdout,
+                        error: passed ? undefined : `Exceeded ${maxDurationMs}ms (took ${result.duration}ms)`,
+                        metrics: {
+                            cpuTime: result.duration,
+                            exitCode: result.exitCode,
+                        },
+                    };
+                }
+                finally {
+                    env.cleanup();
+                }
+            },
+            timeout: maxDurationMs * 2,
+        };
+    }
+}
+//# sourceMappingURL=productTestHarness.js.map

package/dist/core/productTestHarness.js.map

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

package/dist/core/toolPatternAnalyzer.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Tool Execution Pattern Analyzer
+ *
+ * Analyzes tool usage patterns to help the AI learn optimal workflows.
+ * Critical for Claude Code to operate efficiently without wasting context
+ * on redundant operations.
+ */
+export interface ToolCall {
+    name: string;
+    args: Record<string, unknown>;
+    timestamp: number;
+    duration?: number;
+    success: boolean;
+}
+export interface Pattern {
+    id: string;
+    description: string;
+    sequence: string[];
+    frequency: number;
+    avgDuration: number;
+    successRate: number;
+    examples: ToolCall[][];
+}
+export interface Inefficiency {
+    type: 'redundant' | 'inefficient_order' | 'missing_step' | 'wrong_tool';
+    description: string;
+    suggestion: string;
+    severity: 'low' | 'medium' | 'high';
+    affectedCalls: string[];
+}
+/**
+ * Analyzes tool execution patterns and suggests optimizations
+ */
+export declare class ToolPatternAnalyzer {
+    private callHistory;
+    private readonly maxHistory;
+    private detectedPatterns;
+    /**
+     * Record a tool call
+     */
+    recordCall(call: ToolCall): void;
+    /**
+     * Get recent tool calls
+     */
+    getRecentCalls(count?: number): ToolCall[];
+    /**
+     * Detect inefficiencies in recent tool usage
+     */
+    detectInefficiencies(lookback?: number): Inefficiency[];
+    /**
+     * Detect redundant file reads
+     */
+    private detectRedundantReads;
+    /**
+     * Detect missing validation after edits
+     */
+    private detectMissingValidation;
+    /**
+     * Detect inefficient search patterns
+     */
+    private detectInefficientSearches;
+    /**
+     * Detect wrong tool choices
+     */
+    private detectWrongToolChoices;
+    /**
+     * Update detected patterns from call history
+     */
+    private updatePatterns;
+    /**
+     * Get detected patterns sorted by frequency
+     */
+    getPatterns(): Pattern[];
+    /**
+     * Generate workflow suggestions based on patterns
+     */
+    generateSuggestions(): string[];
+    /**
+     * Clear all history and patterns
+     */
+    clear(): void;
+}
+/**
+ * Global singleton instance
+ */
+export declare const toolPatternAnalyzer: ToolPatternAnalyzer;
+//# sourceMappingURL=toolPatternAnalyzer.d.ts.map

package/dist/core/toolPatternAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolPatternAnalyzer.d.ts","sourceRoot":"","sources":["../../src/core/toolPatternAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,GAAG,mBAAmB,GAAG,cAAc,GAAG,YAAY,CAAC;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAClC,OAAO,CAAC,gBAAgB,CAAmC;IAE3D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAYhC;;OAEG;IACH,cAAc,CAAC,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAI9C;;OAEG;IACH,oBAAoB,CAAC,QAAQ,GAAE,MAAW,GAAG,YAAY,EAAE;IAmB3D;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6C/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAwCjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAKxB;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAuB/B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}