# P2-002 evidence pack — learned quality/cost/latency routing

## Implemented control

The learned-router adoption contract accepts training outcomes only when the
environment is exactly `production` and every record preserves request,
provider, model, route-decision, subgroup, quality, cost, latency, calibration
evidence, and observation identity.

The policy requires a positive exploration floor, at least two provider
identities, non-empty hard safety constraints, a deterministic rollback artifact
and trigger, and an exact deterministic-baseline reference.

Adoption then requires exactly one passing offline, shadow, and canary
evaluation. Every stage must bind the same deterministic baseline, include at
least two subgroup result sets, and preserve both p95 and p99 latency/cost tail
analysis.

## Verification and claim boundary

The focused suite passes **8/8** cases covering the passing adoption snapshot,
non-production/unattributed/uncalibrated outcomes, every policy control,
insufficient production volume/provider diversity, missing or failed stages,
baseline mismatch, subgroup collapse, and incomplete tails. Focused ESLint,
contracts TypeScript, targeted package build, pre-commit checks, and V5
documentation validation pass.

The exploration/safety/diversity/rollback control box is complete. The training
and staged-evaluation boxes remain open: the repository contains no authorized
calibrated production outcome corpus and no real offline, shadow, or canary
experiment against a deterministic router. Test fixtures are not training data
or rollout evidence.

## Publication identity

- **Implementation source commit:** `ea922ae92ca78b377776ea064ebfe8d63e8f54a7`
- **Published at:** `2026-07-24T14:38:00Z`

| Artifact                                                       | SHA-256                                                            |
| -------------------------------------------------------------- | ------------------------------------------------------------------ |
| `libs/contracts/src/common/learned-routing-governance.ts`      | `0a54eb5abe4f44bc3e6f3da4b7a50872024991b266076bfafc2af8090d9bb968` |
| `libs/contracts/src/common/learned-routing-governance.spec.ts` | `e6a386bf4b3c401e6f70b7ad826e0b2196f3e460b87239db43fc51192c2a73a3` |
| `libs/contracts/src/common/index.ts`                           | `3023908d715aa5594806bc3e078734a6bde543ba79a40cf3b84363dfed37aedb` |
| `package.json`                                                 | `c0407cdee6aa09f926b57f4f393a241ff35411e27c105f667053632404a8f28c` |
| `.github/workflows/content-slot-contract.yml`                  | `bbb069d0558c1652081049f63388dbd312327d011dbc0c0321bec95382bc6d52` |
