do_memory_core/retrieval/
mod.rs

1//! Episodic memory retrieval with caching and hybrid search.
2//!
3//! This module provides efficient retrieval of episodes with:
4//! - LRU caching and TTL for query results
5//! - BM25 keyword search (via CSM crate, first-tier, no API calls)
6//! - ConceptGraph ontology expansion (via CSM crate, synonym matching)
7//! - HDC hyperdimensional vectors (via CSM crate)
8//! - Cascading retrieval pipeline (WG-131)
9//! - Hierarchical/gist reranking for dense context (WG-118)
10//! - Reconstructive retrieval windows (WG-120, E-mem-inspired)
11//! - Execution-signature retrieval (WG-121, APEX-EM-inspired)
12//! - Scope-before-search shard routing (WG-122, ShardMemo-inspired)
13
14pub mod cache;
15pub mod cascade;
16pub mod gist;
17pub mod semantic_retriever;
18pub mod shard;
19pub mod signature;
20pub mod windows;
21
22// Re-export CSM types when csm feature is enabled
23#[cfg(feature = "csm")]
24pub use chaotic_semantic_memory::{
25    BundleAccumulator, ConceptGraph, HVec10240, encoder::TextEncoder as HdcEncoder,
26};
27
28#[cfg(feature = "csm")]
29pub use chaotic_semantic_memory::retrieval::{
30    Bm25Config, Bm25Index, HybridConfig, HybridMode, compute_weights, merge_results,
31    normalize_scores,
32};
33
34pub use cache::{CacheKey, CacheMetrics, DEFAULT_CACHE_TTL, DEFAULT_MAX_ENTRIES, QueryCache};
35pub use cascade::{CascadeConfig, CascadeResult, CascadeRetriever};
36pub use gist::{EpisodeGist, GistExtractor, GistScoredItem, HierarchicalReranker, RerankConfig};
37pub use semantic_retriever::{HybridHit, ScoreComponents, SemanticRetriever};
38pub use shard::{EpisodeMetadata, RoutingResult, ScopeFilter, ShardConfig, ShardRouter, TimeRange};
39pub use signature::{
40    ExecutionSignature, QuerySignature, SignatureConfig, SignatureMatch, SignatureMatcher,
41    StepPattern,
42};
43pub use windows::{
44    ContextWindow, RetrievalHit, WindowConfig, WindowExpander, WindowExpansionResult,
45    merge_overlapping_windows,
46};
do_memory_core/retrieval/mod.rs

do_memory_core/retrieval/
mod.rs
