ghcralph 0.1.0

package/dist/core/context-builder.js

@@ -0,0 +1,388 @@
+/**
+ * Context Builder
+ *
+ * Builds rich context for AI agent prompts including relevant files,
+ * git history, and previous iteration results.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { glob } from 'glob';
+import { debug, warn } from '../utils/index.js';
+import { getExamplesForModel } from './prompt-examples.js';
+const execAsync = promisify(exec);
+/**
+ * Default Ralph prompt template (simplified per Ralph pattern)
+ * The {output_format} placeholder is replaced with model-appropriate examples
+ */
+const DEFAULT_PROMPT_TEMPLATE = `You are an expert software engineer. Your task is: {task_title}
+
+## Task Description
+{task_content}
+
+{state_section}
+{context_section}
+{previous_progress}
+{feedback_section}
+
+{output_format}
+
+## Instructions
+- Make small, focused changes
+- Test your changes with [ACTION:EXECUTE]
+- Use [ACTION:COMPLETE] when tests pass and task is done`;
+/**
+ * Legacy prompt template with meta info (for backwards compatibility)
+ */
+const LEGACY_PROMPT_TEMPLATE = `You are an expert software engineer. Your task is: {task_title}
+
+## Task Description
+{task_content}
+
+## Current State
+- Iteration: {iteration} of {max_iterations}
+- Tokens used: {tokens_used} of {max_tokens}
+
+{context_section}
+{previous_progress}
+
+## Instructions
+- Make small, focused changes
+- Test your changes when possible
+- Explain your reasoning
+- Stop when the task is complete`;
+/**
+ * Default context builder configuration
+ */
+const DEFAULT_CONFIG = {
+    maxContextTokens: 8000,
+    includeGitDiff: true,
+    includeGitHistory: true,
+    gitHistoryLimit: 5,
+    includeProjectStructure: true,
+    freshContextPerIteration: true, // Ralph pattern: rely on filesystem, not history
+    includeMetaInfo: false, // Ralph pattern: don't include iteration/token counts
+    model: 'gpt-4.1', // Default model (0x cost multiplier)
+};
+/**
+ * Context builder for creating rich AI prompts
+ */
+export class ContextBuilder {
+    config;
+    cwd;
+    constructor(config = {}, cwd) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.cwd = cwd ?? process.cwd();
+    }
+    /**
+     * Build a complete context prompt for the current iteration
+     */
+    async buildContext(task, iteration, maxIterations, tokensUsed, maxTokens, previousIterations = [], feedbackSection) {
+        const filesIncluded = [];
+        let truncated = false;
+        // Select template based on configuration
+        let template;
+        if (this.config.promptTemplate) {
+            template = this.config.promptTemplate;
+        }
+        else if (this.config.includeMetaInfo) {
+            template = LEGACY_PROMPT_TEMPLATE;
+        }
+        else {
+            template = DEFAULT_PROMPT_TEMPLATE;
+        }
+        // Build context sections
+        const contextParts = [];
+        // 1. Add explicit context files first (highest priority)
+        if (this.config.contextGlobs && this.config.contextGlobs.length > 0) {
+            const explicitContext = await this.getExplicitContextFiles();
+            if (explicitContext.content) {
+                contextParts.push('## Relevant Files\n' + explicitContext.content);
+                filesIncluded.push(...explicitContext.files);
+            }
+        }
+        // 2. Add task-relevant files (based on keywords)
+        const keywordFiles = await this.findRelevantFiles(task);
+        if (keywordFiles.content && !this.exceedsTokenLimit(contextParts.join('\n'), keywordFiles.content)) {
+            contextParts.push(keywordFiles.content);
+            filesIncluded.push(...keywordFiles.files);
+        }
+        // 3. Add git diff (current changes) - CRITICAL for Ralph pattern
+        // This is the primary way the AI knows what has been done
+        if (this.config.includeGitDiff) {
+            const gitDiff = await this.getGitDiff();
+            if (gitDiff && !this.exceedsTokenLimit(contextParts.join('\n'), gitDiff)) {
+                contextParts.push('## Current Changes (git diff)\n```diff\n' + gitDiff + '\n```');
+            }
+        }
+        // 4. Add git history
+        if (this.config.includeGitHistory) {
+            const gitHistory = await this.getGitHistory();
+            if (gitHistory && !this.exceedsTokenLimit(contextParts.join('\n'), gitHistory)) {
+                contextParts.push('## Recent Git History\n' + gitHistory);
+            }
+        }
+        // 5. Add project structure overview
+        if (this.config.includeProjectStructure) {
+            const structure = await this.getProjectStructure();
+            if (structure && !this.exceedsTokenLimit(contextParts.join('\n'), structure)) {
+                contextParts.push('## Project Structure\n```\n' + structure + '\n```');
+            }
+        }
+        // Build previous progress section
+        // In fresh context mode (Ralph pattern), we skip this - rely on git diff instead
+        let previousProgress = '';
+        if (!this.config.freshContextPerIteration) {
+            previousProgress = this.buildPreviousProgress(previousIterations);
+        }
+        // Build state section (only if includeMetaInfo is true)
+        let stateSection = '';
+        if (this.config.includeMetaInfo) {
+            stateSection = `## Current State
+- Iteration: ${iteration} of ${maxIterations}
+- Tokens used: ${tokensUsed} of ${maxTokens}`;
+        }
+        // Build context section
+        const contextSection = contextParts.length > 0
+            ? '## Context\n' + contextParts.join('\n\n')
+            : '';
+        // Get model-appropriate output format examples
+        const outputFormat = getExamplesForModel(this.config.model ?? 'gpt-4.1');
+        // Build the final prompt
+        let prompt = template
+            .replace('{task_title}', task.title)
+            .replace('{task_content}', task.content)
+            .replace('{iteration}', String(iteration))
+            .replace('{max_iterations}', String(maxIterations))
+            .replace('{tokens_used}', String(tokensUsed))
+            .replace('{max_tokens}', String(maxTokens))
+            .replace('{state_section}', stateSection)
+            .replace('{context_section}', contextSection)
+            .replace('{previous_progress}', previousProgress)
+            .replace('{feedback_section}', feedbackSection ?? '')
+            .replace('{output_format}', outputFormat);
+        // Clean up multiple consecutive newlines
+        prompt = prompt.replace(/\n{3,}/g, '\n\n').trim();
+        // Estimate token count
+        const estimatedTokens = this.estimateTokens(prompt);
+        // Check if we exceeded limits and need to truncate
+        if (estimatedTokens > this.config.maxContextTokens) {
+            truncated = true;
+            prompt = this.truncatePrompt(prompt);
+        }
+        return {
+            prompt,
+            estimatedTokens: this.estimateTokens(prompt),
+            filesIncluded,
+            truncated,
+        };
+    }
+    /**
+     * Get explicit context files from glob patterns
+     */
+    async getExplicitContextFiles() {
+        if (!this.config.contextGlobs || this.config.contextGlobs.length === 0) {
+            return { content: '', files: [] };
+        }
+        const files = [];
+        const contentParts = [];
+        for (const pattern of this.config.contextGlobs) {
+            try {
+                const matches = await glob(pattern, { cwd: this.cwd, nodir: true });
+                for (const file of matches) {
+                    try {
+                        const fullPath = path.join(this.cwd, file);
+                        const content = await fs.readFile(fullPath, 'utf-8');
+                        // Skip very large files
+                        if (content.length > 50000) {
+                            debug(`Skipping large file: ${file}`);
+                            continue;
+                        }
+                        files.push(file);
+                        contentParts.push(`### ${file}\n\`\`\`\n${content}\n\`\`\``);
+                    }
+                    catch {
+                        debug(`Failed to read file: ${file}`);
+                    }
+                }
+            }
+            catch {
+                debug(`Failed to glob pattern: ${pattern}`);
+            }
+        }
+        return {
+            content: contentParts.join('\n\n'),
+            files,
+        };
+    }
+    /**
+     * Find relevant files based on task keywords
+     */
+    async findRelevantFiles(task) {
+        // Extract keywords from task
+        const keywords = this.extractKeywords(task.title + ' ' + task.content);
+        if (keywords.length === 0) {
+            return { content: '', files: [] };
+        }
+        const files = [];
+        const contentParts = [];
+        // Try to find files matching keywords
+        for (const keyword of keywords.slice(0, 3)) { // Limit to top 3 keywords
+            try {
+                // Search for files containing the keyword
+                const { stdout } = await execAsync(`git grep -l "${keyword}" 2>/dev/null | head -3`, { cwd: this.cwd });
+                const matchedFiles = stdout.trim().split('\n').filter(Boolean);
+                for (const file of matchedFiles) {
+                    if (files.includes(file))
+                        continue;
+                    try {
+                        const fullPath = path.join(this.cwd, file);
+                        const content = await fs.readFile(fullPath, 'utf-8');
+                        // Skip large files
+                        if (content.length > 30000)
+                            continue;
+                        files.push(file);
+                        contentParts.push(`### ${file}\n\`\`\`\n${content.substring(0, 5000)}${content.length > 5000 ? '\n...(truncated)' : ''}\n\`\`\``);
+                        // Limit total files
+                        if (files.length >= 5)
+                            break;
+                    }
+                    catch {
+                        // Skip files we can't read
+                    }
+                }
+                if (files.length >= 5)
+                    break;
+            }
+            catch {
+                // git grep not available or no matches
+            }
+        }
+        if (contentParts.length === 0) {
+            return { content: '', files: [] };
+        }
+        return {
+            content: '## Relevant Files (keyword matches)\n' + contentParts.join('\n\n'),
+            files,
+        };
+    }
+    /**
+     * Extract keywords from text
+     */
+    extractKeywords(text) {
+        // Remove common words and extract meaningful terms
+        const stopWords = new Set([
+            'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+            'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+            'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+            'should', 'may', 'might', 'must', 'shall', 'can', 'need', 'this', 'that',
+            'these', 'those', 'it', 'its', 'add', 'update', 'create', 'fix', 'implement',
+        ]);
+        // Extract words
+        const words = text
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter(w => w.length > 2 && !stopWords.has(w));
+        // Return unique words, prioritizing longer ones
+        return [...new Set(words)].sort((a, b) => b.length - a.length);
+    }
+    /**
+     * Get current git diff
+     */
+    async getGitDiff() {
+        try {
+            const { stdout } = await execAsync('git diff --staged HEAD 2>/dev/null || git diff HEAD 2>/dev/null', {
+                cwd: this.cwd,
+                maxBuffer: 100000,
+            });
+            const diff = stdout.trim();
+            if (!diff)
+                return null;
+            // Truncate if too long
+            if (diff.length > 10000) {
+                return diff.substring(0, 10000) + '\n...(truncated)';
+            }
+            return diff;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get recent git history
+     */
+    async getGitHistory() {
+        try {
+            const limit = this.config.gitHistoryLimit ?? 5;
+            const { stdout } = await execAsync(`git log --oneline -n ${limit} 2>/dev/null`, { cwd: this.cwd });
+            return stdout.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get project structure overview
+     */
+    async getProjectStructure() {
+        try {
+            // Use find to get directory structure, limited depth
+            const { stdout } = await execAsync('find . -type f -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/dist/*" | head -50', { cwd: this.cwd });
+            return stdout.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Build previous progress section
+     */
+    buildPreviousProgress(iterations) {
+        const successful = iterations.filter(i => i.success && i.summary);
+        if (successful.length === 0) {
+            return '';
+        }
+        const summaries = successful
+            .map(i => `- Iteration ${i.iteration}: ${i.summary}`)
+            .join('\n');
+        return `## Previous Progress\n${summaries}`;
+    }
+    /**
+     * Check if adding content would exceed token limit
+     */
+    exceedsTokenLimit(existing, additional) {
+        const estimatedTokens = this.estimateTokens(existing + additional);
+        return estimatedTokens > this.config.maxContextTokens;
+    }
+    /**
+     * Estimate token count (rough approximation: ~4 chars per token)
+     */
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * Truncate prompt to fit within limits
+     */
+    truncatePrompt(prompt) {
+        const maxChars = this.config.maxContextTokens * 4;
+        if (prompt.length <= maxChars) {
+            return prompt;
+        }
+        warn(`Truncating prompt from ${prompt.length} to ${maxChars} characters`);
+        // Keep start and end, truncate middle
+        const keepStart = Math.floor(maxChars * 0.7);
+        const keepEnd = Math.floor(maxChars * 0.25);
+        return prompt.substring(0, keepStart) +
+            '\n\n...(context truncated due to size limits)...\n\n' +
+            prompt.substring(prompt.length - keepEnd);
+    }
+}
+/**
+ * Create a context builder with custom configuration
+ */
+export function createContextBuilder(config, cwd) {
+    return new ContextBuilder(config, cwd);
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/core/context-builder.js.map

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

package/dist/core/feedback-builder.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Feedback Builder
+ *
+ * Builds feedback prompts to show the AI the results of its actions.
+ * This is a core component of the Ralph pattern - the AI must see
+ * actual results (test output, errors, git diff) to iterate effectively.
+ */
+import type { ExecutionResult } from './action-executor.js';
+import type { VerificationResult } from './verification-hooks.js';
+/**
+ * Feedback section types
+ */
+export type FeedbackSectionType = 'actions' | 'verification' | 'git-diff' | 'error' | 'suggestion';
+/**
+ * A section of feedback
+ */
+export interface FeedbackSection {
+    type: FeedbackSectionType;
+    title: string;
+    content: string;
+    success: boolean;
+}
+/**
+ * Complete feedback for the next iteration
+ */
+export interface IterationFeedback {
+    /** All feedback sections */
+    sections: FeedbackSection[];
+    /** Overall success status */
+    overallSuccess: boolean;
+    /** Whether task should be marked complete */
+    taskComplete: boolean;
+    /** Formatted feedback for prompt */
+    formatted: string;
+}
+/**
+ * Feedback builder configuration
+ */
+export interface FeedbackBuilderConfig {
+    /** Working directory */
+    cwd: string;
+    /** Maximum lines of output to include per section */
+    maxOutputLines: number;
+    /** Whether to include git diff */
+    includeGitDiff: boolean;
+    /** Maximum git diff size in characters */
+    maxDiffSize: number;
+}
+/**
+ * Feedback Builder
+ *
+ * Creates structured feedback for the AI based on what happened
+ * in the previous iteration.
+ */
+export declare class FeedbackBuilder {
+    private config;
+    constructor(config?: Partial<FeedbackBuilderConfig>);
+    /**
+     * Build feedback from action execution results
+     */
+    buildFromActions(executionResult: ExecutionResult): FeedbackSection;
+    /**
+     * Build feedback from verification results
+     */
+    buildFromVerification(results: VerificationResult[]): FeedbackSection;
+    /**
+     * Build feedback from current git diff
+     */
+    buildFromGitDiff(): Promise<FeedbackSection | null>;
+    /**
+     * Build an error feedback section
+     */
+    buildError(error: Error | string): FeedbackSection;
+    /**
+     * Build a suggestion section
+     */
+    buildSuggestion(suggestion: string): FeedbackSection;
+    /**
+     * Combine sections into complete iteration feedback
+     */
+    buildComplete(actionResult: ExecutionResult | null, verificationResults: VerificationResult[], options?: {
+        includeGitDiff?: boolean;
+        suggestion?: string;
+    }): Promise<IterationFeedback>;
+    /**
+     * Format feedback sections for inclusion in prompt
+     */
+    formatForPrompt(sections: FeedbackSection[], taskComplete: boolean): string;
+}
+/**
+ * Create a feedback builder with custom configuration
+ */
+export declare function createFeedbackBuilder(config?: Partial<FeedbackBuilderConfig>): FeedbackBuilder;
+//# sourceMappingURL=feedback-builder.d.ts.map

package/dist/core/feedback-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-builder.d.ts","sourceRoot":"","sources":["../../src/core/feedback-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,cAAc,GACd,UAAU,GACV,OAAO,GACP,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,6BAA6B;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AASD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIvD;;OAEG;IACH,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,eAAe;IAiCnE;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,eAAe;IAyCrE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuCzD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,eAAe;IAUlD;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IASpD;;OAEG;IACG,aAAa,CACjB,YAAY,EAAE,eAAe,GAAG,IAAI,EACpC,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9D,OAAO,CAAC,iBAAiB,CAAC;IA2C7B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM;CAwB5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,eAAe,CAEjB"}