Struct RankConfidence 

pub struct RankConfidence {
    pub confidence: f64,
    pub gap_to_next: f64,
    pub stability: RankStability,
}

Confidence level for a ranking position.

Derived from distribution-free conformal prediction: we compute nonconformity scores (score gaps) and calibrate them against the empirical distribution of all gaps in the result set.

Invariants

1. confidence is in [0.0, 1.0].
2. A gap of zero always yields Unstable stability.
3. Deterministic: same scores → same confidence.

Fields

confidence: f64

Probability that this item truly belongs at this rank position. Computed as the fraction of score gaps that are smaller than the gap between this item and the next.

gap_to_next: f64

Absolute score gap to the next-ranked item (0.0 if last or tied).

stability: RankStability

Stability classification derived from gap analysis.

Trait Implementations

impl Clone for RankConfidence

fn clone(&self) -> RankConfidence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RankConfidence

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

Formats the value using the given formatter.

impl Display for RankConfidence

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

Formats the value using the given formatter.