Struct AdaptivePolicy 

pub struct AdaptivePolicy { /* private fields */ }

Adaptive cache threshold policy.

Tracks rolling hit/miss observations and periodically evaluates whether the cache should grow or shrink. The policy itself does not mutate any cache; it produces Adjustment recommendations.

Implementations

impl AdaptivePolicy

pub fn new(config: AdaptiveConfig) -> Result<AdaptivePolicy, AdaptiveError>

Create a new policy from the given configuration.

Returns an error if the configuration is invalid.

pub fn with_initial_capacity( config: AdaptiveConfig, initial_capacity: usize, ) -> Result<AdaptivePolicy, AdaptiveError>

Create a policy with a specific initial capacity.

pub fn record_hit(&mut self) -> Option<Adjustment>

Record a cache hit.

Returns Some(Adjustment) when this observation triggers an evaluation (every adjustment_interval operations), None otherwise.

pub fn record_miss(&mut self) -> Option<Adjustment>

Record a cache miss.

Returns Some(Adjustment) when this observation triggers an evaluation, None otherwise.

pub fn evaluate_now(&mut self) -> Adjustment

Force an evaluation regardless of the operation counter.

pub fn rolling_hit_rate(&self) -> f64

Current rolling hit rate.

pub fn total_hits(&self) -> u64

Total hits since creation / last reset.

pub fn total_misses(&self) -> u64

Total misses since creation / last reset.

pub fn lifetime_hit_rate(&self) -> f64

Lifetime hit rate (not rolling-windowed).

pub fn current_capacity(&self) -> usize

Currently recommended capacity.

pub fn adjustments_made(&self) -> u64

Number of adjustments made so far.

pub fn history(&self) -> &[AdjustmentRecord]

Read-only access to the adjustment history.

pub fn config(&self) -> &AdaptiveConfig

The active configuration.

pub fn window_fill(&self) -> usize

Total number of observations in the rolling window.

pub fn reset(&mut self)

Reset all counters and the rolling window, keeping the current configuration.