oh-my-codex 0.18.11 → 0.18.13

package/dist/pipeline/stages/ultraqa.js

@@ -25,6 +25,9 @@ export function createUltraqaStage(options = {}) {
                 summary: options.summary ?? (hasQaEvidence
                     ? (clean ? 'UltraQA gate clean.' : 'UltraQA found issues; return to ralplan.')
                     : 'UltraQA evidence missing; fail closed and return to ralplan.'),
+                stage: 'ultraqa',
+                artifact_path: '.omx/state/autopilot-state.json#pipeline_stage_results.ultraqa.artifacts.qa_verdict',
+                ...(skipped ? { reason: options.summary ?? 'UltraQA explicitly skipped.' } : {}),
             };
             return {
                 status: 'completed',

package/dist/pipeline/stages/ultraqa.js.map

@@ -1 +1 @@
-{"version":3,"file":"ultraqa.js","sourceRoot":"","sources":["../../../src/pipeline/stages/ultraqa.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,OAAO;QACL,IAAI,EAAE,SAAS;QAEf,KAAK,CAAC,GAAG,CAAC,GAAiB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAsB;gBACpC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,kBAAkB,EAAG,GAAG,CAAC,SAAS,CAAC,SAAiD,IAAI,EAAE;gBAC1F,mBAAmB,EAAG,GAAG,CAAC,SAAS,CAAC,aAAa,CAAyC,IAAI,EAAE;gBAChG,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;aAC/C,CAAC;YACF,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;YACnF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;YACzC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACjE,MAAM,OAAO,GAAmB;gBAC9B,KAAK;gBACL,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,aAAa;oBACxC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,0CAA0C,CAAC;oBAC9E,CAAC,CAAC,8DAA8D,CAAC;aACpE,CAAC;YAEF,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE;oBACT,KAAK,EAAE,SAAS;oBAChB,iBAAiB,EAAE,UAAU;oBAC7B,UAAU,EAAE,OAAO;oBACnB,wBAAwB,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;oBACxD,WAAW,EAAE,UAAU,CAAC,WAAW;iBACpC;gBACD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACpC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"ultraqa.js","sourceRoot":"","sources":["../../../src/pipeline/stages/ultraqa.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,OAAO;QACL,IAAI,EAAE,SAAS;QAEf,KAAK,CAAC,GAAG,CAAC,GAAiB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAsB;gBACpC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,kBAAkB,EAAG,GAAG,CAAC,SAAS,CAAC,SAAiD,IAAI,EAAE;gBAC1F,mBAAmB,EAAG,GAAG,CAAC,SAAS,CAAC,aAAa,CAAyC,IAAI,EAAE;gBAChG,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;aAC/C,CAAC;YACF,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;YACnF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;YACzC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACjE,MAAM,OAAO,GAAmB;gBAC9B,KAAK;gBACL,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,aAAa;oBACxC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,0CAA0C,CAAC;oBAC9E,CAAC,CAAC,8DAA8D,CAAC;gBACnE,KAAK,EAAE,SAAS;gBAChB,aAAa,EAAE,qFAAqF;gBACpG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,6BAA6B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjF,CAAC;YAEF,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE;oBACT,KAAK,EAAE,SAAS;oBAChB,iBAAiB,EAAE,UAAU;oBAC7B,UAAU,EAAE,OAAO;oBACnB,wBAAwB,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;oBACxD,WAAW,EAAE,UAAU,CAAC,WAAW;iBACpC;gBACD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACpC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/ralplan/__tests__/consensus-gate.test.d.ts

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

package/dist/ralplan/__tests__/consensus-gate.test.d.ts.map

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

package/dist/ralplan/__tests__/consensus-gate.test.js

@@ -0,0 +1,631 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { getBaseStateDir } from '../../state/paths.js';
+import { subagentTrackingPath } from '../../subagents/tracker.js';
+import { buildRalplanConsensusGateForCwd, buildRalplanConsensusGateFromSources } from '../consensus-gate.js';
+describe('ralplan consensus gate state roots', () => {
+    it('rejects invalid complete consensus even when it appears after a valid source', () => {
+        const validConsensus = {
+            ralplan_consensus_gate: {
+                complete: true,
+                sequence: ['architect-review', 'critic-review'],
+                ralplan_architect_review: {
+                    agent_role: 'architect',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:00:00.000Z',
+                },
+                ralplan_critic_review: {
+                    agent_role: 'critic',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:05:00.000Z',
+                },
+            },
+        };
+        const invalidConsensus = {
+            ralplan_consensus_gate: {
+                complete: true,
+                sequence: ['architect-review', 'critic-review'],
+                ralplan_architect_review: {
+                    agent_role: 'architect',
+                    verdict: 'iterate',
+                    completed_at: '2026-06-12T10:10:00.000Z',
+                },
+                ralplan_critic_review: {
+                    agent_role: 'critic',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:15:00.000Z',
+                },
+            },
+        };
+        const gate = buildRalplanConsensusGateFromSources([
+            { source: 'older-valid-source', value: validConsensus },
+            { source: 'later-invalid-source', value: invalidConsensus },
+        ]);
+        assert.equal(gate.complete, false);
+        assert.equal(gate.source, 'later-invalid-source');
+        assert.equal(gate.blockedReason, 'non_approving_ralplan_consensus_review');
+        assert.match(gate.blockedDetails?.join(' ') ?? '', /architect.*verdict=iterate/i);
+    });
+    it('rejects malformed complete consensus even when it appears after a valid source', () => {
+        const validConsensus = {
+            ralplan_consensus_gate: {
+                complete: true,
+                sequence: ['architect-review', 'critic-review'],
+                ralplan_architect_review: {
+                    agent_role: 'architect',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:00:00.000Z',
+                },
+                ralplan_critic_review: {
+                    agent_role: 'critic',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:05:00.000Z',
+                },
+            },
+        };
+        const malformedConsensus = {
+            ralplan_consensus_gate: {
+                complete: true,
+                sequence: ['critic-review', 'architect-review'],
+                ralplan_architect_review: {
+                    agent_role: 'architect',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:10:00.000Z',
+                },
+                ralplan_critic_review: {
+                    agent_role: 'critic',
+                    verdict: 'approve',
+                    completed_at: '2026-06-12T10:15:00.000Z',
+                },
+            },
+        };
+        const gate = buildRalplanConsensusGateFromSources([
+            { source: 'older-valid-source', value: validConsensus },
+            { source: 'later-malformed-source', value: malformedConsensus },
+        ]);
+        assert.equal(gate.complete, false);
+        assert.equal(gate.source, 'later-malformed-source');
+        assert.equal(gate.blockedReason, 'non_approving_ralplan_consensus_review');
+        assert.match(gate.blockedDetails?.join(' ') ?? '', /sequence is not architect-review then critic-review/i);
+    });
+    it('ignores ambient root consensus unless the ambient session is bound to this cwd', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-local-'));
+        const ambientRoot = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-ambient-'));
+        const previousOmxRoot = process.env.OMX_ROOT;
+        const previousOmxStateRoot = process.env.OMX_STATE_ROOT;
+        const previousOmxTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        try {
+            process.env.OMX_ROOT = ambientRoot;
+            delete process.env.OMX_STATE_ROOT;
+            delete process.env.OMX_TEAM_STATE_ROOT;
+            const ambientStateDir = getBaseStateDir(cwd);
+            await mkdir(ambientStateDir, { recursive: true });
+            await writeFile(join(ambientStateDir, 'ralplan-state.json'), JSON.stringify({
+                ralplan_consensus_gate: {
+                    complete: true,
+                    sequence: ['architect-review', 'critic-review'],
+                    ralplan_architect_review: { agent_role: 'architect', verdict: 'approve' },
+                    ralplan_critic_review: { agent_role: 'critic', verdict: 'approve' },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd);
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            if (typeof previousOmxRoot === 'string')
+                process.env.OMX_ROOT = previousOmxRoot;
+            else
+                delete process.env.OMX_ROOT;
+            if (typeof previousOmxStateRoot === 'string')
+                process.env.OMX_STATE_ROOT = previousOmxStateRoot;
+            else
+                delete process.env.OMX_STATE_ROOT;
+            if (typeof previousOmxTeamStateRoot === 'string')
+                process.env.OMX_TEAM_STATE_ROOT = previousOmxTeamStateRoot;
+            else
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            await rm(cwd, { recursive: true, force: true });
+            await rm(ambientRoot, { recursive: true, force: true });
+        }
+    });
+    it('reads tracker-backed consensus evidence from OMX_STATE_ROOT instead of cwd/.omx/state', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-cwd-'));
+        const boxedRoot = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-state-root-'));
+        const previousOmxRoot = process.env.OMX_ROOT;
+        const previousOmxStateRoot = process.env.OMX_STATE_ROOT;
+        const previousOmxTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        const sessionId = 'sess-boxed-consensus';
+        try {
+            delete process.env.OMX_ROOT;
+            delete process.env.OMX_TEAM_STATE_ROOT;
+            process.env.OMX_STATE_ROOT = boxedRoot;
+            const baseStateDir = getBaseStateDir(cwd);
+            const sessionDir = join(baseStateDir, 'sessions', sessionId);
+            await mkdir(sessionDir, { recursive: true });
+            await writeFile(join(baseStateDir, 'session.json'), JSON.stringify({
+                session_id: sessionId,
+                native_session_id: 'thread-leader',
+                cwd,
+            }, null, 2));
+            await writeFile(subagentTrackingPath(cwd), JSON.stringify({
+                schemaVersion: 1,
+                sessions: {
+                    [sessionId]: {
+                        session_id: sessionId,
+                        leader_thread_id: 'thread-leader',
+                        updated_at: '2026-06-11T16:30:00.000Z',
+                        threads: {
+                            'thread-leader': {
+                                thread_id: 'thread-leader',
+                                kind: 'leader',
+                                first_seen_at: '2026-06-11T16:29:00.000Z',
+                                last_seen_at: '2026-06-11T16:29:00.000Z',
+                                turn_count: 1,
+                            },
+                            'thread-architect': {
+                                thread_id: 'thread-architect',
+                                kind: 'subagent',
+                                first_seen_at: '2026-06-11T16:29:30.000Z',
+                                last_seen_at: '2026-06-11T16:29:30.000Z',
+                                completed_at: '2026-06-11T16:29:30.000Z',
+                                turn_count: 1,
+                            },
+                            'thread-critic': {
+                                thread_id: 'thread-critic',
+                                kind: 'subagent',
+                                first_seen_at: '2026-06-11T16:30:00.000Z',
+                                last_seen_at: '2026-06-11T16:30:00.000Z',
+                                completed_at: '2026-06-11T16:30:00.000Z',
+                                turn_count: 1,
+                            },
+                        },
+                    },
+                },
+            }, null, 2));
+            await writeFile(join(sessionDir, 'autopilot-state.json'), JSON.stringify({
+                current_phase: 'ralplan',
+                handoff_artifacts: {
+                    ralplan_consensus_gate: {
+                        complete: true,
+                        sequence: ['architect-review', 'critic-review'],
+                        ralplan_architect_review: {
+                            agent_role: 'architect',
+                            provenance_kind: 'native_subagent',
+                            verdict: 'approve',
+                            session_id: sessionId,
+                            thread_id: 'thread-architect',
+                            artifact_path: '.omx/plans/architect.md',
+                            tracker_path: '.omx/state/subagent-tracking.json',
+                            completed_at: '2026-06-11T16:29:30.000Z',
+                        },
+                        ralplan_critic_review: {
+                            agent_role: 'critic',
+                            provenance_kind: 'native_subagent',
+                            verdict: 'approve',
+                            session_id: sessionId,
+                            thread_id: 'thread-critic',
+                            artifact_path: '.omx/plans/critic.md',
+                            tracker_path: '.omx/state/subagent-tracking.json',
+                            completed_at: '2026-06-11T16:30:00.000Z',
+                        },
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                sessionId,
+                requireNativeSubagents: true,
+            });
+            assert.equal(gate.complete, true);
+            assert.equal(gate.blockedReason, null);
+            assert.match(String(gate.source), new RegExp(`${boxedRoot.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`));
+        }
+        finally {
+            if (typeof previousOmxRoot === 'string')
+                process.env.OMX_ROOT = previousOmxRoot;
+            else
+                delete process.env.OMX_ROOT;
+            if (typeof previousOmxStateRoot === 'string')
+                process.env.OMX_STATE_ROOT = previousOmxStateRoot;
+            else
+                delete process.env.OMX_STATE_ROOT;
+            if (typeof previousOmxTeamStateRoot === 'string')
+                process.env.OMX_TEAM_STATE_ROOT = previousOmxTeamStateRoot;
+            else
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            await rm(cwd, { recursive: true, force: true });
+            await rm(boxedRoot, { recursive: true, force: true });
+        }
+    });
+    it('accepts session-scoped tracker-backed reviews without an explicit sessionId option', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-discovered-session-'));
+        const boxedRoot = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-discovered-root-'));
+        const previousOmxRoot = process.env.OMX_ROOT;
+        const previousOmxStateRoot = process.env.OMX_STATE_ROOT;
+        const previousOmxTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        const sessionId = 'sess-discovered-consensus';
+        try {
+            delete process.env.OMX_ROOT;
+            delete process.env.OMX_TEAM_STATE_ROOT;
+            process.env.OMX_STATE_ROOT = boxedRoot;
+            const baseStateDir = getBaseStateDir(cwd);
+            const sessionDir = join(baseStateDir, 'sessions', sessionId);
+            await mkdir(sessionDir, { recursive: true });
+            await writeFile(join(baseStateDir, 'session.json'), JSON.stringify({
+                session_id: sessionId,
+                native_session_id: 'thread-leader',
+                cwd,
+            }, null, 2));
+            await writeFile(subagentTrackingPath(cwd), JSON.stringify({
+                schemaVersion: 1,
+                sessions: {
+                    [sessionId]: {
+                        session_id: sessionId,
+                        leader_thread_id: 'thread-leader',
+                        updated_at: '2026-06-12T10:03:00.000Z',
+                        threads: {
+                            'thread-leader': {
+                                thread_id: 'thread-leader',
+                                kind: 'leader',
+                                first_seen_at: '2026-06-12T09:59:00.000Z',
+                                last_seen_at: '2026-06-12T09:59:00.000Z',
+                                turn_count: 1,
+                            },
+                            'thread-architect': {
+                                thread_id: 'thread-architect',
+                                kind: 'subagent',
+                                first_seen_at: '2026-06-12T10:02:00.000Z',
+                                last_seen_at: '2026-06-12T10:02:00.000Z',
+                                completed_at: '2026-06-12T10:02:00.000Z',
+                                turn_count: 1,
+                            },
+                            'thread-critic': {
+                                thread_id: 'thread-critic',
+                                kind: 'subagent',
+                                first_seen_at: '2026-06-12T10:03:00.000Z',
+                                last_seen_at: '2026-06-12T10:03:00.000Z',
+                                completed_at: '2026-06-12T10:03:00.000Z',
+                                turn_count: 1,
+                            },
+                        },
+                    },
+                },
+            }, null, 2));
+            await writeFile(join(sessionDir, 'ralplan-state.json'), JSON.stringify({
+                ralplan_consensus_gate: {
+                    complete: true,
+                    sequence: ['architect-review', 'critic-review'],
+                    ralplan_architect_review: {
+                        agent_role: 'architect',
+                        provenance_kind: 'native_subagent',
+                        verdict: 'approve',
+                        thread_id: 'thread-architect',
+                        completed_at: '2026-06-12T10:02:00.000Z',
+                    },
+                    ralplan_critic_review: {
+                        agent_role: 'critic',
+                        provenance_kind: 'native_subagent',
+                        verdict: 'approve',
+                        thread_id: 'thread-critic',
+                        completed_at: '2026-06-12T10:03:00.000Z',
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                requireNativeSubagents: true,
+            });
+            assert.equal(gate.complete, true);
+            assert.equal(gate.blockedReason, null);
+            assert.match(String(gate.source), new RegExp(`${sessionId}/ralplan-state\\.json$`));
+        }
+        finally {
+            if (typeof previousOmxRoot === 'string')
+                process.env.OMX_ROOT = previousOmxRoot;
+            else
+                delete process.env.OMX_ROOT;
+            if (typeof previousOmxStateRoot === 'string')
+                process.env.OMX_STATE_ROOT = previousOmxStateRoot;
+            else
+                delete process.env.OMX_STATE_ROOT;
+            if (typeof previousOmxTeamStateRoot === 'string')
+                process.env.OMX_TEAM_STATE_ROOT = previousOmxTeamStateRoot;
+            else
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            await rm(cwd, { recursive: true, force: true });
+            await rm(boxedRoot, { recursive: true, force: true });
+        }
+    });
+    it('rejects stale top-level handoff consensus during a return-to-ralplan cycle', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-stale-'));
+        try {
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    handoff_artifacts: {
+                        ralplan_consensus_gate: {
+                            complete: true,
+                            sequence: ['architect-review', 'critic-review'],
+                            ralplan_architect_review: {
+                                agent_role: 'architect',
+                                verdict: 'approve',
+                                completed_at: '2026-06-11T16:00:00.000Z',
+                            },
+                            ralplan_critic_review: {
+                                agent_role: 'critic',
+                                verdict: 'approve',
+                                completed_at: '2026-06-11T16:05:00.000Z',
+                            },
+                        },
+                    },
+                },
+            });
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('rejects stale local ralplan state consensus during a return-to-ralplan cycle', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-stale-local-state-'));
+        try {
+            const stateDir = join(cwd, '.omx', 'state');
+            await mkdir(stateDir, { recursive: true });
+            await writeFile(join(stateDir, 'ralplan-state.json'), JSON.stringify({
+                current_phase: 'complete',
+                ralplan_consensus_gate: {
+                    complete: true,
+                    sequence: ['architect-review', 'critic-review'],
+                    ralplan_architect_review: {
+                        agent_role: 'architect',
+                        verdict: 'approve',
+                        completed_at: '2026-06-11T16:00:00.000Z',
+                    },
+                    ralplan_critic_review: {
+                        agent_role: 'critic',
+                        verdict: 'approve',
+                        completed_at: '2026-06-11T16:05:00.000Z',
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_cycle: 1,
+                },
+            });
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('rejects local nested handoff consensus when only the local container review_cycle advances', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-local-container-only-'));
+        try {
+            const stateDir = join(cwd, '.omx', 'state');
+            await mkdir(stateDir, { recursive: true });
+            await writeFile(join(stateDir, 'ralplan-state.json'), JSON.stringify({
+                current_phase: 'complete',
+                review_cycle: 2,
+                handoff_artifacts: {
+                    ralplan_consensus_gate: {
+                        complete: true,
+                        sequence: ['architect-review', 'critic-review'],
+                        ralplan_architect_review: {
+                            agent_role: 'architect',
+                            verdict: 'approve',
+                            completed_at: '2026-06-12T10:00:00.000Z',
+                        },
+                        ralplan_critic_review: {
+                            agent_role: 'critic',
+                            verdict: 'approve',
+                            completed_at: '2026-06-12T10:05:00.000Z',
+                        },
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_cycle: 1,
+                },
+            });
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('accepts local nested handoff consensus when both reviews carry the advanced review_cycle', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-local-review-fresh-'));
+        try {
+            const stateDir = join(cwd, '.omx', 'state');
+            await mkdir(stateDir, { recursive: true });
+            await writeFile(join(stateDir, 'ralplan-state.json'), JSON.stringify({
+                current_phase: 'complete',
+                review_cycle: 2,
+                handoff_artifacts: {
+                    ralplan_consensus_gate: {
+                        complete: true,
+                        sequence: ['architect-review', 'critic-review'],
+                        ralplan_architect_review: {
+                            agent_role: 'architect',
+                            verdict: 'approve',
+                            review_cycle: 2,
+                            completed_at: '2026-06-12T10:00:00.000Z',
+                        },
+                        ralplan_critic_review: {
+                            agent_role: 'critic',
+                            verdict: 'approve',
+                            review_cycle: 2,
+                            completed_at: '2026-06-12T10:05:00.000Z',
+                        },
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_cycle: 1,
+                },
+            });
+            assert.equal(gate.complete, true);
+            assert.equal(gate.blockedReason, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('rejects local state.handoff_artifacts consensus when only the local container review_cycle advances', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-local-state-container-only-'));
+        try {
+            const stateDir = join(cwd, '.omx', 'state');
+            await mkdir(stateDir, { recursive: true });
+            await writeFile(join(stateDir, 'ralplan-state.json'), JSON.stringify({
+                current_phase: 'complete',
+                review_cycle: 2,
+                state: {
+                    handoff_artifacts: {
+                        ralplan_consensus_gate: {
+                            complete: true,
+                            sequence: ['architect-review', 'critic-review'],
+                            ralplan_architect_review: {
+                                agent_role: 'architect',
+                                verdict: 'approve',
+                                completed_at: '2026-06-12T10:00:00.000Z',
+                            },
+                            ralplan_critic_review: {
+                                agent_role: 'critic',
+                                verdict: 'approve',
+                                completed_at: '2026-06-12T10:05:00.000Z',
+                            },
+                        },
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_cycle: 1,
+                },
+            });
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('accepts local state.handoff_artifacts consensus when nested state and both reviews carry the advanced review_cycle', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-local-state-review-fresh-'));
+        try {
+            const stateDir = join(cwd, '.omx', 'state');
+            await mkdir(stateDir, { recursive: true });
+            await writeFile(join(stateDir, 'ralplan-state.json'), JSON.stringify({
+                current_phase: 'complete',
+                state: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_cycle: 1,
+                    handoff_artifacts: {
+                        review_cycle: 2,
+                        ralplan_consensus_gate: {
+                            complete: true,
+                            sequence: ['architect-review', 'critic-review'],
+                            ralplan_architect_review: {
+                                agent_role: 'architect',
+                                verdict: 'approve',
+                                review_cycle: 2,
+                                completed_at: '2026-06-12T10:00:00.000Z',
+                            },
+                            ralplan_critic_review: {
+                                agent_role: 'critic',
+                                verdict: 'approve',
+                                review_cycle: 2,
+                                completed_at: '2026-06-12T10:05:00.000Z',
+                            },
+                        },
+                    },
+                },
+            }, null, 2));
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_cycle: 1,
+                },
+            });
+            assert.equal(gate.complete, true);
+            assert.equal(gate.blockedReason, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('rejects stale review history consensus during a return-to-ralplan cycle', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-stale-history-'));
+        try {
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    review_history: [{
+                            ralplan_architect_review: {
+                                agent_role: 'architect',
+                                verdict: 'approve',
+                                completed_at: '2026-06-11T16:00:00.000Z',
+                            },
+                            ralplan_critic_review: {
+                                agent_role: 'critic',
+                                verdict: 'approve',
+                                completed_at: '2026-06-11T16:05:00.000Z',
+                            },
+                        }],
+                },
+            });
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('rejects stale review array consensus during a return-to-ralplan cycle', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-ralplan-consensus-stale-arrays-'));
+        try {
+            const gate = buildRalplanConsensusGateForCwd(cwd, {
+                artifacts: {
+                    current_phase: 'ralplan',
+                    return_to_ralplan_reason: 'Code review requested changes.',
+                    architectReviews: [{
+                            agent_role: 'architect',
+                            verdict: 'approve',
+                            completed_at: '2026-06-11T16:00:00.000Z',
+                        }],
+                    criticReviews: [{
+                            agent_role: 'critic',
+                            verdict: 'approve',
+                            completed_at: '2026-06-11T16:05:00.000Z',
+                        }],
+                },
+            });
+            assert.equal(gate.complete, false);
+            assert.equal(gate.blockedReason, 'missing_sequential_architect_then_critic_approval');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=consensus-gate.test.js.map