Struct ShadowRun 

pub struct ShadowRun;

Shadow-run comparison harness.

Runs the same model and event sequence through two independent LabSession instances and compares their frame outputs.

Implementations

impl ShadowRun

pub fn compare<M, MF, SF>( config: ShadowRunConfig, model_factory: MF, scenario_fn: SF, ) -> ShadowRunResult

where M: Model, MF: Fn() -> M, SF: Fn(&mut LabSession<M>),

Run a shadow comparison between baseline and candidate lanes.

Both lanes execute the same scenario_fn with the same seed and configuration. Frame checksums are compared after both runs complete.

The model_factory is called twice (once per lane) to produce independent model instances.

Evidence

Emits structured JSONL to stderr with events:

• shadow.start: comparison parameters
• shadow.lane.done: per-lane summary
• shadow.frame.diverged: each divergent frame
• shadow.verdict: final pass/fail with statistics

pub fn assert_match<M, MF, SF>( config: ShadowRunConfig, model_factory: MF, scenario_fn: SF, ) -> ShadowRunResult

where M: Model, MF: Fn() -> M, SF: Fn(&mut LabSession<M>),

Assert that baseline and candidate produce identical frames.

Convenience wrapper around compare that panics on divergence with a diagnostic message.

Panics

Panics if any frame checksum diverges between lanes.