Struct CacheEntry 

pub struct CacheEntry {
    pub hash: String,
    pub line_count: usize,
    pub original_tokens: usize,
    pub path: String,
    pub stored_mtime: Option<SystemTime>,
    pub compressed_outputs: HashMap<String, String>,
    pub full_content_delivered: bool,
    pub last_mode: String,
    /* private fields */
}

A cached file read: zstd-compressed content, hash, token count, and access metadata.

read_count and last_access use interior mutability (atomics) so cache hits can be recorded under a shared (read) lock — parallel reads of distinct files no longer serialize on a global write lock.

Fields

hash: String

line_count: usize

original_tokens: usize

path: String

stored_mtime: Option<SystemTime>

compressed_outputs: HashMap<String, String>

Mode-specific compressed outputs (e.g. “map”, “signatures”) cached to avoid re-parsing.

full_content_delivered: bool

Whether full (uncompressed) content was already delivered for this hash. Prevents cache-stub loops when upgrading from compressed to full mode.

last_mode: String

Last read mode used for this file (for auto-escalation on edit failure).

Implementations

impl CacheEntry

pub fn new( content: &str, hash: String, line_count: usize, original_tokens: usize, path: String, stored_mtime: Option<SystemTime>, ) -> Self

Creates a new entry with zstd-compressed content.

pub fn read_count(&self) -> u32

Current read count (lock-free).

pub fn bump_read_count(&self) -> u32

Atomically increments the read count and returns the new value (lock-free).

pub fn set_read_count(&self, n: u32)

Overwrites the read count (used by store and tests).

pub fn last_access(&self) -> Instant

Last access time, decoded from the atomic millisecond offset.

pub fn touch(&self)

Marks the entry as accessed now (lock-free).

pub fn set_last_access(&self, when: Instant)

Overwrites the last-access time (used by tests and eviction setup).

pub fn content(&self) -> Option<String>

Decompresses and returns the full file content.

pub fn set_content(&mut self, content: &str)

Replaces the stored content with new zstd-compressed data.

pub fn compressed_size(&self) -> usize

Approximate RAM usage of the compressed content in bytes.

impl CacheEntry

pub fn eviction_score_legacy(&self, now: Instant) -> f64

Computes a legacy eviction score blending recency, frequency, and size.

pub fn get_compressed(&self, mode_key: &str) -> Option<&String>

pub fn set_compressed(&mut self, mode_key: &str, output: String)

pub fn mark_full_delivered(&mut self)

Trait Implementations

impl Debug for CacheEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.