@open-agent-toolkit/cli 0.1.45 → 0.1.46

package/dist/commands/config/index.js

@@ -5,11 +5,12 @@ import { resolveProjectsRoot } from '../shared/oat-paths.js';
 import { confirmAction, } from '../shared/shared.prompts.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
 import { compileDispatchCeilingPreset } from '../../config/dispatch-ceiling-preset.js';
-import { readOatConfig, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, } from '../../config/oat-config.js';
+import { dispatchPolicyModeDescription, dispatchPolicyPolicyDescription, managedDispatchPolicyValueList, } from '../../config/dispatch-policy-options.js';
+import { VALID_DISPATCH_POLICY_MODES, VALID_MANAGED_DISPATCH_POLICIES, isCodexMaterializedRouteTarget, readOatConfig, readOatLocalConfig, readUserConfig, validateDispatchRouteTarget, writeOatConfig, writeOatLocalConfig, writeUserConfig, } from '../../config/oat-config.js';
 import { resolveEffectiveConfig, } from '../../config/resolve.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
-import { validateMatrixCell, } from '../../providers/identity/availability.js';
+import { normalizeMatrixCellAvailability, validateMatrixCell, } from '../../providers/identity/availability.js';
 import { Command } from 'commander';
 import { createConfigDumpCommand } from './dump.js';
 const DISPATCH_CEILING_PROVIDER_KEY_PREFIX = 'workflow.dispatchCeiling.providers.';
@@ -478,7 +479,7 @@ const CONFIG_CATALOG = [
         defaultValue: 'unset',
         mutability: 'read/write',
         owningCommand: 'oat config set workflow.dispatchPolicy.mode <value>',
-        description: 'Dispatch policy mode. "managed" means OAT selects model/effort from workflow.dispatchPolicy.policy; "inherit" means OAT leaves dispatch controls to the host/provider defaults. Set workflow.dispatchPolicy.policy to choose a managed policy. Resolution: local > shared > user > default.',
+        description: dispatchPolicyModeDescription(),
     },
     {
         key: 'workflow.dispatchPolicy.policy',
@@ -489,7 +490,7 @@ const CONFIG_CATALOG = [
         defaultValue: 'unset',
         mutability: 'read/write',
         owningCommand: 'oat config set workflow.dispatchPolicy.policy <value>',
-        description: 'Managed dispatch policy. economy, balanced, high, and frontier are capped managed policies; uncapped keeps OAT-managed preferred selection without provider caps. Setting this key writes workflow.dispatchPolicy.mode=managed. Resolution: local > shared > user > default.',
+        description: dispatchPolicyPolicyDescription(),
     },
     {
         key: 'workflow.dispatchCeiling.providers.codex',
@@ -614,14 +615,8 @@ const WORKFLOW_ENUM_VALUES = {
     'workflow.postImplementSequence': ['wait', 'summary', 'pr', 'docs-pr'],
     'workflow.reviewExecutionModel': ['subagent', 'inline', 'fresh-session'],
     'workflow.designMode': ['collaborative', 'selective', 'draft'],
-    'workflow.dispatchPolicy.mode': ['managed', 'inherit'],
-    'workflow.dispatchPolicy.policy': [
-        'economy',
-        'balanced',
-        'high',
-        'frontier',
-        'uncapped',
-    ],
+    'workflow.dispatchPolicy.mode': [...VALID_DISPATCH_POLICY_MODES],
+    'workflow.dispatchPolicy.policy': [...VALID_MANAGED_DISPATCH_POLICIES],
     'workflow.dispatchCeiling.preset': ['balanced', 'maximum', 'cost-conscious'],
     'workflow.dispatchCeiling.providers.codex': [
         'low',
@@ -747,13 +742,15 @@ function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 function matrixCellAvailabilityWarning(path, value, availability) {
-    if (availability === 'valid') {
+    const result = normalizeMatrixCellAvailability(availability);
+    if (result.availability === 'valid') {
         return null;
     }
-    if (availability === 'unknown-value') {
-        return `${path} value '${value}' was not recognized by the provider availability oracle; saving anyway.`;
+    const details = result.message ? ` ${result.message}` : '';
+    if (result.availability === 'unknown-value') {
+        return `${path} value '${value}' was not recognized by the provider availability oracle; saving anyway.${details}`;
     }
-    return `${path} value '${value}' could not be validated because the provider availability oracle is unavailable; saving anyway.`;
+    return `${path} value '${value}' could not be validated because the provider availability oracle is unavailable; saving anyway.${details}`;
 }
 function parseDispatchMatrixRecommendation(raw) {
     const parsed = JSON.parse(raw);
@@ -775,6 +772,9 @@ function parseDispatchMatrixRecommendation(raw) {
 function isRouteTarget(entry) {
     return isRecord(entry);
 }
+function formatRouteTargetValue(entry) {
+    return [entry.model, entry.effort].filter(Boolean).join('/');
+}
 function addDispatchMatrixCellRefs(refs, provider, path, cell) {
     if (typeof cell === 'string') {
         refs.push({ provider, value: cell, path });
@@ -789,11 +789,31 @@ function addDispatchMatrixCellRefs(refs, provider, path, cell) {
         if (!isRouteTarget(entry)) {
             continue;
         }
+        const targetProvider = entry.harness ?? provider;
+        if (isCodexMaterializedRouteTarget(provider, entry)) {
+            if (entry.model && entry.effort) {
+                refs.push({
+                    provider: targetProvider,
+                    value: formatRouteTargetValue(entry),
+                    path: entryPath,
+                    target: entry,
+                });
+                continue;
+            }
+        }
         if (entry.model) {
-            refs.push({ provider, value: entry.model, path: `${entryPath}.model` });
+            refs.push({
+                provider: targetProvider,
+                value: entry.model,
+                path: `${entryPath}.model`,
+            });
         }
         if (entry.effort) {
-            refs.push({ provider, value: entry.effort, path: `${entryPath}.effort` });
+            refs.push({
+                provider: targetProvider,
+                value: entry.effort,
+                path: `${entryPath}.effort`,
+            });
         }
     }
 }
@@ -814,6 +834,30 @@ function collectDispatchMatrixCellRefs(providers) {
     }
     return refs;
 }
+function collectDispatchMatrixTargetValidationErrors(providers) {
+    const errors = [];
+    for (const [provider, providerValue] of Object.entries(providers)) {
+        if (typeof providerValue === 'string') {
+            continue;
+        }
+        const providerPath = `workflow.dispatchCeiling.providers.${provider}`;
+        for (const [tier, cell] of Object.entries(providerValue)) {
+            if (!Array.isArray(cell)) {
+                continue;
+            }
+            for (const [index, entry] of cell.entries()) {
+                if (!isRouteTarget(entry)) {
+                    continue;
+                }
+                const validation = validateDispatchRouteTarget(provider, entry);
+                if (!validation.valid) {
+                    errors.push(`${providerPath}.${tier}[${index}]: ${validation.reason}`);
+                }
+            }
+        }
+    }
+    return errors;
+}
 function applyWorkflowValue(workflow, key, value) {
     const subKey = key.slice('workflow.'.length);
     if (subKey === 'dispatchPolicy.mode') {
@@ -826,7 +870,7 @@ function applyWorkflowValue(workflow, key, value) {
         }
         const policy = workflow.dispatchPolicy?.policy;
         if (!policy) {
-            throw new Error('Cannot set workflow.dispatchPolicy.mode to managed without an existing workflow.dispatchPolicy.policy. Set workflow.dispatchPolicy.policy <economy|balanced|high|frontier|uncapped> instead.');
+            throw new Error(`Cannot set workflow.dispatchPolicy.mode to managed without an existing workflow.dispatchPolicy.policy. Set workflow.dispatchPolicy.policy <${managedDispatchPolicyValueList('|')}> instead.`);
         }
         return {
             ...workflow,
@@ -956,6 +1000,7 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
             const availability = await dependencies.validateMatrixCell(providerNameFromConfigKey(key), parsedValue, {
                 cwd: repoRoot,
                 env: dependencies.processEnv,
+                detailed: true,
             });
             const warning = dispatchProviderAvailabilityWarning(key, parsedValue, availability);
             if (warning) {
@@ -1149,9 +1194,13 @@ async function loadDispatchMatrixRecommendation(dependencies) {
     return parseDispatchMatrixRecommendation(await dependencies.readFile(assetPath));
 }
 async function validateRecommendationCells(repoRoot, recommendation, dependencies, warn) {
+    const targetErrors = collectDispatchMatrixTargetValidationErrors(recommendation.providers);
+    if (targetErrors.length > 0) {
+        throw new Error(targetErrors.join('\n'));
+    }
     for (const ref of collectDispatchMatrixCellRefs(recommendation.providers)) {
         const closedValues = closedDispatchProviderValues(ref.provider);
-        if (closedValues && !closedValues.includes(ref.value)) {
+        if (!ref.target && closedValues && !closedValues.includes(ref.value)) {
             throw new Error(`Invalid value for ${ref.path}: expected one of ${closedValues.join(' | ')}, got '${ref.value}'`);
         }
         let availability;
@@ -1159,6 +1208,8 @@ async function validateRecommendationCells(repoRoot, recommendation, dependencie
             availability = await dependencies.validateMatrixCell(ref.provider, ref.value, {
                 cwd: repoRoot,
                 env: dependencies.processEnv,
+                detailed: true,
+                ...(ref.target ? { target: ref.target } : {}),
             });
         }
         catch {

package/dist/commands/doctor/index.d.ts

@@ -2,7 +2,7 @@ import { type CommandContext, type GlobalOptions } from '../../app/command-conte
 import { type PjmDoctorOptions } from '../pjm/doctor.js';
 import { type OatConfig, type OatLocalConfig, type UserConfig } from '../../config/oat-config.js';
 import { type Manifest } from '../../manifest/index.js';
-import { type MatrixCellAvailability, type ValidateMatrixCellOptions } from '../../providers/identity/availability.js';
+import { type MatrixCellAvailabilityResponse, type ValidateMatrixCellOptions } from '../../providers/identity/availability.js';
 import type { ConcreteScope } from '../../shared/types.js';
 import { type DoctorCheck } from '../../ui/output.js';
 import { Command } from 'commander';
@@ -22,7 +22,7 @@ interface DoctorDependencies {
     readOatConfig: (repoRoot: string) => Promise<OatConfig>;
     readOatLocalConfig: (repoRoot: string) => Promise<OatLocalConfig>;
     readUserConfig: (userConfigDir: string) => Promise<UserConfig>;
-    validateMatrixCell: (provider: string, value: string, options: ValidateMatrixCellOptions) => Promise<MatrixCellAvailability>;
+    validateMatrixCell: (provider: string, value: string, options: ValidateMatrixCellOptions) => Promise<MatrixCellAvailabilityResponse>;
     processEnv: NodeJS.ProcessEnv;
     runPjmDoctorChecks: (repoRoot: string, options?: PjmDoctorOptions) => Promise<DoctorCheck[]>;
     checkSkillVersions: (scopeRoot: string, assetsRoot: string, pathExists: (path: string) => Promise<boolean>) => Promise<SkillVersionReport>;

package/dist/commands/doctor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EAInB,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAO9D,OAAO,EAIL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,KACd,OAAO,CACV,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CACnE,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,KACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5B,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAytBD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,OAAO,CAcT"}

package/dist/commands/doctor/index.js

@@ -7,17 +7,18 @@ import { createPjmDisabledCheck, runPjmDoctorChecks, } from '../pjm/doctor.js';
 import { getSkillVersion } from '../shared/frontmatter.js';
 import { withScopeOption } from '../shared/scope-option.js';
 import { readGlobalOptions, resolveConcreteScopes, } from '../shared/shared.utils.js';
-import { readOatConfig, readOatLocalConfig, readUserConfig, } from '../../config/oat-config.js';
+import { readOatConfig, readOatLocalConfig, readUserConfig, isCodexMaterializedRouteTarget, } from '../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../fs/paths.js';
 import TOML from '@iarna/toml';
 import { loadManifest } from '../../manifest/index.js';
 import { claudeAdapter } from '../../providers/claude/index.js';
 import { codexAdapter } from '../../providers/codex/index.js';
+import { isOatManagedCodexRoleFile } from '../../providers/codex/codec/shared.js';
 import { copilotAdapter } from '../../providers/copilot/index.js';
 import { cursorAdapter } from '../../providers/cursor/index.js';
 import { geminiAdapter } from '../../providers/gemini/index.js';
-import { validateMatrixCell, } from '../../providers/identity/availability.js';
+import { normalizeMatrixCellAvailability, validateMatrixCell, } from '../../providers/identity/availability.js';
 import { formatDoctorResults } from '../../ui/output.js';
 import { Command } from 'commander';
 async function pathExistsDefault(path) {
@@ -143,6 +144,9 @@ function createDependencies() {
 function isRouteTarget(entry) {
     return typeof entry === 'object' && entry !== null && !Array.isArray(entry);
 }
+function formatRouteTargetValue(entry) {
+    return [entry.model, entry.effort].filter(Boolean).join('/');
+}
 function addDispatchMatrixCellRefs(refs, layer, provider, path, cell) {
     if (typeof cell === 'string') {
         refs.push({ layer, provider, value: cell, path });
@@ -157,10 +161,23 @@ function addDispatchMatrixCellRefs(refs, layer, provider, path, cell) {
         if (!isRouteTarget(entry)) {
             continue;
         }
+        const targetProvider = entry.harness ?? provider;
+        if (isCodexMaterializedRouteTarget(provider, entry)) {
+            if (entry.model && entry.effort) {
+                refs.push({
+                    layer,
+                    provider: targetProvider,
+                    value: formatRouteTargetValue(entry),
+                    path: entryPath,
+                    target: entry,
+                });
+                continue;
+            }
+        }
         if (entry.model) {
             refs.push({
                 layer,
-                provider,
+                provider: targetProvider,
                 value: entry.model,
                 path: `${entryPath}.model`,
             });
@@ -168,7 +185,7 @@ function addDispatchMatrixCellRefs(refs, layer, provider, path, cell) {
         if (entry.effort) {
             refs.push({
                 layer,
-                provider,
+                provider: targetProvider,
                 value: entry.effort,
                 path: `${entryPath}.effort`,
             });
@@ -203,7 +220,12 @@ function collectDispatchMatrixCellRefs(layers) {
 }
 function formatDispatchMatrixIssueList(issues) {
     return issues
-        .map((issue) => `${issue.path}=${issue.value} (${issue.layer} config)`)
+        .map((issue) => {
+        const suffix = 'message' in issue && typeof issue.message === 'string'
+            ? `; ${issue.message}`
+            : '';
+        return `${issue.path}=${issue.value} (${issue.layer} config)${suffix}`;
+    })
         .join(', ');
 }
 async function createDispatchMatrixDoctorCheck(scopeRoot, layers, dependencies) {
@@ -218,18 +240,24 @@ async function createDispatchMatrixDoctorCheck(scopeRoot, layers, dependencies)
     }
     const issues = [];
     for (const ref of refs) {
-        let availability;
+        let result;
         try {
-            availability = await dependencies.validateMatrixCell(ref.provider, ref.value, {
+            result = normalizeMatrixCellAvailability(await dependencies.validateMatrixCell(ref.provider, ref.value, {
                 cwd: scopeRoot,
                 env: dependencies.processEnv,
-            });
+                detailed: true,
+                ...(ref.target ? { target: ref.target } : {}),
+            }));
         }
         catch {
-            availability = 'unvalidated';
+            result = { availability: 'unvalidated' };
         }
-        if (availability !== 'valid') {
-            issues.push({ ...ref, availability });
+        if (result.availability !== 'valid') {
+            issues.push({
+                ...ref,
+                availability: result.availability,
+                ...(result.message ? { message: result.message } : {}),
+            });
         }
     }
     if (issues.length === 0) {
@@ -250,16 +278,45 @@ async function createDispatchMatrixDoctorCheck(scopeRoot, layers, dependencies)
         messageParts.push(`Unvalidated dispatch matrix cells: ${formatDispatchMatrixIssueList(unvalidated)}`);
     }
     const hasUnknown = unknown.length > 0;
+    const hasUnvalidated = unvalidated.length > 0;
     return {
         name: 'project:dispatch_matrix',
         description: 'Dispatch matrix cell availability',
-        status: hasUnknown ? 'warn' : 'pass',
+        status: hasUnknown || hasUnvalidated ? 'warn' : 'pass',
         message: messageParts.join('. '),
         fix: hasUnknown
             ? 'Run `oat config set workflow.dispatchCeiling.providers.<provider> <value>` with an available value, or refresh provider assets with `oat sync --scope project`.'
             : undefined,
     };
 }
+function getCodexAgentConfigFile(config) {
+    if (!config || typeof config !== 'object' || Array.isArray(config)) {
+        return null;
+    }
+    const configFile = config.config_file;
+    return typeof configFile === 'string' && configFile.startsWith('agents/')
+        ? configFile
+        : null;
+}
+function isLikelyOatGeneratedCodexRoleName(roleName) {
+    return (roleName === 'oat-phase-implementer' ||
+        roleName === 'oat-reviewer' ||
+        roleName.startsWith('oat-phase-implementer-') ||
+        roleName.startsWith('oat-reviewer-'));
+}
+async function isManagedCodexRoleConfig(scopeRoot, roleName, configFile, dependencies) {
+    const absoluteRolePath = join(scopeRoot, '.codex', configFile);
+    if (!(await dependencies.pathExists(absoluteRolePath))) {
+        return isLikelyOatGeneratedCodexRoleName(roleName);
+    }
+    try {
+        const roleContent = await dependencies.readFile(absoluteRolePath);
+        return isOatManagedCodexRoleFile(roleContent, roleName);
+    }
+    catch {
+        return false;
+    }
+}
 async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies) {
     const checks = [];
     const skillsPath = join(scopeRoot, '.agents', 'skills');
@@ -419,17 +476,18 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
                     !Array.isArray(parsedConfig.agents)
                     ? parsedConfig.agents
                     : null;
-                const managedRoles = Object.entries(agents ?? {})
-                    .filter(([, config]) => {
-                    if (!config ||
-                        typeof config !== 'object' ||
-                        Array.isArray(config)) {
-                        return false;
+                const managedRoles = [];
+                const roleConfigFiles = new Map();
+                for (const [roleName, roleConfig] of Object.entries(agents ?? {})) {
+                    const configFile = getCodexAgentConfigFile(roleConfig);
+                    if (!configFile) {
+                        continue;
+                    }
+                    roleConfigFiles.set(roleName, configFile);
+                    if (await isManagedCodexRoleConfig(scopeRoot, roleName, configFile, dependencies)) {
+                        managedRoles.push(roleName);
                     }
-                    const configFile = config.config_file;
-                    return (typeof configFile === 'string' && configFile.startsWith('agents/'));
-                })
-                    .map(([roleName]) => roleName);
+                }
                 if (managedRoles.length > 0) {
                     const multiAgentEnabled = features?.multi_agent === true || features?.multi_agent === 'true';
                     checks.push({
@@ -445,11 +503,9 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
                     });
                     const missingRoleFiles = [];
                     for (const roleName of managedRoles) {
-                        const roleConfig = agents[roleName];
-                        const configFile = roleConfig.config_file;
-                        if (typeof configFile !== 'string') {
+                        const configFile = roleConfigFiles.get(roleName);
+                        if (!configFile)
                             continue;
-                        }
                         const absoluteRolePath = join(scopeRoot, '.codex', configFile);
                         if (!(await dependencies.pathExists(absoluteRolePath))) {
                             missingRoleFiles.push(configFile);
@@ -464,7 +520,7 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
                             : `Missing codex role files: ${missingRoleFiles.join(', ')}`,
                         fix: missingRoleFiles.length === 0
                             ? undefined
-                            : 'Regenerate codex roles with `oat sync --scope project`.',
+                            : 'Regenerate codex roles with `oat sync --scope project`, or materialize a single role with `oat providers codex materialize ...`.',
                     });
                 }
             }

package/dist/commands/project/dispatch-ceiling/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/dispatch-ceiling/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAML,KAAK,uBAAuB,EAU7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAazB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAs+CD,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAyDT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/dispatch-ceiling/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAY9B,OAAO,EAOL,KAAK,uBAAuB,EAU7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAazB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AA4pDD,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAwET"}