agent-switchboard 0.4.12 → 0.4.16

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

@@ -0,0 +1,26 @@
+/**
+ * Codex hook distribution: writes hooks.json and copies bundle files.
+ *
+ * Codex reads hooks from ~/.codex/hooks.json (global) and
+ * <project>/.codex/hooks.json (project scope). Unlike Claude Code which
+ * embeds hooks inside settings.json, Codex uses a dedicated file.
+ *
+ * Codex only supports: command handlers, 5 event types, no ${HOOK_DIR}
+ * runtime expansion. ASB must filter unsupported entries and rewrite
+ * bundle paths to absolute paths before writing.
+ */
+import type { ConfigScope } from '../config/scope.js';
+import type { DistributionResult } from '../library/distribute.js';
+import type { BundleDistributionResult } from '../library/distribute-bundle.js';
+import type { HookEntry } from './library.js';
+type CodexPlatform = 'codex';
+export interface CodexHookDistributeOptions {
+    scope?: ConfigScope;
+    selected: readonly HookEntry[];
+    dryRun?: boolean;
+    projectMode?: 'managed' | 'exclusive' | 'none';
+}
+export declare function distributeCodexHooks(options: CodexHookDistributeOptions): {
+    results: Array<DistributionResult<CodexPlatform> | BundleDistributionResult<CodexPlatform>>;
+};
+export {};

package/dist/hooks/codex-distribute.js

@@ -0,0 +1,370 @@
+/**
+ * Codex hook distribution: writes hooks.json and copies bundle files.
+ *
+ * Codex reads hooks from ~/.codex/hooks.json (global) and
+ * <project>/.codex/hooks.json (project scope). Unlike Claude Code which
+ * embeds hooks inside settings.json, Codex uses a dedicated file.
+ *
+ * Codex only supports: command handlers, 5 event types, no ${HOOK_DIR}
+ * runtime expansion. ASB must filter unsupported entries and rewrite
+ * bundle paths to absolute paths before writing.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { ensureTrustEntry } from '../agents/codex.js';
+import { getCodexConfigPath, getCodexDir, getCodexHooksJsonPath, getProjectCodexDir, getProjectCodexHooksJsonPath, } from '../config/paths.js';
+import { distributeBundle } from '../library/distribute-bundle.js';
+import { ensureParentDir, rmDirRecursive } from '../library/fs.js';
+import { listHookBundleFiles } from './library.js';
+import { HOOK_DIR_PLACEHOLDER } from './schema.js';
+const CODEX_SUPPORTED_EVENTS = new Set([
+    'PreToolUse',
+    'PostToolUse',
+    'SessionStart',
+    'UserPromptSubmit',
+    'Stop',
+]);
+const CODEX_SUPPORTED_HANDLER_TYPES = new Set(['command']);
+// biome-ignore lint/suspicious/noTemplateCurlyInString: intentional literal placeholder
+const CLAUDE_PLUGIN_ROOT_HOOKS_PREFIX = '${CLAUDE_PLUGIN_ROOT}/hooks';
+// biome-ignore lint/suspicious/noTemplateCurlyInString: intentional literal placeholder
+const CLAUDE_PLUGIN_ROOT_HOOKS_PREFIX_WINDOWS = '${CLAUDE_PLUGIN_ROOT}\\hooks';
+const ASB_MANAGED_KEY = '_asb_managed_hooks';
+const ASB_HOOKS_SUBDIR = 'asb';
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function resolveHooksJsonPath(scope) {
+    const projectRoot = scope?.project?.trim();
+    if (projectRoot && projectRoot.length > 0) {
+        return getProjectCodexHooksJsonPath(projectRoot);
+    }
+    return getCodexHooksJsonPath();
+}
+function resolveHooksBundleParentDir(scope) {
+    const projectRoot = scope?.project?.trim();
+    if (projectRoot && projectRoot.length > 0) {
+        return path.join(getProjectCodexDir(projectRoot), 'hooks', ASB_HOOKS_SUBDIR);
+    }
+    return path.join(getCodexDir(), 'hooks', ASB_HOOKS_SUBDIR);
+}
+function resolveHookBundleTargetDir(entry, scope) {
+    return path.join(resolveHooksBundleParentDir(scope), entry.id);
+}
+// ---------------------------------------------------------------------------
+// Portable path helpers
+// ---------------------------------------------------------------------------
+function preferHomeVar(command) {
+    const home = os.homedir();
+    if (!command.includes(home))
+        return command;
+    return command.replaceAll(home, '$HOME');
+}
+function filterForCodex(entries) {
+    const result = [];
+    for (const entry of entries) {
+        const filteredHooks = {};
+        for (const [event, groups] of Object.entries(entry.hooks)) {
+            if (!CODEX_SUPPORTED_EVENTS.has(event))
+                continue;
+            const filteredGroups = [];
+            for (const group of groups) {
+                const filteredHandlers = (group.hooks ?? []).filter((h) => CODEX_SUPPORTED_HANDLER_TYPES.has(h.type ?? ''));
+                if (filteredHandlers.length > 0) {
+                    filteredGroups.push({ ...group, hooks: filteredHandlers });
+                }
+            }
+            if (filteredGroups.length > 0) {
+                filteredHooks[event] = filteredGroups;
+            }
+        }
+        if (Object.keys(filteredHooks).length > 0) {
+            result.push({ entry, hooks: filteredHooks });
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// hooks.json I/O
+// ---------------------------------------------------------------------------
+function readHooksJson(filePath) {
+    try {
+        if (fs.existsSync(filePath)) {
+            return {
+                ok: true,
+                data: JSON.parse(fs.readFileSync(filePath, 'utf-8')),
+            };
+        }
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    return { ok: true, data: {} };
+}
+function writeHooksJson(filePath, data) {
+    ensureParentDir(filePath);
+    fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Config merge
+// ---------------------------------------------------------------------------
+function rewriteHookDir(hooks, distributedDir) {
+    const result = {};
+    for (const [event, groups] of Object.entries(hooks)) {
+        result[event] = groups.map((group) => ({
+            ...group,
+            hooks: (group.hooks ?? []).map((handler) => {
+                if (typeof handler.command !== 'string')
+                    return handler;
+                return {
+                    ...handler,
+                    command: preferHomeVar(handler.command
+                        .replaceAll(HOOK_DIR_PLACEHOLDER, distributedDir)
+                        .replaceAll(CLAUDE_PLUGIN_ROOT_HOOKS_PREFIX, distributedDir)
+                        .replaceAll(CLAUDE_PLUGIN_ROOT_HOOKS_PREFIX_WINDOWS, distributedDir)),
+                };
+            }),
+        }));
+    }
+    return result;
+}
+function mergeHooksIntoFile(fileData, filteredEntries, scope) {
+    const existingHooks = (fileData.hooks ?? {});
+    // Remove previously ASB-managed matcher groups
+    const cleanedHooks = {};
+    for (const [event, groups] of Object.entries(existingHooks)) {
+        const kept = groups.filter((g) => g._asb_source !== true);
+        if (kept.length > 0)
+            cleanedHooks[event] = kept;
+    }
+    // Merge filtered entries
+    for (const { entry, hooks } of filteredEntries) {
+        const resolvedHooks = entry.isBundle
+            ? rewriteHookDir(hooks, resolveHookBundleTargetDir(entry, scope))
+            : hooks;
+        for (const [event, groups] of Object.entries(resolvedHooks)) {
+            if (!cleanedHooks[event])
+                cleanedHooks[event] = [];
+            for (const group of groups) {
+                cleanedHooks[event].push({ ...group, _asb_source: true });
+            }
+        }
+    }
+    fileData.hooks = cleanedHooks;
+    fileData[ASB_MANAGED_KEY] = filteredEntries.map((f) => f.entry.id);
+}
+// ---------------------------------------------------------------------------
+// Orphan cleanup for bundles
+// ---------------------------------------------------------------------------
+function cleanOrphanBundleDirs(activeIds, scope, dryRun) {
+    const parentDir = resolveHooksBundleParentDir(scope);
+    const results = [];
+    if (!fs.existsSync(parentDir))
+        return results;
+    try {
+        const entries = fs.readdirSync(parentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (activeIds.has(entry.name))
+                continue;
+            const dirPath = path.join(parentDir, entry.name);
+            try {
+                if (!dryRun)
+                    rmDirRecursive(dirPath);
+                results.push({
+                    platform: 'codex',
+                    targetDir: dirPath,
+                    status: 'deleted',
+                    reason: 'orphan',
+                    entryId: entry.name,
+                });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                results.push({
+                    platform: 'codex',
+                    targetDir: dirPath,
+                    status: 'error',
+                    error: `Failed to delete orphan: ${msg}`,
+                    entryId: entry.name,
+                });
+            }
+        }
+    }
+    catch {
+        // Ignore directory read errors
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Codex prerequisites: feature flag + project trust
+// ---------------------------------------------------------------------------
+function ensureCodexHooksFeature(results) {
+    const configPath = getCodexConfigPath();
+    if (!fs.existsSync(configPath))
+        return;
+    const content = fs.readFileSync(configPath, 'utf-8');
+    if (content.includes('codex_hooks') && content.includes('true'))
+        return;
+    // Feature not explicitly enabled - add warning result
+    results.push({
+        platform: 'codex',
+        filePath: configPath,
+        status: 'written',
+        reason: 'codex_hooks feature flag may not be enabled in config.toml',
+    });
+}
+function ensureProjectTrust(projectRoot, results) {
+    const globalPath = getCodexConfigPath();
+    const globalContent = fs.existsSync(globalPath) ? fs.readFileSync(globalPath, 'utf-8') : '';
+    const trustResult = ensureTrustEntry(globalContent, projectRoot);
+    if (trustResult.warning) {
+        results.push({
+            platform: 'codex',
+            filePath: globalPath,
+            status: 'skipped',
+            reason: trustResult.warning,
+        });
+    }
+    if (trustResult.changed) {
+        ensureParentDir(globalPath);
+        fs.writeFileSync(globalPath, trustResult.content, 'utf-8');
+        results.push({
+            platform: 'codex',
+            filePath: globalPath,
+            status: 'written',
+            reason: 'added project trust entry',
+        });
+    }
+}
+export function distributeCodexHooks(options) {
+    const { scope, selected, dryRun = false, projectMode } = options;
+    if (scope?.project && projectMode === 'none') {
+        return { results: [] };
+    }
+    const results = [];
+    // Ensure Codex hooks feature flag is enabled
+    if (!dryRun) {
+        ensureCodexHooksFeature(results);
+    }
+    // Ensure project trust for project-scoped distribution
+    if (!dryRun && scope?.project) {
+        ensureProjectTrust(scope.project, results);
+    }
+    // Filter entries for Codex compatibility
+    const filteredEntries = filterForCodex(selected);
+    // Pre-validate hooks.json before making any filesystem changes
+    const hooksJsonPath = resolveHooksJsonPath(scope);
+    const fileResult = readHooksJson(hooksJsonPath);
+    if (!fileResult.ok) {
+        results.push({
+            platform: 'codex',
+            filePath: hooksJsonPath,
+            status: 'error',
+            error: `Cannot read hooks.json, aborting merge: ${fileResult.error}`,
+        });
+        return { results };
+    }
+    const fileData = fileResult.data;
+    // Validate hooks field shape: must be a Record<string, array> or absent
+    if (fileData.hooks !== undefined) {
+        if (typeof fileData.hooks !== 'object' ||
+            fileData.hooks === null ||
+            Array.isArray(fileData.hooks)) {
+            results.push({
+                platform: 'codex',
+                filePath: hooksJsonPath,
+                status: 'error',
+                error: 'hooks.json has invalid shape: "hooks" must be an object',
+            });
+            return { results };
+        }
+        for (const [event, groups] of Object.entries(fileData.hooks)) {
+            if (!Array.isArray(groups)) {
+                results.push({
+                    platform: 'codex',
+                    filePath: hooksJsonPath,
+                    status: 'error',
+                    error: `hooks.json has invalid shape: "hooks.${event}" must be an array`,
+                });
+                return { results };
+            }
+        }
+    }
+    // Phase 1: Copy bundle files (only after validation passes)
+    const bundleEntries = filteredEntries.filter((f) => f.entry.isBundle).map((f) => f.entry);
+    if (bundleEntries.length > 0) {
+        const bundleOutcome = distributeBundle({
+            section: 'hooks',
+            selected: bundleEntries,
+            platforms: ['codex'],
+            resolveTargetDir: (_p, entry) => resolveHookBundleTargetDir(entry, scope),
+            listFiles: listHookBundleFiles,
+            getId: (entry) => entry.id,
+            scope,
+            dryRun,
+        });
+        results.push(...bundleOutcome.results);
+    }
+    // Clean up orphan bundle directories
+    const activeBundleIds = new Set(bundleEntries.map((e) => e.id));
+    results.push(...cleanOrphanBundleDirs(activeBundleIds, scope, dryRun));
+    // Phase 2: Merge hook configs into hooks.json
+    const previouslyManaged = (fileData[ASB_MANAGED_KEY] ?? []);
+    // Check for existing ASB groups
+    const existingHooks = (fileData.hooks ?? {});
+    const hasAsbGroups = Object.values(existingHooks).some((groups) => groups.some((g) => g._asb_source === true));
+    if (filteredEntries.length === 0 && previouslyManaged.length === 0 && !hasAsbGroups) {
+        return { results };
+    }
+    const before = JSON.stringify(fileData);
+    mergeHooksIntoFile(fileData, filteredEntries, scope);
+    // Clean up empty state: if no hooks remain, remove the file entirely
+    const mergedHooks = fileData.hooks;
+    const totalGroups = Object.values(mergedHooks).reduce((sum, groups) => sum + groups.length, 0);
+    const hasNoHooks = totalGroups === 0;
+    if (hasNoHooks && filteredEntries.length === 0) {
+        // Remove ASB tracking keys
+        delete fileData[ASB_MANAGED_KEY];
+        // If file has only hooks (now empty) and ASB keys, consider deleting
+        const remainingKeys = Object.keys(fileData).filter((k) => k !== 'hooks');
+        if (remainingKeys.length === 0 && fs.existsSync(hooksJsonPath) && !dryRun) {
+            fs.unlinkSync(hooksJsonPath);
+            results.push({
+                platform: 'codex',
+                filePath: hooksJsonPath,
+                status: 'deleted',
+                reason: 'no hooks remain',
+            });
+            return { results };
+        }
+    }
+    const after = JSON.stringify(fileData);
+    if (before === after) {
+        results.push({
+            platform: 'codex',
+            filePath: hooksJsonPath,
+            status: 'skipped',
+            reason: 'up-to-date',
+        });
+    }
+    else if (dryRun) {
+        const reason = filteredEntries.length === 0 ? 'hooks cleared' : `${filteredEntries.length} hook(s) merged`;
+        results.push({ platform: 'codex', filePath: hooksJsonPath, status: 'written', reason });
+    }
+    else {
+        try {
+            writeHooksJson(hooksJsonPath, fileData);
+            const reason = filteredEntries.length === 0 ? 'hooks cleared' : `${filteredEntries.length} hook(s) merged`;
+            results.push({ platform: 'codex', filePath: hooksJsonPath, status: 'written', reason });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            results.push({ platform: 'codex', filePath: hooksJsonPath, status: 'error', error: msg });
+        }
+    }
+    return { results };
+}
+//# sourceMappingURL=codex-distribute.js.map

package/dist/hooks/codex-distribute.js.map

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

package/dist/hooks/distribution.d.ts

@@ -14,14 +14,14 @@
 import type { ConfigScope } from '../config/scope.js';
 import type { DistributionResult } from '../library/distribute.js';
 import type { BundleDistributionResult } from '../library/distribute-bundle.js';
-export type HookPlatform = 'claude-code';
+export type HookPlatform = 'claude-code' | 'codex';
 export interface HookDistributionOutcome {
     results: Array<DistributionResult<HookPlatform> | BundleDistributionResult<HookPlatform>>;
 }
 /**
- * Distribute hooks to Claude Code:
+ * Distribute hooks to active targets (Claude Code, Codex, etc.):
  *  1. Copy bundle files for bundle-type hooks
- *  2. Merge all active hook configs into settings.json
+ *  2. Merge all active hook configs into each target's config
  *  3. Clean up orphan bundle directories
  */
 export declare function distributeHooks(scope?: ConfigScope, activeAppIds?: string[], assumeInstalled?: ReadonlySet<string>, options?: {

package/dist/hooks/distribution.js

@@ -19,6 +19,7 @@ import { distributeBundle } from '../library/distribute-bundle.js';
 import { ensureParentDir, rmDirRecursive } from '../library/fs.js';
 import { loadLibraryStateSectionForApplication } from '../library/state.js';
 import { getTargetById } from '../targets/registry.js';
+import { distributeCodexHooks } from './codex-distribute.js';
 import { listHookBundleFiles, loadHookLibrary } from './library.js';
 import { HOOK_DIR_PLACEHOLDER } from './schema.js';
 const ASB_MANAGED_KEY = '_asb_managed_hooks';
@@ -191,10 +192,20 @@ function cleanOrphanBundleDirs(activeIds, scope, dryRun) {
 // ---------------------------------------------------------------------------
 // Main distribution entry point
 // ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Target reachability check
+// ---------------------------------------------------------------------------
+function isTargetReachable(platformId, _activeAppIds, assumeInstalled) {
+    const target = getTargetById(platformId);
+    if (target?.isInstalled?.() === false && !assumeInstalled?.has(platformId)) {
+        return false;
+    }
+    return true;
+}
 /**
- * Distribute hooks to Claude Code:
+ * Distribute hooks to active targets (Claude Code, Codex, etc.):
  *  1. Copy bundle files for bundle-type hooks
- *  2. Merge all active hook configs into settings.json
+ *  2. Merge all active hook configs into each target's config
  *  3. Clean up orphan bundle directories
  */
 export function distributeHooks(scope, activeAppIds, assumeInstalled, options) {
@@ -202,49 +213,80 @@ export function distributeHooks(scope, activeAppIds, assumeInstalled, options) {
         return { results: [] };
     }
     const results = [];
-    const platform = 'claude-code';
-    // Skip if claude-code is not installed (unless assumed installed)
-    const target = getTargetById(platform);
-    if (target?.isInstalled?.() === false && !assumeInstalled?.has(platform)) {
+    const dryRun = options?.dryRun === true;
+    // Check if any hook-capable target is reachable before loading library
+    const claudeReachable = isTargetReachable('claude-code', activeAppIds, assumeInstalled);
+    const codexReachable = isTargetReachable('codex', activeAppIds, assumeInstalled);
+    if (!claudeReachable && !codexReachable) {
         return { results };
     }
-    // When activeAppIds is set and doesn't include claude-code, treat as inactive:
-    // use empty selection so that cleanup/unmerge of previously injected hooks can run.
-    const isActive = !activeAppIds || activeAppIds.includes(platform);
+    // Load all hook entries once (shared across targets)
     const allEntries = loadHookLibrary(scope);
     const byId = new Map(allEntries.map((e) => [e.id, e]));
-    const state = loadLibraryStateSectionForApplication('hooks', 'claude-code', scope);
+    // --- Claude Code distribution ---
+    const claudeResults = distributeClaude({
+        scope,
+        activeAppIds,
+        assumeInstalled,
+        allEntries,
+        byId,
+        dryRun,
+        projectMode: options?.projectMode,
+    });
+    results.push(...claudeResults);
+    // --- Codex distribution ---
+    const codexResults = distributeCodex({
+        scope,
+        activeAppIds,
+        assumeInstalled,
+        allEntries,
+        byId,
+        dryRun,
+        projectMode: options?.projectMode,
+    });
+    results.push(...codexResults);
+    return { results };
+}
+function distributeClaude(ctx) {
+    const platform = 'claude-code';
+    const results = [];
+    // Skip if claude-code is not installed (unless assumed installed)
+    const target = getTargetById(platform);
+    if (target?.isInstalled?.() === false && !ctx.assumeInstalled?.has(platform)) {
+        return results;
+    }
+    // When activeAppIds is set and doesn't include claude-code, treat as inactive
+    const isActive = !ctx.activeAppIds || ctx.activeAppIds.includes(platform);
+    const state = loadLibraryStateSectionForApplication('hooks', 'claude-code', ctx.scope);
     const selected = [];
     if (isActive) {
         for (const id of state.enabled) {
-            const e = byId.get(id);
+            const e = ctx.byId.get(id);
             if (e)
                 selected.push(e);
         }
     }
     // Phase 1: Copy bundle files for bundle-type hooks
-    const dryRun = options?.dryRun === true;
     const bundleEntries = selected.filter((e) => e.isBundle);
     if (bundleEntries.length > 0) {
         const bundleOutcome = distributeBundle({
             section: 'hooks',
             selected: bundleEntries,
             platforms: [platform],
-            resolveTargetDir: (_p, entry) => resolveHookBundleTargetDir(_p, entry, scope),
+            resolveTargetDir: (_p, entry) => resolveHookBundleTargetDir(_p, entry, ctx.scope),
             listFiles: listHookBundleFiles,
             getId: (entry) => entry.id,
-            scope,
-            dryRun,
+            scope: ctx.scope,
+            dryRun: ctx.dryRun,
         });
         results.push(...bundleOutcome.results);
     }
     // Clean up orphan bundle directories
     const activeBundleIds = new Set(bundleEntries.map((e) => e.id));
-    results.push(...cleanOrphanBundleDirs(activeBundleIds, scope, dryRun));
+    results.push(...cleanOrphanBundleDirs(activeBundleIds, ctx.scope, ctx.dryRun));
     // Phase 2: Merge hook configs into settings.json
-    const settingsPath = resolveSettingsPath(scope);
+    const settingsPath = resolveSettingsPath(ctx.scope);
     const settingsResult = readSettingsJson(settingsPath);
-    // Abort hooks config merge if settings file is unreadable (prevents data loss)
     if (!settingsResult.ok) {
         results.push({
             platform,
@@ -252,23 +294,22 @@ export function distributeHooks(scope, activeAppIds, assumeInstalled, options) {
             status: 'error',
             error: `Cannot read settings.json, aborting hooks merge: ${settingsResult.error}`,
         });
-        return { results };
+        return results;
     }
     const settings = settingsResult.data;
     const previouslyManaged = (settings[ASB_MANAGED_KEY] ?? []);
-    // Also check for legacy ASB hooks (missing _asb_source marker)
     const existingHooks = (settings.hooks ?? {});
-    const hasLegacyAsb = Object.values(existingHooks).some((groups) => groups.some((g) => isLegacyAsbGroup(g, scope)));
+    const hasLegacyAsb = Object.values(existingHooks).some((groups) => groups.some((g) => isLegacyAsbGroup(g, ctx.scope)));
     if (selected.length === 0 && previouslyManaged.length === 0 && !hasLegacyAsb) {
-        return { results };
+        return results;
     }
     const before = JSON.stringify(settings);
-    mergeHooksIntoSettings(settings, selected, scope);
+    mergeHooksIntoSettings(settings, selected, ctx.scope);
     const after = JSON.stringify(settings);
     if (before === after) {
         results.push({ platform, filePath: settingsPath, status: 'skipped', reason: 'up-to-date' });
     }
-    else if (dryRun) {
+    else if (ctx.dryRun) {
         const reason = selected.length === 0 ? 'hooks cleared' : `${selected.length} hook(s) merged`;
         results.push({ platform, filePath: settingsPath, status: 'written', reason });
     }
@@ -283,6 +324,34 @@ export function distributeHooks(scope, activeAppIds, assumeInstalled, options) {
             results.push({ platform, filePath: settingsPath, status: 'error', error: msg });
         }
     }
-    return { results };
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Codex distribution (delegates to codex-distribute module)
+// ---------------------------------------------------------------------------
+function distributeCodex(ctx) {
+    const platform = 'codex';
+    // Skip if codex is not installed (unless assumed installed)
+    const target = getTargetById(platform);
+    if (target?.isInstalled?.() === false && !ctx.assumeInstalled?.has(platform)) {
+        return [];
+    }
+    const isActive = !ctx.activeAppIds || ctx.activeAppIds.includes(platform);
+    const state = loadLibraryStateSectionForApplication('hooks', 'codex', ctx.scope);
+    const selected = [];
+    if (isActive) {
+        for (const id of state.enabled) {
+            const e = ctx.byId.get(id);
+            if (e)
+                selected.push(e);
+        }
+    }
+    const outcome = distributeCodexHooks({
+        scope: ctx.scope,
+        selected,
+        dryRun: ctx.dryRun,
+        projectMode: ctx.projectMode,
+    });
+    return outcome.results;
 }
 //# sourceMappingURL=distribution.js.map