CacheKit Docs

High-performance cache policies and supporting data structures.

View the Project on GitHub OxidizeLabs/cachekit

S3-FIFO operational spec

Spec maturity: stub

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

S3-FIFO: three FIFO queues (small, main, ghost) for scan resistance. Victim selection depends on queue roles — not uniquely determined here.

Harness contract (InvariantOnly)

Check When
len <= capacity After every Op
check_invariants() After every Op (debug builds only in adapter)

Per-Op adapter behavior

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

Observables

References