rafcode 1.0.0

package/dist/core/claude-runner.js

@@ -0,0 +1,297 @@
+import * as pty from 'node-pty';
+import { execSync, spawn } from 'node:child_process';
+import { logger } from '../utils/logger.js';
+function getClaudePath() {
+    try {
+        return execSync('which claude', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        throw new Error('Claude CLI not found. Please ensure it is installed and in your PATH.');
+    }
+}
+const CONTEXT_OVERFLOW_PATTERNS = [
+    /context length exceeded/i,
+    /token limit/i,
+    /maximum context/i,
+    /context window/i,
+];
+export class ClaudeRunner {
+    activeProcess = null;
+    killed = false;
+    model;
+    constructor(config = {}) {
+        this.model = config.model ?? 'opus';
+    }
+    /**
+     * Run Claude interactively with stdin/stdout passthrough.
+     * Used for planning phase where user interaction is needed.
+     *
+     * @param systemPrompt - Instructions appended to Claude's system prompt via --append-system-prompt
+     * @param userMessage - User message passed as positional argument to trigger Claude to start
+     * @param options - Runner options (cwd, dangerouslySkipPermissions)
+     */
+    async runInteractive(systemPrompt, userMessage, options = {}) {
+        const { cwd = process.cwd(), dangerouslySkipPermissions = false } = options;
+        return new Promise((resolve) => {
+            const args = ['--model', this.model];
+            // Add --dangerously-skip-permissions if requested (for --auto mode)
+            if (dangerouslySkipPermissions) {
+                args.push('--dangerously-skip-permissions');
+            }
+            // System instructions via --append-system-prompt
+            args.push('--append-system-prompt', systemPrompt);
+            // User message as positional argument - Claude starts immediately
+            args.push(userMessage);
+            logger.debug(`Starting interactive Claude session with model: ${this.model}`);
+            this.activeProcess = pty.spawn(getClaudePath(), args, {
+                name: 'xterm-256color',
+                cols: process.stdout.columns ?? 80,
+                rows: process.stdout.rows ?? 24,
+                cwd,
+                env: process.env,
+            });
+            // Set raw mode to pass through all input
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(true);
+            }
+            process.stdin.resume();
+            // Pipe input to Claude
+            const onData = (data) => {
+                if (this.activeProcess && !this.killed) {
+                    this.activeProcess.write(data.toString());
+                }
+            };
+            process.stdin.on('data', onData);
+            // Pipe output to stdout
+            this.activeProcess.onData((data) => {
+                process.stdout.write(data);
+            });
+            this.activeProcess.onExit(({ exitCode }) => {
+                // Cleanup
+                process.stdin.off('data', onData);
+                if (process.stdin.isTTY) {
+                    process.stdin.setRawMode(false);
+                }
+                process.stdin.pause();
+                this.activeProcess = null;
+                if (this.killed) {
+                    resolve(130); // SIGINT exit code
+                }
+                else {
+                    resolve(exitCode);
+                }
+            });
+        });
+    }
+    /**
+     * Run Claude non-interactively and collect output.
+     * Used for execution phase where we parse the results.
+     * Uses child_process.spawn with -p flag for prompt (like ralphy).
+     *
+     * TIMEOUT BEHAVIOR:
+     * - The timeout is applied per individual call to this method
+     * - Each call gets a fresh timeout - elapsed time is NOT shared between calls
+     * - When used with retries (in do.ts), each retry attempt gets its own fresh timeout
+     * - Timeout includes all time Claude is running, including context building
+     * - Default timeout is 60 minutes if not specified
+     */
+    async run(prompt, options = {}) {
+        const { timeout = 60, cwd = process.cwd() } = options;
+        // Ensure timeout is a positive number, fallback to 60 minutes
+        const validatedTimeout = Number(timeout) > 0 ? Number(timeout) : 60;
+        const timeoutMs = validatedTimeout * 60 * 1000;
+        return new Promise((resolve) => {
+            let output = '';
+            let stderr = '';
+            let timedOut = false;
+            let contextOverflow = false;
+            const claudePath = getClaudePath();
+            logger.debug(`Starting Claude execution session with model: ${this.model}`);
+            logger.debug(`Claude path: ${claudePath}`);
+            // Use --append-system-prompt to add RAF instructions to system prompt
+            // This gives RAF instructions stronger precedence than passing as user message
+            // --dangerously-skip-permissions bypasses interactive prompts
+            // -p enables print mode (non-interactive)
+            const proc = spawn(claudePath, [
+                '--dangerously-skip-permissions',
+                '--model',
+                this.model,
+                '--append-system-prompt',
+                prompt,
+                '-p',
+                'Execute the task as described in the system prompt.',
+            ], {
+                cwd,
+                env: process.env,
+                stdio: ['ignore', 'pipe', 'pipe'], // no stdin needed
+            });
+            // Track this process
+            this.activeProcess = proc;
+            // Set up timeout
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                logger.warn('Claude session timed out');
+                proc.kill('SIGTERM');
+            }, timeoutMs);
+            // Collect stdout
+            proc.stdout.on('data', (data) => {
+                const text = data.toString();
+                output += text;
+                // Check for context overflow
+                for (const pattern of CONTEXT_OVERFLOW_PATTERNS) {
+                    if (pattern.test(text)) {
+                        contextOverflow = true;
+                        logger.warn('Context overflow detected');
+                        proc.kill('SIGTERM');
+                        break;
+                    }
+                }
+            });
+            // Collect stderr
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (exitCode) => {
+                clearTimeout(timeoutHandle);
+                this.activeProcess = null;
+                if (stderr) {
+                    logger.debug(`Claude stderr: ${stderr}`);
+                }
+                resolve({
+                    output,
+                    exitCode: exitCode ?? (this.killed ? 130 : 1),
+                    timedOut,
+                    contextOverflow,
+                });
+            });
+        });
+    }
+    /**
+     * Run Claude non-interactively with verbose output to stdout.
+     * Uses child_process.spawn with -p flag for prompt (like ralphy).
+     *
+     * TIMEOUT BEHAVIOR:
+     * - The timeout is applied per individual call to this method
+     * - Each call gets a fresh timeout - elapsed time is NOT shared between calls
+     * - When used with retries (in do.ts), each retry attempt gets its own fresh timeout
+     * - Timeout includes all time Claude is running, including context building
+     * - Default timeout is 60 minutes if not specified
+     */
+    async runVerbose(prompt, options = {}) {
+        const { timeout = 60, cwd = process.cwd() } = options;
+        // Ensure timeout is a positive number, fallback to 60 minutes
+        const validatedTimeout = Number(timeout) > 0 ? Number(timeout) : 60;
+        const timeoutMs = validatedTimeout * 60 * 1000;
+        return new Promise((resolve) => {
+            let output = '';
+            let stderr = '';
+            let timedOut = false;
+            let contextOverflow = false;
+            const claudePath = getClaudePath();
+            logger.debug(`Starting Claude execution session (verbose) with model: ${this.model}`);
+            logger.debug(`Prompt length: ${prompt.length}, timeout: ${timeoutMs}ms, cwd: ${cwd}`);
+            logger.debug(`Claude path: ${claudePath}`);
+            logger.debug('Spawning process...');
+            // Use --append-system-prompt to add RAF instructions to system prompt
+            // This gives RAF instructions stronger precedence than passing as user message
+            // --dangerously-skip-permissions bypasses interactive prompts
+            // -p enables print mode (non-interactive)
+            const proc = spawn(claudePath, [
+                '--dangerously-skip-permissions',
+                '--model',
+                this.model,
+                '--append-system-prompt',
+                prompt,
+                '-p',
+                'Execute the task as described in the system prompt.',
+            ], {
+                cwd,
+                env: process.env,
+                stdio: ['ignore', 'pipe', 'pipe'], // no stdin needed
+            });
+            // Track this process
+            this.activeProcess = proc;
+            logger.debug('Process spawned');
+            // Set up timeout
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                logger.warn('Claude session timed out');
+                proc.kill('SIGTERM');
+            }, timeoutMs);
+            // Collect and display stdout
+            let dataReceived = false;
+            proc.stdout.on('data', (data) => {
+                if (!dataReceived) {
+                    logger.debug('First data chunk received');
+                    dataReceived = true;
+                }
+                const text = data.toString();
+                output += text;
+                process.stdout.write(text);
+                // Check for context overflow
+                for (const pattern of CONTEXT_OVERFLOW_PATTERNS) {
+                    if (pattern.test(text)) {
+                        contextOverflow = true;
+                        logger.warn('Context overflow detected');
+                        proc.kill('SIGTERM');
+                        break;
+                    }
+                }
+            });
+            // Collect stderr
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (exitCode) => {
+                clearTimeout(timeoutHandle);
+                this.activeProcess = null;
+                logger.debug(`Claude exited with code ${exitCode}, output length: ${output.length}, timedOut: ${timedOut}, contextOverflow: ${contextOverflow}`);
+                if (stderr) {
+                    logger.debug(`Claude stderr: ${stderr}`);
+                }
+                resolve({
+                    output,
+                    exitCode: exitCode ?? (this.killed ? 130 : 1),
+                    timedOut,
+                    contextOverflow,
+                });
+            });
+        });
+    }
+    /**
+     * Kill the active Claude process gracefully.
+     */
+    kill() {
+        if (this.activeProcess) {
+            this.killed = true;
+            // Send Ctrl+C first for graceful shutdown (only for PTY processes)
+            // ChildProcess from spawn() doesn't have write(), only PTY does
+            try {
+                if (typeof this.activeProcess.write === 'function') {
+                    this.activeProcess.write('\x03');
+                }
+            }
+            catch {
+                // Ignore write errors - process may already be closing
+            }
+            // Force kill after 5 seconds if still running
+            setTimeout(() => {
+                if (this.activeProcess) {
+                    try {
+                        this.activeProcess.kill();
+                    }
+                    catch {
+                        // Ignore kill errors - process may already be dead
+                    }
+                }
+            }, 5000);
+        }
+    }
+    /**
+     * Check if a process is currently running.
+     */
+    isRunning() {
+        return this.activeProcess !== null;
+    }
+}
+//# sourceMappingURL=claude-runner.js.map

package/dist/core/claude-runner.js.map

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

package/dist/core/editor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Open the user's preferred editor and return the content they wrote.
+ */
+export declare function openEditor(initialContent?: string): Promise<string>;
+/**
+ * Returns initial content for the project description editor.
+ * Opens with an empty file for a clean user experience.
+ */
+export declare function getInputTemplate(): string;
+//# sourceMappingURL=editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/core/editor.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,wBAAsB,UAAU,CAAC,cAAc,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C7E;AAaD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/core/editor.js

@@ -0,0 +1,77 @@
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { getEditor } from '../utils/config.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Escape a file path for shell usage.
+ */
+function escapeShellPath(filePath) {
+    // Use single quotes and escape any existing single quotes
+    return `'${filePath.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * Open the user's preferred editor and return the content they wrote.
+ */
+export async function openEditor(initialContent = '') {
+    const editor = getEditor();
+    const tempDir = os.tmpdir();
+    const tempFile = path.join(tempDir, `raf-input-${Date.now()}.md`);
+    // Write initial content if any
+    fs.writeFileSync(tempFile, initialContent);
+    // Build shell command with properly escaped file path
+    // This handles editors like "code --wait" or "vim" uniformly
+    const shellCommand = `${editor} ${escapeShellPath(tempFile)}`;
+    logger.debug(`Opening editor: ${shellCommand}`);
+    return new Promise((resolve, reject) => {
+        // Use shell: true with the full command as a single string
+        // This correctly handles editors with arguments (e.g., "code --wait")
+        const editorProcess = spawn(shellCommand, [], {
+            stdio: 'inherit',
+            shell: true,
+        });
+        editorProcess.on('error', (error) => {
+            cleanupTempFile(tempFile);
+            reject(new Error(`Failed to open editor: ${error.message}`));
+        });
+        editorProcess.on('exit', (code) => {
+            // Read the file content regardless of exit code
+            // Many editors (vim included) may exit with non-zero for various benign reasons
+            try {
+                const content = fs.readFileSync(tempFile, 'utf-8');
+                cleanupTempFile(tempFile);
+                // Only treat as error if file is empty/unchanged AND exit code is non-zero
+                // This distinguishes between "user cancelled" and "editor failed"
+                if (code !== 0 && content === initialContent) {
+                    reject(new Error(`Editor exited with code ${code}`));
+                    return;
+                }
+                resolve(content);
+            }
+            catch (error) {
+                cleanupTempFile(tempFile);
+                reject(new Error(`Failed to read editor content: ${error}`));
+            }
+        });
+    });
+}
+/**
+ * Safely remove temp file, ignoring errors if file doesn't exist.
+ */
+function cleanupTempFile(filePath) {
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        // Ignore errors - file may already be deleted
+    }
+}
+/**
+ * Returns initial content for the project description editor.
+ * Opens with an empty file for a clean user experience.
+ */
+export function getInputTemplate() {
+    return '';
+}
+//# sourceMappingURL=editor.js.map

package/dist/core/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/core/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,0DAA0D;IAC1D,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,iBAAyB,EAAE;IAC1D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAElE,+BAA+B;IAC/B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAE3C,sDAAsD;IACtD,6DAA6D;IAC7D,MAAM,YAAY,GAAG,GAAG,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9D,MAAM,CAAC,KAAK,CAAC,mBAAmB,YAAY,EAAE,CAAC,CAAC;IAEhD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,2DAA2D;QAC3D,sEAAsE;QACtE,MAAM,aAAa,GAAG,KAAK,CAAC,YAAY,EAAE,EAAE,EAAE;YAC5C,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAChC,gDAAgD;YAChD,gFAAgF;YAChF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,eAAe,CAAC,QAAQ,CAAC,CAAC;gBAE1B,2EAA2E;gBAC3E,kEAAkE;gBAClE,IAAI,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;oBAC7C,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,CAAC;oBACrD,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,eAAe,CAAC,QAAQ,CAAC,CAAC;gBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/core/failure-analyzer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Failure types that can be detected programmatically without using the API.
+ */
+export type ProgrammaticFailureType = 'api_error' | 'rate_limit' | 'timeout' | 'context_overflow';
+/**
+ * Result of analyzing task failure.
+ */
+export interface FailureAnalysisResult {
+    failureReason: string;
+    analysis: string;
+    suggestedFix: string;
+    relevantOutput: string;
+}
+/**
+ * Detect if the failure is a known programmatic failure type.
+ * Returns null if the failure type requires AI analysis.
+ */
+export declare function detectProgrammaticFailure(output: string, failureReason: string): ProgrammaticFailureType | null;
+/**
+ * Generate a programmatic failure report for known failure types.
+ */
+export declare function generateProgrammaticReport(failureType: ProgrammaticFailureType, _failureReason: string, output: string): string;
+/**
+ * Analyze a failure using Claude (Sonnet/Haiku) and generate a structured report.
+ * Uses a fast model for cost efficiency.
+ */
+export declare function analyzeFailure(output: string, failureReason: string, taskId: string, timeoutMs?: number): Promise<string>;
+//# sourceMappingURL=failure-analyzer.d.ts.map

package/dist/core/failure-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-analyzer.d.ts","sourceRoot":"","sources":["../../src/core/failure-analyzer.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,WAAW,GACX,YAAY,GACZ,SAAS,GACT,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAoCD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,uBAAuB,GAAG,IAAI,CA8BhC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,uBAAuB,EACpC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CAsFR;AAiCD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,MAAM,CAAC,CA8BjB"}