Struct CoverageReport 

pub struct CoverageReport {
    pub total_pairs_planned: usize,
    pub matched: usize,
    pub coverage: f64,
    pub unmatched_by_reason: BTreeMap<UnmatchedReason, usize>,
    pub unmatched_sample: Vec<UnmatchedSide>,
}

Diagnostic / observability summary of IcMatchResult.

See spec §5.4 for the field contract. All counts mirror the matcher’s already-computed values — this report is a thin pass-through layer with the histogram + sample for auditors / dashboards.

Fields

total_pairs_planned: usize

Total number of distinct IC pairs the manifest planned (sum across all entities of seller-side plans). Mirrors IcMatchResult::total_planned.

matched: usize

Number of fully matched pairs (both sides observed). Equals IcMatchResult::matched.len().

coverage: f64

matched / total_pairs_planned, with 0/0 mapped to 0.0 (mirrors IcMatchResult::coverage so the two stay consistent — see the matcher’s module docs for the rationale).

unmatched_by_reason: BTreeMap<UnmatchedReason, usize>

Histogram of unmatched sides keyed by reason.

Always contains all three UnmatchedReason variants — even when zero — so the schema is stable across runs and dashboards can rely on the keys being present. Keyed by the enum itself (with snake_case serde rename) and stored in a BTreeMap so the JSON output’s iteration order is deterministic.

unmatched_sample: Vec<UnmatchedSide>

Up to UNMATCHED_SAMPLE_CAP unmatched sides for diagnostic triage. The sample is the head of IcMatchResult::unmatched (already sorted by pair_id for determinism) so the same input always produces the same sample.

Trait Implementations

impl Clone for CoverageReport

fn clone(&self) -> CoverageReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CoverageReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CoverageReport

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CoverageReport

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

where __S: Serializer,

Serialize this value into the given Serde serializer.