Struct CacheStore 

pub struct CacheStore { /* private fields */ }

The persistent layered cache.

Implementations

impl CacheStore

pub fn open(root: &Path, max_bytes: u64) -> Result<Self>

Open (or create) a cache rooted at root with a byte budget. A corrupt index is tolerated: it is rebuilt empty.

pub fn lookup(&mut self, key: &CacheKey) -> Option<Vec<u8>>

Look up an artifact; loads it from disk and bumps LRU + hits.

pub fn contains(&self, key: &CacheKey) -> bool

Whether an artifact is present (without loading).

pub fn insert(&mut self, key: &CacheKey, data: &[u8]) -> Result<()>

Insert an artifact (atomic temp + rename).

pub fn invalidate_from(&mut self, from_layer: u8) -> usize

Invalidate entries at layer >= from_layer (e.g. driver update → invalidate_from(4) keeps layers 1–3).

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

Persist the index.

pub fn metrics(&self) -> &CacheMetrics

Metrics snapshot.

pub fn bytes_stored(&self) -> u64

Current byte usage.

pub fn entry_count(&self) -> usize

Entry count.

pub fn index_fingerprint(&self) -> u64

Stable identity hash of the whole index (for audits).