Struct FileParseCache 

pub struct FileParseCache { /* private fields */ }

Thread-safe LRU cache for parsed session analyses with automatic eviction.

Entries are held as Arc<CodeAnalysis> (the typed struct). We deliberately avoid caching Arc<serde_json::Value> because serde_json::to_value deep- clones every string and adds per-node Value enum overhead on top — for long Claude sessions that roughly doubles the working set. Callers that need a Value (CLI single-file dump) serialise on demand from the typed form, which only happens once per request rather than once per cache entry.

Implementations

impl FileParseCache

pub fn new() -> Self

Creates a new LRU cache with capacity from constants::capacity::FILE_CACHE_SIZE.

pub fn get_or_parse<P: AsRef<Path>>(&self, path: P) -> Result<Arc<CodeAnalysis>>

Retrieves cached analysis or parses the file if needed, auto-detecting the provider from file contents.

Prefer Self::get_or_parse_as whenever the caller already knows which provider the file belongs to (e.g. walking a specific session directory). Content detection is only safe for ad-hoc single-file paths.

Workflow:

1. Check cache hit with read-only peek (no lock contention)
2. If valid, promote entry to front with write lock
3. If miss/stale, parse file and cache result (may evict LRU entry)

Optimized to minimize write lock contention in parallel workloads.

Errors

Returns an error if the file’s metadata cannot be read or if parsing the session file fails (malformed data, unreadable contents, etc.). A poisoned cache lock does not error — it simply forces a reparse.

pub fn get_or_parse_as<P: AsRef<Path>>( &self, path: P, provider: ExtensionType, ) -> Result<Arc<CodeAnalysis>>

Same as Self::get_or_parse but the caller specifies which provider the file belongs to — the parser skips content-based detection, so metadata sentinels at the top of a Claude session (permission-mode, file-history-snapshot) cannot cause the file to be mis-filed under a different provider.

Errors

Returns an error if the file’s metadata cannot be read or if parsing the session file as provider fails.

pub fn clear(&self)

Clears all entries from the cache.

pub fn cleanup_stale(&self)

Removes entries for non-existent files (manual cleanup).

With LRU eviction, stale entries are naturally removed over time, so this is typically not needed in production.

pub fn stats(&self) -> CacheStats

Returns cache statistics for monitoring and debugging.

estimated_memory_kb is a real sum of per-entry sizes captured by estimate_analysis_bytes at insertion time.

pub fn invalidate<P: AsRef<Path>>(&self, path: P)

Removes a specific file from the cache.

pub fn get_cached_paths(&self) -> Vec<PathBuf>

Returns all currently cached file paths.

Trait Implementations

impl Default for FileParseCache

fn default() -> Self

Returns the “default value” for a type.