Skip to main content

13 — Evaluation, benchmarks & drift.

Promotion of a model, a prompt, a tool, an agent, or an ontology change is gated by the evaluation harness. Evaluation is continuous, not a release activity. Drift is a first-class signal that demotes assets without operator action.

13.1 Eval suite types

Golden

Frozen labelled set — Hand-curated inputs with known correct outputs. Owned by the tenant. Versioned. Tested every promotion.

Replay

Recent runs — A sample of recent production runs replayed against the candidate. Shows real-world behavioural delta.

Adversarial

Probes — Prompt-injection, evidence forgery, jailbreaks, ontology poisoning. Block on regression.

Calibration

Probability quality — Reliability diagrams, ECE / MCE, isotonic-fit deviation. Bounds confidence drift.

13.2 Bench score math

The bench score is a weighted aggregate over an eval pack. Each suite has a weight; each suite has its own metric.

13.3 Eval gate algorithm

Fig. 13.1 — Eval gate algorithm. A candidate must pass minimum probes, regression, score, and adversarial probes before entering shadow; shadow + canary precede full enable.

13.4 Drift sigma

Drift is measured continuously on the live signal. The default detector is a sigma probe over a trailing baseline window.

13.5 Watched metrics

13.6 Reviewer-pairwise eval

For workflows where ground truth is operator judgement (e.g. nuanced narrative interpretation), the harness uses pairwise human comparison. Reviewers see (A, B) draws — candidate vs baseline — without knowing which is which. Win rate is reported with a confidence interval; a candidate must beat baseline at the configured significance level to pass.

13.7 Eval result lineage

Every eval run is itself an immutable artefact: it has a content hash, a frozen pack version, a candidate id, a baseline id, the dataset snapshot id, the runtime versions used, and the resulting metrics. Promotion decisions cite the eval result by id; rollbacks cite the original eval result.

13.8 Continuous eval cadence

  • Full pack — on every change to model / prompt / tool / agent / ontology.
  • Regression suite — nightly per asset class.
  • Drift probes — every current_window (typically 1 day) per asset.
  • Calibration refit — weekly for extractors / classifiers.
  • Adversarial sweep — weekly + on threat-intel update.

13.9 Failure attribution

When a Decision is later judged wrong by a reviewer, the harness back-attributes:
  1. which step in the plan caused the deviation,
  2. which model lineage was active at that step,
  3. which prompt revision and retrieval snapshot were used,
  4. whether the verifier should have caught it (and if so, which rule pack and rule).
Attributions feed the eval suites, the verifier rule packs, and the routing policy.