ghcralph 0.1.0

package/dist/core/feedback-builder.js

@@ -0,0 +1,226 @@
+/**
+ * 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 { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { debug } from '../utils/index.js';
+const execAsync = promisify(exec);
+const DEFAULT_CONFIG = {
+    cwd: process.cwd(),
+    maxOutputLines: 50,
+    includeGitDiff: true,
+    maxDiffSize: 5000,
+};
+/**
+ * Feedback Builder
+ *
+ * Creates structured feedback for the AI based on what happened
+ * in the previous iteration.
+ */
+export class FeedbackBuilder {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Build feedback from action execution results
+     */
+    buildFromActions(executionResult) {
+        const lines = [];
+        for (const result of executionResult.results) {
+            const icon = result.success ? '✓' : '✗';
+            lines.push(`${icon} ${result.message}`);
+            // Include output for EXECUTE actions or failures
+            if (result.output && (result.action.type === 'EXECUTE' || !result.success)) {
+                const outputLines = result.output.split('\n');
+                const truncated = outputLines.slice(0, this.config.maxOutputLines);
+                if (outputLines.length > this.config.maxOutputLines) {
+                    truncated.push(`... (${outputLines.length - this.config.maxOutputLines} more lines)`);
+                }
+                lines.push('```');
+                lines.push(...truncated);
+                lines.push('```');
+            }
+            // Include error details for failures
+            if (!result.success && result.error) {
+                lines.push(`  Error: ${result.error}`);
+            }
+        }
+        return {
+            type: 'actions',
+            title: 'Action Results',
+            content: lines.join('\n'),
+            success: executionResult.allSucceeded,
+        };
+    }
+    /**
+     * Build feedback from verification results
+     */
+    buildFromVerification(results) {
+        if (results.length === 0) {
+            return {
+                type: 'verification',
+                title: 'Verification',
+                content: 'No verification hooks configured.',
+                success: true,
+            };
+        }
+        const lines = [];
+        let allPassed = true;
+        for (const result of results) {
+            const icon = result.passed ? '✓' : '✗';
+            lines.push(`${icon} ${result.message} (${result.durationMs}ms)`);
+            if (!result.passed) {
+                allPassed = false;
+                // Include failure output
+                if (result.output) {
+                    const outputLines = result.output.split('\n');
+                    const truncated = outputLines.slice(-this.config.maxOutputLines); // Last N lines for errors
+                    if (outputLines.length > this.config.maxOutputLines) {
+                        lines.push(`... (${outputLines.length - this.config.maxOutputLines} lines omitted)`);
+                    }
+                    lines.push('```');
+                    lines.push(...truncated);
+                    lines.push('```');
+                }
+            }
+        }
+        return {
+            type: 'verification',
+            title: 'Verification Results',
+            content: lines.join('\n'),
+            success: allPassed,
+        };
+    }
+    /**
+     * Build feedback from current git diff
+     */
+    async buildFromGitDiff() {
+        if (!this.config.includeGitDiff) {
+            return null;
+        }
+        try {
+            const { stdout } = await execAsync('git diff --stat HEAD 2>/dev/null', {
+                cwd: this.config.cwd,
+                maxBuffer: 100000,
+            });
+            const diffStat = stdout.trim();
+            if (!diffStat) {
+                return null; // No changes
+            }
+            // Get actual diff (limited)
+            const { stdout: diffContent } = await execAsync('git diff HEAD 2>/dev/null', {
+                cwd: this.config.cwd,
+                maxBuffer: this.config.maxDiffSize * 2,
+            });
+            let content = diffContent.trim();
+            if (content.length > this.config.maxDiffSize) {
+                content = content.substring(0, this.config.maxDiffSize) + '\n... (diff truncated)';
+            }
+            return {
+                type: 'git-diff',
+                title: 'Current Changes',
+                content: `\`\`\`diff\n${content}\n\`\`\``,
+                success: true,
+            };
+        }
+        catch {
+            debug('Failed to get git diff');
+            return null;
+        }
+    }
+    /**
+     * Build an error feedback section
+     */
+    buildError(error) {
+        const message = error instanceof Error ? error.message : error;
+        return {
+            type: 'error',
+            title: 'Error',
+            content: `An error occurred: ${message}`,
+            success: false,
+        };
+    }
+    /**
+     * Build a suggestion section
+     */
+    buildSuggestion(suggestion) {
+        return {
+            type: 'suggestion',
+            title: 'Suggestion',
+            content: suggestion,
+            success: true,
+        };
+    }
+    /**
+     * Combine sections into complete iteration feedback
+     */
+    async buildComplete(actionResult, verificationResults, options = {}) {
+        const sections = [];
+        // Add action results
+        if (actionResult) {
+            sections.push(this.buildFromActions(actionResult));
+        }
+        // Add verification results
+        if (verificationResults.length > 0) {
+            sections.push(this.buildFromVerification(verificationResults));
+        }
+        // Add git diff if requested
+        if (options.includeGitDiff !== false) {
+            const diffSection = await this.buildFromGitDiff();
+            if (diffSection) {
+                sections.push(diffSection);
+            }
+        }
+        // Add suggestion if provided
+        if (options.suggestion) {
+            sections.push(this.buildSuggestion(options.suggestion));
+        }
+        // Calculate overall status
+        const overallSuccess = sections.every((s) => s.success);
+        const verificationPassed = verificationResults.every((r) => r.passed);
+        const taskComplete = actionResult?.taskComplete === true && verificationPassed;
+        // Format for prompt
+        const formatted = this.formatForPrompt(sections, taskComplete);
+        return {
+            sections,
+            overallSuccess,
+            taskComplete,
+            formatted,
+        };
+    }
+    /**
+     * Format feedback sections for inclusion in prompt
+     */
+    formatForPrompt(sections, taskComplete) {
+        const lines = ['## Feedback from Previous Iteration'];
+        if (taskComplete) {
+            lines.push('');
+            lines.push('✅ **Task verified complete!** All actions succeeded and verification passed.');
+            lines.push('');
+        }
+        for (const section of sections) {
+            lines.push('');
+            lines.push(`### ${section.title}`);
+            lines.push(section.content);
+        }
+        if (!taskComplete && sections.some((s) => !s.success)) {
+            lines.push('');
+            lines.push('### Next Steps');
+            lines.push('Review the failures above and continue working on the task.');
+            lines.push('Use [ACTION:EXECUTE] to investigate issues if needed.');
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Create a feedback builder with custom configuration
+ */
+export function createFeedbackBuilder(config) {
+    return new FeedbackBuilder(config);
+}
+//# sourceMappingURL=feedback-builder.js.map

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

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

package/dist/core/file-safeguard.d.ts

@@ -0,0 +1,109 @@
+/**
+ * File Safeguard Manager
+ *
+ * Protects existing files from accidental deletion while allowing
+ * cleanup of agent-created files.
+ */
+/**
+ * File safeguard configuration
+ */
+export interface FileSafeguardConfig {
+    /** Working directory */
+    cwd: string;
+    /** Whether to allow deletion of existing files */
+    allowDeleteExisting: boolean;
+    /** Path to store baseline snapshot */
+    baselinePath: string;
+}
+/**
+ * Baseline snapshot data
+ */
+export interface BaselineSnapshot {
+    /** When the snapshot was created */
+    createdAt: string;
+    /** List of files that existed at session start */
+    files: string[];
+    /** Number of files in the baseline */
+    count: number;
+}
+/**
+ * File operation tracking
+ */
+export interface FileOperations {
+    /** Files that existed before session */
+    baselineFiles: Set<string>;
+    /** Files created during session */
+    createdFiles: Set<string>;
+    /** Files modified during session */
+    modifiedFiles: Set<string>;
+    /** Deletion attempts that were blocked */
+    blockedDeletions: string[];
+}
+/**
+ * File Safeguard Manager class
+ */
+export declare class FileSafeguardManager {
+    private config;
+    private operations;
+    private initialized;
+    constructor(config?: Partial<FileSafeguardConfig>);
+    private getNormalizedRelativePath;
+    /**
+     * Initialize by creating baseline snapshot
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create baseline snapshot of existing files
+     */
+    private createBaseline;
+    /**
+     * Load existing baseline from file
+     */
+    private loadBaseline;
+    /**
+     * Check if a file existed before the session
+     */
+    isBaselineFile(filePath: string): boolean;
+    /**
+     * Check if a file was created during this session
+     */
+    isCreatedFile(filePath: string): boolean;
+    /**
+     * Track a file creation
+     */
+    trackFileCreation(filePath: string): void;
+    /**
+     * Track a file modification
+     */
+    trackFileModification(filePath: string): void;
+    /**
+     * Check if a file can be deleted
+     */
+    canDelete(filePath: string): boolean;
+    /**
+     * Get summary of file operations
+     */
+    getSummary(): {
+        baselineCount: number;
+        createdCount: number;
+        modifiedCount: number;
+        blockedCount: number;
+    };
+    /**
+     * Get detailed file operation info
+     */
+    getDetails(): {
+        created: string[];
+        modified: string[];
+        blockedDeletions: string[];
+    };
+    /**
+     * Clean up baseline file (call at end of session)
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Create a file safeguard manager
+ */
+export declare function createFileSafeguardManager(config?: Partial<FileSafeguardConfig>): FileSafeguardManager;
+//# sourceMappingURL=file-safeguard.d.ts.map

package/dist/core/file-safeguard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-safeguard.d.ts","sourceRoot":"","sources":["../../src/core/file-safeguard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,mCAAmC;IACnC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,oCAAoC;IACpC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAUrD,OAAO,CAAC,yBAAyB;IAKjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;YACW,cAAc;IA6B5B;;OAEG;YACW,YAAY;IAc1B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKzC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKxC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAwBpC;;OAEG;IACH,UAAU,IAAI;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB;IASD;;OAEG;IACH,UAAU,IAAI;QACZ,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B;IAQD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,oBAAoB,CAEtG"}

package/dist/core/file-safeguard.js

@@ -0,0 +1,200 @@
+/**
+ * File Safeguard Manager
+ *
+ * Protects existing files from accidental deletion while allowing
+ * cleanup of agent-created files.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { debug, warn } from '../utils/index.js';
+const execAsync = promisify(exec);
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    cwd: process.cwd(),
+    allowDeleteExisting: false,
+    baselinePath: '.ghcralph/baseline-files.json',
+};
+/**
+ * File Safeguard Manager class
+ */
+export class FileSafeguardManager {
+    config;
+    operations;
+    initialized = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.operations = {
+            baselineFiles: new Set(),
+            createdFiles: new Set(),
+            modifiedFiles: new Set(),
+            blockedDeletions: [],
+        };
+    }
+    getNormalizedRelativePath(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(this.config.cwd, filePath);
+        return path.relative(this.config.cwd, absolutePath).replace(/\\/g, '/');
+    }
+    /**
+     * Initialize by creating baseline snapshot
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Try to load existing baseline
+            const loaded = await this.loadBaseline();
+            if (loaded) {
+                debug('Loaded existing baseline snapshot');
+                this.initialized = true;
+                return;
+            }
+            // Create new baseline
+            await this.createBaseline();
+            this.initialized = true;
+        }
+        catch (err) {
+            warn('Failed to initialize file safeguards: ' + (err instanceof Error ? err.message : String(err)));
+        }
+    }
+    /**
+     * Create baseline snapshot of existing files
+     */
+    async createBaseline() {
+        try {
+            // Get list of tracked files from git
+            const { stdout } = await execAsync('git ls-files', { cwd: this.config.cwd });
+            const files = stdout.trim().split('\n').filter(Boolean);
+            // Store in memory
+            this.operations.baselineFiles = new Set(files);
+            // Save to file
+            const snapshot = {
+                createdAt: new Date().toISOString(),
+                files,
+                count: files.length,
+            };
+            const baselinePath = path.join(this.config.cwd, this.config.baselinePath);
+            const baselineDir = path.dirname(baselinePath);
+            // Ensure directory exists
+            await fs.mkdir(baselineDir, { recursive: true });
+            await fs.writeFile(baselinePath, JSON.stringify(snapshot, null, 2));
+            debug(`Created baseline with ${files.length} files`);
+        }
+        catch (err) {
+            debug('Failed to create baseline: ' + (err instanceof Error ? err.message : String(err)));
+        }
+    }
+    /**
+     * Load existing baseline from file
+     */
+    async loadBaseline() {
+        try {
+            const baselinePath = path.join(this.config.cwd, this.config.baselinePath);
+            const content = await fs.readFile(baselinePath, 'utf-8');
+            const snapshot = JSON.parse(content);
+            this.operations.baselineFiles = new Set(snapshot.files);
+            debug(`Loaded baseline with ${snapshot.count} files from ${snapshot.createdAt}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if a file existed before the session
+     */
+    isBaselineFile(filePath) {
+        const relativePath = this.getNormalizedRelativePath(filePath);
+        return this.operations.baselineFiles.has(relativePath);
+    }
+    /**
+     * Check if a file was created during this session
+     */
+    isCreatedFile(filePath) {
+        const relativePath = this.getNormalizedRelativePath(filePath);
+        return this.operations.createdFiles.has(relativePath);
+    }
+    /**
+     * Track a file creation
+     */
+    trackFileCreation(filePath) {
+        const relativePath = this.getNormalizedRelativePath(filePath);
+        if (!this.operations.baselineFiles.has(relativePath)) {
+            this.operations.createdFiles.add(relativePath);
+            debug(`Tracked file creation: ${relativePath}`);
+        }
+    }
+    /**
+     * Track a file modification
+     */
+    trackFileModification(filePath) {
+        const relativePath = this.getNormalizedRelativePath(filePath);
+        this.operations.modifiedFiles.add(relativePath);
+    }
+    /**
+     * Check if a file can be deleted
+     */
+    canDelete(filePath) {
+        // Always allow if override is set
+        if (this.config.allowDeleteExisting) {
+            return true;
+        }
+        const relativePath = this.getNormalizedRelativePath(filePath);
+        // Allow deletion of files created during session
+        if (this.operations.createdFiles.has(relativePath)) {
+            return true;
+        }
+        // Block deletion of baseline files
+        if (this.operations.baselineFiles.has(relativePath)) {
+            this.operations.blockedDeletions.push(relativePath);
+            warn(`Blocked deletion of pre-existing file: ${relativePath}`);
+            return false;
+        }
+        // Allow deletion of unknown files (not in baseline, not tracked as created)
+        return true;
+    }
+    /**
+     * Get summary of file operations
+     */
+    getSummary() {
+        return {
+            baselineCount: this.operations.baselineFiles.size,
+            createdCount: this.operations.createdFiles.size,
+            modifiedCount: this.operations.modifiedFiles.size,
+            blockedCount: this.operations.blockedDeletions.length,
+        };
+    }
+    /**
+     * Get detailed file operation info
+     */
+    getDetails() {
+        return {
+            created: Array.from(this.operations.createdFiles),
+            modified: Array.from(this.operations.modifiedFiles),
+            blockedDeletions: this.operations.blockedDeletions,
+        };
+    }
+    /**
+     * Clean up baseline file (call at end of session)
+     */
+    async cleanup() {
+        try {
+            const baselinePath = path.join(this.config.cwd, this.config.baselinePath);
+            await fs.unlink(baselinePath);
+            debug('Cleaned up baseline file');
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+/**
+ * Create a file safeguard manager
+ */
+export function createFileSafeguardManager(config) {
+    return new FileSafeguardManager(config);
+}
+//# sourceMappingURL=file-safeguard.js.map

package/dist/core/file-safeguard.js.map

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

package/dist/core/git-branch-manager.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Git Branch Manager
+ *
+ * Manages git branch isolation for safe Ralph operations
+ */
+/**
+ * Git branch manager configuration
+ */
+export interface GitBranchConfig {
+    /** Prefix for GitHub Copilot Ralph branches (default: 'ralph/') */
+    branchPrefix: string;
+    /** Whether to auto-create branches without prompting */
+    autoCreate: boolean;
+    /** Working directory */
+    cwd: string;
+}
+/**
+ * Working directory status
+ */
+export interface WorkingDirStatus {
+    /** Whether the working directory is clean */
+    isClean: boolean;
+    /** Number of modified files */
+    modifiedFiles: number;
+    /** Number of untracked files */
+    untrackedFiles: number;
+}
+/**
+ * Branch info
+ */
+export interface BranchInfo {
+    /** Current branch name */
+    name: string;
+    /** Whether this is a main/master branch */
+    isMain: boolean;
+    /** Whether this is a Ralph branch */
+    isRalphBranch: boolean;
+}
+/**
+ * Git Branch Manager class
+ */
+export declare class GitBranchManager {
+    private config;
+    constructor(config?: Partial<GitBranchConfig>);
+    /**
+     * Check if we're in a git repository
+     */
+    isGitRepository(): Promise<boolean>;
+    /**
+     * Get current branch information
+     */
+    getCurrentBranch(): Promise<BranchInfo>;
+    /**
+     * Get working directory status
+     */
+    getWorkingDirStatus(): Promise<WorkingDirStatus>;
+    /**
+     * Stash current changes
+     */
+    stashChanges(message?: string): Promise<boolean>;
+    /**
+     * Pop stashed changes
+     */
+    popStash(): Promise<boolean>;
+    /**
+     * Generate a branch name from task info
+     */
+    generateBranchName(taskTitle: string, taskId?: string): string;
+    /**
+     * Create and switch to a new Ralph branch
+     */
+    createAndSwitchBranch(branchName: string): Promise<boolean>;
+    /**
+     * Switch to an existing branch
+     */
+    switchBranch(branchName: string): Promise<boolean>;
+    /**
+     * Check if a branch exists
+     */
+    branchExists(branchName: string): Promise<boolean>;
+    /**
+     * Get the default branch (main/master)
+     */
+    getDefaultBranch(): Promise<string>;
+    /**
+     * Merge a Ralph branch back to the original branch
+     */
+    mergeBranch(sourceBranch: string, targetBranch: string): Promise<boolean>;
+    /**
+     * Delete a branch
+     */
+    deleteBranch(branchName: string, force?: boolean): Promise<boolean>;
+    /**
+     * Get the list of GitHub Copilot Ralph branches
+     */
+    listRalphBranches(): Promise<string[]>;
+    /**
+     * Prepare the branch for a Ralph operation
+     * Returns the branch name to use
+     */
+    prepareForOperation(taskTitle: string, taskId?: string, options?: {
+        branch?: string;
+        force?: boolean;
+    }): Promise<{
+        branchName: string;
+        created: boolean;
+        originalBranch: string;
+    }>;
+    /**
+     * Get the latest commit hash
+     */
+    getLatestCommitHash(): Promise<string | null>;
+    /**
+     * Get the commit count on current branch
+     */
+    getCommitCount(): Promise<number>;
+}
+/**
+ * Create a git branch manager with configuration
+ */
+export declare function createGitBranchManager(config?: Partial<GitBranchConfig>): GitBranchManager;
+//# sourceMappingURL=git-branch-manager.d.ts.map