Struct ContextLedger 

pub struct ContextLedger {
    pub window_size: usize,
    pub entries: Vec<LedgerEntry>,
    pub total_tokens_sent: usize,
    pub total_tokens_saved: usize,
}

Fields

window_size: usize

entries: Vec<LedgerEntry>

total_tokens_sent: usize

total_tokens_saved: usize

Implementations

impl ContextLedger

pub fn new() -> Self

pub fn with_window_size(size: usize) -> Self

pub fn record( &mut self, path: &str, mode: &str, original_tokens: usize, sent_tokens: usize, )

pub fn record_with_task( &mut self, path: &str, mode: &str, original_tokens: usize, sent_tokens: usize, task: Option<&str>, )

pub fn upsert( &mut self, path: &str, mode: &str, original_tokens: usize, sent_tokens: usize, source_hash: Option<&str>, kind: ContextKind, provenance: Option<Provenance>, )

Record with full CFT metadata including source hash and provenance.

pub fn update_phi(&mut self, path: &str, phi: f64)

Update the Phi score for an entry.

pub fn set_state(&mut self, path: &str, state: ContextState)

Set the state for an entry.

pub fn find_by_id(&self, id: &ContextItemId) -> Option<&LedgerEntry>

Find an entry by its ContextItemId.

pub fn items_by_state(&self, state: ContextState) -> Vec<&LedgerEntry>

Get all entries with a specific state.

pub fn eviction_candidates_by_phi(&self, keep_count: usize) -> Vec<String>

Eviction candidates ordered by Phi (lowest first), falling back to timestamp for entries without Phi scores.

pub fn mark_stale_by_hash(&mut self, path: &str, new_hash: &str)

Mark entries as stale if their source hash has changed.

pub fn pressure(&self) -> ContextPressure

pub fn compression_ratio(&self) -> f64

pub fn files_by_token_cost(&self) -> Vec<(String, usize)>

pub fn mode_distribution(&self) -> HashMap<String, usize>

pub fn eviction_candidates(&self, keep_count: usize) -> Vec<String>

pub fn remove(&mut self, path: &str)

pub fn save(&self)

pub fn prune(&mut self) -> usize

pub fn load() -> Self

pub fn format_summary(&self) -> String

pub fn adjusted_total_saved(&self) -> isize

impl ContextLedger

pub fn reinjection_plan( &self, intent: &StructuredIntent, target_utilization: f64, ) -> ReinjectionPlan

Trait Implementations

impl Clone for ContextLedger

fn clone(&self) -> ContextLedger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextLedger

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

Formats the value using the given formatter.

impl Default for ContextLedger

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ContextLedger

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ContextLedger

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

where __S: Serializer,

Serialize this value into the given Serde serializer.