Struct PersonalKnowledgeCache 

pub struct PersonalKnowledgeCache {
    pub last_sync: i64,
    /* private fields */
}

Local cache of personal facts synced from server

Fields

last_sync: i64

Timestamp of last successful sync with server

Implementations

impl PersonalKnowledgeCache

pub fn new<P: AsRef<Path>>(db_path: P, max_queue_size: usize) -> Result<Self>

Create a new cache with SQLite persistence

pub fn in_memory(max_queue_size: usize) -> Result<Self>

Create an in-memory cache (for testing)

pub fn set_last_sync(&mut self, timestamp: i64) -> Result<()>

Update last sync timestamp

pub fn upsert_fact(&mut self, fact: PersonalFact) -> Result<()>

Add or update a fact (upsert by key)

pub fn add_fact(&mut self, fact: PersonalFact) -> Result<()>

Add a new fact to the cache

pub fn upsert_fact_simple( &mut self, key: &str, value: &str, _confidence: f32, local_only: bool, ) -> Result<()>

Add or update a fact with simplified interface

pub fn get_all_facts(&self) -> Vec<&PersonalFact>

Get all non-deleted facts

pub fn get_facts_by_key_prefix( &self, prefix: &str, ) -> Result<Vec<&PersonalFact>>

Get facts by key prefix (e.g., “recent_entity:” gets all recent entity facts)

pub fn update_fact(&mut self, fact: PersonalFact) -> Result<()>

Update an existing fact

pub fn get_fact(&self, id: &str) -> Option<&PersonalFact>

Get a fact by ID

pub fn get_fact_by_key(&self, key: &str) -> Option<&PersonalFact>

Get a fact by key

pub fn get_fact_mut(&mut self, id: &str) -> Option<&mut PersonalFact>

Get a mutable reference to a fact by ID

pub fn remove_fact(&mut self, id: &str) -> Result<bool>

Remove a fact (soft delete)

pub fn remove_fact_by_key(&mut self, key: &str) -> Result<bool>

Remove a fact by key (soft delete)

pub fn all_facts(&self) -> impl Iterator<Item = &PersonalFact>

Get all active facts

pub fn facts_by_category( &self, category: PersonalFactCategory, ) -> Vec<&PersonalFact>

Get facts by category

pub fn search_facts(&self, query: &str) -> Vec<&PersonalFact>

Get facts matching a search query (simple substring match)

pub fn get_reliable_facts(&self, min_confidence: f32) -> Vec<&PersonalFact>

Get facts above a confidence threshold

pub fn get_syncable_facts(&self) -> Vec<&PersonalFact>

Get facts that should be synced to server (not local_only)

pub fn queue_submission(&mut self, fact: PersonalFact) -> Result<bool>

Queue a fact for submission to server

pub fn pending_submissions(&self) -> &[PendingFactSubmission]

Get pending submissions

pub fn clear_pending_submissions(&mut self) -> Result<()>

Clear all pending submissions (after successful sync)

pub fn queue_feedback(&mut self, feedback: PersonalFactFeedback) -> Result<bool>

Queue feedback for sending to server

pub fn pending_feedback(&self) -> &[PersonalFactFeedback]

Get pending feedback

pub fn clear_pending_feedback(&mut self) -> Result<()>

Clear all pending feedback (after successful sync)

pub fn merge_from_server( &mut self, server_facts: Vec<PersonalFact>, ) -> Result<MergeResult>

Merge facts from server (handles version conflicts)

pub fn apply_decay(&mut self) -> Result<u32>

Apply decay to all facts based on category

pub fn stats(&self) -> CacheStats

Get statistics about the cache

pub fn export_json(&self) -> Result<String>

Export all facts as JSON (for /profile export)

pub fn import_json(&mut self, json: &str) -> Result<ImportResult>

Import facts from JSON (for /profile import)