Struct KnowledgeStore 

pub struct KnowledgeStore { /* private fields */ }

A validated local knowledge store backed by one JSON snapshot file.

Implementations

impl KnowledgeStore

pub fn open(path: impl Into<PathBuf>) -> Result<Self, KnowledgeStoreError>

Open an existing store or an empty store at path.

pub fn open_with_limits( path: impl Into<PathBuf>, limits: KnowledgeStoreLimits, ) -> Result<Self, KnowledgeStoreError>

Open a store with explicit record and serialized-byte limits.

pub fn path(&self) -> &Path

Return the path used for the snapshot file.

pub fn limits(&self) -> KnowledgeStoreLimits

Return the active store limits.

pub fn snapshot(&self) -> &KnowledgeStoreSnapshot

Return the last validated in-memory snapshot.

pub fn refresh(&mut self) -> Result<(), KnowledgeStoreError>

Re-read the snapshot under the store lock.

pub fn get(&self, record_id: &str) -> Option<&KnowledgeRecord>

Find one record by its stable ID.

pub fn assess( &self, context: &KnowledgeLookupContext, ) -> Vec<KnowledgeAssessment>

Assess all records against fresh session dimensions without changing the store or returning any executable browser reference.

pub fn records(&self) -> &[KnowledgeRecord]

Return the validated records for inspection or export.

pub fn stats(&self) -> Result<KnowledgeStoreStats, KnowledgeStoreError>

Return bounded serialized-size and lifecycle counts.

pub fn replace_snapshot( &mut self, snapshot: KnowledgeStoreSnapshot, ) -> Result<(), KnowledgeStoreError>

Replace the complete store only after validating its schema and bounds.

pub fn transition( &mut self, record_id: &str, next: KnowledgeConfidence, reason: String, observed_at: String, fresh_verification: bool, ) -> Result<KnowledgeStoreChange, KnowledgeStoreError>

Transition one record and retain the lifecycle evidence in its history.

pub fn purge_origin( &mut self, origin: &str, ) -> Result<KnowledgePurgeResult, KnowledgeStoreError>

Remove every record scoped to one exact origin.

pub fn upsert( &mut self, record: KnowledgeRecord, ) -> Result<KnowledgeStoreChange, KnowledgeStoreError>

Insert or replace a record, then prune the least useful records first.

pub fn remove( &mut self, record_id: &str, ) -> Result<KnowledgeStoreChange, KnowledgeStoreError>

Remove one record and persist the resulting snapshot.

Trait Implementations

impl Debug for KnowledgeStore

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

Formats the value using the given formatter.