Struct CacheManager 

pub struct CacheManager { /* private fields */ }

Manages the Reflex cache directory

Implementations

impl CacheManager

pub fn new(root: impl AsRef<Path>) -> Self

Create a new cache manager for the given root directory

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

Initialize the cache directory structure if it doesn’t exist

pub fn exists(&self) -> bool

Check if cache exists and is valid

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

Validate cache integrity and detect corruption

Performs basic integrity checks on the cache:

• Verifies all required files exist
• Checks SQLite database can be opened
• Validates binary file headers (trigrams.bin, content.bin)

Returns Ok(()) if cache is valid, Err with details if corrupted.

pub fn path(&self) -> &Path

Get the path to the cache directory

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

Clear the entire cache

pub fn load_hashes(&self) -> Result<HashMap<String, String>>

Load file hashes for incremental indexing from SQLite

pub fn save_hashes(&self, _hashes: &HashMap<String, String>) -> Result<()>

👎Deprecated: Hashes are now stored in SQLite via update_file()

Save file hashes for incremental indexing

DEPRECATED: Hashes are now saved directly to SQLite via update_file(). This method is kept for backward compatibility but does nothing.

pub fn update_file( &self, path: &str, hash: &str, language: &str, line_count: usize, ) -> Result<()>

Update file metadata in the files table

pub fn batch_update_files( &self, files: &[(String, String, String, usize)], ) -> Result<()>

Batch update multiple files in a single transaction for performance

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

Update statistics after indexing by calculating totals from database

pub fn list_files(&self) -> Result<Vec<IndexedFile>>

Get list of all indexed files

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

Get statistics about the current cache

pub fn record_branch_file( &self, path: &str, branch: &str, hash: &str, commit_sha: Option<&str>, ) -> Result<()>

Record a file’s hash for a specific branch

pub fn batch_record_branch_files( &self, files: &[(String, String)], branch: &str, commit_sha: Option<&str>, ) -> Result<()>

Batch record multiple files for a specific branch in a single transaction

pub fn get_branch_files(&self, branch: &str) -> Result<HashMap<String, String>>

Get all files indexed for a specific branch

Returns a HashMap of path → hash for all files in the branch.

pub fn branch_exists(&self, branch: &str) -> Result<bool>

Check if a branch has any indexed files

Fast existence check using LIMIT 1 for O(1) performance.

pub fn get_branch_info(&self, branch: &str) -> Result<BranchInfo>

Get branch metadata (commit, last_indexed, file_count, dirty status)

pub fn update_branch_metadata( &self, branch: &str, commit_sha: Option<&str>, file_count: usize, is_dirty: bool, ) -> Result<()>

Update branch metadata after indexing

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

Find a file with a specific hash (for symbol reuse optimization)

Returns the path and branch where this hash was first seen, enabling reuse of parsed symbols across branches.