Struct BounceTracker 

pub struct BounceTracker { /* private fields */ }

Implementations

impl BounceTracker

pub fn new() -> Self

pub fn next_seq(&mut self) -> u64

pub fn set_seq(&mut self, seq: u64)

pub fn record_read( &mut self, path: &str, mode: &str, tokens_sent: usize, original_tokens: usize, )

pub fn flush_pending(&mut self)

Commit every provisional bounce now, regardless of its window. Used at process shutdown so a bounce detected shortly before exit is not lost.

pub fn pending_bounces(&self) -> usize

Provisional bounces still waiting for their edit window to pass.

pub fn record_shell_read(&mut self, path: &str, view: ReadView)

A shell read of path (cat, head, sed -n, …). A full read can complete a correction of a preceding compressed view; a partial one never does. Either way it becomes the path’s newest read, so a second cat cannot book the same correction twice.

pub fn record_expansion(&mut self, source: Option<&str>, wasted_tokens: usize)

Records an explicit archive/context expansion as a quality bounce.

Unlike a full file re-read, ctx_expand may address a content handle rather than a path, so it cannot always be inferred by detect_bounce. Benchmark replay uses this method to keep the quality proxy on the same tracker as ordinary compressed-then-full bounces.

pub fn last_read(&self, path: &str) -> Option<(bool, Option<(String, String)>)>

The newest read of path this process still remembers: whether it was compressed and the scope and task it ran under, so a later event is charged to the read that caused it. None: no read is known here (another process, or before a restart). A partial read (line window) is precise, not lossy, so it reports false like a full read.

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

An edit of path. Besides exempting the full re-reads it forces, it cancels any provisional bounce of the path still inside its edit window: the compressed→full re-read was the read-before-edit, not a compression failure.

pub fn should_force_full(&self, path: &str) -> bool

pub fn bounce_rate_for_extension(&self, path: &str) -> Option<f64>

pub fn total_bounces(&self) -> u64

pub fn total_wasted_tokens(&self) -> usize

pub fn adjusted_savings(&self, raw_savings: usize) -> isize

pub fn per_extension_json(&self) -> Vec<Value>

pub fn format_summary(&self) -> String

Trait Implementations

impl Debug for BounceTracker

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

Formats the value using the given formatter.

impl Default for BounceTracker

fn default() -> Self

Returns the “default value” for a type.