Struct DiffEvidenceLedger 

pub struct DiffEvidenceLedger { /* private fields */ }

Fixed-capacity ring buffer for diff strategy decisions.

Pre-allocates all storage up front so that record() never allocates on the hot path (the record itself is moved in, not cloned).

Implementations

impl DiffEvidenceLedger

pub fn new(decision_capacity: usize) -> Self

Create a new ledger with the given capacity for decisions.

Transition capacity is set to 1/10 of decision capacity (regime transitions are much rarer than per-frame decisions).

pub fn record(&mut self, record: DiffStrategyRecord)

Record a diff strategy decision. Overwrites oldest when full.

pub fn record_transition(&mut self, transition: RegimeTransition)

Record a regime transition explicitly.

pub fn len(&self) -> usize

Number of decisions stored.

pub fn is_empty(&self) -> bool

Whether the ledger is empty.

pub fn transition_count(&self) -> usize

Number of regime transitions stored.

pub fn current_regime(&self) -> DiffRegime

Current regime.

pub fn decisions(&self) -> impl Iterator<Item = &DiffStrategyRecord>

Iterate over stored decisions in insertion order (oldest first).

pub fn transitions(&self) -> impl Iterator<Item = &RegimeTransition>

Iterate over stored transitions in insertion order (oldest first).

pub fn last_decision(&self) -> Option<&DiffStrategyRecord>

Get the most recent decision.

pub fn export_jsonl(&self) -> String

Export all decisions and transitions as JSONL lines.

pub fn flush_to_sink(&self, sink: &EvidenceSink) -> Result<()>

Flush decisions to an evidence sink.

pub fn clear(&mut self)

Clear all stored decisions and transitions.

Trait Implementations

impl Debug for DiffEvidenceLedger

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.