oh-my-codex-pennix 0.18.13

package/dist/cli/__tests__/native-assets.test.js

@@ -0,0 +1,296 @@
+import { createServer } from 'node:http';
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { chmod, mkdtemp, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { hydrateNativeBinary, inferNativeAssetLibc, isRepositoryCheckout, resolveCachedNativeBinaryCandidatePaths, resolveCachedNativeBinaryPath, resolveNativeReleaseAssetCandidates, resolveNativeReleaseBaseUrl, } from '../native-assets.js';
+async function startStaticServer(root) {
+    const server = createServer(async (req, res) => {
+        const url = new URL(req.url || '/', 'http://127.0.0.1');
+        const filePath = join(root, url.pathname.replace(/^\//, ''));
+        try {
+            const body = await readFile(filePath);
+            res.writeHead(200);
+            res.end(body);
+        }
+        catch {
+            res.writeHead(404);
+            res.end('missing');
+        }
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const address = server.address();
+    if (!address || typeof address === 'string')
+        throw new Error('failed to bind test server');
+    return {
+        baseUrl: `http://127.0.0.1:${address.port}`,
+        close: () => new Promise((resolve, reject) => server.close((err) => err ? reject(err) : resolve())),
+    };
+}
+function sha256(buffer) {
+    return createHash('sha256').update(buffer).digest('hex');
+}
+describe('repository checkout detection', () => {
+    it('does not treat an installed npm package that ships src/scripts as a source checkout', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-native-installed-'));
+        try {
+            const packageRoot = join(wd, 'node_modules', 'oh-my-codex');
+            await mkdir(join(packageRoot, 'src', 'scripts'), { recursive: true });
+            await writeFile(join(packageRoot, 'package.json'), JSON.stringify({ name: 'oh-my-codex' }));
+            assert.equal(isRepositoryCheckout(packageRoot), false);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('recognizes a git working tree as a source checkout', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-native-checkout-'));
+        try {
+            await mkdir(join(wd, '.git'), { recursive: true });
+            await mkdir(join(wd, 'src'), { recursive: true });
+            assert.equal(isRepositoryCheckout(wd), true);
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+describe('native asset helpers', () => {
+    it('infers Linux libc variants from manifest metadata', () => {
+        assert.equal(inferNativeAssetLibc({
+            archive: 'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz',
+            target: 'x86_64-unknown-linux-musl',
+            libc: undefined,
+        }), 'musl');
+        assert.equal(inferNativeAssetLibc({
+            archive: 'omx-sparkshell-x86_64-unknown-linux-gnu.tar.gz',
+            target: 'x86_64-unknown-linux-gnu',
+            libc: undefined,
+        }), 'glibc');
+    });
+    it('prefers musl cache paths before glibc and legacy Linux cache paths', () => {
+        assert.deepEqual(resolveCachedNativeBinaryCandidatePaths('omx-sparkshell', '0.8.15', 'linux', 'x64', {
+            OMX_NATIVE_CACHE_DIR: '/tmp/omx-native-cache',
+        }, {
+            linuxLibcPreference: ['musl', 'glibc'],
+        }), [
+            '/tmp/omx-native-cache/0.8.15/linux-x64-musl/omx-sparkshell/omx-sparkshell',
+            '/tmp/omx-native-cache/0.8.15/linux-x64-glibc/omx-sparkshell/omx-sparkshell',
+            '/tmp/omx-native-cache/0.8.15/linux-x64/omx-sparkshell/omx-sparkshell',
+        ]);
+    });
+    it('orders manifest assets musl-first for Linux hydration', () => {
+        const manifest = {
+            version: '0.8.15',
+            assets: [
+                {
+                    product: 'omx-sparkshell',
+                    version: '0.8.15',
+                    platform: 'linux',
+                    arch: 'x64',
+                    target: 'x86_64-unknown-linux-gnu',
+                    libc: 'glibc',
+                    archive: 'omx-sparkshell-x86_64-unknown-linux-gnu.tar.gz',
+                    binary: 'omx-sparkshell',
+                    binary_path: 'omx-sparkshell',
+                    sha256: 'glibc',
+                    download_url: 'https://example.invalid/glibc',
+                },
+                {
+                    product: 'omx-sparkshell',
+                    version: '0.8.15',
+                    platform: 'linux',
+                    arch: 'x64',
+                    target: 'x86_64-unknown-linux-musl',
+                    libc: 'musl',
+                    archive: 'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz',
+                    binary: 'omx-sparkshell',
+                    binary_path: 'omx-sparkshell',
+                    sha256: 'musl',
+                    download_url: 'https://example.invalid/musl',
+                },
+            ],
+        };
+        const ordered = resolveNativeReleaseAssetCandidates(manifest, 'omx-sparkshell', '0.8.15', 'linux', 'x64', {
+            linuxLibcPreference: ['musl', 'glibc'],
+        });
+        assert.deepEqual(ordered.map((asset) => asset.archive), [
+            'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz',
+            'omx-sparkshell-x86_64-unknown-linux-gnu.tar.gz',
+        ]);
+    });
+    it('derives GitHub release base url from package.json repository + version', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-native-base-'));
+        try {
+            await writeFile(join(wd, 'package.json'), JSON.stringify({
+                version: '0.8.15',
+                repository: { url: 'git+https://github.com/Yeachan-Heo/oh-my-codex.git' },
+            }));
+            const base = await resolveNativeReleaseBaseUrl(wd, undefined, {});
+            assert.equal(base, 'https://github.com/Yeachan-Heo/oh-my-codex/releases/download/v0.8.15');
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('hydrates a native binary from the release manifest into the cache', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-native-hydrate-'));
+        const cacheDir = join(wd, 'cache');
+        const assetRoot = join(wd, 'assets');
+        try {
+            await mkdir(assetRoot, { recursive: true });
+            await writeFile(join(wd, 'package.json'), JSON.stringify({
+                version: '0.8.15',
+                repository: { url: 'git+https://github.com/Yeachan-Heo/oh-my-codex.git' },
+            }));
+            const stagingDir = join(wd, 'staging');
+            await mkdir(stagingDir, { recursive: true });
+            const binaryPath = join(stagingDir, 'omx-sparkshell');
+            await writeFile(binaryPath, '#!/bin/sh\necho hydrated\n');
+            await chmod(binaryPath, 0o755);
+            const archivePath = join(assetRoot, 'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz');
+            const archive = spawnSync('tar', ['-czf', archivePath, '-C', stagingDir, 'omx-sparkshell'], { encoding: 'utf-8' });
+            assert.equal(archive.status, 0, archive.stderr || archive.stdout);
+            const archiveBuffer = await readFile(archivePath);
+            const manifest = {
+                version: '0.8.15',
+                tag: 'v0.8.15',
+                assets: [
+                    {
+                        product: 'omx-sparkshell',
+                        version: '0.8.15',
+                        platform: 'linux',
+                        arch: 'x64',
+                        archive: 'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz',
+                        binary: 'omx-sparkshell',
+                        binary_path: 'omx-sparkshell',
+                        sha256: sha256(archiveBuffer),
+                        size: archiveBuffer.length,
+                        download_url: '',
+                    },
+                ],
+            };
+            const server = await startStaticServer(assetRoot);
+            try {
+                manifest.assets[0].download_url = `${server.baseUrl}/${manifest.assets[0].archive}`;
+                await writeFile(join(assetRoot, 'native-release-manifest.json'), JSON.stringify(manifest, null, 2));
+                const hydrated = await hydrateNativeBinary('omx-sparkshell', {
+                    packageRoot: wd,
+                    env: {
+                        OMX_NATIVE_MANIFEST_URL: `${server.baseUrl}/native-release-manifest.json`,
+                        OMX_NATIVE_CACHE_DIR: cacheDir,
+                    },
+                    platform: 'linux',
+                    arch: 'x64',
+                });
+                assert.equal(hydrated, resolveCachedNativeBinaryPath('omx-sparkshell', '0.8.15', 'linux', 'x64', {
+                    OMX_NATIVE_CACHE_DIR: cacheDir,
+                }, 'musl'));
+                assert.equal(await readFile(hydrated, 'utf-8'), '#!/bin/sh\necho hydrated\n');
+            }
+            finally {
+                await server.close();
+            }
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('hydrates a native binary when the archive wraps files in a top-level directory', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-native-hydrate-nested-'));
+        const cacheDir = join(wd, 'cache');
+        const assetRoot = join(wd, 'assets');
+        try {
+            await mkdir(assetRoot, { recursive: true });
+            await writeFile(join(wd, 'package.json'), JSON.stringify({
+                version: '0.8.15',
+                repository: { url: 'git+https://github.com/Yeachan-Heo/oh-my-codex.git' },
+            }));
+            const stagingDir = join(wd, 'staging', 'omx-sparkshell-x86_64-unknown-linux-musl');
+            await mkdir(stagingDir, { recursive: true });
+            const binaryPath = join(stagingDir, 'omx-sparkshell');
+            await writeFile(binaryPath, '#!/bin/sh\necho hydrated-nested\n');
+            await chmod(binaryPath, 0o755);
+            const archivePath = join(assetRoot, 'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz');
+            const archive = spawnSync('tar', ['-czf', archivePath, '-C', join(wd, 'staging'), 'omx-sparkshell-x86_64-unknown-linux-musl'], { encoding: 'utf-8' });
+            assert.equal(archive.status, 0, archive.stderr || archive.stdout);
+            const archiveBuffer = await readFile(archivePath);
+            const manifest = {
+                version: '0.8.15',
+                tag: 'v0.8.15',
+                assets: [
+                    {
+                        product: 'omx-sparkshell',
+                        version: '0.8.15',
+                        platform: 'linux',
+                        arch: 'x64',
+                        archive: 'omx-sparkshell-x86_64-unknown-linux-musl.tar.gz',
+                        binary: 'omx-sparkshell',
+                        binary_path: 'omx-sparkshell',
+                        sha256: sha256(archiveBuffer),
+                        size: archiveBuffer.length,
+                        download_url: '',
+                    },
+                ],
+            };
+            const server = await startStaticServer(assetRoot);
+            try {
+                manifest.assets[0].download_url = `${server.baseUrl}/${manifest.assets[0].archive}`;
+                await writeFile(join(assetRoot, 'native-release-manifest.json'), JSON.stringify(manifest, null, 2));
+                const hydrated = await hydrateNativeBinary('omx-sparkshell', {
+                    packageRoot: wd,
+                    env: {
+                        OMX_NATIVE_MANIFEST_URL: `${server.baseUrl}/native-release-manifest.json`,
+                        OMX_NATIVE_CACHE_DIR: cacheDir,
+                    },
+                    platform: 'linux',
+                    arch: 'x64',
+                });
+                assert.equal(hydrated, resolveCachedNativeBinaryPath('omx-sparkshell', '0.8.15', 'linux', 'x64', {
+                    OMX_NATIVE_CACHE_DIR: cacheDir,
+                }, 'musl'));
+                assert.equal(await readFile(hydrated, 'utf-8'), '#!/bin/sh\necho hydrated-nested\n');
+            }
+            finally {
+                await server.close();
+            }
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('returns undefined when the native release manifest is unavailable', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-native-hydrate-missing-manifest-'));
+        try {
+            await writeFile(join(wd, 'package.json'), JSON.stringify({
+                version: '0.8.15',
+                repository: { url: 'git+https://github.com/Yeachan-Heo/oh-my-codex.git' },
+            }));
+            const missingRoot = join(wd, 'missing-assets');
+            await mkdir(missingRoot, { recursive: true });
+            const server = await startStaticServer(missingRoot);
+            try {
+                const hydrated = await hydrateNativeBinary('omx-sparkshell', {
+                    packageRoot: wd,
+                    env: {
+                        OMX_NATIVE_MANIFEST_URL: `${server.baseUrl}/native-release-manifest.json`,
+                        OMX_NATIVE_CACHE_DIR: join(wd, 'cache'),
+                    },
+                    platform: 'linux',
+                    arch: 'x64',
+                });
+                assert.equal(hydrated, undefined);
+            }
+            finally {
+                await server.close();
+            }
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=native-assets.test.js.map

package/dist/cli/__tests__/native-assets.test.js.map

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

package/dist/cli/__tests__/native-hook-dispatch-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=native-hook-dispatch-contract.test.d.ts.map

package/dist/cli/__tests__/native-hook-dispatch-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-hook-dispatch-contract.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/native-hook-dispatch-contract.test.ts"],"names":[],"mappings":""}

package/dist/cli/__tests__/native-hook-dispatch-contract.test.js

@@ -0,0 +1,11 @@
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { describe, it } from 'node:test';
+describe('native hook dispatch contract', () => {
+    it('force-enables native hook dispatch in the CLI path', async () => {
+        const source = await readFile(join(process.cwd(), 'src', 'cli', 'index.ts'), 'utf-8');
+        assert.match(source, /async function emitNativeHookEvent[\s\S]*?await dispatchHookEvent\(payload,\s*\{\s*cwd,\s*enabled:\s*true,\s*\}\);/);
+    });
+});
+//# sourceMappingURL=native-hook-dispatch-contract.test.js.map

package/dist/cli/__tests__/native-hook-dispatch-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-hook-dispatch-contract.test.js","sourceRoot":"","sources":["../../../src/cli/__tests__/native-hook-dispatch-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QACtF,MAAM,CAAC,KAAK,CACV,MAAM,EACN,oHAAoH,CACrH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/__tests__/nested-help-routing.test.d.ts

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

package/dist/cli/__tests__/nested-help-routing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-help-routing.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/nested-help-routing.test.ts"],"names":[],"mappings":""}

package/dist/cli/__tests__/nested-help-routing.test.js

@@ -0,0 +1,63 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { spawnSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function runOmx(cwd, argv) {
+    const testDir = dirname(fileURLToPath(import.meta.url));
+    const repoRoot = join(testDir, '..', '..', '..');
+    const omxBin = join(repoRoot, 'dist', 'cli', 'omx.js');
+    return spawnSync(process.execPath, [omxBin, ...argv], {
+        cwd,
+        encoding: 'utf-8',
+        env: {
+            ...process.env,
+            OMX_AUTO_UPDATE: '0',
+            OMX_NOTIFY_FALLBACK: '0',
+            OMX_HOOK_DERIVED_SIGNALS: '0',
+        },
+    });
+}
+describe('nested help routing', () => {
+    for (const [argv, expectedUsage] of [
+        [['adapt', '--help'], /Usage:\s*omx adapt <target> <probe\|status\|init\|envelope\|doctor>/i],
+        [['ask', '--help'], /Usage:\s*omx ask <claude\|gemini> <question or task>/i],
+        [['question', '--help'], /omx question - OMX-owned blocking user question entrypoint/i],
+        [['autoresearch', '--help'], /hard-deprecated legacy command surface[\s\S]*\$autoresearch/i],
+        [['explore', '--help'], /hard-deprecated legacy command surface[\s\S]*omx sparkshell/i],
+        [['hud', '--help'], /Usage:\s*\n\s*omx hud\s+Show current HUD state/i],
+        [['hooks', '--help'], /Usage:\s*\n\s*omx hooks init/i],
+        [['state', '--help'], /Usage:\s*omx state <read\|write\|clear\|list-active\|get-status>/i],
+        [['mcp-serve', '--help'], /Usage:\s*omx mcp-serve <target>/i],
+        [['tmux-hook', '--help'], /Usage:\s*\n\s*omx tmux-hook init/i],
+        [['ralph', '--help'], /omx ralph - Launch Codex with ralph persistence mode active/i],
+    ]) {
+        it(`routes ${argv.join(' ')} to command-local help`, async () => {
+            const cwd = await mkdtemp(join(tmpdir(), 'omx-nested-help-'));
+            try {
+                const result = runOmx(cwd, argv);
+                assert.equal(result.status, 0, result.stderr || result.stdout);
+                assert.match(result.stdout, expectedUsage);
+                assert.doesNotMatch(result.stdout, /oh-my-codex \(omx\) - Multi-agent orchestration for Codex CLI/i);
+            }
+            finally {
+                await rm(cwd, { recursive: true, force: true });
+            }
+        });
+    }
+    it('routes `omx state read` through the top-level CLI', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-state-route-'));
+        try {
+            const result = runOmx(cwd, ['state', 'read', '--input', '{"mode":"ralph"}', '--json']);
+            assert.equal(result.status, 0, result.stderr || result.stdout);
+            assert.match(result.stdout.trim(), /^\{"exists":false,"mode":"ralph"\}$/);
+            assert.doesNotMatch(result.stdout, /Unknown command: state/i);
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=nested-help-routing.test.js.map

package/dist/cli/__tests__/nested-help-routing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-help-routing.test.js","sourceRoot":"","sources":["../../../src/cli/__tests__/nested-help-routing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,MAAM,CAAC,GAAW,EAAE,IAAc;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE;QACpD,GAAG;QACH,QAAQ,EAAE,OAAO;QACjB,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,eAAe,EAAE,GAAG;YACpB,mBAAmB,EAAE,GAAG;YACxB,wBAAwB,EAAE,GAAG;SAC9B;KACF,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,KAAK,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI;QAClC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,sEAAsE,CAAC;QAC7F,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,uDAAuD,CAAC;QAC5E,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,6DAA6D,CAAC;QACvF,CAAC,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,8DAA8D,CAAC;QAC5F,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,8DAA8D,CAAC;QACvF,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,iDAAiD,CAAC;QACtE,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,+BAA+B,CAAC;QACtD,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,mEAAmE,CAAC;QAC1F,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,kCAAkC,CAAC;QAC7D,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,mCAAmC,CAAC;QAC9D,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,8DAA8D,CAAC;KAClD,EAAE,CAAC;QACtC,EAAE,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACjC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;gBAC3C,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,gEAAgE,CAAC,CAAC;YACvG,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC;YACvF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,qCAAqC,CAAC,CAAC;YAC1E,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QAChE,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/__tests__/package-bin-contract.test.d.ts

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

package/dist/cli/__tests__/package-bin-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-bin-contract.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/package-bin-contract.test.ts"],"names":[],"mappings":""}

package/dist/cli/__tests__/package-bin-contract.test.js

@@ -0,0 +1,190 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { arch, platform, tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { getInstallableNativeAgentNames } from '../../agents/policy.js';
+import { getSetupInstallableSkillNames } from '../../catalog/installable.js';
+import { readCatalogManifest } from '../../catalog/reader.js';
+import { OMX_FIRST_PARTY_MCP_PLUGIN_TARGETS } from '../../config/omx-first-party-mcp.js';
+describe('package bin contract', () => {
+    it('declares omx with an explicit relative bin path and avoids packaging platform-specific native binaries', () => {
+        const packageJsonPath = join(process.cwd(), 'package.json');
+        const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        const binaryName = platform() === 'win32' ? 'omx-sparkshell.exe' : 'omx-sparkshell';
+        const packagedSparkShellPath = join(process.cwd(), 'bin', 'native', `${platform()}-${arch()}`, binaryName);
+        assert.deepEqual(pkg.bin, { omx: 'dist/cli/omx.js' });
+        assert.equal(pkg.scripts?.['build:explore'], 'cargo build -p omx-explore-harness');
+        assert.equal(pkg.scripts?.['build:explore:release'], 'node dist/scripts/build-explore-harness.js');
+        assert.equal(pkg.scripts?.['build:full'], 'npm run build && npm run build:explore:release && npm run build:sparkshell && npm run build:api');
+        assert.equal(pkg.scripts?.['build:api'], 'node dist/scripts/build-api.js');
+        assert.equal(pkg.scripts?.['clean:native-package-assets'], 'node dist/scripts/cleanup-explore-harness.js');
+        assert.equal(pkg.scripts?.['sync:plugin'], 'node dist/scripts/sync-plugin-mirror.js');
+        assert.equal(pkg.scripts?.['sync:plugin:check'], 'node dist/scripts/sync-plugin-mirror.js --check');
+        assert.equal(pkg.scripts?.['verify:plugin-bundle'], 'node dist/scripts/sync-plugin-mirror.js --check');
+        assert.equal(pkg.scripts?.['verify:native-agents'], 'node dist/scripts/verify-native-agents.js');
+        assert.equal(pkg.scripts?.prepack, 'npm run build && npm run verify:native-agents && npm run sync:plugin && npm run verify:plugin-bundle && npm run clean:native-package-assets');
+        assert.equal(pkg.scripts?.prepare, 'node src/scripts/prepare-build.js');
+        assert.match(pkg.scripts?.postinstall ?? '', /dist\/scripts\/postinstall\.js/);
+        assert.match(pkg.scripts?.postinstall ?? '', /existsSync/);
+        assert.equal(pkg.scripts?.postpack, 'npm run clean:native-package-assets');
+        assert.equal(pkg.scripts?.['test:explore'], 'cargo test -p omx-explore-harness && node --test dist/cli/__tests__/explore.test.js dist/hooks/__tests__/explore-routing.test.js dist/hooks/__tests__/explore-sparkshell-guidance-contract.test.js');
+        assert.equal(pkg.scripts?.['test:team:cross-rebase-smoke:compiled'], 'node dist/scripts/run-test-files.js dist/team/__tests__/cross-rebase-smoke.test.js');
+        assert.equal(pkg.scripts?.['test:node'], 'node dist/scripts/run-test-files.js dist');
+        assert.equal(pkg.scripts?.test, 'npm run build && npm run verify:native-agents && npm run verify:plugin-bundle && npm run test:node && node dist/scripts/generate-catalog-docs.js --check');
+        assert.equal(pkg.scripts?.['test:ci:compiled'], 'npm run verify:native-agents && npm run verify:plugin-bundle && npm run test:node && node dist/scripts/generate-catalog-docs.js --check');
+        assert.equal(pkg.scripts?.['coverage:team-critical'], 'npm run build && npm run coverage:team-critical:compiled');
+        assert.equal(pkg.scripts?.['coverage:team-critical:compiled'], "c8 --all --src dist/team --src dist/state --include 'dist/team/**/*.js' --include 'dist/state/**/*.js' --exclude '**/__tests__/**' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/team --check-coverage --lines=78 --functions=90 --branches=70 --statements=78 node dist/scripts/run-test-files.js dist/team/__tests__ dist/state/__tests__");
+        assert.equal(pkg.scripts?.['coverage:ts:full'], 'npm run build && npm run coverage:ts:full:compiled');
+        assert.equal(pkg.scripts?.['coverage:ts:full:compiled'], "c8 --all --src dist --exclude '**/__tests__/**' --exclude 'dist/bin/**' --exclude 'dist/**/*.d.ts' --reporter=text-summary --reporter=lcov --reporter=json-summary --report-dir coverage/ts-full node dist/scripts/run-test-files.js dist");
+        assert.equal(pkg.scripts?.['test:ralph-persistence:compiled'], 'node dist/scripts/run-test-files.js dist/cli/__tests__/session-scoped-runtime.test.js dist/mcp/__tests__/trace-server.test.js dist/hud/__tests__/state.test.js dist/mcp/__tests__/state-server-ralph-phase.test.js dist/ralph/__tests__/persistence.test.js dist/verification/__tests__/ralph-persistence-gate.test.js');
+        assert.equal(pkg.scripts?.['test:plugin-boundaries:compiled'], 'node dist/scripts/run-test-files.js dist/cli/__tests__/codex-plugin-layout.test.js dist/cli/__tests__/package-bin-contract.test.js dist/cli/__tests__/setup-hooks-shared-ownership.test.js dist/catalog/__tests__/plugin-bundle-ssot.test.js');
+        assert.equal(pkg.scripts?.['test:compat:node'], 'npm run build && node dist/scripts/run-test-files.js dist/compat/__tests__');
+        for (const scriptName of ['test:node', 'test:ci:compiled', 'coverage:team-critical', 'coverage:team-critical:compiled', 'coverage:ts:full', 'coverage:ts:full:compiled', 'test:team:cross-rebase-smoke:compiled', 'test:team:worker-runtime-identity:compiled', 'test:recent-bug-regressions:compiled', 'test:ralph-persistence:compiled', 'test:plugin-boundaries:compiled', 'test:explicit-terminal-contract:compiled', 'test:compat:node']) {
+            const script = pkg.scripts?.[scriptName];
+            assert.ok(script, `expected ${scriptName} to exist`);
+            assert.equal(script.includes('$(find '), false, `${scriptName} should not rely on POSIX command substitution`);
+            assert.equal(script.includes('*.test.js'), false, `${scriptName} should not rely on shell glob expansion`);
+        }
+        assert.equal(pkg.files?.includes('dist/'), true, 'expected package files allowlist to include dist/');
+        assert.equal(pkg.files?.includes('bin/'), false, 'did not expect broad bin/ allowlist in package files');
+        assert.equal(pkg.files?.includes('agents/'), false, 'native agent TOMLs are setup output, not package input');
+        assert.ok(pkg.files?.includes('Cargo.toml'));
+        assert.ok(pkg.files?.includes('Cargo.lock'));
+        assert.ok(pkg.files?.includes('crates/'));
+        assert.ok(pkg.files?.includes('plugins/'));
+        assert.ok(pkg.files?.includes('.agents/plugins/marketplace.json'));
+        const binPath = join(process.cwd(), 'dist', 'cli', 'omx.js');
+        const compiledCliPath = join(process.cwd(), 'dist', 'cli', 'index.js');
+        const prepareBuildSource = readFileSync(join(process.cwd(), 'src', 'scripts', 'prepare-build.js'), 'utf-8');
+        assert.match(prepareBuildSource, /dist.*cli.*omx\.js/s);
+        assert.match(prepareBuildSource, /dist.*scripts.*postinstall\.js/s);
+        assert.match(prepareBuildSource, /npm.*run.*build/s);
+        assert.match(prepareBuildSource, /--global=false/s);
+        assert.match(prepareBuildSource, /--location=project/s);
+        assert.match(prepareBuildSource, /npm_config_global.*false/s);
+        assert.match(prepareBuildSource, /npm_config_location.*project/s);
+        assert.match(prepareBuildSource, /shouldCleanupBootstrappedDependencies/s);
+        assert.match(prepareBuildSource, /hadNodeModules/s);
+        assert.match(prepareBuildSource, /nodeModulesDir/s);
+        assert.match(prepareBuildSource, /rmSync.*node_modules/s);
+        assert.match(prepareBuildSource, /--include=dev/s);
+        assert.match(prepareBuildSource, /--ignore-scripts/s);
+        const binSource = readFileSync(binPath, 'utf-8');
+        const compiledCliSource = readFileSync(compiledCliPath, 'utf-8');
+        assert.match(binSource, /^#!\/usr\/bin\/env node/);
+        const mcpInitialize = JSON.stringify({
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'initialize',
+            params: {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'package-bin-contract', version: '0' },
+            },
+        }) + '\n';
+        for (const target of OMX_FIRST_PARTY_MCP_PLUGIN_TARGETS) {
+            const mcpServe = spawnSync(process.execPath, [binPath, 'mcp-serve', target], {
+                cwd: process.cwd(),
+                encoding: 'utf-8',
+                input: mcpInitialize,
+                timeout: 5_000,
+            });
+            assert.equal(mcpServe.status, 0, `${target} stderr=${mcpServe.stderr} stdout=${mcpServe.stdout}`);
+            assert.notEqual(mcpServe.stdout.trim(), '', `omx bin wrapper must keep mcp-serve ${target} alive long enough to complete stdio initialization`);
+            const mcpResponse = JSON.parse(mcpServe.stdout);
+            assert.match(mcpResponse.result?.serverInfo?.name ?? '', /^omx-/, `${target} initialize response should include serverInfo`);
+        }
+        assert.match(compiledCliSource, /omx update\s+Install the stable channel now, then refresh setup/);
+        assert.match(compiledCliSource, /omx update --stable\s+Install\/rollback to npm stable \(oh-my-codex@latest\), then refresh setup/);
+        assert.match(compiledCliSource, /omx update --dev\s+Install the upstream dev branch, then refresh setup/);
+        assert.match(compiledCliSource, /case "update"/);
+        rmSync(packagedSparkShellPath, { force: true });
+        const packed = (() => {
+            const npmCache = mkdtempSync(join(tmpdir(), 'omx-npm-pack-cache-'));
+            try {
+                return spawnSync('npm', ['pack', '--dry-run', '--json', '--ignore-scripts'], {
+                    cwd: process.cwd(),
+                    encoding: 'utf-8',
+                    env: {
+                        ...process.env,
+                        npm_config_cache: npmCache,
+                        npm_config_update_notifier: 'false',
+                    },
+                });
+            }
+            finally {
+                rmSync(npmCache, { recursive: true, force: true });
+            }
+        })();
+        assert.equal(packed.status, 0, packed.stderr || packed.stdout);
+        const jsonStart = packed.stdout.indexOf('[');
+        assert.notEqual(jsonStart, -1, `expected npm pack --json output in stdout\n${packed.stdout}`);
+        const results = JSON.parse(packed.stdout.slice(jsonStart));
+        assert.equal(Array.isArray(results), true, 'expected npm pack --json array output');
+        const binEntry = results[0]?.files?.find((file) => file.path === 'dist/cli/omx.js');
+        assert.ok(binEntry, 'expected npm pack output to include dist/cli/omx.js');
+        const packagedHarnessPath = process.platform === 'win32' ? 'bin/omx-explore-harness.exe' : 'bin/omx-explore-harness';
+        const packagedHarnessEntry = results[0]?.files?.find((file) => file.path === packagedHarnessPath);
+        const packagedHarnessMetaEntry = results[0]?.files?.find((file) => file.path === 'bin/omx-explore-harness.meta.json');
+        const nativeBinaryEntry = results[0]?.files?.find((file) => file.path.includes('bin/native/'));
+        const cargoTomlEntry = results[0]?.files?.find((file) => file.path === 'Cargo.toml');
+        const cargoLockEntry = results[0]?.files?.find((file) => file.path === 'Cargo.lock');
+        const crateManifestEntry = results[0]?.files?.find((file) => file.path === 'crates/omx-explore/Cargo.toml');
+        const crateMainEntry = results[0]?.files?.find((file) => file.path === 'crates/omx-explore/src/main.rs');
+        const marketplaceEntry = results[0]?.files?.find((file) => file.path === '.agents/plugins/marketplace.json');
+        const pluginManifestEntry = results[0]?.files?.find((file) => file.path === 'plugins/oh-my-codex/.codex-plugin/plugin.json');
+        const pluginMcpEntry = results[0]?.files?.find((file) => file.path === 'plugins/oh-my-codex/.mcp.json');
+        const pluginAppsEntry = results[0]?.files?.find((file) => file.path === 'plugins/oh-my-codex/.app.json');
+        const pluginHooksManifestEntry = results[0]?.files?.find((file) => file.path === 'plugins/oh-my-codex/hooks/hooks.json');
+        const pluginHookLauncherEntry = results[0]?.files?.find((file) => file.path === 'plugins/oh-my-codex/hooks/codex-native-hook.mjs');
+        const stateServerEntry = results[0]?.files?.find((file) => file.path === 'dist/mcp/state-server.js');
+        const memoryServerEntry = results[0]?.files?.find((file) => file.path === 'dist/mcp/memory-server.js');
+        const codeIntelServerEntry = results[0]?.files?.find((file) => file.path === 'dist/mcp/code-intel-server.js');
+        const traceServerEntry = results[0]?.files?.find((file) => file.path === 'dist/mcp/trace-server.js');
+        const wikiServerEntry = results[0]?.files?.find((file) => file.path === 'dist/mcp/wiki-server.js');
+        const rootRalphSkillEntry = results[0]?.files?.find((file) => file.path === 'skills/ralph/SKILL.md');
+        const promptEntry = results[0]?.files?.find((file) => file.path === 'prompts/executor.md');
+        const templateEntry = results[0]?.files?.find((file) => file.path === 'templates/AGENTS.md');
+        const rootNativeAgentEntry = results[0]?.files?.find((file) => file.path === 'agents' || file.path.startsWith('agents/'));
+        const pluginScopedHooksEntry = results[0]?.files?.find((file) => file.path === 'plugins/oh-my-codex/hooks.json'
+            || file.path === 'plugins/oh-my-codex/.codex/hooks.json'
+            || file.path === 'plugins/oh-my-codex/.codex-plugin/hooks.json'
+            || file.path.startsWith('plugins/oh-my-codex/.omx/hooks/'));
+        assert.equal(packagedHarnessEntry, undefined, `did not expect ${packagedHarnessPath} in npm pack output`);
+        assert.equal(packagedHarnessMetaEntry, undefined, 'did not expect packaged explore harness metadata in npm pack output');
+        assert.equal(nativeBinaryEntry, undefined, 'did not expect staged native binaries in npm pack output');
+        assert.ok(cargoTomlEntry, 'expected npm pack output to include Cargo.toml');
+        assert.ok(cargoLockEntry, 'expected npm pack output to include Cargo.lock');
+        assert.ok(crateManifestEntry, 'expected npm pack output to include crates/omx-explore/Cargo.toml');
+        assert.ok(crateMainEntry, 'expected npm pack output to include crates/omx-explore/src/main.rs');
+        assert.ok(marketplaceEntry, 'expected npm pack output to include .agents/plugins/marketplace.json');
+        assert.ok(pluginManifestEntry, 'expected npm pack output to include plugins/oh-my-codex/.codex-plugin/plugin.json');
+        assert.ok(pluginMcpEntry, 'expected npm pack output to include plugins/oh-my-codex/.mcp.json');
+        assert.ok(pluginAppsEntry, 'expected npm pack output to include plugins/oh-my-codex/.app.json');
+        assert.ok(pluginHooksManifestEntry, 'expected npm pack output to include plugins/oh-my-codex/hooks/hooks.json');
+        assert.ok(pluginHookLauncherEntry, 'expected npm pack output to include plugins/oh-my-codex/hooks/codex-native-hook.mjs');
+        assert.ok(stateServerEntry, 'expected npm pack output to include dist/mcp/state-server.js for omx mcp-serve');
+        assert.ok(memoryServerEntry, 'expected npm pack output to include dist/mcp/memory-server.js for omx mcp-serve');
+        assert.ok(codeIntelServerEntry, 'expected npm pack output to include dist/mcp/code-intel-server.js for omx mcp-serve');
+        assert.ok(traceServerEntry, 'expected npm pack output to include dist/mcp/trace-server.js for omx mcp-serve');
+        assert.ok(wikiServerEntry, 'expected npm pack output to include dist/mcp/wiki-server.js for omx mcp-serve');
+        const packedFilePaths = new Set((results[0]?.files ?? []).map((file) => file.path));
+        const manifest = readCatalogManifest(process.cwd());
+        const installableSkillNames = [...getSetupInstallableSkillNames(manifest)].sort();
+        for (const skillName of installableSkillNames) {
+            assert.equal(packedFilePaths.has(`plugins/oh-my-codex/skills/${skillName}/SKILL.md`), true, `expected npm pack output to include mirrored plugin ${skillName} skill`);
+        }
+        const installableNativeAgentNames = [...getInstallableNativeAgentNames(manifest)].sort();
+        for (const agentName of installableNativeAgentNames) {
+            assert.equal(packedFilePaths.has(`prompts/${agentName}.md`), true, `expected npm pack output to include prompt for native agent ${agentName}`);
+        }
+        assert.ok(rootRalphSkillEntry, 'expected npm pack output to keep canonical root skills');
+        assert.ok(promptEntry, 'expected npm pack output to keep prompts');
+        assert.ok(templateEntry, 'expected npm pack output to keep templates');
+        assert.equal(rootNativeAgentEntry, undefined, 'did not expect generated root native agent TOMLs in package output');
+        assert.equal(pluginScopedHooksEntry, undefined, 'did not expect setup-owned hook assets inside the installable plugin bundle');
+    });
+});
+//# sourceMappingURL=package-bin-contract.test.js.map