Struct PersistManager 

pub struct PersistManager { /* private fields */ }

Persistence manager for cache entries.

Handles atomic writes, lock management, and manifest tracking.

Implementations

impl PersistManager

pub fn new<P: AsRef<Path>>(cache_root: P) -> Result<Self>

Create a new persistence manager.

Arguments

• cache_root: Root directory for cache storage

Examples

let manager = PersistManager::new(".sqry-cache")?;

Errors

Returns anyhow::Error when the cache directories cannot be created or when stale lock cleanup fails.

pub fn user_cache_dir(&self) -> PathBuf

Get the user-specific cache directory.

Returns the path where this user’s cache entries are stored.

pub fn write_entry( &self, key: &CacheKey, summaries: &[GraphNodeSummary], ) -> Result<usize>

Write a cache entry to disk atomically.

Uses temp file + rename pattern for crash safety.

Arguments

• key: Cache key identifying the entry
• summaries: Node summaries to persist

Returns

Ok(bytes_written) on success

Errors

Returns anyhow::Error when locking, serialization, writing, or atomic rename steps fail.

pub fn read_entry( &self, key: &CacheKey, ) -> Result<Option<Vec<GraphNodeSummary>>>

Read a cache entry from disk.

Returns

• Ok(Some(summaries)) if entry exists and is valid
• Ok(None) if entry doesn’t exist
• Err(_) on I/O or deserialization errors

Errors

Returns anyhow::Error when the entry cannot be read or deserialized.

pub fn delete_entry(&self, key: &CacheKey) -> Result<()>

Delete a cache entry from disk.

Errors

Returns anyhow::Error when either the entry or its lock file cannot be removed.

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

Clear all cache entries for this user.

Errors

Returns anyhow::Error when directory traversal or entry deletion fails.