oh-my-codex 0.18.1 → 0.18.2

package/dist/scripts/__tests__/codex-native-hook.test.js

@@ -15,9 +15,11 @@ import { resetTriageConfigCache } from "../../hooks/triage-config.js";
 import { executeStateOperation } from "../../state/operations.js";
 import { OMX_TMUX_HUD_OWNER_ENV } from "../../hud/reconcile.js";
 import { readAllState } from "../../hud/state.js";
+import { renderHud } from "../../hud/render.js";
 import { getLegacyWikiDir, serializePage, writePage } from "../../wiki/storage.js";
 import { WIKI_SCHEMA_VERSION } from "../../wiki/types.js";
 import { createUltragoalPlan, readUltragoalPlan } from "../../ultragoal/artifacts.js";
+import { getBaseStateDir } from "../../state/paths.js";
 function nativeHookScriptPath() {
     return join(process.cwd(), "dist", "scripts", "codex-native-hook.js");
 }
@@ -222,7 +224,7 @@ describe("codex native hook config", () => {
         assert.equal(sessionStart.matcher, "startup|resume|clear");
         assert.equal(sessionStart.hooks?.[0]?.statusMessage, undefined);
         const preToolUse = config.hooks.PreToolUse[0];
-        assert.equal(preToolUse.matcher, "Bash");
+        assert.equal(preToolUse.matcher, undefined);
         assert.match(String(preToolUse.hooks?.[0]?.command || ""), /codex-native-hook\.js"?$/);
         assert.equal(preToolUse.hooks?.[0]?.statusMessage, undefined);
         const postToolUse = config.hooks.PostToolUse[0];
@@ -1593,6 +1595,9 @@ describe("codex native hook dispatch", () => {
             assert.match(output, /omx ultragoal checkpoint --goal-id G001-demo --status complete/);
             assert.match(output, /--status blocked/);
             assert.match(output, /Codex goal context/);
+            assert.match(output, /no such table: thread_goals/);
+            assert.match(output, /unavailable get_goal error JSON or path/);
+            assert.match(output, /safe-recovery blocker/);
             assert.doesNotMatch(output, /fresh (?:Codex )?(?:thread|session)s?/i);
             assert.match(output, /Hooks must not mutate Codex goal state/);
         }
@@ -1864,6 +1869,30 @@ describe("codex native hook dispatch", () => {
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("injects autopilot ralplan consensus gate guidance on prompt activation", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-autopilot-ralplan-gate-"));
+        try {
+            await mkdir(join(cwd, ".omx", "state"), { recursive: true });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: "sess-autopilot-ralplan-gate",
+                thread_id: "thread-autopilot-ralplan-gate",
+                turn_id: "turn-autopilot-ralplan-gate",
+                prompt: "$autopilot implement issue #2430",
+            }, { cwd });
+            assert.equal(result.omxEventName, "keyword-detector");
+            assert.equal(result.skillState?.skill, "autopilot");
+            const message = String(result.outputJson?.hookSpecificOutput?.additionalContext || "");
+            assert.match(message, /Autopilot protocol:/);
+            assert.match(message, /deep-interview -> ralplan -> ultragoal -> code-review -> ultraqa/);
+            assert.match(message, /Planner output has been reviewed sequentially by Architect and then Critic/);
+            assert.match(message, /do not hand off to Ultragoal or implementation until .*ralplan_architect_review.*ralplan_critic_review/);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     it("records ultragoal prompt skill activation with goal-tool handoff guidance", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-ultragoal-"));
         try {
@@ -1878,7 +1907,8 @@ describe("codex native hook dispatch", () => {
             }, { cwd });
             assert.equal(result.omxEventName, "keyword-detector");
             assert.equal(result.skillState?.skill, "ultragoal");
-            assert.equal(result.skillState?.initialized_mode, undefined);
+            assert.equal(result.skillState?.initialized_mode, "ultragoal");
+            assert.equal(result.skillState?.initialized_state_path, ".omx/state/sessions/sess-ultragoal-1/ultragoal-state.json");
             const message = String(result.outputJson?.hookSpecificOutput?.additionalContext || "");
             assert.match(message, /"\$ultragoal" -> ultragoal/);
             assert.match(message, /Ultragoal protocol:/);
@@ -1887,7 +1917,65 @@ describe("codex native hook dispatch", () => {
             assert.match(message, /update_goal/);
             assert.match(message, /does not call `\/goal clear`/);
             assert.match(message, /multiple sequential ultragoal runs/);
-            assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", "sess-ultragoal-1", "ultragoal-state.json")), false);
+            assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", "sess-ultragoal-1", "ultragoal-state.json")), true);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("deactivates active deep-interview state on explicit ultragoal handoff", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-ultragoal-deep-interview-handoff-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            const sessionDir = join(stateDir, "sessions", "sess-ultragoal-handoff");
+            await mkdir(sessionDir, { recursive: true });
+            await writeJson(join(sessionDir, "skill-active-state.json"), {
+                version: 1,
+                active: true,
+                skill: "deep-interview",
+                phase: "planning",
+                session_id: "sess-ultragoal-handoff",
+                active_skills: [{ skill: "deep-interview", phase: "planning", active: true, session_id: "sess-ultragoal-handoff" }],
+            });
+            await writeJson(join(sessionDir, "deep-interview-state.json"), {
+                active: true,
+                mode: "deep-interview",
+                current_phase: "intent-first",
+                session_id: "sess-ultragoal-handoff",
+                question_enforcement: {
+                    obligation_id: "obligation-ultragoal-handoff",
+                    source: "omx-question",
+                    status: "pending",
+                    requested_at: "2026-05-21T03:00:00.000Z",
+                },
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: "sess-ultragoal-handoff",
+                thread_id: "thread-ultragoal-handoff",
+                turn_id: "turn-ultragoal-handoff",
+                prompt: "$ultragoal turn the clarified spec into goals",
+            }, { cwd });
+            assert.equal(result.omxEventName, "keyword-detector");
+            assert.equal(result.skillState?.skill, "ultragoal");
+            assert.match(JSON.stringify(result.outputJson), /mode transiting: deep-interview -> ultragoal/);
+            const completed = JSON.parse(await readFile(join(sessionDir, "deep-interview-state.json"), "utf-8"));
+            assert.equal(completed.active, false);
+            assert.equal(completed.current_phase, "completed");
+            assert.equal(completed.question_enforcement?.status, "cleared");
+            assert.equal(completed.question_enforcement?.clear_reason, "handoff");
+            assert.equal(existsSync(join(sessionDir, "ultragoal-state.json")), true);
+            const edit = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-ultragoal-handoff",
+                thread_id: "thread-ultragoal-handoff",
+                tool_name: "Edit",
+                tool_use_id: "tool-ultragoal-post-handoff-edit",
+                tool_input: { file_path: "src/implementation.ts", old_string: "a", new_string: "b" },
+            }, { cwd });
+            assert.equal(edit.outputJson, null);
         }
         finally {
             await rm(cwd, { recursive: true, force: true });
@@ -3248,6 +3336,153 @@ exit 0
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("blocks implementation file edits while deep-interview remains active after a clarified answer", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-pretool-deep-interview-edit-block-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            const sessionDir = join(stateDir, "sessions", "sess-di-edit-block");
+            await mkdir(sessionDir, { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-di-edit-block", cwd });
+            await writeJson(join(sessionDir, "skill-active-state.json"), {
+                version: 1,
+                active: true,
+                skill: "deep-interview",
+                phase: "planning",
+                session_id: "sess-di-edit-block",
+                thread_id: "thread-di-edit-block",
+                active_skills: [{ skill: "deep-interview", phase: "planning", active: true, session_id: "sess-di-edit-block", thread_id: "thread-di-edit-block" }],
+            });
+            await writeJson(join(sessionDir, "deep-interview-state.json"), {
+                active: true,
+                mode: "deep-interview",
+                current_phase: "intent-first",
+                session_id: "sess-di-edit-block",
+                thread_id: "thread-di-edit-block",
+                rounds: [{ answer: "Implement by editing src/hooks/keyword-detector.ts and add tests." }],
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-di-edit-block",
+                thread_id: "thread-di-edit-block",
+                tool_name: "Edit",
+                tool_use_id: "tool-di-edit-block",
+                tool_input: { file_path: "src/hooks/keyword-detector.ts", old_string: "a", new_string: "b" },
+            }, { cwd });
+            assert.equal(result.omxEventName, "pre-tool-use");
+            assert.equal(result.outputJson?.decision, "block");
+            assert.match(String(result.outputJson?.reason ?? ""), /Deep-interview is active/);
+            assert.match(JSON.stringify(result.outputJson), /requirements\/spec mode/);
+            assert.match(JSON.stringify(result.outputJson), /\$ralplan/);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("allows deep-interview artifact and state writes while blocking implementation Bash writes", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-pretool-deep-interview-artifact-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            const sessionDir = join(stateDir, "sessions", "sess-di-artifact");
+            await mkdir(sessionDir, { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-di-artifact", cwd });
+            await writeJson(join(sessionDir, "skill-active-state.json"), {
+                version: 1,
+                active: true,
+                skill: "deep-interview",
+                phase: "planning",
+                session_id: "sess-di-artifact",
+                active_skills: [{ skill: "deep-interview", phase: "planning", active: true, session_id: "sess-di-artifact" }],
+            });
+            await writeJson(join(sessionDir, "deep-interview-state.json"), {
+                active: true,
+                mode: "deep-interview",
+                current_phase: "intent-first",
+                session_id: "sess-di-artifact",
+            });
+            const allowedWrite = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-di-artifact",
+                tool_name: "Write",
+                tool_use_id: "tool-di-spec-write",
+                tool_input: { file_path: ".omx/specs/deep-interview-demo.md", content: "# Spec" },
+            }, { cwd });
+            assert.equal(allowedWrite.outputJson, null);
+            const allowedBash = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-di-artifact",
+                tool_name: "Bash",
+                tool_use_id: "tool-di-context-bash",
+                tool_input: { command: "cat > .omx/context/demo.md <<'EOF'\n# Context\nEOF" },
+            }, { cwd });
+            assert.equal(allowedBash.outputJson, null);
+            const allowedAppendBash = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-di-artifact",
+                tool_name: "Bash",
+                tool_use_id: "tool-di-context-append-bash",
+                tool_input: { command: "echo more context >> .omx/context/demo.md" },
+            }, { cwd });
+            assert.equal(allowedAppendBash.outputJson, null);
+            const blockedBash = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-di-artifact",
+                tool_name: "Bash",
+                tool_use_id: "tool-di-src-bash",
+                tool_input: { command: "cat > src/implementation.ts <<'EOF'\nexport const x = 1;\nEOF" },
+            }, { cwd });
+            assert.equal(blockedBash.outputJson?.decision, "block");
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("allows implementation tools after an explicit deep-interview handoff deactivates the mode", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-pretool-deep-interview-handoff-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            const sessionDir = join(stateDir, "sessions", "sess-di-handoff");
+            await mkdir(sessionDir, { recursive: true });
+            await writeJson(join(sessionDir, "skill-active-state.json"), {
+                version: 1,
+                active: true,
+                skill: "deep-interview",
+                phase: "planning",
+                session_id: "sess-di-handoff",
+                active_skills: [{ skill: "deep-interview", phase: "planning", active: true, session_id: "sess-di-handoff" }],
+            });
+            await writeJson(join(sessionDir, "deep-interview-state.json"), {
+                active: true,
+                mode: "deep-interview",
+                current_phase: "intent-first",
+                session_id: "sess-di-handoff",
+            });
+            await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: "sess-di-handoff",
+                prompt: "$ralph implement the clarified spec in src/implementation.ts",
+            }, { cwd });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "PreToolUse",
+                cwd,
+                session_id: "sess-di-handoff",
+                tool_name: "Edit",
+                tool_use_id: "tool-di-post-handoff-edit",
+                tool_input: { file_path: "src/implementation.ts", old_string: "a", new_string: "b" },
+            }, { cwd });
+            assert.equal(result.outputJson, null);
+            const completed = JSON.parse(await readFile(join(sessionDir, "deep-interview-state.json"), "utf-8"));
+            assert.equal(completed.active, false);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     it("returns a destructive-command caution on PreToolUse for rm -rf dist", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-pretool-danger-"));
         try {
@@ -5423,6 +5658,7 @@ exit 0
                 active: true,
                 current_phase: "team-exec",
                 team_name: "review-team",
+                session_id: "sess-stop-team",
             });
             await writeJson(join(stateDir, "team", "review-team", "phase.json"), {
                 current_phase: "team-verify",
@@ -6216,6 +6452,63 @@ exit 0
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("does not block Stop from canonical team state owned by another thread", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-team-canonical-other-thread-"));
+        try {
+            await initTeamState("canonical-other-thread-team", "canonical other-thread stop fallback", "executor", 1, cwd, undefined, { ...process.env, OMX_SESSION_ID: "sess-stop-team-canonical-thread" });
+            const manifestPath = join(cwd, ".omx", "state", "team", "canonical-other-thread-team", "manifest.v2.json");
+            const manifest = JSON.parse(await readFile(manifestPath, "utf-8"));
+            await writeJson(manifestPath, {
+                ...manifest,
+                leader: {
+                    ...manifest.leader,
+                    thread_id: "thread-other",
+                },
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-stop-team-canonical-thread",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("blocks Stop from canonical team state owned by the current thread", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-team-canonical-current-thread-"));
+        try {
+            await initTeamState("canonical-current-thread-team", "canonical current-thread stop fallback", "executor", 1, cwd, undefined, { ...process.env, OMX_SESSION_ID: "sess-stop-team-canonical-current-thread" });
+            const manifestPath = join(cwd, ".omx", "state", "team", "canonical-current-thread-team", "manifest.v2.json");
+            const manifest = JSON.parse(await readFile(manifestPath, "utf-8"));
+            await writeJson(manifestPath, {
+                ...manifest,
+                leader: {
+                    ...manifest.leader,
+                    thread_id: "thread-current",
+                },
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-stop-team-canonical-current-thread",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.deepEqual(result.outputJson, {
+                decision: "block",
+                reason: `OMX team pipeline is still active (canonical-current-thread-team) at phase team-exec; continue coordinating until the team reaches a terminal phase.${TEAM_STOP_COMMIT_GUIDANCE}`,
+                stopReason: "team_team-exec",
+                systemMessage: "OMX team pipeline is still active at phase team-exec.",
+            });
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     it("emits one concise final decision summary and auto-finalize guidance when release-readiness already has a stable final recommendation and no active worker tasks", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-release-readiness-finalize-"));
         try {
@@ -6389,8 +6682,8 @@ exit 0
         const sharedRoot = join(cwd, "shared-root");
         const priorTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
         try {
-            process.env.OMX_TEAM_STATE_ROOT = "shared-root";
-            await initTeamState("canonical-root-team", "canonical stop root fallback", "executor", 1, cwd, undefined, { ...process.env, OMX_SESSION_ID: "sess-stop-team-root", OMX_TEAM_STATE_ROOT: "shared-root" });
+            process.env.OMX_TEAM_STATE_ROOT = sharedRoot;
+            await initTeamState("canonical-root-team", "canonical stop root fallback", "executor", 1, cwd, undefined, { ...process.env, OMX_SESSION_ID: "sess-stop-team-root", OMX_TEAM_STATE_ROOT: sharedRoot });
             const result = await dispatchCodexNativeHook({
                 hook_event_name: "Stop",
                 cwd,
@@ -6447,13 +6740,14 @@ exit 0
     });
     it("returns Stop continuation output from canonical team state rooted via OMX_TEAM_STATE_ROOT", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-team-env-root-"));
+        const teamStateRoot = join(cwd, "shared-team-state");
         const previousTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
         try {
-            process.env.OMX_TEAM_STATE_ROOT = "shared-team-state";
+            process.env.OMX_TEAM_STATE_ROOT = teamStateRoot;
             await initTeamState("env-root-team", "env root stop fallback", "executor", 1, cwd, undefined, {
                 ...process.env,
                 OMX_SESSION_ID: "sess-stop-team-env-root",
-                OMX_TEAM_STATE_ROOT: "shared-team-state",
+                OMX_TEAM_STATE_ROOT: teamStateRoot,
             });
             const result = await dispatchCodexNativeHook({
                 hook_event_name: "Stop",
@@ -9191,6 +9485,8 @@ exit 0
                 active: true,
                 current_phase: "team-exec",
                 team_name: "review-team",
+                session_id: "sess-stop-team-refire",
+                thread_id: "thread-stop-team-refire",
             });
             await writeJson(join(stateDir, "team", "review-team", "phase.json"), {
                 current_phase: "team-verify",
@@ -9379,6 +9675,214 @@ exit 0
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("does not block Stop from root team state without team_name when no session is known", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-root-team-no-session-no-name-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(stateDir, { recursive: true });
+            await writeJson(join(stateDir, "team-state.json"), {
+                active: true,
+                mode: "team",
+                current_phase: "starting",
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("does not block Stop from root team state without team_name for a foreign session", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-root-team-foreign-no-name-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(join(stateDir, "sessions", "sess-current"), { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-current" });
+            await writeJson(join(stateDir, "team-state.json"), {
+                active: true,
+                mode: "team",
+                current_phase: "starting",
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("does not block Stop from another thread's stale root team state when no scoped team state exists", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-stale-root-team-thread-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(join(stateDir, "sessions", "sess-current"), { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-current" });
+            await writeJson(join(stateDir, "team-state.json"), {
+                active: true,
+                current_phase: "starting",
+                team_name: "stale-root-thread-team",
+                session_id: "sess-current",
+                thread_id: "thread-other",
+            });
+            await writeJson(join(stateDir, "team", "stale-root-thread-team", "phase.json"), {
+                current_phase: "team-exec",
+                max_fix_attempts: 3,
+                current_fix_attempt: 0,
+                transitions: [],
+                updated_at: new Date().toISOString(),
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("does not block Stop from root team state with matching session but missing thread ownership", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-root-team-missing-thread-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(join(stateDir, "sessions", "sess-current"), { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-current" });
+            await writeJson(join(stateDir, "team-state.json"), {
+                active: true,
+                current_phase: "starting",
+                team_name: "root-missing-thread-team",
+                session_id: "sess-current",
+            });
+            await writeJson(join(stateDir, "team", "root-missing-thread-team", "phase.json"), {
+                current_phase: "team-exec",
+                max_fix_attempts: 3,
+                current_fix_attempt: 0,
+                transitions: [],
+                updated_at: new Date().toISOString(),
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("does not block Stop from root team state when canonical phase is missing", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-root-team-missing-phase-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(join(stateDir, "sessions", "sess-current"), { recursive: true });
+            await mkdir(join(stateDir, "team", "root-missing-phase-team"), { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-current" });
+            await writeJson(join(stateDir, "team-state.json"), {
+                active: true,
+                current_phase: "starting",
+                team_name: "root-missing-phase-team",
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("does not block Stop from session-scoped team state owned by another thread", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-scoped-team-other-thread-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(join(stateDir, "sessions", "sess-current"), { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-current" });
+            await writeJson(join(stateDir, "sessions", "sess-current", "team-state.json"), {
+                active: true,
+                current_phase: "starting",
+                team_name: "scoped-other-thread-team",
+                session_id: "sess-current",
+                thread_id: "thread-other",
+            });
+            await writeJson(join(stateDir, "team", "scoped-other-thread-team", "phase.json"), {
+                current_phase: "team-exec",
+                max_fix_attempts: 3,
+                current_fix_attempt: 0,
+                transitions: [],
+                updated_at: new Date().toISOString(),
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("blocks Stop from session-scoped team state owned by the current session and thread", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-scoped-team-current-thread-"));
+        try {
+            const stateDir = join(cwd, ".omx", "state");
+            await mkdir(join(stateDir, "sessions", "sess-current"), { recursive: true });
+            await writeJson(join(stateDir, "session.json"), { session_id: "sess-current" });
+            await writeJson(join(stateDir, "sessions", "sess-current", "team-state.json"), {
+                active: true,
+                current_phase: "starting",
+                team_name: "scoped-current-team",
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            });
+            await writeJson(join(stateDir, "team", "scoped-current-team", "phase.json"), {
+                current_phase: "team-exec",
+                max_fix_attempts: 3,
+                current_fix_attempt: 0,
+                transitions: [],
+                updated_at: new Date().toISOString(),
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-current",
+                thread_id: "thread-current",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.deepEqual(result.outputJson, {
+                decision: "block",
+                reason: `OMX team pipeline is still active (scoped-current-team) at phase team-exec; continue coordinating until the team reaches a terminal phase.${TEAM_STOP_COMMIT_GUIDANCE}`,
+                stopReason: "team_team-exec",
+                systemMessage: "OMX team pipeline is still active at phase team-exec.",
+            });
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     it("does not block Stop from another session's stale root team state when no scoped team state exists", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-stale-root-team-"));
         try {
@@ -9561,6 +10065,79 @@ describe("codex native hook triage integration", () => {
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("does not activate workflow state for native subagent prompts even when canonical id is the child session", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-subagent-keyword-"));
+        const boxedRoot = await mkdtemp(join(tmpdir(), "omx-native-subagent-keyword-boxed-"));
+        const originalOmxRoot = process.env.OMX_ROOT;
+        const originalOmxStateRoot = process.env.OMX_STATE_ROOT;
+        const originalTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        try {
+            process.env.OMX_ROOT = boxedRoot;
+            delete process.env.OMX_STATE_ROOT;
+            delete process.env.OMX_TEAM_STATE_ROOT;
+            const boxedStateDir = getBaseStateDir(cwd);
+            await mkdir(boxedStateDir, { recursive: true });
+            await writeJson(join(boxedStateDir, "subagent-tracking.json"), {
+                schemaVersion: 1,
+                sessions: {
+                    "omx-parent-session": {
+                        session_id: "omx-parent-session",
+                        leader_thread_id: "parent-native-thread",
+                        updated_at: "2026-05-21T19:04:40.000Z",
+                        threads: {
+                            "parent-native-thread": {
+                                thread_id: "parent-native-thread",
+                                kind: "leader",
+                                first_seen_at: "2026-05-21T19:04:40.000Z",
+                                last_seen_at: "2026-05-21T19:04:40.000Z",
+                                turn_count: 1,
+                            },
+                            "child-native-session": {
+                                thread_id: "child-native-session",
+                                kind: "subagent",
+                                first_seen_at: "2026-05-21T19:04:41.000Z",
+                                last_seen_at: "2026-05-21T19:04:41.000Z",
+                                turn_count: 1,
+                                mode: "review",
+                            },
+                        },
+                    },
+                },
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: "child-native-session",
+                thread_id: "child-native-session",
+                turn_id: "turn-subagent-review",
+                prompt: [
+                    "Read-only review only. Do not edit files. Do not inspect/mutate OMX state/hooks.",
+                    "Context: The user asked for $autopilot, and this subagent must only review the patch.",
+                ].join("\n\n"),
+            }, { cwd });
+            const additionalContext = String(result.outputJson?.hookSpecificOutput?.additionalContext ?? "");
+            assert.equal(additionalContext, "");
+            assert.equal(existsSync(join(boxedStateDir, "sessions", "child-native-session", "skill-active-state.json")), false);
+            assert.equal(existsSync(join(boxedStateDir, "sessions", "child-native-session", "autopilot-state.json")), false);
+            assert.equal(existsSync(join(cwd, ".omx", "state", "subagent-tracking.json")), false, "subagent tracking must not leak into the source worktree when OMX_ROOT is boxed");
+        }
+        finally {
+            if (originalOmxRoot === undefined)
+                delete process.env.OMX_ROOT;
+            else
+                process.env.OMX_ROOT = originalOmxRoot;
+            if (originalOmxStateRoot === undefined)
+                delete process.env.OMX_STATE_ROOT;
+            else
+                process.env.OMX_STATE_ROOT = originalOmxStateRoot;
+            if (originalTeamStateRoot === undefined)
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            else
+                process.env.OMX_TEAM_STATE_ROOT = originalTeamStateRoot;
+            await rm(cwd, { recursive: true, force: true });
+            await rm(boxedRoot, { recursive: true, force: true });
+        }
+    });
     it("does not inject triage advisory for autopilot keyword prompts", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-triage-keyword-autopilot-"));
         try {
@@ -9585,6 +10162,48 @@ describe("codex native hook triage integration", () => {
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("makes autopilot keyword activation observable in state, HUD context, and prompt guidance", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-autopilot-observable-"));
+        try {
+            await mkdir(join(cwd, ".omx", "state"), { recursive: true });
+            await writeSessionStart(cwd, "sess-autopilot-observable");
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: "sess-autopilot-observable",
+                thread_id: "thread-autopilot-observable",
+                turn_id: "turn-autopilot-observable",
+                prompt: "$autopilot implement issue #2430",
+            }, { cwd });
+            assert.equal(result.skillState?.skill, "autopilot");
+            assert.equal(result.skillState?.phase, "deep-interview");
+            assert.equal(result.skillState?.initialized_state_path, ".omx/state/sessions/sess-autopilot-observable/autopilot-state.json");
+            const additionalContext = String(result.outputJson?.hookSpecificOutput?.additionalContext ?? "");
+            assert.match(additionalContext, /detected workflow keyword "\$autopilot" -> autopilot/);
+            assert.match(additionalContext, /\$deep-interview -> \$ralplan -> \$ultragoal \(\+ \$team if needed\) -> \$code-review -> \$ultraqa/);
+            assert.match(additionalContext, /deep_interview_gate\.skip_reason/);
+            assert.match(additionalContext, /Do not silently fall back to ordinary \$plan\/ralplan-only handling/);
+            assert.match(additionalContext, /Codex goal-mode handoff guidance/);
+            assert.doesNotMatch(additionalContext, /multi-step goal with no workflow keyword/);
+            const statePath = join(cwd, ".omx", "state", "sessions", "sess-autopilot-observable", "autopilot-state.json");
+            const modeState = JSON.parse(await readFile(statePath, "utf-8"));
+            assert.equal(modeState.active, true);
+            assert.equal(modeState.current_phase, "deep-interview");
+            assert.deepEqual(modeState.state?.phase_cycle, ["deep-interview", "ralplan", "ultragoal", "code-review", "ultraqa"]);
+            assert.deepEqual(modeState.state?.deep_interview_gate, {
+                status: "required",
+                skip_reason: null,
+                rationale: "Autopilot starts at the deep-interview gate by default; clear bounded tasks may skip only with an explicit persisted skip reason.",
+            });
+            const hudState = await readAllState(cwd);
+            assert.equal(hudState.autopilot?.active, true);
+            assert.equal(hudState.autopilot?.current_phase, "deep-interview");
+            assert.match(renderHud(hudState, "focused"), /autopilot:deep-interview/);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     // ── Group 2: HEAVY injection ─────────────────────────────────────────────
     it("injects HEAVY advisory and writes prompt-routing-state for a multi-step goal prompt", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-triage-heavy-"));