ralph-starter 0.0.1 → 0.1.1-beta.0

package/dist/loop/__tests__/validation.test.js

@@ -0,0 +1,234 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { detectValidationCommands, formatValidationFeedback, runAllValidations, runValidation, } from '../validation.js';
+// Mock fs
+vi.mock('fs', () => ({
+    existsSync: vi.fn(),
+    readFileSync: vi.fn(),
+}));
+// Mock execa
+vi.mock('execa', () => ({
+    execa: vi.fn(),
+}));
+import { execa } from 'execa';
+const mockExistsSync = vi.mocked(existsSync);
+const mockReadFileSync = vi.mocked(readFileSync);
+const mockExeca = vi.mocked(execa);
+describe('validation', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('detectValidationCommands', () => {
+        it('should return empty array when no config files exist', () => {
+            mockExistsSync.mockReturnValue(false);
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands).toHaveLength(0);
+        });
+        it('should detect commands from AGENTS.md', () => {
+            mockExistsSync.mockImplementation((path) => path.toString().includes('AGENTS.md'));
+            mockReadFileSync.mockReturnValue(`
+# Project Commands
+
+- **Test**: \`npm test\`
+- **Lint**: \`npm run lint\`
+- **Build**: \`npm run build\`
+      `);
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands).toHaveLength(3);
+            expect(commands.find((c) => c.name === 'test')).toBeDefined();
+            expect(commands.find((c) => c.name === 'lint')).toBeDefined();
+            expect(commands.find((c) => c.name === 'build')).toBeDefined();
+        });
+        it('should parse command with arguments from AGENTS.md', () => {
+            mockExistsSync.mockImplementation((path) => path.toString().includes('AGENTS.md'));
+            mockReadFileSync.mockReturnValue('- test: `pytest -x --verbose`');
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands[0]).toEqual({
+                name: 'test',
+                command: 'pytest',
+                args: ['-x', '--verbose'],
+            });
+        });
+        it('should fallback to package.json when no AGENTS.md', () => {
+            mockExistsSync.mockImplementation((path) => path.toString().includes('package.json'));
+            mockReadFileSync.mockReturnValue(JSON.stringify({
+                scripts: {
+                    test: 'vitest',
+                    lint: 'eslint .',
+                    build: 'tsc',
+                },
+            }));
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands).toHaveLength(3);
+            expect(commands.find((c) => c.name === 'test')).toEqual({
+                name: 'test',
+                command: 'npm',
+                args: ['run', 'test'],
+            });
+        });
+        it('should skip default npm test error message', () => {
+            mockExistsSync.mockImplementation((path) => path.toString().includes('package.json'));
+            mockReadFileSync.mockReturnValue(JSON.stringify({
+                scripts: {
+                    test: 'echo "Error: no test specified" && exit 1',
+                    lint: 'eslint .',
+                },
+            }));
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands.find((c) => c.name === 'test')).toBeUndefined();
+            expect(commands.find((c) => c.name === 'lint')).toBeDefined();
+        });
+        it('should detect typecheck script', () => {
+            mockExistsSync.mockImplementation((path) => path.toString().includes('package.json'));
+            mockReadFileSync.mockReturnValue(JSON.stringify({
+                scripts: {
+                    typecheck: 'tsc --noEmit',
+                },
+            }));
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands.find((c) => c.name === 'typecheck')).toBeDefined();
+        });
+        it('should handle invalid package.json', () => {
+            mockExistsSync.mockImplementation((path) => path.toString().includes('package.json'));
+            mockReadFileSync.mockReturnValue('not valid json');
+            const commands = detectValidationCommands('/test/dir');
+            expect(commands).toHaveLength(0);
+        });
+    });
+    describe('runValidation', () => {
+        it('should return success when command exits with 0', async () => {
+            mockExeca.mockResolvedValueOnce({
+                exitCode: 0,
+                stdout: 'All tests passed',
+                stderr: '',
+            });
+            const command = {
+                name: 'test',
+                command: 'npm',
+                args: ['test'],
+            };
+            const result = await runValidation('/test/dir', command);
+            expect(result.success).toBe(true);
+            expect(result.output).toBe('All tests passed');
+        });
+        it('should return failure when command exits with non-zero', async () => {
+            mockExeca.mockResolvedValueOnce({
+                exitCode: 1,
+                stdout: '',
+                stderr: 'Test failed: Expected 1 but got 2',
+            });
+            const command = {
+                name: 'test',
+                command: 'npm',
+                args: ['test'],
+            };
+            const result = await runValidation('/test/dir', command);
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('Test failed');
+        });
+        it('should handle command execution errors', async () => {
+            mockExeca.mockRejectedValueOnce(new Error('Command not found: npm'));
+            const command = {
+                name: 'test',
+                command: 'npm',
+                args: ['test'],
+            };
+            const result = await runValidation('/test/dir', command);
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('Command not found');
+        });
+        it('should use stdout as error when stderr is empty', async () => {
+            mockExeca.mockResolvedValueOnce({
+                exitCode: 1,
+                stdout: 'Error in stdout',
+                stderr: '',
+            });
+            const command = {
+                name: 'test',
+                command: 'npm',
+                args: ['test'],
+            };
+            const result = await runValidation('/test/dir', command);
+            expect(result.error).toBe('Error in stdout');
+        });
+    });
+    describe('runAllValidations', () => {
+        it('should run all commands when all pass', async () => {
+            mockExeca.mockResolvedValue({
+                exitCode: 0,
+                stdout: 'Passed',
+                stderr: '',
+            });
+            const commands = [
+                { name: 'test', command: 'npm', args: ['test'] },
+                { name: 'lint', command: 'npm', args: ['run', 'lint'] },
+                { name: 'build', command: 'npm', args: ['run', 'build'] },
+            ];
+            const results = await runAllValidations('/test/dir', commands);
+            expect(results).toHaveLength(3);
+            expect(results.every((r) => r.success)).toBe(true);
+        });
+        it('should stop on first failure', async () => {
+            mockExeca
+                .mockResolvedValueOnce({ exitCode: 0, stdout: 'Passed', stderr: '' })
+                .mockResolvedValueOnce({ exitCode: 1, stdout: '', stderr: 'Failed' })
+                .mockResolvedValueOnce({ exitCode: 0, stdout: 'Passed', stderr: '' });
+            const commands = [
+                { name: 'test', command: 'npm', args: ['test'] },
+                { name: 'lint', command: 'npm', args: ['run', 'lint'] },
+                { name: 'build', command: 'npm', args: ['run', 'build'] },
+            ];
+            const results = await runAllValidations('/test/dir', commands);
+            expect(results).toHaveLength(2); // Stopped after lint failed
+            expect(results[0].success).toBe(true);
+            expect(results[1].success).toBe(false);
+        });
+        it('should handle empty command list', async () => {
+            const results = await runAllValidations('/test/dir', []);
+            expect(results).toHaveLength(0);
+        });
+    });
+    describe('formatValidationFeedback', () => {
+        it('should return empty string when all validations pass', () => {
+            const results = [
+                { success: true, command: 'npm test', output: 'Passed' },
+                { success: true, command: 'npm run lint', output: 'No issues' },
+            ];
+            const feedback = formatValidationFeedback(results);
+            expect(feedback).toBe('');
+        });
+        it('should format failed validation as feedback', () => {
+            const results = [
+                { success: true, command: 'npm test', output: 'Passed' },
+                {
+                    success: false,
+                    command: 'npm run lint',
+                    output: '',
+                    error: 'src/index.ts:10:5 - Unexpected any',
+                },
+            ];
+            const feedback = formatValidationFeedback(results);
+            expect(feedback).toContain('## Validation Failed');
+            expect(feedback).toContain('npm run lint');
+            expect(feedback).toContain('Unexpected any');
+            expect(feedback).toContain('Please fix the above issues');
+        });
+        it('should include multiple failures', () => {
+            const results = [
+                { success: false, command: 'npm test', output: '', error: 'Test 1 failed' },
+                { success: false, command: 'npm run lint', output: '', error: 'Lint error' },
+            ];
+            const feedback = formatValidationFeedback(results);
+            expect(feedback).toContain('Test 1 failed');
+            expect(feedback).toContain('Lint error');
+        });
+        it('should use output when error is empty', () => {
+            const results = [
+                { success: false, command: 'npm test', output: 'Output error', error: '' },
+            ];
+            const feedback = formatValidationFeedback(results);
+            expect(feedback).toContain('Output error');
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/loop/__tests__/validation.test.js.map

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

package/dist/loop/agents.d.ts

@@ -0,0 +1,26 @@
+export type AgentType = 'claude-code' | 'cursor' | 'codex' | 'opencode' | 'unknown';
+export interface Agent {
+    type: AgentType;
+    name: string;
+    command: string;
+    available: boolean;
+}
+export interface AgentRunOptions {
+    task: string;
+    cwd: string;
+    auto?: boolean;
+    maxTurns?: number;
+    /** Stream output to console in real-time */
+    streamOutput?: boolean;
+    /** Callback for each line of output */
+    onOutput?: (line: string) => void;
+}
+export declare function checkAgentAvailable(type: AgentType): Promise<boolean>;
+export declare function detectAvailableAgents(): Promise<Agent[]>;
+export declare function detectBestAgent(): Promise<Agent | null>;
+export declare function runAgent(agent: Agent, options: AgentRunOptions): Promise<{
+    output: string;
+    exitCode: number;
+}>;
+export declare function printAgentStatus(agents: Agent[]): void;
+//# sourceMappingURL=agents.d.ts.map

package/dist/loop/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/loop/agents.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AA8BD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3E;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAgB9D;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAc7D;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAkH/C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAUtD"}

package/dist/loop/agents.js

@@ -0,0 +1,188 @@
+import chalk from 'chalk';
+import { execa } from 'execa';
+const AGENTS = {
+    'claude-code': {
+        name: 'Claude Code',
+        command: 'claude',
+        checkCmd: ['claude', '--version'],
+    },
+    cursor: {
+        name: 'Cursor',
+        command: 'cursor',
+        checkCmd: ['cursor', '--version'],
+    },
+    codex: {
+        name: 'Codex CLI',
+        command: 'codex',
+        checkCmd: ['codex', '--version'],
+    },
+    opencode: {
+        name: 'OpenCode',
+        command: 'opencode',
+        checkCmd: ['opencode', '--version'],
+    },
+    unknown: {
+        name: 'Unknown',
+        command: '',
+        checkCmd: [],
+    },
+};
+export async function checkAgentAvailable(type) {
+    if (type === 'unknown')
+        return false;
+    const agent = AGENTS[type];
+    try {
+        await execa(agent.checkCmd[0], agent.checkCmd.slice(1));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectAvailableAgents() {
+    const agents = [];
+    for (const [type, config] of Object.entries(AGENTS)) {
+        if (type === 'unknown')
+            continue;
+        const available = await checkAgentAvailable(type);
+        agents.push({
+            type: type,
+            name: config.name,
+            command: config.command,
+            available,
+        });
+    }
+    return agents;
+}
+export async function detectBestAgent() {
+    const agents = await detectAvailableAgents();
+    const available = agents.filter((a) => a.available);
+    if (available.length === 0)
+        return null;
+    // Prefer Claude Code, then others
+    const preferred = ['claude-code', 'cursor', 'codex', 'opencode'];
+    for (const type of preferred) {
+        const agent = available.find((a) => a.type === type);
+        if (agent)
+            return agent;
+    }
+    return available[0];
+}
+export async function runAgent(agent, options) {
+    const args = [];
+    let stdinInput;
+    const env = { ...process.env };
+    switch (agent.type) {
+        case 'claude-code':
+            // Claude Code specific flags - use structured output format
+            // Pass prompt via stdin to avoid shell escaping issues with complex prompts
+            args.push('--print');
+            args.push('--verbose');
+            args.push('--output-format', 'stream-json');
+            if (options.auto) {
+                args.push('--dangerously-skip-permissions');
+                // Required for --dangerously-skip-permissions on some systems
+                env.IS_SANDBOX = '1';
+            }
+            if (options.maxTurns) {
+                args.push('--max-turns', String(options.maxTurns));
+            }
+            // Pass prompt via stdin instead of command arg
+            stdinInput = options.task;
+            break;
+        case 'cursor':
+            // Cursor agent mode
+            args.push('--agent', options.task);
+            break;
+        case 'codex':
+            // Codex specific flags
+            args.push('-p', options.task);
+            if (options.auto) {
+                args.push('--auto-approve');
+            }
+            break;
+        case 'opencode':
+            // OpenCode specific flags
+            args.push('-p', options.task);
+            if (options.auto) {
+                args.push('--auto');
+            }
+            break;
+        default:
+            throw new Error(`Unknown agent type: ${agent.type}`);
+    }
+    try {
+        // Collect output while optionally streaming
+        let output = '';
+        const subprocess = execa(agent.command, args, {
+            cwd: options.cwd,
+            reject: false,
+            stdout: 'pipe',
+            stderr: 'pipe',
+            env,
+            // Pass prompt via stdin for agents that support it (e.g., Claude Code)
+            input: stdinInput,
+        });
+        // Stream output if requested
+        if (options.streamOutput || options.onOutput) {
+            subprocess.stdout?.on('data', (data) => {
+                const text = data.toString();
+                output += text;
+                if (options.streamOutput) {
+                    process.stdout.write(chalk.dim(text));
+                }
+                if (options.onOutput) {
+                    // Call callback for each line
+                    const lines = text.split('\n').filter((l) => l.trim());
+                    for (const line of lines) {
+                        options.onOutput(line);
+                    }
+                }
+            });
+            subprocess.stderr?.on('data', (data) => {
+                const text = data.toString();
+                output += text;
+                if (options.streamOutput) {
+                    process.stderr.write(chalk.dim(text));
+                }
+                if (options.onOutput) {
+                    const lines = text.split('\n').filter((l) => l.trim());
+                    for (const line of lines) {
+                        options.onOutput(line);
+                    }
+                }
+            });
+            // Wait for completion
+            const result = await subprocess;
+            return {
+                output,
+                exitCode: result.exitCode ?? 0,
+            };
+        }
+        else {
+            // Original behavior - just capture output
+            const result = await subprocess;
+            return {
+                output: result.stdout + result.stderr,
+                exitCode: result.exitCode ?? 0,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            output: error instanceof Error ? error.message : 'Unknown error',
+            exitCode: 1,
+        };
+    }
+}
+export function printAgentStatus(agents) {
+    console.log();
+    console.log(chalk.cyan.bold('Available Agents:'));
+    console.log();
+    for (const agent of agents) {
+        const status = agent.available ? chalk.green('✓ installed') : chalk.gray('✗ not found');
+        console.log(`  ${agent.name.padEnd(15)} ${status}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=agents.js.map

package/dist/loop/agents.js.map

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

package/dist/loop/circuit-breaker.d.ts

@@ -0,0 +1,61 @@
+export interface CircuitBreakerConfig {
+    maxConsecutiveFailures: number;
+    maxSameErrorCount: number;
+    cooldownMs: number;
+}
+export interface CircuitBreakerState {
+    consecutiveFailures: number;
+    errorHistory: Map<string, number>;
+    isOpen: boolean;
+    lastFailure?: Date;
+    totalFailures: number;
+}
+export declare const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig;
+export declare class CircuitBreaker {
+    private config;
+    private state;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Hash an error message to track similar errors
+     */
+    private hashError;
+    /**
+     * Record a successful iteration - resets consecutive failures
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed iteration
+     * @returns true if circuit should trip (open)
+     */
+    recordFailure(errorMessage: string): boolean;
+    /**
+     * Determine if the circuit should trip
+     */
+    private shouldTrip;
+    /**
+     * Check if circuit is open (tripped)
+     */
+    isTripped(): boolean;
+    /**
+     * Get the reason why the circuit tripped
+     */
+    getTripReason(): string | null;
+    /**
+     * Reset the circuit breaker completely
+     */
+    reset(): void;
+    /**
+     * Get current state for logging/debugging
+     */
+    getState(): Readonly<CircuitBreakerState>;
+    /**
+     * Get statistics for display
+     */
+    getStats(): {
+        consecutiveFailures: number;
+        totalFailures: number;
+        uniqueErrors: number;
+        isOpen: boolean;
+    };
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/loop/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/loop/circuit-breaker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,8BAA8B,EAAE,oBAI5C,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAsB;gBAEvB,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAUtD;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;;OAGG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAmB5C;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,SAAS,IAAI,OAAO;IAkBpB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAwB9B;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAIzC;;OAEG;IACH,QAAQ,IAAI;QACV,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC;KACjB;CAQF"}