@open-agent-toolkit/cli 0.1.73 → 0.1.74

package/dist/commands/sync/index.js

@@ -5,17 +5,18 @@ import { withScopeOption } from '../shared/scope-option.js';
 import { selectManyWithAbort, } from '../shared/shared.prompts.js';
 import { readGlobalOptions, resolveConcreteScopes, } from '../shared/shared.utils.js';
 import { DEFAULT_SYNC_CONFIG, loadSyncConfig, saveSyncConfig, } from '../../config/index.js';
-import { computeSyncPlan, executeSyncPlan, scanBundledManagedCodexAgents, scanCanonical, } from '../../engine/index.js';
+import { computeSyncPlan, executeSyncPlan, scanBundledManagedAgents, scanCanonical, } from '../../engine/index.js';
 import { CliError } from '../../errors/index.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../fs/paths.js';
 import { loadManifest } from '../../manifest/index.js';
 import { claudeAdapter } from '../../providers/claude/index.js';
 import { codexAdapter } from '../../providers/codex/index.js';
-import { applyCodexProjectExtensionPlan, computeCodexProjectExtensionPlan, toCodexExtensionOperations, } from '../../providers/codex/codec/sync-extension.js';
+import { codexMaterializationExtension } from '../../providers/codex/codec/sync-extension.js';
 import { copilotAdapter } from '../../providers/copilot/index.js';
 import { cursorAdapter } from '../../providers/cursor/index.js';
+import { cursorMaterializationExtension } from '../../providers/cursor/codec/sync-extension.js';
 import { geminiAdapter } from '../../providers/gemini/index.js';
-import { getConfigAwareAdapters, } from '../../providers/shared/index.js';
+import { getConfigAwareAdapters, toMaterializationOperations, } from '../../providers/shared/index.js';
 import { formatSyncPlan } from '../../ui/output.js';
 import { Command, Option } from 'commander';
 import { runSyncApply } from './apply.js';
@@ -36,7 +37,7 @@ function defaultDependencies() {
         },
         saveSyncConfig,
         scanCanonical,
-        scanBundledManagedCodexAgents,
+        scanBundledManagedAgents,
         getAdapters() {
             return [
                 claudeAdapter,
@@ -50,9 +51,15 @@ function defaultDependencies() {
         selectProvidersWithAbort: selectManyWithAbort,
         computeSyncPlan,
         executeSyncPlan,
-        computeCodexProjectExtensionPlan,
-        toCodexExtensionOperations,
-        applyCodexProjectExtensionPlan,
+        getMaterializationExtensions() {
+            return [
+                codexMaterializationExtension,
+                cursorMaterializationExtension,
+            ];
+        },
+        applyMaterializationExtensionPlan(extension, scopeRoot, plan) {
+            return extension.applyPlan(scopeRoot, plan);
+        },
         formatSyncPlan,
     };
 }
@@ -166,23 +173,25 @@ async function computePlans(context, dependencies, allowedCanonicalPaths) {
             scopeRoot,
             allowedCanonicalPaths,
         });
-        let codexExtensionPlan;
-        let codexExtension;
         const activeAdapterNames = resolved.activeAdapters.map((adapter) => adapter.name);
-        if (activeAdapterNames.includes('codex')) {
-            const codexCanonical = scope === 'user'
-                ? [
-                    ...canonical,
-                    ...(await dependencies.scanBundledManagedCodexAgents()),
-                ]
-                : canonical;
-            codexExtensionPlan = await dependencies.computeCodexProjectExtensionPlan(scopeRoot, codexCanonical, allowedCanonicalPaths, { userConfigDir: join(context.home, '.oat') });
-            codexExtension = {
-                operations: dependencies.toCodexExtensionOperations(codexExtensionPlan),
-                managedRoles: codexExtensionPlan.managedRoles,
-                aggregateConfigHash: codexExtensionPlan.aggregateConfigHash,
-            };
-        }
+        const enabledExtensions = dependencies
+            .getMaterializationExtensions()
+            .filter((extension) => activeAdapterNames.includes(extension.provider));
+        const extensionCanonical = scope === 'user' && enabledExtensions.length > 0
+            ? [...canonical, ...(await dependencies.scanBundledManagedAgents())]
+            : canonical;
+        const materializationExtensionPlans = await Promise.all(enabledExtensions.map((extension) => extension.computePlan({
+            scopeRoot,
+            canonicalEntries: extensionCanonical,
+            allowedCanonicalPaths,
+            options: { userConfigDir: join(context.home, '.oat') },
+        })));
+        const materializationExtensions = materializationExtensionPlans.map((extensionPlan) => ({
+            provider: extensionPlan.provider,
+            operations: toMaterializationOperations(extensionPlan),
+            managedEntries: extensionPlan.managedEntries,
+            aggregateHash: extensionPlan.aggregateHash,
+        }));
         scopePlans.push({
             scope,
             scopeRoot,
@@ -192,8 +201,8 @@ async function computePlans(context, dependencies, allowedCanonicalPaths) {
             activeAdapterNames,
             plan,
             providerMismatches: resolved.mismatches,
-            codexExtensionPlan,
-            codexExtension,
+            materializationExtensionPlans,
+            materializationExtensions,
         });
     }
     return scopePlans;

package/dist/commands/sync/sync.types.d.ts

@@ -3,8 +3,7 @@ import type { MultiSelectChoice, PromptContext } from '../shared/shared.prompts.
 import type { SyncConfig } from '../../config/index.js';
 import type { CanonicalEntry, SyncPlan, SyncResult } from '../../engine/index.js';
 import type { Manifest } from '../../manifest/index.js';
-import type { CodexExtensionApplyResult, CodexExtensionPlan } from '../../providers/codex/codec/sync-extension.js';
-import type { ConfigAwareAdaptersResult, ProviderAdapter } from '../../providers/shared/index.js';
+import type { ConfigAwareAdaptersResult, MaterializationApplyResult, MaterializationExtension, MaterializationOperation, MaterializationPlan, ProviderAdapter } from '../../providers/shared/index.js';
 import type { ConcreteScope, Scope } from '../../shared/types.js';
 export interface SyncProviderMismatches {
     detectedUnset: string[];
@@ -19,8 +18,8 @@ export interface ScopeSyncPlan {
     canonical?: CanonicalEntry[];
     activeAdapterNames?: string[];
     providerMismatches?: SyncProviderMismatches;
-    codexExtensionPlan?: CodexExtensionPlan;
-    codexExtension?: CodexExtensionSummary;
+    materializationExtensionPlans: MaterializationPlan[];
+    materializationExtensions: MaterializationExtensionSummary[];
 }
 export interface SyncSummary {
     plannedOperations: number;
@@ -34,6 +33,8 @@ export interface SyncJsonPayload {
     plans: SyncPlan[];
     summary: SyncSummary;
     providerMismatches?: SyncProviderMismatches[];
+    materializationExtensions?: MaterializationExtensionSummary[];
+    /** Retained for compatibility with existing Codex JSON consumers. */
     codexExtensions?: CodexExtensionSummary[];
 }
 export type CodexExtensionAction = 'create' | 'update' | 'remove' | 'skip';
@@ -53,6 +54,24 @@ export interface CodexExtensionSummary {
     failed?: number;
     skipped?: number;
 }
+export interface MaterializationExtensionSummary {
+    provider: string;
+    operations: MaterializationOperation[];
+    managedEntries: string[];
+    aggregateHash: string;
+    applied?: number;
+    failed?: number;
+    skipped?: number;
+}
+export type SyncMaterializationExtension = MaterializationExtension<MaterializationPlan, {
+    scopeRoot: string;
+    canonicalEntries: CanonicalEntry[];
+    allowedCanonicalPaths?: string[];
+    options: {
+        userConfigDir?: string;
+        env?: NodeJS.ProcessEnv;
+    };
+}>;
 export interface SyncCommandDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;
     resolveScopeRoot: (scope: ConcreteScope, context: CommandContext) => Promise<string>;
@@ -60,7 +79,7 @@ export interface SyncCommandDependencies {
     loadSyncConfig: (configPath: string) => Promise<SyncConfig>;
     saveSyncConfig: (configPath: string, config: SyncConfig) => Promise<SyncConfig>;
     scanCanonical: (scopeRoot: string, scope: ConcreteScope) => Promise<CanonicalEntry[]>;
-    scanBundledManagedCodexAgents: () => Promise<CanonicalEntry[]>;
+    scanBundledManagedAgents: () => Promise<CanonicalEntry[]>;
     getAdapters: () => ProviderAdapter[];
     getConfigAwareAdapters: (adapters: ProviderAdapter[], scopeRoot: string, config: SyncConfig) => Promise<ConfigAwareAdaptersResult>;
     selectProvidersWithAbort: <T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext) => Promise<T[] | null>;
@@ -74,12 +93,8 @@ export interface SyncCommandDependencies {
         allowedCanonicalPaths?: string[];
     }) => Promise<SyncPlan>;
     executeSyncPlan: (plan: SyncPlan, manifest: Manifest, manifestPath: string) => Promise<SyncResult>;
-    computeCodexProjectExtensionPlan: (scopeRoot: string, canonicalEntries: CanonicalEntry[], allowedCanonicalPaths?: string[], options?: {
-        userConfigDir?: string;
-        env?: NodeJS.ProcessEnv;
-    }) => Promise<CodexExtensionPlan>;
-    toCodexExtensionOperations: (plan: CodexExtensionPlan) => CodexExtensionOperation[];
-    applyCodexProjectExtensionPlan: (scopeRoot: string, plan: CodexExtensionPlan) => Promise<CodexExtensionApplyResult>;
+    getMaterializationExtensions: () => SyncMaterializationExtension[];
+    applyMaterializationExtensionPlan: (extension: SyncMaterializationExtension, scopeRoot: string, plan: MaterializationPlan) => Promise<MaterializationApplyResult>;
     formatSyncPlan: (plan: SyncPlan, applied: boolean) => string;
 }
 //# sourceMappingURL=sync.types.d.ts.map

package/dist/commands/sync/sync.types.d.ts.map

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

package/dist/commands/sync/sync.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.utils.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/sync.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,CAc1E"}
+{"version":3,"file":"sync.utils.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/sync.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,CAgB1E"}

package/dist/commands/sync/sync.utils.js

@@ -1,8 +1,9 @@
 export function countPlannedOperations(scopePlans) {
     return scopePlans.reduce((total, scopePlan) => {
-        const codexOperations = scopePlan.codexExtension?.operations.filter((entry) => entry.action !== 'skip').length ?? 0;
+        const extensionOperations = scopePlan.materializationExtensions.reduce((count, extension) => count +
+            extension.operations.filter((entry) => entry.action !== 'skip').length, 0);
         return (total +
             [...scopePlan.plan.entries, ...scopePlan.plan.removals].filter((entry) => entry.operation !== 'skip').length +
-            codexOperations);
+            extensionOperations);
     }, 0);
 }

package/dist/engine/index.d.ts

@@ -5,5 +5,5 @@ export { configureLocalHooksPath, getHookInstallInfo, HOOK_DRIFT_WARNING, HOOK_M
 export type { HookInstallInfo, HookStatus } from './hook.js';
 export { hasMarker, insertMarker, OAT_DIRECTORY_SENTINEL, OAT_MARKER_PREFIX, writeDirectorySentinel, } from './markers.js';
 export type { CanonicalEntry } from './scanner.js';
-export { scanBundledManagedCodexAgents, scanCanonical } from './scanner.js';
+export { scanBundledManagedAgents, scanBundledManagedCodexAgents, scanCanonical, } from './scanner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/engine/index.js

@@ -3,4 +3,4 @@ export { SYNC_OPERATION_TYPES, } from './engine.types.js';
 export { executeSyncPlan } from './execute-plan.js';
 export { configureLocalHooksPath, getHookInstallInfo, HOOK_DRIFT_WARNING, HOOK_MARKER_END, HOOK_MARKER_START, HOOK_STRAY_INFO, installHook, isHookInstalled, REPO_GITHOOKS_PATH, runHookCheck, uninstallHook, } from './hook.js';
 export { hasMarker, insertMarker, OAT_DIRECTORY_SENTINEL, OAT_MARKER_PREFIX, writeDirectorySentinel, } from './markers.js';
-export { scanBundledManagedCodexAgents, scanCanonical } from './scanner.js';
+export { scanBundledManagedAgents, scanBundledManagedCodexAgents, scanCanonical, } from './scanner.js';

package/dist/engine/scanner.d.ts

@@ -6,7 +6,9 @@ export interface CanonicalEntry {
     canonicalPath: string;
     isFile: boolean;
 }
-export declare function scanBundledManagedCodexAgents(): Promise<CanonicalEntry[]>;
+export declare function scanBundledManagedAgents(): Promise<CanonicalEntry[]>;
+/** @deprecated Use scanBundledManagedAgents for provider-neutral materialization. */
+export declare const scanBundledManagedCodexAgents: typeof scanBundledManagedAgents;
 export declare function scanCanonical(basePath: string, scope: ConcreteScope): Promise<CanonicalEntry[]>;
 export {};
 //# sourceMappingURL=scanner.d.ts.map

package/dist/engine/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/engine/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAEvB,KAAK,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AA0DD,wBAAsB,6BAA6B,IAAI,OAAO,CAC5D,cAAc,EAAE,CACjB,CAsBA;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CA2B3B"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/engine/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAEvB,KAAK,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AA0DD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAsB1E;AAED,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,iCAA2B,CAAC;AAEtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CA2B3B"}

package/dist/engine/scanner.js

@@ -43,13 +43,13 @@ async function readEntries(dirPath) {
         throw error;
     }
 }
-export async function scanBundledManagedCodexAgents() {
+export async function scanBundledManagedAgents() {
     const agentsDir = join(await resolveAssetsRoot(), 'agents');
     const entries = await readEntries(agentsDir);
     const available = new Set(entries.filter((entry) => entry.isFile).map((entry) => entry.name));
     const missing = USER_SCOPE_MANAGED_AGENT_FILES.filter((name) => !available.has(name));
     if (missing.length > 0) {
-        throw new CliError(`Bundled managed Codex role definitions are unavailable: ${missing.join(', ')}. Reinstall or rebuild OAT before running user sync.`);
+        throw new CliError(`Bundled managed role definitions are unavailable: ${missing.join(', ')}. Reinstall or rebuild OAT before running user sync.`);
     }
     return USER_SCOPE_MANAGED_AGENT_FILES.map((name) => ({
         name,
@@ -58,6 +58,8 @@ export async function scanBundledManagedCodexAgents() {
         isFile: true,
     }));
 }
+/** @deprecated Use scanBundledManagedAgents for provider-neutral materialization. */
+export const scanBundledManagedCodexAgents = scanBundledManagedAgents;
 export async function scanCanonical(basePath, scope) {
     const scopeRoot = resolve(basePath);
     const entries = [];

package/dist/providers/ceiling/registry.d.ts

@@ -13,6 +13,7 @@
  * (no variant files). Every other provider is advisory by default.
  */
 export type EnforcementMechanism = 'pinned-variant' | 'model-arg' | 'none';
+export type ProviderSelectionAxis = 'model' | 'model-effort' | 'tier' | 'none';
 export type CeilingRole = 'implementer' | 'reviewer';
 export interface CeilingCompileContext {
     /** The orchestrator's own tier, used to detect above-orchestrator upgrades. */
@@ -33,6 +34,7 @@ export interface ProviderCeilingAdapter {
     supportsCeiling: boolean;
     validValues: string[];
     mechanism: EnforcementMechanism;
+    selectionAxis: ProviderSelectionAxis;
     /**
      * Compile a ceiling value into dispatch args for the given role, or `null`
      * when the value is invalid or the provider is advisory/unsupported.

package/dist/providers/ceiling/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/providers/ceiling/registry.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB,IAAI,CAAC;AAKT,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,qBAAqB,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,qBAAqB,GACzB,mBAAmB,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;CACtE;AAMD,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAK9C,CAAC;AA4GF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAE1E"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/providers/ceiling/registry.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,WAAW,GAAG,MAAM,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB,IAAI,CAAC;AAKT,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,oBAAoB,CAAC;IAChC,aAAa,EAAE,qBAAqB,CAAC;IACrC;;;OAGG;IACH,qBAAqB,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,qBAAqB,GACzB,mBAAmB,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;CACtE;AAMD,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAK9C,CAAC;AA6HF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAE1E"}

package/dist/providers/ceiling/registry.js

@@ -1,5 +1,7 @@
 import { VALID_CLAUDE_DISPATCH_CEILINGS, VALID_CODEX_DISPATCH_CEILINGS, } from '../../config/oat-config.js';
 import { buildCodexMaterializedTargetRoleName } from '../codex/codec/shared.js';
+import { findCursorModelPinMapping } from '../cursor/codec/catalog.js';
+import { buildCursorMaterializedRoleName } from '../cursor/codec/shared.js';
 const DIRECT_DISPATCH_ROLE_PATTERN = /^oat-(?:phase-implementer|reviewer)(?:-|$)/;
 export function isDirectDispatchRoleName(value) {
     return DIRECT_DISPATCH_ROLE_PATTERN.test(value.trim());
@@ -19,6 +21,7 @@ const codexAdapter = {
     supportsCeiling: true,
     validValues: [...VALID_CODEX_DISPATCH_CEILINGS],
     mechanism: 'pinned-variant',
+    selectionAxis: 'model-effort',
     compileToDispatchArgs(value, role, ctx) {
         if (!VALID_CODEX_DISPATCH_CEILINGS.includes(value)) {
             return null;
@@ -60,6 +63,7 @@ const claudeAdapter = {
     supportsCeiling: true,
     validValues: [...VALID_CLAUDE_DISPATCH_CEILINGS],
     mechanism: 'model-arg',
+    selectionAxis: 'tier',
     compileToDispatchArgs(value) {
         if (isDirectDispatchRoleName(value) ||
             !VALID_CLAUDE_DISPATCH_CEILINGS.includes(value)) {
@@ -76,10 +80,21 @@ const cursorAdapter = {
     provider: 'cursor',
     supportsCeiling: true,
     validValues: [],
-    mechanism: 'model-arg',
-    compileToDispatchArgs(value) {
-        const model = value.trim();
-        return model && !isDirectDispatchRoleName(model) ? { model } : null;
+    mechanism: 'pinned-variant',
+    selectionAxis: 'model',
+    compileToDispatchArgs(value, role, ctx) {
+        const model = ctx.target?.model ?? value.trim();
+        if (!model ||
+            isDirectDispatchRoleName(model) ||
+            !findCursorModelPinMapping(model)) {
+            return null;
+        }
+        return {
+            variant: buildCursorMaterializedRoleName({
+                agentName: role === 'reviewer' ? CODEX_REVIEWER_ROLE : CODEX_IMPLEMENTER_ROLE,
+                ladderModelId: model,
+            }),
+        };
     },
     // Cursor model slugs do not share a total order, so upgrade verification is
     // not meaningful here; availability is checked by the identity oracle layer.
@@ -93,6 +108,7 @@ function advisoryAdapter(provider) {
         supportsCeiling: false,
         validValues: [],
         mechanism: 'none',
+        selectionAxis: 'none',
         compileToDispatchArgs() {
             return null;
         },

package/dist/providers/codex/codec/sync-extension.d.ts

@@ -1,5 +1,6 @@
 import type { CanonicalEntry } from '../../../engine/index.js';
-export type CodexExtensionAction = 'create' | 'update' | 'remove' | 'skip';
+import { type MaterializationAction, type MaterializationApplyResult, type MaterializationContext, type MaterializationExtension, type MaterializationPlan, type MaterializationWriteOperation } from '../../shared/index.js';
+export type CodexExtensionAction = MaterializationAction;
 export type CodexExtensionTarget = 'role' | 'config';
 export interface CodexExtensionOperation {
     action: CodexExtensionAction;
@@ -8,20 +9,20 @@ export interface CodexExtensionOperation {
     reason: string;
     roleName?: string;
 }
-export interface CodexExtensionWriteOperation extends CodexExtensionOperation {
-    content?: string;
+export interface CodexExtensionWriteOperation extends MaterializationWriteOperation<'codex', CodexExtensionTarget> {
+    roleName?: string;
 }
-export interface CodexExtensionPlan {
+export interface CodexExtensionPlan extends MaterializationPlan<'codex', CodexExtensionTarget, CodexExtensionPlanMetadata> {
     operations: CodexExtensionWriteOperation[];
     managedRoles: string[];
     aggregateConfigHash: string;
 }
-export interface CodexExtensionApplyResult {
-    applied: number;
-    failed: number;
-    skipped: number;
+export interface CodexExtensionPlanMetadata {
+    managedRoles: string[];
+    aggregateConfigHash: string;
 }
-interface CodexMaterializationTargetOptions {
+export type CodexExtensionApplyResult = MaterializationApplyResult;
+export interface CodexMaterializationTargetOptions {
     userConfigDir?: string;
     projectPath?: string | null;
     env?: NodeJS.ProcessEnv;
@@ -34,5 +35,5 @@ export declare function summarizeCodexExtension(plan: CodexExtensionPlan): {
     skipped: number;
 };
 export declare function toCodexExtensionOperations(plan: CodexExtensionPlan): CodexExtensionOperation[];
-export {};
+export declare const codexMaterializationExtension: MaterializationExtension<CodexExtensionPlan, MaterializationContext<CodexMaterializationTargetOptions>>;
 //# sourceMappingURL=sync-extension.d.ts.map

package/dist/providers/codex/codec/sync-extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-extension.d.ts","sourceRoot":"","sources":["../../../../src/providers/codex/codec/sync-extension.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAyBpD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,4BAA4B,EAAE,CAAC;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD,UAAU,iCAAiC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAqiBD,wBAAsB,gCAAgC,CACpD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,cAAc,EAAE,EAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAChC,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,kBAAkB,CAAC,CAqJ7B;AAED,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC,CA6BpC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAE1E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAaA;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,GACvB,uBAAuB,EAAE,CAQ3B"}
+{"version":3,"file":"sync-extension.d.ts","sourceRoot":"","sources":["../../../../src/providers/codex/codec/sync-extension.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EACnC,MAAM,mBAAmB,CAAC;AAqB3B,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B,CACjF,OAAO,EACP,oBAAoB,CACrB;IACC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB,CAC7D,OAAO,EACP,oBAAoB,EACpB,0BAA0B,CAC3B;IACC,UAAU,EAAE,4BAA4B,EAAE,CAAC;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAgBnE,MAAM,WAAW,iCAAiC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAqiBD,wBAAsB,gCAAgC,CACpD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,cAAc,EAAE,EAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAChC,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,kBAAkB,CAAC,CAkL7B;AAED,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC,CA6BpC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAE1E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,GACvB,uBAAuB,EAAE,CAQ3B;AAED,eAAO,MAAM,6BAA6B,EAAE,wBAAwB,CAClE,kBAAkB,EAClB,sBAAsB,CAAC,iCAAiC,CAAC,CAY1D,CAAC"}

package/dist/providers/codex/codec/sync-extension.js

@@ -8,6 +8,7 @@ import { CliError } from '../../../errors/index.js';
 import { ensureDir, fileExists } from '../../../fs/io.js';
 import { validateRealPathWithinScope } from '../../../fs/paths.js';
 import TOML from '@iarna/toml';
+import { hasMaterializationChanges, summarizeMaterializationPlan, } from '../../shared/index.js';
 import YAML from 'yaml';
 import { SUPPORTED_CODEX_BASE_ROLES, SUPPORTED_CODEX_ROLE_TARGETS, } from './catalog.js';
 import { mergeCodexConfig, readCodexMaxDepth, } from './config-merge.js';
@@ -404,10 +405,18 @@ export async function computeCodexProjectExtensionPlan(scopeRoot, canonicalEntri
     const existingConfigPath = configPath(scopeRoot);
     const existingConfigContent = await readOptionalFile(existingConfigPath);
     if (isPartialSync && desiredRoles.length === 0) {
+        const aggregateConfigHash = hashContent(existingConfigContent ?? '');
         return {
+            provider: 'codex',
             operations: [],
+            managedEntries: [],
+            aggregateHash: aggregateConfigHash,
+            metadata: {
+                managedRoles: [],
+                aggregateConfigHash,
+            },
             managedRoles: [],
-            aggregateConfigHash: hashContent(existingConfigContent ?? ''),
+            aggregateConfigHash,
         };
     }
     const inheritedMaxDepth = await readInheritedCodexMaxDepth(scopeRoot, options);
@@ -419,10 +428,12 @@ export async function computeCodexProjectExtensionPlan(scopeRoot, canonicalEntri
         const existingRoleContent = await readOptionalFile(role.rolePath);
         if (existingRoleContent === null) {
             operations.push({
+                provider: 'codex',
                 action: 'create',
                 target: 'role',
                 path: toRelativePath(scopeRoot, role.rolePath),
                 reason: 'managed role file missing',
+                entryName: role.roleName,
                 roleName: role.roleName,
                 content: role.content,
             });
@@ -430,20 +441,24 @@ export async function computeCodexProjectExtensionPlan(scopeRoot, canonicalEntri
         }
         if (existingRoleContent.trimEnd() !== role.content.trimEnd()) {
             operations.push({
+                provider: 'codex',
                 action: 'update',
                 target: 'role',
                 path: toRelativePath(scopeRoot, role.rolePath),
                 reason: 'managed role file differs from canonical export',
+                entryName: role.roleName,
                 roleName: role.roleName,
                 content: role.content,
             });
             continue;
         }
         operations.push({
+            provider: 'codex',
             action: 'skip',
             target: 'role',
             path: toRelativePath(scopeRoot, role.rolePath),
             reason: 'managed role file already in sync',
+            entryName: role.roleName,
             roleName: role.roleName,
         });
     }
@@ -453,10 +468,12 @@ export async function computeCodexProjectExtensionPlan(scopeRoot, canonicalEntri
         if (staleRoleContent &&
             isOatManagedCodexRoleFile(staleRoleContent, staleRole)) {
             operations.push({
+                provider: 'codex',
                 action: 'remove',
                 target: 'role',
                 path: toRelativePath(scopeRoot, staleRolePath),
                 reason: 'stale managed role removed',
+                entryName: staleRole,
                 roleName: staleRole,
             });
         }
@@ -468,6 +485,7 @@ export async function computeCodexProjectExtensionPlan(scopeRoot, canonicalEntri
         inheritedMaxDepth,
     });
     operations.push({
+        provider: 'codex',
         action: existingConfigContent === null
             ? 'create'
             : configMerge.changed
@@ -482,10 +500,22 @@ export async function computeCodexProjectExtensionPlan(scopeRoot, canonicalEntri
                 : 'codex config already in sync',
         content: configMerge.mergedContent,
     });
+    const managedRoles = [
+        ...desiredRoles.map((role) => role.roleName),
+        ...staleRoles,
+    ];
+    const aggregateConfigHash = hashContent(configMerge.mergedContent);
     return {
+        provider: 'codex',
         operations,
-        managedRoles: [...desiredRoles.map((role) => role.roleName), ...staleRoles],
-        aggregateConfigHash: hashContent(configMerge.mergedContent),
+        managedEntries: managedRoles,
+        aggregateHash: aggregateConfigHash,
+        metadata: {
+            managedRoles,
+            aggregateConfigHash,
+        },
+        managedRoles,
+        aggregateConfigHash,
     };
 }
 export async function applyCodexProjectExtensionPlan(scopeRoot, plan) {
@@ -517,19 +547,10 @@ export async function applyCodexProjectExtensionPlan(scopeRoot, plan) {
     return result;
 }
 export function hasCodexExtensionChanges(plan) {
-    return plan.operations.some((operation) => operation.action !== 'skip');
+    return hasMaterializationChanges(plan);
 }
 export function summarizeCodexExtension(plan) {
-    let plannedOperations = 0;
-    let skipped = 0;
-    for (const operation of plan.operations) {
-        if (operation.action === 'skip') {
-            skipped += 1;
-            continue;
-        }
-        plannedOperations += 1;
-    }
-    return { plannedOperations, skipped };
+    return summarizeMaterializationPlan(plan);
 }
 export function toCodexExtensionOperations(plan) {
     return plan.operations.map((operation) => ({
@@ -540,3 +561,10 @@ export function toCodexExtensionOperations(plan) {
         roleName: operation.roleName,
     }));
 }
+export const codexMaterializationExtension = {
+    provider: 'codex',
+    computePlan(context) {
+        return computeCodexProjectExtensionPlan(context.scopeRoot, context.canonicalEntries, context.allowedCanonicalPaths, context.options);
+    },
+    applyPlan: applyCodexProjectExtensionPlan,
+};

package/dist/providers/cursor/codec/catalog.d.ts

@@ -0,0 +1,18 @@
+export type CursorPinSyntaxFamily = 'gpt-reasoning' | 'claude-effort' | 'composer-fast' | 'grok-effort-fast';
+export interface CursorPinGateEvidence {
+    gate: 'g01';
+    probeName: string;
+    disposition: 'approved';
+}
+export interface CursorModelPinMapping {
+    ladderModelId: string;
+    frontmatterModel: string;
+    syntaxFamily: CursorPinSyntaxFamily;
+    gateEvidence: CursorPinGateEvidence;
+    catalogue: boolean;
+}
+export declare const CURSOR_MODEL_PIN_MAPPINGS: readonly [CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping];
+export declare const SUPPORTED_CURSOR_ROLE_TARGETS: CursorModelPinMapping[];
+export declare const SUPPORTED_CURSOR_BASE_ROLES: readonly ["oat-phase-implementer", "oat-reviewer"];
+export declare function findCursorModelPinMapping(ladderModelId: string): CursorModelPinMapping | undefined;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/providers/cursor/codec/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,eAAe,GACf,eAAe,GACf,kBAAkB,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,qBAAqB,CAAC;IACpC,YAAY,EAAE,qBAAqB,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;CACpB;AA0BD,eAAO,MAAM,yBAAyB,oWA2Ee,CAAC;AAEtD,eAAO,MAAM,6BAA6B,yBAEzC,CAAC;AAEF,eAAO,MAAM,2BAA2B,oDAG9B,CAAC;AAEX,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,GACpB,qBAAqB,GAAG,SAAS,CAInC"}

package/dist/providers/cursor/codec/catalog.js

@@ -0,0 +1,39 @@
+function approvedMapping(ladderModelId, frontmatterModel, syntaxFamily, options = {}) {
+    return {
+        ladderModelId,
+        frontmatterModel,
+        syntaxFamily,
+        gateEvidence: {
+            gate: 'g01',
+            probeName: options.probeName ??
+                `oat-pin-probe-${ladderModelId.replaceAll('.', '-')}`,
+            disposition: 'approved',
+        },
+        catalogue: options.catalogue ?? true,
+    };
+}
+export const CURSOR_MODEL_PIN_MAPPINGS = [
+    approvedMapping('composer-2.5', 'composer-2.5[fast=true]', 'composer-fast'),
+    approvedMapping('composer-2.5-fast', 'composer-2.5[fast=true]', 'composer-fast', { catalogue: false }),
+    approvedMapping('claude-sonnet-5-high', 'claude-sonnet-5[effort=high]', 'claude-effort'),
+    approvedMapping('gpt-5.6-luna-high', 'gpt-5.6-luna[reasoning=high]', 'gpt-reasoning'),
+    approvedMapping('gpt-5.6-luna-xhigh', 'gpt-5.6-luna[reasoning=xhigh]', 'gpt-reasoning'),
+    approvedMapping('cursor-grok-4.5-high', 'grok-4.5[effort=high,fast=false]', 'grok-effort-fast'),
+    approvedMapping('cursor-grok-4.5-high-fast', 'grok-4.5[effort=high,fast=true]', 'grok-effort-fast', { catalogue: false }),
+    approvedMapping('gpt-5.6-terra-high', 'gpt-5.6-terra[reasoning=high]', 'gpt-reasoning'),
+    approvedMapping('gpt-5.6-sol-medium', 'gpt-5.6-sol[reasoning=medium]', 'gpt-reasoning'),
+    approvedMapping('gpt-5.6-sol-high', 'gpt-5.6-sol[reasoning=high]', 'gpt-reasoning'),
+    approvedMapping('claude-fable-5-thinking-high', 'claude-fable-5[effort=high]', 'claude-effort'),
+    approvedMapping('claude-fable-5-thinking-xhigh', 'claude-fable-5[effort=xhigh]', 'claude-effort'),
+    approvedMapping('claude-fable-5-xhigh', 'claude-fable-5[effort=xhigh]', 'claude-effort', { catalogue: false }),
+    approvedMapping('gpt-5.6-sol-xhigh', 'gpt-5.6-sol[reasoning=xhigh]', 'gpt-reasoning'),
+    approvedMapping('gpt-5.6-sol-max', 'gpt-5.6-sol[reasoning=max]', 'gpt-reasoning'),
+];
+export const SUPPORTED_CURSOR_ROLE_TARGETS = CURSOR_MODEL_PIN_MAPPINGS.filter((mapping) => mapping.catalogue);
+export const SUPPORTED_CURSOR_BASE_ROLES = [
+    'oat-phase-implementer',
+    'oat-reviewer',
+];
+export function findCursorModelPinMapping(ladderModelId) {
+    return CURSOR_MODEL_PIN_MAPPINGS.find((mapping) => mapping.ladderModelId === ladderModelId);
+}