oh-my-codex 0.20.2 → 0.20.5

package/dist/cli/update-worker.js

@@ -0,0 +1,142 @@
+import { appendFile, lstat, readFile, realpath, rm } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { spawnSync } from 'node:child_process';
+import { basename, isAbsolute, join, relative } from 'node:path';
+import { isCompletePackageManagerOwnership, runNpmCommand, validatePackageManagerOwnership } from './package-manager-ownership.js';
+import { writeUserInstallStamp } from '../scripts/postinstall-advisory.js';
+import { omxUserInstallStampPath } from '../utils/paths.js';
+const PACKAGE_NAME = 'oh-my-codex';
+const installSource = `${PACKAGE_NAME}@latest`;
+const SKIP_NATIVE_AGENT_REFRESH_ENV = 'OMX_SKIP_NATIVE_AGENT_REFRESH';
+const installOptions = { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 120000, windowsHide: true };
+function within(root, path) {
+    const relation = relative(root, path);
+    return relation !== '' && !relation.startsWith('..') && !isAbsolute(relation);
+}
+function digest(contents) { return createHash('sha256').update(contents).digest('hex'); }
+function installArgs(ownership) {
+    return ownership.manager === 'bun'
+        ? ['add', '--global', '--ignore-scripts', installSource]
+        : ['install', '--global', '--ignore-scripts', '--no-audit', '--no-progress', '--prefix', ownership.npmPrefix, installSource];
+}
+function isDeferredUpdatePayload(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const payload = value;
+    return typeof payload.cwd === 'string'
+        && Boolean(payload.cwd)
+        && typeof payload.logPath === 'string'
+        && Boolean(payload.logPath)
+        && Number.isSafeInteger(payload.parentPid)
+        && payload.parentPid > 0
+        && Array.isArray(payload.setupArgs)
+        && payload.setupArgs.every((arg) => typeof arg === 'string')
+        && isCompletePackageManagerOwnership(payload.ownership);
+}
+async function waitForParent(parentPid) {
+    await new Promise((resolve) => {
+        const timer = setInterval(() => { try {
+            process.kill(parentPid, 0);
+        }
+        catch {
+            clearInterval(timer);
+            resolve();
+        } }, 1000);
+    });
+}
+async function canonicalRegularFile(path, stage) {
+    try {
+        const stat = await lstat(path);
+        if (!stat.isFile() || stat.isSymbolicLink())
+            return null;
+        const canonical = await realpath(path);
+        return within(stage, canonical) ? canonical : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function ownerOnlyStage(stage) {
+    try {
+        const stat = await lstat(stage);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            return false;
+        // Windows does not expose POSIX mode/uid ownership through Node's stat data.
+        // Its per-user temp location is combined with canonical stage and frozen-payload validation.
+        return process.platform === 'win32'
+            || ((stat.mode & 0o077) === 0 && (typeof process.getuid !== 'function' || stat.uid === process.getuid()));
+    }
+    catch {
+        return false;
+    }
+}
+async function finalizeSuccessfulUpdate(ownership) {
+    const manifest = JSON.parse(await readFile(join(ownership.packageRoot, 'package.json'), 'utf-8'));
+    if (typeof manifest.version !== 'string' || manifest.version.trim() === '') {
+        throw new Error('Updated package version is unavailable for deferred update finalization.');
+    }
+    await writeUserInstallStamp({
+        installed_version: manifest.version.trim().replace(/^v/i, ''),
+        setup_completed_version: manifest.version.trim().replace(/^v/i, ''),
+        install_channel: 'stable',
+        install_source: installSource,
+        package_manager: ownership.manager,
+        updated_at: new Date().toISOString(),
+    }, omxUserInstallStampPath(ownership.environment.CODEX_HOME));
+}
+async function main() {
+    const payloadPath = process.argv[2];
+    const expectedDigest = process.argv[3];
+    let payload = null;
+    let stagedDirectory = null;
+    try {
+        const expectedWorkerDigest = process.argv[4];
+        if (!payloadPath || !expectedDigest || !expectedWorkerDigest)
+            throw new Error('Frozen transaction payload is missing.');
+        const workerPath = await canonicalRegularFile(process.argv[1] ?? '', await realpath(join(process.argv[1] ?? '', '..')));
+        if (!workerPath || digest(await readFile(workerPath, 'utf-8')) !== expectedWorkerDigest)
+            throw new Error('Frozen update worker identity changed before execution.');
+        const stage = await realpath(join(payloadPath, '..'));
+        if (!await ownerOnlyStage(stage) || !basename(stage).startsWith('omx-update-')) {
+            throw new Error('Frozen transaction staging directory is not an owner-only update stage.');
+        }
+        const stagedPayload = await canonicalRegularFile(payloadPath, stage);
+        if (!stagedPayload || stagedPayload !== join(stage, 'transaction.json')) {
+            throw new Error('Frozen transaction payload is not the canonical staged transaction file.');
+        }
+        const serialized = await readFile(stagedPayload, 'utf-8');
+        if (digest(serialized) !== expectedDigest)
+            throw new Error('Frozen transaction payload fingerprint changed before execution.');
+        const parsedPayload = JSON.parse(serialized);
+        if (!isDeferredUpdatePayload(parsedPayload))
+            throw new Error('Frozen transaction payload is incomplete.');
+        payload = parsedPayload;
+        stagedDirectory = stage;
+        await waitForParent(payload.parentPid);
+        if (!await validatePackageManagerOwnership(payload.ownership))
+            throw new Error('Frozen manager, package root, or bin ownership validation failed before update.');
+        const result = payload.ownership.manager === 'npm'
+            ? runNpmCommand(payload.ownership.npmCommand, installArgs(payload.ownership), { ...installOptions, env: payload.ownership.environment })
+            : spawnSync(payload.ownership.bunCommand, installArgs(payload.ownership), { ...installOptions, env: payload.ownership.environment });
+        if (result.error || result.status !== 0)
+            throw new Error(String(result.stderr || result.error?.message || 'controller install failed'));
+        const cliEntry = await validatePackageManagerOwnership(payload.ownership);
+        if (!cliEntry)
+            throw new Error('Frozen manager, package root, or bin ownership validation failed after update.');
+        const setup = spawnSync(process.execPath, [cliEntry, ...payload.setupArgs], { cwd: payload.cwd, env: { ...payload.ownership.environment, [SKIP_NATIVE_AGENT_REFRESH_ENV]: '1' }, stdio: 'inherit', windowsHide: true });
+        if (setup.error || setup.status !== 0)
+            throw new Error(setup.error?.message || `setup exited ${setup.status}`);
+        await finalizeSuccessfulUpdate(payload.ownership);
+    }
+    catch (error) {
+        if (payload)
+            await appendFile(payload.logPath, `[omx] Deferred update failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+    finally {
+        if (stagedDirectory)
+            await rm(stagedDirectory, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+void main();
+//# sourceMappingURL=update-worker.js.map

package/dist/cli/update-worker.js.map

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

package/dist/cli/update.d.ts

@@ -6,19 +6,14 @@
  * launch-time cadence so a user request always checks npm immediately.
  */
 import { spawn, spawnSync } from 'child_process';
+import { type PackageManagerOwnership } from './package-manager-ownership.js';
+import { readUserInstallStamp } from '../scripts/postinstall-advisory.js';
+export { isInstallVersionBump, readUserInstallStamp, writeUserInstallStamp, } from '../scripts/postinstall-advisory.js';
+export type { UserInstallStamp } from '../scripts/postinstall-advisory.js';
 export interface UpdateState {
     last_checked_at: string;
     last_seen_latest?: string;
 }
-export interface UserInstallStamp {
-    installed_version: string;
-    setup_completed_version?: string;
-    install_channel?: UpdateChannel;
-    install_source?: string;
-    install_revision?: string;
-    dev_base_version?: string;
-    updated_at: string;
-}
 export interface UpdateExecutionResult {
     status: 'updated' | 'scheduled' | 'up-to-date' | 'declined' | 'failed' | 'unavailable';
     currentVersion: string | null;
@@ -53,10 +48,11 @@ export declare function shouldCheckForUpdates(nowMs: number, state: UpdateState
 declare function writeUpdateState(cwd: string, state: UpdateState): Promise<void>;
 declare function fetchLatestVersion(timeoutMs?: number): Promise<string | null>;
 declare function getCurrentVersion(): Promise<string | null>;
-export declare function runGlobalUpdate(installSourceOrSpawnProcess?: string | SpawnSyncLike, spawnProcessOrPlatform?: SpawnSyncLike | NodeJS.Platform, platform?: NodeJS.Platform): RunGlobalUpdateResult;
+export declare function runGlobalUpdate(installSourceOrSpawnProcess?: string | SpawnSyncLike, spawnProcessOrPlatform?: SpawnSyncLike | NodeJS.Platform, _platform?: NodeJS.Platform, ownership?: PackageManagerOwnership): RunGlobalUpdateResult;
 export declare function resolveSetupRefreshArgs(cwd: string): string[];
+/** Compatibility formatter retained for existing callers; deferred updates use update-worker instead. */
 export declare function formatDeferredSetupCommand(platform: NodeJS.Platform, command: string, args: string[]): string;
-export declare function runDeferredGlobalUpdate(cwd: string, spawnProcess?: SpawnLike, platform?: NodeJS.Platform, parentPid?: number): RunDeferredUpdateResult;
+export declare function runDeferredGlobalUpdate(cwd: string, spawnProcess?: SpawnLike, platform?: NodeJS.Platform, parentPid?: number, ownership?: PackageManagerOwnership): RunDeferredUpdateResult;
 declare function askYesNo(question: string): Promise<boolean>;
 interface UpdateDependencies {
     askYesNo: typeof askYesNo;
@@ -65,22 +61,18 @@ interface UpdateDependencies {
     getInstalledVersionAfterUpdate: typeof getInstalledVersionAfterUpdate;
     getInstalledRevisionAfterUpdate: typeof getInstalledRevisionAfterUpdate;
     readUserInstallStamp: typeof readUserInstallStamp;
-    runGlobalUpdate: (installSource: string) => RunGlobalUpdateResult;
-    runDeferredGlobalUpdate: typeof runDeferredGlobalUpdate;
-    runSetupRefresh: (cwd: string) => Promise<RunSetupRefreshResult>;
+    resolvePackageManagerOwnership: () => Promise<PackageManagerOwnership | null>;
+    runGlobalUpdate: (installSource: string, ownership?: PackageManagerOwnership) => RunGlobalUpdateResult;
+    runDeferredGlobalUpdate: (cwd: string, ownership?: PackageManagerOwnership) => RunDeferredUpdateResult;
+    runSetupRefresh: (cwd: string, ownership?: PackageManagerOwnership) => Promise<RunSetupRefreshResult>;
     writeUpdateState: typeof writeUpdateState;
 }
-export declare function readUserInstallStamp(path?: string): Promise<UserInstallStamp | null>;
-export declare function writeUserInstallStamp(stamp: UserInstallStamp, path?: string): Promise<void>;
-export declare function isInstallVersionBump(currentVersion: string | null | undefined, stamp: UserInstallStamp | null): boolean;
-export declare function resolveGlobalInstallRoot(spawnProcess?: SpawnSyncLike, platform?: NodeJS.Platform): string | null;
-declare function getInstalledVersionAfterUpdate(): Promise<string | null>;
-declare function getInstalledRevisionAfterUpdate(): Promise<string | null>;
+declare function getInstalledVersionAfterUpdate(ownership?: PackageManagerOwnership): Promise<string | null>;
+declare function getInstalledRevisionAfterUpdate(ownership?: PackageManagerOwnership): Promise<string | null>;
 export declare function resolveInstalledCliEntry(globalInstallRoot: string): Promise<string | null>;
-export declare function spawnInstalledSetupRefresh(cliEntry: string, cwd: string, spawnProcess?: SpawnSyncLike): RunSetupRefreshResult;
+export declare function spawnInstalledSetupRefresh(cliEntry: string, cwd: string, spawnProcess?: SpawnSyncLike, command?: string, environment?: NodeJS.ProcessEnv): RunSetupRefreshResult;
 export declare function runImmediateUpdate(cwd?: string, dependencies?: Partial<UpdateDependencies>, options?: {
     channel?: UpdateChannel;
 }): Promise<UpdateExecutionResult>;
 export declare function maybeCheckAndPromptUpdate(cwd: string, dependencies?: Partial<UpdateDependencies>): Promise<void>;
-export {};
 //# sourceMappingURL=update.d.ts.map

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

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