Struct EpisodeCatalog 

pub struct EpisodeCatalog<const N: usize> { /* private fields */ }

Fixed-size circular buffer of past episodes.

N is the catalog capacity. Older episodes are overwritten when the buffer wraps. For audit-grade durability, persist the catalog to disk between runs (see docs/operator_handbook.md).

Implementations

impl<const N: usize> EpisodeCatalog<N>

pub fn new() -> Self

Construct an empty catalog.

pub fn record(&mut self, ep: DebugEpisode)

Append an episode to the catalog. Wraps when full.

pub fn total_recorded(&self) -> u64

Total episodes recorded since construction (including any overwritten by buffer wrap). Useful for audit logs.

pub fn len(&self) -> usize

Number of entries currently stored (capped at N).

pub fn is_empty(&self) -> bool

True iff no episodes have been recorded.

pub fn find_similar(&self, query: &DebugEpisode) -> Option<SimilarEpisode>

Find the most-similar past episode to query.

Returns None if the catalog is empty or no past entry has non-zero similarity. Tie-broken by lower catalog index for determinism.

Trait Implementations

impl<const N: usize> Default for EpisodeCatalog<N>

fn default() -> Self

Returns the “default value” for a type.