oh-my-codex 0.16.3 → 0.16.4

package/dist/ralph/__tests__/completion-audit.test.d.ts

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

package/dist/ralph/__tests__/completion-audit.test.d.ts.map

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

package/dist/ralph/__tests__/completion-audit.test.js

@@ -0,0 +1,121 @@
+import { mkdtemp, rm, symlink, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, relative } from 'node:path';
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { evaluateRalphCompletionAuditEvidence } from '../completion-audit.js';
+test('rejects absolute completion-audit paths', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-absolute-'));
+    try {
+        const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: '/etc/hosts' }, cwd);
+        assert.equal(result.complete, false);
+        assert.equal(result.reason, 'missing_completion_audit');
+        assert.equal(result.source, 'missing');
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+});
+test('rejects non-JSON completion-audit artifacts', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-non-json-'));
+    try {
+        await writeFile(join(cwd, 'audit.md'), 'passed with checklist and tests', 'utf-8');
+        const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: 'audit.md' }, cwd);
+        assert.equal(result.complete, false);
+        assert.equal(result.reason, 'missing_completion_audit');
+        assert.equal(result.source, 'missing');
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+});
+test('rejects completion-audit artifacts outside the workspace', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-traversal-'));
+    const outside = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-outside-'));
+    try {
+        await writeFile(join(outside, 'audit.json'), JSON.stringify({
+            passed: true,
+            prompt_to_artifact_checklist: ['mapped'],
+            verification_evidence: ['tested'],
+        }), 'utf-8');
+        const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: relative(cwd, join(outside, 'audit.json')) }, cwd);
+        assert.equal(result.complete, false);
+        assert.equal(result.reason, 'missing_completion_audit');
+        assert.equal(result.source, 'missing');
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+        await rm(outside, { recursive: true, force: true });
+    }
+});
+test('rejects completion-audit symlinks that resolve outside the workspace', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-symlink-cwd-'));
+    const outside = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-symlink-outside-'));
+    try {
+        await writeFile(join(outside, 'audit.json'), JSON.stringify({
+            passed: true,
+            prompt_to_artifact_checklist: ['mapped'],
+            verification_evidence: ['tested'],
+        }), 'utf-8');
+        await symlink(join(outside, 'audit.json'), join(cwd, 'audit.json'));
+        const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: 'audit.json' }, cwd);
+        assert.equal(result.complete, false);
+        assert.equal(result.reason, 'missing_completion_audit');
+        assert.equal(result.source, 'missing');
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+        await rm(outside, { recursive: true, force: true });
+    }
+});
+test('rejects malformed and empty completion-audit JSON artifacts', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-invalid-json-'));
+    try {
+        await writeFile(join(cwd, 'empty.json'), '', 'utf-8');
+        await writeFile(join(cwd, 'invalid.json'), '{not json', 'utf-8');
+        for (const path of ['empty.json', 'invalid.json']) {
+            const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: path }, cwd);
+            assert.equal(result.complete, false);
+            assert.equal(result.reason, 'missing_completion_audit');
+            assert.equal(result.source, 'missing');
+        }
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+});
+test('requires explicit passed=true in completion-audit evidence', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-explicit-pass-'));
+    try {
+        await writeFile(join(cwd, 'audit.json'), JSON.stringify({
+            status: 'passed',
+            prompt_to_artifact_checklist: ['mapped'],
+            verification_evidence: ['tested'],
+        }), 'utf-8');
+        const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: 'audit.json' }, cwd);
+        assert.equal(result.complete, false);
+        assert.equal(result.reason, 'completion_audit_not_passing');
+        assert.equal(result.source, 'artifact');
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+});
+test('accepts structured relative JSON completion-audit artifacts with evidence', async () => {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-ralph-audit-valid-json-'));
+    try {
+        await writeFile(join(cwd, 'audit.json'), JSON.stringify({
+            passed: true,
+            prompt_to_artifact_checklist: ['mapped prompt to artifact'],
+            verification_evidence: ['node --test dist/ralph/__tests__/completion-audit.test.js'],
+        }), 'utf-8');
+        const result = evaluateRalphCompletionAuditEvidence({ completion_audit_path: 'audit.json' }, cwd);
+        assert.equal(result.complete, true);
+        assert.equal(result.reason, 'completion_audit_passed');
+        assert.equal(result.source, 'artifact');
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=completion-audit.test.js.map

package/dist/ralph/__tests__/completion-audit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-audit.test.js","sourceRoot":"","sources":["../../../src/ralph/__tests__/completion-audit.test.ts"],"names":[],"mappings":"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"}

package/dist/ralph/completion-audit.d.ts

@@ -0,0 +1,8 @@
+export interface RalphCompletionAuditResult {
+    complete: boolean;
+    reason: string;
+    source: 'state' | 'artifact' | 'missing';
+}
+export declare function evaluateRalphCompletionAuditEvidence(state: Record<string, unknown>, cwd: string): RalphCompletionAuditResult;
+export declare function isRalphCompletePhase(value: unknown): boolean;
+//# sourceMappingURL=completion-audit.d.ts.map

package/dist/ralph/completion-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-audit.d.ts","sourceRoot":"","sources":["../../src/ralph/completion-audit.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;CAC1C;AAgED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,0BAA0B,CA+B5B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG5D"}

package/dist/ralph/completion-audit.js

@@ -0,0 +1,99 @@
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { extname, isAbsolute, relative, resolve } from 'node:path';
+const JSON_EXTENSION = '.json';
+function isRecord(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+function safeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function hasPassingVerdict(value) {
+    return value.passed === true;
+}
+function isInsideDirectory(parent, child) {
+    const childRelativePath = relative(parent, child);
+    return childRelativePath === '' || (!childRelativePath.startsWith('..') && !isAbsolute(childRelativePath));
+}
+function hasSubstantiveValue(value) {
+    if (typeof value === 'string')
+        return value.trim().length > 0;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (isRecord(value))
+        return Object.keys(value).length > 0;
+    return value === true;
+}
+function readAuditArtifact(cwd, rawPath) {
+    const auditPath = safeString(rawPath);
+    if (!auditPath)
+        return null;
+    if (isAbsolute(auditPath))
+        return null;
+    const root = resolve(cwd);
+    const resolvedPath = resolve(root, auditPath);
+    if (!isInsideDirectory(root, resolvedPath))
+        return null;
+    if (!existsSync(resolvedPath))
+        return null;
+    if (extname(resolvedPath) !== JSON_EXTENSION)
+        return null;
+    const rootRealPath = realpathSync(root);
+    const artifactRealPath = realpathSync(resolvedPath);
+    if (!isInsideDirectory(rootRealPath, artifactRealPath))
+        return null;
+    try {
+        const content = readFileSync(resolvedPath, 'utf-8').trim();
+        if (!content)
+            return null;
+        const parsed = JSON.parse(content);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function selectAuditCandidate(state, cwd) {
+    for (const key of ['completion_audit', 'completionAudit', 'completion_audit_evidence', 'completionAuditEvidence']) {
+        if (isRecord(state[key]))
+            return { audit: state[key], source: 'state' };
+    }
+    for (const key of ['completion_audit_path', 'completionAuditPath', 'completion_audit_evidence_path', 'completionAuditEvidencePath']) {
+        const artifact = readAuditArtifact(cwd, state[key]);
+        if (artifact)
+            return { audit: artifact, source: 'artifact' };
+    }
+    return { audit: null, source: 'missing' };
+}
+export function evaluateRalphCompletionAuditEvidence(state, cwd) {
+    const { audit, source } = selectAuditCandidate(state, cwd);
+    if (!audit) {
+        return { complete: false, reason: 'missing_completion_audit', source };
+    }
+    if (!hasPassingVerdict(audit)) {
+        return { complete: false, reason: 'completion_audit_not_passing', source };
+    }
+    const checklist = audit.prompt_to_artifact_checklist
+        ?? audit.promptToArtifactChecklist
+        ?? audit.checklist
+        ?? audit.requirements_checklist
+        ?? audit.requirementsChecklist;
+    if (!hasSubstantiveValue(checklist)) {
+        return { complete: false, reason: 'missing_completion_checklist', source };
+    }
+    const evidence = audit.verification_evidence
+        ?? audit.verificationEvidence
+        ?? audit.evidence
+        ?? audit.validation_evidence
+        ?? audit.validationEvidence
+        ?? audit.commands
+        ?? audit.tests;
+    if (!hasSubstantiveValue(evidence)) {
+        return { complete: false, reason: 'missing_verification_evidence', source };
+    }
+    return { complete: true, reason: 'completion_audit_passed', source };
+}
+export function isRalphCompletePhase(value) {
+    const phase = safeString(value).toLowerCase();
+    return phase === 'complete' || phase === 'completed';
+}
+//# sourceMappingURL=completion-audit.js.map

package/dist/ralph/completion-audit.js.map

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

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

@@ -14,6 +14,7 @@ import { writeSessionStart } from "../../hooks/session.js";
 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 { writePage } from "../../wiki/storage.js";
 import { WIKI_SCHEMA_VERSION } from "../../wiki/types.js";
 function nativeHookScriptPath() {
@@ -183,7 +184,7 @@ describe("codex native hook config", () => {
             "Stop",
         ]);
         const sessionStart = config.hooks.SessionStart[0];
-        assert.equal(sessionStart.matcher, "startup|resume");
+        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");
@@ -962,7 +963,7 @@ describe("codex native hook dispatch", () => {
             assert.equal(result.omxEventName, "keyword-detector");
             assert.equal(result.skillState?.skill, "ralplan");
             assert.ok(result.outputJson, "UserPromptSubmit should emit developer context");
-            assert.match(JSON.stringify(result.outputJson), /skill: ralplan activated and initial state initialized at \.omx\/state\/sessions\/sess-1\/ralplan-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(JSON.stringify(result.outputJson), /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
             assert.equal(existsSync(join(cwd, ".omx", "state", "skill-active-state.json")), false, "session-scoped keyword activation should not write root skill-active-state.json");
             const statePath = join(cwd, ".omx", "state", "sessions", "sess-1", "skill-active-state.json");
             assert.equal(existsSync(statePath), true);
@@ -976,6 +977,114 @@ describe("codex native hook dispatch", () => {
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("records boxed keyword activation mode detail and skill state under OMX_ROOT", async () => {
+        const root = await mkdtemp(join(tmpdir(), "omx-native-hook-boxed-"));
+        const cwd = join(root, "source");
+        const omxRoot = join(root, "box");
+        const sessionId = "sess-boxed-ralplan";
+        const previousOmxRoot = process.env.OMX_ROOT;
+        const previousOmxStateRoot = process.env.OMX_STATE_ROOT;
+        const previousTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        const previousOmxSessionId = process.env.OMX_SESSION_ID;
+        try {
+            await mkdir(cwd, { recursive: true });
+            process.env.OMX_ROOT = omxRoot;
+            delete process.env.OMX_STATE_ROOT;
+            delete process.env.OMX_TEAM_STATE_ROOT;
+            process.env.OMX_SESSION_ID = sessionId;
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: sessionId,
+                thread_id: "thread-boxed",
+                turn_id: "turn-boxed",
+                prompt: "$ralplan implement issue #1307",
+            }, { cwd });
+            assert.equal(result.omxEventName, "keyword-detector");
+            assert.equal(result.skillState?.skill, "ralplan");
+            const boxedSessionDir = join(omxRoot, ".omx", "state", "sessions", sessionId);
+            assert.equal(existsSync(join(boxedSessionDir, "skill-active-state.json")), true);
+            assert.equal(existsSync(join(boxedSessionDir, "ralplan-state.json")), true);
+            assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", sessionId, "skill-active-state.json")), false);
+            assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", sessionId, "ralplan-state.json")), false);
+            const hudState = await readAllState(cwd);
+            assert.equal(hudState.ralplan?.active, true);
+            assert.equal(hudState.ralplan?.current_phase, "planning");
+        }
+        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 previousTeamStateRoot === "string")
+                process.env.OMX_TEAM_STATE_ROOT = previousTeamStateRoot;
+            else
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            if (typeof previousOmxSessionId === "string")
+                process.env.OMX_SESSION_ID = previousOmxSessionId;
+            else
+                delete process.env.OMX_SESSION_ID;
+            await rm(root, { recursive: true, force: true });
+        }
+    });
+    it("records native keyword activation mode detail and skill state under OMX_TEAM_STATE_ROOT", async () => {
+        const root = await mkdtemp(join(tmpdir(), "omx-native-hook-team-root-"));
+        const cwd = join(root, "source");
+        const teamStateRoot = join(root, "team-state");
+        const sessionId = "sess-team-root-ralplan";
+        const previousOmxRoot = process.env.OMX_ROOT;
+        const previousOmxStateRoot = process.env.OMX_STATE_ROOT;
+        const previousTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        const previousOmxSessionId = process.env.OMX_SESSION_ID;
+        try {
+            await mkdir(cwd, { recursive: true });
+            delete process.env.OMX_ROOT;
+            delete process.env.OMX_STATE_ROOT;
+            process.env.OMX_TEAM_STATE_ROOT = teamStateRoot;
+            process.env.OMX_SESSION_ID = sessionId;
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "UserPromptSubmit",
+                cwd,
+                session_id: sessionId,
+                thread_id: "thread-team-root",
+                turn_id: "turn-team-root",
+                prompt: "$ralplan implement issue #1307",
+            }, { cwd });
+            assert.equal(result.omxEventName, "keyword-detector");
+            assert.equal(result.skillState?.skill, "ralplan");
+            const teamSessionDir = join(teamStateRoot, "sessions", sessionId);
+            assert.equal(existsSync(join(teamSessionDir, "skill-active-state.json")), true);
+            assert.equal(existsSync(join(teamSessionDir, "ralplan-state.json")), true);
+            assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", sessionId, "skill-active-state.json")), false);
+            assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", sessionId, "ralplan-state.json")), false);
+            const hudState = await readAllState(cwd);
+            assert.equal(hudState.ralplan?.active, true);
+            assert.equal(hudState.ralplan?.current_phase, "planning");
+        }
+        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 previousTeamStateRoot === "string")
+                process.env.OMX_TEAM_STATE_ROOT = previousTeamStateRoot;
+            else
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            if (typeof previousOmxSessionId === "string")
+                process.env.OMX_SESSION_ID = previousOmxSessionId;
+            else
+                delete process.env.OMX_SESSION_ID;
+            await rm(root, { recursive: true, force: true });
+        }
+    });
     it("warns completion-like prompts when active goal workflows need Codex snapshot reconciliation", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-goal-warning-"));
         try {
@@ -1188,7 +1297,7 @@ describe("codex native hook dispatch", () => {
             assert.equal(result.skillState?.skill, "ralplan");
             const message = String(result.outputJson?.hookSpecificOutput?.additionalContext || "");
             assert.match(message, /\$oh-my-codex:ralplan" -> ralplan/);
-            assert.match(message, /skill: ralplan activated and initial state initialized at \.omx\/state\/sessions\/sess-plugin-1\/ralplan-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(message, /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
             assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", "sess-plugin-1", "ralplan-state.json")), true);
         }
         finally {
@@ -1362,7 +1471,7 @@ describe("codex native hook dispatch", () => {
             assert.equal(result.skillState?.skill, "ralph");
             const message = String(result.outputJson?.hookSpecificOutput?.additionalContext || "");
             assert.match(message, /\$ralph" -> ralph/);
-            assert.match(message, /skill: ralph activated and initial state initialized at \.omx\/state\/sessions\/sess-ralph-msg\/ralph-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(message, /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
             assert.match(message, /Prompt-side `\$ralph` activation seeds Ralph workflow state only; it does not invoke `omx ralph`\./);
             assert.match(message, /Use `omx ralph --prd \.\.\.` only when you explicitly want the PRD-gated CLI startup path\./);
         }
@@ -1386,7 +1495,7 @@ describe("codex native hook dispatch", () => {
             assert.equal(result.skillState?.skill, "ralph");
             const message = String(result.outputJson?.hookSpecificOutput?.additionalContext || "");
             assert.match(message, /\$oh-my-codex:ralph" -> ralph/);
-            assert.match(message, /skill: ralph activated and initial state initialized at \.omx\/state\/sessions\/sess-plugin-ralph-msg\/ralph-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(message, /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
             assert.match(message, /Prompt-side `\$ralph` activation seeds Ralph workflow state only; it does not invoke `omx ralph`\./);
         }
         finally {
@@ -1455,7 +1564,7 @@ describe("codex native hook dispatch", () => {
             assert.equal(result.skillState?.skill, "deep-interview");
             const message = String(result.outputJson?.hookSpecificOutput?.additionalContext || "");
             assert.match(message, /\$deep-interview" -> deep-interview/);
-            assert.match(message, /skill: deep-interview activated and initial state initialized at \.omx\/state\/sessions\/sess-deep-interview-msg\/deep-interview-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(message, /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
             assert.match(message, /Deep-interview is active, but this session is not attached to tmux/);
             assert.match(message, /Do not invoke `omx question`, `omx hud`, or `omx team`/);
             assert.match(message, /native structured question tool when available/);
@@ -1845,8 +1954,11 @@ export async function onHookEvent(event) {
             }, { cwd });
             assert.match(JSON.stringify(denied.outputJson), /denied workflow keyword/i);
             assert.match(JSON.stringify(denied.outputJson), /Unsupported workflow overlap: team \+ autopilot\./);
-            assert.match(JSON.stringify(denied.outputJson), /`omx state clear --mode <mode>`/);
-            assert.match(JSON.stringify(denied.outputJson), /`omx_state\.\*` MCP tools/);
+            assert.match(JSON.stringify(denied.outputJson), /omx state clear --input/);
+            assert.match(JSON.stringify(denied.outputJson), /mode\\":\\"<mode>/);
+            assert.match(JSON.stringify(denied.outputJson), /--json/);
+            assert.match(JSON.stringify(denied.outputJson), /explicit MCP compatibility is enabled/);
+            assert.match(JSON.stringify(denied.outputJson), /`omx_state\.\*` tools/);
             assert.equal(existsSync(join(cwd, ".omx", "state", "sessions", "sess-deny-1", "autopilot-state.json")), false);
         }
         finally {
@@ -1905,7 +2017,7 @@ export async function onHookEvent(event) {
             assert.match(message, /\$ralph" -> ralph/);
             assert.doesNotMatch(message, /mode transiting:/);
             assert.match(message, /planning preserved over simultaneous execution follow-up; deferred skills: team, ralph\./);
-            assert.match(message, /skill: ralplan activated and initial state initialized at \.omx\/state\/sessions\/sess-multi-1\/ralplan-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(message, /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
             assert.doesNotMatch(message, /Use the durable OMX team runtime via `omx team \.\.\.`/);
         }
         finally {
@@ -1930,7 +2042,7 @@ export async function onHookEvent(event) {
             assert.match(message, /\$oh-my-codex:ralph" -> ralph/);
             assert.doesNotMatch(message, /mode transiting:/);
             assert.match(message, /planning preserved over simultaneous execution follow-up; deferred skills: team, ralph\./);
-            assert.match(message, /skill: ralplan activated and initial state initialized at \.omx\/state\/sessions\/sess-plugin-multi-1\/ralplan-state\.json; write subsequent updates via omx_state MCP\./);
+            assert.match(message, /use CLI-first state updates via `omx state write\/read\/clear --input '<json>' --json`/);
         }
         finally {
             await rm(cwd, { recursive: true, force: true });
@@ -3700,7 +3812,7 @@ exit 0
             assert.equal(output?.decision, "block");
             assert.equal(output?.reason, "The MCP tool appears to have lost its transport/server connection. Preserve state, debug the transport failure, and use OMX CLI/file-backed fallbacks instead of retrying blindly.");
             const additionalContext = String(output?.hookSpecificOutput?.additionalContext ?? "");
-            assert.match(additionalContext, /omx state state_write --input/);
+            assert.match(additionalContext, /omx state write --input/);
             assert.match(additionalContext, /plain Node stdio processes/i);
             assert.match(additionalContext, /read-stall-state/);
             assert.match(additionalContext, /OMX_MCP_TRANSPORT_DEBUG=1/);
@@ -3870,7 +3982,7 @@ exit 0
             assert.match(String(result.outputJson?.reason || ""), /lost its transport\/server connection/);
             const hookSpecificOutput = result.outputJson?.hookSpecificOutput;
             assert.equal(hookSpecificOutput?.hookEventName, "PostToolUse");
-            assert.match(String(hookSpecificOutput?.additionalContext || ""), /Retry via CLI parity with `omx state state_write --input '\{\}' --json`\./);
+            assert.match(String(hookSpecificOutput?.additionalContext || ""), /Retry via CLI parity with `omx state write --input '\{\}' --json`\./);
             assert.match(String(hookSpecificOutput?.additionalContext || ""), /omx team api read-stall-state/);
             const phase = JSON.parse(await readFile(join(cwd, ".omx", "state", "team", "mcp-transport-dead-team", "phase.json"), "utf-8"));
             assert.equal(phase.current_phase, "failed");
@@ -3928,7 +4040,7 @@ exit 0
                 reason: "The MCP tool appears to have lost its transport/server connection. Preserve state, debug the transport failure, and use OMX CLI/file-backed fallbacks instead of retrying blindly.",
                 hookSpecificOutput: {
                     hookEventName: "PostToolUse",
-                    additionalContext: "Clear MCP transport-death signal detected. Preserve current team/runtime state. Retry via CLI parity with `omx state state_write --input '{\"mode\":\"team\",\"active\":true}' --json`. OMX MCP servers are plain Node stdio processes, so they still shut down when stdin/transport closes. If this happened during team runtime, inspect first with `omx team status <team>` or `omx team api read-stall-state --input '{\"team_name\":\"<team>\"}' --json`, and only force cleanup after capturing needed state. For root-cause debugging, rerun with `OMX_MCP_TRANSPORT_DEBUG=1` to log why the stdio transport closed.",
+                    additionalContext: "Clear MCP transport-death signal detected. Preserve current team/runtime state. Retry via CLI parity with `omx state write --input '{\"mode\":\"team\",\"active\":true}' --json`. OMX MCP servers are plain Node stdio processes, so they still shut down when stdin/transport closes. If this happened during team runtime, inspect first with `omx team status <team>` or `omx team api read-stall-state --input '{\"team_name\":\"<team>\"}' --json`, and only force cleanup after capturing needed state. For root-cause debugging, rerun with `OMX_MCP_TRANSPORT_DEBUG=1` to log why the stdio transport closed.",
                 },
             });
             const phase = await readTeamPhase("transport-team", cwd);
@@ -5093,6 +5205,38 @@ exit 0
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("ignores stale source-root team Stop fallback when OMX_TEAM_STATE_ROOT is authoritative", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-team-stale-source-root-"));
+        const teamStateRoot = join(cwd, "shared-team-state");
+        const priorTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
+        try {
+            process.env.OMX_TEAM_STATE_ROOT = teamStateRoot;
+            await mkdir(join(cwd, ".omx", "state"), { recursive: true });
+            await mkdir(join(teamStateRoot, "team", "stale-source-team"), { recursive: true });
+            await writeJson(join(cwd, ".omx", "state", "team-state.json"), {
+                active: true,
+                team_name: "stale-source-team",
+                current_phase: "team-exec",
+            });
+            await writeJson(join(teamStateRoot, "team", "stale-source-team", "phase.json"), {
+                current_phase: "team-exec",
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: "sess-stale-source-team",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            if (typeof priorTeamStateRoot === "string")
+                process.env.OMX_TEAM_STATE_ROOT = priorTeamStateRoot;
+            else
+                delete process.env.OMX_TEAM_STATE_ROOT;
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     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 previousTeamStateRoot = process.env.OMX_TEAM_STATE_ROOT;
@@ -5984,6 +6128,69 @@ exit 0
             await rm(cwd, { recursive: true, force: true });
         }
     });
+    it("blocks Codex App Stop when Ralph is marked complete without completion-audit evidence", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-ralph-complete-audit-missing-"));
+        try {
+            const sessionId = "sess-ralph-complete-missing";
+            const statePath = join(cwd, ".omx", "state", "sessions", sessionId, "ralph-state.json");
+            await writeJson(join(cwd, ".omx", "state", "session.json"), { session_id: sessionId, native_session_id: sessionId, cwd });
+            await writeJson(statePath, {
+                active: false,
+                mode: "ralph",
+                current_phase: "complete",
+                session_id: sessionId,
+                completed_at: "2026-05-10T12:00:00.000Z",
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: sessionId,
+                last_assistant_message: "Done. Ralph complete.",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.match(String(result.outputJson?.reason), /Ralph completion audit is missing required evidence/);
+            assert.equal(result.outputJson?.stopReason, "ralph_completion_audit_missing_completion_audit");
+            const reopened = JSON.parse(await readFile(statePath, "utf-8"));
+            assert.equal(reopened.active, true);
+            assert.equal(reopened.current_phase, "verifying");
+            assert.equal(reopened.completion_audit_gate, "blocked");
+            assert.equal(reopened.completion_audit_missing_reason, "missing_completion_audit");
+            assert.equal(typeof reopened.completed_at, "undefined");
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it("allows Codex App Stop when complete Ralph state carries checklist and verification evidence", async () => {
+        const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-ralph-complete-audit-present-"));
+        try {
+            const sessionId = "sess-ralph-complete-present";
+            await writeJson(join(cwd, ".omx", "state", "session.json"), { session_id: sessionId, native_session_id: sessionId, cwd });
+            await writeJson(join(cwd, ".omx", "state", "sessions", sessionId, "ralph-state.json"), {
+                active: false,
+                mode: "ralph",
+                current_phase: "complete",
+                session_id: sessionId,
+                completed_at: "2026-05-10T12:00:00.000Z",
+                completion_audit: {
+                    passed: true,
+                    prompt_to_artifact_checklist: ["issue #2260 fixed", "tests added"],
+                    verification_evidence: ["node --test dist/scripts/__tests__/codex-native-hook.test.js"],
+                },
+            });
+            const result = await dispatchCodexNativeHook({
+                hook_event_name: "Stop",
+                cwd,
+                session_id: sessionId,
+                last_assistant_message: "Done with completion audit evidence recorded.",
+            }, { cwd });
+            assert.equal(result.omxEventName, "stop");
+            assert.equal(result.outputJson, null);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
     it("returns Stop continuation output while Ralph is active without an explicit session pin", async () => {
         const cwd = await mkdtemp(join(tmpdir(), "omx-native-hook-stop-"));
         try {