Embedding Pipeline Service  ·  View 19 of 22  ·  Operations

Contract Lifecycle

Seven states a contract passes through, and the loop that closes when drift proposes its replacement.

Editable source SVG draw.io All views
Proposed digest pinned, priced Building shadow index, dual-write Gated recall@10 vs outgoing Serving alias points here Superseded 21-day rollback window Retired storage reclaimed in 7 d Under watch drift + query shift Embedding contract accepted estimate completeness + oldest chunk alias flip, per tenant a better model, or drift no rollback needed evidence kept 13 months proposes the next contract Contract Lifecycle — The Loop That Keeps Retrieval Current Decision point Application we own Security / platform Data store External / third party Risk / gap The loop closes through drift: the signal that retires a contract is the same signal that justifies proposing its replacement. v 1.0 · owner Data & AI Platform Architecture · date 2026-10

Why this is a loop, not a pipeline

  • The signal that retires a contract — drift, a query mix that moved, a better model — is the same signal that justifies proposing the next one.
  • An architecture in which a model change is routine tracks the state of the art. One in which it is a project is two years behind within two years, with no moment at which anyone decided to let that happen.
  • Superseded is a real state with a 21-day duration, not a label. Rollback exists only while it lasts.

Gates between states

  • Proposed → Building requires a priced estimate that someone accepted.
  • Building → Gated requires completeness and an oldest-unmigrated-chunk age inside budget.
  • Gated → Serving requires recall@10 within 2 points of the outgoing contract. Completeness alone never opens this gate.

Evidence that outlives the contract

  • Evaluation runs and drift series are kept 13 months, so a slow regression across two consecutive migrations is visible rather than lost at each cutover.
  • Alias flips, index retirements and evaluation overrides are immutably audited, because they are the operations that change what every user sees.