rafcode 1.0.0

package/dist/core/failure-analyzer.js

@@ -0,0 +1,305 @@
+import { spawn } from 'node:child_process';
+import { execSync } from 'node:child_process';
+/**
+ * Patterns for detecting programmatic failure types.
+ */
+const API_ERROR_PATTERNS = [
+    /api error/i,
+    /internal server error/i,
+    /service unavailable/i,
+    /bad gateway/i,
+    /500\s+(internal\s+)?server\s+error/i,
+    /502\s+bad\s+gateway/i,
+    /503\s+service\s+unavailable/i,
+    /504\s+gateway\s+timeout/i,
+    /APIError/i,
+    /API request failed/i,
+];
+const RATE_LIMIT_PATTERNS = [
+    /rate limit/i,
+    /too many requests/i,
+    /429\s+too\s+many\s+requests/i,
+    /quota exceeded/i,
+    /request limit/i,
+    /throttl/i,
+];
+const CONTEXT_OVERFLOW_PATTERNS = [
+    /context length exceeded/i,
+    /token limit/i,
+    /maximum context/i,
+    /context window/i,
+    /too many tokens/i,
+    /max.*tokens/i,
+];
+/**
+ * Detect if the failure is a known programmatic failure type.
+ * Returns null if the failure type requires AI analysis.
+ */
+export function detectProgrammaticFailure(output, failureReason) {
+    const combined = `${output}\n${failureReason}`;
+    // Check for context overflow
+    for (const pattern of CONTEXT_OVERFLOW_PATTERNS) {
+        if (pattern.test(combined)) {
+            return 'context_overflow';
+        }
+    }
+    // Check for rate limiting
+    for (const pattern of RATE_LIMIT_PATTERNS) {
+        if (pattern.test(combined)) {
+            return 'rate_limit';
+        }
+    }
+    // Check for API errors
+    for (const pattern of API_ERROR_PATTERNS) {
+        if (pattern.test(combined)) {
+            return 'api_error';
+        }
+    }
+    // Check for timeout (usually passed in failureReason)
+    if (/timeout|timed out/i.test(failureReason)) {
+        return 'timeout';
+    }
+    return null;
+}
+/**
+ * Generate a programmatic failure report for known failure types.
+ */
+export function generateProgrammaticReport(failureType, _failureReason, output) {
+    const relevantOutput = extractRelevantOutput(output, 50);
+    switch (failureType) {
+        case 'api_error':
+            return `## Failure Reason
+API error occurred during task execution.
+
+## Analysis
+The Claude API returned an error response. This is typically a temporary issue with the API service.
+
+## Suggested Fix
+- Wait a few minutes and retry the task
+- Check the Anthropic status page for any ongoing incidents
+- If the issue persists, try running with a smaller context
+
+## Relevant Output
+\`\`\`
+${relevantOutput}
+\`\`\`
+
+<promise>FAILED</promise>`;
+        case 'rate_limit':
+            return `## Failure Reason
+Rate limit exceeded during task execution.
+
+## Analysis
+The API rate limit was reached. This typically happens when too many requests are made in a short period.
+
+## Suggested Fix
+- Wait 1-2 minutes before retrying
+- If using parallel execution, reduce concurrency
+- Consider upgrading your API tier for higher limits
+
+## Relevant Output
+\`\`\`
+${relevantOutput}
+\`\`\`
+
+<promise>FAILED</promise>`;
+        case 'timeout':
+            return `## Failure Reason
+Task execution timed out.
+
+## Analysis
+The task took longer than the configured timeout to complete. This could indicate:
+- The task is too complex or large for a single execution
+- Claude is stuck or making slow progress
+- Network issues causing delays
+
+## Suggested Fix
+- Increase the timeout with \`--timeout <minutes>\`
+- Break the task into smaller subtasks
+- Check the logs for what Claude was doing before timeout
+
+## Relevant Output
+\`\`\`
+${relevantOutput}
+\`\`\`
+
+<promise>FAILED</promise>`;
+        case 'context_overflow':
+            return `## Failure Reason
+Context window exceeded during task execution.
+
+## Analysis
+The conversation context grew too large for Claude to process. This typically happens when:
+- Too much code or output was included in the context
+- The task involves very large files
+- Multiple previous outcomes created a large context
+
+## Suggested Fix
+- Break the task into smaller, independent subtasks
+- Reduce the amount of context passed to Claude
+- Consider processing files in chunks
+
+## Relevant Output
+\`\`\`
+${relevantOutput}
+\`\`\`
+
+<promise>FAILED</promise>`;
+    }
+}
+/**
+ * Extract the most relevant portion of output for the failure report.
+ */
+function extractRelevantOutput(output, maxLines) {
+    // Remove ANSI codes
+    const cleanOutput = output.replace(/\x1b\[[0-9;]*m/g, '');
+    // Split into lines
+    const lines = cleanOutput.split('\n');
+    // If output is small enough, return all of it
+    if (lines.length <= maxLines) {
+        return cleanOutput.trim();
+    }
+    // Otherwise, take the last N lines (most relevant for failures)
+    const lastLines = lines.slice(-maxLines);
+    return `...(truncated)\n${lastLines.join('\n').trim()}`;
+}
+/**
+ * Get the path to Claude CLI.
+ */
+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.');
+    }
+}
+/**
+ * Analyze a failure using Claude (Sonnet/Haiku) and generate a structured report.
+ * Uses a fast model for cost efficiency.
+ */
+export async function analyzeFailure(output, failureReason, taskId, timeoutMs = 60000) {
+    // First check for programmatic failures
+    const programmaticType = detectProgrammaticFailure(output, failureReason);
+    if (programmaticType) {
+        return generateProgrammaticReport(programmaticType, failureReason, output);
+    }
+    // For other failures, use Claude to analyze
+    try {
+        const analysisResult = await callClaudeForAnalysis(output, failureReason, taskId, timeoutMs);
+        return analysisResult;
+    }
+    catch (error) {
+        // If analysis fails, generate a basic fallback report
+        const relevantOutput = extractRelevantOutput(output, 50);
+        return `## Failure Reason
+${failureReason}
+
+## Analysis
+Unable to perform automated analysis: ${error instanceof Error ? error.message : String(error)}
+
+## Suggested Fix
+Review the relevant output below and the task logs for more details.
+
+## Relevant Output
+\`\`\`
+${relevantOutput}
+\`\`\`
+
+<promise>FAILED</promise>`;
+    }
+}
+/**
+ * Call Claude CLI to analyze the failure.
+ * Uses the print mode with a concise prompt.
+ */
+async function callClaudeForAnalysis(output, failureReason, taskId, timeoutMs) {
+    const relevantOutput = extractRelevantOutput(output, 100);
+    const prompt = `Analyze this failed task execution and generate a brief failure report.
+
+Task ID: ${taskId}
+Initial Failure Reason: ${failureReason}
+
+Execution Output (last 100 lines):
+\`\`\`
+${relevantOutput}
+\`\`\`
+
+Respond with ONLY a markdown report in this exact format:
+
+## Failure Reason
+[One-line description of what went wrong]
+
+## Analysis
+[2-3 sentences explaining why the failure occurred]
+
+## Suggested Fix
+[1-3 bullet points with actionable steps to resolve]
+
+## Relevant Output
+\`\`\`
+[Key error messages or output that shows the failure]
+\`\`\`
+
+<promise>FAILED</promise>`;
+    return new Promise((resolve, reject) => {
+        let analysisOutput = '';
+        let stderr = '';
+        const claudePath = getClaudePath();
+        // Use haiku model for fast, cost-effective analysis
+        const proc = spawn(claudePath, [
+            '--model', 'haiku',
+            '--dangerously-skip-permissions',
+            '-p',
+            prompt,
+        ], {
+            env: process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const timeout = setTimeout(() => {
+            proc.kill('SIGTERM');
+            reject(new Error('Analysis timed out'));
+        }, timeoutMs);
+        proc.stdout.on('data', (data) => {
+            analysisOutput += data.toString();
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (exitCode) => {
+            clearTimeout(timeout);
+            if (exitCode !== 0) {
+                reject(new Error(`Analysis failed with exit code ${exitCode}: ${stderr}`));
+                return;
+            }
+            // Validate the output has the expected structure
+            if (!analysisOutput.includes('## Failure Reason') ||
+                !analysisOutput.includes('<promise>FAILED</promise>')) {
+                // If the output doesn't have the expected structure, wrap it
+                const fixedOutput = `## Failure Reason
+${failureReason}
+
+## Analysis
+${analysisOutput.trim()}
+
+## Suggested Fix
+Review the task logs for more details.
+
+## Relevant Output
+\`\`\`
+${extractRelevantOutput(output, 30)}
+\`\`\`
+
+<promise>FAILED</promise>`;
+                resolve(fixedOutput);
+                return;
+            }
+            resolve(analysisOutput.trim());
+        });
+        proc.on('error', (error) => {
+            clearTimeout(timeout);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=failure-analyzer.js.map

package/dist/core/failure-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-analyzer.js","sourceRoot":"","sources":["../../src/core/failure-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAqB9C;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,YAAY;IACZ,wBAAwB;IACxB,sBAAsB;IACtB,cAAc;IACd,qCAAqC;IACrC,sBAAsB;IACtB,8BAA8B;IAC9B,0BAA0B;IAC1B,WAAW;IACX,qBAAqB;CACtB,CAAC;AAEF,MAAM,mBAAmB,GAAG;IAC1B,aAAa;IACb,oBAAoB;IACpB,8BAA8B;IAC9B,iBAAiB;IACjB,gBAAgB;IAChB,UAAU;CACX,CAAC;AAEF,MAAM,yBAAyB,GAAG;IAChC,0BAA0B;IAC1B,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,aAAqB;IAErB,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,aAAa,EAAE,CAAC;IAE/C,6BAA6B;IAC7B,KAAK,MAAM,OAAO,IAAI,yBAAyB,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,kBAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAAoC,EACpC,cAAsB,EACtB,MAAc;IAEd,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzD,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,WAAW;YACd,OAAO;;;;;;;;;;;;;EAaX,cAAc;;;0BAGU,CAAC;QAEvB,KAAK,YAAY;YACf,OAAO;;;;;;;;;;;;;EAaX,cAAc;;;0BAGU,CAAC;QAEvB,KAAK,SAAS;YACZ,OAAO;;;;;;;;;;;;;;;;EAgBX,cAAc;;;0BAGU,CAAC;QAEvB,KAAK,kBAAkB;YACrB,OAAO;;;;;;;;;;;;;;;;EAgBX,cAAc;;;0BAGU,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,MAAc,EAAE,QAAgB;IAC7D,oBAAoB;IACpB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAE1D,mBAAmB;IACnB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,mBAAmB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,aAAqB,EACrB,MAAc,EACd,YAAoB,KAAK;IAEzB,wCAAwC;IACxC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1E,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,0BAA0B,CAAC,gBAAgB,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7F,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sDAAsD;QACtD,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzD,OAAO;EACT,aAAa;;;wCAGyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;;;;;;;EAO5F,cAAc;;;0BAGU,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAClC,MAAc,EACd,aAAqB,EACrB,MAAc,EACd,SAAiB;IAEjB,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG;;WAEN,MAAM;0BACS,aAAa;;;;EAIrC,cAAc;;;;;;;;;;;;;;;;;;;0BAmBU,CAAC;IAEzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QAEnC,oDAAoD;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE;YAC7B,SAAS,EAAE,OAAO;YAClB,gCAAgC;YAChC,IAAI;YACJ,MAAM;SACP,EAAE;YACD,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC1C,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,cAAc,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC5B,YAAY,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC3E,OAAO;YACT,CAAC;YAED,iDAAiD;YACjD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAC7C,CAAC,cAAc,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;gBAC1D,6DAA6D;gBAC7D,MAAM,WAAW,GAAG;EAC1B,aAAa;;;EAGb,cAAc,CAAC,IAAI,EAAE;;;;;;;EAOrB,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC;;;0BAGT,CAAC;gBACnB,OAAO,CAAC,WAAW,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/git.d.ts

@@ -0,0 +1,42 @@
+export interface GitStatus {
+    isRepo: boolean;
+    hasChanges: boolean;
+    branch: string | null;
+}
+/**
+ * Check if we're in a git repository.
+ */
+export declare function isGitRepo(): boolean;
+/**
+ * Get current git status.
+ */
+export declare function getGitStatus(): GitStatus;
+/**
+ * Check if there are uncommitted changes.
+ */
+export declare function hasUncommittedChanges(): boolean;
+/**
+ * Parse git status --porcelain output into a list of file paths.
+ * Format: XY filename (where X is index status, Y is working tree status)
+ * Examples:
+ *   M  file.txt     - modified, staged
+ *   MM file.txt     - modified, staged, then modified again
+ *    M file.txt     - modified, not staged
+ *   A  file.txt     - added
+ *   D  file.txt     - deleted
+ *   ?? file.txt     - untracked
+ *   R  old -> new   - renamed
+ */
+export declare function parseGitStatus(output: string): string[];
+/**
+ * Get list of currently changed files (both staged and unstaged).
+ * Returns empty array if not in a git repo.
+ */
+export declare function getChangedFiles(): string[];
+/**
+ * Stash uncommitted changes with a descriptive name.
+ * @param name - Name for the stash (e.g., "raf-001-task-3-failed")
+ * @returns true if stash was created, false otherwise
+ */
+export declare function stashChanges(name: string): boolean;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CA6BxC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAyCvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAqBlD"}

package/dist/core/git.js

@@ -0,0 +1,148 @@
+import { execSync } from 'node:child_process';
+import { logger } from '../utils/logger.js';
+/**
+ * Check if we're in a git repository.
+ */
+export function isGitRepo() {
+    try {
+        execSync('git rev-parse --is-inside-work-tree', { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get current git status.
+ */
+export function getGitStatus() {
+    const status = {
+        isRepo: false,
+        hasChanges: false,
+        branch: null,
+    };
+    try {
+        execSync('git rev-parse --is-inside-work-tree', { encoding: 'utf-8', stdio: 'pipe' });
+        status.isRepo = true;
+    }
+    catch {
+        return status;
+    }
+    try {
+        const branchOutput = execSync('git branch --show-current', { encoding: 'utf-8', stdio: 'pipe' });
+        status.branch = branchOutput.trim() || null;
+    }
+    catch {
+        // Might be in detached HEAD state
+    }
+    try {
+        const statusOutput = execSync('git status --porcelain', { encoding: 'utf-8', stdio: 'pipe' });
+        status.hasChanges = statusOutput.trim().length > 0;
+    }
+    catch {
+        // Ignore errors
+    }
+    return status;
+}
+/**
+ * Check if there are uncommitted changes.
+ */
+export function hasUncommittedChanges() {
+    try {
+        const status = execSync('git status --porcelain', { encoding: 'utf-8', stdio: 'pipe' });
+        return status.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse git status --porcelain output into a list of file paths.
+ * Format: XY filename (where X is index status, Y is working tree status)
+ * Examples:
+ *   M  file.txt     - modified, staged
+ *   MM file.txt     - modified, staged, then modified again
+ *    M file.txt     - modified, not staged
+ *   A  file.txt     - added
+ *   D  file.txt     - deleted
+ *   ?? file.txt     - untracked
+ *   R  old -> new   - renamed
+ */
+export function parseGitStatus(output) {
+    if (!output.trim()) {
+        return [];
+    }
+    const files = [];
+    // Don't trim the entire output - leading spaces are significant in git porcelain format
+    // Only split by newlines, then handle each line
+    const lines = output.split('\n');
+    for (const line of lines) {
+        if (!line || line.length < 3)
+            continue;
+        // The filename starts at position 3 (after XY and space)
+        let filePath = line.slice(3);
+        // Handle renamed files: "R  old -> new" or "R old -> new"
+        if (line[0] === 'R' || line[1] === 'R') {
+            const arrowIndex = filePath.indexOf(' -> ');
+            if (arrowIndex !== -1) {
+                filePath = filePath.slice(arrowIndex + 4);
+            }
+        }
+        // Handle copied files similarly
+        if (line[0] === 'C' || line[1] === 'C') {
+            const arrowIndex = filePath.indexOf(' -> ');
+            if (arrowIndex !== -1) {
+                filePath = filePath.slice(arrowIndex + 4);
+            }
+        }
+        // Handle quoted paths (git escapes special characters)
+        if (filePath.startsWith('"') && filePath.endsWith('"')) {
+            filePath = filePath.slice(1, -1);
+        }
+        files.push(filePath);
+    }
+    return files;
+}
+/**
+ * Get list of currently changed files (both staged and unstaged).
+ * Returns empty array if not in a git repo.
+ */
+export function getChangedFiles() {
+    if (!isGitRepo()) {
+        return [];
+    }
+    try {
+        const output = execSync('git status --porcelain', { encoding: 'utf-8', stdio: 'pipe' });
+        return parseGitStatus(output);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Stash uncommitted changes with a descriptive name.
+ * @param name - Name for the stash (e.g., "raf-001-task-3-failed")
+ * @returns true if stash was created, false otherwise
+ */
+export function stashChanges(name) {
+    if (!isGitRepo()) {
+        logger.warn('Not in a git repository, skipping stash');
+        return false;
+    }
+    if (!hasUncommittedChanges()) {
+        logger.debug('No uncommitted changes to stash');
+        return false;
+    }
+    try {
+        execSync(`git stash push -m "${name.replace(/"/g, '\\"')}"`, {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch (error) {
+        logger.error(`Failed to stash changes: ${error}`);
+        return false;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

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

package/dist/core/project-manager.d.ts

@@ -0,0 +1,72 @@
+export interface ProjectInfo {
+    number: number;
+    name: string;
+    path: string;
+    taskCount?: number;
+    completedCount?: number;
+    failedCount?: number;
+}
+export declare class ProjectManager {
+    private rafDir;
+    constructor();
+    /**
+     * Create a new project folder with initial structure.
+     * Returns the project path.
+     */
+    createProject(projectName: string): string;
+    /**
+     * Find an existing project by name.
+     */
+    findProject(projectName: string): string | null;
+    /**
+     * List all projects with derived state information.
+     */
+    listProjects(): ProjectInfo[];
+    /**
+     * Save user input to input.md.
+     */
+    saveInput(projectPath: string, content: string): void;
+    /**
+     * Read user input from input.md.
+     */
+    readInput(projectPath: string): string;
+    /**
+     * Save an outcome file for a completed task.
+     */
+    saveOutcome(projectPath: string, taskId: string, content: string): void;
+    /**
+     * Read all outcomes for context.
+     */
+    readOutcomes(projectPath: string): Array<{
+        taskId: string;
+        content: string;
+    }>;
+    /**
+     * Save a log file to the project's logs directory.
+     */
+    saveLog(projectPath: string, taskId: string, content: string): void;
+    /**
+     * Read a plan file.
+     */
+    readPlan(projectPath: string, planFile: string): string;
+    /**
+     * Get absolute path to a plan file.
+     */
+    getPlanPath(projectPath: string, planFile: string): string;
+    /**
+     * Ensure logs directory exists in project folder.
+     */
+    ensureLogsDir(projectPath: string): void;
+    /**
+     * Check if a project folder is empty (contains no plan files).
+     * Returns true if the folder has no plan files, false otherwise.
+     */
+    isProjectFolderEmpty(projectPath: string): boolean;
+    /**
+     * Clean up an empty project folder.
+     * Only removes the folder if it contains no plan files.
+     * This is idempotent - safe to call multiple times.
+     */
+    cleanupEmptyProject(projectPath: string): void;
+}
+//# sourceMappingURL=project-manager.d.ts.map

package/dist/core/project-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manager.d.ts","sourceRoot":"","sources":["../../src/core/project-manager.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;;IAMvB;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAqB1C;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAyB7B;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMrD;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQtC;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiBvE;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB7E;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAUnE;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQvD;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI1D;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOxC;;;OAGG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAiBlD;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAkB/C"}