CacheKit Docs

High-performance cache policies and supporting data structures.

View the Project on GitHub OxidizeLabs/cachekit

ARC operational spec

Spec maturity: stub

Executable oracle: invariant checks on ArcCore; no full PolicyModel yet.

Adaptive Replacement Cache: dynamically balances recency (T1) and frequency (T2) lists. Victim selection is adaptive — not uniquely determined from residency alone.

State (implementation-shaped)

ARC maintains T1, T2, B1, B2 ghost lists and adaptation parameter p. Exact victim depends on list lengths and p.

Harness contract (InvariantOnly)

Check When
len <= capacity After every Op
debug_validate_invariants() After every Op

Per-Op adapter behavior

Op Effect
Insert(k) insert(k, v)
Get(k) get(k)
Peek(k) peek(k)
Remove(k) remove(k)
GetMut / Touch / EvictOne No-op in adapter

Observables

Future work

References