oh-my-claude-sisyphus 3.6.1 → 3.6.3

package/dist/hooks/ralph-progress/index.js

@@ -0,0 +1,408 @@
+/**
+ * Ralph Progress Log Support
+ *
+ * Implements append-only progress tracking using progress.txt format from original Ralph.
+ * This provides memory persistence between ralph iterations.
+ *
+ * Structure:
+ * - Codebase Patterns section at top (consolidated learnings)
+ * - Per-story progress entries appended
+ * - Learnings captured for future iterations
+ */
+import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+// ============================================================================
+// Constants
+// ============================================================================
+export const PROGRESS_FILENAME = 'progress.txt';
+export const PATTERNS_HEADER = '## Codebase Patterns';
+export const ENTRY_SEPARATOR = '---';
+// ============================================================================
+// File Operations
+// ============================================================================
+/**
+ * Get the path to progress.txt in a directory
+ */
+export function getProgressPath(directory) {
+    return join(directory, PROGRESS_FILENAME);
+}
+/**
+ * Get the path to progress.txt in .omc subdirectory
+ */
+export function getOmcProgressPath(directory) {
+    return join(directory, '.omc', PROGRESS_FILENAME);
+}
+/**
+ * Find progress.txt in a directory (checks both root and .omc)
+ */
+export function findProgressPath(directory) {
+    const rootPath = getProgressPath(directory);
+    if (existsSync(rootPath)) {
+        return rootPath;
+    }
+    const omcPath = getOmcProgressPath(directory);
+    if (existsSync(omcPath)) {
+        return omcPath;
+    }
+    return null;
+}
+/**
+ * Read raw progress.txt content
+ */
+export function readProgressRaw(directory) {
+    const progressPath = findProgressPath(directory);
+    if (!progressPath) {
+        return null;
+    }
+    try {
+        return readFileSync(progressPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse progress.txt content into structured format
+ */
+export function parseProgress(content) {
+    const lines = content.split('\n');
+    const patterns = [];
+    const entries = [];
+    let startedAt = '';
+    let inPatterns = false;
+    let currentEntry = null;
+    let currentSection = '';
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Check for started timestamp
+        if (trimmed.startsWith('Started:')) {
+            startedAt = trimmed.replace('Started:', '').trim();
+            continue;
+        }
+        // Check for patterns section
+        if (trimmed === PATTERNS_HEADER) {
+            inPatterns = true;
+            continue;
+        }
+        // Check for separator (ends patterns section, separates entries)
+        if (trimmed === ENTRY_SEPARATOR) {
+            inPatterns = false;
+            if (currentEntry && currentEntry.storyId) {
+                entries.push(currentEntry);
+            }
+            currentEntry = null;
+            currentSection = '';
+            continue;
+        }
+        // Parse patterns
+        if (inPatterns && trimmed.startsWith('-')) {
+            patterns.push({
+                pattern: trimmed.slice(1).trim()
+            });
+            continue;
+        }
+        // Parse entry header (## [Date] - [Story ID])
+        const headerMatch = trimmed.match(/^##\s*\[(.+?)\]\s*-\s*(.+)$/);
+        if (headerMatch) {
+            if (currentEntry && currentEntry.storyId) {
+                entries.push(currentEntry);
+            }
+            currentEntry = {
+                timestamp: headerMatch[1],
+                storyId: headerMatch[2],
+                implementation: [],
+                filesChanged: [],
+                learnings: []
+            };
+            currentSection = '';
+            continue;
+        }
+        // Parse sections within entry
+        if (currentEntry) {
+            if (trimmed.toLowerCase().includes('learnings')) {
+                currentSection = 'learnings';
+                continue;
+            }
+            if (trimmed.toLowerCase().includes('files changed') || trimmed.toLowerCase().includes('files:')) {
+                currentSection = 'files';
+                continue;
+            }
+            if (trimmed.startsWith('-') || trimmed.startsWith('*')) {
+                const item = trimmed.slice(1).trim();
+                if (currentSection === 'learnings') {
+                    currentEntry.learnings.push(item);
+                }
+                else if (currentSection === 'files') {
+                    currentEntry.filesChanged.push(item);
+                }
+                else {
+                    currentEntry.implementation.push(item);
+                }
+            }
+        }
+    }
+    // Don't forget the last entry
+    if (currentEntry && currentEntry.storyId) {
+        entries.push(currentEntry);
+    }
+    return {
+        patterns,
+        entries,
+        startedAt
+    };
+}
+/**
+ * Read and parse progress.txt
+ */
+export function readProgress(directory) {
+    const content = readProgressRaw(directory);
+    if (!content) {
+        return null;
+    }
+    return parseProgress(content);
+}
+// ============================================================================
+// Progress Operations
+// ============================================================================
+/**
+ * Initialize a new progress.txt file
+ */
+export function initProgress(directory) {
+    const omcDir = join(directory, '.omc');
+    if (!existsSync(omcDir)) {
+        try {
+            mkdirSync(omcDir, { recursive: true });
+        }
+        catch {
+            return false;
+        }
+    }
+    const progressPath = getOmcProgressPath(directory);
+    const now = new Date().toISOString();
+    const content = `# Ralph Progress Log
+Started: ${now}
+
+${PATTERNS_HEADER}
+(No patterns discovered yet)
+
+${ENTRY_SEPARATOR}
+
+`;
+    try {
+        writeFileSync(progressPath, content);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Append a progress entry
+ */
+export function appendProgress(directory, entry) {
+    let progressPath = findProgressPath(directory);
+    if (!progressPath) {
+        // Initialize if doesn't exist
+        if (!initProgress(directory)) {
+            return false;
+        }
+        progressPath = getOmcProgressPath(directory);
+    }
+    const now = new Date().toISOString();
+    const dateStr = now.split('T')[0];
+    const timeStr = now.split('T')[1].slice(0, 5);
+    const lines = [
+        '',
+        `## [${dateStr} ${timeStr}] - ${entry.storyId}`,
+        ''
+    ];
+    if (entry.implementation.length > 0) {
+        lines.push('**What was implemented:**');
+        entry.implementation.forEach(item => {
+            lines.push(`- ${item}`);
+        });
+        lines.push('');
+    }
+    if (entry.filesChanged.length > 0) {
+        lines.push('**Files changed:**');
+        entry.filesChanged.forEach(file => {
+            lines.push(`- ${file}`);
+        });
+        lines.push('');
+    }
+    if (entry.learnings.length > 0) {
+        lines.push('**Learnings for future iterations:**');
+        entry.learnings.forEach(learning => {
+            lines.push(`- ${learning}`);
+        });
+        lines.push('');
+    }
+    lines.push(ENTRY_SEPARATOR);
+    lines.push('');
+    try {
+        appendFileSync(progressPath, lines.join('\n'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Add a codebase pattern to the patterns section
+ * @param retryCount - Internal retry counter to prevent infinite recursion
+ */
+export function addPattern(directory, pattern, retryCount = 0) {
+    // Guard against infinite recursion
+    if (retryCount > 1) {
+        return false;
+    }
+    const progressPath = findProgressPath(directory);
+    if (!progressPath) {
+        // Initialize if doesn't exist
+        if (!initProgress(directory)) {
+            return false;
+        }
+        // Retry once after initialization
+        return addPattern(directory, pattern, retryCount + 1);
+    }
+    try {
+        let content = readFileSync(progressPath, 'utf-8');
+        // Remove placeholder if present (do this FIRST before calculating positions)
+        content = content.replace('(No patterns discovered yet)\n', '');
+        // Find the patterns section and add the new pattern
+        const patternsSectionStart = content.indexOf(PATTERNS_HEADER);
+        if (patternsSectionStart === -1) {
+            return false;
+        }
+        // Find the first separator after patterns
+        const separatorPos = content.indexOf(ENTRY_SEPARATOR, patternsSectionStart);
+        if (separatorPos === -1) {
+            return false;
+        }
+        // Insert the pattern before the separator
+        const before = content.slice(0, separatorPos);
+        const after = content.slice(separatorPos);
+        const newContent = before + `- ${pattern}\n\n` + after;
+        writeFileSync(progressPath, newContent);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get patterns from progress.txt for injection into context
+ */
+export function getPatterns(directory) {
+    const progress = readProgress(directory);
+    if (!progress) {
+        return [];
+    }
+    return progress.patterns.map(p => p.pattern);
+}
+/**
+ * Get recent learnings for context injection
+ */
+export function getRecentLearnings(directory, limit = 5) {
+    const progress = readProgress(directory);
+    if (!progress) {
+        return [];
+    }
+    const learnings = [];
+    const recentEntries = progress.entries.slice(-limit);
+    for (const entry of recentEntries) {
+        learnings.push(...entry.learnings);
+    }
+    return learnings;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Format patterns for context injection
+ */
+export function formatPatternsForContext(directory) {
+    const patterns = getPatterns(directory);
+    if (patterns.length === 0) {
+        return '';
+    }
+    const lines = [
+        '<codebase-patterns>',
+        '',
+        '## Known Patterns from Previous Iterations',
+        ''
+    ];
+    patterns.forEach(pattern => {
+        lines.push(`- ${pattern}`);
+    });
+    lines.push('');
+    lines.push('</codebase-patterns>');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format recent progress for context injection
+ */
+export function formatProgressForContext(directory, limit = 3) {
+    const progress = readProgress(directory);
+    if (!progress || progress.entries.length === 0) {
+        return '';
+    }
+    const recent = progress.entries.slice(-limit);
+    const lines = [
+        '<recent-progress>',
+        '',
+        '## Recent Progress',
+        ''
+    ];
+    for (const entry of recent) {
+        lines.push(`### ${entry.storyId} (${entry.timestamp})`);
+        if (entry.implementation.length > 0) {
+            entry.implementation.forEach(item => {
+                lines.push(`- ${item}`);
+            });
+        }
+        lines.push('');
+    }
+    lines.push('</recent-progress>');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format learnings for context injection
+ */
+export function formatLearningsForContext(directory) {
+    const learnings = getRecentLearnings(directory, 10);
+    if (learnings.length === 0) {
+        return '';
+    }
+    const lines = [
+        '<learnings>',
+        '',
+        '## Learnings from Previous Iterations',
+        ''
+    ];
+    // Deduplicate learnings
+    const unique = [...new Set(learnings)];
+    unique.forEach(learning => {
+        lines.push(`- ${learning}`);
+    });
+    lines.push('');
+    lines.push('</learnings>');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Get full context injection for ralph
+ */
+export function getProgressContext(directory) {
+    const patterns = formatPatternsForContext(directory);
+    const learnings = formatLearningsForContext(directory);
+    const recent = formatProgressForContext(directory, 2);
+    if (!patterns && !learnings && !recent) {
+        return '';
+    }
+    return [patterns, learnings, recent].filter(Boolean).join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/ralph-progress/index.js.map

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

package/dist/hooks/ralph-verifier/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Ralph Verifier
+ *
+ * Adds architect verification to ralph completion claims.
+ * When ralph outputs a completion promise, instead of immediately
+ * accepting it, we trigger an architect verification phase.
+ *
+ * Flow:
+ * 1. Ralph outputs <promise>TASK_COMPLETE</promise>
+ * 2. System detects this and enters verification mode
+ * 3. Architect agent is invoked to verify the work
+ * 4. If architect approves -> truly complete
+ * 5. If architect finds flaws -> continue ralph with architect feedback
+ */
+export interface VerificationState {
+    /** Whether verification is pending */
+    pending: boolean;
+    /** The completion claim that triggered verification */
+    completion_claim: string;
+    /** Number of verification attempts */
+    verification_attempts: number;
+    /** Max verification attempts before force-accepting */
+    max_verification_attempts: number;
+    /** Architect feedback from last verification */
+    architect_feedback?: string;
+    /** Whether architect approved */
+    architect_approved?: boolean;
+    /** Timestamp of verification request */
+    requested_at: string;
+    /** Original ralph task */
+    original_task: string;
+}
+/**
+ * Read verification state
+ */
+export declare function readVerificationState(directory: string): VerificationState | null;
+/**
+ * Write verification state
+ */
+export declare function writeVerificationState(directory: string, state: VerificationState): boolean;
+/**
+ * Clear verification state
+ */
+export declare function clearVerificationState(directory: string): boolean;
+/**
+ * Start verification process
+ */
+export declare function startVerification(directory: string, completionClaim: string, originalTask: string): VerificationState;
+/**
+ * Record architect feedback
+ */
+export declare function recordArchitectFeedback(directory: string, approved: boolean, feedback: string): VerificationState | null;
+/**
+ * Generate architect verification prompt
+ */
+export declare function getArchitectVerificationPrompt(state: VerificationState): string;
+/**
+ * Generate continuation prompt after architect rejection
+ */
+export declare function getArchitectRejectionContinuationPrompt(state: VerificationState): string;
+/**
+ * Check if text contains architect approval
+ */
+export declare function detectArchitectApproval(text: string): boolean;
+/**
+ * Check if text contains architect rejection indicators
+ */
+export declare function detectArchitectRejection(text: string): {
+    rejected: boolean;
+    feedback: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/ralph-verifier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ralph-verifier/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,yBAAyB,EAAE,MAAM,CAAC;IAClC,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAWD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAUjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAkB3F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAWjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,iBAAiB,CAYnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,GACf,iBAAiB,GAAG,IAAI,CAyB1B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAwC/E;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA2BxF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuB9F"}