1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
//! # DualCache-FF (Fast and Furious)
//!
//! A highly opinionated, absolutely wait-free concurrent cache in Rust, optimized for extreme
//! read-to-write ratios and scan-resistance. Built for high-performance and `no_std` embedded
//! target environments.
//!
//! ## 🧠Key Concepts & Features
//!
//! - **Wait-Free Read Path & QSBR**: All reads are completely non-blocking and wait-free.
//! Memory reclamation is handled via Quiet State Based Reclamation (QSBR), allowing readers
//! to instantly access cached nodes without locks, mutexes, or atomic reference counting overhead.
//! - **Three-Tier Promotion System**:
//! - **T1 (Hot Cache)**: A high-speed `AtomicPtr` slot array mapping to Cache indices for instant lookup.
//! - **T2 (Secondary Filter)**: A larger slot array for capturing secondary heat patterns.
//! - **Cache (Main Storage)**: The source of truth using an open-addressed index (Linear Probing).
//! - **Asynchronous Daemon & Batched Telemetry**: Cache admissions and evictions are handled
//! exclusively by an asynchronous background daemon. Read/write telemetry is buffered locally
//! in Thread-Local Storage (TLS) and periodically flushed to the daemon via a custom lock-free `LossyQueue`.
//! - **Avg-based Clock Eviction**: A revolution-shielded circular clock evicts items whose
//! access rank falls below the global average, instantly adapting to shifting workload heat distributions.
//! - **`no_std` / Bare-Metal Fallback**: Out-of-the-box support for resource-constrained environments
//! via `StaticDualCache`, using atomic spinlocks to eliminate background threads and achieve zero idle power.
extern crate alloc;
pub
pub use Config;
pub use ;
pub use ;
pub use Daemon;
pub use StaticDualCache;