Struct TransitionMap 

pub struct TransitionMap { /* private fields */ }

Tracks topic transitions as a Markov chain. Maps from_topic -> (to_topic -> frequency_count).

Also maintains a learned topic cache that maps raw user messages to canonical topic labels, so repeated patterns skip the LLM.

Implementations

impl TransitionMap

pub fn record(&mut self, from: &str, to: &str)

Record a transition, applying the topic cache if available. If a canonical label exists for a raw topic, uses that instead.

pub fn reinforce(&mut self, from: &str, to: &str)

pub fn decay(&mut self, from: &str, to: &str)

pub fn predict_from(&self, topic: &str, limit: usize) -> Vec<(String, u32)>

Returns the top N predicted topics from a given topic, sorted by frequency descending.

pub fn learn_canonical(&mut self, raw: &str, canonical: &str)

Store a learned mapping from a raw topic to its canonical label.

pub fn get_canonical(&self, raw: &str) -> Option<&String>

Look up a cached canonical label for a raw topic.

pub fn known_topics(&self) -> Vec<String>

Returns the list of known canonical topic labels (deduped).

pub fn topic_cache_size(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn total_transitions(&self) -> usize

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

Save the transition map to a JSON file. Prunes transitions with count below min_count to keep the file from growing unbounded. Uses atomic write (temp file + rename) to avoid corruption.

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

Load a transition map from a JSON file, merging counts into the current map so that patterns accumulate across sessions. Supports both v1 (no topic_cache) and v2 (with topic_cache) formats.

Trait Implementations

impl Clone for TransitionMap

fn clone(&self) -> TransitionMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransitionMap

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

Formats the value using the given formatter.

impl Default for TransitionMap

fn default() -> TransitionMap

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TransitionMap

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TransitionMap

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

where __S: Serializer,

Serialize this value into the given Serde serializer.