oh-my-claude-sisyphus 1.10.0 → 1.10.2

package/dist/installer/hooks.d.ts

@@ -80,7 +80,7 @@ export declare const STOP_CONTINUATION_SCRIPT_NODE = "#!/usr/bin/env node\n// Si
  * Persistent Mode Bash script
  * Enhanced stop hook that handles ultrawork, ralph-loop, and todo continuation
  */
-export declare const PERSISTENT_MODE_SCRIPT = "#!/bin/bash\n# Sisyphus Persistent Mode Hook\n# Unified handler for ultrawork, ralph-loop, and todo continuation\n# Prevents stopping when work remains incomplete\n\n# Read stdin\nINPUT=$(cat)\n\n# Get session ID and directory\nSESSION_ID=\"\"\nDIRECTORY=\"\"\nif command -v jq &> /dev/null; then\n  SESSION_ID=$(echo \"$INPUT\" | jq -r '.sessionId // .session_id // \"\"' 2>/dev/null)\n  DIRECTORY=$(echo \"$INPUT\" | jq -r '.directory // \"\"' 2>/dev/null)\nfi\n\n# Default to current directory\nif [ -z \"$DIRECTORY\" ]; then\n  DIRECTORY=$(pwd)\nfi\n\n# Check for active ultrawork state\nULTRAWORK_STATE=\"\"\nif [ -f \"$DIRECTORY/.sisyphus/ultrawork-state.json\" ]; then\n  ULTRAWORK_STATE=$(cat \"$DIRECTORY/.sisyphus/ultrawork-state.json\" 2>/dev/null)\nelif [ -f \"$HOME/.claude/ultrawork-state.json\" ]; then\n  ULTRAWORK_STATE=$(cat \"$HOME/.claude/ultrawork-state.json\" 2>/dev/null)\nfi\n\n# Check for active ralph loop\nRALPH_STATE=\"\"\nif [ -f \"$DIRECTORY/.sisyphus/ralph-state.json\" ]; then\n  RALPH_STATE=$(cat \"$DIRECTORY/.sisyphus/ralph-state.json\" 2>/dev/null)\nfi\n\n# Check for incomplete todos\nINCOMPLETE_COUNT=0\nTODOS_DIR=\"$HOME/.claude/todos\"\nif [ -d \"$TODOS_DIR\" ]; then\n  for todo_file in \"$TODOS_DIR\"/*.json; do\n    if [ -f \"$todo_file\" ]; then\n      if command -v jq &> /dev/null; then\n        COUNT=$(jq '[.[] | select(.status != \"completed\" and .status != \"cancelled\")] | length' \"$todo_file\" 2>/dev/null || echo \"0\")\n        INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n      else\n        # Fallback: count \"pending\" or \"in_progress\" occurrences\n        COUNT=$(grep -c '\"status\"[[:space:]]*:[[:space:]]*\"pending\\|in_progress\"' \"$todo_file\" 2>/dev/null) || COUNT=0\n        INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n      fi\n    fi\n  done\nfi\n\n# Check project todos as well\nfor todo_path in \"$DIRECTORY/.sisyphus/todos.json\" \"$DIRECTORY/.claude/todos.json\"; do\n  if [ -f \"$todo_path\" ]; then\n    if command -v jq &> /dev/null; then\n      COUNT=$(jq 'if type == \"array\" then [.[] | select(.status != \"completed\" and .status != \"cancelled\")] | length else 0 end' \"$todo_path\" 2>/dev/null || echo \"0\")\n      INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n    else\n      # Fallback: count \"pending\" or \"in_progress\" occurrences\n      COUNT=$(grep -c '\"status\"[[:space:]]*:[[:space:]]*\"pending\\|in_progress\"' \"$todo_path\" 2>/dev/null) || COUNT=0\n      INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n    fi\n  fi\ndone\n\n# Priority 1: Ralph Loop\nif [ -n \"$RALPH_STATE\" ]; then\n  IS_ACTIVE=$(echo \"$RALPH_STATE\" | jq -r '.active // false' 2>/dev/null)\n  if [ \"$IS_ACTIVE\" = \"true\" ]; then\n    ITERATION=$(echo \"$RALPH_STATE\" | jq -r '.iteration // 1' 2>/dev/null)\n    MAX_ITER=$(echo \"$RALPH_STATE\" | jq -r '.max_iterations // 10' 2>/dev/null)\n    PROMISE=$(echo \"$RALPH_STATE\" | jq -r '.completion_promise // \"TASK_COMPLETE\"' 2>/dev/null)\n    PROMPT=$(echo \"$RALPH_STATE\" | jq -r '.prompt // \"\"' 2>/dev/null)\n\n    if [ \"$ITERATION\" -lt \"$MAX_ITER\" ]; then\n      # Increment iteration\n      NEW_ITER=$((ITERATION + 1))\n      echo \"$RALPH_STATE\" | jq \".iteration = $NEW_ITER\" > \"$DIRECTORY/.sisyphus/ralph-state.json\" 2>/dev/null\n\n      cat << EOF\n{\"continue\": false, \"reason\": \"<ralph-loop-continuation>\\n\\n[RALPH LOOP - ITERATION $NEW_ITER/$MAX_ITER]\\n\\nYour previous attempt did not output the completion promise. The work is NOT done yet.\\n\\nCRITICAL INSTRUCTIONS:\\n1. Review your progress and the original task\\n2. Check your todo list - are ALL items marked complete?\\n3. Continue from where you left off\\n4. When FULLY complete, output: <promise>$PROMISE</promise>\\n5. Do NOT stop until the task is truly done\\n\\nOriginal task: $PROMPT\\n\\n</ralph-loop-continuation>\\n\\n---\\n\"}\nEOF\n      exit 0\n    fi\n  fi\nfi\n\n# Priority 2: Ultrawork Mode with incomplete todos\nif [ -n \"$ULTRAWORK_STATE\" ] && [ \"$INCOMPLETE_COUNT\" -gt 0 ]; then\n  # Check if active (with jq fallback)\n  IS_ACTIVE=\"\"\n  if command -v jq &> /dev/null; then\n    IS_ACTIVE=$(echo \"$ULTRAWORK_STATE\" | jq -r '.active // false' 2>/dev/null)\n  else\n    # Fallback: grep for \"active\": true\n    if echo \"$ULTRAWORK_STATE\" | grep -q '\"active\"[[:space:]]*:[[:space:]]*true'; then\n      IS_ACTIVE=\"true\"\n    fi\n  fi\n\n  if [ \"$IS_ACTIVE\" = \"true\" ]; then\n    # Get reinforcement count (with fallback)\n    REINFORCE_COUNT=0\n    if command -v jq &> /dev/null; then\n      REINFORCE_COUNT=$(echo \"$ULTRAWORK_STATE\" | jq -r '.reinforcement_count // 0' 2>/dev/null)\n    else\n      REINFORCE_COUNT=$(echo \"$ULTRAWORK_STATE\" | grep -oP '\"reinforcement_count\"[[:space:]]*:[[:space:]]*\\K[0-9]+' 2>/dev/null) || REINFORCE_COUNT=0\n    fi\n    NEW_COUNT=$((REINFORCE_COUNT + 1))\n\n    # Get original prompt (with fallback)\n    ORIGINAL_PROMPT=\"\"\n    if command -v jq &> /dev/null; then\n      ORIGINAL_PROMPT=$(echo \"$ULTRAWORK_STATE\" | jq -r '.original_prompt // \"\"' 2>/dev/null)\n    else\n      ORIGINAL_PROMPT=$(echo \"$ULTRAWORK_STATE\" | grep -oP '\"original_prompt\"[[:space:]]*:[[:space:]]*\"\\K[^\"]+' 2>/dev/null) || ORIGINAL_PROMPT=\"\"\n    fi\n\n    # Update state file (best effort)\n    if command -v jq &> /dev/null; then\n      echo \"$ULTRAWORK_STATE\" | jq \".reinforcement_count = $NEW_COUNT | .last_checked_at = \\\"$(date -Iseconds)\\\"\" > \"$DIRECTORY/.sisyphus/ultrawork-state.json\" 2>/dev/null\n    fi\n\n    cat << EOF\n{\"continue\": false, \"reason\": \"<ultrawork-persistence>\\n\\n[ULTRAWORK MODE STILL ACTIVE - Reinforcement #$NEW_COUNT]\\n\\nYour ultrawork session is NOT complete. $INCOMPLETE_COUNT incomplete todos remain.\\n\\nREMEMBER THE ULTRAWORK RULES:\\n- **PARALLEL**: Fire independent calls simultaneously - NEVER wait sequentially\\n- **BACKGROUND FIRST**: Use Task(run_in_background=true) for exploration (10+ concurrent)\\n- **TODO**: Track EVERY step. Mark complete IMMEDIATELY after each\\n- **VERIFY**: Check ALL requirements met before done\\n- **NO Premature Stopping**: ALL TODOs must be complete\\n\\nContinue working on the next pending task. DO NOT STOP until all tasks are marked complete.\\n\\nOriginal task: $ORIGINAL_PROMPT\\n\\n</ultrawork-persistence>\\n\\n---\\n\"}\nEOF\n    exit 0\n  fi\nfi\n\n# Priority 3: Todo Continuation (baseline)\nif [ \"$INCOMPLETE_COUNT\" -gt 0 ]; then\n  cat << EOF\n{\"continue\": false, \"reason\": \"<todo-continuation>\\n\\n[SYSTEM REMINDER - TODO CONTINUATION]\\n\\nIncomplete tasks remain in your todo list ($INCOMPLETE_COUNT remaining). Continue working on the next pending task.\\n\\n- Proceed without asking for permission\\n- Mark each task complete when finished\\n- Do not stop until all tasks are done\\n\\n</todo-continuation>\\n\\n---\\n\"}\nEOF\n  exit 0\nfi\n\n# No blocking needed\necho '{\"continue\": true}'\nexit 0\n";
+export declare const PERSISTENT_MODE_SCRIPT = "#!/bin/bash\n# Sisyphus Persistent Mode Hook\n# Unified handler for ultrawork, ralph-loop, and todo continuation\n# Prevents stopping when work remains incomplete\n\n# Read stdin\nINPUT=$(cat)\n\n# Get session ID and directory\nSESSION_ID=\"\"\nDIRECTORY=\"\"\nif command -v jq &> /dev/null; then\n  SESSION_ID=$(echo \"$INPUT\" | jq -r '.sessionId // .session_id // \"\"' 2>/dev/null)\n  DIRECTORY=$(echo \"$INPUT\" | jq -r '.directory // \"\"' 2>/dev/null)\nfi\n\n# Default to current directory\nif [ -z \"$DIRECTORY\" ]; then\n  DIRECTORY=$(pwd)\nfi\n\n# Check for active ultrawork state\nULTRAWORK_STATE=\"\"\nif [ -f \"$DIRECTORY/.sisyphus/ultrawork-state.json\" ]; then\n  ULTRAWORK_STATE=$(cat \"$DIRECTORY/.sisyphus/ultrawork-state.json\" 2>/dev/null)\nelif [ -f \"$HOME/.claude/ultrawork-state.json\" ]; then\n  ULTRAWORK_STATE=$(cat \"$HOME/.claude/ultrawork-state.json\" 2>/dev/null)\nfi\n\n# Check for active ralph loop\nRALPH_STATE=\"\"\nif [ -f \"$DIRECTORY/.sisyphus/ralph-state.json\" ]; then\n  RALPH_STATE=$(cat \"$DIRECTORY/.sisyphus/ralph-state.json\" 2>/dev/null)\nfi\n\n# Check for verification state (oracle verification)\nVERIFICATION_STATE=\"\"\nif [ -f \"$DIRECTORY/.sisyphus/ralph-verification.json\" ]; then\n  VERIFICATION_STATE=$(cat \"$DIRECTORY/.sisyphus/ralph-verification.json\" 2>/dev/null)\nfi\n\n# Check for incomplete todos\nINCOMPLETE_COUNT=0\nTODOS_DIR=\"$HOME/.claude/todos\"\nif [ -d \"$TODOS_DIR\" ]; then\n  for todo_file in \"$TODOS_DIR\"/*.json; do\n    if [ -f \"$todo_file\" ]; then\n      if command -v jq &> /dev/null; then\n        COUNT=$(jq '[.[] | select(.status != \"completed\" and .status != \"cancelled\")] | length' \"$todo_file\" 2>/dev/null || echo \"0\")\n        INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n      else\n        # Fallback: count \"pending\" or \"in_progress\" occurrences\n        COUNT=$(grep -c '\"status\"[[:space:]]*:[[:space:]]*\"pending\\|in_progress\"' \"$todo_file\" 2>/dev/null) || COUNT=0\n        INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n      fi\n    fi\n  done\nfi\n\n# Check project todos as well\nfor todo_path in \"$DIRECTORY/.sisyphus/todos.json\" \"$DIRECTORY/.claude/todos.json\"; do\n  if [ -f \"$todo_path\" ]; then\n    if command -v jq &> /dev/null; then\n      COUNT=$(jq 'if type == \"array\" then [.[] | select(.status != \"completed\" and .status != \"cancelled\")] | length else 0 end' \"$todo_path\" 2>/dev/null || echo \"0\")\n      INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n    else\n      # Fallback: count \"pending\" or \"in_progress\" occurrences\n      COUNT=$(grep -c '\"status\"[[:space:]]*:[[:space:]]*\"pending\\|in_progress\"' \"$todo_path\" 2>/dev/null) || COUNT=0\n      INCOMPLETE_COUNT=$((INCOMPLETE_COUNT + COUNT))\n    fi\n  fi\ndone\n\n# Priority 1: Ralph Loop with Oracle Verification\nif [ -n \"$RALPH_STATE\" ]; then\n  IS_ACTIVE=$(echo \"$RALPH_STATE\" | jq -r '.active // false' 2>/dev/null)\n  if [ \"$IS_ACTIVE\" = \"true\" ]; then\n    ITERATION=$(echo \"$RALPH_STATE\" | jq -r '.iteration // 1' 2>/dev/null)\n    MAX_ITER=$(echo \"$RALPH_STATE\" | jq -r '.max_iterations // 10' 2>/dev/null)\n    PROMISE=$(echo \"$RALPH_STATE\" | jq -r '.completion_promise // \"TASK_COMPLETE\"' 2>/dev/null)\n    PROMPT=$(echo \"$RALPH_STATE\" | jq -r '.prompt // \"\"' 2>/dev/null)\n\n    # Check if oracle verification is pending\n    if [ -n \"$VERIFICATION_STATE\" ]; then\n      IS_PENDING=$(echo \"$VERIFICATION_STATE\" | jq -r '.pending // false' 2>/dev/null)\n      if [ \"$IS_PENDING\" = \"true\" ]; then\n        ATTEMPT=$(echo \"$VERIFICATION_STATE\" | jq -r '.verification_attempts // 0' 2>/dev/null)\n        MAX_ATTEMPTS=$(echo \"$VERIFICATION_STATE\" | jq -r '.max_verification_attempts // 3' 2>/dev/null)\n        ORIGINAL_TASK=$(echo \"$VERIFICATION_STATE\" | jq -r '.original_task // \"\"' 2>/dev/null)\n        COMPLETION_CLAIM=$(echo \"$VERIFICATION_STATE\" | jq -r '.completion_claim // \"\"' 2>/dev/null)\n        ORACLE_FEEDBACK=$(echo \"$VERIFICATION_STATE\" | jq -r '.oracle_feedback // \"\"' 2>/dev/null)\n        NEXT_ATTEMPT=$((ATTEMPT + 1))\n\n        FEEDBACK_SECTION=\"\"\n        if [ -n \"$ORACLE_FEEDBACK\" ] && [ \"$ORACLE_FEEDBACK\" != \"null\" ]; then\n          FEEDBACK_SECTION=\"\\n**Previous Oracle Feedback (rejected):**\\n$ORACLE_FEEDBACK\\n\"\n        fi\n\n        cat << EOF\n{\"continue\": false, \"reason\": \"<ralph-verification>\\n\\n[ORACLE VERIFICATION REQUIRED - Attempt $NEXT_ATTEMPT/$MAX_ATTEMPTS]\\n\\nThe agent claims the task is complete. Before accepting, YOU MUST verify with Oracle.\\n\\n**Original Task:**\\n$ORIGINAL_TASK\\n\\n**Completion Claim:**\\n$COMPLETION_CLAIM\\n$FEEDBACK_SECTION\\n## MANDATORY VERIFICATION STEPS\\n\\n1. **Spawn Oracle Agent** for verification:\\n   \\`\\`\\`\\n   Task(subagent_type=\\\"oracle\\\", prompt=\\\"Verify this task completion claim...\\\")\\n   \\`\\`\\`\\n\\n2. **Oracle must check:**\\n   - Are ALL requirements from the original task met?\\n   - Is the implementation complete, not partial?\\n   - Are there any obvious bugs or issues?\\n   - Does the code compile/run without errors?\\n   - Are tests passing (if applicable)?\\n\\n3. **Based on Oracle's response:**\\n   - If APPROVED: Output \\`<oracle-approved>VERIFIED_COMPLETE</oracle-approved>\\`\\n   - If REJECTED: Continue working on the identified issues\\n\\nDO NOT output the completion promise again until Oracle approves.\\n\\n</ralph-verification>\\n\\n---\\n\"}\nEOF\n        exit 0\n      fi\n    fi\n\n    if [ \"$ITERATION\" -lt \"$MAX_ITER\" ]; then\n      # Increment iteration\n      NEW_ITER=$((ITERATION + 1))\n      echo \"$RALPH_STATE\" | jq \".iteration = $NEW_ITER\" > \"$DIRECTORY/.sisyphus/ralph-state.json\" 2>/dev/null\n\n      cat << EOF\n{\"continue\": false, \"reason\": \"<ralph-loop-continuation>\\n\\n[RALPH LOOP - ITERATION $NEW_ITER/$MAX_ITER]\\n\\nYour previous attempt did not output the completion promise. The work is NOT done yet.\\n\\nCRITICAL INSTRUCTIONS:\\n1. Review your progress and the original task\\n2. Check your todo list - are ALL items marked complete?\\n3. Continue from where you left off\\n4. When FULLY complete, output: <promise>$PROMISE</promise>\\n5. Do NOT stop until the task is truly done\\n\\nOriginal task: $PROMPT\\n\\n</ralph-loop-continuation>\\n\\n---\\n\"}\nEOF\n      exit 0\n    fi\n  fi\nfi\n\n# Priority 2: Ultrawork Mode with incomplete todos\nif [ -n \"$ULTRAWORK_STATE\" ] && [ \"$INCOMPLETE_COUNT\" -gt 0 ]; then\n  # Check if active (with jq fallback)\n  IS_ACTIVE=\"\"\n  if command -v jq &> /dev/null; then\n    IS_ACTIVE=$(echo \"$ULTRAWORK_STATE\" | jq -r '.active // false' 2>/dev/null)\n  else\n    # Fallback: grep for \"active\": true\n    if echo \"$ULTRAWORK_STATE\" | grep -q '\"active\"[[:space:]]*:[[:space:]]*true'; then\n      IS_ACTIVE=\"true\"\n    fi\n  fi\n\n  if [ \"$IS_ACTIVE\" = \"true\" ]; then\n    # Get reinforcement count (with fallback)\n    REINFORCE_COUNT=0\n    if command -v jq &> /dev/null; then\n      REINFORCE_COUNT=$(echo \"$ULTRAWORK_STATE\" | jq -r '.reinforcement_count // 0' 2>/dev/null)\n    else\n      REINFORCE_COUNT=$(echo \"$ULTRAWORK_STATE\" | grep -oP '\"reinforcement_count\"[[:space:]]*:[[:space:]]*\\K[0-9]+' 2>/dev/null) || REINFORCE_COUNT=0\n    fi\n    NEW_COUNT=$((REINFORCE_COUNT + 1))\n\n    # Get original prompt (with fallback)\n    ORIGINAL_PROMPT=\"\"\n    if command -v jq &> /dev/null; then\n      ORIGINAL_PROMPT=$(echo \"$ULTRAWORK_STATE\" | jq -r '.original_prompt // \"\"' 2>/dev/null)\n    else\n      ORIGINAL_PROMPT=$(echo \"$ULTRAWORK_STATE\" | grep -oP '\"original_prompt\"[[:space:]]*:[[:space:]]*\"\\K[^\"]+' 2>/dev/null) || ORIGINAL_PROMPT=\"\"\n    fi\n\n    # Update state file (best effort)\n    if command -v jq &> /dev/null; then\n      echo \"$ULTRAWORK_STATE\" | jq \".reinforcement_count = $NEW_COUNT | .last_checked_at = \\\"$(date -Iseconds)\\\"\" > \"$DIRECTORY/.sisyphus/ultrawork-state.json\" 2>/dev/null\n    fi\n\n    cat << EOF\n{\"continue\": false, \"reason\": \"<ultrawork-persistence>\\n\\n[ULTRAWORK MODE STILL ACTIVE - Reinforcement #$NEW_COUNT]\\n\\nYour ultrawork session is NOT complete. $INCOMPLETE_COUNT incomplete todos remain.\\n\\nREMEMBER THE ULTRAWORK RULES:\\n- **PARALLEL**: Fire independent calls simultaneously - NEVER wait sequentially\\n- **BACKGROUND FIRST**: Use Task(run_in_background=true) for exploration (10+ concurrent)\\n- **TODO**: Track EVERY step. Mark complete IMMEDIATELY after each\\n- **VERIFY**: Check ALL requirements met before done\\n- **NO Premature Stopping**: ALL TODOs must be complete\\n\\nContinue working on the next pending task. DO NOT STOP until all tasks are marked complete.\\n\\nOriginal task: $ORIGINAL_PROMPT\\n\\n</ultrawork-persistence>\\n\\n---\\n\"}\nEOF\n    exit 0\n  fi\nfi\n\n# Priority 3: Todo Continuation (baseline)\nif [ \"$INCOMPLETE_COUNT\" -gt 0 ]; then\n  cat << EOF\n{\"continue\": false, \"reason\": \"<todo-continuation>\\n\\n[SYSTEM REMINDER - TODO CONTINUATION]\\n\\nIncomplete tasks remain in your todo list ($INCOMPLETE_COUNT remaining). Continue working on the next pending task.\\n\\n- Proceed without asking for permission\\n- Mark each task complete when finished\\n- Do not stop until all tasks are done\\n\\n</todo-continuation>\\n\\n---\\n\"}\nEOF\n  exit 0\nfi\n\n# No blocking needed\necho '{\"continue\": true}'\nexit 0\n";
 /**
  * Session Start Bash script
  * Restores persistent mode states when a new session starts
@@ -89,7 +89,7 @@ export declare const SESSION_START_SCRIPT = "#!/bin/bash\n# Sisyphus Session Sta
 /**
  * Node.js Persistent Mode Hook Script
  */
-export declare const PERSISTENT_MODE_SCRIPT_NODE = "#!/usr/bin/env node\n// Sisyphus Persistent Mode Hook (Node.js)\n// Unified handler for ultrawork, ralph-loop, and todo continuation\n// Cross-platform: Windows, macOS, Linux\n\nimport { existsSync, readFileSync, writeFileSync, readdirSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\n\nasync function readStdin() {\n  const chunks = [];\n  for await (const chunk of process.stdin) {\n    chunks.push(chunk);\n  }\n  return Buffer.concat(chunks).toString('utf-8');\n}\n\nfunction readJsonFile(path) {\n  try {\n    if (!existsSync(path)) return null;\n    return JSON.parse(readFileSync(path, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nfunction writeJsonFile(path, data) {\n  try {\n    writeFileSync(path, JSON.stringify(data, null, 2));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction countIncompleteTodos(todosDir, projectDir) {\n  let count = 0;\n\n  // Check global todos\n  if (existsSync(todosDir)) {\n    try {\n      const files = readdirSync(todosDir).filter(f => f.endsWith('.json'));\n      for (const file of files) {\n        const todos = readJsonFile(join(todosDir, file));\n        if (Array.isArray(todos)) {\n          count += todos.filter(t => t.status !== 'completed' && t.status !== 'cancelled').length;\n        }\n      }\n    } catch {}\n  }\n\n  // Check project todos\n  for (const path of [\n    join(projectDir, '.sisyphus', 'todos.json'),\n    join(projectDir, '.claude', 'todos.json')\n  ]) {\n    const todos = readJsonFile(path);\n    if (Array.isArray(todos)) {\n      count += todos.filter(t => t.status !== 'completed' && t.status !== 'cancelled').length;\n    }\n  }\n\n  return count;\n}\n\nasync function main() {\n  try {\n    const input = await readStdin();\n    let data = {};\n    try { data = JSON.parse(input); } catch {}\n\n    const directory = data.directory || process.cwd();\n    const todosDir = join(homedir(), '.claude', 'todos');\n\n    // Check for ultrawork state\n    let ultraworkState = readJsonFile(join(directory, '.sisyphus', 'ultrawork-state.json'))\n      || readJsonFile(join(homedir(), '.claude', 'ultrawork-state.json'));\n\n    // Check for ralph loop state\n    const ralphState = readJsonFile(join(directory, '.sisyphus', 'ralph-state.json'));\n\n    // Count incomplete todos\n    const incompleteCount = countIncompleteTodos(todosDir, directory);\n\n    // Priority 1: Ralph Loop\n    if (ralphState?.active) {\n      const iteration = ralphState.iteration || 1;\n      const maxIter = ralphState.max_iterations || 10;\n\n      if (iteration < maxIter) {\n        const newIter = iteration + 1;\n        ralphState.iteration = newIter;\n        writeJsonFile(join(directory, '.sisyphus', 'ralph-state.json'), ralphState);\n\n        console.log(JSON.stringify({\n          continue: false,\n          reason: `<ralph-loop-continuation>\n\n[RALPH LOOP - ITERATION ${newIter}/${maxIter}]\n\nYour previous attempt did not output the completion promise. The work is NOT done yet.\n\nCRITICAL INSTRUCTIONS:\n1. Review your progress and the original task\n2. Check your todo list - are ALL items marked complete?\n3. Continue from where you left off\n4. When FULLY complete, output: <promise>${ralphState.completion_promise || 'TASK_COMPLETE'}</promise>\n5. Do NOT stop until the task is truly done\n\n${ralphState.prompt ? `Original task: ${ralphState.prompt}` : ''}\n\n</ralph-loop-continuation>\n\n---\n`\n        }));\n        return;\n      }\n    }\n\n    // Priority 2: Ultrawork with incomplete todos\n    if (ultraworkState?.active && incompleteCount > 0) {\n      const newCount = (ultraworkState.reinforcement_count || 0) + 1;\n      ultraworkState.reinforcement_count = newCount;\n      ultraworkState.last_checked_at = new Date().toISOString();\n\n      writeJsonFile(join(directory, '.sisyphus', 'ultrawork-state.json'), ultraworkState);\n\n      console.log(JSON.stringify({\n        continue: false,\n        reason: `<ultrawork-persistence>\n\n[ULTRAWORK MODE STILL ACTIVE - Reinforcement #${newCount}]\n\nYour ultrawork session is NOT complete. ${incompleteCount} incomplete todos remain.\n\nREMEMBER THE ULTRAWORK RULES:\n- **PARALLEL**: Fire independent calls simultaneously - NEVER wait sequentially\n- **BACKGROUND FIRST**: Use Task(run_in_background=true) for exploration (10+ concurrent)\n- **TODO**: Track EVERY step. Mark complete IMMEDIATELY after each\n- **VERIFY**: Check ALL requirements met before done\n- **NO Premature Stopping**: ALL TODOs must be complete\n\nContinue working on the next pending task. DO NOT STOP until all tasks are marked complete.\n\n${ultraworkState.original_prompt ? `Original task: ${ultraworkState.original_prompt}` : ''}\n\n</ultrawork-persistence>\n\n---\n`\n      }));\n      return;\n    }\n\n    // Priority 3: Todo Continuation\n    if (incompleteCount > 0) {\n      console.log(JSON.stringify({\n        continue: false,\n        reason: `<todo-continuation>\n\n[SYSTEM REMINDER - TODO CONTINUATION]\n\nIncomplete tasks remain in your todo list (${incompleteCount} remaining). Continue working on the next pending task.\n\n- Proceed without asking for permission\n- Mark each task complete when finished\n- Do not stop until all tasks are done\n\n</todo-continuation>\n\n---\n`\n      }));\n      return;\n    }\n\n    // No blocking needed\n    console.log(JSON.stringify({ continue: true }));\n  } catch (error) {\n    console.log(JSON.stringify({ continue: true }));\n  }\n}\n\nmain();\n";
+export declare const PERSISTENT_MODE_SCRIPT_NODE = "#!/usr/bin/env node\n// Sisyphus Persistent Mode Hook (Node.js)\n// Unified handler for ultrawork, ralph-loop, and todo continuation\n// Cross-platform: Windows, macOS, Linux\n\nimport { existsSync, readFileSync, writeFileSync, readdirSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\n\nasync function readStdin() {\n  const chunks = [];\n  for await (const chunk of process.stdin) {\n    chunks.push(chunk);\n  }\n  return Buffer.concat(chunks).toString('utf-8');\n}\n\nfunction readJsonFile(path) {\n  try {\n    if (!existsSync(path)) return null;\n    return JSON.parse(readFileSync(path, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nfunction writeJsonFile(path, data) {\n  try {\n    writeFileSync(path, JSON.stringify(data, null, 2));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction countIncompleteTodos(todosDir, projectDir) {\n  let count = 0;\n\n  // Check global todos\n  if (existsSync(todosDir)) {\n    try {\n      const files = readdirSync(todosDir).filter(f => f.endsWith('.json'));\n      for (const file of files) {\n        const todos = readJsonFile(join(todosDir, file));\n        if (Array.isArray(todos)) {\n          count += todos.filter(t => t.status !== 'completed' && t.status !== 'cancelled').length;\n        }\n      }\n    } catch {}\n  }\n\n  // Check project todos\n  for (const path of [\n    join(projectDir, '.sisyphus', 'todos.json'),\n    join(projectDir, '.claude', 'todos.json')\n  ]) {\n    const todos = readJsonFile(path);\n    if (Array.isArray(todos)) {\n      count += todos.filter(t => t.status !== 'completed' && t.status !== 'cancelled').length;\n    }\n  }\n\n  return count;\n}\n\nasync function main() {\n  try {\n    const input = await readStdin();\n    let data = {};\n    try { data = JSON.parse(input); } catch {}\n\n    const directory = data.directory || process.cwd();\n    const todosDir = join(homedir(), '.claude', 'todos');\n\n    // Check for ultrawork state\n    let ultraworkState = readJsonFile(join(directory, '.sisyphus', 'ultrawork-state.json'))\n      || readJsonFile(join(homedir(), '.claude', 'ultrawork-state.json'));\n\n    // Check for ralph loop state\n    const ralphState = readJsonFile(join(directory, '.sisyphus', 'ralph-state.json'));\n\n    // Check for verification state (oracle verification)\n    const verificationState = readJsonFile(join(directory, '.sisyphus', 'ralph-verification.json'));\n\n    // Count incomplete todos\n    const incompleteCount = countIncompleteTodos(todosDir, directory);\n\n    // Priority 1: Ralph Loop with Oracle Verification\n    if (ralphState?.active) {\n      const iteration = ralphState.iteration || 1;\n      const maxIter = ralphState.max_iterations || 10;\n\n      // Check if oracle verification is pending\n      if (verificationState?.pending) {\n        const attempt = (verificationState.verification_attempts || 0) + 1;\n        const maxAttempts = verificationState.max_verification_attempts || 3;\n\n        console.log(JSON.stringify({\n          continue: false,\n          reason: `<ralph-verification>\n\n[ORACLE VERIFICATION REQUIRED - Attempt ${attempt}/${maxAttempts}]\n\nThe agent claims the task is complete. Before accepting, YOU MUST verify with Oracle.\n\n**Original Task:**\n${verificationState.original_task || ralphState.prompt || 'No task specified'}\n\n**Completion Claim:**\n${verificationState.completion_claim || 'Task marked complete'}\n\n${verificationState.oracle_feedback ? `**Previous Oracle Feedback (rejected):**\n${verificationState.oracle_feedback}\n` : ''}\n\n## MANDATORY VERIFICATION STEPS\n\n1. **Spawn Oracle Agent** for verification:\n   \\`\\`\\`\n   Task(subagent_type=\"oracle\", prompt=\"Verify this task completion claim...\")\n   \\`\\`\\`\n\n2. **Oracle must check:**\n   - Are ALL requirements from the original task met?\n   - Is the implementation complete, not partial?\n   - Are there any obvious bugs or issues?\n   - Does the code compile/run without errors?\n   - Are tests passing (if applicable)?\n\n3. **Based on Oracle's response:**\n   - If APPROVED: Output \\`<oracle-approved>VERIFIED_COMPLETE</oracle-approved>\\`\n   - If REJECTED: Continue working on the identified issues\n\nDO NOT output the completion promise again until Oracle approves.\n\n</ralph-verification>\n\n---\n`\n        }));\n        return;\n      }\n\n      if (iteration < maxIter) {\n        const newIter = iteration + 1;\n        ralphState.iteration = newIter;\n        writeJsonFile(join(directory, '.sisyphus', 'ralph-state.json'), ralphState);\n\n        console.log(JSON.stringify({\n          continue: false,\n          reason: `<ralph-loop-continuation>\n\n[RALPH LOOP - ITERATION ${newIter}/${maxIter}]\n\nYour previous attempt did not output the completion promise. The work is NOT done yet.\n\nCRITICAL INSTRUCTIONS:\n1. Review your progress and the original task\n2. Check your todo list - are ALL items marked complete?\n3. Continue from where you left off\n4. When FULLY complete, output: <promise>${ralphState.completion_promise || 'TASK_COMPLETE'}</promise>\n5. Do NOT stop until the task is truly done\n\n${ralphState.prompt ? `Original task: ${ralphState.prompt}` : ''}\n\n</ralph-loop-continuation>\n\n---\n`\n        }));\n        return;\n      }\n    }\n\n    // Priority 2: Ultrawork with incomplete todos\n    if (ultraworkState?.active && incompleteCount > 0) {\n      const newCount = (ultraworkState.reinforcement_count || 0) + 1;\n      ultraworkState.reinforcement_count = newCount;\n      ultraworkState.last_checked_at = new Date().toISOString();\n\n      writeJsonFile(join(directory, '.sisyphus', 'ultrawork-state.json'), ultraworkState);\n\n      console.log(JSON.stringify({\n        continue: false,\n        reason: `<ultrawork-persistence>\n\n[ULTRAWORK MODE STILL ACTIVE - Reinforcement #${newCount}]\n\nYour ultrawork session is NOT complete. ${incompleteCount} incomplete todos remain.\n\nREMEMBER THE ULTRAWORK RULES:\n- **PARALLEL**: Fire independent calls simultaneously - NEVER wait sequentially\n- **BACKGROUND FIRST**: Use Task(run_in_background=true) for exploration (10+ concurrent)\n- **TODO**: Track EVERY step. Mark complete IMMEDIATELY after each\n- **VERIFY**: Check ALL requirements met before done\n- **NO Premature Stopping**: ALL TODOs must be complete\n\nContinue working on the next pending task. DO NOT STOP until all tasks are marked complete.\n\n${ultraworkState.original_prompt ? `Original task: ${ultraworkState.original_prompt}` : ''}\n\n</ultrawork-persistence>\n\n---\n`\n      }));\n      return;\n    }\n\n    // Priority 3: Todo Continuation\n    if (incompleteCount > 0) {\n      console.log(JSON.stringify({\n        continue: false,\n        reason: `<todo-continuation>\n\n[SYSTEM REMINDER - TODO CONTINUATION]\n\nIncomplete tasks remain in your todo list (${incompleteCount} remaining). Continue working on the next pending task.\n\n- Proceed without asking for permission\n- Mark each task complete when finished\n- Do not stop until all tasks are done\n\n</todo-continuation>\n\n---\n`\n      }));\n      return;\n    }\n\n    // No blocking needed\n    console.log(JSON.stringify({ continue: true }));\n  } catch (error) {\n    console.log(JSON.stringify({ continue: true }));\n  }\n}\n\nmain();\n";
 /**
  * Node.js Session Start Hook Script
  */

package/dist/installer/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/installer/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,kCAAkC;AAClC,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,mCAAmC;AACnC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,woJA2F7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wcAgB9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,2TAU1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,8cAgB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,+PAME,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,khMAsGnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,u7CAwCpC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,+lNAsMxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,svEAgFzC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,ixNA+IlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,g0EA8DhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,m3KAyLvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,0iFAoGrC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAiCtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAyCtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,0BAA0B,CAE1E;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;CAA6B,CAAC;AAMhE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAqB,CAAC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/installer/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,kCAAkC;AAClC,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,mCAAmC;AACnC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,woJA2F7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wcAgB9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,2TAU1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,8cAgB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,+PAME,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,khMAsGnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,u7CAwCpC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,+lNAsMxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,svEAgFzC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,yqSA4KlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,g0EA8DhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,4oOA+OvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,0iFAoGrC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAiCtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAyCtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,0BAA0B,CAE1E;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;CAA6B,CAAC;AAMhE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAqB,CAAC"}

package/dist/installer/hooks.js

@@ -700,6 +700,12 @@ if [ -f "$DIRECTORY/.sisyphus/ralph-state.json" ]; then
   RALPH_STATE=$(cat "$DIRECTORY/.sisyphus/ralph-state.json" 2>/dev/null)
 fi
 
+# Check for verification state (oracle verification)
+VERIFICATION_STATE=""
+if [ -f "$DIRECTORY/.sisyphus/ralph-verification.json" ]; then
+  VERIFICATION_STATE=$(cat "$DIRECTORY/.sisyphus/ralph-verification.json" 2>/dev/null)
+fi
+
 # Check for incomplete todos
 INCOMPLETE_COUNT=0
 TODOS_DIR="$HOME/.claude/todos"
@@ -732,7 +738,7 @@ for todo_path in "$DIRECTORY/.sisyphus/todos.json" "$DIRECTORY/.claude/todos.jso
   fi
 done
 
-# Priority 1: Ralph Loop
+# Priority 1: Ralph Loop with Oracle Verification
 if [ -n "$RALPH_STATE" ]; then
   IS_ACTIVE=$(echo "$RALPH_STATE" | jq -r '.active // false' 2>/dev/null)
   if [ "$IS_ACTIVE" = "true" ]; then
@@ -741,6 +747,29 @@ if [ -n "$RALPH_STATE" ]; then
     PROMISE=$(echo "$RALPH_STATE" | jq -r '.completion_promise // "TASK_COMPLETE"' 2>/dev/null)
     PROMPT=$(echo "$RALPH_STATE" | jq -r '.prompt // ""' 2>/dev/null)
 
+    # Check if oracle verification is pending
+    if [ -n "$VERIFICATION_STATE" ]; then
+      IS_PENDING=$(echo "$VERIFICATION_STATE" | jq -r '.pending // false' 2>/dev/null)
+      if [ "$IS_PENDING" = "true" ]; then
+        ATTEMPT=$(echo "$VERIFICATION_STATE" | jq -r '.verification_attempts // 0' 2>/dev/null)
+        MAX_ATTEMPTS=$(echo "$VERIFICATION_STATE" | jq -r '.max_verification_attempts // 3' 2>/dev/null)
+        ORIGINAL_TASK=$(echo "$VERIFICATION_STATE" | jq -r '.original_task // ""' 2>/dev/null)
+        COMPLETION_CLAIM=$(echo "$VERIFICATION_STATE" | jq -r '.completion_claim // ""' 2>/dev/null)
+        ORACLE_FEEDBACK=$(echo "$VERIFICATION_STATE" | jq -r '.oracle_feedback // ""' 2>/dev/null)
+        NEXT_ATTEMPT=$((ATTEMPT + 1))
+
+        FEEDBACK_SECTION=""
+        if [ -n "$ORACLE_FEEDBACK" ] && [ "$ORACLE_FEEDBACK" != "null" ]; then
+          FEEDBACK_SECTION="\\n**Previous Oracle Feedback (rejected):**\\n$ORACLE_FEEDBACK\\n"
+        fi
+
+        cat << EOF
+{"continue": false, "reason": "<ralph-verification>\\n\\n[ORACLE VERIFICATION REQUIRED - Attempt $NEXT_ATTEMPT/$MAX_ATTEMPTS]\\n\\nThe agent claims the task is complete. Before accepting, YOU MUST verify with Oracle.\\n\\n**Original Task:**\\n$ORIGINAL_TASK\\n\\n**Completion Claim:**\\n$COMPLETION_CLAIM\\n$FEEDBACK_SECTION\\n## MANDATORY VERIFICATION STEPS\\n\\n1. **Spawn Oracle Agent** for verification:\\n   \\\`\\\`\\\`\\n   Task(subagent_type=\\"oracle\\", prompt=\\"Verify this task completion claim...\\")\\n   \\\`\\\`\\\`\\n\\n2. **Oracle must check:**\\n   - Are ALL requirements from the original task met?\\n   - Is the implementation complete, not partial?\\n   - Are there any obvious bugs or issues?\\n   - Does the code compile/run without errors?\\n   - Are tests passing (if applicable)?\\n\\n3. **Based on Oracle's response:**\\n   - If APPROVED: Output \\\`<oracle-approved>VERIFIED_COMPLETE</oracle-approved>\\\`\\n   - If REJECTED: Continue working on the identified issues\\n\\nDO NOT output the completion promise again until Oracle approves.\\n\\n</ralph-verification>\\n\\n---\\n"}
+EOF
+        exit 0
+      fi
+    fi
+
     if [ "$ITERATION" -lt "$MAX_ITER" ]; then
       # Increment iteration
       NEW_ITER=$((ITERATION + 1))
@@ -960,14 +989,68 @@ async function main() {
     // Check for ralph loop state
     const ralphState = readJsonFile(join(directory, '.sisyphus', 'ralph-state.json'));
 
+    // Check for verification state (oracle verification)
+    const verificationState = readJsonFile(join(directory, '.sisyphus', 'ralph-verification.json'));
+
     // Count incomplete todos
     const incompleteCount = countIncompleteTodos(todosDir, directory);
 
-    // Priority 1: Ralph Loop
+    // Priority 1: Ralph Loop with Oracle Verification
     if (ralphState?.active) {
       const iteration = ralphState.iteration || 1;
       const maxIter = ralphState.max_iterations || 10;
 
+      // Check if oracle verification is pending
+      if (verificationState?.pending) {
+        const attempt = (verificationState.verification_attempts || 0) + 1;
+        const maxAttempts = verificationState.max_verification_attempts || 3;
+
+        console.log(JSON.stringify({
+          continue: false,
+          reason: \`<ralph-verification>
+
+[ORACLE VERIFICATION REQUIRED - Attempt \${attempt}/\${maxAttempts}]
+
+The agent claims the task is complete. Before accepting, YOU MUST verify with Oracle.
+
+**Original Task:**
+\${verificationState.original_task || ralphState.prompt || 'No task specified'}
+
+**Completion Claim:**
+\${verificationState.completion_claim || 'Task marked complete'}
+
+\${verificationState.oracle_feedback ? \`**Previous Oracle Feedback (rejected):**
+\${verificationState.oracle_feedback}
+\` : ''}
+
+## MANDATORY VERIFICATION STEPS
+
+1. **Spawn Oracle Agent** for verification:
+   \\\`\\\`\\\`
+   Task(subagent_type="oracle", prompt="Verify this task completion claim...")
+   \\\`\\\`\\\`
+
+2. **Oracle must check:**
+   - 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 Oracle's response:**
+   - If APPROVED: Output \\\`<oracle-approved>VERIFIED_COMPLETE</oracle-approved>\\\`
+   - If REJECTED: Continue working on the identified issues
+
+DO NOT output the completion promise again until Oracle approves.
+
+</ralph-verification>
+
+---
+\`
+        }));
+        return;
+      }
+
       if (iteration < maxIter) {
         const newIter = iteration + 1;
         ralphState.iteration = newIter;

package/dist/installer/hooks.js.map

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

package/dist/installer/index.js

@@ -736,7 +736,7 @@ You are "Sisyphus" - Powerful AI Agent with orchestration capabilities from OhMy
 - Adapting to codebase maturity (disciplined vs chaotic)
 - Delegating specialized work to the right subagents
 - Parallel execution for maximum throughput
-- Follows user instructions. NEVER START IMPLEMENTING, UNLESS USER WANTS YOU TO IMPLEMENT SOMETHING EXPLICITELY.
+- Follows user instructions. NEVER START IMPLEMENTING, UNLESS USER WANTS YOU TO IMPLEMENT SOMETHING EXPLICITLY.
 
 **Operating Mode**: You NEVER work alone when specialists are available. Frontend work → delegate. Deep research → parallel background agents. Complex architecture → consult Oracle.
 
@@ -1540,7 +1540,7 @@ Named by [YeonGyu Kim](https://github.com/code-yeongyu).
 - Adapting to codebase maturity (disciplined vs chaotic)
 - Delegating specialized work to the right subagents
 - Parallel execution for maximum throughput
-- Follows user instructions. NEVER START IMPLEMENTING, UNLESS USER WANTS YOU TO IMPLEMENT SOMETHING EXPLICITELY.
+- Follows user instructions. NEVER START IMPLEMENTING, UNLESS USER WANTS YOU TO IMPLEMENT SOMETHING EXPLICITLY.
   - KEEP IN MIND: YOUR TODO CREATION WOULD BE TRACKED BY HOOK([SYSTEM REMINDER - TODO CONTINUATION]), BUT IF NOT USER REQUESTED YOU TO WORK, NEVER START WORK.
 
 **Operating Mode**: You NEVER work alone when specialists are available. Frontend work → delegate. Deep research → parallel background agents (async subagents). Complex architecture → consult Oracle.
@@ -2866,7 +2866,7 @@ Named by [YeonGyu Kim](https://github.com/code-yeongyu).
 - Adapting to codebase maturity (disciplined vs chaotic)
 - Delegating specialized work to the right subagents
 - Parallel execution for maximum throughput
-- Follows user instructions. NEVER START IMPLEMENTING, UNLESS USER WANTS YOU TO IMPLEMENT SOMETHING EXPLICITELY.
+- Follows user instructions. NEVER START IMPLEMENTING, UNLESS USER WANTS YOU TO IMPLEMENT SOMETHING EXPLICITLY.
   - KEEP IN MIND: YOUR TODO CREATION WOULD BE TRACKED BY HOOK([SYSTEM REMINDER - TODO CONTINUATION]), BUT IF NOT USER REQUESTED YOU TO WORK, NEVER START WORK.
 
 **Operating Mode**: You NEVER work alone when specialists are available. Frontend work → delegate. Deep research → parallel background agents (async subagents). Complex architecture → consult Oracle.

package/dist/providers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Provider module exports
+ */
+export type { ProviderType, ModelId, AuthType, ProviderConfig, ResolvedModel, ModelInfo, OAuthTokens, OAuthConfig, } from './types.js';
+export { getProviderFromModelId, getModelNameFromId, createModelId, } from './types.js';
+export { MODEL_REGISTRY, getModelInfo, getModelsForProvider, isKnownModel, getAllModelIds, DEFAULT_MODELS, } from './registry.js';
+export { ModelRouter, createModelRouter } from './router.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,cAAc,EACd,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,10 @@
+/**
+ * Provider module exports
+ */
+// Type utilities
+export { getProviderFromModelId, getModelNameFromId, createModelId, } from './types.js';
+// Registry
+export { MODEL_REGISTRY, getModelInfo, getModelsForProvider, isKnownModel, getAllModelIds, DEFAULT_MODELS, } from './registry.js';
+// Router
+export { ModelRouter, createModelRouter } from './router.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,iBAAiB;AACjB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,WAAW;AACX,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Model registry with known models and their capabilities
+ */
+import type { ModelId, ModelInfo, ProviderType } from './types.js';
+/**
+ * Registry of known models with their capabilities
+ */
+export declare const MODEL_REGISTRY: Record<string, ModelInfo>;
+/**
+ * Get model info from the registry
+ */
+export declare function getModelInfo(modelId: ModelId): ModelInfo | undefined;
+/**
+ * Get all models for a specific provider
+ */
+export declare function getModelsForProvider(provider: ProviderType): ModelInfo[];
+/**
+ * Check if a model is known in the registry
+ */
+export declare function isKnownModel(modelId: ModelId): boolean;
+/**
+ * Get all known model IDs
+ */
+export declare function getAllModelIds(): ModelId[];
+/**
+ * Get default models for each provider
+ */
+export declare const DEFAULT_MODELS: Record<ProviderType, ModelId>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA2HpD,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,CAExE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAE1C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAKxD,CAAC"}

package/dist/providers/registry.js

@@ -0,0 +1,162 @@
+/**
+ * Model registry with known models and their capabilities
+ */
+/**
+ * Registry of known models with their capabilities
+ */
+export const MODEL_REGISTRY = {
+    // OpenAI Models (OAuth - ChatGPT Plus/Pro)
+    'openai/gpt-4o': {
+        id: 'openai/gpt-4o',
+        provider: 'openai',
+        displayName: 'GPT-4o',
+        contextWindow: 128000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'openai/gpt-4o-mini': {
+        id: 'openai/gpt-4o-mini',
+        provider: 'openai',
+        displayName: 'GPT-4o Mini',
+        contextWindow: 128000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'openai/o1': {
+        id: 'openai/o1',
+        provider: 'openai',
+        displayName: 'o1',
+        contextWindow: 200000,
+        supportsVision: true,
+        supportsTools: false,
+        supportsStreaming: false,
+    },
+    'openai/o1-mini': {
+        id: 'openai/o1-mini',
+        provider: 'openai',
+        displayName: 'o1-mini',
+        contextWindow: 128000,
+        supportsVision: false,
+        supportsTools: false,
+        supportsStreaming: false,
+    },
+    'openai/o1-pro': {
+        id: 'openai/o1-pro',
+        provider: 'openai',
+        displayName: 'o1-pro',
+        contextWindow: 200000,
+        supportsVision: true,
+        supportsTools: false,
+        supportsStreaming: false,
+    },
+    'openai/o3-mini': {
+        id: 'openai/o3-mini',
+        provider: 'openai',
+        displayName: 'o3-mini',
+        contextWindow: 200000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    // Google Models (OAuth - Consumer Account)
+    'google/gemini-2.0-flash': {
+        id: 'google/gemini-2.0-flash',
+        provider: 'google',
+        displayName: 'Gemini 2.0 Flash',
+        contextWindow: 1000000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'google/gemini-2.0-flash-lite': {
+        id: 'google/gemini-2.0-flash-lite',
+        provider: 'google',
+        displayName: 'Gemini 2.0 Flash Lite',
+        contextWindow: 1000000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'google/gemini-1.5-pro': {
+        id: 'google/gemini-1.5-pro',
+        provider: 'google',
+        displayName: 'Gemini 1.5 Pro',
+        contextWindow: 2000000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'google/gemini-1.5-flash': {
+        id: 'google/gemini-1.5-flash',
+        provider: 'google',
+        displayName: 'Gemini 1.5 Flash',
+        contextWindow: 1000000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    // Anthropic Models (API Key)
+    'anthropic/claude-opus-4-5': {
+        id: 'anthropic/claude-opus-4-5',
+        provider: 'anthropic',
+        displayName: 'Claude Opus 4.5',
+        contextWindow: 200000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'anthropic/claude-sonnet-4-5': {
+        id: 'anthropic/claude-sonnet-4-5',
+        provider: 'anthropic',
+        displayName: 'Claude Sonnet 4.5',
+        contextWindow: 200000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+    'anthropic/claude-haiku-4-5': {
+        id: 'anthropic/claude-haiku-4-5',
+        provider: 'anthropic',
+        displayName: 'Claude Haiku 4.5',
+        contextWindow: 200000,
+        supportsVision: true,
+        supportsTools: true,
+        supportsStreaming: true,
+    },
+};
+/**
+ * Get model info from the registry
+ */
+export function getModelInfo(modelId) {
+    return MODEL_REGISTRY[modelId];
+}
+/**
+ * Get all models for a specific provider
+ */
+export function getModelsForProvider(provider) {
+    return Object.values(MODEL_REGISTRY).filter(m => m.provider === provider);
+}
+/**
+ * Check if a model is known in the registry
+ */
+export function isKnownModel(modelId) {
+    return modelId in MODEL_REGISTRY;
+}
+/**
+ * Get all known model IDs
+ */
+export function getAllModelIds() {
+    return Object.keys(MODEL_REGISTRY);
+}
+/**
+ * Get default models for each provider
+ */
+export const DEFAULT_MODELS = {
+    anthropic: 'anthropic/claude-sonnet-4-5',
+    openai: 'openai/gpt-4o',
+    google: 'google/gemini-2.0-flash',
+    openrouter: 'openrouter/anthropic/claude-3.5-sonnet', // OpenRouter uses passthrough
+};
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

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

package/dist/providers/router.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Model router - resolves agent model preferences to actual models
+ * based on provider authentication status
+ */
+import type { ModelId, ResolvedModel } from './types.js';
+import type { AuthManager } from '../auth/manager.js';
+/**
+ * Model router that resolves agent model lists to available models
+ */
+export declare class ModelRouter {
+    private authManager;
+    constructor(authManager: AuthManager);
+    /**
+     * Resolve a model list to the first available authenticated model
+     *
+     * @param modelList - Ordered list of preferred models
+     * @returns The resolved model with provider info
+     * @throws Error if no authenticated provider is available for any model
+     */
+    resolveModel(modelList: ModelId[]): Promise<ResolvedModel>;
+    /**
+     * Check if any model in the list can be used
+     *
+     * @param modelList - List of models to check
+     * @returns true if at least one model has an authenticated provider
+     */
+    canResolve(modelList: ModelId[]): Promise<boolean>;
+    /**
+     * Get the first available model from the list without throwing
+     *
+     * @param modelList - List of models to check
+     * @returns The resolved model or null if none available
+     */
+    tryResolveModel(modelList: ModelId[]): Promise<ResolvedModel | null>;
+}
+/**
+ * Create a model router instance
+ */
+export declare function createModelRouter(authManager: AuthManager): ModelRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/providers/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/providers/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;;;;;OAMG;IACG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAqChE;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAexD;;;;;OAKG;IACG,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAO3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAEvE"}

package/dist/providers/router.js

@@ -0,0 +1,88 @@
+/**
+ * Model router - resolves agent model preferences to actual models
+ * based on provider authentication status
+ */
+import { getProviderFromModelId, getModelNameFromId } from './types.js';
+/**
+ * Model router that resolves agent model lists to available models
+ */
+export class ModelRouter {
+    authManager;
+    constructor(authManager) {
+        this.authManager = authManager;
+    }
+    /**
+     * Resolve a model list to the first available authenticated model
+     *
+     * @param modelList - Ordered list of preferred models
+     * @returns The resolved model with provider info
+     * @throws Error if no authenticated provider is available for any model
+     */
+    async resolveModel(modelList) {
+        if (!modelList || modelList.length === 0) {
+            throw new Error('Model list cannot be empty');
+        }
+        const triedProviders = [];
+        for (let i = 0; i < modelList.length; i++) {
+            const modelId = modelList[i];
+            const provider = getProviderFromModelId(modelId);
+            // Skip if we've already tried this provider
+            if (triedProviders.includes(provider)) {
+                continue;
+            }
+            triedProviders.push(provider);
+            const isAuthenticated = await this.authManager.isAuthenticated(provider);
+            if (isAuthenticated) {
+                return {
+                    provider,
+                    modelId,
+                    modelName: getModelNameFromId(modelId),
+                    isFallback: i > 0,
+                    fallbackReason: i > 0 ? `Primary model "${modelList[0]}" unavailable (provider not authenticated)` : undefined,
+                };
+            }
+        }
+        // All models exhausted - throw error with details
+        throw new Error(`No authenticated provider available. Tried models: ${modelList.join(', ')}. ` +
+            `Run /connect <provider> to authenticate.`);
+    }
+    /**
+     * Check if any model in the list can be used
+     *
+     * @param modelList - List of models to check
+     * @returns true if at least one model has an authenticated provider
+     */
+    async canResolve(modelList) {
+        if (!modelList || modelList.length === 0) {
+            return false;
+        }
+        for (const modelId of modelList) {
+            const provider = getProviderFromModelId(modelId);
+            if (await this.authManager.isAuthenticated(provider)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get the first available model from the list without throwing
+     *
+     * @param modelList - List of models to check
+     * @returns The resolved model or null if none available
+     */
+    async tryResolveModel(modelList) {
+        try {
+            return await this.resolveModel(modelList);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Create a model router instance
+ */
+export function createModelRouter(authManager) {
+    return new ModelRouter(authManager);
+}
+//# sourceMappingURL=router.js.map