Struct ForgettingMemory 

pub struct ForgettingMemory { /* private fields */ }

A decaying, file-backed memory store.

Implementations

impl ForgettingMemory

pub fn new( files: FileMemoryStore, config: ForgetConfig, ) -> Result<Self, FileMemoryError>

Opens the store root and loads any existing decay ledger.

pub fn config(&self) -> ForgetConfig

Current decay policy.

pub fn remember( &mut self, name: &str, content: &str, importance: f64, now: SystemTime, ) -> Result<(), FileMemoryError>

Writes a new memory with the given importance. Re-remembering an existing name overwrites its content and refreshes its timestamps.

pub fn recall( &mut self, name: &str, now: SystemTime, ) -> Result<String, FileMemoryError>

Reads a memory’s content, refreshing its last_access_at (recency reward).

pub fn importance(&self, name: &str) -> Option<f64>

Importance of a memory, if tracked.

pub fn forget(&mut self, name: &str) -> Result<(), FileMemoryError>

Explicitly forgets one memory and its ledger entry.

pub fn should_forget(&self, name: &str, now: SystemTime) -> bool

Whether name should be pruned at now: either TTL-expired or weak-and-idle-grace.

pub fn consolidate(&mut self, now: SystemTime) -> Result<usize, FileMemoryError>

Prunes every memory that should be forgotten at now. Returns the number pruned.

Pure with respect to time (uses the injected now); the caller decides when to run it.

pub fn live_at(&self, now: SystemTime) -> Vec<String>

Names of memories that currently survive should_forget at now.

Trait Implementations

impl Debug for ForgettingMemory

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

Formats the value using the given formatter.