Struct Calibration 

pub struct Calibration { /* private fields */ }

Process-wide calibration store. Concurrent updates are serialized via a single RwLock because update events are rare (one per keyhog calibrate invocation or per verifier outcome) and the locked region is constant-time. We deliberately don’t shard via DashMap - the persisted artifact is small enough that contention is a non-issue.

Implementations

impl Calibration

pub fn empty() -> Self

pub fn load(path: &Path) -> Self

pub fn save(&self, path: &Path) -> Result<()>

pub fn record_true_positive(&self, detector_id: &str)

Record a true positive for detector_id (α += 1).

kimi-confidence audit: bare alpha += 1 would panic in debug and wrap to 0 in release once a single detector accumulates 2^32 observations. Wrapping to 0 silently mutes a previously reliable detector (posterior mean drops to 0.0/1.0 = 0). Use saturating_add so the worst case is a frozen counter at u32::MAX, which keeps the posterior mean correct.

pub fn record_false_positive(&self, detector_id: &str)

Record a false positive for detector_id (β += 1). Same saturating_add rationale as [record_true_positive].

pub fn confidence_multiplier(&self, detector_id: &str) -> f64

Return the posterior mean for detector_id, falling back to 0.5 when no observations exist (uniform prior over a never-calibrated detector). The scanner’s confidence-scoring path consumes this value, but only when calibration is explicitly opted in (see the module-level coherence contract) so default / benchmark scans stay deterministic.

pub fn counters(&self, detector_id: &str) -> BetaCounters

Return the full counters for detector_id (defaults to Beta(1, 1)).

pub fn entries(&self) -> Vec<(String, BetaCounters)>

Iterate every recorded (detector_id, counters). Useful for keyhog calibrate --show.

Trait Implementations

impl Debug for Calibration

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

Formats the value using the given formatter.

impl Default for Calibration

fn default() -> Calibration

Returns the “default value” for a type.