@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/core/testFailureMonitor.js

@@ -0,0 +1,262 @@
+/**
+ * Test Failure Monitor - Real-time monitoring of test output for early abort
+ *
+ * Detects test failures as they stream and can trigger early abort to allow
+ * the AI to pivot and replan instead of waiting for a broken test suite to finish.
+ */
+const DEFAULT_CONFIG = {
+    failureThreshold: 3,
+    abortOnCompileError: true,
+    minRunTime: 5000,
+    maxConsecutiveFailures: 2,
+};
+// Patterns for detecting various test runner outputs
+const TEST_PATTERNS = {
+    // Jest patterns
+    jestFail: /FAIL\s+(.+\.(?:test|spec)\.[jt]sx?)/,
+    jestPass: /PASS\s+(.+\.(?:test|spec)\.[jt]sx?)/,
+    jestTestFail: /✕\s+(.+)/,
+    jestTestPass: /✓\s+(.+)/,
+    jestSummaryFail: /Tests:\s+(\d+)\s+failed/,
+    // Vitest patterns
+    vitestFail: /❌\s+(.+)/,
+    vitestPass: /✓\s+(.+)/,
+    // Mocha patterns
+    mochaFail: /\d+\)\s+(.+)/,
+    mochaPass: /✔\s+(.+)/,
+    // Generic test patterns
+    genericFail: /(?:FAILED|FAILURE|ERROR)[\s:]+(.+)/i,
+    assertionFail: /(?:AssertionError|Expected|assert)/i,
+    // Compilation/Build errors (should abort immediately)
+    compileError: /(?:SyntaxError|TypeError|ReferenceError|Cannot find module|Module not found|error TS\d+)/i,
+    buildFail: /(?:Build failed|Compilation failed|Failed to compile)/i,
+    // Test suite crash
+    suiteCrash: /(?:Test suite failed to run|Could not find|Cannot read|Unhandled promise rejection)/i,
+};
+export class TestFailureMonitor {
+    config;
+    state;
+    startTime;
+    recentLines = [];
+    MAX_RECENT_LINES = 50;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.state = this.createInitialState();
+        this.startTime = Date.now();
+    }
+    createInitialState() {
+        return {
+            failedTests: [],
+            passedTests: 0,
+            totalTests: 0,
+            hasCompileError: false,
+            consecutiveFailures: 0,
+            shouldAbort: false,
+            abortReason: null,
+            suggestions: [],
+        };
+    }
+    /**
+     * Process a line of test output in real-time
+     * Returns true if we should abort
+     */
+    processLine(line) {
+        // Track recent lines for context
+        this.recentLines.push(line);
+        if (this.recentLines.length > this.MAX_RECENT_LINES) {
+            this.recentLines.shift();
+        }
+        // Check for compile/build errors first (highest priority)
+        if (TEST_PATTERNS.compileError.test(line) || TEST_PATTERNS.buildFail.test(line)) {
+            this.state.hasCompileError = true;
+            if (this.config.abortOnCompileError) {
+                this.state.shouldAbort = true;
+                this.state.abortReason = 'Compilation/build error detected';
+                this.state.suggestions = [
+                    'Fix the compilation error before running tests',
+                    'Check for syntax errors or missing imports',
+                    'Run the build separately to see full error output',
+                ];
+                return true;
+            }
+        }
+        // Check for test suite crash
+        if (TEST_PATTERNS.suiteCrash.test(line)) {
+            this.state.shouldAbort = true;
+            this.state.abortReason = 'Test suite crashed before tests could run';
+            this.state.suggestions = [
+                'Check test configuration and setup files',
+                'Verify all test dependencies are installed',
+                'Look for initialization errors in beforeAll/beforeEach hooks',
+            ];
+            return true;
+        }
+        // Check for test file failures (Jest/Vitest)
+        const failMatch = line.match(TEST_PATTERNS.jestFail);
+        if (failMatch) {
+            const testFile = failMatch[1];
+            if (testFile && !this.state.failedTests.includes(testFile)) {
+                this.state.failedTests.push(testFile);
+                this.state.consecutiveFailures++;
+                this.state.totalTests++;
+            }
+        }
+        // Check for individual test failures
+        if (TEST_PATTERNS.jestTestFail.test(line) ||
+            TEST_PATTERNS.vitestFail.test(line) ||
+            TEST_PATTERNS.assertionFail.test(line)) {
+            this.state.consecutiveFailures++;
+        }
+        // Check for passing tests (reset consecutive failures)
+        if (TEST_PATTERNS.jestPass.test(line) ||
+            TEST_PATTERNS.jestTestPass.test(line) ||
+            TEST_PATTERNS.vitestPass.test(line) ||
+            TEST_PATTERNS.mochaPass.test(line)) {
+            this.state.passedTests++;
+            this.state.totalTests++;
+            this.state.consecutiveFailures = 0; // Reset on pass
+        }
+        // Check abort conditions
+        return this.checkAbortConditions();
+    }
+    checkAbortConditions() {
+        const elapsed = Date.now() - this.startTime;
+        // Don't abort too early - let some tests run first
+        if (elapsed < this.config.minRunTime) {
+            return false;
+        }
+        // Check failure threshold
+        if (this.state.failedTests.length >= this.config.failureThreshold) {
+            this.state.shouldAbort = true;
+            this.state.abortReason = `${this.state.failedTests.length} test files have failed`;
+            this.state.suggestions = this.generateSuggestions();
+            return true;
+        }
+        // Check consecutive failures
+        if (this.state.consecutiveFailures >= this.config.maxConsecutiveFailures) {
+            // Only abort if we've seen some test activity
+            if (this.state.totalTests > 0) {
+                this.state.shouldAbort = true;
+                this.state.abortReason = `${this.state.consecutiveFailures} consecutive test failures detected`;
+                this.state.suggestions = this.generateSuggestions();
+                return true;
+            }
+        }
+        return false;
+    }
+    generateSuggestions() {
+        const suggestions = [];
+        if (this.state.failedTests.length > 0) {
+            suggestions.push(`Focus on fixing the first failing test: ${this.state.failedTests[0]}`);
+            suggestions.push('Run the specific failing test in isolation to see full output');
+        }
+        if (this.state.hasCompileError) {
+            suggestions.push('Fix compilation errors before running the full test suite');
+        }
+        if (this.state.consecutiveFailures > 2) {
+            suggestions.push('Multiple consecutive failures suggest a common root cause');
+            suggestions.push('Check recent changes that might affect multiple tests');
+        }
+        suggestions.push('Consider running tests incrementally as you fix each issue');
+        return suggestions;
+    }
+    /**
+     * Get the current monitoring state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get recent output lines for context
+     */
+    getRecentOutput() {
+        return this.recentLines.join('\n');
+    }
+    /**
+     * Format abort message for AI consumption
+     */
+    formatAbortMessage() {
+        if (!this.state.shouldAbort) {
+            return '';
+        }
+        const lines = [
+            '',
+            '═══ EARLY ABORT - REPLAN RECOMMENDED ═══',
+            '',
+            `Reason: ${this.state.abortReason}`,
+            '',
+            'Test Status:',
+            `  • Failed test files: ${this.state.failedTests.length}`,
+            `  • Passed tests: ${this.state.passedTests}`,
+            `  • Has compile error: ${this.state.hasCompileError ? 'YES' : 'no'}`,
+            '',
+        ];
+        if (this.state.failedTests.length > 0) {
+            lines.push('Failed test files:');
+            for (const test of this.state.failedTests.slice(0, 5)) {
+                lines.push(`  ✗ ${test}`);
+            }
+            if (this.state.failedTests.length > 5) {
+                lines.push(`  ... and ${this.state.failedTests.length - 5} more`);
+            }
+            lines.push('');
+        }
+        lines.push('Suggested Actions:');
+        for (const suggestion of this.state.suggestions) {
+            lines.push(`  → ${suggestion}`);
+        }
+        lines.push('');
+        lines.push('The test run was aborted early to save time. Please replan your approach.');
+        return lines.join('\n');
+    }
+    /**
+     * Reset the monitor for a new test run
+     */
+    reset() {
+        this.state = this.createInitialState();
+        this.startTime = Date.now();
+        this.recentLines = [];
+    }
+}
+/**
+ * Detect if a command is likely a test command
+ */
+export function isTestCommand(command) {
+    const cmd = command.toLowerCase();
+    return (cmd.includes('npm test') ||
+        cmd.includes('npm run test') ||
+        cmd.includes('yarn test') ||
+        cmd.includes('pnpm test') ||
+        cmd.includes('jest') ||
+        cmd.includes('vitest') ||
+        cmd.includes('mocha') ||
+        cmd.includes('ava') ||
+        cmd.includes('tap') ||
+        cmd.includes('pytest') ||
+        cmd.includes('go test') ||
+        cmd.includes('cargo test') ||
+        cmd.includes('rspec') ||
+        /\btest\b/.test(cmd));
+}
+/**
+ * Create a test monitor with sensible defaults based on command
+ */
+export function createTestMonitor(command) {
+    if (!isTestCommand(command)) {
+        return null;
+    }
+    // Adjust config based on command type
+    const config = {};
+    // For watch mode, be more lenient
+    if (command.includes('--watch') || command.includes('-w')) {
+        config.failureThreshold = 5;
+        config.minRunTime = 10000;
+    }
+    // For CI-like commands, be more aggressive about early abort
+    if (command.includes('--ci') || command.includes('--coverage')) {
+        config.failureThreshold = 2;
+        config.minRunTime = 3000;
+    }
+    return new TestFailureMonitor(config);
+}
+//# sourceMappingURL=testFailureMonitor.js.map

package/dist/core/testFailureMonitor.js.map

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

package/dist/core/toolPreconditions.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pre-flight validation patterns for AI flow design.
+ * Catches common tool usage failures before execution and provides actionable guidance.
+ */
+export interface PreflightWarning {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: 'critical' | 'warning' | 'info';
+    readonly suggestion: string;
+}
+export declare const EDIT_WITHOUT_READ = "EDIT_WITHOUT_READ";
+type ToolHistoryCall = {
+    toolName: string;
+    args: Record<string, unknown>;
+    timestamp?: number;
+};
+/**
+ * Validate tool preconditions before execution to prevent common AI flow failures.
+ *
+ * This function implements the critical AI flow design principle: validate before execute.
+ * It catches common patterns that lead to tool failures and provides actionable guidance.
+ *
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @returns Array of pre-flight warnings (empty if all validations pass)
+ */
+export declare function validateToolPreconditions(toolName: string, args: Record<string, unknown>): PreflightWarning[];
+/**
+ * Enhanced AI flow validation for TypeScript software engineering
+ * Provides comprehensive validation of AI tool usage patterns
+ */
+export declare function validateAIFlowPatterns(toolName: string, args: Record<string, unknown>, toolHistory: readonly ToolHistoryCall[]): PreflightWarning[];
+export {};
+//# sourceMappingURL=toolPreconditions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolPreconditions.d.ts","sourceRoot":"","sources":["../../src/core/toolPreconditions.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,EAAE,CA0GpB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS,eAAe,EAAE,GACtC,gBAAgB,EAAE,CAuEpB"}

package/dist/core/toolPreconditions.js

@@ -0,0 +1,242 @@
+import { existsSync, realpathSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, normalize as normalizePath, resolve as resolvePath } from 'node:path';
+import { analyzeBashFlow } from './bashCommandGuidance.js';
+export const EDIT_WITHOUT_READ = 'EDIT_WITHOUT_READ';
+/**
+ * Validate tool preconditions before execution to prevent common AI flow failures.
+ *
+ * This function implements the critical AI flow design principle: validate before execute.
+ * It catches common patterns that lead to tool failures and provides actionable guidance.
+ *
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @returns Array of pre-flight warnings (empty if all validations pass)
+ */
+export function validateToolPreconditions(toolName, args) {
+    const warnings = [];
+    const toolLower = toolName.toLowerCase();
+    // -------------------------------------------------------------------------
+    // Edit Tool Validation - Critical for AI software engineering flow
+    // -------------------------------------------------------------------------
+    if (toolLower === 'edit') {
+        const oldString = args['old_string'];
+        const newString = args['new_string'];
+        const filePath = args['file_path'];
+        if (!oldString) {
+            // Empty old_string = new file creation - validate path structure
+            if (filePath && !isAbsolute(filePath)) {
+                warnings.push({
+                    code: 'EDIT_RELATIVE_PATH',
+                    message: 'Edit file_path should be absolute path for new file creation',
+                    severity: 'warning',
+                    suggestion: 'Use absolute path (e.g. /foo/bar or C:\\foo\\bar) for file creation',
+                });
+            }
+        }
+        else {
+            // PATTERN 1: Placeholder patterns - AI is guessing content (but NOT "TODO" which is legitimate code)
+            const placeholderPatterns = ['[content]', '[code]', '/* ... */', '// ...'];
+            // Only flag "..." if it's standalone, not as part of spread operator or ellipsis in comments
+            const hasStandalonePlaceholder = placeholderPatterns.some((p) => oldString.includes(p)) ||
+                /(?<!\.)\.\.\.(?!\.)/.test(oldString); // Matches ... but not .... or .....
+            if (hasStandalonePlaceholder) {
+                warnings.push({
+                    code: 'EDIT_PLACEHOLDER',
+                    message: 'Placeholder patterns detected - HALLUCINATION ALERT',
+                    severity: 'critical',
+                    suggestion: 'AI is guessing content instead of reading actual file. ALWAYS use Read tool to get exact file content including whitespace.',
+                });
+            }
+            // PATTERN 2: Tab vs space mismatch (legitimate concern)
+            if (oldString && newString) {
+                const oldHasTabs = oldString.includes('\t');
+                const newHasTabs = newString.includes('\t');
+                if (oldHasTabs && !newHasTabs) {
+                    warnings.push({
+                        code: 'EDIT_WHITESPACE_MISMATCH',
+                        message: 'old_string uses tabs, new_string uses spaces',
+                        severity: 'warning',
+                        suggestion: 'Whitespace type mismatch may cause Edit to fail.',
+                    });
+                }
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Search Operations Validation - Only flag truly problematic patterns
+    // -------------------------------------------------------------------------
+    if (toolLower === 'grep' || toolLower === 'glob' || toolLower.includes('search')) {
+        const patternArg = args['pattern'];
+        const pattern = typeof patternArg === 'string' ? patternArg.trim() : '';
+        const isGrepTool = toolLower.includes('grep');
+        if (pattern) {
+            // Only warn on truly broad patterns that would match everything
+            if (isBroadBasePattern(pattern)) {
+                warnings.push({
+                    code: 'SEARCH_BROAD_PATTERN',
+                    message: `Pattern '${pattern}' is too broad and may return thousands of files`,
+                    severity: 'critical',
+                    suggestion: "Use targeted patterns like '**/*.ts' or 'src/**/*.js'.",
+                });
+            }
+            // For grep: only warn on patterns that literally match everything
+            if (isGrepTool && isVeryBroadRegex(pattern)) {
+                const hasFileFilters = typeof args['glob'] === 'string' || typeof args['type'] === 'string';
+                if (!hasFileFilters) {
+                    warnings.push({
+                        code: 'SEARCH_CONTEXT_OVERFLOW_RISK',
+                        message: `Regex pattern '${pattern}' matches everything`,
+                        severity: 'warning',
+                        suggestion: 'Use a more specific pattern or add a glob/type filter.',
+                    });
+                }
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Bash Command Efficiency
+    // -------------------------------------------------------------------------
+    if (toolLower === 'bash' || toolLower === 'execute_bash') {
+        const command = String(args['command'] || '');
+        const flowWarnings = analyzeBashFlow(command);
+        for (const flow of flowWarnings) {
+            warnings.push({
+                code: flow.code,
+                message: flow.message,
+                severity: flow.severity === 'critical' ? 'critical' : flow.severity === 'info' ? 'info' : 'warning',
+                suggestion: flow.suggestion ?? flow.message,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Enhanced AI flow validation for TypeScript software engineering
+ * Provides comprehensive validation of AI tool usage patterns
+ */
+export function validateAIFlowPatterns(toolName, args, toolHistory) {
+    const warnings = [];
+    const toolLower = toolName.toLowerCase();
+    // Pattern: Edit without prior Read - Critical for hallucination reduction
+    if (toolLower === 'edit') {
+        const targetPath = normalizeFilePath(args['file_path']);
+        const isNewFileCreation = isNewFileEdit(args['old_string']);
+        const hasRecentRead = hasMatchingRead(toolHistory, targetPath);
+        if (!isNewFileCreation && !hasRecentRead) {
+            warnings.push({
+                code: EDIT_WITHOUT_READ,
+                message: 'Edit attempted without prior file read - HIGH HALLUCINATION RISK',
+                severity: 'critical',
+                suggestion: 'ALWAYS use Read tool first to get exact text including whitespace and indentation. Never guess file content.',
+            });
+        }
+    }
+    // Pattern: Multiple validation runs
+    if (toolLower === 'run_repo_checks' || toolLower === 'run_tests' || toolLower === 'run_build') {
+        const now = Date.now();
+        const recencyWindowMs = 15 * 60 * 1000; // Only warn when validations are clustered
+        const recentValidations = toolHistory
+            .filter((call) => call.toolName.toLowerCase().includes('run_') ||
+            call.toolName.toLowerCase().includes('test') ||
+            call.toolName.toLowerCase().includes('build'))
+            .filter((call) => {
+            if (typeof call.timestamp !== 'number') {
+                return true;
+            }
+            return now - call.timestamp <= recencyWindowMs;
+        });
+        if (recentValidations.length > 0) {
+            warnings.push({
+                code: 'DEFERRED_VALIDATION_REMINDER',
+                message: 'Validation already ran recently; batch edits and run one final pass at the end.',
+                severity: 'info',
+                suggestion: 'Finish implementation work first, then run a single build/test/check step to validate.',
+            });
+        }
+    }
+    // Pattern: Excessive git status calls (actually wasteful)
+    // Note: Multiple git operations in sequence (add, commit, push) is fine - don't warn on that
+    if (toolLower.includes('git')) {
+        const command = String(args['command'] || '');
+        if (command.includes('git status')) {
+            const recentStatusCalls = toolHistory.filter((call) => {
+                const cmd = String(call.args['command'] || '');
+                return cmd.includes('git status');
+            });
+            // Only warn if there are 3+ status calls - 2 is normal (before and after operations)
+            if (recentStatusCalls.length >= 3) {
+                warnings.push({
+                    code: 'GIT_REDUNDANT_STATUS',
+                    message: 'Multiple git status calls detected',
+                    severity: 'info',
+                    suggestion: 'One git status call is usually sufficient.',
+                });
+            }
+        }
+    }
+    return warnings;
+}
+function isBroadBasePattern(pattern) {
+    // Only the truly universal patterns that match everything
+    return pattern === '.' || pattern === '*' || pattern === '**' || pattern === '**/*';
+}
+function isVeryBroadRegex(pattern) {
+    const normalized = pattern.trim();
+    return normalized === '.*' || normalized === '.+' || normalized === '.';
+}
+function hasMatchingRead(toolHistory, targetPath) {
+    if (!targetPath)
+        return false;
+    return toolHistory.some((call) => {
+        const callLower = call.toolName.toLowerCase();
+        if (!callLower.includes('read')) {
+            return false;
+        }
+        const readPath = normalizeFilePath(call.args['path'] ?? call.args['file_path']);
+        return Boolean(readPath && readPath === targetPath);
+    });
+}
+function isNewFileEdit(oldString) {
+    return typeof oldString === 'string' && oldString.length === 0;
+}
+function normalizeFilePath(pathValue) {
+    if (typeof pathValue !== 'string') {
+        return null;
+    }
+    const trimmed = pathValue.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        const normalized = normalizePath(trimmed);
+        const absolutePath = isAbsolute(normalized) ? normalized : resolvePath(process.cwd(), normalized);
+        // Resolve symlinks on the deepest existing directory to avoid /var vs /private/var mismatches
+        let currentDir = dirname(absolutePath);
+        let suffix = basename(absolutePath);
+        // Loop until we find an existing ancestor or hit the filesystem root.
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            if (existsSync(currentDir)) {
+                try {
+                    const realDir = realpathSync(currentDir);
+                    return normalizePath(join(realDir, suffix));
+                }
+                catch {
+                    // If realpath fails, fall through to the default normalization
+                    break;
+                }
+            }
+            const parentDir = dirname(currentDir);
+            if (parentDir === currentDir) {
+                break;
+            }
+            suffix = join(basename(currentDir), suffix);
+            currentDir = parentDir;
+        }
+        return normalizePath(absolutePath);
+    }
+    catch {
+        return trimmed;
+    }
+}
+//# sourceMappingURL=toolPreconditions.js.map

package/dist/core/toolPreconditions.js.map

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