README.md

Policy Data Structures

These documents describe reusable data structures that show up across cache eviction policies (LRU/LRU-K/LFU/ARC/Clock/etc).

Index

• IntrusiveList — O(1) recency lists (LRU/SLRU/2Q/ARC)
• SlabArena — stable handles + free list (avoid pointer chasing)
• ClockRing — Clock/second-chance ring + hand
• GhostList — history (“ghost”) lists for adaptive policies (ARC/CAR)
• FixedHistory — fixed-size access history per key (LRU-K style)
• FrequencyBuckets — LFU bucket lists + min_freq tracking
• LazyHeap — heap + authoritative map with stale entries (heap LFU, OPT simulators)