@stanco323/oh-my-claude-code 4.10.3

package/dist/hooks/ralph/verifier.js

@@ -0,0 +1,280 @@
+/**
+ * Ralph Verifier
+ *
+ * Adds architect verification to ralph completion claims.
+ * When ralph claims completion, an architect verification phase is triggered.
+ *
+ * Flow:
+ * 1. Ralph claims task is complete
+ * 2. System enters verification mode
+ * 3. Architect agent is invoked to verify the work
+ * 4. If architect approves -> truly complete, use /oh-my-claudecode:cancel to exit
+ * 5. If architect finds flaws -> continue ralph with architect feedback
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { resolveSessionStatePath, ensureSessionStateDir, getOmcRoot } from '../../lib/worktree-paths.js';
+import { formatOmcCliInvocation } from '../../utils/omc-cli-rendering.js';
+const DEFAULT_MAX_VERIFICATION_ATTEMPTS = 3;
+const DEFAULT_RALPH_CRITIC_MODE = 'architect';
+function getCriticMode(mode) {
+    return mode ?? DEFAULT_RALPH_CRITIC_MODE;
+}
+function getCriticLabel(mode) {
+    switch (getCriticMode(mode)) {
+        case 'critic':
+            return 'Critic';
+        case 'codex':
+            return 'Codex critic';
+        default:
+            return 'Architect';
+    }
+}
+function getVerificationAgentStep(mode) {
+    switch (getCriticMode(mode)) {
+        case 'critic':
+            return `1. **Spawn Critic Agent** for verification:
+   \`\`\`
+   Task(subagent_type="critic", prompt="Critically review this task completion claim...")
+   \`\`\``;
+        case 'codex':
+            return `1. **Run an external Codex critic review**:
+   \`\`\`
+   ${formatOmcCliInvocation('ask codex --agent-prompt critic "<verification prompt covering the task, completion claim, and acceptance criteria>"')}
+   \`\`\`
+   Use the Codex output as the reviewer verdict before deciding pass/fix.`;
+        default:
+            return `1. **Spawn Architect Agent** for verification:
+   \`\`\`
+   Task(subagent_type="architect", prompt="Verify this task completion claim...")
+   \`\`\``;
+    }
+}
+/**
+ * Get verification state file path
+ * When sessionId is provided, uses session-scoped path.
+ */
+function getVerificationStatePath(directory, sessionId) {
+    if (sessionId) {
+        return resolveSessionStatePath('ralph-verification', sessionId, directory);
+    }
+    return join(getOmcRoot(directory), 'ralph-verification.json');
+}
+/**
+ * Read verification state
+ * @param sessionId - When provided, reads from session-scoped path only (no legacy fallback)
+ */
+export function readVerificationState(directory, sessionId) {
+    const statePath = getVerificationStatePath(directory, sessionId);
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(statePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write verification state
+ */
+export function writeVerificationState(directory, state, sessionId) {
+    const statePath = getVerificationStatePath(directory, sessionId);
+    if (sessionId) {
+        ensureSessionStateDir(sessionId, directory);
+    }
+    else {
+        const stateDir = getOmcRoot(directory);
+        if (!existsSync(stateDir)) {
+            try {
+                mkdirSync(stateDir, { recursive: true });
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    try {
+        writeFileSync(statePath, JSON.stringify(state, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear verification state
+ * @param sessionId - When provided, clears session-scoped state only
+ */
+export function clearVerificationState(directory, sessionId) {
+    const statePath = getVerificationStatePath(directory, sessionId);
+    if (existsSync(statePath)) {
+        try {
+            unlinkSync(statePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Start verification process
+ */
+export function startVerification(directory, completionClaim, originalTask, criticMode, sessionId) {
+    const state = {
+        pending: true,
+        completion_claim: completionClaim,
+        verification_attempts: 0,
+        max_verification_attempts: DEFAULT_MAX_VERIFICATION_ATTEMPTS,
+        requested_at: new Date().toISOString(),
+        original_task: originalTask,
+        critic_mode: getCriticMode(criticMode)
+    };
+    writeVerificationState(directory, state, sessionId);
+    return state;
+}
+/**
+ * Record architect feedback
+ */
+export function recordArchitectFeedback(directory, approved, feedback, sessionId) {
+    const state = readVerificationState(directory, sessionId);
+    if (!state) {
+        return null;
+    }
+    state.verification_attempts += 1;
+    state.architect_approved = approved;
+    state.architect_feedback = feedback;
+    if (approved) {
+        // Clear state on approval
+        clearVerificationState(directory, sessionId);
+        return { ...state, pending: false };
+    }
+    // Check if max attempts reached
+    if (state.verification_attempts >= state.max_verification_attempts) {
+        clearVerificationState(directory, sessionId);
+        return { ...state, pending: false };
+    }
+    // Continue verification loop
+    writeVerificationState(directory, state, sessionId);
+    return state;
+}
+/**
+ * Generate architect verification prompt
+ * When a currentStory is provided, includes its specific acceptance criteria for targeted verification.
+ */
+export function getArchitectVerificationPrompt(state, currentStory) {
+    const criticLabel = getCriticLabel(state.critic_mode);
+    const approvalTag = `<ralph-approved critic="${getCriticMode(state.critic_mode)}">VERIFIED_COMPLETE</ralph-approved>`;
+    const storySection = currentStory ? `
+**Current Story: ${currentStory.id} - ${currentStory.title}**
+${currentStory.description}
+
+**Acceptance Criteria to Verify:**
+${currentStory.acceptanceCriteria.map((c, i) => `${i + 1}. ${c}`).join('\n')}
+
+IMPORTANT: Verify EACH acceptance criterion above is met. Do not verify based on general impressions — check each criterion individually with concrete evidence.
+` : '';
+    return `<ralph-verification>
+
+[${criticLabel.toUpperCase()} VERIFICATION REQUIRED - Attempt ${state.verification_attempts + 1}/${state.max_verification_attempts}]
+
+The agent claims the task is complete. Before accepting, YOU MUST verify with ${criticLabel}.
+
+**Original Task:**
+${state.original_task}
+
+**Completion Claim:**
+${state.completion_claim}
+
+${state.architect_feedback ? `**Previous ${criticLabel} Feedback (rejected):**\n${state.architect_feedback}\n` : ''}
+${storySection}
+## MANDATORY VERIFICATION STEPS
+
+${getVerificationAgentStep(state.critic_mode)}
+
+2. **${criticLabel} must check:**${currentStory ? `
+   - Verify EACH acceptance criterion listed above is met with fresh evidence
+   - Run the relevant tests/builds to confirm criteria pass` : `
+   - Are ALL requirements from the original task met?
+   - Is the implementation complete, not partial?`}
+   - Are there any obvious bugs or issues?
+   - Does the code compile/run without errors?
+   - Are tests passing (if applicable)?
+
+3. **Based on ${criticLabel}'s response:**
+   - If APPROVED: Output \`${approvalTag}\`, then run \`/oh-my-claudecode:cancel\` to cleanly exit
+   - If REJECTED: Continue working on the identified issues
+
+</ralph-verification>
+
+---
+
+`;
+}
+/**
+ * Generate continuation prompt after architect rejection
+ */
+export function getArchitectRejectionContinuationPrompt(state) {
+    const criticLabel = getCriticLabel(state.critic_mode);
+    return `<ralph-continuation-after-rejection>
+
+[${criticLabel.toUpperCase()} REJECTED - Continue Working]
+
+${criticLabel} found issues with your completion claim. You must address them.
+
+**${criticLabel} Feedback:**
+${state.architect_feedback}
+
+**Original Task:**
+${state.original_task}
+
+## INSTRUCTIONS
+
+1. Address ALL issues identified by ${criticLabel}
+2. Do NOT claim completion again until issues are fixed
+3. When truly done, another ${criticLabel} verification will be triggered
+4. After ${criticLabel} approves, run \`/oh-my-claudecode:cancel\` to cleanly exit
+
+Continue working now.
+
+</ralph-continuation-after-rejection>
+
+---
+
+`;
+}
+/**
+ * Check if text contains architect approval
+ */
+export function detectArchitectApproval(text) {
+    return /<(?:architect-approved|ralph-approved)(?:\s+[^>]*)?>.*?VERIFIED_COMPLETE.*?<\/(?:architect-approved|ralph-approved)>/is.test(text);
+}
+/**
+ * Check if text contains architect rejection indicators
+ */
+export function detectArchitectRejection(text) {
+    // Look for explicit rejection patterns
+    const rejectionPatterns = [
+        /(architect|critic|codex|reviewer).*?(rejected|found issues|not complete|incomplete)/i,
+        /issues? (found|identified|detected)/i,
+        /not yet complete/i,
+        /missing.*?(implementation|feature|test)/i,
+        /bug.*?(found|detected|identified)/i,
+        /error.*?(found|detected|identified)/i
+    ];
+    for (const pattern of rejectionPatterns) {
+        if (pattern.test(text)) {
+            // Extract feedback (rough heuristic)
+            const feedbackMatch = text.match(/(?:architect|critic|codex|reviewer|feedback|issue|problem|error|bug)[:\s]+([^.]+\.)/i);
+            return {
+                rejected: true,
+                feedback: feedbackMatch ? feedbackMatch[1] : 'Architect found issues with the implementation.'
+            };
+        }
+    }
+    return { rejected: false, feedback: '' };
+}
+//# sourceMappingURL=verifier.js.map

package/dist/hooks/ralph/verifier.js.map

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

package/dist/hooks/recovery/__tests__/storage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.test.d.ts.map

package/dist/hooks/recovery/__tests__/storage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/recovery/__tests__/storage.test.ts"],"names":[],"mappings":""}

package/dist/hooks/recovery/__tests__/storage.test.js

@@ -0,0 +1,65 @@
+import { mkdtempSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const SYNTHETIC_THINKING_CONTENT = '[Synthetic thinking block inserted to preserve message structure]';
+describe('recovery storage issue #1386 regression', () => {
+    const originalXdgDataHome = process.env.XDG_DATA_HOME;
+    let dataDir;
+    beforeEach(() => {
+        dataDir = mkdtempSync(join(tmpdir(), 'issue-1386-recovery-'));
+        process.env.XDG_DATA_HOME = dataDir;
+        vi.resetModules();
+    });
+    afterEach(() => {
+        if (originalXdgDataHome === undefined) {
+            delete process.env.XDG_DATA_HOME;
+        }
+        else {
+            process.env.XDG_DATA_HOME = originalXdgDataHome;
+        }
+        vi.resetModules();
+    });
+    it('prepends generic synthetic thinking instead of reusing prior assistant thinking', async () => {
+        const sessionID = 'session-1';
+        const priorMessageID = 'assistant-1';
+        const targetMessageID = 'assistant-2';
+        const staleThinking = 'Old reasoning that should never be copied forward';
+        const storageRoot = join(dataDir, 'claude-code', 'storage');
+        const messageDir = join(storageRoot, 'message', sessionID);
+        const priorPartDir = join(storageRoot, 'part', priorMessageID);
+        const targetPartDir = join(storageRoot, 'part', targetMessageID);
+        mkdirSync(messageDir, { recursive: true });
+        mkdirSync(priorPartDir, { recursive: true });
+        mkdirSync(targetPartDir, { recursive: true });
+        writeFileSync(join(messageDir, `${priorMessageID}.json`), JSON.stringify({
+            id: priorMessageID,
+            sessionID,
+            role: 'assistant',
+            time: { created: 1 },
+        }));
+        writeFileSync(join(messageDir, `${targetMessageID}.json`), JSON.stringify({
+            id: targetMessageID,
+            sessionID,
+            role: 'assistant',
+            time: { created: 2 },
+        }));
+        writeFileSync(join(priorPartDir, 'thinking.json'), JSON.stringify({
+            id: 'thinking-1',
+            sessionID,
+            messageID: priorMessageID,
+            type: 'thinking',
+            thinking: staleThinking,
+        }));
+        const { prependThinkingPart } = await import('../storage.js');
+        expect(prependThinkingPart(sessionID, targetMessageID)).toBe(true);
+        const insertedPart = JSON.parse(readFileSync(join(targetPartDir, 'prt_0000000000_thinking.json'), 'utf-8'));
+        expect(insertedPart).toMatchObject({
+            type: 'thinking',
+            synthetic: true,
+            thinking: SYNTHETIC_THINKING_CONTENT,
+        });
+        expect(insertedPart.thinking).not.toContain(staleThinking);
+    });
+});
+//# sourceMappingURL=storage.test.js.map

package/dist/hooks/recovery/__tests__/storage.test.js.map

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

package/dist/hooks/recovery/constants.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Unified Recovery Constants
+ *
+ * Constants, messages, and patterns for all recovery mechanisms.
+ */
+export declare const CLAUDE_CODE_STORAGE: string;
+export declare const MESSAGE_STORAGE: string;
+export declare const PART_STORAGE: string;
+/**
+ * Debug logging configuration
+ */
+export declare const DEBUG: boolean;
+export declare const DEBUG_FILE: string;
+/**
+ * Part type sets for categorization
+ */
+export declare const THINKING_TYPES: Set<string>;
+export declare const META_TYPES: Set<string>;
+export declare const CONTENT_TYPES: Set<string>;
+/**
+ * Placeholder text for empty content
+ */
+export declare const PLACEHOLDER_TEXT = "[user interrupted]";
+/**
+ * ============================================================================
+ * CONTEXT WINDOW LIMIT RECOVERY
+ * ============================================================================
+ */
+/**
+ * Recovery message when context window limit is hit
+ */
+export declare const CONTEXT_LIMIT_RECOVERY_MESSAGE = "CONTEXT WINDOW LIMIT REACHED - IMMEDIATE ACTION REQUIRED\n\nThe conversation has exceeded the model's context window limit. To continue working effectively, you must take one of these actions:\n\n1. SUMMARIZE THE CONVERSATION\n   - Use the /compact command if available\n   - Or provide a concise summary of what has been accomplished so far\n   - Include key decisions, code changes, and remaining tasks\n\n2. START A FRESH CONTEXT\n   - If summarization isn't sufficient, suggest starting a new session\n   - Provide a handoff message with essential context\n\n3. REDUCE OUTPUT SIZE\n   - When showing code, show only relevant portions\n   - Use file paths and line numbers instead of full code blocks\n   - Be more concise in explanations\n\nIMPORTANT: Do not attempt to continue without addressing this limit.\nThe API will reject further requests until the context is reduced.\n\nCurrent Status:\n- Context limit exceeded\n- Further API calls will fail until context is reduced\n- Action required before continuing\n";
+/**
+ * Short notification for context limit
+ */
+export declare const CONTEXT_LIMIT_SHORT_MESSAGE = "Context window limit reached. Please use /compact to summarize the conversation or start a new session.";
+/**
+ * Recovery message for non-empty content errors
+ */
+export declare const NON_EMPTY_CONTENT_RECOVERY_MESSAGE = "API ERROR: Non-empty content validation failed.\n\nThis error typically occurs when:\n- A message has empty text content\n- The conversation structure is invalid\n\nSuggested actions:\n1. Continue with a new message\n2. If the error persists, start a new session\n\nThe system will attempt automatic recovery.\n";
+/**
+ * Recovery message when truncation was applied
+ */
+export declare const TRUNCATION_APPLIED_MESSAGE = "CONTEXT OPTIMIZATION APPLIED\n\nSome tool outputs have been truncated to fit within the context window.\nThe conversation can now continue normally.\n\nIf you need to see the full output of a previous tool call, you can:\n- Re-run the specific command\n- Ask to see a particular file or section\n\nContinuing with the current task...\n";
+/**
+ * Message when recovery fails
+ */
+export declare const RECOVERY_FAILED_MESSAGE = "CONTEXT RECOVERY FAILED\n\nAll automatic recovery attempts have been exhausted.\nPlease start a new session to continue.\n\nBefore starting a new session:\n1. Note what has been accomplished\n2. Save any important code changes\n3. Document the current state of the task\n\nYou can copy this conversation summary to continue in a new session.\n";
+/**
+ * Patterns to extract token counts from error messages
+ */
+export declare const TOKEN_LIMIT_PATTERNS: RegExp[];
+/**
+ * Keywords indicating token limit errors
+ */
+export declare const TOKEN_LIMIT_KEYWORDS: string[];
+/**
+ * ============================================================================
+ * EDIT ERROR RECOVERY
+ * ============================================================================
+ */
+/**
+ * Known Edit tool error patterns that indicate the AI made a mistake
+ */
+export declare const EDIT_ERROR_PATTERNS: readonly ["oldString and newString must be different", "oldString not found", "oldString found multiple times", "old_string not found", "old_string and new_string must be different"];
+/**
+ * System reminder injected when Edit tool fails due to AI mistake
+ * Short, direct, and commanding - forces immediate corrective action
+ */
+export declare const EDIT_ERROR_REMINDER = "\n[EDIT ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou made an Edit mistake. STOP and do this NOW:\n\n1. READ the file immediately to see its ACTUAL current state\n2. VERIFY what the content really looks like (your assumption was wrong)\n3. APOLOGIZE briefly to the user for the error\n4. CONTINUE with corrected action based on the real file content\n\nDO NOT attempt another edit until you've read and verified the file state.\n";
+/**
+ * ============================================================================
+ * SESSION RECOVERY
+ * ============================================================================
+ */
+/**
+ * Recovery messages for different error types
+ */
+export declare const RECOVERY_MESSAGES: {
+    readonly tool_result_missing: {
+        readonly title: "Tool Crash Recovery";
+        readonly message: "Injecting cancelled tool results...";
+    };
+    readonly thinking_block_order: {
+        readonly title: "Thinking Block Recovery";
+        readonly message: "Fixing message structure...";
+    };
+    readonly thinking_disabled_violation: {
+        readonly title: "Thinking Strip Recovery";
+        readonly message: "Stripping thinking blocks...";
+    };
+    readonly empty_content: {
+        readonly title: "Empty Content Recovery";
+        readonly message: "Adding placeholder content...";
+    };
+    readonly context_window_limit: {
+        readonly title: "Context Window Limit";
+        readonly message: "Context limit reached - recovery required";
+    };
+    readonly edit_error: {
+        readonly title: "Edit Error";
+        readonly message: "Edit operation failed - corrective action needed";
+    };
+};
+/**
+ * Recovery error patterns
+ */
+export declare const ERROR_PATTERNS: {
+    readonly tool_result_missing: readonly ["tool_use", "tool_result"];
+    readonly thinking_block_order: readonly ["thinking", "first block", "must start with", "preceeding", "final block", "cannot be thinking"];
+    readonly thinking_disabled_violation: readonly ["thinking is disabled", "cannot contain"];
+    readonly empty_content: readonly ["empty", "content", "message"];
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/recovery/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/recovery/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,eAAO,MAAM,mBAAmB,QAA4B,CAAC;AAC7D,eAAO,MAAM,eAAe,QAAuC,CAAC;AACpE,eAAO,MAAM,YAAY,QAAoC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,KAAK,SAG0B,CAAC;AAE7C,eAAO,MAAM,UAAU,QAAuC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,cAAc,aAA0D,CAAC;AACtF,eAAO,MAAM,UAAU,aAAyC,CAAC;AACjE,eAAO,MAAM,aAAa,aAAuD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B,kgCAyB1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,4GAA4G,CAAC;AAErJ;;GAEG;AACH,eAAO,MAAM,kCAAkC,4TAW9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,oVAUtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,4VAWnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAMhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAShC,CAAC;AAEF;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,wLAMtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8aAW/B,CAAC;AAEF;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAYjB,CAAC"}