rafcode 1.0.0

package/dist/parsers/output-parser.js

@@ -0,0 +1,137 @@
+const COMPLETE_PATTERN = /<promise>COMPLETE<\/promise>/i;
+const FAILED_PATTERN = /<promise>FAILED<\/promise>/i;
+const FAILURE_REASON_PATTERN = /Reason:\s*(.+?)(?:\n|$)/i;
+const CONTEXT_OVERFLOW_PATTERNS = [
+    /context length exceeded/i,
+    /token limit/i,
+    /maximum context/i,
+    /context window/i,
+    /too many tokens/i,
+];
+/**
+ * Parse Claude's output to determine task result.
+ */
+export function parseOutput(output) {
+    const result = {
+        result: 'unknown',
+        contextOverflow: false,
+    };
+    // Check for context overflow
+    for (const pattern of CONTEXT_OVERFLOW_PATTERNS) {
+        if (pattern.test(output)) {
+            result.contextOverflow = true;
+            break;
+        }
+    }
+    // Check for completion markers (search from the end for the last occurrence)
+    const completeMatch = output.match(COMPLETE_PATTERN);
+    const failedMatch = output.match(FAILED_PATTERN);
+    if (completeMatch && failedMatch) {
+        // Both present - use whichever appears last
+        const completeIndex = output.lastIndexOf(completeMatch[0]);
+        const failedIndex = output.lastIndexOf(failedMatch[0]);
+        if (failedIndex > completeIndex) {
+            result.result = 'failed';
+            extractFailureReason(output, result);
+        }
+        else {
+            result.result = 'complete';
+        }
+    }
+    else if (completeMatch) {
+        result.result = 'complete';
+    }
+    else if (failedMatch) {
+        result.result = 'failed';
+        extractFailureReason(output, result);
+    }
+    return result;
+}
+function extractFailureReason(output, result) {
+    const reasonMatch = output.match(FAILURE_REASON_PATTERN);
+    if (reasonMatch) {
+        result.failureReason = reasonMatch[1]?.trim();
+    }
+    else {
+        // Try to find any text after the FAILED marker
+        const failedIndex = output.lastIndexOf('<promise>FAILED</promise>');
+        if (failedIndex !== -1) {
+            const afterFailed = output.substring(failedIndex + '<promise>FAILED</promise>'.length).trim();
+            if (afterFailed) {
+                // Take first few lines as reason
+                const lines = afterFailed.split('\n').slice(0, 3);
+                result.failureReason = lines.join(' ').trim().substring(0, 500);
+            }
+        }
+    }
+    if (!result.failureReason) {
+        result.failureReason = 'Unknown failure (no reason provided)';
+    }
+}
+/**
+ * Check if output indicates a retryable failure.
+ */
+export function isRetryableFailure(parsed) {
+    // Context overflow is not retryable
+    if (parsed.contextOverflow) {
+        return false;
+    }
+    // Unknown result might be retryable
+    if (parsed.result === 'unknown') {
+        return true;
+    }
+    // Check failure reason for non-retryable patterns
+    if (parsed.result === 'failed' && parsed.failureReason) {
+        const nonRetryable = [
+            /cannot be done/i,
+            /impossible/i,
+            /not supported/i,
+            /permission denied/i,
+            /access denied/i,
+        ];
+        for (const pattern of nonRetryable) {
+            if (pattern.test(parsed.failureReason)) {
+                return false;
+            }
+        }
+        // Most failures are retryable
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract a summary from Claude's output for the outcome file.
+ */
+export function extractSummary(output) {
+    // Remove ANSI codes
+    const cleanOutput = output.replace(/\x1b\[[0-9;]*m/g, '');
+    // Try to find meaningful summary sections
+    const lines = cleanOutput.split('\n');
+    const summaryLines = [];
+    let inCodeBlock = false;
+    for (const line of lines) {
+        // Skip code blocks
+        if (line.trim().startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            continue;
+        }
+        if (inCodeBlock) {
+            continue;
+        }
+        // Skip empty lines and very short lines
+        if (line.trim().length < 5) {
+            continue;
+        }
+        // Skip lines that look like file paths or commands
+        if (line.trim().startsWith('/') || line.trim().startsWith('$')) {
+            continue;
+        }
+        summaryLines.push(line);
+        // Limit summary length
+        if (summaryLines.length >= 50) {
+            break;
+        }
+    }
+    return summaryLines.join('\n').trim() || 'No summary available.';
+}
+//# sourceMappingURL=output-parser.js.map

package/dist/parsers/output-parser.js.map

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

package/dist/prompts/amend.d.ts

@@ -0,0 +1,20 @@
+import { DerivedTask } from '../core/state-derivation.js';
+export interface AmendPromptParams {
+    projectPath: string;
+    existingTasks: Array<DerivedTask & {
+        taskName: string;
+    }>;
+    nextTaskNumber: number;
+    newTaskDescription: string;
+}
+export interface AmendPromptResult {
+    systemPrompt: string;
+    userMessage: string;
+}
+/**
+ * Generate a prompt for amending an existing project with new tasks.
+ * - systemPrompt: Amendment mode conventions, existing tasks context (via --append-system-prompt)
+ * - userMessage: Reference to input.md and new task description (via positional argument, triggers Claude to start)
+ */
+export declare function getAmendPrompt(params: AmendPromptParams): AmendPromptResult;
+//# sourceMappingURL=amend.d.ts.map

package/dist/prompts/amend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amend.d.ts","sourceRoot":"","sources":["../../src/prompts/amend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CA8K3E"}

package/dist/prompts/amend.js

@@ -0,0 +1,166 @@
+/**
+ * Generate a prompt for amending an existing project with new tasks.
+ * - systemPrompt: Amendment mode conventions, existing tasks context (via --append-system-prompt)
+ * - userMessage: Reference to input.md and new task description (via positional argument, triggers Claude to start)
+ */
+export function getAmendPrompt(params) {
+    const { projectPath, existingTasks, nextTaskNumber, newTaskDescription, } = params;
+    const existingTasksSummary = existingTasks
+        .map((task) => {
+        const status = task.status === 'completed'
+            ? '[COMPLETED]'
+            : task.status === 'failed'
+                ? '[FAILED]'
+                : '[PENDING]';
+        const modifiability = task.status === 'completed' ? '[PROTECTED]' : '[MODIFIABLE]';
+        return `- Task ${task.id}: ${task.taskName} ${status} ${modifiability}`;
+    })
+        .join('\n');
+    const protectedTasks = existingTasks.filter((t) => t.status === 'completed');
+    const modifiableTasks = existingTasks.filter((t) => t.status !== 'completed');
+    const protectedTasksList = protectedTasks.length > 0
+        ? protectedTasks.map((t) => `- Task ${t.id}: ${t.taskName}`).join('\n')
+        : '(none)';
+    const modifiableTasksList = modifiableTasks.length > 0
+        ? modifiableTasks.map((t) => `- Task ${t.id}: ${t.taskName}`).join('\n')
+        : '(none)';
+    const systemPrompt = `You are a project planning assistant for RAF (Ralph's Automation Framework). Your task is to ADD NEW TASKS or MODIFY PENDING tasks in an existing project.
+
+## IMPORTANT: Amendment Mode
+
+You are in AMENDMENT MODE. This means:
+- You MAY modify [MODIFIABLE] tasks (pending/failed) if the user requests changes
+- NEVER modify [PROTECTED] tasks (completed) - their outcomes depend on the original plan
+- DO NOT renumber existing tasks
+- You can create NEW tasks starting from number ${nextTaskNumber.toString().padStart(3, '0')}
+
+## Project Location
+
+Project folder: ${projectPath}
+
+## Existing Tasks
+
+The following tasks already exist in this project:
+
+${existingTasksSummary}
+
+### Protected Tasks (COMPLETED - cannot be modified)
+${protectedTasksList}
+
+### Modifiable Tasks (PENDING/FAILED - can be modified if requested)
+${modifiableTasksList}
+
+## Instructions
+
+### Step 1: Read Context
+
+First, read the original project description from:
+- ${projectPath}/input.md
+
+And review existing decisions from:
+- ${projectPath}/decisions.md (if it exists)
+
+### Step 2: Analyze New Requirements
+
+Read the user's description of new tasks and identify what needs to be added. Consider:
+- How the new tasks relate to existing ones
+- Dependencies on completed tasks (check the ## Dependencies section in existing plan files)
+- Whether new tasks should reference existing task outcomes
+
+### Step 3: Interview the User
+
+For EACH new task you identify, use the AskUserQuestion tool to gather:
+- Specific requirements and constraints
+- Technology preferences
+- Any existing code or patterns to follow
+- Edge cases to handle
+
+### Step 3.5: Record Decisions
+
+After EACH interview question is answered, append the Q&A pair to the existing decisions file:
+- ${projectPath}/decisions.md
+
+Use this format:
+\`\`\`markdown
+## [Amendment] [Question asked]
+[User's answer]
+\`\`\`
+
+### Step 4: Create New Plan Files
+
+After interviewing the user about all NEW tasks, create plan files starting from the next available number:
+- ${projectPath}/plans/${nextTaskNumber.toString().padStart(3, '0')}-task-name.md
+- ${projectPath}/plans/${(nextTaskNumber + 1).toString().padStart(3, '0')}-task-name.md
+- etc.
+
+Each plan file should follow this structure:
+
+\`\`\`markdown
+# Task: [Task Name]
+
+## Objective
+[Clear, one-sentence description of what this task accomplishes]
+
+## Context
+[Why this task is needed, how it fits into the larger project]
+[Reference relevant existing tasks if applicable]
+
+## Dependencies
+[Optional section - omit if task has no dependencies]
+[Comma-separated list of task IDs this task depends on, e.g., "001, 002"]
+[If a dependency fails, this task will be automatically blocked]
+
+## Requirements
+[Specific requirements gathered from the user interview]
+- Requirement 1
+- Requirement 2
+- ...
+
+## Implementation Steps
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+...
+
+## Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] All tests pass
+
+## Notes
+[Any additional context, warnings, or considerations]
+[Reference to existing task outcomes if relevant]
+\`\`\`
+
+### Step 5: Confirm Completion
+
+After creating all new plan files:
+1. Provide a summary of:
+   - The new tasks you've created
+   - How they relate to existing tasks
+   - Total task count in the project
+2. Display this exit message to the user:
+
+\`\`\`
+Planning complete! Press Ctrl-C twice to exit to exit this session 
+\`\`\`
+
+## Important Rules
+
+1. NEVER modify COMPLETED task plans - they are [PROTECTED] because their outcomes depend on the original plan
+2. You MAY modify non-completed task plans (pending/failed) if the user requests changes - they are [MODIFIABLE]
+3. ALWAYS interview the user before creating or modifying plans
+4. New tasks start from number ${nextTaskNumber.toString().padStart(3, '0')}
+5. Use descriptive, kebab-case names for plan files
+6. Each plan should be self-contained with all context needed
+7. Specify task dependencies using the ## Dependencies section with task IDs only (e.g., "001, 002")
+8. Tasks without dependencies should omit the Dependencies section entirely
+9. Be specific - vague plans lead to poor execution`;
+    const userMessage = `I want to add the following new tasks to this project:
+
+${newTaskDescription}
+
+Please analyze this and start the planning interview for the new tasks.`;
+    return { systemPrompt, userMessage };
+}
+//# sourceMappingURL=amend.js.map

package/dist/prompts/amend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amend.js","sourceRoot":"","sources":["../../src/prompts/amend.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,MAAM,EACJ,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,GAAG,MAAM,CAAC;IAEX,MAAM,oBAAoB,GAAG,aAAa;SACvC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,KAAK,WAAW;YACzB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ;gBACxB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,WAAW,CAAC;QACpB,MAAM,aAAa,GACjB,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/D,OAAO,UAAU,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,aAAa,EAAE,CAAC;IAC1E,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IAE9E,MAAM,kBAAkB,GACtB,cAAc,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvE,CAAC,CAAC,QAAQ,CAAC;IACf,MAAM,mBAAmB,GACvB,eAAe,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACxE,CAAC,CAAC,QAAQ,CAAC;IAEf,MAAM,YAAY,GAAG;;;;;;;;kDAQ2B,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;;;;kBAI1E,WAAW;;;;;;EAM3B,oBAAoB;;;EAGpB,kBAAkB;;;EAGlB,mBAAmB;;;;;;;IAOjB,WAAW;;;IAGX,WAAW;;;;;;;;;;;;;;;;;;;;IAoBX,WAAW;;;;;;;;;;;IAWX,WAAW,UAAU,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;IAC/D,WAAW,UAAU,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA4DxC,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;;;;;oDAKvB,CAAC;IAEnD,MAAM,WAAW,GAAG;;EAEpB,kBAAkB;;wEAEoD,CAAC;IAEvE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/dist/prompts/execution.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Summarize an outcome for dependency context.
+ * Extracts the key sections (Summary, Key Changes, Notes) and truncates if needed.
+ */
+export declare function summarizeOutcome(content: string): string;
+export interface ExecutionPromptParams {
+    projectPath: string;
+    planPath: string;
+    taskId: string;
+    taskNumber: number;
+    totalTasks: number;
+    previousOutcomes: Array<{
+        taskId: string;
+        content: string;
+    }>;
+    autoCommit: boolean;
+    projectNumber: string;
+    outcomeFilePath: string;
+    attemptNumber?: number;
+    previousOutcomeFile?: string;
+    /** Task IDs that this task depends on */
+    dependencyIds?: string[];
+    /** Outcomes of dependency tasks, keyed by task ID */
+    dependencyOutcomes?: Array<{
+        taskId: string;
+        content: string;
+    }>;
+}
+export declare function getExecutionPrompt(params: ExecutionPromptParams): string;
+//# sourceMappingURL=execution.d.ts.map

package/dist/prompts/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/prompts/execution.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAqKxE"}

package/dist/prompts/execution.js

@@ -0,0 +1,179 @@
+/**
+ * Maximum characters for a dependency outcome summary.
+ * Outcomes larger than this will be truncated to avoid context bloat.
+ */
+const MAX_DEPENDENCY_OUTCOME_CHARS = 4000;
+/**
+ * Summarize an outcome for dependency context.
+ * Extracts the key sections (Summary, Key Changes, Notes) and truncates if needed.
+ */
+export function summarizeOutcome(content) {
+    // If content is small enough, return as-is
+    if (content.length <= MAX_DEPENDENCY_OUTCOME_CHARS) {
+        return content;
+    }
+    // Try to extract just the Summary section
+    const summaryMatch = content.match(/^## Summary\s*\n([\s\S]*?)(?=\n## |$)/m);
+    if (summaryMatch && summaryMatch[1]) {
+        const summary = summaryMatch[1].trim();
+        if (summary.length > 0 && summary.length <= MAX_DEPENDENCY_OUTCOME_CHARS) {
+            return `## Summary\n\n${summary}\n\n*[Outcome truncated for context size]*`;
+        }
+    }
+    // Fallback: truncate the full content
+    const truncated = content.substring(0, MAX_DEPENDENCY_OUTCOME_CHARS);
+    // Find a good break point (newline or period)
+    const lastNewline = truncated.lastIndexOf('\n');
+    const lastPeriod = truncated.lastIndexOf('. ');
+    const breakPoint = Math.max(lastNewline, lastPeriod);
+    if (breakPoint > MAX_DEPENDENCY_OUTCOME_CHARS / 2) {
+        return truncated.substring(0, breakPoint + 1) + '\n\n*[Outcome truncated for context size]*';
+    }
+    return truncated + '\n\n*[Outcome truncated for context size]*';
+}
+export function getExecutionPrompt(params) {
+    const { projectPath, planPath, taskId, taskNumber, totalTasks, previousOutcomes, autoCommit, projectNumber, outcomeFilePath, attemptNumber = 1, previousOutcomeFile, dependencyIds = [], dependencyOutcomes = [], } = params;
+    let outcomesSection = '';
+    if (previousOutcomes.length > 0) {
+        outcomesSection = `
+## Previous Task Outcomes
+
+The following tasks have already been completed. Review them for context and to avoid duplication:
+
+${previousOutcomes.map((o) => `### Task ${o.taskId}\n${o.content}`).join('\n\n')}
+`;
+    }
+    // Zero-pad task number to 3 digits
+    const paddedTaskNumber = taskNumber.toString().padStart(3, '0');
+    const commitInstructions = autoCommit
+        ? `
+## Git Instructions
+
+After successfully completing the task:
+1. Stage all changes with \`git add -A\`
+   - This includes any new plan files in the \`plans/\` folder
+2. Commit with message: "RAF[${projectNumber}:${paddedTaskNumber}] <description>"
+   - Write a concise description of what was accomplished
+   - Focus on the actual change, not the task name
+
+**IMPORTANT - On Failure**: If the task fails, do NOT commit. Just write the outcome file with the \`<promise>FAILED</promise>\` marker and stop. Uncommitted changes will be preserved for debugging.
+`
+        : '';
+    // Generate retry context section for attempt 2+
+    let retryContextSection = '';
+    if (attemptNumber > 1 && previousOutcomeFile) {
+        retryContextSection = `
+## Retry Context
+
+This is attempt ${attemptNumber} at executing this task. The previous attempt produced an outcome file that you should review before starting.
+
+**Previous outcome file**: ${previousOutcomeFile}
+
+Please:
+1. Read the previous outcome file first
+2. Understand what was attempted and why it failed
+3. Account for the previous failure in your approach
+4. Avoid making the same mistakes
+`;
+    }
+    // Generate dependency context section if task has dependencies
+    let dependencyContextSection = '';
+    if (dependencyIds.length > 0 && dependencyOutcomes.length > 0) {
+        const depOutcomesFormatted = dependencyOutcomes.map((o) => {
+            const summarized = summarizeOutcome(o.content);
+            return `### Task ${o.taskId}\n${summarized}`;
+        }).join('\n\n');
+        dependencyContextSection = `
+## Dependency Context
+
+This task depends on the following completed tasks. Review their outcomes to understand what was accomplished and build upon their work:
+
+**Dependencies**: ${dependencyIds.join(', ')}
+
+${depOutcomesFormatted}
+`;
+    }
+    return `You are executing a planned task for RAF (Ralph's Automation Framework).
+
+## Task Information
+
+- Task: ${taskNumber} of ${totalTasks}
+- Task ID: ${taskId}
+- Project folder: ${projectPath}
+
+## Your Mission
+
+1. Read the plan file at: ${planPath}
+2. Execute the task according to the plan
+3. Verify all acceptance criteria are met
+4. Signal completion with the appropriate marker
+
+## Instructions
+${retryContextSection}
+### Step 1: Read the Plan
+
+First, read the plan file to understand exactly what needs to be done.
+
+### Step 2: Execute the Task
+
+Follow the implementation steps in the plan. Key guidelines:
+- Write clean, maintainable code
+- Follow existing code patterns in the project
+- Add appropriate error handling
+- Write tests if specified in the plan
+- Follow any CLAUDE.md instructions if present
+${dependencyContextSection}${outcomesSection}
+### Step 3: Verify Completion
+
+Before marking the task complete:
+- Check all acceptance criteria from the plan
+- Run any relevant tests
+- Ensure no regressions were introduced
+${commitInstructions}
+### Step 4: Write Outcome File
+
+**CRITICAL**: You MUST write an outcome file to document what was accomplished.
+
+**Outcome file path**: \`${outcomeFilePath}\`
+
+The outcome file should contain:
+1. A summary of what was done
+2. Key changes made (files modified, features added, etc.)
+3. Any important notes or follow-up items
+4. The completion marker as the LAST line
+
+**For code tasks**: Summarize what was changed and why
+**For documentation/report tasks**: The outcome IS the deliverable - include the full content
+
+**CRITICAL**: The outcome file MUST end with one of these markers:
+
+If the task was completed successfully, end the file with:
+\`\`\`
+<promise>COMPLETE</promise>
+\`\`\`
+
+If the task failed and cannot be completed, end the file with:
+\`\`\`
+<promise>FAILED</promise>
+Reason: [explain why the task failed]
+\`\`\`
+
+## Important Rules
+
+1. ALWAYS read the plan file first
+2. Follow the plan precisely
+3. Do not skip any acceptance criteria
+4. If you encounter blockers, try to resolve them
+5. The outcome file MUST contain EXACTLY ONE completion marker
+6. The completion marker MUST be the LAST line in the outcome file
+7. On SUCCESS: Commit code changes AND outcome file together BEFORE you finish
+8. On FAILURE: Do NOT commit - just write the outcome file with FAILED marker
+
+## Error Handling
+
+If you encounter errors:
+- Try to fix them yourself first
+- If an error prevents completion, write the outcome file with FAILED status and a clear reason
+- Do not mark COMPLETE if there are failing tests or unmet criteria`;
+}
+//# sourceMappingURL=execution.js.map

package/dist/prompts/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/prompts/execution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,2CAA2C;IAC3C,IAAI,OAAO,CAAC,MAAM,IAAI,4BAA4B,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0CAA0C;IAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC7E,IAAI,YAAY,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,4BAA4B,EAAE,CAAC;YACzE,OAAO,iBAAiB,OAAO,4CAA4C,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;IACrE,8CAA8C;IAC9C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,UAAU,GAAG,4BAA4B,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,4CAA4C,CAAC;IAC/F,CAAC;IAED,OAAO,SAAS,GAAG,4CAA4C,CAAC;AAClE,CAAC;AAoBD,MAAM,UAAU,kBAAkB,CAAC,MAA6B;IAC9D,MAAM,EACJ,WAAW,EACX,QAAQ,EACR,MAAM,EACN,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,GAAG,CAAC,EACjB,mBAAmB,EACnB,aAAa,GAAG,EAAE,EAClB,kBAAkB,GAAG,EAAE,GACxB,GAAG,MAAM,CAAC;IAEX,IAAI,eAAe,GAAG,EAAE,CAAC;IACzB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,eAAe,GAAG;;;;;EAKpB,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;CAC/E,CAAC;IACA,CAAC;IAED,mCAAmC;IACnC,MAAM,gBAAgB,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEhE,MAAM,kBAAkB,GAAG,UAAU;QACnC,CAAC,CAAC;;;;;;+BAMyB,aAAa,IAAI,gBAAgB;;;;;CAK/D;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,gDAAgD;IAChD,IAAI,mBAAmB,GAAG,EAAE,CAAC;IAC7B,IAAI,aAAa,GAAG,CAAC,IAAI,mBAAmB,EAAE,CAAC;QAC7C,mBAAmB,GAAG;;;kBAGR,aAAa;;6BAEF,mBAAmB;;;;;;;CAO/C,CAAC;IACA,CAAC;IAED,+DAA+D;IAC/D,IAAI,wBAAwB,GAAG,EAAE,CAAC;IAClC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACxD,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,YAAY,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,wBAAwB,GAAG;;;;;oBAKX,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;;EAE1C,oBAAoB;CACrB,CAAC;IACA,CAAC;IAED,OAAO;;;;UAIC,UAAU,OAAO,UAAU;aACxB,MAAM;oBACC,WAAW;;;;4BAIH,QAAQ;;;;;;EAMlC,mBAAmB;;;;;;;;;;;;;EAanB,wBAAwB,GAAG,eAAe;;;;;;;EAO1C,kBAAkB;;;;;2BAKO,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAwC0B,CAAC;AACrE,CAAC"}

package/dist/prompts/planning.d.ts

@@ -0,0 +1,15 @@
+export interface PlanningPromptParams {
+    projectPath: string;
+    inputContent: string;
+}
+export interface PlanningPromptResult {
+    systemPrompt: string;
+    userMessage: string;
+}
+/**
+ * Generate the planning prompt with system instructions and user message separated.
+ * - systemPrompt: RAF planning conventions, file structure, interview process (via --append-system-prompt)
+ * - userMessage: Reference to input.md file (via positional argument, triggers Claude to start)
+ */
+export declare function getPlanningPrompt(params: PlanningPromptParams): PlanningPromptResult;
+//# sourceMappingURL=planning.d.ts.map

package/dist/prompts/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/prompts/planning.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CA+JpF"}