Module enhanced_retrieval

codex_memory::memory

Module enhanced_retrieval 

Source
Expand description

Memory-Aware Retrieval System for Story 9

This module implements enhanced memory-aware retrieval with cognitive principles including recently consolidated memory boosting, reflection/insight inclusion, memory lineage tracking, query pattern caching, and performance optimizations.

§Cognitive Science Foundation

§Research Basis

  1. Strengthening Bias (Bjork & Bjork, 1992): Recently strengthened memories have enhanced retrieval
  2. Elaborative Processing (Craik & Lockhart, 1972): Deep processing creates retrievable cues
  3. Spreading Activation (Anderson, 1983): Related concepts activate each other
  4. Recognition Heuristic (Goldstein & Gigerenzer, 2002): Familiarity aids recall
  5. Memory Palace Effect (Yates, 1966): Structured relationships aid retrieval

§Key Features

§Recently Consolidated Memory Boosting

  • 2x boost for memories with recent consolidation activity
  • Exponential decay based on time since consolidation
  • Consolidation strength weighting

§Reflection/Insight Integration

  • Automatic inclusion of insight memories in search results
  • Meta-memory identification and special scoring
  • Cross-referenced with original source memories

§Memory Lineage Tracking

  • 3-level depth traversal of memory relationships
  • Parent-child memory chains
  • Bidirectional relationship mapping
  • Provenance metadata inclusion

§Query Pattern Caching

  • Semantic hash-based cache keys
  • Configurable TTL and invalidation policies
  • LRU eviction with memory pressure awareness
  • Cache hit ratio optimization

§Performance Optimizations

  • Batch database operations
  • Index-optimized queries
  • Async result streaming
  • P95 latency target: <200ms

Structs§

BoostExplanation
Explanation of score boosting applied
CacheEntry
Query cache entry
CacheOperationMetrics
Cache operation metrics
ConsolidationEvent
Consolidation event in memory history
EnhancedRetrievalConfig
Configuration for memory-aware retrieval
MemoryAncestor
Ancestor memory in lineage chain
MemoryAwareRetrievalEngine
Main memory-aware retrieval engine
MemoryAwareSearchRequest
Enhanced search request with memory-aware features
MemoryAwareSearchResponse
Enhanced search response with memory-aware features
MemoryAwareSearchResult
Enhanced search result with memory-aware features
MemoryDescendant
Descendant memory in lineage chain
MemoryLineage
Memory lineage information
ModificationRecord
Modification record for provenance
PerformanceMetrics
Performance metrics for monitoring
ProvenanceMetadata
Provenance metadata for memory lineage
QualityIndicators
Quality indicators for memory assessment
QueryPatternCache
Query pattern cache implementation

Enums§

RelationshipType
Types of memory relationships