@open-agent-toolkit/cli 0.3.9 → 0.3.10

package/assets/bundle-metadata.json

@@ -1,4 +1,4 @@
 {
   "schemaVersion": 1,
-  "oatVersion": "0.3.9"
+  "oatVersion": "0.3.10"
 }

package/assets/config/dispatch-matrix-recommendation.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-09-25.1",
+  "version": "2026-10-01.1",
   "providers": {
     "codex": {
       "economy": {
@@ -39,17 +39,17 @@
         "candidates": [
           {
             "harness": "codex",
-            "model": "gpt-6-sol",
+            "model": "gpt-6.1-sol",
             "effort": "low"
           },
           {
             "harness": "codex",
-            "model": "gpt-6-sol",
+            "model": "gpt-6.1-sol",
             "effort": "medium"
           },
           {
             "harness": "codex",
-            "model": "gpt-6-sol",
+            "model": "gpt-6.1-sol",
             "effort": "high"
           }
         ]
@@ -58,7 +58,7 @@
         "candidates": [
           {
             "harness": "codex",
-            "model": "gpt-6-sol",
+            "model": "gpt-6.1-sol",
             "effort": "xhigh"
           },
           {
@@ -80,7 +80,7 @@
           "haiku",
           {
             "harness": "claude",
-            "model": "claude-sonnet-5",
+            "model": "claude-sonnet-5-5",
             "effort": "medium"
           }
         ]

package/assets/docs/cli-utilities/configuration.md

@@ -497,11 +497,11 @@ The example above is illustrative rather than a copy of the bundled ladder; its
 tiers are trimmed for readability.
 
 The bundled recommendation covers 11 Codex model/effort combinations: GPT-6
-Luna at `low` through `max`, GPT-6 Sol at `low` through `high` plus `xhigh`,
+Luna at `low` through `max`, GPT-6.1 Sol at `low` through `high` plus `xhigh`,
 and GPT-6 Astra at `high` and `xhigh`.
 Claude covers `haiku`, plus explicit Sonnet, Opus, and Fable
 model/effort pairs. Effort-pinned Claude cells require a recognized versioned
-model ID (`fable-5-1`, `fable-5`, `opus-5-5`, `sonnet-5`,
+model ID (`fable-5-1`, `fable-5`, `opus-5-5`, `sonnet-5-5`, `sonnet-5`,
 `opus-4-7`, `opus-4-6`, or `sonnet-4-6`) or a matching
 `ANTHROPIC_DEFAULT_<FAMILY>_MODEL` pin. A custom provider pin must declare
 matching capability through `<PIN>_SUPPORTED_CAPABILITIES`: `effort` enables
@@ -513,14 +513,17 @@ Model-only Claude aliases remain compatible through the per-call model argument
 and report `effortAxis: not-applicable` because the Agent API exposes no
 per-call effort argument. The recommendation carries 16 Cursor candidates
 across four tiers, drawn from a materialization
-catalogue with 26 catalogued multi-family flat IDs spanning Composer, Claude
-(Sonnet, Opus 5.5, Fable 5, and Fable 5.1), GPT, and Grok 4.5 and 4.6; the two figures differ because some
+catalogue with 31 catalogued multi-family flat IDs spanning Composer, Claude
+(Sonnet 5, Sonnet 5.5, Opus 5.5, Fable 5, and Fable 5.1), GPT, and Grok 4.5 and 4.6; the two figures differ because some
 approved mappings stay materializable without being recommended. An explicit
-mapping connects each flat ladder ID to a separate bracket-form frontmatter
-model; configuration and skills never derive or normalize either form.
+mapping connects each flat ladder ID to its verified frontmatter model.
+Existing mappings keep their bracket selectors; Sonnet 5.5 uses per-pin
+verified exact IDs. The 31 mappings produce 62 pinned role variants.
+Configuration and skills never derive selectors or admit arbitrary flat IDs.
 
 The corresponding pinned Codex variant catalogue includes
-`gpt-5.6-luna-high`, `gpt-5.6-terra-xhigh`, `gpt-5.6-sol-high`, and
+`gpt-6-1-sol-high` and `gpt-6-1-sol-max`, alongside compatible older targets
+such as `gpt-5.6-luna-high`, `gpt-5.6-terra-xhigh`, `gpt-5.6-sol-high`, and
 `gpt-5.6-sol-max`. Configuration selects from that materialized catalogue; it
 does not construct an unregistered role during dispatch.
 
@@ -664,7 +667,8 @@ the exact registered role, pinned child, or resolver-returned model argument.
 
 `oat doctor` compares configured Cursor flat IDs with the current Cursor
 catalogue and reports availability drift. This check is diagnostic: catalogue
-presence does not prove that a bracket-form definition pin was honored.
+presence does not prove that a definition pin was honored, whether its
+selector is bracket-form or an approved exact ID.
 
 Each shipped mapping has mapping-specific native-launch evidence, but Cursor
 can silently fallback when account, plan, or administration constraints prevent

package/assets/docs/cli-utilities/workflow-gates.md

@@ -241,7 +241,7 @@ line. The reviewer's resolver stamp describes the project reviewer policy, so
 gate-originated artifacts label it as the policy view:
 
 ```markdown
-**Dispatch audit (policy view):** `Dispatch: scope=p01 action=review role=reviewer ... target=oat-reviewer-gpt-6-sol-high`
+**Dispatch audit (policy view):** `Dispatch: scope=p01 action=review role=reviewer ... target=oat-reviewer-gpt-6-1-sol-high`
 ```
 
 The gate reads reviewer stamps (`action=review role=reviewer`) from audit lines

package/assets/docs/contributing/updating-model-guidance.md

@@ -26,7 +26,9 @@ they choose to adopt a newer recommendation.
 
 A model can remain supported for a user's explicit configuration without being
 recommended by the new ladder. For example, this refresh keeps GPT-5.6 Codex
-and Cursor targets available while preferring GPT-6 in Codex. Claude Opus 4.8
+and Cursor targets available while preferring GPT-6.1 Sol and GPT-6 Luna in
+Codex. GPT-6 Sol remains supported for explicit compatibility configurations.
+Claude Opus 4.8
 and 5.0 have left current supported generations and recommendations; historical
 probe records can still describe past behavior, clearly labeled as historical.
 
@@ -34,7 +36,11 @@ probe records can still describe past behavior, clearly labeled as historical.
 
 Check the provider's official model documentation and the local runtime before
 editing an ID or effort range. The [OpenAI model catalog](https://developers.openai.com/api/docs/models)
-lists GPT-6 Astra, Sol, and Luna. The
+lists GPT-6.1 Sol and GPT-6 Astra, Sol, and Luna. The
+[GPT-6.1 Sol model page](https://developers.openai.com/api/docs/models/gpt-6.1-sol)
+identifies `gpt-6.1-sol` and supports `low`, `medium`, `high`, `xhigh`, and
+`max`; `none` and `minimal` are not supported efforts for this family. Direct
+API tool calls require the Responses API. The
 [Astra model page](https://developers.openai.com/api/docs/models/gpt-6-astra)
 names `gpt-6-astra` and documents `low`, `medium`, `high`, `xhigh`, and `max`;
 compare it with the installed Codex runtime model cache for the exact names and
@@ -42,7 +48,11 @@ local effort set. Catalog presence establishes support, not relative task
 quality. The
 [Anthropic Opus 5.5 documentation](https://www.anthropic.com/claude-opus-5-5)
 names `claude-opus-5-5`; confirm a Claude Code invocation reports that exact
-assistant model before admitting it to the Claude catalog. Claude subagent
+assistant model before admitting it to the Claude catalog. The
+[Sonnet 5.5 overview](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
+and [effort reference](https://platform.claude.com/docs/en/build-with-claude/effort)
+identify `claude-sonnet-5-5` and its five low-through-max efforts. Verify
+Claude Code identity separately. Claude subagent
 `model` and `effort` frontmatter select a per-agent route; see the
 [Claude Code subagent fields](https://code.claude.com/docs/en/sub-agents).
 An API model announcement alone does not prove a third-party harness supports
@@ -66,14 +76,32 @@ The positive Sonnet control resolved, while invalid family and effort controls
 fell back to defaults. Five Opus 5.5 mappings are now approved for desktop
 subagents; the CLI result alone does not establish that the same bracket syntax
 works as a CLI top-level `--model` argument. Likewise, do not add GPT-6
-Cursor targets until that runtime lists and verifies them.
+or GPT-6.1 Cursor targets until that runtime lists and verifies them.
 
 A 2026-09-25 desktop 3.21.18 probe added Grok 4.6 and Fable 5.1 mappings
 and moved the bundled Cursor ladder to them. The same probe showed Grok 4.7
-resolves only bare flat IDs, never bracket selectors, so it stays out of the
-catalogue; see [Verifying Cursor Pins](verifying-cursor-pins.md). See [Dispatch Policy](../workflows/projects/dispatch-ceiling.md#cursor-evidence-authority)
+resolves only bare flat IDs, never bracket selectors. It still needs its own
+approved registry entry and complete per-pin evidence before admission; see [Verifying Cursor Pins](verifying-cursor-pins.md). See [Dispatch Policy](../workflows/projects/dispatch-ceiling.md#cursor-evidence-authority)
 for the distinction between catalog, configured mapping, and runtime identity.
 
+The October 1 refresh migrates Codex Sol defaults and examples to
+`gpt-6.1-sol` while preserving existing effort choices, including medium for
+intelligent recon. Claude Economy moves to `claude-sonnet-5-5` medium by user
+direction. GPT-6 Sol and Sonnet 5 remain explicitly supported. Cursor lists
+Sonnet 5.5 flat IDs at low through max. Cursor 3.22.12 native probes matched
+those exact IDs at start, Shell execution, and stop while every Sonnet 5.5
+bracket pin fell back to the account default. The existing Opus low control
+matched; unknown-family and Sonnet `ultra` exact-ID controls fell back. The
+fixture summary and event records at
+`packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01{,-events}.jsonl`
+retain both rounds. Ship explicit, evidence-backed exact-ID mappings for that family;
+keep existing bracket mappings. An exact-ID mapping requires the same per-pin
+native evidence and controls as a bracket mapping. Do not enable generic
+pass-through of CLI IDs. Cursor does not list GPT-6 Sol or
+GPT-6.1 Sol in the observed catalog. Do not carry Codex model IDs into Cursor
+configurations. These selector changes do not import a separate vault policy
+refresh or claim newly measured task-performance gains.
+
 ## Change and Validate
 
 1. Update the supported catalog for each verified runtime and its tests. Preserve

package/assets/docs/contributing/verifying-cursor-pins.md

@@ -7,7 +7,8 @@ description: 'Runbook for probe-verifying a Cursor model pin before shipping it:
 
 A Cursor model pin maps an OAT ladder model ID to the frontmatter selector that
 materialized role files carry, for example `gpt-5.6-sol-medium` to
-`gpt-5.6-sol[reasoning=medium]`. Adding one to
+`gpt-5.6-sol[reasoning=medium]`, or the verified exact ID
+`claude-sonnet-5-5-medium`. Adding one to
 `packages/cli/src/providers/cursor/codec/catalog.ts` requires evidence that
 Cursor actually resolves that selector to the intended model.
 
@@ -81,10 +82,22 @@ flat IDs such as `grok-4.7-medium` resolved exactly. Two lessons follow:
   control and probe non-default rungs. Here even `effort=low,fast=false`
   landed on the high-fast default.
 
-Approved mappings are bracket-form only
-(`DR-260718-explicit-cursor-pin-mapping`), so Grok 4.7 has no mapping until
-that decision is revisited. The redacted evidence is in the same fixtures
-directory.
+The 2026-10-01 revision of `DR-260718-explicit-cursor-pin-mapping` permits
+verified exact-ID entries as well as bracket selectors. Grok 4.7 remains
+outside the shipped catalog until its own entry is added and approved. The
+redacted evidence is in the same fixtures directory.
+
+The 2026-10-01 Sonnet 5.5 probe on Cursor 3.22.12 confirmed the same syntax
+distinction: every `claude-sonnet-5-5[effort=...]` selector fell back to
+`grok-4.7-high-fast`, but all five exact IDs
+`claude-sonnet-5-5-low|medium|high|xhigh|max` resolved correctly. Both rounds
+included a working Opus 5.5 low control and unknown-family and unsupported-effort
+controls that fell back. The summary and 64 correlated native events are
+retained beside the earlier fixtures.
+
+[Cursor documents specific model IDs and bracket parameters](https://cursor.com/docs/subagents#model-configuration).
+Choose a candidate from the live catalog, then probe its exact frontmatter
+spelling. Documentation and catalog presence do not replace native evidence.
 
 ## Prerequisites
 
@@ -272,10 +285,19 @@ approved it:
 
 ```ts
 approvedMapping(
-  'gpt-5.6-sol-medium',
-  'gpt-5.6-sol[reasoning=medium]',
-  'gpt-reasoning',
-  { probeName: 'zz-pin-probe-sol56-medium', verifiedAt: '2026-07-25', evidencePath: '...' },
+  'claude-sonnet-5-5-medium',
+  'claude-sonnet-5-5-medium',
+  'explicit-model-id',
+  {
+    probeName: 'zz-pin-probe-sonnet55-flat-medium',
+    probeRecord: {
+      submittedSelector: 'claude-sonnet-5-5-medium',
+      resolvedModel: 'claude-sonnet-5-5-medium',
+      verifiedAt: '2026-10-01',
+      evidencePath:
+        'packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl',
+    },
+  },
 ),
 ```
 
@@ -287,6 +309,13 @@ than inheriting an approval that never covered the new selector.
 Retain the raw payloads alongside the summary. They are the primary evidence;
 the summary is an interpretation of them.
 
+For an exact-ID mapping, use the `explicit-model-id` syntax family and a
+mapping-specific probe record. The frontmatter selector must equal the ladder
+ID, and the independently captured submitted selector and resolved model must
+agree with both. Missing or mismatched evidence must fail materialization;
+there is no generic model-ID pass-through. Preserve rejected selector results
+and control observations alongside the successful rungs.
+
 ## Cleanup
 
 Delete every temporary artifact:

package/assets/docs/provider-sync/providers.md

@@ -26,11 +26,11 @@ description: 'Provider-specific path mappings for Claude, Cursor, Copilot, Gemin
     - Interactive `oat init` and `oat status` ask for an individual disposition for each unresolved Cursor-local skill: adopt it into `.agents/skills` or keep it Cursor-only and remember the exact path in sync config
     - Keep-local is blocked when a canonical skill has the same name because Cursor does not document a safe duplicate-resolution order
     - During upgrades, OAT removes only verified clean legacy managed skill views. Changed or replaced views are preserved, detached from manifest ownership, and offered for migration.
-    - Sync materializes pinned Markdown definitions for both `oat-phase-implementer` and `oat-reviewer` in addition to the base roles, which sync like any other canonical agent at both scopes. Each generated name keeps the configured flat ladder ID, while an explicit verified mapping writes the separate bracket-form frontmatter model. OAT never derives one form from the other.
+    - Sync materializes pinned Markdown definitions for both `oat-phase-implementer` and `oat-reviewer` in addition to the base roles, which sync like any other canonical agent at both scopes. Each generated name keeps the configured flat ladder ID, while an explicit verified mapping writes its frontmatter model: a bracket-form selector for existing families or an exact ID for Sonnet 5.5. The supported catalogue contains 31 pins and 62 pinned role variants. OAT never derives a selector from the ladder ID or passes through an unregistered ID.
     - Generated definitions carry `supported-catalogue`, `project-config`, or `user-config` ownership. Project and supported output lives in the tracked `.cursor/agents` view; user-owned output lives under `~/.cursor/agents`. Cleanup reconciles only the applicable owner.
     - Managed dispatch requires `providers.cursor.dispatchArgs.variant` and launches that exact resolver-selected native agent type first. Skills do not pass a Task-level model argument or normalize Cursor model strings.
     - Cursor may silently fallback when a definition pin cannot be honored. Variant acceptance therefore establishes launcher-owned `configured` provenance only; runtime identity remains `not-reported` unless independently observed.
-    - `oat doctor` checks whether each flat ID is still present in the current Cursor catalogue and reports availability drift. Catalogue availability is diagnostic and does not prove that a definition-level bracket pin ran as configured.
+    - `oat doctor` checks whether each flat ID is still present in the current Cursor catalogue and reports availability drift. Catalogue availability is diagnostic and does not prove that a definition-level pin ran as configured.
     - Rule files render as `.cursor/rules/*.mdc`
 
 === "Copilot"
@@ -59,7 +59,7 @@ description: 'Provider-specific path mappings for Claude, Cursor, Copilot, Gemin
       - `.codex/agents/<role>.toml`
       - `.codex/config.toml` (`[features] multi_agent = true`, `[agents.<role>]` upserts)
     - Codex role files include OAT managed provenance headers and are regenerated by `oat sync --scope project|user|all`
-    - Project sync writes and maintains the version-controlled supported catalogue: GPT-6 Luna, Sol, and Astra at `low`, `medium`, `high`, `xhigh`, and `max`; GPT-5.6 Luna and Terra through `xhigh`; and GPT-5.6 Sol through `max`. Both `oat-phase-implementer` and `oat-reviewer` receive each supported pair (56 pinned variants). Sync writes files; it does not create a Git commit.
+    - Project sync writes and maintains the version-controlled supported catalogue: GPT-6.1 Sol and GPT-6 Luna, Sol, and Astra at `low`, `medium`, `high`, `xhigh`, and `max`; GPT-5.6 Luna and Terra through `xhigh`; and GPT-5.6 Sol through `max`. Both `oat-phase-implementer` and `oat-reviewer` receive each supported pair (66 pinned variants). Sync writes files; it does not create a Git commit.
     - Custom targets follow configuration provenance: user-config targets write only under `~/.codex`; shared, repo-local, and active-project targets write under the project's tracked `.codex` view.
     - User sync loads only the bundled canonical `oat-phase-implementer` and `oat-reviewer` definitions needed to expand user-config targets. It does not enable general user-agent mirroring, and it refuses stale user-role cleanup if either managed definition is unavailable.
     - Generated variants carry `supported-catalogue`, `user-config`, or `project-config` ownership. Cleanup removes stale entries only for the owner being reconciled and preserves other scopes plus unrelated Codex entries.
@@ -67,7 +67,7 @@ description: 'Provider-specific path mappings for Claude, Cursor, Copilot, Gemin
     - A single role can be materialized directly with `oat providers codex materialize <agent-name> --model <model-id> --effort <reasoning-effort>`; `--agent-path` selects a specific canonical markdown agent, `--role-name` overrides the generated role name, and `--scope user` writes a user-config-owned role.
     - Aggregate Codex config drift metadata (`aggregateConfigHash`) is emitted in sync/status codex extension output and intentionally not stored as a separate manifest row
     - Sync-time materialization is best effort; managed workflow correctness uses exact registered roles or a fresh child pinned to the resolved model plus reasoning effort with canonical role instructions. After a successful provider-visible file change, OAT conservatively advises starting a new Codex session so it has an opportunity to load the role. This repository policy is not a Codex hot-reload contract, an application-process restart requirement, or proof that the new session exposed the role.
-    - Codex `max` is a first-class dispatch effort. It is supported for GPT-6 Luna, Sol, and Astra, plus GPT-5.6 Sol, for both implementer and reviewer roles.
+    - Codex `max` is a first-class dispatch effort. It is supported for GPT-6.1 Sol, GPT-6 Luna, Sol, and Astra, plus GPT-5.6 Sol, for both implementer and reviewer roles.
     - Codex multi-agent dispatch uses config-defined roles (`[agents.<name>]`) and `agent_type`
     - Codex subagent workflows require `[features] multi_agent = true` in active Codex config layers
     - Default managed Codex execution requires root (depth 0) → phase implementer (depth 1). `agents.max_depth >= 2` enables optional nested phase-agent work; sync and direct materialization still merge that capability floor without lowering a higher target value.

package/assets/docs/workflows/projects/dispatch-ceiling.md

@@ -85,13 +85,15 @@ Run the same command without `--dry-run` to replace bundled cells. Use
 `--shared` or `--local` instead when that scope owns the ladder. Add
 `--keep-existing` to fill only missing cells and preserve existing choices.
 
-Version `2026-09-25.1` is the current bundled recommendation. It prefers
-GPT-6 Luna and Sol in Codex, then Sol xhigh, Astra high, and Astra xhigh in
+Version `2026-10-01.1` is the current bundled recommendation. It prefers
+GPT-6 Luna and GPT-6.1 Sol in Codex, then Sol 6.1 xhigh, Astra high, and Astra xhigh in
 Codex Frontier. Astra's task advantage has not been measured locally; this is
 an explicit user-directed preference, not acceptance by the separately
-maintained model-selection policy. Opus 5.5 low/medium/high remains in Claude High.
+maintained model-selection policy. Sonnet 5.5 medium replaces Sonnet 5 medium
+in Claude Economy; the older generation stays supported for explicit cells.
+Opus 5.5 low/medium/high remains in Claude High.
 The Claude low option suits bounded intelligent recon in Balanced or High;
-medium remains the implementation starting point under High. GPT-5.6 targets remain
+medium remains the implementation starting point under High. GPT-6 Sol and GPT-5.6 targets remain
 supported for explicit Codex and Cursor configurations. Cursor's preferred
 ladder interleaves verified GPT-5.6 and Opus 5.5 mappings: Balanced adds
 Opus 5.5 low above Terra high, High orders Sol medium, Opus low, Sol high,
@@ -249,19 +251,23 @@ oat_dispatch_policy:
 The bundled ladder is a curated subset of the supported targets:
 
 - **Codex:** GPT-6 Luna at `low` through `max` across Economy and Balanced;
-  GPT-6 Sol at `low` through `high` in High and `xhigh` in Frontier; then
+  GPT-6.1 Sol at `low` through `high` in High and `xhigh` in Frontier; then
   GPT-6 Astra at `high` and `xhigh` in Frontier. Astra and Sol remain supported
-  at `low`, `medium`, `high`, `xhigh`, and `max`, while GPT-5.6 variants remain
+  at `low`, `medium`, `high`, `xhigh`, and `max`, while GPT-6 Sol and GPT-5.6 variants remain
   available outside this preferred ladder.
-- **Claude:** `haiku` and Sonnet 5 at Economy/Balanced, Opus 5.5 at High and
-  Frontier, and Fable 5.1 at Frontier.
+- **Claude:** `haiku` and Sonnet 5.5 medium at Economy; Opus 5.5 low at
+  Balanced, low/medium/high at High, and xhigh/max at Frontier; Fable 5.1
+  high ends Frontier. Sonnet 5 remains supported for explicit configurations.
 - **Cursor:** the preferred ladder uses approved Composer 2.5, GPT-5.6, Grok
   4.6, Opus 5.5, and Fable 5.1 targets. The catalogue maps each flat ladder ID
-  to its separately verified bracket-form frontmatter model. Grok 4.6 (`low`
+  to its separately verified frontmatter model. Sonnet 5.5 exact-ID pins
+  remain supported outside the ladder; existing families keep their bracket
+  selectors. Grok 4.6 (`low`
   through `xhigh`) and Fable 5.1 (`low` through `max`, thinking variants) were
   approved from a 2026-09-25 [native desktop probe](../../contributing/verifying-cursor-pins.md);
   targets outside the ladder remain available for explicit selection. Grok
-  4.7 has no approved mapping because it ignores bracket selectors.
+  4.7 stays outside the shipped catalogue pending its own approved mapping
+  and per-pin evidence; exact-ID support does not admit arbitrary CLI IDs.
 
 The final candidate in a named tier defines that tier's reviewer ceiling. Lower
 reviewer selection requires a separate reviewed contract; a normal reviewer
@@ -363,9 +369,9 @@ branch replaces, rather than supplements, preferred selection.
 
 An effort-pinned Claude candidate must establish the exact generation and that
 generation's supported effort. Current directly recognized generations include
-`claude-fable-5-1`, `claude-fable-5`, `claude-opus-5-5`, `claude-sonnet-5`,
+`claude-fable-5-1`, `claude-fable-5`, `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-sonnet-5`,
 `claude-opus-4-7`, `claude-opus-4-6`, and `claude-sonnet-4-6`.
-Opus 5.5 supports `low`, `medium`, `high`, `xhigh`, and `max`; consult the
+Opus 5.5 and Sonnet 5.5 support `low`, `medium`, `high`, `xhigh`, and `max`; consult the
 [updating guide](../../contributing/updating-model-guidance.md) before adding
 further generations or rungs. Retired Opus 5.0 and 4.8 are no longer directly
 recognized for effort-pinned dispatch.
@@ -413,8 +419,9 @@ Cursor selection, pin mapping, catalogue availability, and runtime identity are
 separate evidence layers:
 
 - The candidate ladder and resolver use an opaque flat ID.
-- The materialized definition uses the mapping's explicit bracket-form
-  frontmatter model.
+- The materialized definition uses the mapping's explicit frontmatter model,
+  either a verified bracket selector or a separately verified exact ID.
+  Sonnet 5.5 uses exact IDs; existing families keep their bracket mappings.
 - Mapping-specific native-launch evidence authorizes the shipped mapping data.
   An approved mapping may carry a probe record whose `submittedSelector` must
   equal the mapping's `frontmatterModel` and whose `resolvedModel` must equal

package/assets/docs/workflows/projects/implementation-execution.md

@@ -389,8 +389,11 @@ Provider controls remain exact: Codex uses
 `providers.claude.dispatchArgs.variant` for an effort-pinned target and
 `providers.claude.dispatchArgs.model` only for a legacy model-only target; and
 Cursor uses `providers.cursor.dispatchArgs.variant`. Cursor launches that exact
-resolver-selected native agent type first; the flat ID and bracket-form pin
+resolver-selected native agent type first; the flat ID and frontmatter pin
 remain inside the explicit mapping and are never normalized by workflow prose.
+A mapping may retain a verified bracket-form selector or use a separately
+verified exact ID, as Sonnet 5.5 does. Exact IDs require an approved mapping
+and native probe evidence; catalog presence alone never enables pass-through.
 The launcher records this selection as `configured`, while runtime identity
 remains `not-reported` without independent observation. Only a pre-start native
 role-selection rejection permits another target-preserving route.

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.3.9",
-  "docs-config": "0.3.9",
-  "docs-theme": "0.3.9",
-  "docs-transforms": "0.3.9"
+  "cli": "0.3.10",
+  "docs-config": "0.3.10",
+  "docs-theme": "0.3.10",
+  "docs-transforms": "0.3.10"
 }

package/assets/skills/oat-dispatch-subagents/SKILL.md

@@ -5,7 +5,7 @@ disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read
 metadata:
-  version: 1.2.10
+  version: 1.2.11
 ---
 
 # Dispatching OAT Subagents

package/assets/skills/oat-dispatch-subagents/references/provider-cursor.md

@@ -46,8 +46,11 @@ prohibited.
 
 Outer lifecycle implementer and reviewer dispatch uses the exact
 `providers.cursor.dispatchArgs.variant` returned by the lifecycle resolver.
-The resolver maps an opaque flat model ID and owns the bracket-form model pin
-inside the materialized definition; skills never parse, normalize, or
+The resolver maps an opaque flat model ID to the mapping's explicit frontmatter
+pin inside the materialized definition. Existing families keep their verified
+bracket-form pins; Sonnet 5.5 uses verified exact-ID pins. Each exact ID needs
+its own native evidence and approved registry entry: this is not generic
+pass-through of any CLI catalog ID. Skills never parse, normalize, or
 reconstruct either model string.
 
 1. Require a non-empty resolver-returned variant for managed dispatch.

package/assets/skills/oat-project-implement/SKILL.md

@@ -7,7 +7,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Bash(oat:*), Bash(oat project log:*), Glob, Grep, AskUserQuestion, Task
 metadata:
-  version: 2.3.14
+  version: 2.3.15
 ---
 
 # Implementation Phase

package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md

@@ -727,7 +727,7 @@ Dispatch policy: {policy}; selected={selected value | none}; cap={value | none}
 ```text
 Dispatch policy: balanced; selected=xhigh; cap=xhigh (codex, enforced — variant oat-phase-implementer-gpt-5-6-terra-xhigh)
 Dispatch policy: inherit host defaults; selected=none; cap=none (codex, advisory — base role follows provider default)
-Dispatch policy: balanced; selected=claude-sonnet-5/high; cap=claude-sonnet-5/high (claude, enforced — native variant oat-phase-implementer-claude-claude-sonnet-5-high)
+Dispatch policy: balanced; selected=claude-sonnet-5-5/high; cap=claude-sonnet-5-5/high (claude, enforced — native variant oat-phase-implementer-claude-claude-sonnet-5-5-high)
 Cursor materialized-variant example: Dispatch policy: frontier; selected=gpt-5.6-sol-max; cap=gpt-5.6-sol-max (cursor, enforced — native variant oat-phase-implementer-gpt-5-6-sol-max)
 Dispatch policy: unresolved; selected=none; cap=none (codex, advisory — policy set but no value resolved)
 ```

package/assets/skills/oat-project-plan-writing/SKILL.md

@@ -5,7 +5,7 @@ disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read, Write, Glob, Grep
 metadata:
-  version: 1.2.33
+  version: 1.2.34
 ---
 
 # Plan Writing Contract
@@ -121,8 +121,8 @@ asking to write anything:
 
 | Provider        | Economy                                                   | Balanced                                                              | High                                                                                                              | Frontier                                                                                                                  |
 | --------------- | --------------------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| Codex           | gpt-6-luna/low, gpt-6-luna/medium, gpt-6-luna/high        | gpt-6-luna/xhigh, gpt-6-luna/max                                      | gpt-6-sol/low, gpt-6-sol/medium, gpt-6-sol/high                                                                   | gpt-6-sol/xhigh, gpt-6-astra/high, gpt-6-astra/xhigh                                                                      |
-| Claude          | haiku, claude-sonnet-5/medium                             | claude-opus-5-5/low                                                   | claude-opus-5-5/low, claude-opus-5-5/medium, claude-opus-5-5/high                                                 | claude-opus-5-5/xhigh, claude-opus-5-5/max, claude-fable-5-1/high                                                         |
+| Codex           | gpt-6-luna/low, gpt-6-luna/medium, gpt-6-luna/high        | gpt-6-luna/xhigh, gpt-6-luna/max                                      | gpt-6.1-sol/low, gpt-6.1-sol/medium, gpt-6.1-sol/high                                                             | gpt-6.1-sol/xhigh, gpt-6-astra/high, gpt-6-astra/xhigh                                                                    |
+| Claude          | haiku, claude-sonnet-5-5/medium                           | claude-opus-5-5/low                                                   | claude-opus-5-5/low, claude-opus-5-5/medium, claude-opus-5-5/high                                                 | claude-opus-5-5/xhigh, claude-opus-5-5/max, claude-fable-5-1/high                                                         |
 | Cursor (opaque) | `composer-2.5`, `gpt-5.6-luna-high`, `gpt-5.6-luna-xhigh` | `cursor-grok-4.6-medium`, `gpt-5.6-terra-high`, `claude-opus-5-5-low` | `gpt-5.6-sol-medium`, `claude-opus-5-5-low`, `gpt-5.6-sol-high`, `claude-opus-5-5-medium`, `claude-opus-5-5-high` | `gpt-5.6-sol-xhigh`, `gpt-5.6-sol-max`, `claude-opus-5-5-high`, `claude-opus-5-5-xhigh`, `claude-fable-5-1-thinking-high` |
 
 In an interactive run, ask the user to select the owning scope explicitly

package/assets/skills/subagent-orchestration/SKILL.md

@@ -4,7 +4,7 @@ description: Use when delegating work to subagents or choosing a model for a tas
 compatibility: Self-contained; no OAT installation required.
 user-invocable: true
 metadata:
-  version: 1.0.10
+  version: 1.0.11
 ---
 
 # Subagent Orchestration

package/assets/skills/subagent-orchestration/references/evidence-and-refresh.md

@@ -1,10 +1,10 @@
 # Evidence and Refresh Policy
 
 ```yaml
-guidance_version: 2026-09-24
-last_verified: 2026-09-24
-review_after: 2026-10-08
-stale_after: 2026-10-23
+guidance_version: 2026-10-01
+last_verified: 2026-10-01
+review_after: 2026-10-15
+stale_after: 2026-10-30
 ```
 
 This file governs dated provider examples. It does not override a live catalog,
@@ -17,7 +17,9 @@ authorization boundary.
 - `review-required`: older than 45 days, a newer family is observed, or a material control, price, tool, context, alias, or harness change is detected.
 - `stale`: older than 90 days, named models are unavailable or deprecated, or the launching surface can no longer express the recorded controls.
 
-The named routes were refreshed against provider catalogues on 2026-09-23.
+The October 1 availability refresh adds GPT-6.1 Sol and Sonnet 5.5 support;
+it migrates active Codex Sol selectors by user direction while preserving
+efforts. Earlier provider observations retain their own dates.
 The benchmark observations below remain dated to 2026-07-25 and require
 review before making a new cross-provider performance claim. Each provider
 reference carries its own verification date; availability refresh does not
@@ -83,8 +85,9 @@ publish a provider-independent effort conversion.
   explicit user direction. No local task evaluation establishes an Astra
   advantage, and this preference is not acceptance by the separately
   maintained model-selection policy.
-- GPT-6 Sol and Luna are selectable in the current Codex catalogue and are
-  the default new-work routes in `provider-codex.md`. GPT-5.6 Sol/Luna/Terra
+- GPT-6.1 Sol and GPT-6 Luna are the default new-work selectors in
+  `provider-codex.md`. The Sol migration preserves existing effort choices,
+  including medium for intelligent recon. GPT-6 Sol and GPT-5.6 Sol/Luna/Terra
   remain supported for explicit configurations. The July independent coding
   data on GPT-5.6 Luna/Terra supported a mechanical floor of Luna high; this
   is historical evidence, not a measured GPT-6 performance comparison.
@@ -93,7 +96,12 @@ publish a provider-independent effort conversion.
   evidence. Earlier Opus 5 effort observations are historical and do not
   establish an Opus 5.5 benchmark result. Consequence adds independent review
   rather than automatically raising effort.
-- Sonnet 5 is a conditional route when measured latency, throughput, access,
+- Sonnet 5.5 is a supported Claude conditional route and the user-selected
+  Economy medium candidate. Cursor 3.22.12 native probes matched Sonnet 5.5
+  exact-ID pins; its bracket-form pins fell back. Every pin requires its own
+  approved evidence and registry entry. Sonnet 5 remains
+  supported for compatibility and established workflows. Sonnet is a
+  conditional route when measured latency, throughput, access,
   rate limits, or end-to-end workload economics win. Fable 5 is an
   eligibility-gated specialist; its missing-domain-concept or long-horizon
   reviewer instantiation remains provisional, and zero-data-retention
@@ -195,6 +203,10 @@ component it cannot resolve. Probe a non-default rung as well, or a result that
 merely matches the family default cannot distinguish an honored parameter from
 an ignored one.
 
+An exact-ID Cursor pin meets the same evidence gate as a bracket-form pin;
+CLI catalog presence alone never permits generic pass-through. The Sonnet 5.5
+refresh uses explicit exact-ID mappings because its bracket-form pins fell back.
+
 The six Cursor `claude-opus-5` and `claude-opus-4-8` mappings shipped on
 2026-07-25 met this gate; their resolved identities are listed in
 `provider-cursor.md`.

package/assets/skills/subagent-orchestration/references/provider-claude.md

@@ -1,7 +1,7 @@
 ---
-guidance_version: 2026-09-23
-last_verified: 2026-09-23
-review_after: 2026-12-22
+guidance_version: 2026-10-01
+last_verified: 2026-10-01
+review_after: 2026-12-30
 ---
 
 # Claude Model Selection
@@ -17,7 +17,12 @@ the dated model examples below. Launch mechanics for OAT dispatch live in
   high-volume, mechanically verified work.
 - `claude-opus-5-5`: normal substantive route and the default for
   interpretation-heavy implementation, hard reasoning, and consequential work.
-- `claude-sonnet-5`: conditional route when measured latency, throughput,
+- `claude-sonnet-5-5`: supported conditional route at `low`, `medium`,
+  `high`, `xhigh`, and `max`; qualify it against the relevant Opus route on
+  representative work. The bundled Economy tier selects medium by explicit
+  user direction; this is separate from task-performance qualification.
+- `claude-sonnet-5`: supported compatibility and established-workflow route
+  when measured latency, throughput,
   access, rate limits, or established-workflow economics beat the relevant
   Opus route.
 - `claude-fable-5-1`: eligibility-gated specialist for a directly relevant
@@ -45,6 +50,12 @@ host.
   is the bottleneck or an evaluated long-horizon workload benefits. Max is
   exceptional and requires a workload-specific effort sweep or an explicit
   quality-first exception.
+- Sonnet 5.5: availability and its five efforts are documented in the
+  [Sonnet 5.5 overview](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
+  and [effort reference](https://platform.claude.com/docs/en/build-with-claude/effort).
+  The existing conditional-route posture applies; availability is not an
+  evaluated workload ranking. Check the installed Claude Code version and
+  returned assistant model before launch.
 - Sonnet 5: use medium or high only when measured latency, throughput, access,
   or workload economics justify the conditional route. Do not preserve xhigh
   or max as generic workhorse settings.
@@ -65,13 +76,13 @@ These routes are dated guidance and benchmark-derived routing hypotheses.
 Evaluate them on representative local work before treating fine boundaries as
 stable.
 
-| Task class               | Default                               | Economy                                                | Escalation                                            | Floor notes                                                                                     |
-| ------------------------ | ------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
-| `mechanical-recon`       | Haiku 4.5                             | Same, with strict output and mechanical verification   | Opus 5.5 medium                                       | Haiku is below floor for semantic audits and silent-miss-prone exploration.                     |
-| `intelligent-recon`      | Opus 5.5 low                          | Sonnet 5 medium/high only when its measured route wins | Opus 5.5 medium; high when deeper reasoning is needed | Verify silent-miss-prone conclusions; do not use Sonnet low for open-ended recon.               |
-| `default-implementation` | Opus 5.5 medium                       | Sonnet 5 medium/high for evaluated bounded throughput  | Opus 5.5 high                                         | Fable is not a routine implementation or economy route.                                         |
-| `hard-reasoning`         | Opus 5.5 high                         | Opus 5.5 medium only after narrowing and evaluation    | Opus 5.5 xhigh for a reasoning-depth bottleneck       | Use max only after a workload-specific effort sweep.                                            |
-| `consequential`          | Opus 5.5 high plus independent review | No routine economy route                               | Opus 5.5 xhigh when deeper reasoning is also required | Consequence adds review and root authorization; it does not automatically require xhigh or max. |
+| Task class               | Default                               | Economy                                                  | Escalation                                            | Floor notes                                                                                     |
+| ------------------------ | ------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| `mechanical-recon`       | Haiku 4.5                             | Same, with strict output and mechanical verification     | Opus 5.5 medium                                       | Haiku is below floor for semantic audits and silent-miss-prone exploration.                     |
+| `intelligent-recon`      | Opus 5.5 low                          | Sonnet 5.5 medium/high only when its measured route wins | Opus 5.5 medium; high when deeper reasoning is needed | Verify silent-miss-prone conclusions; do not use Sonnet low for open-ended recon.               |
+| `default-implementation` | Opus 5.5 medium                       | Sonnet 5.5 medium/high for evaluated bounded throughput  | Opus 5.5 high                                         | Fable is not a routine implementation or economy route.                                         |
+| `hard-reasoning`         | Opus 5.5 high                         | Opus 5.5 medium only after narrowing and evaluation      | Opus 5.5 xhigh for a reasoning-depth bottleneck       | Use max only after a workload-specific effort sweep.                                            |
+| `consequential`          | Opus 5.5 high plus independent review | No routine economy route                                 | Opus 5.5 xhigh when deeper reasoning is also required | Consequence adds review and root authorization; it does not automatically require xhigh or max. |
 
 ## Root and Subagent Cost Posture
 
@@ -108,7 +119,9 @@ verified before selection.
 
 Eligibility filters the candidate set before capability or economy is compared.
 A route that fails one of these gates is unavailable regardless of benchmark
-standing. The non-Opus constraints are dated observations; reverify against the live
+standing. The table below records existing generations; it does not establish Sonnet 5.5
+retention, service tiers, or context limits. Verify those separately.
+The non-Opus constraints are dated observations; reverify against the live
 schema and the organization's actual plan before launch. Do not transfer Opus 5
 service-tier or retention claims to Opus 5.5 without fresh evidence.
 

package/assets/skills/subagent-orchestration/references/provider-codex.md

@@ -1,7 +1,7 @@
 ---
-guidance_version: 2026-09-24
-last_verified: 2026-09-24
-review_after: 2026-12-22
+guidance_version: 2026-10-01
+last_verified: 2026-10-01
+review_after: 2026-12-30
 ---
 
 # Codex and OpenAI Model Selection
@@ -13,16 +13,19 @@ model examples below. Launch mechanics for OAT dispatch live in
 
 ## Current Families
 
-Use verified GPT-6 Sol/Luna model IDs for routine new Codex work. GPT-6 Astra
+Use `gpt-6.1-sol` for new Sol routes and `gpt-6-luna` for bounded Luna work.
+This Sol selector migration preserves the existing task-class effort guidance;
+it does not claim a newly measured workload advantage. GPT-6 Astra
 is a supported Frontier candidate:
 
 - `gpt-6-astra`: Frontier candidate for especially demanding work; the bundled
   recommendation uses high and xhigh, while the supported catalogue also
   permits low, medium, and max;
-- `gpt-6-sol`: high-capability implementation and reasoning route;
+- `gpt-6.1-sol`: high-capability implementation and reasoning route;
 - `gpt-6-luna`: cost-sensitive, bounded work.
 
-Public engineering benchmarks show task-dependent Astra gains over Sol, with
+The earlier public engineering benchmarks show task-dependent Astra gains
+over GPT-6 Sol, with
 cost and runtime tradeoffs; they do not establish a universal replacement. The
 September frontier-release comparison remains review-pending in the separate
 model-selection vault, and no matched OAT workload evaluation has qualified a
@@ -30,8 +33,8 @@ routine default change. Astra's Frontier inclusion is a user-directed
 preference. Keep the Sol task-class defaults below while that evidence is
 reconciled and local task fit is evaluated.
 
-The GPT-5.6 Sol/Luna/Terra targets remain supported for explicit configurations
-and established workloads. Re-evaluate economics and qualitative routing on
+GPT-6 Sol (`gpt-6-sol`) and the GPT-5.6 Sol/Luna/Terra targets remain supported
+for explicit configurations and established workloads. Re-evaluate economics and qualitative routing on
 representative work before carrying over GPT-5.6-specific comparisons.
 
 Direct API specialist routes:
@@ -48,18 +51,24 @@ name includes `codex`.
 ## Dated Task-Class Matrix
 
 These are current task-class starting points, not an evaluated ordering across
-providers or a promise about relative GPT-6 latency and price. All shown
+providers or a promise about relative GPT-6 or GPT-6.1 latency and price. All shown
 model/effort pairs are in the local Codex catalogue.
 
-| Task class               | Default                                    | Escalation                                                            | Floor notes                                                                   |
-| ------------------------ | ------------------------------------------ | --------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
-| `mechanical-recon`       | `gpt-6-luna`, high                         | `gpt-6-sol`, medium                                                   | Lower effort is suitable only when a miss is cheap and mechanically detected. |
-| `intelligent-recon`      | `gpt-6-sol`, medium                        | Sol high                                                              | Preserve verification for silent-miss-prone reconnaissance.                   |
-| `default-implementation` | `gpt-6-sol`, medium                        | Sol high                                                              | Luna is for independently bounded, strongly verified work.                    |
-| `hard-reasoning`         | `gpt-6-sol`, high                          | Sol xhigh                                                             | Narrow the problem before raising effort.                                     |
-| `consequential`          | `gpt-6-sol`, high, plus independent review | Sol xhigh for a reasoning-depth bottleneck; max only after evaluation | The root retains consequential authorization.                                 |
-
-The bundled Frontier ladder ends with Astra xhigh after Sol xhigh and Astra
+| Task class               | Default                                      | Escalation                                                            | Floor notes                                                                   |
+| ------------------------ | -------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `mechanical-recon`       | `gpt-6-luna`, high                           | `gpt-6.1-sol`, medium                                                 | Lower effort is suitable only when a miss is cheap and mechanically detected. |
+| `intelligent-recon`      | `gpt-6.1-sol`, medium                        | Sol high                                                              | Preserve verification for silent-miss-prone reconnaissance.                   |
+| `default-implementation` | `gpt-6.1-sol`, medium                        | Sol high                                                              | Luna is for independently bounded, strongly verified work.                    |
+| `hard-reasoning`         | `gpt-6.1-sol`, high                          | Sol xhigh                                                             | Narrow the problem before raising effort.                                     |
+| `consequential`          | `gpt-6.1-sol`, high, plus independent review | Sol xhigh for a reasoning-depth bottleneck; max only after evaluation | The root retains consequential authorization.                                 |
+
+[OpenAI's GPT-6.1 Sol model reference](https://developers.openai.com/api/docs/models/gpt-6.1-sol)
+identifies `gpt-6.1-sol` and the supported efforts `low`, `medium`, `high`,
+`xhigh`, and `max`. Do not emit `none` or `minimal` for this family. For direct
+API tool calls, use the Responses API. Verify the launching Codex runtime
+independently of API availability.
+
+The bundled Frontier ladder ends with Astra xhigh after Sol 6.1 xhigh and Astra
 high. The supported Astra and Sol effort sets both end at max, so Sol max
 remains available for explicit configuration even though it is no longer in
 the bundled Frontier recommendation.

package/assets/skills/subagent-orchestration/references/provider-cursor.md

@@ -1,12 +1,14 @@
 ---
-guidance_version: 2026-09-25
-last_verified: 2026-09-25
-review_after: 2026-12-24
+guidance_version: 2026-10-01
+last_verified: 2026-10-01
+review_after: 2026-12-30
 catalog_basis:
   Cursor desktop 3.21.18 resolved Grok 4.6 and Fable 5.1 effort selectors in
   native subagent hooks, and Grok 4.7 only as bare flat IDs; Cursor desktop
   3.20.14 resolved all five Opus 5.5 effort selectors; GPT-6 Sol/Luna were
-  absent from the observed Cursor catalog
+  absent from the observed Cursor catalog; the 2026-10-01 CLI catalog lists
+  Sonnet 5.5 flat IDs; Cursor desktop 3.22.12 matched five exact-ID Sonnet
+  5.5 pins while every bracket-form Sonnet 5.5 probe fell back
 ---
 
 # Cursor Model Selection
@@ -51,8 +53,8 @@ Cursor desktop 3.20.14 resolved all five `claude-opus-5-5[effort=...]`
 selectors to corresponding flat IDs in native hooks; on 2026-09-25, Cursor
 desktop 3.21.18 did the same for Grok 4.6 and Fable 5.1. See the
 probe records at `packages/cli/src/providers/cursor/codec/__fixtures__/README.md`.
-GPT-6 Sol/Luna were absent from the observed Cursor catalogue, so their Codex
-availability does not authorize Cursor routes.
+GPT-6 Sol/Luna and GPT-6.1 Sol were absent from the 2026-10-01 Cursor CLI
+catalogue, so their Codex availability does not authorize Cursor routes.
 
 | Task class               | Default                                                             | Economy                                            | Escalation                                                  | Floor notes                                                                                                      |
 | ------------------------ | ------------------------------------------------------------------- | -------------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
@@ -90,8 +92,34 @@ Grok 4.7 has no approved mapping. Every bracket spelling tried
 (`grok-4.7[effort=...]` with and without `fast`, `reasoning=`, and
 `grok-4-7[...]`) fell back to that same account default, which is easy to
 mistake for success because it is itself a Grok 4.7 model. Only bare flat IDs
-such as `grok-4.7-medium` resolved as requested, and the approved catalogue
-does not emit bare IDs. Do not pin Grok 4.7 until a mapping is approved.
+such as `grok-4.7-medium` resolved as requested, but Grok 4.7 still lacks
+its own approved registry entry and complete per-pin evidence. It stays outside
+the shipped catalogue. This is a family-specific admission gap, not a blanket
+prohibition of exact-ID pins.
+
+## Sonnet 5.5 Exact-ID Pin Evidence
+
+The 2026-10-01 Cursor CLI catalogue lists
+`claude-sonnet-5-5-low|medium|high|xhigh|max`. In Cursor desktop 3.22.12,
+every `claude-sonnet-5-5[effort=...]` probe fell back to the account default,
+`grok-4.7-high-fast`. Exact-ID pins
+`claude-sonnet-5-5-low|medium|high|xhigh|max` instead matched their requested
+rungs in `subagentStart`, Shell `preToolUse`, and `subagentStop`. The Opus 5.5
+low positive control matched its established mapping; unknown-family and
+Sonnet 5.5 `ultra` exact-ID controls both fell back to `grok-4.7-high-fast`.
+Catalog visibility or a subagent self-report does not establish those results.
+The 16 correlated summary rows and 64 native events from both rounds live in
+`packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl`
+and `cursor-pin-probe-2026-10-01-events.jsonl`; the adjacent `README.md` records
+provenance and excludes unrelated discovery calls.
+
+Sonnet 5.5 mappings write the verified exact ID as frontmatter `model`.
+Existing Sonnet 5, Opus, Fable, GPT, and Grok mappings retain their independently
+verified selectors. Neither selector form is universally valid: every exact-ID
+mapping requires native hook evidence, non-default-rung and invalid-selector
+controls, and an explicit approved registry entry. There is no generic
+pass-through of flat CLI IDs. See the
+[probe runbook](../../../../apps/oat-docs/docs/contributing/verifying-cursor-pins.md).
 
 ## Historical Opus Cursor Probe Evidence (Retired)
 
@@ -177,8 +205,10 @@ and non-thinking variants.
 - `claude-fable-5-1-thinking-high`: eligible specialist for hard reasoning and
   the bundled Frontier terminal target; xhigh only for evaluated long-horizon
   work. Cursor lists Fable as "NO ZDR"; confirm retention eligibility.
-- `claude-sonnet-5-thinking-high`: strong provider-diversity alternative for
-  normal implementation and agentic work when available.
+- `claude-sonnet-5-5-high`: exact-ID provider-diversity option for normal
+  implementation and agentic work; qualify task performance separately.
+- `claude-sonnet-5-thinking-high`: supported compatibility option for
+  established workflows.
 - `gpt-5.4-mini-medium`: economical general tool and coding worker.
 - `gpt-5.4-nano-medium`: strict extraction, classification, ranking, and simple
   read-only tool calls. Not a semantic repository worker.

package/dist/providers/claude/dispatch-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-envelope.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/dispatch-envelope.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,qBAAqB,EAC3B,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,WAAW,CAAC;AA4FnB,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,aAAa,GAAG,UAAU,CAAC;IACzC,QAAQ,EAAE,uBAAuB,GAAG,cAAc,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,wBAAwB,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAgBD,KAAK,YAAY,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,MAAM,CAWR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,CAAC,CAAC,QAAQ,GAChB,sBAAsB,EAAE,CAM1B;AAsID;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,4BAA4B,CAgC/B;AASD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG;IACpE,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAqDA;AAuDD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC;IAAE,UAAU,EAAE,sBAAsB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAkE7D;AAMD;;;;GAIG;AACH,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAEpC,YACE,UAAU,EAAE,SAAS,sBAAsB,EAAE,EAC7C,OAAO,GAAE,SAAS,MAAM,EAAO,EAyBhC;CACF;AAmBD,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,EAAE,4BAA4B,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,qBAAqB,CA2CxB"}
+{"version":3,"file":"dispatch-envelope.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/dispatch-envelope.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,qBAAqB,EAC3B,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,WAAW,CAAC;AA6FnB,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,aAAa,GAAG,UAAU,CAAC;IACzC,QAAQ,EAAE,uBAAuB,GAAG,cAAc,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,wBAAwB,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAgBD,KAAK,YAAY,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,MAAM,CAWR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,CAAC,CAAC,QAAQ,GAChB,sBAAsB,EAAE,CAM1B;AAsID;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,4BAA4B,CAgC/B;AASD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG;IACpE,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAqDA;AAuDD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC;IAAE,UAAU,EAAE,sBAAsB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAkE7D;AAMD;;;;GAIG;AACH,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAEpC,YACE,UAAU,EAAE,SAAS,sBAAsB,EAAE,EAC7C,OAAO,GAAE,SAAS,MAAM,EAAO,EAyBhC;CACF;AAmBD,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,EAAE,4BAA4B,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,qBAAqB,CA2CxB"}

package/dist/providers/claude/dispatch-envelope.js

@@ -8,6 +8,7 @@ const generationSchema = z.enum([
     'fable-5-1',
     'fable-5',
     'opus-5-5',
+    'sonnet-5-5',
     'sonnet-5',
     'opus-4-7',
     'opus-4-6',

package/dist/providers/claude/targets.d.ts

@@ -4,6 +4,7 @@ declare const CLAUDE_GENERATION_EFFORTS: {
     readonly 'fable-5-1': readonly ["low", "medium", "high", "xhigh", "max"];
     readonly 'fable-5': readonly ["low", "medium", "high", "xhigh", "max"];
     readonly 'opus-5-5': readonly ["low", "medium", "high", "xhigh", "max"];
+    readonly 'sonnet-5-5': readonly ["low", "medium", "high", "xhigh", "max"];
     readonly 'sonnet-5': readonly ["low", "medium", "high", "xhigh", "max"];
     readonly 'opus-4-7': readonly ["low", "medium", "high", "xhigh", "max"];
     readonly 'opus-4-6': readonly ["low", "medium", "high", "max"];

package/dist/providers/claude/targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/targets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,YAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEhF,eAAO,MAAM,mBAAmB,YAC9B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,CACG,CAAC;AAEX,QAAA,MAAM,yBAAyB;;;;;;;;CAQuB,CAAC;AAGvD,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,yBAAyB,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAC9B,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,CAAC;AAEnC,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,mBAAmB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AASD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAkBD,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,qBAAqB,GAAG,IAAI,CAc9B;AA4ID,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,oBAAoB,CAAC,EAClE,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAgBxB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAC3B,sBAAsB,CAoBxB;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAexB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAeT;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,oBAAoB,GAC3B,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlB"}
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/targets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,YAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEhF,eAAO,MAAM,mBAAmB,YAC9B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,CACG,CAAC;AAEX,QAAA,MAAM,yBAAyB;;;;;;;;;CASuB,CAAC;AAGvD,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,yBAAyB,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAC9B,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,CAAC;AAEnC,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,mBAAmB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AASD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAkBD,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,qBAAqB,GAAG,IAAI,CAe9B;AA4ID,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,oBAAoB,CAAC,EAClE,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAgBxB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAC3B,sBAAsB,CAoBxB;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAexB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAeT;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,oBAAoB,GAC3B,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlB"}

package/dist/providers/claude/targets.js

@@ -10,6 +10,7 @@ const CLAUDE_GENERATION_EFFORTS = {
     'fable-5-1': CLAUDE_EFFORT_ORDER,
     'fable-5': CLAUDE_EFFORT_ORDER,
     'opus-5-5': CLAUDE_EFFORT_ORDER,
+    'sonnet-5-5': CLAUDE_EFFORT_ORDER,
     'sonnet-5': CLAUDE_EFFORT_ORDER,
     'opus-4-7': CLAUDE_EFFORT_ORDER,
     'opus-4-6': ['low', 'medium', 'high', 'max'],
@@ -35,7 +36,8 @@ function modelFamily(model) {
 /** Extract a documented effort-capability generation from a provider model ID. */
 export function claudeModelGeneration(model) {
     const normalized = model.toLowerCase().replace(/\[1m\]$/u, '');
-    for (const generation of Object.keys(CLAUDE_GENERATION_EFFORTS)) {
+    const generations = Object.keys(CLAUDE_GENERATION_EFFORTS).sort((left, right) => right.length - left.length);
+    for (const generation of generations) {
         const [family, ...versionParts] = generation.split('-');
         const version = versionParts.join('[-.]');
         const pattern = new RegExp(`(?:^|[./:_-])(?:claude-)?${family}-${version}(?=$|[-@.:/[])`, 'u');

package/dist/providers/codex/codec/shared.d.ts

@@ -11,6 +11,9 @@ export declare const SUPPORTED_CODEX_ROLE_TARGETS: readonly ({
 } | {
     model: string;
     effort: string;
+} | {
+    model: string;
+    effort: string;
 } | {
     model: string;
     effort: "high" | "low" | "medium" | "xhigh";

package/dist/providers/codex/codec/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/providers/codex/codec/shared.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAC3D,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAE7D,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,aAAa,GACb,gBAAgB,CAAC;AAoBrB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;IAyB/B,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5D;AAQD,wBAAgB,oCAAoC,CAAC,OAAO,EAAE;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAiBT;AAgDD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAOT;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAEvB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,MAAM,CAkBR;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAErE"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/providers/codex/codec/shared.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAC3D,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAE7D,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,aAAa,GACb,gBAAgB,CAAC;AAoBrB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;IA6B/B,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5D;AAQD,wBAAgB,oCAAoC,CAAC,OAAO,EAAE;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAiBT;AAgDD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAOT;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAEvB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,MAAM,CAkBR;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAErE"}

package/dist/providers/codex/codec/shared.js

@@ -12,6 +12,10 @@ const STANDARD_SUPPORTED_CODEX_EFFORTS = [
     'xhigh',
 ];
 export const SUPPORTED_CODEX_ROLE_TARGETS = [
+    ...[...STANDARD_SUPPORTED_CODEX_EFFORTS, 'max'].map((effort) => ({
+        model: 'gpt-6.1-sol',
+        effort,
+    })),
     ...[...STANDARD_SUPPORTED_CODEX_EFFORTS, 'max'].map((effort) => ({
         model: 'gpt-6-astra',
         effort,

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

@@ -1,4 +1,4 @@
-export type CursorPinSyntaxFamily = 'gpt-reasoning' | 'claude-effort' | 'composer-fast' | 'grok-effort-fast';
+export type CursorPinSyntaxFamily = 'explicit-model-id' | 'gpt-reasoning' | 'claude-effort' | 'composer-fast' | 'grok-effort-fast';
 /**
  * What a probe submitted and what the harness resolved it to, transcribed from
  * the probe evidence.
@@ -29,7 +29,7 @@ export interface CursorModelPinMapping {
     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, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping];
+export declare const CURSOR_MODEL_PIN_MAPPINGS: readonly [CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, CursorModelPinMapping, 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;

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

@@ -1 +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;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;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;AA+BD,eAAO,MAAM,yBAAyB,6rBA6Se,CAAC;AAEtD,eAAO,MAAM,6BAA6B,yBAEzC,CAAC;AAEF,eAAO,MAAM,2BAA2B,YACtC,uBAAuB,EACvB,cAAc,CACN,CAAC;AAEX,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,GACpB,qBAAqB,GAAG,SAAS,CAInC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,eAAe,GACf,kBAAkB,CAAC;AAEvB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;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;AA+BD,eAAO,MAAM,yBAAyB,gzBAwXe,CAAC;AAEtD,eAAO,MAAM,6BAA6B,yBAEzC,CAAC;AAEF,eAAO,MAAM,2BAA2B,YACtC,uBAAuB,EACvB,cAAc,CACN,CAAC;AAEX,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,GACpB,qBAAqB,GAAG,SAAS,CAInC"}

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

@@ -27,6 +27,51 @@ export const CURSOR_MODEL_PIN_MAPPINGS = [
         },
     }),
     approvedMapping('claude-sonnet-5-high', 'claude-sonnet-5[effort=high]', 'claude-effort', { catalogue: false }),
+    approvedMapping('claude-sonnet-5-5-low', 'claude-sonnet-5-5-low', 'explicit-model-id', {
+        probeName: 'zz-pin-probe-sonnet55-flat-low',
+        probeRecord: {
+            submittedSelector: 'claude-sonnet-5-5-low',
+            resolvedModel: 'claude-sonnet-5-5-low',
+            verifiedAt: '2026-10-01',
+            evidencePath: 'packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl',
+        },
+    }),
+    approvedMapping('claude-sonnet-5-5-medium', 'claude-sonnet-5-5-medium', 'explicit-model-id', {
+        probeName: 'zz-pin-probe-sonnet55-flat-medium',
+        probeRecord: {
+            submittedSelector: 'claude-sonnet-5-5-medium',
+            resolvedModel: 'claude-sonnet-5-5-medium',
+            verifiedAt: '2026-10-01',
+            evidencePath: 'packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl',
+        },
+    }),
+    approvedMapping('claude-sonnet-5-5-high', 'claude-sonnet-5-5-high', 'explicit-model-id', {
+        probeName: 'zz-pin-probe-sonnet55-flat-high',
+        probeRecord: {
+            submittedSelector: 'claude-sonnet-5-5-high',
+            resolvedModel: 'claude-sonnet-5-5-high',
+            verifiedAt: '2026-10-01',
+            evidencePath: 'packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl',
+        },
+    }),
+    approvedMapping('claude-sonnet-5-5-xhigh', 'claude-sonnet-5-5-xhigh', 'explicit-model-id', {
+        probeName: 'zz-pin-probe-sonnet55-flat-xhigh',
+        probeRecord: {
+            submittedSelector: 'claude-sonnet-5-5-xhigh',
+            resolvedModel: 'claude-sonnet-5-5-xhigh',
+            verifiedAt: '2026-10-01',
+            evidencePath: 'packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl',
+        },
+    }),
+    approvedMapping('claude-sonnet-5-5-max', 'claude-sonnet-5-5-max', 'explicit-model-id', {
+        probeName: 'zz-pin-probe-sonnet55-flat-max',
+        probeRecord: {
+            submittedSelector: 'claude-sonnet-5-5-max',
+            resolvedModel: 'claude-sonnet-5-5-max',
+            verifiedAt: '2026-10-01',
+            evidencePath: 'packages/cli/src/providers/cursor/codec/__fixtures__/cursor-pin-probe-2026-10-01.jsonl',
+        },
+    }),
     approvedMapping('claude-opus-5-5-low', 'claude-opus-5-5[effort=low]', 'claude-effort', {
         probeName: 'zz-pin-probe-opus55-low',
         probeRecord: {

package/dist/providers/cursor/codec/mapping-validation.d.ts

@@ -0,0 +1,4 @@
+import type { CursorModelPinMapping } from './catalog.js';
+/** Validate at both target collection and rendering, before any role writes. */
+export declare function assertApprovedCursorModelPinMapping(mapping: CursorModelPinMapping): void;
+//# sourceMappingURL=mapping-validation.d.ts.map

package/dist/providers/cursor/codec/mapping-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-validation.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/mapping-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,gFAAgF;AAChF,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAkCN"}

package/dist/providers/cursor/codec/mapping-validation.js

@@ -0,0 +1,25 @@
+import { CliError } from '../../../errors/index.js';
+/** Validate at both target collection and rendering, before any role writes. */
+export function assertApprovedCursorModelPinMapping(mapping) {
+    if (mapping.gateEvidence.gate !== 'g01' ||
+        mapping.gateEvidence.disposition !== 'approved' ||
+        !mapping.gateEvidence.probeName.trim()) {
+        throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: mapping-specific gate g01 approval is required.`);
+    }
+    if (mapping.syntaxFamily === 'explicit-model-id') {
+        const record = mapping.gateEvidence.probeRecord;
+        if (!/^[a-z0-9]+(?:[.-][a-z0-9]+)*$/.test(mapping.frontmatterModel) ||
+            mapping.frontmatterModel !== mapping.ladderModelId ||
+            !record ||
+            record.submittedSelector !== mapping.frontmatterModel ||
+            record.resolvedModel !== mapping.ladderModelId ||
+            !/^\d{4}-\d{2}-\d{2}$/.test(record.verifiedAt) ||
+            !record.evidencePath.trim()) {
+            throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: explicit model ID requires matching mapping-specific native probe evidence.`);
+        }
+        return;
+    }
+    if (!/\[[^\]]+\]$/.test(mapping.frontmatterModel)) {
+        throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: frontmatter model must include a non-empty bracket segment.`);
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/materialize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAKhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,eAAe,CAAC;CACxB;AA4BD,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,OAAO,EACP,KAAK,GACN,EAAE,6BAA6B,GAAG,uBAAuB,CA8BzD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC;CACxB,GAAG,uBAAuB,EAAE,CAwB5B;AAqCD,wBAAsB,sCAAsC,CAC1D,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Ef"}
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/materialize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAKhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,eAAe,CAAC;CACxB;AAWD,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,OAAO,EACP,KAAK,GACN,EAAE,6BAA6B,GAAG,uBAAuB,CA8BzD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC;CACxB,GAAG,uBAAuB,EAAE,CAwB5B;AAqCD,wBAAsB,sCAAsC,CAC1D,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

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

@@ -3,28 +3,19 @@ import { join } from 'node:path';
 import { CliError } from '../../../errors/index.js';
 import { validateRealPathWithinScope } from '../../../fs/paths.js';
 import YAML from 'yaml';
+import { assertApprovedCursorModelPinMapping } from './mapping-validation.js';
 import { buildCursorMaterializedRoleName, isOatManagedCursorRoleFile, normalizeCursorRoleName, renderCursorManagedComments, } from './shared.js';
 const CURSOR_AGENT_DISCOVERY_DIRECTORIES = [
     '.cursor/agents',
     '.claude/agents',
     '.codex/agents',
 ];
-function assertApprovedMapping(mapping) {
-    if (mapping.gateEvidence.gate !== 'g01' ||
-        mapping.gateEvidence.disposition !== 'approved' ||
-        !mapping.gateEvidence.probeName.trim()) {
-        throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: mapping-specific gate g01 approval is required.`);
-    }
-    if (!/\[[^\]]+\]$/.test(mapping.frontmatterModel)) {
-        throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: frontmatter model must include a non-empty bracket segment.`);
-    }
-}
 function optionalCursorBoolean(agent, field) {
     const value = field === 'readonly' ? agent.readonly : agent.frontmatter[field];
     return typeof value === 'boolean' ? value : undefined;
 }
 export function materializeCursorAgent({ agent, mapping, owner, }) {
-    assertApprovedMapping(mapping);
+    assertApprovedCursorModelPinMapping(mapping);
     const roleName = buildCursorMaterializedRoleName({
         agentName: agent.name,
         ladderModelId: mapping.ladderModelId,

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

@@ -1 +1 @@
-{"version":3,"file":"sync-extension.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/sync-extension.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAIL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EACnC,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAC;AAMnB,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB,CACxE,QAAQ,EACR,qBAAqB,CACtB;IACC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA8B,SAAQ,6BAA6B,CAClF,QAAQ,EACR,qBAAqB,CACtB;IACC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB,CAC9D,QAAQ,EACR,qBAAqB,EACrB,2BAA2B,CAC5B;IACC,UAAU,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAQpE,MAAM,WAAW,kCAAkC;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAiWD,wBAAsB,iCAAiC,CACrD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,cAAc,EAAE,EAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAChC,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,mBAAmB,CAAC,CAmH9B;AA6DD,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,0BAA0B,CAAC,CA4DrC;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAE5E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,GACxB,wBAAwB,EAAE,CAM5B;AAED,eAAO,MAAM,8BAA8B,EAAE,wBAAwB,CACnE,mBAAmB,EACnB,sBAAsB,CAAC,kCAAkC,CAAC,CAY3D,CAAC"}
+{"version":3,"file":"sync-extension.d.ts","sourceRoot":"","sources":["../../../../src/providers/cursor/codec/sync-extension.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAIL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EACnC,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAC;AAOnB,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB,CACxE,QAAQ,EACR,qBAAqB,CACtB;IACC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA8B,SAAQ,6BAA6B,CAClF,QAAQ,EACR,qBAAqB,CACtB;IACC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB,CAC9D,QAAQ,EACR,qBAAqB,EACrB,2BAA2B,CAC5B;IACC,UAAU,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAQpE,MAAM,WAAW,kCAAkC;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAgVD,wBAAsB,iCAAiC,CACrD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,cAAc,EAAE,EAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAChC,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,mBAAmB,CAAC,CAmH9B;AA6DD,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,0BAA0B,CAAC,CA4DrC;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAE5E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,GACxB,wBAAwB,EAAE,CAM5B;AAED,eAAO,MAAM,8BAA8B,EAAE,wBAAwB,CACnE,mBAAmB,EACnB,sBAAsB,CAAC,kCAAkC,CAAC,CAY3D,CAAC"}

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

@@ -12,6 +12,7 @@ import { validateRealPathWithinScope } from '../../../fs/paths.js';
 import { hasMaterializationChanges, summarizeMaterializationPlan, toMaterializationOperations, } from '../../shared/index.js';
 import YAML from 'yaml';
 import { CURSOR_MODEL_PIN_MAPPINGS, SUPPORTED_CURSOR_BASE_ROLES, SUPPORTED_CURSOR_ROLE_TARGETS, } from './catalog.js';
+import { assertApprovedCursorModelPinMapping } from './mapping-validation.js';
 import { assertNoUnmanagedCursorAgentCollisions, materializeCursorAgent, } from './materialize.js';
 import { isOatManagedCursorRoleFile, readOatManagedCursorRoleOwner, readOatManagedCursorRoleName, } from './shared.js';
 const OWNER_PRECEDENCE = {
@@ -29,22 +30,12 @@ function isUserCursorScope(scopeRoot, options) {
     return Boolean(options.userConfigDir &&
         resolve(scopeRoot) === resolve(options.userConfigDir, '..'));
 }
-function assertApprovedMapping(mapping) {
-    if (mapping.gateEvidence.gate !== 'g01' ||
-        mapping.gateEvidence.disposition !== 'approved' ||
-        !mapping.gateEvidence.probeName.trim()) {
-        throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: mapping-specific gate g01 approval is required.`);
-    }
-    if (!/\[[^\]]+\]$/.test(mapping.frontmatterModel)) {
-        throw new CliError(`Cannot materialize Cursor model ${mapping.ladderModelId}: approved mapping must include a non-empty bracket segment.`);
-    }
-}
 function addCursorTarget(ladderModelId, owner, source, targets, mappings) {
     const mapping = mappings.find((candidate) => candidate.ladderModelId === ladderModelId);
     if (!mapping) {
         throw new CliError(`Cannot materialize unknown Cursor model mapping "${ladderModelId}" from ${source}. Add mapping-specific gate g01 evidence before using this target.`);
     }
-    assertApprovedMapping(mapping);
+    assertApprovedCursorModelPinMapping(mapping);
     const existing = targets.get(ladderModelId);
     if (!existing ||
         OWNER_PRECEDENCE[owner] >= OWNER_PRECEDENCE[existing.owner]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.3.9"
+    "@open-agent-toolkit/control-plane": "0.3.10"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",