claudecode-omc 4.3.4

package/dist/hooks/autopilot/state.js

@@ -0,0 +1,508 @@
+/**
+ * Autopilot State Management & Phase Transitions
+ *
+ * Handles:
+ * - Persistent state for the autopilot workflow across phases
+ * - Phase transitions, especially Ralph → UltraQA and UltraQA → Validation
+ * - State machine operations
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, statSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_CONFIG } from './types.js';
+import { readRalphState, clearRalphState, clearLinkedUltraworkState } from '../ralph/index.js';
+import { startUltraQA, clearUltraQAState, readUltraQAState } from '../ultraqa/index.js';
+import { canStartMode } from '../mode-registry/index.js';
+import { resolveSessionStatePath, ensureSessionStateDir } from '../../lib/worktree-paths.js';
+const STATE_FILE = 'autopilot-state.json';
+const SPEC_DIR = 'autopilot';
+// ============================================================================
+// STATE MANAGEMENT
+// ============================================================================
+/**
+ * Get the state file path
+ */
+function getStateFilePath(directory, sessionId) {
+    if (sessionId) {
+        return resolveSessionStatePath('autopilot', sessionId, directory);
+    }
+    const omcDir = join(directory, '.omc');
+    return join(omcDir, 'state', STATE_FILE);
+}
+/**
+ * Ensure the .omc/state directory exists
+ */
+function ensureStateDir(directory, sessionId) {
+    if (sessionId) {
+        ensureSessionStateDir(sessionId, directory);
+        return;
+    }
+    const stateDir = join(directory, '.omc', 'state');
+    if (!existsSync(stateDir)) {
+        mkdirSync(stateDir, { recursive: true });
+    }
+}
+/**
+ * Ensure the autopilot directory exists
+ */
+export function ensureAutopilotDir(directory) {
+    ensureStateDir(directory);
+    const autopilotDir = join(directory, '.omc', SPEC_DIR);
+    if (!existsSync(autopilotDir)) {
+        mkdirSync(autopilotDir, { recursive: true });
+    }
+    return autopilotDir;
+}
+/**
+ * Read autopilot state from disk
+ */
+export function readAutopilotState(directory, sessionId) {
+    if (sessionId) {
+        // Session-scoped ONLY — no legacy fallback
+        const sessionFile = getStateFilePath(directory, sessionId);
+        if (!existsSync(sessionFile))
+            return null;
+        try {
+            const content = readFileSync(sessionFile, 'utf-8');
+            const state = JSON.parse(content);
+            // Validate session identity
+            if (state.session_id && state.session_id !== sessionId)
+                return null;
+            return state;
+        }
+        catch {
+            return null;
+        }
+    }
+    // No sessionId: legacy path (backward compat)
+    const stateFile = getStateFilePath(directory);
+    if (!existsSync(stateFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write autopilot state to disk
+ */
+export function writeAutopilotState(directory, state, sessionId) {
+    try {
+        ensureStateDir(directory, sessionId);
+        const stateFile = getStateFilePath(directory, sessionId);
+        writeFileSync(stateFile, JSON.stringify(state, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear autopilot state
+ */
+export function clearAutopilotState(directory, sessionId) {
+    const stateFile = getStateFilePath(directory, sessionId);
+    if (!existsSync(stateFile)) {
+        return true;
+    }
+    try {
+        unlinkSync(stateFile);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the age of the autopilot state file in milliseconds.
+ * Returns null if no state file exists.
+ */
+export function getAutopilotStateAge(directory, sessionId) {
+    const stateFile = getStateFilePath(directory, sessionId);
+    if (!existsSync(stateFile))
+        return null;
+    try {
+        const stats = statSync(stateFile);
+        return Date.now() - stats.mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if autopilot is active
+ */
+export function isAutopilotActive(directory, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    return state !== null && state.active === true;
+}
+/**
+ * Initialize a new autopilot session
+ */
+export function initAutopilot(directory, idea, sessionId, config) {
+    // Mutual exclusion check via mode-registry
+    const canStart = canStartMode('autopilot', directory);
+    if (!canStart.allowed) {
+        console.error(canStart.message);
+        return null;
+    }
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    const now = new Date().toISOString();
+    const state = {
+        active: true,
+        phase: 'expansion',
+        iteration: 1,
+        max_iterations: mergedConfig.maxIterations ?? 10,
+        originalIdea: idea,
+        expansion: {
+            analyst_complete: false,
+            architect_complete: false,
+            spec_path: null,
+            requirements_summary: '',
+            tech_stack: []
+        },
+        planning: {
+            plan_path: null,
+            architect_iterations: 0,
+            approved: false
+        },
+        execution: {
+            ralph_iterations: 0,
+            ultrawork_active: false,
+            tasks_completed: 0,
+            tasks_total: 0,
+            files_created: [],
+            files_modified: []
+        },
+        qa: {
+            ultraqa_cycles: 0,
+            build_status: 'pending',
+            lint_status: 'pending',
+            test_status: 'pending'
+        },
+        validation: {
+            architects_spawned: 0,
+            verdicts: [],
+            all_approved: false,
+            validation_rounds: 0
+        },
+        started_at: now,
+        completed_at: null,
+        phase_durations: {},
+        total_agents_spawned: 0,
+        wisdom_entries: 0,
+        session_id: sessionId,
+        project_path: directory
+    };
+    ensureAutopilotDir(directory);
+    writeAutopilotState(directory, state, sessionId);
+    return state;
+}
+/**
+ * Transition to a new phase
+ */
+export function transitionPhase(directory, newPhase, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state || !state.active) {
+        return null;
+    }
+    const now = new Date().toISOString();
+    const oldPhase = state.phase;
+    // Record duration for old phase (if we have a start time recorded)
+    const phaseStartKey = `${oldPhase}_start_ms`;
+    if (state.phase_durations[phaseStartKey] !== undefined) {
+        const duration = Date.now() - state.phase_durations[phaseStartKey];
+        state.phase_durations[oldPhase] = duration;
+    }
+    // Transition to new phase and record start time
+    state.phase = newPhase;
+    state.phase_durations[`${newPhase}_start_ms`] = Date.now();
+    if (newPhase === 'complete' || newPhase === 'failed') {
+        state.completed_at = now;
+        state.active = false;
+    }
+    writeAutopilotState(directory, state, sessionId);
+    return state;
+}
+/**
+ * Increment the agent spawn counter
+ */
+export function incrementAgentCount(directory, count = 1, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state)
+        return false;
+    state.total_agents_spawned += count;
+    return writeAutopilotState(directory, state, sessionId);
+}
+/**
+ * Update expansion phase data
+ */
+export function updateExpansion(directory, updates, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state)
+        return false;
+    state.expansion = { ...state.expansion, ...updates };
+    return writeAutopilotState(directory, state, sessionId);
+}
+/**
+ * Update planning phase data
+ */
+export function updatePlanning(directory, updates, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state)
+        return false;
+    state.planning = { ...state.planning, ...updates };
+    return writeAutopilotState(directory, state, sessionId);
+}
+/**
+ * Update execution phase data
+ */
+export function updateExecution(directory, updates, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state)
+        return false;
+    state.execution = { ...state.execution, ...updates };
+    return writeAutopilotState(directory, state, sessionId);
+}
+/**
+ * Update QA phase data
+ */
+export function updateQA(directory, updates, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state)
+        return false;
+    state.qa = { ...state.qa, ...updates };
+    return writeAutopilotState(directory, state, sessionId);
+}
+/**
+ * Update validation phase data
+ */
+export function updateValidation(directory, updates, sessionId) {
+    const state = readAutopilotState(directory, sessionId);
+    if (!state)
+        return false;
+    state.validation = { ...state.validation, ...updates };
+    return writeAutopilotState(directory, state, sessionId);
+}
+/**
+ * Get the spec file path
+ */
+export function getSpecPath(directory) {
+    return join(directory, '.omc', SPEC_DIR, 'spec.md');
+}
+/**
+ * Get the plan file path
+ */
+export function getPlanPath(directory) {
+    return join(directory, '.omc', 'plans', 'autopilot-impl.md');
+}
+/**
+ * Transition from Ralph (Phase 2: Execution) to UltraQA (Phase 3: QA)
+ *
+ * This handles the mutual exclusion by:
+ * 1. Saving Ralph's progress to autopilot state
+ * 2. Cleanly terminating Ralph mode (and linked Ultrawork)
+ * 3. Starting UltraQA mode
+ * 4. Preserving context for potential rollback
+ */
+export function transitionRalphToUltraQA(directory, sessionId) {
+    const autopilotState = readAutopilotState(directory, sessionId);
+    if (!autopilotState || autopilotState.phase !== 'execution') {
+        return {
+            success: false,
+            error: 'Not in execution phase - cannot transition to QA'
+        };
+    }
+    const ralphState = readRalphState(directory, sessionId);
+    // Step 1: Preserve Ralph progress in autopilot state
+    const executionUpdated = updateExecution(directory, {
+        ralph_iterations: ralphState?.iteration ?? autopilotState.execution.ralph_iterations,
+        ralph_completed_at: new Date().toISOString(),
+        ultrawork_active: false
+    }, sessionId);
+    if (!executionUpdated) {
+        return {
+            success: false,
+            error: 'Failed to update execution state'
+        };
+    }
+    // Step 2: Cleanly terminate Ralph (and linked Ultrawork)
+    if (ralphState?.linked_ultrawork) {
+        clearLinkedUltraworkState(directory, sessionId);
+    }
+    const ralphCleared = clearRalphState(directory, sessionId);
+    if (!ralphCleared) {
+        return {
+            success: false,
+            error: 'Failed to clear Ralph state'
+        };
+    }
+    // Step 3: Transition to QA phase
+    const newState = transitionPhase(directory, 'qa', sessionId);
+    if (!newState) {
+        return {
+            success: false,
+            error: 'Failed to transition to QA phase'
+        };
+    }
+    // Step 4: Start UltraQA
+    const qaResult = startUltraQA(directory, 'tests', sessionId, { maxCycles: 5 });
+    if (!qaResult.success) {
+        // Rollback on failure - restore execution phase
+        transitionPhase(directory, 'execution', sessionId);
+        updateExecution(directory, { ralph_completed_at: undefined }, sessionId);
+        return {
+            success: false,
+            error: qaResult.error || 'Failed to start UltraQA'
+        };
+    }
+    return {
+        success: true,
+        state: newState
+    };
+}
+/**
+ * Transition from UltraQA (Phase 3: QA) to Validation (Phase 4)
+ */
+export function transitionUltraQAToValidation(directory, sessionId) {
+    const autopilotState = readAutopilotState(directory, sessionId);
+    if (!autopilotState || autopilotState.phase !== 'qa') {
+        return {
+            success: false,
+            error: 'Not in QA phase - cannot transition to validation'
+        };
+    }
+    const qaState = readUltraQAState(directory, sessionId);
+    // Preserve QA progress
+    const qaUpdated = updateQA(directory, {
+        ultraqa_cycles: qaState?.cycle ?? autopilotState.qa.ultraqa_cycles,
+        qa_completed_at: new Date().toISOString()
+    }, sessionId);
+    if (!qaUpdated) {
+        return {
+            success: false,
+            error: 'Failed to update QA state'
+        };
+    }
+    // Terminate UltraQA
+    clearUltraQAState(directory, sessionId);
+    // Transition to validation
+    const newState = transitionPhase(directory, 'validation', sessionId);
+    if (!newState) {
+        return {
+            success: false,
+            error: 'Failed to transition to validation phase'
+        };
+    }
+    return {
+        success: true,
+        state: newState
+    };
+}
+/**
+ * Transition from Validation (Phase 4) to Complete
+ */
+export function transitionToComplete(directory, sessionId) {
+    const state = transitionPhase(directory, 'complete', sessionId);
+    if (!state) {
+        return {
+            success: false,
+            error: 'Failed to transition to complete phase'
+        };
+    }
+    return { success: true, state };
+}
+/**
+ * Transition to failed state
+ */
+export function transitionToFailed(directory, error, sessionId) {
+    const state = transitionPhase(directory, 'failed', sessionId);
+    if (!state) {
+        return {
+            success: false,
+            error: 'Failed to transition to failed phase'
+        };
+    }
+    return { success: true, state };
+}
+/**
+ * Get a prompt for Claude to execute the transition
+ */
+export function getTransitionPrompt(fromPhase, toPhase) {
+    if (fromPhase === 'execution' && toPhase === 'qa') {
+        return `## PHASE TRANSITION: Execution → QA
+
+The execution phase is complete. Transitioning to QA phase.
+
+**CRITICAL**: Ralph mode must be cleanly terminated before UltraQA can start.
+
+The transition handler has:
+1. Preserved Ralph iteration count and progress
+2. Cleared Ralph state (and linked Ultrawork)
+3. Started UltraQA in 'tests' mode
+
+You are now in QA phase. Run the QA cycle:
+1. Build: Run the project's build command
+2. Lint: Run the project's lint command
+3. Test: Run the project's test command
+
+Fix any failures and repeat until all pass.
+
+Signal when QA passes: QA_COMPLETE
+`;
+    }
+    if (fromPhase === 'qa' && toPhase === 'validation') {
+        return `## PHASE TRANSITION: QA → Validation
+
+All QA checks have passed. Transitioning to validation phase.
+
+The transition handler has:
+1. Preserved UltraQA cycle count
+2. Cleared UltraQA state
+3. Updated phase to 'validation'
+
+You are now in validation phase. Spawn parallel validation architects:
+
+\`\`\`
+// Spawn all three in parallel
+Task(subagent_type="oh-my-claudecode:architect", model="opus",
+  prompt="FUNCTIONAL COMPLETENESS REVIEW: Verify all requirements from spec are implemented")
+
+Task(subagent_type="oh-my-claudecode:security-reviewer", model="opus",
+  prompt="SECURITY REVIEW: Check for vulnerabilities, injection risks, auth issues")
+
+Task(subagent_type="oh-my-claudecode:code-reviewer", model="opus",
+  prompt="CODE QUALITY REVIEW: Check patterns, maintainability, test coverage")
+\`\`\`
+
+Aggregate verdicts:
+- All APPROVED → Signal: AUTOPILOT_COMPLETE
+- Any REJECTED → Fix issues and re-validate (max 3 rounds)
+`;
+    }
+    if (fromPhase === 'expansion' && toPhase === 'planning') {
+        return `## PHASE TRANSITION: Expansion → Planning
+
+The idea has been expanded into a detailed specification.
+
+Read the spec and create an implementation plan using the Architect agent (direct planning mode).
+
+Signal when Critic approves the plan: PLANNING_COMPLETE
+`;
+    }
+    if (fromPhase === 'planning' && toPhase === 'execution') {
+        return `## PHASE TRANSITION: Planning → Execution
+
+The plan has been approved. Starting execution phase with Ralph + Ultrawork.
+
+Execute tasks from the plan in parallel where possible.
+
+Signal when all tasks complete: EXECUTION_COMPLETE
+`;
+    }
+    return '';
+}
+//# sourceMappingURL=state.js.map

package/dist/hooks/autopilot/state.js.map

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

package/dist/hooks/autopilot/transition-helper.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Transactional Transition Helper
+ *
+ * Executes a series of steps atomically: if any step fails,
+ * all previously completed steps are rolled back in reverse order.
+ */
+export interface TransitionStep {
+    name: string;
+    execute: () => Promise<void>;
+    rollback: () => Promise<void>;
+}
+export interface TransitionResult {
+    success: boolean;
+    failedStep?: string;
+    error?: string;
+}
+/**
+ * Execute a sequence of transition steps transactionally.
+ * If any step fails, all previously completed steps are rolled back in reverse order.
+ */
+export declare function executeTransition(steps: TransitionStep[]): Promise<TransitionResult>;
+//# sourceMappingURL=transition-helper.d.ts.map

package/dist/hooks/autopilot/transition-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-helper.d.ts","sourceRoot":"","sources":["../../../src/hooks/autopilot/transition-helper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe1F"}

package/dist/hooks/autopilot/transition-helper.js

@@ -0,0 +1,31 @@
+/**
+ * Transactional Transition Helper
+ *
+ * Executes a series of steps atomically: if any step fails,
+ * all previously completed steps are rolled back in reverse order.
+ */
+/**
+ * Execute a sequence of transition steps transactionally.
+ * If any step fails, all previously completed steps are rolled back in reverse order.
+ */
+export async function executeTransition(steps) {
+    const completed = [];
+    for (const step of steps) {
+        try {
+            await step.execute();
+            completed.push(step);
+        }
+        catch (error) {
+            // Rollback in reverse order
+            for (const done of completed.reverse()) {
+                try {
+                    await done.rollback();
+                }
+                catch { /* best-effort rollback */ }
+            }
+            return { success: false, failedStep: step.name, error: String(error) };
+        }
+    }
+    return { success: true };
+}
+//# sourceMappingURL=transition-helper.js.map

package/dist/hooks/autopilot/transition-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-helper.js","sourceRoot":"","sources":["../../../src/hooks/autopilot/transition-helper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAuB;IAC7D,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4BAA4B;YAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvC,IAAI,CAAC;oBAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}