x

Author: zTgx

docs/design/logo-horizontal.svg

@@ -3,8 +3,17 @@
 
 //! Caching for retrieval operations.
 //!
-//! Caches search paths and node scores for repeated queries.
+//! Three-tier reasoning cache:
+//! - **L1**: Exact query match — instant cache hit for repeated queries
+//! - **L2**: Path pattern cache — reuse navigation decisions across queries
+//! - **L3**: Strategy score cache — share keyword/BM25 scores across queries
+//!
+//! Legacy `PathCache` remains for backward compatibility.
 
 mod path_cache;
+mod reasoning_cache;
 
 pub use path_cache::PathCache;
+pub use reasoning_cache::{
+    CachedCandidate, ReasoningCache, ReasoningCacheConfig, ReasoningCacheStats,
+};