oh-my-codex 0.7.5 → 0.8.0

package/dist/team/role-router.js

@@ -0,0 +1,137 @@
+/**
+ * Role Router for team orchestration.
+ *
+ * Layer 1: Prompt loading utilities (loadRolePrompt, isKnownRole, listAvailableRoles)
+ * Layer 2: Heuristic role routing (routeTaskToRole, computeWorkerRoleAssignments)
+ */
+import { readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+// ─── Layer 1: Prompt Loading ────────────────────────────────────────────────
+/** Role names must be lowercase alphanumeric with hyphens (e.g., 'test-engineer'). */
+const SAFE_ROLE_PATTERN = /^[a-z][a-z0-9-]*$/;
+/**
+ * Load behavioral prompt content for a given agent role.
+ * Returns null if the prompt file does not exist or the role name is invalid.
+ */
+export async function loadRolePrompt(role, promptsDir) {
+    if (!SAFE_ROLE_PATTERN.test(role))
+        return null;
+    const filePath = join(promptsDir, `${role}.md`);
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return content.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check whether a role has a corresponding prompt file.
+ */
+export function isKnownRole(role, promptsDir) {
+    if (!SAFE_ROLE_PATTERN.test(role))
+        return false;
+    return existsSync(join(promptsDir, `${role}.md`));
+}
+/**
+ * List all available roles by scanning the prompts directory.
+ * Returns role names (filename without .md extension).
+ */
+export async function listAvailableRoles(promptsDir) {
+    try {
+        const files = await readdir(promptsDir);
+        return files
+            .filter(f => f.endsWith('.md'))
+            .map(f => f.slice(0, -3))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Keyword-to-role mapping categories.
+ * Order matters: first match wins within a category, but higher keyword count wins across categories.
+ */
+const ROLE_KEYWORDS = [
+    { role: 'test-engineer', keywords: ['test', 'spec', 'coverage', 'tdd', 'jest', 'vitest', 'mocha', 'pytest', 'unit test', 'integration test', 'e2e'] },
+    { role: 'designer', keywords: ['ui', 'component', 'layout', 'css', 'design', 'responsive', 'tailwind', 'react', 'frontend', 'styling', 'ux'] },
+    { role: 'build-fixer', keywords: ['build', 'compile', 'tsc', 'type error', 'typescript error', 'build error', 'compilation'] },
+    { role: 'debugger', keywords: ['debug', 'investigate', 'root cause', 'regression', 'stack trace', 'bisect', 'diagnose'] },
+    { role: 'writer', keywords: ['doc', 'readme', 'migration guide', 'changelog', 'comment', 'documentation', 'api doc'] },
+    { role: 'quality-reviewer', keywords: ['review', 'audit', 'quality', 'lint', 'anti-pattern', 'code review'] },
+    { role: 'security-reviewer', keywords: ['security', 'auth', 'owasp', 'xss', 'injection', 'cve', 'vulnerability', 'authentication', 'authorization'] },
+    { role: 'code-simplifier', keywords: ['refactor', 'simplify', 'clean up', 'reduce complexity', 'consolidate'] },
+];
+/**
+ * Phase-context labels used in routing reason strings.
+ * These are NOT applied as role assignments — they only appear in diagnostic output
+ * to indicate what a phase-aware router might suggest.
+ */
+const PHASE_CONTEXT_LABELS = {
+    'team-verify': 'verifier',
+    'team-fix': 'build-fixer',
+    'team-plan': 'planner',
+    'team-prd': 'analyst',
+};
+/**
+ * Map a task description to the best agent role using keyword heuristics.
+ * Falls back to fallbackRole when confidence is low.
+ */
+export function routeTaskToRole(taskSubject, taskDescription, phase, fallbackRole) {
+    const text = `${taskSubject} ${taskDescription}`.toLowerCase();
+    // Score each role category by keyword match count
+    let bestRole = '';
+    let bestCount = 0;
+    let bestKeyword = '';
+    for (const { role, keywords } of ROLE_KEYWORDS) {
+        let count = 0;
+        let matchedKeyword = '';
+        for (const kw of keywords) {
+            if (text.includes(kw)) {
+                count++;
+                if (!matchedKeyword)
+                    matchedKeyword = kw;
+            }
+        }
+        if (count > bestCount) {
+            bestCount = count;
+            bestRole = role;
+            bestKeyword = matchedKeyword;
+        }
+    }
+    // High confidence: 2+ keyword matches from the same category
+    if (bestCount >= 2) {
+        return {
+            role: bestRole,
+            confidence: 'high',
+            reason: `matched ${bestCount} keywords in ${bestRole} category (e.g., "${bestKeyword}")`,
+        };
+    }
+    // Medium confidence: exactly 1 keyword match
+    if (bestCount === 1) {
+        return {
+            role: bestRole,
+            confidence: 'medium',
+            reason: `matched keyword "${bestKeyword}" for ${bestRole}`,
+        };
+    }
+    // Low confidence: phase-context inference only
+    if (phase) {
+        const phaseDefault = PHASE_CONTEXT_LABELS[phase];
+        if (phaseDefault) {
+            return {
+                role: fallbackRole, // use fallbackRole for low confidence per plan
+                confidence: 'low',
+                reason: `no keyword match; phase ${phase} suggests ${phaseDefault} but using fallback`,
+            };
+        }
+    }
+    return {
+        role: fallbackRole,
+        confidence: 'low',
+        reason: 'no keyword match; using fallback role',
+    };
+}
+//# sourceMappingURL=role-router.js.map

package/dist/team/role-router.js.map

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

package/dist/team/runtime-cli.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export interface LivePaneState {
+    paneIds: string[];
+    leaderPaneId: string;
+}
+export declare function loadLivePaneState(teamName: string, cwd: string): Promise<LivePaneState | null>;
+export declare function shutdownWithForceFallback(teamName: string, cwd: string): Promise<void>;
+export declare function detectDeadWorkerFailure(deadWorkerCount: number, liveWorkerPaneCount: number, hasOutstandingWork: boolean, phase: string): {
+    deadWorkerFailure: boolean;
+    fixingWithNoWorkers: boolean;
+};
+//# sourceMappingURL=runtime-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../../src/team/runtime-cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAkBD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CASpG;AAED,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5F;AAED,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,MAAM,EAC3B,kBAAkB,EAAE,OAAO,EAC3B,KAAK,EAAE,MAAM,GACZ;IAAE,iBAAiB,EAAE,OAAO,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAA;CAAE,CAM9D"}

package/dist/team/runtime-cli.js

@@ -0,0 +1,244 @@
+/**
+ * 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
+    let shutdownInProgress = false;
+    const handleShutdown = (signal) => {
+        if (shutdownInProgress)
+            return;
+        shutdownInProgress = true;
+        process.stderr.write(`[runtime-cli] Received ${signal}, shutting down...\n`);
+        doShutdown('failed')
+            .catch((err) => {
+            process.stderr.write(`[runtime-cli] Shutdown error: ${err}\n`);
+        })
+            .finally(() => process.exit(1));
+    };
+    process.on('SIGINT', () => handleShutdown('SIGINT'));
+    process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+    // 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":"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"}

package/dist/team/runtime.d.ts

@@ -1,6 +1,7 @@
 import { type TeamConfig, type WorkerHeartbeat, type WorkerStatus, type TeamTask } from './team-ops.js';
 import { type TeamPhase, type TerminalPhase } from './orchestrator.js';
 import { TEAM_LOW_COMPLEXITY_DEFAULT_MODEL } from './model-contract.js';
+import { resolveCanonicalTeamStateRoot } from './state-root.js';
 import { type WorktreeMode } from './worktree.js';
 /** Snapshot of the team state at a point in time */
 export interface TeamSnapshot {
@@ -45,12 +46,16 @@ 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;
+export { resolveCanonicalTeamStateRoot };
 export declare function resolveWorkerLaunchArgsFromEnv(env: NodeJS.ProcessEnv, agentType: string, inheritedLeaderModel?: string): string[];
 /**
  * Start a new team: init state, create tmux session, bootstrap workers.

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

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