Eve library

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

Evidence

Revision 1

On this page

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