Struct MarkovPredictor 

pub struct MarkovPredictor<S: Eq + Hash + Clone> { /* private fields */ }

Markov-chain predictor wrapping a TransitionCounter.

Provides prediction queries with confidence-aware blending between observed transition probabilities and a uniform fallback.

Implementations

impl<S: Eq + Hash + Clone> MarkovPredictor<S>

pub fn new() -> Self

Create a predictor with default settings (min_observations=20, no auto-decay).

pub fn with_min_observations(n: u64) -> Self

Create a predictor with a custom observation threshold (no auto-decay).

pub fn with_counter( counter: TransitionCounter<S>, min_observations: u64, ) -> Self

Create a predictor with a pre-loaded counter (e.g., from persistence).

pub fn enable_auto_decay(&mut self, config: DecayConfig)

Enable automatic temporal decay on record_transition() calls.

Every config.interval record calls, all counts are multiplied by config.factor, causing old transition data to fade over time.

pub fn record_transition(&mut self, from: S, to: S)

Record a screen transition.

If auto-decay is enabled, this may trigger a decay cycle after every interval calls.

pub fn predict(&self, current_screen: &S) -> Vec<ScreenPrediction<S>>

Predict likely next screens from current_screen.

Returns predictions sorted by effective probability (descending). Each prediction blends observed and uniform probabilities based on confidence.

pub fn is_cold_start(&self, screen: &S) -> bool

Check whether predictions from screen have insufficient data.

Returns true if fewer than min_observations transitions have been recorded from this screen.

pub fn confidence(&self, screen: &S) -> f64

Confidence level for predictions from screen (0.0..1.0).

Grows linearly from 0 to 1 as observations approach min_observations.

pub fn counter(&self) -> &TransitionCounter<S>

Access the underlying transition counter.

pub fn counter_mut(&mut self) -> &mut TransitionCounter<S>

Mutable access to the transition counter (for merging, decay, etc.).

pub fn min_observations(&self) -> u64

Return the minimum observations threshold.

Trait Implementations

impl<S: Clone + Eq + Hash + Clone> Clone for MarkovPredictor<S>

fn clone(&self) -> MarkovPredictor<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Eq + Hash + Clone> Debug for MarkovPredictor<S>

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

Formats the value using the given formatter.

impl<S: Eq + Hash + Clone> Default for MarkovPredictor<S>

fn default() -> Self

Returns the “default value” for a type.