oh-my-codex 0.20.3 → 0.21.0

package/dist/cli/autopilot.js

@@ -0,0 +1,160 @@
+import { readFile } from 'node:fs/promises';
+import { readModeState, readModeStateForExplicitSession, startMode, updateAutopilotPipelineState, } from '../modes/base.js';
+import { deriveAutopilotChildPhase } from '../autopilot/fsm.js';
+export const AUTOPILOT_HELP = `omx autopilot - canonical supervised deep-interview -> ralplan -> ultragoal workflow
+
+Usage:
+  omx autopilot start --task <text> [--session <id>] [--json]
+  omx autopilot status [--session <id>] [--json]
+  omx autopilot next [--session <id>] [--json]
+  omx autopilot advance --to <ralplan|ultragoal> --handoff-json <json-or-path> [--session <id>] [--json]
+
+The supervisor owns one session-scoped autopilot-state.json. Child stages remain
+supervised phases; advance validates durable artifacts and cannot skip stages.
+Cancel and state clear remain available through their normal exact-session paths.
+`;
+function value(args, flag) {
+    const inline = args.find((arg) => arg.startsWith(`${flag}=`));
+    if (inline)
+        return inline.slice(flag.length + 1);
+    const index = args.indexOf(flag);
+    if (index < 0)
+        return undefined;
+    const result = args[index + 1];
+    if (!result || result.startsWith('--'))
+        throw new Error(`Missing value for ${flag}.`);
+    return result;
+}
+function positionalTask(args) {
+    const valueFlags = new Set(['--task', '--session', '--to', '--handoff-json']);
+    const words = [];
+    for (let i = 0; i < args.length; i += 1) {
+        if (valueFlags.has(args[i])) {
+            i += 1;
+            continue;
+        }
+        if (!args[i].startsWith('--'))
+            words.push(args[i]);
+    }
+    return words.join(' ').trim();
+}
+async function jsonInput(raw) {
+    const text = raw.trim().startsWith('{') ? raw : await readFile(raw, 'utf-8');
+    const parsed = JSON.parse(text);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        throw new Error('--handoff-json must resolve to a JSON object.');
+    return parsed;
+}
+function assertBoundHandoffIdentity(handoff, cwd, sessionId) {
+    if (typeof handoff.session_id === 'string' && handoff.session_id !== sessionId) {
+        throw new Error('Autopilot handoff session_id does not match the selected session.');
+    }
+    if (typeof handoff.workingDirectory === 'string' && handoff.workingDirectory !== cwd) {
+        throw new Error('Autopilot handoff workingDirectory does not match the selected workspace.');
+    }
+    handoff.session_id = sessionId;
+    handoff.workingDirectory = cwd;
+}
+async function readAutopilot(cwd, sessionId) {
+    return sessionId
+        ? readModeStateForExplicitSession('autopilot', sessionId, cwd)
+        : readModeState('autopilot', cwd);
+}
+/**
+ * A terminalization that carried skipped gates must never read as clean success. The durable
+ * marker is the machine token `complete-with-skipped-gates`; this renders the human string and
+ * names each skipped gate with its missing evidence so the report is actionable.
+ */
+function skippedGateReport(state) {
+    if (state.completion_status !== 'complete-with-skipped-gates')
+        return null;
+    const entries = Array.isArray(state.skipped_gates) ? state.skipped_gates : [];
+    const lines = entries.map((entry) => {
+        const record = (entry ?? {});
+        const gate = typeof record.skippedGate === 'string' ? record.skippedGate : 'unknown gate';
+        const missing = typeof record.missingEvidence === 'string' ? record.missingEvidence : 'unspecified evidence';
+        return `  - ${gate}: missing ${missing}`;
+    });
+    return ['autopilot: complete with skipped gates', ...lines].join('\n');
+}
+function instruction(state) {
+    const phase = deriveAutopilotChildPhase(state);
+    const task = typeof state.task_description === 'string' ? state.task_description : '';
+    if (phase === 'deep-interview')
+        return `$deep-interview ${JSON.stringify(task)}`;
+    if (phase === 'ralplan')
+        return `$ralplan ${JSON.stringify(task)}`;
+    if (phase === 'ultragoal')
+        return `$ultragoal ${JSON.stringify(task)}`;
+    return `Autopilot phase ${String(state.current_phase ?? 'unknown')} has no child-stage instruction.`;
+}
+export async function autopilotCommand(args, deps = {}) {
+    const stdout = deps.stdout ?? ((line) => console.log(line));
+    const cwd = (deps.cwd ?? process.cwd)();
+    const command = args[0] ?? 'help';
+    const rest = args.slice(1);
+    const sessionId = value(rest, '--session');
+    const json = rest.includes('--json');
+    if (command === 'help' || command === '--help' || command === '-h') {
+        stdout(AUTOPILOT_HELP);
+        return;
+    }
+    if (command === 'start') {
+        const task = value(rest, '--task') ?? positionalTask(rest);
+        if (!task)
+            throw new Error('Missing --task.');
+        const state = await startMode('autopilot', task, 3, cwd, sessionId);
+        const initialized = await updateAutopilotPipelineState({
+            ...state,
+            active: true,
+            current_phase: 'deep-interview',
+            session_id: sessionId,
+            workingDirectory: cwd,
+            phase_cycle: ['deep-interview', 'ralplan', 'ultragoal'],
+            handoff_artifacts: {},
+            deep_interview_gate: { status: 'required' },
+            review_cycle: 0,
+        }, cwd, sessionId);
+        if (json)
+            stdout(JSON.stringify({ ok: true, state: initialized, instruction: instruction(initialized) }));
+        else
+            stdout(instruction(initialized));
+        return;
+    }
+    const state = await readAutopilot(cwd, sessionId);
+    if (!state)
+        throw new Error('No Autopilot state found. Run `omx autopilot start --task <text>` first.');
+    if (command === 'status' || command === 'next') {
+        const nextInstruction = instruction(state);
+        const skippedGates = skippedGateReport(state);
+        if (json)
+            stdout(JSON.stringify({ state, instruction: nextInstruction }));
+        else if (command === 'next')
+            stdout(nextInstruction);
+        else
+            stdout([skippedGates ?? `autopilot: ${state.current_phase}`, nextInstruction].join('\n'));
+        return;
+    }
+    if (command === 'advance') {
+        const to = value(rest, '--to');
+        if (to !== 'ralplan' && to !== 'ultragoal')
+            throw new Error('--to must be ralplan or ultragoal.');
+        const rawHandoff = value(rest, '--handoff-json');
+        if (!rawHandoff)
+            throw new Error('Missing --handoff-json.');
+        const handoff = await jsonInput(rawHandoff);
+        assertBoundHandoffIdentity(handoff, cwd, sessionId);
+        const updated = await updateAutopilotPipelineState({
+            ...handoff,
+            active: true,
+            current_phase: to,
+        }, cwd, sessionId);
+        if (json)
+            stdout(JSON.stringify({ ok: true, state: updated, instruction: instruction(updated) }));
+        else
+            stdout(instruction(updated));
+        return;
+    }
+    throw new Error(`Unknown autopilot command: ${command}\n${AUTOPILOT_HELP}`);
+}
+//# sourceMappingURL=autopilot.js.map

package/dist/cli/autopilot.js.map

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

package/dist/cli/codex-feature-probe.d.ts

@@ -5,6 +5,22 @@ export interface CodexFeatureProbeOptions {
     codexVersionProbe?: () => string | null;
 }
 type SpawnSyncLike = typeof spawnSync;
+export interface CodexVersionProbeOutput {
+    output: string;
+    truncated: boolean;
+    lineLimitExceeded: boolean;
+}
+export type CodexVersionProbeResult = {
+    status: "ok";
+    collected: CodexVersionProbeOutput;
+} | {
+    status: "start-unavailable";
+} | {
+    status: "exit-failure";
+} | {
+    status: "timeout";
+};
+export declare function probeInstalledCodexVersionDetailed(spawnImpl?: SpawnSyncLike): CodexVersionProbeResult;
 export declare function probeInstalledCodexFeatureList(spawnImpl?: SpawnSyncLike): string | null;
 export declare function probeInstalledCodexVersion(spawnImpl?: SpawnSyncLike): string | null;
 export interface CodexHookFeatureSupport {

package/dist/cli/codex-feature-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-feature-probe.d.ts","sourceRoot":"","sources":["../../src/cli/codex-feature-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,KAAK,aAAa,GAAG,OAAO,SAAS,CAAC;AAkBtC,wBAAgB,8BAA8B,CAC5C,SAAS,GAAE,aAAyB,GACnC,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,aAAyB,GACnC,MAAM,GAAG,IAAI,CAOf;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,oBAAoB,CAAC;IACtC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAYzB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAEtB"}
+{"version":3,"file":"codex-feature-probe.d.ts","sourceRoot":"","sources":["../../src/cli/codex-feature-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,KAAK,aAAa,GAAG,OAAO,SAAS,CAAC;AAUtC,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,uBAAuB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,GAC1B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAuB1B,wBAAgB,kCAAkC,CAChD,SAAS,GAAE,aAAyB,GACnC,uBAAuB,CA6BzB;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,GAAE,aAAyB,GACnC,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,aAAyB,GACnC,MAAM,GAAG,IAAI,CAOf;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,oBAAoB,CAAC;IACtC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAYzB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAEtB"}

package/dist/cli/codex-feature-probe.js

@@ -1,8 +1,11 @@
 import { spawnSync } from "child_process";
 import { DEFAULT_CODEX_HOOK_FEATURE_FLAG, resolveCodexHookFeatureFlag, supportsCodexPluginScopedHooks, } from "../config/codex-feature-flags.js";
 const CODEX_FEATURE_PROBE_TIMEOUT_MS = 3_000;
+const CODEX_VERSION_PROBE_MAX_BYTES = 4_096;
+const CODEX_VERSION_PROBE_MAX_LINES = 8;
 let cachedFeatureListOutput;
 let cachedVersionOutput;
+let cachedDetailedVersionResult;
 function runCodexProbe(args, spawnImpl) {
     const result = spawnImpl("codex", [...args], {
         encoding: "utf-8",
@@ -14,6 +17,47 @@ function runCodexProbe(args, spawnImpl) {
         return null;
     return [result.stdout, result.stderr].filter(Boolean).join("\n") || null;
 }
+function collectBoundedVersionOutput(stdout, stderr) {
+    const raw = [stdout, stderr].filter(Boolean).join("\n");
+    const rawBytes = Buffer.from(raw, "utf8");
+    const truncated = rawBytes.length > CODEX_VERSION_PROBE_MAX_BYTES;
+    const byteBounded = rawBytes.subarray(0, CODEX_VERSION_PROBE_MAX_BYTES).toString("utf8");
+    const rawLines = raw.split(/\r?\n/);
+    const lineLimitExceeded = rawLines.length > CODEX_VERSION_PROBE_MAX_LINES;
+    const output = byteBounded.split(/\r?\n/).slice(0, CODEX_VERSION_PROBE_MAX_LINES).join("\n");
+    return { output, truncated, lineLimitExceeded };
+}
+export function probeInstalledCodexVersionDetailed(spawnImpl = spawnSync) {
+    if (spawnImpl === spawnSync && cachedDetailedVersionResult !== undefined) {
+        return cachedDetailedVersionResult;
+    }
+    const result = spawnImpl("codex", ["--version"], {
+        encoding: "utf-8",
+        killSignal: "SIGKILL",
+        timeout: CODEX_FEATURE_PROBE_TIMEOUT_MS,
+        windowsHide: true,
+    });
+    const errorCode = result.error?.code;
+    let probeResult;
+    if (errorCode === "ETIMEDOUT" || result.signal) {
+        probeResult = { status: "timeout" };
+    }
+    else if (result.error) {
+        probeResult = { status: "start-unavailable" };
+    }
+    else if (result.status !== 0) {
+        probeResult = { status: "exit-failure" };
+    }
+    else {
+        probeResult = {
+            status: "ok",
+            collected: collectBoundedVersionOutput(typeof result.stdout === "string" ? result.stdout : "", typeof result.stderr === "string" ? result.stderr : ""),
+        };
+    }
+    if (spawnImpl === spawnSync)
+        cachedDetailedVersionResult = probeResult;
+    return probeResult;
+}
 export function probeInstalledCodexFeatureList(spawnImpl = spawnSync) {
     if (spawnImpl === spawnSync && cachedFeatureListOutput !== undefined) {
         return cachedFeatureListOutput;

package/dist/cli/codex-feature-probe.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-feature-probe.js","sourceRoot":"","sources":["../../src/cli/codex-feature-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,GAE/B,MAAM,kCAAkC,CAAC;AAS1C,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAE7C,IAAI,uBAAkD,CAAC;AACvD,IAAI,mBAA8C,CAAC;AAEnD,SAAS,aAAa,CAAC,IAAuB,EAAE,SAAwB;IACtE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;QAC3C,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,8BAA8B;QACvC,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,SAAS,GAAkB,SAAS;IAEpC,IAAI,SAAS,KAAK,SAAS,IAAI,uBAAuB,KAAK,SAAS,EAAE,CAAC;QACrE,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,SAAS,KAAK,SAAS;QAAE,uBAAuB,GAAG,MAAM,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAAS,GAAkB,SAAS;IAEpC,IAAI,SAAS,KAAK,SAAS,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACjE,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,SAAS,KAAK,SAAS;QAAE,mBAAmB,GAAG,MAAM,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,UAAU,oCAAoC,CAClD,OAAO,GAA6B,EAAE;IAEtC,MAAM,kBAAkB,GACtB,OAAO,CAAC,kBAAkB,EAAE,EAAE,IAAI,8BAA8B,EAAE,CAAC;IACrE,MAAM,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,EAAE,IAAI,0BAA0B,EAAE,CAAC;IACpF,OAAO;QACL,eAAe,EAAE,2BAA2B,CAAC;YAC3C,kBAAkB;YAClB,aAAa;YACb,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,iBAAiB,EAAE,8BAA8B,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAAO,GAA6B,EAAE;IAEtC,OAAO,oCAAoC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC;AACvE,CAAC"}
+{"version":3,"file":"codex-feature-probe.js","sourceRoot":"","sources":["../../src/cli/codex-feature-probe.ts"],"names":[],"mappings":"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"}

package/dist/cli/codex-home.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-home.d.ts","sourceRoot":"","sources":["../../src/cli/codex-home.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,iCAAiC,EACjC,2BAA2B,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,6BAA6B,0CAAoC,CAAC;AAC/E,eAAO,MAAM,uBAAuB,oCAA8B,CAAC;AAEnE,wBAAgB,qCAAqC,CACpD,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,yBAAyB,CACxC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,+BAA+B,CAC9C,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,MAAM,CAKR"}
+{"version":3,"file":"codex-home.d.ts","sourceRoot":"","sources":["../../src/cli/codex-home.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,iCAAiC,EACjC,2BAA2B,EAE3B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,6BAA6B,0CAAoC,CAAC;AAC/E,eAAO,MAAM,uBAAuB,oCAA8B,CAAC;AAEnE,wBAAgB,qCAAqC,CACpD,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,yBAAyB,CACxC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,+BAA+B,CAC9C,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,MAAM,CAKR"}

package/dist/cli/codex-home.js

@@ -1,14 +1,17 @@
 import { join } from "path";
 import { codexConfigPath } from "../utils/paths.js";
-import { readPersistedSetupPreferencesSync, readPersistedSetupScopeSync, } from "./setup-preferences.js";
+import { readPersistedSetupPreferencesSync, readPersistedSetupScopeSync, resolveNearestPersistedSetupScopeSync, } from "./setup-preferences.js";
 export const readPersistedSetupPreferences = readPersistedSetupPreferencesSync;
 export const readPersistedSetupScope = readPersistedSetupScopeSync;
 export function resolveProjectLocalCodexHomeForLaunch(cwd, env = process.env) {
     if (env.CODEX_HOME && env.CODEX_HOME.trim() !== "")
         return undefined;
-    const persistedScope = readPersistedSetupScope(cwd);
-    if (persistedScope === "project") {
-        return join(cwd, ".codex");
+    // Walk upward so a project-scoped setup is honored from any directory
+    // inside its tree — launching from a subdirectory must not fall through
+    // to the user config (issue #3447).
+    const nearest = resolveNearestPersistedSetupScopeSync(cwd);
+    if (nearest?.scope === "project") {
+        return join(nearest.projectRoot, ".codex");
     }
     return undefined;
 }

package/dist/cli/codex-home.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-home.js","sourceRoot":"","sources":["../../src/cli/codex-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACN,iCAAiC,EACjC,2BAA2B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,6BAA6B,GAAG,iCAAiC,CAAC;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAEnE,MAAM,UAAU,qCAAqC,CACpD,GAAW,EACX,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACrE,MAAM,cAAc,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,GAAW,EACX,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC;IAC1E,OAAO,qCAAqC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC9C,GAAW,EACX,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,iBAAiB;QACvB,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC;QACxC,CAAC,CAAC,eAAe,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"codex-home.js","sourceRoot":"","sources":["../../src/cli/codex-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACN,iCAAiC,EACjC,2BAA2B,EAC3B,qCAAqC,GACrC,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,6BAA6B,GAAG,iCAAiC,CAAC;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAEnE,MAAM,UAAU,qCAAqC,CACpD,GAAW,EACX,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACrE,sEAAsE;IACtE,wEAAwE;IACxE,oCAAoC;IACpC,MAAM,OAAO,GAAG,qCAAqC,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,GAAW,EACX,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC;IAC1E,OAAO,qCAAqC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC9C,GAAW,EACX,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,iBAAiB;QACvB,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC;QACxC,CAAC,CAAC,eAAe,EAAE,CAAC;AACtB,CAAC"}

package/dist/cli/doctor.d.ts

@@ -3,7 +3,9 @@
  */
 import { type NativeHookClaimJournalDurability } from "./native-hook-claim-journal.js";
 import { spawnSync } from "child_process";
+import { type CanonicalSessionBindingSnapshot } from "../mcp/state-paths.js";
 import { type SetupInstallMode } from "./setup-preferences.js";
+import { type ProcessInspectionProvider } from "../hooks/session.js";
 /** @internal Test seam for deterministic claim-journal durability coverage. */
 export declare function setDoctorClaimJournalDurabilityForTest(durability: NativeHookClaimJournalDurability | undefined): () => void;
 interface DoctorOptions {
@@ -11,6 +13,12 @@ interface DoctorOptions {
     force?: boolean;
     dryRun?: boolean;
     team?: boolean;
+    repairState?: boolean;
+}
+export interface StateProjectionRepairResult {
+    archived: string[];
+    preserved: string[];
+    skipped: string[];
 }
 interface Check {
     name: string;
@@ -39,6 +47,11 @@ interface NativeHookDistSmokeOptions {
     nodePath?: string;
     runner?: typeof spawnSync;
 }
+interface ProcessIdentityReadinessOptions {
+    platform?: NodeJS.Platform;
+    pid?: number;
+    provider?: Pick<ProcessInspectionProvider, "observeProcess">;
+}
 type DoctorSetupScope = "user" | "project";
 interface DoctorPaths {
     codexHomeDir: string;
@@ -49,7 +62,23 @@ interface DoctorPaths {
     agentsDir: string;
     stateDir: string;
 }
+type BindingSelectorName = "OMX_SESSION_ID" | "CODEX_SESSION_ID" | "SESSION_ID";
+export declare function sanitizeBindingDiagnosticLine(value: string): string;
+declare function selectorEvaluation(snapshot: CanonicalSessionBindingSnapshot, env: NodeJS.ProcessEnv): {
+    nonblank: BindingSelectorName[];
+    bad: BindingSelectorName[];
+};
+export declare const evaluateStateRootSessionBinding: typeof selectorEvaluation;
+export declare function formatStateRootSessionBindingDiagnostic(snapshot: CanonicalSessionBindingSnapshot, env?: NodeJS.ProcessEnv, badSelectors?: readonly BindingSelectorName[]): string;
+export declare function checkStateRootSessionBinding(snapshot: CanonicalSessionBindingSnapshot, env?: NodeJS.ProcessEnv): Check;
+/**
+ * Archive non-authoritative mode-state projections without interpreting their
+ * workflow contents. The canonical session pointer selects the one current
+ * session scope; all other mode projection files are stale by ownership.
+ */
+export declare function repairStateProjections(cwd: string, env?: NodeJS.ProcessEnv): Promise<StateProjectionRepairResult>;
 export declare function doctor(options?: DoctorOptions): Promise<void>;
+export declare function checkProcessIdentityReadiness(options?: ProcessIdentityReadinessOptions): Check | null;
 export declare function checkExploreHarness(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv, options?: {
     exploreRoutingEnabled?: boolean;
 }): Check;

package/dist/cli/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGN,KAAK,gCAAgC,EACrC,MAAM,gCAAgC,CAAC;AAQxC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAwD1C,OAAO,EAEN,KAAK,gBAAgB,EAErB,MAAM,wBAAwB,CAAC;AA6BhC,+EAA+E;AAC/E,wBAAgB,sCAAsC,CACrD,UAAU,EAAE,gCAAgC,GAAG,SAAS,GACtD,MAAM,IAAI,CAMZ;AAED,UAAU,aAAa;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,UAAU,KAAK;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CAChB;AAUD,UAAU,iBAAiB;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,IAAI,OAAO,CAAC;IAC1B,WAAW,IAAI,OAAO,CAAC;CACvB;AAED,UAAU,uBAAuB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,UAAU,yBAA0B,SAAQ,uBAAuB;IAClE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAKD,UAAU,0BAA0B;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,SAAS,CAAC;CAC1B;AAED,KAAK,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;AAS3C,UAAU,WAAW;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAkGD,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiNvE;AAuYD,wBAAgB,mBAAmB,CAClC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,KAAK,CA8FP;AAoHD,wBAAsB,0BAA0B,CAC/C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,KAAK,CAAC,CAoBhB;AAED,wBAAsB,2BAA2B,CAChD,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqClD;AAcD,wBAAsB,kCAAkC,CACvD,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA8BvB;AAgRD,UAAU,gCAAgC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAqED,wBAAsB,+BAA+B,CACpD,OAAO,GAAE,gCAAqC,GAC5C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA0DvB;AAED,MAAM,WAAW,sBAAsB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B;AA6iBD,wBAAsB,gBAAgB,CACrC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,KAAK,CAAC,CAsDhB;AAED,wBAAsB,wBAAwB,CAC7C,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,KAAK,CAAC,CAiEhB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAmB1E;AAED,UAAU,+BAA+B;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,oCAAoC,CACnD,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACnB,GACJ,+BAA+B,CAqBjC;AAkGD,UAAU,mCAAmC;IAC5C,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,SAAS,CAAC;IAC1B,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE;QAChC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;KACjB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAyCD,wBAAsB,iCAAiC,CACtD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,mCAAwC,GAC/C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA2LvB;AAyfD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAsG3D"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"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"}