Struct CacheStore 

pub struct CacheStore { /* private fields */ }

CacheStore provides file caching with SHA-256 hash-based change detection

Implementations

impl CacheStore

pub fn new(config: CacheConfig) -> Result<Self, Error>

Create a new cache store

pub async fn init(&self) -> Result<(), Error>

Initialize the database schema

pub fn estimate_tokens(text: &str) -> u64

Estimate tokens from character count.

Uses ~4 characters per token, which matches the average for GPT-4 and Claude tokenizers on typical source code. Ceiling division ensures non-empty inputs always count as at least 1 token.

The previous formula (chars * 0.75) overstated token counts by ~3x.

pub async fn read_file( &self, path: &str, offset: Option<usize>, limit: Option<usize>, force: bool, ) -> Result<FileReadResult, Error>

Read a file with caching

Follows the TypeScript algorithm:

1. Check if this session has read this file before (session_reads table)
2. If not: return full content, cache it
3. If yes and hash matches: return “[unchanged]”
4. If yes and hash differs: compute diff, return diff

pub async fn get_stats(&self) -> Result<CacheStats, Error>

Get cache statistics

pub async fn clear(&self) -> Result<(), Error>

Clear the cache