oh-my-codex-pennix 0.18.13

package/dist/config/__tests__/models.test.js

@@ -0,0 +1,241 @@
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { DEFAULT_FRONTIER_MODEL, DEFAULT_SPARK_MODEL, DEFAULT_TEAM_CHILD_MODEL, getAgentReasoningOverride, getEnvConfiguredStandardDefaultModel, getMainDefaultModel, getModelForMode, getSparkDefaultModel, getStandardDefaultModel, getTeamChildModel, getTeamLowComplexityModel, readAgentReasoningOverrides, readConfiguredEnvOverrides, } from '../models.js';
+describe('getModelForMode', () => {
+    let tempDir;
+    let originalCodexHome;
+    let originalDefaultFrontierModel;
+    let originalDefaultStandardModel;
+    let originalDefaultSparkModel;
+    let originalTeamChildModel;
+    let originalSparkModel;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'omx-models-'));
+        originalCodexHome = process.env.CODEX_HOME;
+        originalDefaultFrontierModel = process.env.OMX_DEFAULT_FRONTIER_MODEL;
+        originalDefaultStandardModel = process.env.OMX_DEFAULT_STANDARD_MODEL;
+        originalDefaultSparkModel = process.env.OMX_DEFAULT_SPARK_MODEL;
+        originalTeamChildModel = process.env.OMX_TEAM_CHILD_MODEL;
+        originalSparkModel = process.env.OMX_SPARK_MODEL;
+        process.env.CODEX_HOME = tempDir;
+        delete process.env.OMX_DEFAULT_FRONTIER_MODEL;
+        delete process.env.OMX_DEFAULT_STANDARD_MODEL;
+        delete process.env.OMX_DEFAULT_SPARK_MODEL;
+        delete process.env.OMX_TEAM_CHILD_MODEL;
+        delete process.env.OMX_SPARK_MODEL;
+    });
+    afterEach(async () => {
+        if (typeof originalCodexHome === 'string') {
+            process.env.CODEX_HOME = originalCodexHome;
+        }
+        else {
+            delete process.env.CODEX_HOME;
+        }
+        if (typeof originalDefaultFrontierModel === 'string') {
+            process.env.OMX_DEFAULT_FRONTIER_MODEL = originalDefaultFrontierModel;
+        }
+        else {
+            delete process.env.OMX_DEFAULT_FRONTIER_MODEL;
+        }
+        if (typeof originalDefaultStandardModel === 'string') {
+            process.env.OMX_DEFAULT_STANDARD_MODEL = originalDefaultStandardModel;
+        }
+        else {
+            delete process.env.OMX_DEFAULT_STANDARD_MODEL;
+        }
+        if (typeof originalDefaultSparkModel === 'string') {
+            process.env.OMX_DEFAULT_SPARK_MODEL = originalDefaultSparkModel;
+        }
+        else {
+            delete process.env.OMX_DEFAULT_SPARK_MODEL;
+        }
+        if (typeof originalTeamChildModel === 'string') {
+            process.env.OMX_TEAM_CHILD_MODEL = originalTeamChildModel;
+        }
+        else {
+            delete process.env.OMX_TEAM_CHILD_MODEL;
+        }
+        if (typeof originalSparkModel === 'string') {
+            process.env.OMX_SPARK_MODEL = originalSparkModel;
+        }
+        else {
+            delete process.env.OMX_SPARK_MODEL;
+        }
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    async function writeConfig(config) {
+        await writeFile(join(tempDir, '.omx-config.json'), JSON.stringify(config));
+    }
+    it('returns frontier default when config file does not exist', () => {
+        assert.equal(getModelForMode('team'), DEFAULT_FRONTIER_MODEL);
+    });
+    it('returns frontier default when config has no models section', async () => {
+        await writeConfig({ notifications: { enabled: false } });
+        assert.equal(getModelForMode('team'), DEFAULT_FRONTIER_MODEL);
+    });
+    it('returns mode-specific model when configured', async () => {
+        await writeConfig({ models: { team: 'gpt-4.1', default: 'o4-mini' } });
+        assert.equal(getModelForMode('team'), 'gpt-4.1');
+    });
+    it('falls back to default when mode-specific model is not set', async () => {
+        await writeConfig({ models: { default: 'o4-mini' } });
+        assert.equal(getModelForMode('team'), 'o4-mini');
+    });
+    it('returns frontier default when models section is empty', async () => {
+        await writeConfig({ models: {} });
+        assert.equal(getModelForMode('team'), DEFAULT_FRONTIER_MODEL);
+    });
+    it('ignores empty string values and falls back to default', async () => {
+        await writeConfig({ models: { team: '', default: 'o4-mini' } });
+        assert.equal(getModelForMode('team'), 'o4-mini');
+    });
+    it('trims whitespace from model values', async () => {
+        await writeConfig({ models: { team: '  gpt-4.1  ' } });
+        assert.equal(getModelForMode('team'), 'gpt-4.1');
+    });
+    it('resolves different modes independently', async () => {
+        await writeConfig({ models: { team: 'gpt-4.1', autopilot: 'o4-mini', ralph: 'gpt-5' } });
+        assert.equal(getModelForMode('team'), 'gpt-4.1');
+        assert.equal(getModelForMode('autopilot'), 'o4-mini');
+        assert.equal(getModelForMode('ralph'), 'gpt-5');
+    });
+    it('returns frontier default for invalid models section (array)', async () => {
+        await writeConfig({ models: ['not', 'valid'] });
+        assert.equal(getModelForMode('team'), DEFAULT_FRONTIER_MODEL);
+    });
+    it('returns frontier default for malformed JSON', async () => {
+        await writeFile(join(tempDir, '.omx-config.json'), 'not-json');
+        assert.equal(getModelForMode('team'), DEFAULT_FRONTIER_MODEL);
+    });
+    it('uses OMX_DEFAULT_FRONTIER_MODEL when config does not provide a value', () => {
+        process.env.OMX_DEFAULT_FRONTIER_MODEL = 'gpt-5.4-mini';
+        assert.equal(getMainDefaultModel(), 'gpt-5.4-mini');
+        assert.equal(getModelForMode('team'), 'gpt-5.4-mini');
+    });
+    it('uses .omx-config.json env.OMX_DEFAULT_FRONTIER_MODEL when shell env is absent', async () => {
+        await writeConfig({ env: { OMX_DEFAULT_FRONTIER_MODEL: 'frontier-local' } });
+        assert.equal(getMainDefaultModel(), 'frontier-local');
+        assert.equal(getModelForMode('team'), 'frontier-local');
+    });
+    it('uses config.toml root model as the main and standard default when env overrides are absent', async () => {
+        await writeFile(join(tempDir, 'config.toml'), 'model = "frontier-config"\n');
+        assert.equal(getMainDefaultModel(), 'frontier-config');
+        assert.equal(getStandardDefaultModel(), 'frontier-config');
+        assert.equal(getModelForMode('team'), 'frontier-config');
+    });
+    it('uses OMX_DEFAULT_STANDARD_MODEL when configured in shell env', () => {
+        process.env.OMX_DEFAULT_STANDARD_MODEL = 'gpt-5.4-mini-tuned';
+        assert.equal(getEnvConfiguredStandardDefaultModel(), 'gpt-5.4-mini-tuned');
+        assert.equal(getStandardDefaultModel(), 'gpt-5.4-mini-tuned');
+    });
+    it('uses .omx-config.json env.OMX_DEFAULT_STANDARD_MODEL when shell env is absent', async () => {
+        await writeConfig({ env: { OMX_DEFAULT_STANDARD_MODEL: 'standard-local' } });
+        assert.equal(getEnvConfiguredStandardDefaultModel(), 'standard-local');
+        assert.equal(getStandardDefaultModel(), 'standard-local');
+    });
+    it('prefers shell OMX_DEFAULT_FRONTIER_MODEL over .omx-config.json env override', async () => {
+        process.env.OMX_DEFAULT_FRONTIER_MODEL = 'frontier-shell';
+        await writeConfig({ env: { OMX_DEFAULT_FRONTIER_MODEL: 'frontier-local' } });
+        assert.equal(getMainDefaultModel(), 'frontier-shell');
+    });
+    it('keeps explicit config default ahead of OMX_DEFAULT_FRONTIER_MODEL', async () => {
+        process.env.OMX_DEFAULT_FRONTIER_MODEL = 'gpt-5.4-mini';
+        await writeConfig({ models: { default: 'o4-mini' } });
+        assert.equal(getModelForMode('team'), 'o4-mini');
+    });
+    it('keeps explicit mode config ahead of OMX_DEFAULT_FRONTIER_MODEL', async () => {
+        process.env.OMX_DEFAULT_FRONTIER_MODEL = 'gpt-5.4-mini';
+        await writeConfig({ models: { team: 'gpt-4.1', default: 'o4-mini' } });
+        assert.equal(getModelForMode('team'), 'gpt-4.1');
+    });
+    it('defaults team child model to standard mini independent of frontier defaults', () => {
+        process.env.OMX_DEFAULT_FRONTIER_MODEL = 'frontier-expensive';
+        assert.equal(DEFAULT_TEAM_CHILD_MODEL, 'gpt-5.4-mini');
+        assert.equal(getTeamChildModel(), 'gpt-5.4-mini');
+    });
+    it('uses OMX_TEAM_CHILD_MODEL shell override for team child model', () => {
+        process.env.OMX_TEAM_CHILD_MODEL = 'team-child-custom';
+        assert.equal(getTeamChildModel(), 'team-child-custom');
+    });
+    it('uses .omx-config.json env.OMX_TEAM_CHILD_MODEL when shell env is absent', async () => {
+        await writeConfig({ env: { OMX_TEAM_CHILD_MODEL: 'team-child-local' } });
+        assert.equal(getTeamChildModel(), 'team-child-local');
+    });
+    it('returns low-complexity team model when configured', async () => {
+        await writeConfig({ models: { team_low_complexity: 'gpt-4.1-mini' } });
+        assert.equal(getTeamLowComplexityModel(), 'gpt-4.1-mini');
+    });
+    it('uses OMX_DEFAULT_SPARK_MODEL when low-complexity config is absent', async () => {
+        process.env.OMX_DEFAULT_SPARK_MODEL = 'gpt-5.3-codex-spark-fast';
+        await writeConfig({ models: { team: 'gpt-4.1' } });
+        assert.equal(getSparkDefaultModel(), 'gpt-5.3-codex-spark-fast');
+        assert.equal(getTeamLowComplexityModel(), 'gpt-5.3-codex-spark-fast');
+    });
+    it('uses .omx-config.json env.OMX_DEFAULT_SPARK_MODEL when shell env is absent', async () => {
+        await writeConfig({ env: { OMX_DEFAULT_SPARK_MODEL: 'spark-local' }, models: { team: 'gpt-4.1' } });
+        assert.equal(getSparkDefaultModel(), 'spark-local');
+    });
+    it('falls back to legacy OMX_SPARK_MODEL when canonical spark env is absent', async () => {
+        process.env.OMX_SPARK_MODEL = 'gpt-5.3-codex-spark-fast';
+        await writeConfig({ models: { team: 'gpt-4.1' } });
+        assert.equal(getSparkDefaultModel(), 'gpt-5.3-codex-spark-fast');
+        assert.equal(getTeamLowComplexityModel(), 'gpt-5.3-codex-spark-fast');
+    });
+    it('prefers OMX_DEFAULT_SPARK_MODEL over legacy OMX_SPARK_MODEL', () => {
+        process.env.OMX_DEFAULT_SPARK_MODEL = 'spark-canonical';
+        process.env.OMX_SPARK_MODEL = 'spark-legacy';
+        assert.equal(getSparkDefaultModel(), 'spark-canonical');
+    });
+    it('reads normalized env overrides from .omx-config.json', async () => {
+        await writeConfig({
+            env: {
+                OMX_DEFAULT_FRONTIER_MODEL: ' frontier-local ',
+                OMX_DEFAULT_STANDARD_MODEL: ' standard-local ',
+                OMX_DEFAULT_SPARK_MODEL: ' spark-local ',
+                EMPTY: '   ',
+            },
+        });
+        assert.deepEqual(readConfiguredEnvOverrides(), {
+            OMX_DEFAULT_FRONTIER_MODEL: 'frontier-local',
+            OMX_DEFAULT_STANDARD_MODEL: 'standard-local',
+            OMX_DEFAULT_SPARK_MODEL: 'spark-local',
+        });
+    });
+    it('reads normalized per-agent reasoning overrides from .omx-config.json', async () => {
+        await writeConfig({
+            agentReasoning: {
+                Architect: ' xhigh ',
+                critic: 'high',
+                executor: 'invalid',
+                'bad role': 'low',
+                empty: '   ',
+            },
+        });
+        assert.deepEqual(readAgentReasoningOverrides(), {
+            architect: 'xhigh',
+            critic: 'high',
+        });
+        assert.equal(getAgentReasoningOverride('ARCHITECT'), 'xhigh');
+        assert.equal(getAgentReasoningOverride('executor'), undefined);
+    });
+    it('keeps explicit low-complexity config ahead of OMX_DEFAULT_SPARK_MODEL', async () => {
+        process.env.OMX_DEFAULT_SPARK_MODEL = 'gpt-5.3-codex-spark-fast';
+        await writeConfig({ models: { team_low_complexity: 'gpt-4.1-mini' } });
+        assert.equal(getTeamLowComplexityModel(), 'gpt-4.1-mini');
+    });
+    it('inherits the main default for standard agents when no standard override is configured', async () => {
+        process.env.OMX_DEFAULT_FRONTIER_MODEL = 'gpt-5.5-custom';
+        await writeConfig({ models: { team: 'gpt-4.1' } });
+        assert.equal(getStandardDefaultModel(), 'gpt-5.5-custom');
+    });
+    it('returns canonical spark fallback when not configured', async () => {
+        await writeConfig({ models: { team: 'gpt-4.1' } });
+        assert.equal(getStandardDefaultModel(), DEFAULT_FRONTIER_MODEL);
+        assert.equal(getSparkDefaultModel(), DEFAULT_SPARK_MODEL);
+        assert.equal(getTeamLowComplexityModel(), DEFAULT_SPARK_MODEL);
+    });
+});
+//# sourceMappingURL=models.test.js.map

package/dist/config/__tests__/models.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.test.js","sourceRoot":"","sources":["../../../src/config/__tests__/models.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,EACpC,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,OAAe,CAAC;IACpB,IAAI,iBAAqC,CAAC;IAC1C,IAAI,4BAAgD,CAAC;IACrD,IAAI,4BAAgD,CAAC;IACrD,IAAI,yBAA6C,CAAC;IAClD,IAAI,sBAA0C,CAAC;IAC/C,IAAI,kBAAsC,CAAC;IAE3C,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;QACvD,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAC3C,4BAA4B,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QACtE,4BAA4B,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QACtE,yBAAyB,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAChE,sBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC1D,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QACxC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,iBAAiB,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAChC,CAAC;QACD,IAAI,OAAO,4BAA4B,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,4BAA4B,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,4BAA4B,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,4BAA4B,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,yBAAyB,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,yBAAyB,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,sBAAsB,KAAK,QAAQ,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,sBAAsB,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,kBAAkB,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QACrC,CAAC;QACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,WAAW,CAAC,MAA+B;QACxD,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,WAAW,CAAC,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,cAAc,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;QAC1G,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAE7E,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,iBAAiB,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,oBAAoB,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,gBAAgB,CAAC;QAC1D,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,cAAc,CAAC;QACxD,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,cAAc,CAAC;QACxD,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAIH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,oBAAoB,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,mBAAmB,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,kBAAkB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,cAAc,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,0BAA0B,CAAC;QACjE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,0BAA0B,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,0BAA0B,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,uBAAuB,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACpG,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,aAAa,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,0BAA0B,CAAC;QACzD,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,0BAA0B,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,0BAA0B,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,iBAAiB,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,cAAc,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,WAAW,CAAC;YAChB,GAAG,EAAE;gBACH,0BAA0B,EAAE,kBAAkB;gBAC9C,0BAA0B,EAAE,kBAAkB;gBAC9C,uBAAuB,EAAE,eAAe;gBACxC,KAAK,EAAE,KAAK;aACb;SACF,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,0BAA0B,EAAE,EAAE;YAC7C,0BAA0B,EAAE,gBAAgB;YAC5C,0BAA0B,EAAE,gBAAgB;YAC5C,uBAAuB,EAAE,aAAa;SACvC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,WAAW,CAAC;YAChB,cAAc,EAAE;gBACd,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,SAAS;gBACnB,UAAU,EAAE,KAAK;gBACjB,KAAK,EAAE,KAAK;aACb;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,2BAA2B,EAAE,EAAE;YAC9C,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,0BAA0B,CAAC;QACjE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,cAAc,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uFAAuF,EAAE,KAAK,IAAI,EAAE;QACrG,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,gBAAgB,CAAC;QAC1D,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,sBAAsB,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config/__tests__/wiki-config-contract.test.d.ts

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

package/dist/config/__tests__/wiki-config-contract.test.d.ts.map

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

package/dist/config/__tests__/wiki-config-contract.test.js

@@ -0,0 +1,23 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { loadSurface } from "../../hooks/__tests__/prompt-guidance-test-helpers.js";
+describe("project wiki config/generator documentation contract", () => {
+    it("documents CLI-first wiki access with explicit MCP compatibility", () => {
+        const doc = loadSurface("docs/reference/project-wiki.md");
+        assert.match(doc, /CLI-first JSON parity surface/i);
+        assert.match(doc, /`omx wiki <tool> --input <json> --json`/);
+        assert.match(doc, /\[mcp_servers\.omx_wiki\]/);
+        assert.match(doc, /dist\/mcp\/wiki-server\.js/);
+        assert.match(doc, /explicit compat mode/i);
+        assert.match(doc, /must not appear in default CLI-first setup/i);
+        assert.match(doc, /bootstrap\/config path should treat `omx_wiki` as a first-party OMX compatibility server/i);
+    });
+    it("documents the OMX-native storage path instead of legacy OMC storage", () => {
+        const doc = loadSurface("docs/reference/project-wiki.md");
+        assert.match(doc, /Wiki state is project-local and should live under/i);
+        assert.match(doc, /`omx_wiki\/\*\.md`/);
+        assert.match(doc, /legacy `\.omx\/wiki\/`/i);
+        assert.match(doc, /The docs and code should never regress back to `\.omc\/wiki\/`/);
+    });
+});
+//# sourceMappingURL=wiki-config-contract.test.js.map

package/dist/config/__tests__/wiki-config-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-config-contract.test.js","sourceRoot":"","sources":["../../../src/config/__tests__/wiki-config-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,uDAAuD,CAAC;AAEpF,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;IACpE,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,GAAG,GAAG,WAAW,CAAC,gCAAgC,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,2FAA2F,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,GAAG,GAAG,WAAW,CAAC,gCAAgC,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gEAAgE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config/codex-feature-flags.d.ts

@@ -0,0 +1,25 @@
+export declare const CODEX_HOOK_FEATURE_FLAGS: readonly ["hooks", "codex_hooks"];
+export declare const CODEX_PLUGIN_SCOPED_HOOKS_FEATURE_FLAG = "plugin_hooks";
+export type CodexHookFeatureFlag = (typeof CODEX_HOOK_FEATURE_FLAGS)[number];
+/**
+ * Current Codex CLI releases expose lifecycle hooks as `[features].hooks`.
+ * Older releases used `[features].codex_hooks`. Keep the default on the
+ * current canonical name while allowing setup to probe and select the legacy
+ * spelling when it is the only feature reported by the installed Codex.
+ */
+export declare const DEFAULT_CODEX_HOOK_FEATURE_FLAG: CodexHookFeatureFlag;
+export declare function isCodexHookFeatureFlagName(name: string): name is CodexHookFeatureFlag;
+export declare function normalizeCodexHookFeatureFlag(value: string | null | undefined): CodexHookFeatureFlag;
+export declare function parseCodexFeatureNames(featuresListOutput: string | null | undefined): Set<string>;
+export declare function parseCodexCliVersion(versionOutput: string | null | undefined): [number, number, number] | null;
+export declare function isCodexCliVersionAtLeast(versionOutput: string | null | undefined, minimum: [number, number, number]): boolean;
+export declare function supportsCodexPluginScopedHooks(options?: {
+    featuresListOutput?: string | null;
+}): boolean;
+export declare function resolveCodexHookFeatureFlag(options?: {
+    featuresListOutput?: string | null;
+    versionOutput?: string | null;
+    fallback?: CodexHookFeatureFlag;
+}): CodexHookFeatureFlag;
+export declare function formatCodexHookFeatureFlagLine(featureFlag: CodexHookFeatureFlag): string;
+//# sourceMappingURL=codex-feature-flags.d.ts.map

package/dist/config/codex-feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-feature-flags.d.ts","sourceRoot":"","sources":["../../src/config/codex-feature-flags.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,mCAAoC,CAAC;AAC1E,eAAO,MAAM,sCAAsC,iBAAiB,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,oBAA8B,CAAC;AAE7E,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,GACX,IAAI,IAAI,oBAAoB,CAE9B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,oBAAoB,CAEtB;AAED,wBAAgB,sBAAsB,CACpC,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5C,GAAG,CAAC,MAAM,CAAC,CAOb;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAIjC;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAQT;AAED,wBAAgB,8BAA8B,CAAC,OAAO,GAAE;IACtD,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,OAAO,CAIf;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE;IACnD,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC5B,GAAG,oBAAoB,CAW5B;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,oBAAoB,GAChC,MAAM,CAER"}

package/dist/config/codex-feature-flags.js

@@ -0,0 +1,60 @@
+export const CODEX_HOOK_FEATURE_FLAGS = ["hooks", "codex_hooks"];
+export const CODEX_PLUGIN_SCOPED_HOOKS_FEATURE_FLAG = "plugin_hooks";
+/**
+ * Current Codex CLI releases expose lifecycle hooks as `[features].hooks`.
+ * Older releases used `[features].codex_hooks`. Keep the default on the
+ * current canonical name while allowing setup to probe and select the legacy
+ * spelling when it is the only feature reported by the installed Codex.
+ */
+export const DEFAULT_CODEX_HOOK_FEATURE_FLAG = "hooks";
+export function isCodexHookFeatureFlagName(name) {
+    return CODEX_HOOK_FEATURE_FLAGS.includes(name);
+}
+export function normalizeCodexHookFeatureFlag(value) {
+    return value === "codex_hooks" ? "codex_hooks" : DEFAULT_CODEX_HOOK_FEATURE_FLAG;
+}
+export function parseCodexFeatureNames(featuresListOutput) {
+    const names = new Set();
+    for (const rawLine of (featuresListOutput ?? "").split(/\r?\n/)) {
+        const match = rawLine.trim().match(/^([A-Za-z0-9_]+)\s+/);
+        if (match)
+            names.add(match[1]);
+    }
+    return names;
+}
+export function parseCodexCliVersion(versionOutput) {
+    const match = (versionOutput ?? "").match(/\b(\d+)\.(\d+)\.(\d+)\b/);
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+export function isCodexCliVersionAtLeast(versionOutput, minimum) {
+    const parsed = parseCodexCliVersion(versionOutput);
+    if (!parsed)
+        return false;
+    for (let i = 0; i < minimum.length; i++) {
+        if (parsed[i] > minimum[i])
+            return true;
+        if (parsed[i] < minimum[i])
+            return false;
+    }
+    return true;
+}
+export function supportsCodexPluginScopedHooks(options = {}) {
+    return parseCodexFeatureNames(options.featuresListOutput).has(CODEX_PLUGIN_SCOPED_HOOKS_FEATURE_FLAG);
+}
+export function resolveCodexHookFeatureFlag(options = {}) {
+    const featureNames = parseCodexFeatureNames(options.featuresListOutput);
+    if (featureNames.has("hooks"))
+        return "hooks";
+    if (featureNames.has("codex_hooks"))
+        return "codex_hooks";
+    if (isCodexCliVersionAtLeast(options.versionOutput, [0, 130, 0])) {
+        return "hooks";
+    }
+    return options.fallback ?? DEFAULT_CODEX_HOOK_FEATURE_FLAG;
+}
+export function formatCodexHookFeatureFlagLine(featureFlag) {
+    return `${normalizeCodexHookFeatureFlag(featureFlag)} = true`;
+}
+//# sourceMappingURL=codex-feature-flags.js.map

package/dist/config/codex-feature-flags.js.map

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

package/dist/config/codex-hooks.d.ts

@@ -0,0 +1,79 @@
+export declare const MANAGED_HOOK_EVENTS: readonly ["SessionStart", "PreToolUse", "PostToolUse", "UserPromptSubmit", "PreCompact", "PostCompact", "Stop"];
+type ManagedHookEventName = (typeof MANAGED_HOOK_EVENTS)[number];
+type JsonObject = Record<string, unknown>;
+export interface ManagedHookEntry {
+    matcher?: string;
+    hooks: Array<{
+        type: "command";
+        command: string;
+        statusMessage?: string;
+        timeout?: number;
+    }>;
+}
+export interface ManagedCodexHooksConfig {
+    hooks: Record<ManagedHookEventName, ManagedHookEntry[]>;
+}
+interface ParsedCodexHooksConfig {
+    root: JsonObject;
+    hooks: JsonObject;
+}
+export interface RemoveManagedCodexHooksResult {
+    nextContent: string | null;
+    removedCount: number;
+}
+export interface ManagedCodexHookTrustState {
+    trusted_hash: string;
+}
+export interface DedupedCodexHookConfigPath {
+    path: string;
+    reason: "unique";
+}
+export interface SkippedCodexHookConfigPath {
+    path: string;
+    reason: "runtime_codex_home_mirror" | "duplicate_realpath";
+    canonicalPath?: string;
+}
+export interface DiscoverCodexHookConfigPathsOptions {
+    maxFiles?: number;
+}
+type HookCommandPlatform = NodeJS.Platform;
+export declare function escapeTomlBasicString(value: string): string;
+export declare const WINDOWS_NATIVE_HOOK_SHIM_RELATIVE_PATH: readonly ["hooks", "omx-native-hook-windows-shim.ps1"];
+export interface ManagedCodexHookOptions {
+    platform?: HookCommandPlatform;
+    codexHomeDir?: string;
+    nodePath?: string;
+    hookScriptPath?: string;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Resolve an absolute path to Windows PowerShell. When PATH has been shortened
+ * (e.g. by a runtime shim that dropped System32), a bare `powershell.exe` fails
+ * to resolve, so prefer SystemRoot/windir and fall back to the well-known
+ * default install location.
+ */
+export declare function resolveWindowsPowerShellPath(env?: NodeJS.ProcessEnv): string;
+export declare function buildManagedCodexNativeHookWindowsShimPath(codexHomeDir: string): string;
+export declare function buildManagedCodexNativeHookWindowsShimContent(pkgRoot: string, options?: Pick<ManagedCodexHookOptions, "hookScriptPath" | "nodePath">): string;
+export declare function buildManagedCodexNativeHookCommand(pkgRoot: string, optionsOrPlatform?: HookCommandPlatform | ManagedCodexHookOptions): string;
+export declare function buildManagedCodexHooksConfig(pkgRoot: string, options?: ManagedCodexHookOptions): ManagedCodexHooksConfig;
+export declare function parseCodexHooksConfig(content: string): ParsedCodexHooksConfig | null;
+export declare function getMissingManagedCodexHookEvents(content: string): ManagedHookEventName[] | null;
+export declare function getManagedCodexHookCommandsForEvent(content: string, eventName: ManagedHookEventName): string[] | null;
+export declare function buildManagedCodexHookTrustState(hooksPath: string, pkgRoot: string, options?: ManagedCodexHookOptions): Record<string, ManagedCodexHookTrustState>;
+export declare function buildManagedCodexHookTrustToml(hooksPath: string | undefined, pkgRoot: string, options?: ManagedCodexHookOptions): string;
+export declare function isRuntimeCodexHomeMirrorPath(hookConfigPath: string, cwd?: string): boolean;
+export declare function dedupeCodexHookConfigPaths(hookConfigPaths: readonly string[], cwd?: string): Promise<{
+    paths: DedupedCodexHookConfigPath[];
+    skipped: SkippedCodexHookConfigPath[];
+}>;
+export declare function discoverCodexHookConfigPaths(cwd?: string, options?: DiscoverCodexHookConfigPathsOptions): Promise<{
+    paths: DedupedCodexHookConfigPath[];
+    skipped: SkippedCodexHookConfigPath[];
+}>;
+export declare function mergeManagedCodexHooksConfig(existingContent: string | null | undefined, pkgRoot: string, hooksPathOrOptions?: string | ManagedCodexHookOptions, options?: ManagedCodexHookOptions): string;
+export declare function removeManagedCodexHooks(existingContent: string): RemoveManagedCodexHooksResult;
+export declare function hasCodexHookEntries(content: string): boolean;
+export declare function hasUserCodexHooksAfterManagedRemoval(existingContent: string): boolean;
+export {};
+//# sourceMappingURL=codex-hooks.d.ts.map

package/dist/config/codex-hooks.d.ts.map

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