oh-my-codex 0.7.4 → 0.7.6

package/dist/team/runtime-cli.js

@@ -0,0 +1,238 @@
+/**
+ * CLI entry point for team runtime.
+ * Reads JSON config from stdin, runs startTeam/monitorTeam/shutdownTeam,
+ * writes structured JSON result to stdout.
+ *
+ * Spawned by omx_run_team_start in state-server.ts.
+ */
+import { readdirSync, readFileSync } from 'fs';
+import { writeFile, rename } from 'fs/promises';
+import { join } from 'path';
+import { startTeam, monitorTeam, shutdownTeam } from './runtime.js';
+import { teamReadConfig as readTeamConfig } from './team-ops.js';
+async function writePanesFile(jobId, paneIds, leaderPaneId) {
+    const omxJobsDir = process.env.OMX_JOBS_DIR;
+    if (!jobId || !omxJobsDir)
+        return;
+    const panesPath = join(omxJobsDir, `${jobId}-panes.json`);
+    await writeFile(panesPath + '.tmp', JSON.stringify({ paneIds: [...paneIds], leaderPaneId }));
+    await rename(panesPath + '.tmp', panesPath);
+}
+export async function loadLivePaneState(teamName, cwd) {
+    const config = await readTeamConfig(teamName, cwd);
+    if (!config)
+        return null;
+    return {
+        paneIds: config.workers
+            .map((worker) => worker.pane_id)
+            .filter((paneId) => typeof paneId === 'string' && paneId.trim().length > 0),
+        leaderPaneId: config.leader_pane_id ?? '',
+    };
+}
+export async function shutdownWithForceFallback(teamName, cwd) {
+    try {
+        await shutdownTeam(teamName, cwd);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!message.includes('shutdown_gate_blocked') && !message.includes('shutdown_rejected')) {
+            throw error;
+        }
+        await shutdownTeam(teamName, cwd, { force: true });
+    }
+}
+export function detectDeadWorkerFailure(deadWorkerCount, liveWorkerPaneCount, hasOutstandingWork, phase) {
+    const allWorkersDead = liveWorkerPaneCount > 0 && deadWorkerCount >= liveWorkerPaneCount;
+    return {
+        deadWorkerFailure: allWorkersDead && hasOutstandingWork,
+        fixingWithNoWorkers: phase === 'team-fix' && allWorkersDead,
+    };
+}
+function collectTaskResults(stateRoot, teamName) {
+    const tasksDir = join(stateRoot, 'team', teamName, 'tasks');
+    try {
+        const files = readdirSync(tasksDir).filter(f => f.endsWith('.json'));
+        return files.map(f => {
+            try {
+                const raw = readFileSync(join(tasksDir, f), 'utf-8');
+                const task = JSON.parse(raw);
+                return {
+                    taskId: task.id ?? f.replace('.json', ''),
+                    status: task.status ?? 'unknown',
+                    summary: (task.result ?? task.summary) ?? '',
+                };
+            }
+            catch {
+                return { taskId: f.replace('.json', ''), status: 'unknown', summary: '' };
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+async function main() {
+    const startTime = Date.now();
+    // Read stdin
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    const rawInput = Buffer.concat(chunks).toString('utf-8').trim();
+    let input;
+    try {
+        input = JSON.parse(rawInput);
+    }
+    catch (err) {
+        process.stderr.write(`[runtime-cli] Failed to parse stdin JSON: ${err}\n`);
+        process.exit(1);
+    }
+    // Validate required fields
+    const missing = [];
+    if (!input.teamName)
+        missing.push('teamName');
+    if (!input.agentTypes || !Array.isArray(input.agentTypes) || input.agentTypes.length === 0)
+        missing.push('agentTypes');
+    if (!input.tasks || !Array.isArray(input.tasks) || input.tasks.length === 0)
+        missing.push('tasks');
+    if (!input.cwd)
+        missing.push('cwd');
+    if (missing.length > 0) {
+        process.stderr.write(`[runtime-cli] Missing required fields: ${missing.join(', ')}\n`);
+        process.exit(1);
+    }
+    const { teamName, agentTypes, tasks, cwd, pollIntervalMs = 5000, } = input;
+    const workerCount = input.workerCount ?? agentTypes.length;
+    const stateRoot = join(cwd, '.omx', 'state');
+    let runtime = null;
+    let finalStatus = 'failed';
+    let pollActive = true;
+    function exitCodeFor(status) {
+        return status === 'completed' ? 0 : 1;
+    }
+    async function doShutdown(status) {
+        pollActive = false;
+        finalStatus = status;
+        // 1. Collect task results
+        const taskResults = collectTaskResults(stateRoot, teamName);
+        // 2. Shutdown team
+        if (runtime) {
+            try {
+                if (status === 'failed') {
+                    // Failure/cancellation path must force cleanup to bypass shutdown gate.
+                    await shutdownTeam(runtime.teamName, runtime.cwd, { force: true });
+                }
+                else {
+                    await shutdownWithForceFallback(runtime.teamName, runtime.cwd);
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[runtime-cli] shutdownTeam error: ${err}\n`);
+            }
+        }
+        const duration = (Date.now() - startTime) / 1000;
+        const output = {
+            status: finalStatus,
+            teamName,
+            taskResults,
+            duration,
+            workerCount,
+        };
+        // 3. Write result to stdout
+        process.stdout.write(JSON.stringify(output) + '\n');
+        // 4. Exit
+        process.exit(exitCodeFor(status));
+    }
+    // Register signal handlers before poll loop
+    process.on('SIGINT', () => {
+        process.stderr.write('[runtime-cli] Received SIGINT, shutting down...\n');
+        doShutdown('failed').catch(() => process.exit(1));
+    });
+    process.on('SIGTERM', () => {
+        process.stderr.write('[runtime-cli] Received SIGTERM, shutting down...\n');
+        doShutdown('failed').catch(() => process.exit(1));
+    });
+    // Start the team — OMX's startTeam takes individual parameters
+    const agentType = agentTypes[0] ?? 'codex';
+    try {
+        runtime = await startTeam(teamName, tasks.map(t => t.subject).join('; '), agentType, workerCount, tasks, cwd);
+    }
+    catch (err) {
+        process.stderr.write(`[runtime-cli] startTeam failed: ${err}\n`);
+        process.exit(1);
+    }
+    // Persist pane IDs so MCP server can clean up explicitly via omx_run_team_cleanup.
+    const jobId = process.env.OMX_JOB_ID;
+    try {
+        const livePanes = await loadLivePaneState(teamName, cwd);
+        if (livePanes) {
+            await writePanesFile(jobId, livePanes.paneIds, livePanes.leaderPaneId);
+        }
+        else {
+            const fallbackPaneIds = runtime.config.workers
+                .map((worker) => worker.pane_id)
+                .filter((paneId) => typeof paneId === 'string' && paneId.trim().length > 0);
+            await writePanesFile(jobId, fallbackPaneIds, runtime.config.leader_pane_id ?? '');
+        }
+    }
+    catch (err) {
+        process.stderr.write(`[runtime-cli] Failed to persist pane IDs: ${err}\n`);
+    }
+    // Poll loop
+    while (pollActive) {
+        await new Promise(r => setTimeout(r, pollIntervalMs));
+        if (!pollActive)
+            break;
+        let snap;
+        try {
+            snap = await monitorTeam(teamName, cwd);
+        }
+        catch (err) {
+            process.stderr.write(`[runtime-cli] monitorTeam error: ${err}\n`);
+            continue;
+        }
+        if (!snap) {
+            process.stderr.write(`[runtime-cli] monitorTeam returned null\n`);
+            continue;
+        }
+        // Refresh pane IDs (workers may have scaled)
+        let livePaneState = null;
+        try {
+            livePaneState = await loadLivePaneState(teamName, cwd);
+            if (livePaneState) {
+                await writePanesFile(jobId, livePaneState.paneIds, livePaneState.leaderPaneId);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[runtime-cli] Failed to persist pane IDs: ${err}\n`);
+        }
+        const perfMs = snap.performance?.total_ms ?? 0;
+        process.stderr.write(`[runtime-cli] phase=${snap.phase} pending=${snap.tasks.pending} inProgress=${snap.tasks.in_progress} completed=${snap.tasks.completed} failed=${snap.tasks.failed} dead=${snap.deadWorkers.length} monitorMs=${perfMs.toFixed(0)}\n`);
+        // Check completion
+        if (snap.phase === 'complete') {
+            await doShutdown('completed');
+            return;
+        }
+        if (snap.phase === 'failed' || snap.phase === 'cancelled') {
+            await doShutdown('failed');
+            return;
+        }
+        // Check failure heuristics
+        const hasOutstandingWork = (snap.tasks.pending + snap.tasks.in_progress) > 0;
+        const liveWorkerPaneCount = livePaneState?.paneIds.length ?? 0;
+        const { deadWorkerFailure, fixingWithNoWorkers } = detectDeadWorkerFailure(snap.deadWorkers.length, liveWorkerPaneCount, hasOutstandingWork, snap.phase);
+        if (deadWorkerFailure || fixingWithNoWorkers) {
+            process.stderr.write(`[runtime-cli] Failure detected: deadWorkerFailure=${deadWorkerFailure} fixingWithNoWorkers=${fixingWithNoWorkers}\n`);
+            await doShutdown('failed');
+            return;
+        }
+    }
+}
+const shouldAutoStart = process.env.OMX_RUNTIME_CLI_DISABLE_AUTO_START !== '1';
+if (shouldAutoStart) {
+    main().catch(err => {
+        process.stderr.write(`[runtime-cli] Fatal error: ${err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=runtime-cli.js.map

package/dist/team/runtime-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cli.js","sourceRoot":"","sources":["../../src/team/runtime-cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,cAAc,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AA8BjE,KAAK,UAAU,cAAc,CAC3B,KAAyB,EACzB,OAAiB,EACjB,YAAoB;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC5C,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU;QAAE,OAAO;IAElC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,aAAa,CAAC,CAAC;IAC1D,MAAM,SAAS,CACb,SAAS,GAAG,MAAM,EAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC,CACxD,CAAC;IACF,MAAM,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB,EAAE,GAAW;IACnE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;aACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;aAC/B,MAAM,CAAC,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/F,YAAY,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAAgB,EAAE,GAAW;IAC3E,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACzF,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,mBAA2B,EAC3B,kBAA2B,EAC3B,KAAa;IAEb,MAAM,cAAc,GAAG,mBAAmB,GAAG,CAAC,IAAI,eAAe,IAAI,mBAAmB,CAAC;IACzF,OAAO;QACL,iBAAiB,EAAE,cAAc,IAAI,kBAAkB;QACvD,mBAAmB,EAAE,KAAK,KAAK,UAAU,IAAI,cAAc;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACnB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwE,CAAC;gBACpG,OAAO;oBACL,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;oBACzC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;oBAChC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;iBAC7C,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,aAAa;IACb,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhE,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAa,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,GAAG,IAAI,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,2BAA2B;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvH,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EACJ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,GAAG,EACH,cAAc,GAAG,IAAI,GACtB,GAAG,KAAK,CAAC;IAEV,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7C,IAAI,OAAO,GAAuB,IAAI,CAAC;IACvC,IAAI,WAAW,GAA2B,QAAQ,CAAC;IACnD,IAAI,UAAU,GAAG,IAAI,CAAC;IAEtB,SAAS,WAAW,CAAC,MAA8B;QACjD,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,MAA8B;QACtD,UAAU,GAAG,KAAK,CAAC;QACnB,WAAW,GAAG,MAAM,CAAC;QAErB,0BAA0B;QAC1B,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE5D,mBAAmB;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACxB,wEAAwE;oBACxE,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,MAAM,yBAAyB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;QACjD,MAAM,MAAM,GAAc;YACxB,MAAM,EAAE,WAAW;YACnB,QAAQ;YACR,WAAW;YACX,QAAQ;YACR,WAAW;SACZ,CAAC;QAEF,4BAA4B;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAEpD,UAAU;QACV,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC1E,UAAU,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC3E,UAAU,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,SAAS,CACvB,QAAQ,EACR,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EACpC,SAAS,EACT,WAAW,EACX,KAAK,EACL,GAAG,CACJ,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mFAAmF;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QACzE,CAAC;aAAM,CAAC;YACN,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO;iBAC3C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;iBAC/B,MAAM,CAAC,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAChG,MAAM,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,GAAG,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,YAAY;IACZ,OAAO,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC,UAAU;YAAE,MAAM;QAEvB,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,IAAI,CAAC,CAAC;YAClE,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAClE,SAAS;QACX,CAAC;QAED,6CAA6C;QAC7C,IAAI,aAAa,GAAyB,IAAI,CAAC;QAC/C,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACvD,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,GAAG,IAAI,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uBAAuB,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,eAAe,IAAI,CAAC,KAAK,CAAC,WAAW,cAAc,IAAI,CAAC,KAAK,CAAC,SAAS,WAAW,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,IAAI,CAAC,WAAW,CAAC,MAAM,cAAc,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACtO,CAAC;QAEF,mBAAmB;QACnB,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1D,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,2BAA2B;QAC3B,MAAM,kBAAkB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7E,MAAM,mBAAmB,GAAG,aAAa,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/D,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,GAAG,uBAAuB,CACxE,IAAI,CAAC,WAAW,CAAC,MAAM,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,IAAI,CAAC,KAAK,CACX,CAAC;QAEF,IAAI,iBAAiB,IAAI,mBAAmB,EAAE,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,iBAAiB,wBAAwB,mBAAmB,IAAI,CAAC,CAAC;YAC5I,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,KAAK,GAAG,CAAC;AAE/E,IAAI,eAAe,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/team/runtime.d.ts

@@ -45,9 +45,13 @@ export interface TeamRuntime {
 }
 interface ShutdownOptions {
     force?: boolean;
+    /** When true, applies ralph-specific cleanup policy: no force-kill on failure, detailed audit logging. */
+    ralph?: boolean;
 }
 export interface TeamStartOptions {
     worktreeMode?: WorktreeMode;
+    /** When true, applies ralph-specific cleanup policy during startup rollback (skip branch deletion). */
+    ralph?: boolean;
 }
 export { TEAM_LOW_COMPLEXITY_DEFAULT_MODEL };
 export declare function resolveCanonicalTeamStateRoot(leaderCwd: string): string;

package/dist/team/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/team/runtime.ts"],"names":[],"mappings":"AA4BA,OAAO,EA+BL,KAAK,UAAU,EAEf,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,EAId,MAAM,eAAe,CAAC;AAkBvB,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAGL,iCAAiC,EAIlC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC;IACjC,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,YAAY,CAAC;QACrB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;QAClC,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC,CAAC;IACH,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,QAAQ,EAAE,CAAC;KACnB,CAAC;IACF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AA8MD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE;AAgCD,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,MAAM,EAAE,CAiCV;AA8BD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC7F,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAuXtB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAuK7F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAuFf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwL9G;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA+C3F;AAuhBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAiGf;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CA6Df"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/team/runtime.ts"],"names":[],"mappings":"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"}

package/dist/team/runtime.js

@@ -3,10 +3,12 @@ import { existsSync } from 'fs';
 import { readdir, readFile } from 'fs/promises';
 import { performance } from 'perf_hooks';
 import { spawn } from 'child_process';
-import { sanitizeTeamName, isTmuxAvailable, createTeamSession, buildWorkerProcessLaunchSpec, resolveTeamWorkerCli, resolveTeamWorkerCliPlan, resolveTeamWorkerLaunchMode, waitForWorkerReady, dismissTrustPromptIfPresent, sleepFractionalSeconds, sendToWorker, sendToWorkerStdin, notifyLeaderStatus, isWorkerAlive, getWorkerPanePid, killWorker, killWorkerByPaneId, unregisterResizeHook, destroyTeamSession, listTeamSessions, } from './tmux-session.js';
-import { teamInit as initTeamState, DEFAULT_MAX_WORKERS, teamReadConfig as readTeamConfig, teamWriteWorkerIdentity as writeWorkerIdentity, teamReadWorkerHeartbeat as readWorkerHeartbeat, teamReadWorkerStatus as readWorkerStatus, teamWriteWorkerInbox as writeWorkerInbox, teamCreateTask as createStateTask, teamReadTask as readTask, teamListTasks as listTasks, teamReadManifest as readTeamManifestV2, teamNormalizePolicy as normalizeTeamPolicy, teamClaimTask as claimTask, teamReleaseTaskClaim as releaseTaskClaim, teamAppendEvent as appendTeamEvent, teamReadTaskApproval as readTaskApproval, teamListMailbox as listMailboxMessages, teamMarkMessageNotified as markMessageNotified, teamEnqueueDispatchRequest as enqueueDispatchRequest, teamMarkDispatchRequestNotified as markDispatchRequestNotified, teamTransitionDispatchRequest as transitionDispatchRequest, teamReadDispatchRequest as readDispatchRequest, teamCleanup as cleanupTeamState, teamSaveConfig as saveTeamConfig, teamWriteShutdownRequest as writeShutdownRequest, teamReadShutdownAck as readShutdownAck, teamReadMonitorSnapshot as readMonitorSnapshot, teamWriteMonitorSnapshot as writeMonitorSnapshot, teamReadPhase as readTeamPhaseState, teamWritePhase as writeTeamPhaseState, } from './team-ops.js';
+import { sanitizeTeamName, isTmuxAvailable, createTeamSession, buildWorkerProcessLaunchSpec, resolveTeamWorkerCli, resolveTeamWorkerCliPlan, resolveTeamWorkerLaunchMode, waitForWorkerReady, dismissTrustPromptIfPresent, sleepFractionalSeconds, sendToWorker, sendToLeaderPane, sendToWorkerStdin, isWorkerAlive, getWorkerPanePid, killWorkerByPaneIdAsync, teardownWorkerPanes, unregisterResizeHook, destroyTeamSession, listTeamSessions, } from './tmux-session.js';
+import { teamInit as initTeamState, DEFAULT_MAX_WORKERS, teamReadConfig as readTeamConfig, teamWriteWorkerIdentity as writeWorkerIdentity, teamReadWorkerHeartbeat as readWorkerHeartbeat, teamReadWorkerStatus as readWorkerStatus, teamWriteWorkerInbox as writeWorkerInbox, teamCreateTask as createStateTask, teamReadTask as readTask, teamListTasks as listTasks, teamReadManifest as readTeamManifestV2, teamNormalizePolicy as normalizeTeamPolicy, teamClaimTask as claimTask, teamReleaseTaskClaim as releaseTaskClaim, teamAppendEvent as appendTeamEvent, teamReadTaskApproval as readTaskApproval, teamListMailbox as listMailboxMessages, teamMarkMessageDelivered as markMessageDelivered, teamMarkMessageNotified as markMessageNotified, teamEnqueueDispatchRequest as enqueueDispatchRequest, teamMarkDispatchRequestNotified as markDispatchRequestNotified, teamTransitionDispatchRequest as transitionDispatchRequest, teamReadDispatchRequest as readDispatchRequest, teamCleanup as cleanupTeamState, teamSaveConfig as saveTeamConfig, teamWriteShutdownRequest as writeShutdownRequest, teamReadShutdownAck as readShutdownAck, teamReadMonitorSnapshot as readMonitorSnapshot, teamWriteMonitorSnapshot as writeMonitorSnapshot, teamReadPhase as readTeamPhaseState, teamWritePhase as writeTeamPhaseState, } from './team-ops.js';
 import { queueInboxInstruction, queueDirectMailboxMessage, queueBroadcastMailboxMessage, waitForDispatchReceipt, } from './mcp-comm.js';
 import { generateWorkerOverlay, writeTeamWorkerInstructionsFile, removeTeamWorkerInstructionsFile, generateInitialInbox, generateTaskAssignmentInbox, generateShutdownInbox, generateTriggerMessage, generateMailboxTriggerMessage, } from './worker-bootstrap.js';
+import { loadRolePrompt } from './role-router.js';
+import { codexPromptsDir } from '../utils/paths.js';
 import { isLowComplexityAgentType, resolveTeamWorkerLaunchArgs, TEAM_LOW_COMPLEXITY_DEFAULT_MODEL, resolveTeamLowComplexityDefaultModel, parseTeamWorkerLaunchArgs, splitWorkerLaunchArgs, } from './model-contract.js';
 import { inferPhaseTargetFromTaskCounts, reconcilePhaseStateForMonitor } from './phase-controller.js';
 import { getTeamTmuxSessions } from '../notifications/tmux.js';
@@ -401,11 +403,24 @@ export async function startTeam(teamName, task, agentType, workerCount, tasks, c
             const workerWorkspace = workerWorkspaceByName.get(workerName) ?? { cwd: leaderCwd };
             // Get tasks assigned to this worker
             const workerTasks = allTasks.filter(t => t.owner === workerName);
+            // Resolve per-worker role from assigned task roles
+            const taskRoles = workerTasks.map(t => t.role).filter(Boolean);
+            const uniqueTaskRoles = new Set(taskRoles);
+            const workerRole = taskRoles.length > 0 && uniqueTaskRoles.size === 1
+                ? taskRoles[0]
+                : agentType;
+            if (uniqueTaskRoles.size > 1) {
+                console.log(`[omx:team] ${workerName}: mixed task roles [${[...uniqueTaskRoles].join(', ')}], falling back to ${agentType}`);
+            }
+            // Load role-specific prompt content if role differs from default
+            const rolePromptContent = workerRole !== agentType
+                ? await loadRolePrompt(workerRole, codexPromptsDir())
+                : null;
             // Write worker identity
             const identity = {
                 name: workerName,
                 index: i,
-                role: agentType,
+                role: workerRole,
                 worker_cli: workerCliPlan[i - 1],
                 assigned_tasks: workerTasks.map(t => t.id),
                 working_dir: workerWorkspace.cwd,
@@ -448,6 +463,8 @@ export async function startTeam(teamName, task, agentType, workerCount, tasks, c
             const inbox = generateInitialInbox(workerName, sanitized, agentType, workerTasks, {
                 teamStateRoot,
                 leaderCwd,
+                workerRole,
+                rolePromptContent: rolePromptContent ?? undefined,
             });
             const trigger = generateTriggerMessage(workerName, sanitized);
             const maxStartupDispatchRetries = 3;
@@ -524,13 +541,13 @@ export async function startTeam(teamName, task, agentType, workerCount, tasks, c
             if (sessionName.includes(':')) {
                 for (const paneId of createdWorkerPaneIds) {
                     try {
-                        killWorkerByPaneId(paneId, createdLeaderPaneId);
+                        await killWorkerByPaneIdAsync(paneId, createdLeaderPaneId);
                     }
                     catch { /* ignore */ }
                 }
                 if (config?.hud_pane_id) {
                     try {
-                        killWorkerByPaneId(config.hud_pane_id, createdLeaderPaneId);
+                        await killWorkerByPaneIdAsync(config.hud_pane_id, createdLeaderPaneId);
                     }
                     catch { /* ignore */ }
                 }
@@ -573,7 +590,9 @@ export async function startTeam(teamName, task, agentType, workerCount, tasks, c
         }
         if (provisionedWorktrees.length > 0) {
             try {
-                await rollbackProvisionedWorktrees(provisionedWorktrees);
+                await rollbackProvisionedWorktrees(provisionedWorktrees, {
+                    skipBranchDeletion: options.ralph === true,
+                });
             }
             catch (cleanupError) {
                 rollbackErrors.push(`rollbackProvisionedWorktrees: ${String(cleanupError)}`);
@@ -691,6 +710,20 @@ export async function monitorTeam(teamName, cwd) {
     const mailboxDeliveryStartMs = performance.now();
     const mailboxNotifiedByMessageId = await deliverPendingMailboxMessages(sanitized, config, workers, previousSnapshot?.mailboxNotifiedByMessageId ?? {}, dispatchPolicy, cwd);
     const mailboxDeliveryMs = performance.now() - mailboxDeliveryStartMs;
+    // Prune ephemeral status messages from leader mailbox (TTL: 60s)
+    try {
+        const leaderMailbox = await listMailboxMessages(sanitized, 'leader-fixed', cwd);
+        const now = Date.now();
+        for (const msg of leaderMailbox) {
+            if (msg.from_worker === 'system' && msg.created_at) {
+                const age = now - new Date(msg.created_at).getTime();
+                if (age > 60_000) {
+                    await markMessageDelivered(sanitized, 'leader-fixed', msg.message_id, cwd);
+                }
+            }
+        }
+    }
+    catch { /* best-effort */ }
     const updatedAt = new Date().toISOString();
     const totalMs = performance.now() - monitorStartMs;
     await writeMonitorSnapshot(sanitized, {
@@ -788,7 +821,7 @@ export async function assignTask(teamName, workerName, taskId, cwd) {
                     waitForWorkerReady(config.tmux_session, workerInfo.index, 15_000, workerInfo.pane_id);
                 }
                 else {
-                    sleepFractionalSeconds(assignRetryDelayS);
+                    await new Promise(r => setTimeout(r, assignRetryDelayS * 1000));
                 }
             }
         }
@@ -827,6 +860,7 @@ export async function reassignTask(teamName, taskId, _fromWorker, toWorker, cwd)
  */
 export async function shutdownTeam(teamName, cwd, options = {}) {
     const force = options.force === true;
+    const ralph = options.ralph === true;
     const sanitized = sanitizeTeamName(teamName);
     const config = await readTeamConfig(sanitized, cwd);
     if (!config) {
@@ -854,10 +888,22 @@ export async function shutdownTeam(teamName, cwd, options = {}) {
         await appendTeamEvent(sanitized, {
             type: 'shutdown_gate',
             worker: 'leader-fixed',
-            reason: `allowed=${gate.allowed} total=${gate.total} pending=${gate.pending} blocked=${gate.blocked} in_progress=${gate.in_progress} completed=${gate.completed} failed=${gate.failed}`,
+            reason: `allowed=${gate.allowed} total=${gate.total} pending=${gate.pending} blocked=${gate.blocked} in_progress=${gate.in_progress} completed=${gate.completed} failed=${gate.failed}${ralph ? ' policy=ralph' : ''}`,
         }, cwd).catch(() => { });
         if (!gate.allowed) {
-            throw new Error(`shutdown_gate_blocked:pending=${gate.pending},blocked=${gate.blocked},in_progress=${gate.in_progress},failed=${gate.failed}`);
+            const hasActiveWork = gate.pending > 0 || gate.blocked > 0 || gate.in_progress > 0;
+            if (ralph && !hasActiveWork) {
+                // Ralph policy: bypass on failure-only scenarios (no pending/blocked/in_progress tasks).
+                // This allows the ralph loop to retry rather than leaving stale team state.
+                await appendTeamEvent(sanitized, {
+                    type: 'ralph_cleanup_policy',
+                    worker: 'leader-fixed',
+                    reason: `gate_bypassed:pending=${gate.pending},blocked=${gate.blocked},in_progress=${gate.in_progress},failed=${gate.failed}`,
+                }, cwd).catch(() => { });
+            }
+            else {
+                throw new Error(`shutdown_gate_blocked:pending=${gate.pending},blocked=${gate.blocked},in_progress=${gate.in_progress},failed=${gate.failed}`);
+            }
         }
     }
     if (force) {
@@ -954,19 +1000,13 @@ export async function shutdownTeam(teamName, cwd, options = {}) {
         if (resizeHookWarning) {
             console.warn(`[team shutdown] ${sanitized}: ${resizeHookWarning}; continuing teardown`);
         }
-        for (const w of config.workers) {
-            try {
-                // Guard: never kill the leader's own pane or the HUD pane.
-                if (leaderPaneId && w.pane_id === leaderPaneId)
-                    continue;
-                if (hudPaneId && w.pane_id === hudPaneId)
-                    continue;
-                if (isWorkerAlive(sessionName, w.index, w.pane_id)) {
-                    killWorker(sessionName, w.index, w.pane_id, leaderPaneId ?? undefined);
-                }
-            }
-            catch { /* ignore */ }
-        }
+        const workerPaneIds = config.workers
+            .map((w) => w.pane_id)
+            .filter((paneId) => typeof paneId === 'string' && paneId.trim().length > 0);
+        await teardownWorkerPanes(workerPaneIds, {
+            leaderPaneId,
+            hudPaneId,
+        });
         // 4. Destroy tmux session
         if (!sessionName.includes(':')) {
             try {
@@ -993,7 +1033,19 @@ export async function shutdownTeam(teamName, cwd, options = {}) {
     }
     catch { /* ignore */ }
     restoreTeamModelInstructionsFile(sanitized);
-    // 6. Cleanup state
+    // 6. Ralph stricter completion logging
+    if (ralph) {
+        const finalTasks = await listTasks(sanitized, cwd).catch(() => []);
+        const completed = finalTasks.filter((t) => t.status === 'completed').length;
+        const failed = finalTasks.filter((t) => t.status === 'failed').length;
+        const pending = finalTasks.filter((t) => t.status === 'pending').length;
+        await appendTeamEvent(sanitized, {
+            type: 'ralph_cleanup_summary',
+            worker: 'leader-fixed',
+            reason: `total=${finalTasks.length} completed=${completed} failed=${failed} pending=${pending} force=${force}`,
+        }, cwd).catch(() => { });
+    }
+    // 7. Cleanup state
     await cleanupTeamState(sanitized, cwd);
 }
 /**
@@ -1144,7 +1196,7 @@ async function emitMonitorDerivedEvents(teamName, tasks, workers, previous, cwd)
         }
     }
 }
-function notifyWorkerOutcome(config, workerIndex, message, workerPaneId) {
+async function notifyWorkerOutcome(config, workerIndex, message, workerPaneId) {
     const worker = config.workers.find((candidate) => candidate.index === workerIndex);
     if (!worker)
         return { ok: false, transport: 'none', reason: 'worker_not_found' };
@@ -1168,7 +1220,7 @@ function notifyWorkerOutcome(config, workerIndex, message, workerPaneId) {
         return { ok: false, transport: 'tmux_send_keys', reason: 'tmux_unavailable' };
     }
     try {
-        sendToWorker(config.tmux_session, workerIndex, message, workerPaneId, worker.worker_cli);
+        await sendToWorker(config.tmux_session, workerIndex, message, workerPaneId, worker.worker_cli);
         return { ok: true, transport: 'tmux_send_keys', reason: 'tmux_send_keys_sent' };
     }
     catch (error) {
@@ -1240,7 +1292,7 @@ async function dispatchCriticalInboxInstruction(params) {
         return { ok: true, transport: 'hook', reason: `hook_receipt_${receipt.status}`, request_id: queued.request_id };
     }
     if (receipt?.status === 'failed') {
-        const fallback = notifyWorkerOutcome(config, workerIndex, triggerMessage, paneId);
+        const fallback = await notifyWorkerOutcome(config, workerIndex, triggerMessage, paneId);
         if (fallback.ok) {
             await transitionDispatchRequest(teamName, queued.request_id, 'failed', 'failed', { last_reason: `fallback_confirmed_after_failed_receipt:${fallback.reason}` }, cwd).catch(() => { });
             return {
@@ -1258,7 +1310,7 @@ async function dispatchCriticalInboxInstruction(params) {
             request_id: queued.request_id,
         };
     }
-    const fallback = notifyWorkerOutcome(config, workerIndex, triggerMessage, paneId);
+    const fallback = await notifyWorkerOutcome(config, workerIndex, triggerMessage, paneId);
     if (fallback.ok) {
         const marked = await markDispatchRequestNotified(teamName, queued.request_id, { last_reason: `fallback_confirmed:${fallback.reason}` }, cwd);
         if (!marked) {
@@ -1293,9 +1345,9 @@ async function finalizeHookPreferredMailboxDispatch(params) {
         return { ok: true, transport: 'hook', reason: `hook_receipt_${receipt.status}`, request_id: requestId, message_id: messageId };
     }
     const fallback = fallbackNotify
-        ? fallbackNotify()
+        ? await fallbackNotify()
         : (typeof workerIndex === 'number'
-            ? notifyWorkerOutcome(config, workerIndex, triggerMessage, paneId)
+            ? await notifyWorkerOutcome(config, workerIndex, triggerMessage, paneId)
             : { ok: false, transport: 'none', reason: 'missing_worker_index' });
     if (receipt?.status === 'failed') {
         if (fallback.ok) {
@@ -1344,10 +1396,24 @@ async function finalizeHookPreferredMailboxDispatch(params) {
         message_id: messageId,
     };
 }
-function notifyLeader(config, message) {
+async function notifyLeaderAsync(config, message, cwd) {
+    // Primary: inject directly into the leader pane via tmux send-keys.
+    // This is the fallback path when hook-based dispatch timed out, so the
+    // leader needs a direct tmux notification to wake up. Fixes #437.
+    if (config.leader_pane_id && isTmuxAvailable()) {
+        try {
+            await sendToLeaderPane(config.leader_pane_id, message);
+            return true;
+        }
+        catch {
+            // Fall through to mailbox
+        }
+    }
+    // Fallback: write to leader mailbox (leader picks up on next hook cycle)
     if (!config.tmux_session)
         return false;
-    return notifyLeaderStatus(config.tmux_session, message);
+    const { notifyLeaderMailboxAsync } = await import('./tmux-session.js');
+    return notifyLeaderMailboxAsync(config.name, 'system', message, cwd);
 }
 async function deliverPendingMailboxMessages(teamName, config, workers, previousNotifications, dispatchPolicy, cwd) {
     const nextNotifications = {};
@@ -1410,7 +1476,7 @@ async function deliverPendingMailboxMessages(teamName, config, workers, previous
                 });
             }
             else {
-                const direct = notifyWorkerOutcome(config, workerInfo.index, triggerMessage, workerInfo.pane_id);
+                const direct = await notifyWorkerOutcome(config, workerInfo.index, triggerMessage, workerInfo.pane_id);
                 outcome = { ...direct, request_id: queued.request.request_id, message_id: msg.message_id };
                 if (outcome.ok) {
                     await markMessageNotified(teamName, worker.name, msg.message_id, cwd).catch(() => false);
@@ -1451,9 +1517,9 @@ export async function sendWorkerMessage(teamName, fromWorker, toWorker, body, cw
             cwd,
             transportPreference: leaderTransportPreference,
             fallbackAllowed: leaderTransportPreference === 'hook_preferred_with_fallback',
-            notify: (_target, message) => (leaderTransportPreference === 'hook_preferred_with_fallback'
+            notify: async (_target, message) => (leaderTransportPreference === 'hook_preferred_with_fallback'
                 ? { ok: true, transport: 'hook', reason: 'queued_for_hook_dispatch' }
-                : { ok: notifyLeader(config, message), transport: 'tmux_send_keys', reason: 'leader_notified' }),
+                : { ok: await notifyLeaderAsync(config, message, cwd), transport: 'mailbox', reason: 'leader_mailbox_notified' }),
         });
         let finalOutcome = outcome;
         const canLeaderFallbackDirectly = Boolean(config.leader_pane_id) && isTmuxAvailable();
@@ -1471,10 +1537,10 @@ export async function sendWorkerMessage(teamName, fromWorker, toWorker, body, cw
                 config,
                 dispatchPolicy,
                 cwd,
-                fallbackNotify: () => ({
-                    ok: notifyLeader(config, leaderTriggerMessage),
-                    transport: 'tmux_send_keys',
-                    reason: 'leader_notified',
+                fallbackNotify: async () => ({
+                    ok: await notifyLeaderAsync(config, leaderTriggerMessage, cwd),
+                    transport: 'mailbox',
+                    reason: 'leader_mailbox_notified',
                 }),
             });
         }
@@ -1500,9 +1566,9 @@ export async function sendWorkerMessage(teamName, fromWorker, toWorker, body, cw
         cwd,
         transportPreference,
         fallbackAllowed: transportPreference === 'hook_preferred_with_fallback',
-        notify: (_target, message) => (transportPreference === 'hook_preferred_with_fallback'
+        notify: async (_target, message) => (transportPreference === 'hook_preferred_with_fallback'
             ? { ok: true, transport: 'hook', reason: 'queued_for_hook_dispatch' }
-            : notifyWorkerOutcome(config, recipient.index, message, recipient.pane_id)),
+            : await notifyWorkerOutcome(config, recipient.index, message, recipient.pane_id)),
     });
     let finalOutcome = outcome;
     if (transportPreference === 'hook_preferred_with_fallback') {
@@ -1544,10 +1610,10 @@ export async function broadcastWorkerMessage(teamName, fromWorker, body, cwd) {
         triggerFor: (workerName) => generateMailboxTriggerMessage(workerName, sanitized, 1),
         transportPreference,
         fallbackAllowed: transportPreference === 'hook_preferred_with_fallback',
-        notify: (target, message) => transportPreference === 'hook_preferred_with_fallback'
+        notify: async (target, message) => transportPreference === 'hook_preferred_with_fallback'
             ? { ok: true, transport: 'hook', reason: 'queued_for_hook_dispatch' }
             : (typeof target.workerIndex === 'number'
-                ? notifyWorkerOutcome(config, target.workerIndex, message, target.paneId)
+                ? await notifyWorkerOutcome(config, target.workerIndex, message, target.paneId)
                 : { ok: false, transport: 'none', reason: 'missing_worker_index' }),
     });
     const finalizedOutcomes = [];