Enum WitnessEvent 

pub enum WitnessEvent {
    Access {
        key: BlockKey,
        score: f32,
        tier: Tier,
    },
    TierChange {
        key: BlockKey,
        from_tier: Tier,
        to_tier: Tier,
        score: f32,
        reason: TierChangeReason,
    },
    Eviction {
        key: BlockKey,
        score: f32,
        bytes_freed: usize,
    },
    Maintenance {
        upgrades: u32,
        downgrades: u32,
        evictions: u32,
        bytes_freed: usize,
        budget_remaining_bytes: u32,
        budget_remaining_ops: u32,
    },
    Compaction {
        key: BlockKey,
        chain_len_before: u8,
    },
    ChecksumFailure {
        key: BlockKey,
        expected: u32,
        actual: u32,
    },
    Reconstruction {
        key: BlockKey,
        policy: ReconstructPolicy,
        success: bool,
    },
}

Types of witnessed events.

Every variant captures the minimum context required to reconstruct the decision after the fact (key, scores, tiers, byte counts).

Variants

Access

A block was accessed (read or write).

Fields

key: BlockKey

score: f32

tier: Tier

TierChange

A block changed tiers.

Fields

key: BlockKey

from_tier: Tier

to_tier: Tier

score: f32

reason: TierChangeReason

Eviction

A block was evicted (compressed to zero).

Fields

key: BlockKey

score: f32

bytes_freed: usize

Maintenance

A maintenance tick was processed.

Fields

upgrades: u32

downgrades: u32

evictions: u32

bytes_freed: usize

budget_remaining_bytes: u32

budget_remaining_ops: u32

Compaction

A delta chain was compacted.

Fields

key: BlockKey

chain_len_before: u8

ChecksumFailure

A checksum mismatch was detected.

Fields

key: BlockKey

expected: u32

actual: u32

Reconstruction

A block was reconstructed from deltas or factors.

Fields

key: BlockKey

policy: ReconstructPolicy

success: bool

Trait Implementations

impl Clone for WitnessEvent

fn clone(&self) -> WitnessEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WitnessEvent

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

Formats the value using the given formatter.