oh-my-codex 0.15.3 → 0.16.0

package/dist/cli/index.js

@@ -6,7 +6,7 @@ import { execFileSync, spawn } from "child_process";
 import { basename, dirname, join } from "path";
 import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
 import { copyFile, cp, lstat, mkdir, readdir, rm, symlink } from "fs/promises";
-import { constants as osConstants } from "os";
+import { constants as osConstants, homedir } from "os";
 import { setup, SETUP_SCOPES } from "./setup.js";
 import { uninstall } from "./uninstall.js";
 import { version } from "./version.js";
@@ -16,6 +16,8 @@ import { hudCommand } from "../hud/index.js";
 import { sidecarCommand } from "../sidecar/index.js";
 import { teamCommand } from "./team.js";
 import { ralphCommand } from "./ralph.js";
+import { ultragoalCommand } from "./ultragoal.js";
+import { performanceGoalCommand } from "./performance-goal.js";
 import { askCommand } from "./ask.js";
 import { questionCommand } from "./question.js";
 import { stateCommand } from "./state.js";
@@ -26,6 +28,7 @@ import { agentsInitCommand } from "./agents-init.js";
 import { agentsCommand } from "./agents.js";
 import { sessionCommand } from "./session-search.js";
 import { autoresearchCommand } from "./autoresearch.js";
+import { autoresearchGoalCommand } from "./autoresearch-goal.js";
 import { mcpParityCommand } from "./mcp-parity.js";
 import { mcpServeCommand } from "./mcp-serve.js";
 import { adaptCommand } from "./adapt.js";
@@ -42,9 +45,10 @@ import { generateOverlay, removeSessionModelInstructionsFile, resolveSessionOrch
 import { readSessionState, writeSessionStart, writeSessionEnd, resetSessionMetrics, } from "../hooks/session.js";
 import { buildClientAttachedReconcileHookName, buildReconcileHudResizeArgs, buildRegisterClientAttachedReconcileArgs, buildRegisterResizeHookArgs, buildResizeHookName, buildResizeHookTarget, buildScheduleDelayedHudResizeArgs, buildUnregisterClientAttachedReconcileArgs, buildUnregisterResizeHookArgs, enableMouseScrolling, isMsysOrGitBash, isNativeWindows, isTmuxAvailable, mitigateCopyModeUnderlineArtifacts, } from "../team/tmux-session.js";
 import { getPackageRoot } from "../utils/package.js";
-import { codexConfigPath, rememberOmxLaunchContext, resolveOmxEntryPath } from "../utils/paths.js";
+import { codexConfigPath, omxRoot, rememberOmxLaunchContext, resolveOmxEntryPath } from "../utils/paths.js";
 import { cleanCodexModelAvailabilityNuxIfNeeded, repairConfigIfNeeded } from "../config/generator.js";
 import { HUD_TMUX_HEIGHT_LINES } from "../hud/constants.js";
+import { OMX_TMUX_HUD_OWNER_ENV } from "../hud/reconcile.js";
 import { createHudWatchPane as createSharedHudWatchPane, killTmuxPane as killSharedTmuxPane, listCurrentWindowHudPaneIds, parsePaneIdFromTmuxOutput, } from "../hud/tmux.js";
 export { parseTmuxPaneSnapshot, isHudWatchPane, findHudWatchPaneIds } from "../hud/tmux.js";
 rememberOmxLaunchContext();
@@ -97,6 +101,11 @@ Usage:
                 Alias for agents-init (lightweight AGENTS bootstrap only)
   omx team      Spawn parallel worker panes in tmux and bootstrap inbox/task state
   omx ralph     Launch Codex with ralph persistence mode active
+  omx ultragoal Create, resume, and checkpoint durable multi-goal plans over Codex goal mode
+  omx performance-goal
+                Create, hand off, and gate evaluator-backed performance goals
+  omx autoresearch-goal
+                Create, hand off, and gate professor-critic research goals
   omx autoresearch [DEPRECATED] Use $autoresearch; direct CLI launch removed
   omx version   Show version information
   omx tmux-hook Manage tmux prompt injection workaround (init|status|validate|test)
@@ -214,6 +223,7 @@ const NESTED_HELP_COMMANDS = new Set([
     "cleanup",
     "adapt",
     "autoresearch",
+    "autoresearch-goal",
     "agents",
     "agents-init",
     "deepinit",
@@ -226,6 +236,8 @@ const NESTED_HELP_COMMANDS = new Set([
     "wiki",
     "mcp-serve",
     "ralph",
+    "ultragoal",
+    "performance-goal",
     "resume",
     "session",
     "sparkshell",
@@ -395,7 +407,7 @@ function resolveTmuxExecutableForLaunch() {
     return resolveTmuxBinaryForPlatform() || "tmux";
 }
 export function runtimeCodexHomePath(cwd, sessionId) {
-    return join(cwd, ".omx", "runtime", "codex-home", sessionId);
+    return join(omxRoot(cwd), "runtime", "codex-home", sessionId);
 }
 async function linkOrCopyCodexHomeEntry(source, destination) {
     const stat = await lstat(source);
@@ -512,6 +524,42 @@ function warnDetachedTmuxFallback(reason) {
     const suffix = reason ? ` (${reason})` : "";
     console.warn(`[omx] warning: tmux is installed but its server/socket is unusable${suffix}. Falling back to direct Codex launch.`);
 }
+const QUICK_ATTACH_NOOP_THRESHOLD_MS = 2_000;
+function isWslWindowsTerminalEnvironment(env) {
+    return Boolean(env.WT_SESSION?.trim() &&
+        (env.WSL_INTEROP?.trim() ||
+            env.WSL_DISTRO_NAME?.trim() ||
+            env.WSLENV?.trim()));
+}
+function readDetachedSessionAttachedClientCount(sessionName) {
+    try {
+        const output = execTmuxFileSync(["display-message", "-p", "-t", sessionName, "#{session_attached}"], {
+            stdio: ["ignore", "pipe", "pipe"],
+            encoding: "utf-8",
+        }).trim();
+        const parsed = Number.parseInt(output, 10);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    catch (err) {
+        logCliOperationFailure(err);
+        return null;
+    }
+}
+function assertDetachedAttachDidNotNoop(sessionName, elapsedMs, env) {
+    if (!isWslWindowsTerminalEnvironment(env))
+        return;
+    if (elapsedMs >= QUICK_ATTACH_NOOP_THRESHOLD_MS)
+        return;
+    const attachedClients = readDetachedSessionAttachedClientCount(sessionName);
+    if (attachedClients === null || attachedClients > 0)
+        return;
+    throw new Error([
+        "tmux attach-session returned immediately without attaching a client",
+        `(session=${sessionName}).`,
+        "This can happen on WSL2 under Windows Terminal.",
+        "Falling back to direct Codex launch.",
+    ].join(" "));
+}
 function resolveTmuxAwareLaunchPolicy(explicitLaunchPolicy, nativeWindows) {
     const launchPolicy = resolveCodexLaunchPolicy(process.env, process.platform, undefined, nativeWindows, undefined, undefined, explicitLaunchPolicy);
     if (launchPolicy !== "detached-tmux") {
@@ -606,6 +654,51 @@ export function buildHudPaneCleanupTargets(existingPaneIds, createdPaneId, leade
     }
     return [...targets];
 }
+export function resolveOmxRootForLaunch(cwd, env = process.env) {
+    const raw = env.OMX_ROOT || env.OMX_STATE_ROOT;
+    if (typeof raw !== "string" || raw.trim() === "")
+        return undefined;
+    return raw.startsWith("/") ? raw : join(cwd, raw);
+}
+export function shouldAutoIsolateMadmaxLaunch(command, launchArgs, env = process.env) {
+    if (command !== "launch" && command !== "exec")
+        return false;
+    if (env.OMX_NO_BOX === "1" || env.OMXBOX_ACTIVE === "1")
+        return false;
+    if (env.OMX_ROOT || env.OMX_STATE_ROOT)
+        return false;
+    return launchArgs.some((arg) => arg === MADMAX_FLAG || arg === MADMAX_SPARK_FLAG);
+}
+function sanitizeRunIdSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+export function createMadmaxIsolatedRoot(sourceCwd, argv, env = process.env) {
+    const runsRoot = env.OMX_RUNS_DIR || join(homedir(), ".omx-runs");
+    mkdirSync(runsRoot, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[-:TZ.]/g, "").slice(0, 14);
+    const suffix = Math.random().toString(16).slice(2, 6);
+    const runDir = join(runsRoot, sanitizeRunIdSegment(`run-${stamp}-${suffix}`));
+    mkdirSync(runDir, { recursive: false });
+    const metadata = {
+        launcher: "omx --madmax",
+        created_at: new Date().toISOString(),
+        cwd: runDir,
+        source_cwd: sourceCwd,
+        argv,
+    };
+    writeFileSync(join(runDir, ".omxbox-run.json"), `${JSON.stringify(metadata, null, 2)}\n`);
+    writeFileSync(join(runsRoot, "registry.jsonl"), `${JSON.stringify(metadata)}\n`, { flag: "a" });
+    return runDir;
+}
+function activateMadmaxIsolationIfNeeded(command, launchArgs, cwd, env = process.env) {
+    if (!shouldAutoIsolateMadmaxLaunch(command, launchArgs, env))
+        return;
+    const runDir = createMadmaxIsolatedRoot(cwd, launchArgs, env);
+    env.OMX_ROOT = runDir;
+    env.OMXBOX_ACTIVE = "1";
+    env.OMX_SOURCE_CWD = cwd;
+    process.stderr.write(`[omx] madmax isolated state: ${runDir} (source: ${cwd})\n`);
+}
 export async function main(args) {
     const knownCommands = new Set([
         "launch",
@@ -622,10 +715,13 @@ export async function main(args) {
         "ask",
         "question",
         "autoresearch",
+        "autoresearch-goal",
         "explore",
         "sparkshell",
         "team",
         "ralph",
+        "ultragoal",
+        "performance-goal",
         "session",
         "resume",
         "version",
@@ -655,6 +751,7 @@ export async function main(args) {
         console.log(HELP);
         return;
     }
+    activateMadmaxIsolationIfNeeded(command, launchArgs, process.cwd(), process.env);
     try {
         switch (command) {
             case "launch":
@@ -717,6 +814,9 @@ export async function main(args) {
             case "autoresearch":
                 await autoresearchCommand(args.slice(1));
                 break;
+            case "autoresearch-goal":
+                await autoresearchGoalCommand(args.slice(1));
+                break;
             case "explore":
                 await exploreCommand(args.slice(1));
                 break;
@@ -740,6 +840,12 @@ export async function main(args) {
             case "ralph":
                 await ralphCommand(args.slice(1));
                 break;
+            case "ultragoal":
+                await ultragoalCommand(args.slice(1));
+                break;
+            case "performance-goal":
+                await performanceGoalCommand(args.slice(1));
+                break;
             case "version":
                 version();
                 break;
@@ -1049,9 +1155,12 @@ export async function execWithOverlay(args) {
             ? serializeNotifyTempContract(notifyTempResult.contract)
             : null;
         const codexArgs = injectModelInstructionsBypassArgs(cwd, ["exec", ...normalizedArgs], process.env, sessionModelInstructionsPath(cwd, sessionId));
-        const codexEnvBase = codexHomeOverride
-            ? { ...process.env, CODEX_HOME: codexHomeOverride }
-            : process.env;
+        const omxRootOverride = resolveOmxRootForLaunch(cwd, process.env);
+        const codexEnvBase = {
+            ...process.env,
+            ...(codexHomeOverride ? { CODEX_HOME: codexHomeOverride } : {}),
+            ...(omxRootOverride ? { OMX_ROOT: omxRootOverride } : {}),
+        };
         const codexEnv = notifyTempContractRaw
             ? {
                 ...codexEnvBase,
@@ -1412,7 +1521,7 @@ function blockMs(ms) {
     Atomics.wait(view, 0, 0, delay);
 }
 function tmuxExtendedKeysLeaseRoot(cwd) {
-    return join(cwd, ".omx", "state", TMUX_EXTENDED_KEYS_LEASE_DIR);
+    return join(omxRoot(cwd), "state", TMUX_EXTENDED_KEYS_LEASE_DIR);
 }
 function resolveTmuxSocketPath(execFileSyncImpl = (file, tmuxArgs) => execFileSync(file, tmuxArgs, {
     encoding: "utf-8",
@@ -1745,7 +1854,7 @@ export function withTmuxExtendedKeys(cwd, run, execFileSyncImpl = (file, tmuxArg
             releaseTmuxExtendedKeysLease(cwd, leaseHandle, execFileSyncImpl);
     }
 }
-export function buildDetachedSessionBootstrapSteps(sessionName, cwd, codexCmd, hudCmd, workerLaunchArgs, codexHomeOverride, notifyTempContractRaw, nativeWindows = false, sessionId, projectLocalCodexHomeForCleanup, runtimeCodexHomeForCleanup) {
+export function buildDetachedSessionBootstrapSteps(sessionName, cwd, codexCmd, hudCmd, workerLaunchArgs, codexHomeOverride, notifyTempContractRaw, nativeWindows = false, sessionId, projectLocalCodexHomeForCleanup, runtimeCodexHomeForCleanup, omxRootOverride, env = process.env) {
     const detachedLeaderCmd = nativeWindows
         ? "powershell.exe"
         : buildDetachedSessionLeaderCommand(cwd, sessionName, codexCmd, sessionId, codexHomeOverride, projectLocalCodexHomeForCleanup, runtimeCodexHomeForCleanup);
@@ -1763,7 +1872,12 @@ export function buildDetachedSessionBootstrapSteps(sessionName, cwd, codexCmd, h
             ? ["-e", `${TEAM_WORKER_LAUNCH_ARGS_ENV}=${workerLaunchArgs}`]
             : []),
         ...(sessionId ? ["-e", `OMX_SESSION_ID=${sessionId}`] : []),
+        ...(sessionId ? ["-e", `${OMX_TMUX_HUD_OWNER_ENV}=1`] : []),
         ...(codexHomeOverride ? ["-e", `CODEX_HOME=${codexHomeOverride}`] : []),
+        ...(omxRootOverride ? ["-e", `OMX_ROOT=${omxRootOverride}`] : []),
+        ...(env.OMX_STATE_ROOT ? ["-e", `OMX_STATE_ROOT=${env.OMX_STATE_ROOT}`] : []),
+        ...(env.OMXBOX_ACTIVE ? ["-e", `OMXBOX_ACTIVE=${env.OMXBOX_ACTIVE}`] : []),
+        ...(env.OMX_SOURCE_CWD ? ["-e", `OMX_SOURCE_CWD=${env.OMX_SOURCE_CWD}`] : []),
         ...(notifyTempContractRaw
             ? ["-e", `${OMX_NOTIFY_TEMP_CONTRACT_ENV}=${notifyTempContractRaw}`]
             : []),
@@ -1890,6 +2004,7 @@ export function buildNotifyFallbackWatcherEnv(env = process.env, options = {}) {
     return {
         ...nextEnv,
         ...(options.codexHomeOverride ? { CODEX_HOME: options.codexHomeOverride } : {}),
+        ...(options.omxRootOverride ? { OMX_ROOT: options.omxRootOverride } : {}),
         ...(options.sessionId ? { OMX_SESSION_ID: options.sessionId } : {}),
         OMX_HUD_AUTHORITY: options.enableAuthority ? "1" : "0",
     };
@@ -2206,13 +2321,20 @@ function runCodex(cwd, args, sessionId, workerDefaultModel, codexHomeOverride, n
     }
     const hudCmd = nativeWindows
         ? buildWindowsPromptCommand("node", [omxBin, "hud", "--watch"])
-        : buildTmuxPaneCommand("env", [`OMX_SESSION_ID=${sessionId}`, "node", omxBin, "hud", "--watch"]);
+        : buildTmuxPaneCommand("env", [`OMX_SESSION_ID=${sessionId}`, `${OMX_TMUX_HUD_OWNER_ENV}=1`, "node", omxBin, "hud", "--watch"]);
     const inheritLeaderFlags = process.env[TEAM_INHERIT_LEADER_FLAGS_ENV] !== "0";
     const workerLaunchArgs = resolveTeamWorkerLaunchArgsEnv(process.env[TEAM_WORKER_LAUNCH_ARGS_ENV], launchArgs, inheritLeaderFlags, workerDefaultModel);
-    const codexBaseEnv = codexHomeOverride
-        ? { ...process.env, CODEX_HOME: codexHomeOverride }
-        : process.env;
-    const codexEnvWithSession = { ...codexBaseEnv, OMX_SESSION_ID: sessionId };
+    const omxRootOverride = resolveOmxRootForLaunch(cwd, process.env);
+    const codexBaseEnv = {
+        ...process.env,
+        ...(codexHomeOverride ? { CODEX_HOME: codexHomeOverride } : {}),
+        ...(omxRootOverride ? { OMX_ROOT: omxRootOverride } : {}),
+    };
+    const codexEnvWithSession = {
+        ...codexBaseEnv,
+        OMX_SESSION_ID: sessionId,
+        [OMX_TMUX_HUD_OWNER_ENV]: "1",
+    };
     const codexEnv = workerLaunchArgs
         ? { ...codexEnvWithSession, [TEAM_WORKER_LAUNCH_ARGS_ENV]: workerLaunchArgs }
         : codexEnvWithSession;
@@ -2303,7 +2425,7 @@ function runCodex(cwd, args, sessionId, workerDefaultModel, codexHomeOverride, n
         let registeredHookName = null;
         let registeredClientAttachedHookName = null;
         try {
-            const bootstrapSteps = buildDetachedSessionBootstrapSteps(sessionName, cwd, codexCmd, hudCmd, workerLaunchArgs, codexHomeOverride, notifyTempContractRaw, nativeWindows, sessionId, projectLocalCodexHomeForCleanup, runtimeCodexHomeForCleanup);
+            const bootstrapSteps = buildDetachedSessionBootstrapSteps(sessionName, cwd, codexCmd, hudCmd, workerLaunchArgs, codexHomeOverride, notifyTempContractRaw, nativeWindows, sessionId, projectLocalCodexHomeForCleanup, runtimeCodexHomeForCleanup, omxRootOverride, process.env);
             for (const step of bootstrapSteps) {
                 const output = execTmuxFileSync(step.args, {
                     stdio: "pipe",
@@ -2343,7 +2465,11 @@ function runCodex(cwd, args, sessionId, workerDefaultModel, codexHomeOverride, n
                         }
                         const stdio = finalizeStep.name === "attach-session" ? "inherit" : "ignore";
                         try {
+                            const startedAtMs = Date.now();
                             execTmuxFileSync(finalizeStep.args, { stdio });
+                            if (finalizeStep.name === "attach-session") {
+                                assertDetachedAttachDidNotNoop(sessionName, Date.now() - startedAtMs, process.env);
+                            }
                         }
                         catch (err) {
                             logCliOperationFailure(err);
@@ -2643,10 +2769,10 @@ async function emitNativeHookEvent(cwd, event, opts = {}) {
     });
 }
 function notifyFallbackPidPath(cwd) {
-    return join(cwd, ".omx", "state", "notify-fallback.pid");
+    return join(omxRoot(cwd), "state", "notify-fallback.pid");
 }
 function hookDerivedWatcherPidPath(cwd) {
-    return join(cwd, ".omx", "state", "hook-derived-watcher.pid");
+    return join(omxRoot(cwd), "state", "hook-derived-watcher.pid");
 }
 export function shouldDetachBackgroundHelper(env = process.env, platform = process.platform) {
     // The long-running watcher/helper itself must stay detached so it can
@@ -2814,7 +2940,7 @@ async function startNotifyFallbackWatcher(cwd, options = {}) {
     const notifyScript = resolveNotifyHookScript(pkgRoot);
     if (!existsSync(watcherScript) || !existsSync(notifyScript))
         return;
-    await mkdir(join(cwd, ".omx", "state"), { recursive: true }).catch((error) => {
+    await mkdir(join(omxRoot(cwd), "state"), { recursive: true }).catch((error) => {
         console.warn("[omx] warning: failed to create notify fallback watcher state directory", {
             cwd,
             error: error instanceof Error ? error.message : String(error),
@@ -2822,6 +2948,7 @@ async function startNotifyFallbackWatcher(cwd, options = {}) {
     });
     const watcherEnv = buildNotifyFallbackWatcherEnv(process.env, {
         codexHomeOverride: options.codexHomeOverride,
+        omxRootOverride: resolveOmxRootForLaunch(cwd, process.env),
         enableAuthority: options.enableAuthority === true,
         sessionId: options.sessionId,
     });
@@ -2887,7 +3014,7 @@ async function startHookDerivedWatcher(cwd) {
             });
         }
     }
-    await mkdir(join(cwd, ".omx", "state"), { recursive: true }).catch((error) => {
+    await mkdir(join(omxRoot(cwd), "state"), { recursive: true }).catch((error) => {
         console.warn("[omx] warning: failed to create hook-derived watcher state directory", {
             cwd,
             error: error instanceof Error ? error.message : String(error),