Struct StatsCache 

pub struct StatsCache {
    pub version: u32,
    pub last_computed_date: Option<String>,
    pub daily_activity: Vec<DailyActivityEntry>,
    pub daily_model_tokens: Vec<DailyModelTokens>,
    pub model_usage: HashMap<String, ModelUsage>,
    pub total_sessions: u64,
    pub total_messages: u64,
    pub longest_session: Option<LongestSession>,
    pub first_session_date: Option<String>,
    pub hour_counts: HashMap<String, u64>,
    pub total_speculation_time_saved_ms: u64,
}

Top-level stats cache structure matching actual Claude Code format

Fields

version: u32

Version of the stats format

last_computed_date: Option<String>

Last computed date (YYYY-MM-DD)

daily_activity: Vec<DailyActivityEntry>

Daily activity entries

daily_model_tokens: Vec<DailyModelTokens>

Daily model token usage

model_usage: HashMap<String, ModelUsage>

Model usage breakdown

total_sessions: u64

Total sessions

total_messages: u64

Total messages

longest_session: Option<LongestSession>

Longest session info

first_session_date: Option<String>

First session date

hour_counts: HashMap<String, u64>

Hour counts for heatmap (0-23 as strings)

total_speculation_time_saved_ms: u64

Total speculation time saved in ms

Implementations

impl StatsCache

pub const CONTEXT_WINDOW: u64 = 200_000

Context window size for Sonnet 4.5 (200K tokens)

pub fn total_input_tokens(&self) -> u64

Calculate total input tokens across all models

pub fn total_output_tokens(&self) -> u64

Calculate total output tokens across all models

pub fn total_tokens(&self) -> u64

Calculate total tokens (input + output)

pub fn total_cache_read_tokens(&self) -> u64

Calculate total cache read tokens

pub fn total_cache_write_tokens(&self) -> u64

Calculate total cache write tokens

pub fn recalculate_costs(&mut self)

Recalculate costs for all models using accurate pricing

This should be called after loading stats from stats-cache.json to ensure cost_usd fields are populated with accurate pricing data.

pub fn session_count(&self) -> u64

Get session count

pub fn message_count(&self) -> u64

Get message count

pub fn top_models(&self, n: usize) -> Vec<(&str, &ModelUsage)>

Get top N models by token usage

pub fn recent_daily(&self, n: usize) -> Vec<&DailyActivityEntry>

Get recent N days of activity

pub fn cache_ratio(&self) -> f64

Calculate cache hit ratio

pub fn calculate_context_saturation( session_metadata: &[&SessionMetadata], last_n: usize, ) -> ContextWindowStats

Calculate context window saturation from session metadata

NOTE: Requires session metadata to be passed from DataStore since StatsCache doesn’t have direct access to sessions.

Trait Implementations

impl Clone for StatsCache

fn clone(&self) -> StatsCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StatsCache

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

Formats the value using the given formatter.

impl Default for StatsCache

fn default() -> StatsCache

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StatsCache

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StatsCache

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.