Struct RefreshLedgerEvidence 

pub struct RefreshLedgerEvidence {
    pub throughput: Vec<RefreshThroughputProfile>,
    pub phase_share: Vec<RefreshPhaseShare>,
    pub dominant_phase: Option<RefreshPhase>,
    pub aggregate_items_processed: u64,
    pub aggregate_duration_ms: u64,
    pub aggregate_items_per_second: Option<f64>,
}

Single-shot derived evidence summary suitable for benchmark comparison and operator dashboards. Computed from a RefreshLedger in O(phases) time with zero allocations beyond the output structs.

Comparing two RefreshLedgerEvidence values across runs is the intended consumer pattern: regression gates assert that aggregate_items_per_second did not drop more than X%, that dominant_phase did not migrate, etc.

Fields

throughput: Vec<RefreshThroughputProfile>

Per-phase throughput. Excludes phases with items_processed == 0 to keep the output focused on phases that actually moved data.

phase_share: Vec<RefreshPhaseShare>

Per-phase wall-clock share. Includes ALL phases that ran (even zero-item phases like a brief Recovery) so the shares sum transparently.

dominant_phase: Option<RefreshPhase>

Phase consuming the largest share of wall time, or None when no phases ran. The “where to optimize next” pointer.

aggregate_items_processed: u64

Total items processed across every phase.

aggregate_duration_ms: u64

Total wall-clock duration in milliseconds (mirrors RefreshLedger.total_duration_ms for ergonomic single-struct access).

aggregate_items_per_second: Option<f64>

Aggregate items/second across the whole refresh; None when aggregate_duration_ms == 0.

Implementations

impl RefreshLedgerEvidence

pub fn compare_to(&self, baseline: &Self) -> RefreshLedgerEvidenceComparison

Compare this evidence summary against a baseline and return a structured regression report. Pure (no I/O); runs in O(phases_baseline + phases_current).

Direction convention: positive duration_delta_pct ⇒ slower in self; positive throughput_delta_pct ⇒ faster in self. Picking these signs (not the opposite) makes the JSON read naturally for benchmark CI (“PR #123 added +12.5% to publish duration”).

Trait Implementations

impl Clone for RefreshLedgerEvidence

fn clone(&self) -> RefreshLedgerEvidence

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RefreshLedgerEvidence

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RefreshLedgerEvidence

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RefreshLedgerEvidence

fn eq(&self, other: &RefreshLedgerEvidence) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RefreshLedgerEvidence

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RefreshLedgerEvidence