Struct SharedContext 

pub struct SharedContext { /* private fields */ }

Durable cross-agent memory backed by an appendable JSONL file.

Implementations

impl SharedContext

pub fn new(path: PathBuf) -> Self

An unpartitioned store at path (tests and explicit tooling).

pub fn legacy() -> Option<Self>

The installation-wide store of releases before 3.11.5. Served to no project; read for the explicit lean-ctx migrate legacy-context adoption only.

pub fn orphaned_entries() -> Vec<(PathBuf, SharedContextEntry)>

Facts left in a partition that is no longer the current one of the root they recorded: that project’s identity (remote, package name) changed since. Served to no project until adopted.

pub fn for_project(project_root: &str) -> Result<Self, String>

The shared facts of project_root, in its own partition of the data directory.

pub fn path(&self) -> &Path

pub fn put( &self, content: impl Into<String>, agent: impl Into<String>, category: impl Into<String>, ) -> Result<String, String>

pub fn get_relevant( &self, query: &str, limit: usize, ) -> Result<Vec<SharedContextEntry>, String>

pub fn get_recent( &self, limit: usize, ) -> Result<Vec<SharedContextEntry>, String>

pub fn get_by_category( &self, category: &str, ) -> Result<Vec<SharedContextEntry>, String>

pub fn prune( &self, max_age_seconds: u64, max_entries: usize, ) -> Result<usize, String>

pub fn verify_fact(&self, hash: &str) -> Result<(), String>

Record an explicit confirmation of a fact.

pub fn mark_stale(&self, hash: &str) -> Result<(), String>

Lower the confidence of a fact identified as stale without removing it.

pub fn supersede(&self, old_hash: &str, new_fact: &str) -> Result<(), String>

Mark old_hash as replaced by the existing fact identified by new_fact.

pub fn prune_stale(&self, max_age_days: u16) -> Result<usize, String>

Remove facts whose latest verification (or creation) predates their expiry window.

pub fn prune_negative(&self) -> Result<usize, String>

Remove facts consistently associated with unsuccessful outcomes.

pub fn get_best( &self, query: &str, limit: usize, ) -> Result<Vec<SharedContextEntry>, String>

Return query-matching facts ordered by their provenance quality score.

pub fn record_fact_outcome( &self, hash: &str, success: bool, ) -> Result<(), String>

Fold an outcome into a fact’s correlation score with an exponential moving average.

pub fn cross_session_stats(&self) -> Result<MemoryStats, String>

Summarize provenance quality and the agents or users that contributed facts.

pub fn stats(&self) -> Result<SharedContextStats, String>

pub fn load(&self) -> Result<Vec<SharedContextEntry>, String>

Trait Implementations

impl Clone for SharedContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedContext

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

Formats the value using the given formatter.