Struct Cache 

pub struct Cache { /* private fields */ }

Node-level LRU cache for OCI module artifacts.

Cache layout: <root>/<module>/<version>/ Each entry directory contains extracted module content plus:

• .cfgd-last-access — unix timestamp for LRU tracking
• .cfgd-complete — sentinel indicating successful extraction

LRU eviction uses the marker file (filesystem atime is unreliable with noatime/relatime mount options).

Implementations

impl Cache

pub fn new(root: PathBuf, max_bytes: u64) -> Result<Self, CsiError>

pub fn get_or_pull( &self, module: &str, version: &str, oci_ref: &str, ) -> Result<PathBuf, CsiError>

Return the cache path for a module, or pull it if not cached.

On cache hit, updates access time for LRU tracking. On cache miss, pulls the OCI artifact to a temp dir and atomically moves it into place (safe under concurrent access). After a pull, runs eviction if over capacity.

pub fn get(&self, module: &str, version: &str) -> Option<PathBuf>

Return the cached path if it exists and is complete, without pulling.

pub fn evict_lru(&self) -> Result<(), CsiError>

Evict least-recently-used entries until cache is under max_bytes.

pub fn current_size_bytes(&self) -> u64

Total bytes used by cached entries (excludes marker files).