Struct StorageHotspotDetector 

pub struct StorageHotspotDetector {
    pub records: HashMap<u64, BlockAccessRecord>,
    pub config: DetectorConfig,
    pub total_events: u64,
}

Detects storage hotspots using sliding-window access counting and exponential decay scoring.

Algorithm

Each block maintains a floating-point score that grows whenever an access is recorded (weighted by AccessType) and shrinks exponentially as logical time elapses (score *= decay_factor^ticks_elapsed). Events older than window_ticks are purged to bound memory usage. A block is classified as a hotspot when its decay-adjusted score equals or exceeds hotspot_threshold.

Fields

records: HashMap<u64, BlockAccessRecord>

Per-block access records, keyed by block identifier.

config: DetectorConfig

Detector configuration.

total_events: u64

Total number of access events recorded since creation.

Implementations

impl StorageHotspotDetector

pub fn new(config: DetectorConfig) -> Self

Create a new detector with the supplied configuration.

pub fn record_access(&mut self, event: AccessEvent)

Record a block access event.

The record for event.block_id is created on first access. Decay is applied for every tick that has elapsed since the last recorded event, events older than the window are evicted, and the event weight is added to the score.

pub fn hotspot_score( &self, block_id: u64, current_tick: u64, ) -> Option<HotspotScore>

Return the decay-adjusted HotspotScore for block_id as of current_tick.

Returns None if the block has never been tracked.

pub fn hotspots(&self, current_tick: u64) -> Vec<HotspotScore>

Return all blocks currently classified as hotspots, sorted by score descending.

pub fn top_n(&self, n: usize, current_tick: u64) -> Vec<HotspotScore>

Return the top n blocks ordered by decay-adjusted score descending.

Non-hotspot blocks are included; the caller must check is_hotspot if only confirmed hotspots are required.

pub fn evict_cold(&mut self, current_tick: u64) -> usize

Remove all block records whose decay-adjusted score has fallen below 0.001.

Returns the number of records that were removed.

pub fn stats(&self, current_tick: u64) -> HotspotDetectorStats

Return aggregate statistics for the current state of the detector.