# World-Class Provider Route Ledger

Append provider matrix probes, degraded-mode findings, and doctor next-action evidence here.

## 2026-04-29 - baseline matrix gap

Hypothesis: Provider route unit coverage exists, but a reproducible matrix ledger is required for world-class claims.
Baseline: Provider route quality is covered by unit tests, but the matrix and failure ledger do not yet exist.
Change: Record the gap before implementing route-matrix probes.
Commands: Planned gates include node --test tests/provider-runtime-core.test.mjs, node --test tests/provider-control-text.test.mjs, node --test tests/provider-cli.test.mjs, npm run verify:provider:smoke, npm run test:route-policy.
Result: Not yet measured in this ledger.
Decision: retry
Reason: Provider flexibility cannot be claimed without deterministic evidence across official, compatible, degraded, blocked, missing-credential, and migration states.
Follow-up: Add matrix rows and record pass/fail evidence per route state.

## 2026-04-30 - deterministic provider route matrix

| route | status | transport | quality tier | workflow mode | native tool claim | next action | failure class |
| --- | --- | --- | --- | --- | --- | --- | --- |
| official-anthropic | ready | anthropic_messages | native | full_native | available | Keep route enabled and record release evidence. | none |
| openai-compatible-responses | ready | openai_responses | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| anthropic-compatible-proxy | ready | anthropic_messages | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| gpt-codex-route | ready | openai_responses | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| chat-only-route | chat_only | anthropic_messages | chat_only | chat_only | unavailable | Use a route that validates Anthropic tool_use or full Responses function calling before relying on task/team workflows. | tool_calling_unverified |
| degraded-partial-native | degraded | anthropic_messages | degraded | strict_compat | partial-strict-recovery | Run /provider validate or /provider matrix again after changing the model slot or gateway configuration. | partial_native_tooling |
| blocked-route | blocked | anthropic_messages | blocked | chat_only | unavailable | Check the provider URL, credential, and model name before retrying validation. | route_unvalidated |
| missing-credentials | blocked | anthropic_messages | blocked | chat_only | unavailable | Add a provider credential, then rerun provider doctor and matrix. | missing_credentials |
| legacy-myclaude-migration | ready | anthropic_messages | compatible | compat_native | available-through-adapter | Import legacy myclaude profile into Clavue provider profiles, then verify the active route. | legacy_migration |

Result: 5/9 routes are release-ready; degraded, chat-only, blocked, missing-credential, and legacy migration states have explicit next actions.
Decision: keep

## 2026-05-01 - offline-contract provider route matrix

Evidence mode: offline-contract

| route | evidence mode | status | transport | quality tier | workflow mode | native tool claim | next action | failure class |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| official-anthropic | offline-contract | ready | anthropic_messages | native | full_native | available | Keep route enabled and record release evidence. | none |
| openai-compatible-responses | offline-contract | ready | openai_responses | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| anthropic-compatible-proxy | offline-contract | ready | anthropic_messages | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| gpt-codex-route | offline-contract | ready | openai_responses | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| chat-only-route | offline-contract | chat_only | anthropic_messages | chat_only | chat_only | unavailable | Use a route that validates Anthropic tool_use or full Responses function calling before relying on task/team workflows. | tool_calling_unverified |
| degraded-partial-native | offline-contract | degraded | anthropic_messages | degraded | strict_compat | partial-strict-recovery | Run /provider validate or /provider matrix again after changing the model slot or gateway configuration. | partial_native_tooling |
| blocked-route | offline-contract | blocked | anthropic_messages | blocked | chat_only | unavailable | Check the provider URL, credential, and model name before retrying validation. | route_unvalidated |
| missing-credentials | offline-contract | blocked | anthropic_messages | blocked | chat_only | unavailable | Add a provider credential, then rerun provider doctor and matrix. | missing_credentials |
| legacy-myclaude-migration | offline-contract | ready | anthropic_messages | compatible | compat_native | available-through-adapter | Import legacy myclaude profile into Clavue provider profiles, then verify the active route. | legacy_migration |

Result: 5/9 routes are release-ready in offline-contract evidence; degraded, chat-only, blocked, missing-credential, and legacy migration states have explicit next actions.
Decision: keep

## 2026-05-01 - offline-contract provider route matrix

Evidence mode: offline-contract

| route | evidence mode | status | transport | quality tier | workflow mode | native tool claim | next action | failure class |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| official-anthropic | offline-contract | ready | anthropic_messages | native | full_native | available | Keep route enabled and record release evidence. | none |
| openai-compatible-responses | offline-contract | ready | openai_responses | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| anthropic-compatible-proxy | offline-contract | ready | anthropic_messages | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| gpt-codex-route | offline-contract | ready | openai_responses | compatible | compat_native | available-through-adapter | Keep route enabled and record release evidence. | none |
| chat-only-route | offline-contract | chat_only | anthropic_messages | chat_only | chat_only | unavailable | Use a route that validates Anthropic tool_use or full Responses function calling before relying on task/team workflows. | tool_calling_unverified |
| degraded-partial-native | offline-contract | degraded | anthropic_messages | degraded | strict_compat | partial-strict-recovery | Run /provider validate or /provider matrix again after changing the model slot or gateway configuration. | partial_native_tooling |
| blocked-route | offline-contract | blocked | anthropic_messages | blocked | chat_only | unavailable | Check the provider URL, credential, and model name before retrying validation. | route_unvalidated |
| missing-credentials | offline-contract | blocked | anthropic_messages | blocked | chat_only | unavailable | Add a provider credential, then rerun provider doctor and matrix. | missing_credentials |
| legacy-myclaude-migration | offline-contract | blocked | anthropic_messages | compatible | compat_native | available-through-adapter | Import legacy myclaude profile into Clavue provider profiles, then verify the active route. | legacy_migration |

Result: 4/9 routes are release-ready in offline-contract evidence; degraded, chat-only, blocked, missing-credential, and legacy migration states have explicit next actions.
Decision: keep
