Struct DecisionEvidence 

pub struct DecisionEvidence {
    pub log_bayes_factor: f64,
    pub regime_contribution: f64,
    pub timing_contribution: f64,
    pub rate_contribution: f64,
    pub explanation: String,
}

Evidence supporting a scheduler decision with Bayes factors.

This captures the mathematical reasoning behind coalesce/apply decisions, providing explainability for the regime-adaptive scheduler.

Bayes Factor Interpretation

The log_bayes_factor represents log10(P(evidence|apply_now) / P(evidence|coalesce)):

• Positive values favor immediate apply (respond quickly)
• Negative values favor coalescing (wait for more events)
• |LBF| > 1 is “strong” evidence, |LBF| > 2 is “decisive”

Example

let evidence = DecisionEvidence {
    log_bayes_factor: 1.5,  // Strong evidence to apply now
    regime_contribution: 0.8,
    timing_contribution: 0.5,
    rate_contribution: 0.2,
    explanation: "Steady regime with long idle interval".to_string(),
};

Fields

log_bayes_factor: f64

Log10 Bayes factor: positive favors apply, negative favors coalesce.

regime_contribution: f64

Contribution from regime detection (Steady vs Burst).

timing_contribution: f64

Contribution from timing (dt_ms, time since last render).

rate_contribution: f64

Contribution from event rate.

explanation: String

Human-readable explanation of the decision.

Implementations

impl DecisionEvidence

pub fn favor_apply(regime: Regime, dt_ms: f64, event_rate: f64) -> Self

Evidence strongly favoring immediate apply (Steady regime, long idle).

pub fn favor_coalesce(regime: Regime, dt_ms: f64, event_rate: f64) -> Self

Evidence favoring coalescing (Burst regime, high rate).

pub fn forced_deadline(deadline_ms: f64) -> Self

Evidence for a forced deadline decision.

pub fn to_jsonl( &self, run_id: &str, screen_mode: ScreenMode, cols: u16, rows: u16, event_idx: u64, ) -> String

Serialize to JSONL format.

pub fn is_strong(&self) -> bool

Check if evidence strongly supports the action (|LBF| > 1).

pub fn is_decisive(&self) -> bool

Check if evidence decisively supports the action (|LBF| > 2).

Trait Implementations

impl Clone for DecisionEvidence

fn clone(&self) -> DecisionEvidence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecisionEvidence

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

Formats the value using the given formatter.