cache

type AdaptiveStats struct {
	ShardID            int
	K                  int32   // current protection threshold for this shard
	GraduationRate     float64 // fraction of items whose freq crossed the shard's k
	EvictedUnprotected uint64  // items evicted with freq <= k
	EvictedProtected   uint64  // items evicted with freq > k (fallback)
	ReachedProtected   uint64  // items whose freq crossed the shard's current k
	// Learned thresholds (self-tuning)
	LearnedRateLow  float64 // learned low threshold (rate below which k decreases)
	LearnedRateHigh float64 // learned high threshold (rate above which k increases)
	WindowHitRate   float64 // current window hit rate
}

type CloxCache[K Key, V any] struct {
	// contains filtered or unexported fields
}

type Config struct {
	NumShards     int  // Must be power of 2
	SlotsPerShard int  // Must be power of 2
	Capacity      int  // Max entries (0 = use SlotsPerShard * NumShards as default)
	CollectStats  bool // Enable hit/miss/eviction counters
	// (recommend: 15 for temporal workloads and low latency)
	SweepPercent int // Percentage of shard to scan during eviction
}

type Key interface {
	~string | ~[]byte
}