ghcralph 0.1.0

package/dist/core/prompt-examples.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Prompt Examples
+ *
+ * Provides concrete examples of ACTION blocks for weaker models.
+ * The original Ralph pattern was designed for Claude's strong instruction-following.
+ * For weaker models (like gpt-4.1), explicit examples help ensure correct output format.
+ */
+/**
+ * Example of ACTION:CREATE block
+ */
+export declare const CREATE_EXAMPLE = "[ACTION:CREATE]\npath: src/calculator.sh\n```bash\n#!/bin/bash\n# Simple calculator\n\nnum1=$1\nop=$2\nnum2=$3\n\ncase $op in\n    \"+\") echo $((num1 + num2)) ;;\n    \"-\") echo $((num1 - num2)) ;;\n    \"*\") echo $((num1 * num2)) ;;\n    \"/\") echo $((num1 / num2)) ;;\nesac\n```";
+/**
+ * Example of ACTION:EDIT block
+ */
+export declare const EDIT_EXAMPLE = "[ACTION:EDIT]\npath: src/calculator.sh\n[OLD]\ncase $op in\n    \"+\") echo $((num1 + num2)) ;;\nesac\n[NEW]\ncase $op in\n    \"+\") echo $((num1 + num2)) ;;\n    \"-\") echo $((num1 - num2)) ;;\nesac";
+/**
+ * Example of ACTION:DELETE block
+ */
+export declare const DELETE_EXAMPLE = "[ACTION:DELETE]\npath: src/old-file.ts";
+/**
+ * Example of ACTION:EXECUTE block
+ */
+export declare const EXECUTE_EXAMPLE = "[ACTION:EXECUTE]\ncommand: npm test";
+/**
+ * Example of ACTION:COMPLETE block
+ */
+export declare const COMPLETE_EXAMPLE = "[ACTION:COMPLETE]\nreason: All tests pass. Calculator implements addition, subtraction, multiplication, and division.";
+/**
+ * All examples combined for inclusion in prompts
+ */
+export declare const ALL_EXAMPLES = "\n### Example: Create a new file\n[ACTION:CREATE]\npath: src/calculator.sh\n```bash\n#!/bin/bash\n# Simple calculator\n\nnum1=$1\nop=$2\nnum2=$3\n\ncase $op in\n    \"+\") echo $((num1 + num2)) ;;\n    \"-\") echo $((num1 - num2)) ;;\n    \"*\") echo $((num1 * num2)) ;;\n    \"/\") echo $((num1 / num2)) ;;\nesac\n```\n\n### Example: Edit an existing file\n[ACTION:EDIT]\npath: src/calculator.sh\n[OLD]\ncase $op in\n    \"+\") echo $((num1 + num2)) ;;\nesac\n[NEW]\ncase $op in\n    \"+\") echo $((num1 + num2)) ;;\n    \"-\") echo $((num1 - num2)) ;;\nesac\n\n### Example: Run a command to test\n[ACTION:EXECUTE]\ncommand: npm test\n\n### Example: Mark task complete\n[ACTION:COMPLETE]\nreason: All tests pass. Calculator implements addition, subtraction, multiplication, and division.\n";
+/**
+ * Minimal examples (for context-constrained situations)
+ */
+export declare const MINIMAL_EXAMPLES = "\nExample CREATE:\n[ACTION:CREATE]\npath: file.sh\n```bash\n#!/bin/bash\necho \"Hello\"\n```\n\nExample EDIT:\n[ACTION:EDIT]\npath: file.sh\n[OLD]\necho \"Hello\"\n[NEW]\necho \"Hello World\"\n\nExample EXECUTE:\n[ACTION:EXECUTE]\ncommand: ./file.sh\n\nExample COMPLETE:\n[ACTION:COMPLETE]\nreason: Task done, tests pass\n";
+/**
+ * Format instructions for ACTION blocks
+ */
+export declare const FORMAT_INSTRUCTIONS = "## Output Format\n\nYou MUST respond using ONLY structured ACTION blocks. DO NOT write prose explanations.\n\nAvailable actions:\n\n**[ACTION:CREATE]** - Create a new file\n```\n[ACTION:CREATE]\npath: <relative file path>\n```<language>\n<file content>\n```\n```\n\n**[ACTION:EDIT]** - Modify an existing file  \n```\n[ACTION:EDIT]\npath: <relative file path>\n[OLD]\n<exact text to find>\n[NEW]\n<replacement text>\n```\n\n**[ACTION:EXECUTE]** - Run a shell command\n```\n[ACTION:EXECUTE]\ncommand: <shell command>\n```\n\n**[ACTION:COMPLETE]** - Mark task as done (only when tests pass!)\n```\n[ACTION:COMPLETE]\nreason: <brief explanation of why task is complete>\n```\n\n## Important Rules\n1. Use EXACT text for [OLD] blocks - must match file contents precisely\n2. Use [ACTION:EXECUTE] to run tests before marking complete\n3. Only use [ACTION:COMPLETE] when verification passes\n4. One action per block - you can include multiple blocks\n";
+/**
+ * Get prompt examples based on model strength
+ */
+export declare function getPromptExamples(modelStrength: 'strong' | 'medium' | 'weak'): string;
+/**
+ * Map model names to strength levels
+ */
+export declare function getModelStrength(model: string): 'strong' | 'medium' | 'weak';
+/**
+ * Get appropriate examples for a specific model
+ */
+export declare function getExamplesForModel(model: string): string;
+//# sourceMappingURL=prompt-examples.d.ts.map

package/dist/core/prompt-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-examples.d.ts","sourceRoot":"","sources":["../../src/core/prompt-examples.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,iSAgBpB,CAAC;AAER;;GAEG;AACH,eAAO,MAAM,YAAY,8MAUpB,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,cAAc,2CACL,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,eAAe,wCACV,CAAC;AAEnB;;GAEG;AACH,eAAO,MAAM,gBAAgB,0HACsE,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,YAAY,2xBAYxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,uUAwB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,s7BA0C/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAcrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAyB5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/core/prompt-examples.js

@@ -0,0 +1,194 @@
+/**
+ * Prompt Examples
+ *
+ * Provides concrete examples of ACTION blocks for weaker models.
+ * The original Ralph pattern was designed for Claude's strong instruction-following.
+ * For weaker models (like gpt-4.1), explicit examples help ensure correct output format.
+ */
+/**
+ * Example of ACTION:CREATE block
+ */
+export const CREATE_EXAMPLE = `[ACTION:CREATE]
+path: src/calculator.sh
+\`\`\`bash
+#!/bin/bash
+# Simple calculator
+
+num1=$1
+op=$2
+num2=$3
+
+case $op in
+    "+") echo $((num1 + num2)) ;;
+    "-") echo $((num1 - num2)) ;;
+    "*") echo $((num1 * num2)) ;;
+    "/") echo $((num1 / num2)) ;;
+esac
+\`\`\``;
+/**
+ * Example of ACTION:EDIT block
+ */
+export const EDIT_EXAMPLE = `[ACTION:EDIT]
+path: src/calculator.sh
+[OLD]
+case $op in
+    "+") echo $((num1 + num2)) ;;
+esac
+[NEW]
+case $op in
+    "+") echo $((num1 + num2)) ;;
+    "-") echo $((num1 - num2)) ;;
+esac`;
+/**
+ * Example of ACTION:DELETE block
+ */
+export const DELETE_EXAMPLE = `[ACTION:DELETE]
+path: src/old-file.ts`;
+/**
+ * Example of ACTION:EXECUTE block
+ */
+export const EXECUTE_EXAMPLE = `[ACTION:EXECUTE]
+command: npm test`;
+/**
+ * Example of ACTION:COMPLETE block
+ */
+export const COMPLETE_EXAMPLE = `[ACTION:COMPLETE]
+reason: All tests pass. Calculator implements addition, subtraction, multiplication, and division.`;
+/**
+ * All examples combined for inclusion in prompts
+ */
+export const ALL_EXAMPLES = `
+### Example: Create a new file
+${CREATE_EXAMPLE}
+
+### Example: Edit an existing file
+${EDIT_EXAMPLE}
+
+### Example: Run a command to test
+${EXECUTE_EXAMPLE}
+
+### Example: Mark task complete
+${COMPLETE_EXAMPLE}
+`;
+/**
+ * Minimal examples (for context-constrained situations)
+ */
+export const MINIMAL_EXAMPLES = `
+Example CREATE:
+[ACTION:CREATE]
+path: file.sh
+\`\`\`bash
+#!/bin/bash
+echo "Hello"
+\`\`\`
+
+Example EDIT:
+[ACTION:EDIT]
+path: file.sh
+[OLD]
+echo "Hello"
+[NEW]
+echo "Hello World"
+
+Example EXECUTE:
+[ACTION:EXECUTE]
+command: ./file.sh
+
+Example COMPLETE:
+[ACTION:COMPLETE]
+reason: Task done, tests pass
+`;
+/**
+ * Format instructions for ACTION blocks
+ */
+export const FORMAT_INSTRUCTIONS = `## Output Format
+
+You MUST respond using ONLY structured ACTION blocks. DO NOT write prose explanations.
+
+Available actions:
+
+**[ACTION:CREATE]** - Create a new file
+\`\`\`
+[ACTION:CREATE]
+path: <relative file path>
+\`\`\`<language>
+<file content>
+\`\`\`
+\`\`\`
+
+**[ACTION:EDIT]** - Modify an existing file  
+\`\`\`
+[ACTION:EDIT]
+path: <relative file path>
+[OLD]
+<exact text to find>
+[NEW]
+<replacement text>
+\`\`\`
+
+**[ACTION:EXECUTE]** - Run a shell command
+\`\`\`
+[ACTION:EXECUTE]
+command: <shell command>
+\`\`\`
+
+**[ACTION:COMPLETE]** - Mark task as done (only when tests pass!)
+\`\`\`
+[ACTION:COMPLETE]
+reason: <brief explanation of why task is complete>
+\`\`\`
+
+## Important Rules
+1. Use EXACT text for [OLD] blocks - must match file contents precisely
+2. Use [ACTION:EXECUTE] to run tests before marking complete
+3. Only use [ACTION:COMPLETE] when verification passes
+4. One action per block - you can include multiple blocks
+`;
+/**
+ * Get prompt examples based on model strength
+ */
+export function getPromptExamples(modelStrength) {
+    switch (modelStrength) {
+        case 'strong':
+            // Strong models (Claude, GPT-4o) need minimal examples
+            return FORMAT_INSTRUCTIONS;
+        case 'medium':
+            // Medium models need format + minimal examples
+            return FORMAT_INSTRUCTIONS + '\n\n## Examples\n' + MINIMAL_EXAMPLES;
+        case 'weak':
+            // Weak models (gpt-4.1, smaller models) need full examples
+            return FORMAT_INSTRUCTIONS + '\n\n## Detailed Examples\n' + ALL_EXAMPLES;
+        default:
+            return FORMAT_INSTRUCTIONS;
+    }
+}
+/**
+ * Map model names to strength levels
+ */
+export function getModelStrength(model) {
+    const normalized = model.toLowerCase();
+    // Strong models - excellent instruction following
+    if (normalized.includes('claude') ||
+        normalized.includes('gpt-4o') ||
+        normalized.includes('gpt-5') ||
+        normalized.includes('sonnet') ||
+        normalized.includes('opus')) {
+        return 'strong';
+    }
+    // Medium models - good but benefit from examples
+    if (normalized.includes('gpt-4-turbo') ||
+        normalized.includes('gemini')) {
+        return 'medium';
+    }
+    // Weak models - need explicit examples
+    // Includes gpt-4.1 (default due to 0x cost), gpt-3.5, smaller models
+    return 'weak';
+}
+/**
+ * Get appropriate examples for a specific model
+ */
+export function getExamplesForModel(model) {
+    const strength = getModelStrength(model);
+    return getPromptExamples(strength);
+}
+//# sourceMappingURL=prompt-examples.js.map

package/dist/core/prompt-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-examples.js","sourceRoot":"","sources":["../../src/core/prompt-examples.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;OAgBvB,CAAC;AAER;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;KAUvB,CAAC;AAEN;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;sBACR,CAAC;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;kBACb,CAAC;AAEnB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;mGACmE,CAAC;AAEpG;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;EAE1B,cAAc;;;EAGd,YAAY;;;EAGZ,eAAe;;;EAGf,gBAAgB;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwB/B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ClC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAA2C;IAC3E,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,uDAAuD;YACvD,OAAO,mBAAmB,CAAC;QAC7B,KAAK,QAAQ;YACX,+CAA+C;YAC/C,OAAO,mBAAmB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;QACtE,KAAK,MAAM;YACT,2DAA2D;YAC3D,OAAO,mBAAmB,GAAG,4BAA4B,GAAG,YAAY,CAAC;QAC3E;YACE,OAAO,mBAAmB,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,kDAAkD;IAClD,IACE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC3B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iDAAiD;IACjD,IACE,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAClC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC7B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,uCAAuC;IACvC,qEAAqE;IACrE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/core/response-parser.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Response Parser
+ *
+ * Parses AI responses to extract structured actions.
+ * This is a core component of the Ralph pattern - the AI outputs
+ * structured actions that we parse and execute.
+ */
+/**
+ * Action types that the AI can request
+ */
+export type ActionType = 'CREATE' | 'EDIT' | 'DELETE' | 'EXECUTE' | 'COMPLETE';
+/**
+ * Base action interface
+ */
+export interface BaseAction {
+    type: ActionType;
+    raw: string;
+}
+/**
+ * Create a new file
+ */
+export interface CreateAction extends BaseAction {
+    type: 'CREATE';
+    path: string;
+    content: string;
+}
+/**
+ * Edit an existing file
+ */
+export interface EditAction extends BaseAction {
+    type: 'EDIT';
+    path: string;
+    oldContent: string;
+    newContent: string;
+}
+/**
+ * Delete a file
+ */
+export interface DeleteAction extends BaseAction {
+    type: 'DELETE';
+    path: string;
+}
+/**
+ * Execute a shell command
+ */
+export interface ExecuteAction extends BaseAction {
+    type: 'EXECUTE';
+    command: string;
+}
+/**
+ * Mark task as complete
+ */
+export interface CompleteAction extends BaseAction {
+    type: 'COMPLETE';
+    reason: string;
+}
+/**
+ * Union type of all actions
+ */
+export type Action = CreateAction | EditAction | DeleteAction | ExecuteAction | CompleteAction;
+/**
+ * Result of parsing a response
+ */
+export interface ParseResult {
+    /** Successfully parsed actions */
+    actions: Action[];
+    /** Any parsing errors or warnings */
+    errors: string[];
+    /** Whether response contained any valid action blocks */
+    hasActions: boolean;
+    /** Raw text outside of action blocks (for logging/debugging) */
+    freeText: string;
+}
+/**
+ * Parse an AI response to extract structured actions
+ */
+export declare function parseResponse(response: string): ParseResult;
+/**
+ * Check if a response contains a COMPLETE action
+ */
+export declare function hasCompleteAction(result: ParseResult): boolean;
+/**
+ * Get the COMPLETE action if present
+ */
+export declare function getCompleteAction(result: ParseResult): CompleteAction | null;
+/**
+ * Filter actions by type
+ */
+export declare function getActionsByType<T extends Action>(result: ParseResult, type: T['type']): T[];
+//# sourceMappingURL=response-parser.d.ts.map

package/dist/core/response-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parser.d.ts","sourceRoot":"","sources":["../../src/core/response-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA8C3D;AAqJD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,CAG5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GACd,CAAC,EAAE,CAEL"}

package/dist/core/response-parser.js

@@ -0,0 +1,209 @@
+/**
+ * Response Parser
+ *
+ * Parses AI responses to extract structured actions.
+ * This is a core component of the Ralph pattern - the AI outputs
+ * structured actions that we parse and execute.
+ */
+/**
+ * Action block pattern - matches [ACTION:TYPE] blocks
+ */
+const ACTION_BLOCK_PATTERN = /\[ACTION:(CREATE|EDIT|DELETE|EXECUTE|COMPLETE)\]([\s\S]*?)(?=\[ACTION:|$)/gi;
+/**
+ * Parse an AI response to extract structured actions
+ */
+export function parseResponse(response) {
+    const actions = [];
+    const errors = [];
+    let freeText = response;
+    // Find all action blocks
+    const matches = [...response.matchAll(ACTION_BLOCK_PATTERN)];
+    if (matches.length === 0) {
+        return {
+            actions: [],
+            errors: ['No action blocks found in response'],
+            hasActions: false,
+            freeText: response.trim(),
+        };
+    }
+    for (const match of matches) {
+        const actionTypeStr = match[1];
+        const actionBodyStr = match[2];
+        if (!actionTypeStr || !actionBodyStr)
+            continue;
+        const actionType = actionTypeStr.toUpperCase();
+        const actionBody = actionBodyStr.trim();
+        const raw = match[0];
+        // Remove this block from freeText
+        freeText = freeText.replace(raw, '');
+        try {
+            const action = parseActionBody(actionType, actionBody, raw);
+            if (action) {
+                actions.push(action);
+            }
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            errors.push(`Failed to parse ${actionType} action: ${errorMsg}`);
+        }
+    }
+    return {
+        actions,
+        errors,
+        hasActions: actions.length > 0,
+        freeText: freeText.trim(),
+    };
+}
+/**
+ * Parse the body of an action block based on its type
+ */
+function parseActionBody(type, body, raw) {
+    switch (type) {
+        case 'CREATE':
+            return parseCreateAction(body, raw);
+        case 'EDIT':
+            return parseEditAction(body, raw);
+        case 'DELETE':
+            return parseDeleteAction(body, raw);
+        case 'EXECUTE':
+            return parseExecuteAction(body, raw);
+        case 'COMPLETE':
+            return parseCompleteAction(body, raw);
+        default:
+            return null;
+    }
+}
+/**
+ * Parse a CREATE action
+ * Expected format:
+ * path: relative/path/to/file
+ * ```
+ * file content
+ * ```
+ */
+function parseCreateAction(body, raw) {
+    // Extract path
+    const pathMatch = body.match(/^path:\s*(.+)$/m);
+    if (!pathMatch?.[1]) {
+        throw new Error('Missing path field');
+    }
+    const filePath = pathMatch[1].trim();
+    // Extract content from code block
+    const contentMatch = body.match(/```(?:\w*\n)?([\s\S]*?)```/);
+    if (!contentMatch?.[1]) {
+        throw new Error('Missing content code block');
+    }
+    const content = contentMatch[1];
+    return {
+        type: 'CREATE',
+        path: filePath,
+        content,
+        raw,
+    };
+}
+/**
+ * Parse an EDIT action
+ * Expected format:
+ * path: relative/path/to/file
+ * [OLD]
+ * old content
+ * [NEW]
+ * new content
+ */
+function parseEditAction(body, raw) {
+    // Extract path
+    const pathMatch = body.match(/^path:\s*(.+)$/m);
+    if (!pathMatch?.[1]) {
+        throw new Error('Missing path field');
+    }
+    const filePath = pathMatch[1].trim();
+    // Extract old and new content
+    const oldMatch = body.match(/\[OLD\]\s*([\s\S]*?)\[NEW\]/);
+    if (!oldMatch?.[1]) {
+        throw new Error('Missing [OLD]...[NEW] markers');
+    }
+    const oldContent = oldMatch[1].trim();
+    const newMatch = body.match(/\[NEW\]\s*([\s\S]*)$/);
+    if (!newMatch?.[1]) {
+        throw new Error('Missing content after [NEW] marker');
+    }
+    const newContent = newMatch[1].trim();
+    return {
+        type: 'EDIT',
+        path: filePath,
+        oldContent,
+        newContent,
+        raw,
+    };
+}
+/**
+ * Parse a DELETE action
+ * Expected format:
+ * path: relative/path/to/file
+ */
+function parseDeleteAction(body, raw) {
+    const pathMatch = body.match(/^path:\s*(.+)$/m);
+    if (!pathMatch?.[1]) {
+        throw new Error('Missing path field');
+    }
+    const filePath = pathMatch[1].trim();
+    return {
+        type: 'DELETE',
+        path: filePath,
+        raw,
+    };
+}
+/**
+ * Parse an EXECUTE action
+ * Expected format:
+ * command: shell command here
+ */
+function parseExecuteAction(body, raw) {
+    const commandMatch = body.match(/^command:\s*(.+)$/m);
+    if (!commandMatch?.[1]) {
+        throw new Error('Missing command field');
+    }
+    const command = commandMatch[1].trim();
+    return {
+        type: 'EXECUTE',
+        command,
+        raw,
+    };
+}
+/**
+ * Parse a COMPLETE action
+ * Expected format:
+ * reason: explanation
+ */
+function parseCompleteAction(body, raw) {
+    const reasonMatch = body.match(/^reason:\s*(.+)$/m);
+    if (!reasonMatch?.[1]) {
+        throw new Error('Missing reason field');
+    }
+    const reason = reasonMatch[1].trim();
+    return {
+        type: 'COMPLETE',
+        reason,
+        raw,
+    };
+}
+/**
+ * Check if a response contains a COMPLETE action
+ */
+export function hasCompleteAction(result) {
+    return result.actions.some((a) => a.type === 'COMPLETE');
+}
+/**
+ * Get the COMPLETE action if present
+ */
+export function getCompleteAction(result) {
+    const action = result.actions.find((a) => a.type === 'COMPLETE');
+    return action?.type === 'COMPLETE' ? action : null;
+}
+/**
+ * Filter actions by type
+ */
+export function getActionsByType(result, type) {
+    return result.actions.filter((a) => a.type === type);
+}
+//# sourceMappingURL=response-parser.js.map

package/dist/core/response-parser.js.map

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

package/dist/core/verification-hooks.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Verification Hooks
+ *
+ * Implements objective exit criteria for the Ralph loop.
+ * The original Ralph pattern requires external, objective verification
+ * (tests pass, build succeeds) rather than trusting the AI to say "I'm done".
+ */
+/**
+ * Result of running a verification hook
+ */
+export interface VerificationResult {
+    /** Whether verification passed */
+    passed: boolean;
+    /** The hook that was run */
+    hookType: VerificationHookType;
+    /** Human-readable message */
+    message: string;
+    /** Command output (stdout + stderr) */
+    output?: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Error if verification failed to run */
+    error?: string;
+}
+/**
+ * Types of verification hooks
+ */
+export type VerificationHookType = 'test' | 'build' | 'lint' | 'custom';
+/**
+ * Configuration for a verification hook
+ */
+export interface VerificationHook {
+    /** Type of hook */
+    type: VerificationHookType;
+    /** Command to run */
+    command: string;
+    /** Optional name for display */
+    name?: string;
+    /** Whether this hook is required to pass */
+    required: boolean;
+    /** Timeout in milliseconds */
+    timeoutMs: number;
+}
+/**
+ * Verification manager configuration
+ */
+export interface VerificationConfig {
+    /** Working directory */
+    cwd: string;
+    /** Hooks to run */
+    hooks: VerificationHook[];
+    /** Whether to stop on first failure */
+    stopOnFirstFailure: boolean;
+}
+/**
+ * Default hooks based on common project patterns
+ */
+export declare function detectDefaultHooks(_cwd: string): VerificationHook[];
+/**
+ * Verification Manager
+ *
+ * Runs objective verification hooks after each iteration to determine
+ * if the task is actually complete (not just AI-declared complete).
+ */
+export declare class VerificationManager {
+    private config;
+    private detectedHooks;
+    private initialized;
+    constructor(config?: Partial<VerificationConfig>);
+    /**
+     * Initialize by detecting available verification hooks
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get all configured hooks (explicit + detected)
+     */
+    getHooks(): VerificationHook[];
+    /**
+     * Add a custom hook
+     */
+    addHook(hook: VerificationHook): void;
+    /**
+     * Run a single verification hook
+     */
+    runHook(hook: VerificationHook): Promise<VerificationResult>;
+    /**
+     * Run all verification hooks
+     */
+    runAll(): Promise<VerificationResult[]>;
+    /**
+     * Check if all required hooks passed
+     */
+    allRequiredPassed(results: VerificationResult[]): boolean;
+    /**
+     * Get a summary of verification results
+     */
+    getSummary(results: VerificationResult[]): string;
+}
+/**
+ * Create a verification manager with custom configuration
+ */
+export declare function createVerificationManager(config?: Partial<VerificationConfig>): VerificationManager;
+//# sourceMappingURL=verification-hooks.d.ts.map

package/dist/core/verification-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-hooks.d.ts","sourceRoot":"","sources":["../../src/core/verification-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,uCAAuC;IACvC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAOnE;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAQpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+GjC;;OAEG;IACH,QAAQ,IAAI,gBAAgB,EAAE;IAI9B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAIrC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoDlE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyB7C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO;IAsBzD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM;CAiBlD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,mBAAmB,CAErB"}