Struct ContextStore 

pub struct ContextStore { /* private fields */ }

A key-value context store for AI coding agents.

Provides namespaced storage with git-aware invalidation for caching file summaries, symbol indexes, project metadata, and session context.

Implementations

impl ContextStore

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Open or create a context store at the given path.

pub fn in_memory() -> Result<Self>

Create an in-memory context store (for testing).

pub fn with_git_repo(self, repo_path: impl AsRef<Path>) -> Result<Self>

Initialize git-aware invalidation from a repository.

pub fn refresh_git_state(&self) -> Result<()>

Refresh the git state for invalidation checks.

pub fn get(&self, key: &str) -> Result<Option<ContextEntry>>

Get a value by key.

pub fn get_if_valid(&self, key: &str) -> Result<Option<ContextEntry>>

Get a value, returning None if invalid (without deleting).

pub fn set(&self, entry: ContextEntry) -> Result<()>

Set a value.

pub fn set_value(&self, key: &str, value: Value) -> Result<()>

Set a simple key-value pair.

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

Delete a value by key.

pub fn delete_prefix(&self, prefix: &str) -> Result<usize>

Delete all entries matching a prefix.

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

Check if a key exists.

pub fn list(&self, query: &ContextQuery) -> Result<Vec<ContextEntry>>

List entries matching a query.

pub fn keys(&self, namespace: Namespace) -> Result<Vec<String>>

List all keys in a namespace.

pub fn get_file_context(&self, path: &str) -> Result<Option<FileContext>>

Get file context.

pub fn set_file_context(&self, path: &str, ctx: &FileContext) -> Result<()>

Set file context with automatic mtime tracking.

pub fn get_file_attr(&self, path: &str, attr: &str) -> Result<Option<Value>>

Get a specific attribute of file context.

pub fn set_file_attr(&self, path: &str, attr: &str, value: Value) -> Result<()>

Set a specific attribute of file context.

pub fn get_symbol(&self, name: &str) -> Result<Option<SymbolInfo>>

Get symbol information.

pub fn set_symbol( &self, info: &SymbolInfo, file_path: Option<&str>, ) -> Result<()>

Set symbol information.

pub fn find_symbols(&self, prefix: &str) -> Result<Vec<SymbolInfo>>

Find symbols by prefix.

pub fn get_project_context(&self) -> Result<Option<ProjectContext>>

Get project context.

pub fn set_project_context(&self, ctx: &ProjectContext) -> Result<()>

Set project context.

pub fn get_project_attr(&self, attr: &str) -> Result<Option<Value>>

Get a project attribute.

pub fn set_project_attr(&self, attr: &str, value: Value) -> Result<()>

Set a project attribute.

pub fn get_session(&self, session_id: &str) -> Result<Option<SessionContext>>

Get session context.

pub fn set_session(&self, ctx: &SessionContext) -> Result<()>

Set session context.

pub fn update_working_files( &self, session_id: &str, files: Vec<String>, ) -> Result<()>

Update session’s working files.

pub fn add_decision( &self, session_id: &str, decision: &str, rationale: Option<&str>, context: Vec<String>, ) -> Result<()>

Add a decision to session context.

pub fn get_batch( &self, keys: &[String], ) -> Result<HashMap<String, ContextEntry>>

Get multiple values by keys.

pub fn set_batch(&self, entries: Vec<ContextEntry>) -> Result<()>

Set multiple entries.

pub fn cleanup_expired(&self) -> Result<usize>

Delete all expired entries.

pub fn cleanup_invalid(&self) -> Result<usize>

Delete all invalid entries based on git state.

pub fn stats(&self) -> Result<ContextStats>

Get statistics about the context store.

pub fn clear(&self) -> Result<()>

Clear all entries (for testing).

pub fn clear_all(&self) -> Result<usize>

Clear all entries and return count.

pub fn clear_namespace(&self, namespace: Namespace) -> Result<usize>

Clear entries in a specific namespace.

pub fn get_file_mtime(&self, path: &str) -> Option<i64>

Get the modification time of a file.

pub fn refresh_invalidation(&self) -> Result<()>

Refresh invalidation state from git.

pub fn list_simple( &self, namespace: Option<Namespace>, prefix: Option<&str>, ) -> Result<Vec<ContextEntry>>

List entries with simplified parameters.