Struct EvolutionTracker 

pub struct EvolutionTracker<L: LLMProvider, S: StorageBackend> { /* private fields */ }

Track how memories evolve over time.

Uses LLM to detect relationships between new and existing memories.

Type Parameters

• L: LLM provider for detection (SimLLMProvider for testing)
• S: Storage backend for entity lookup

Example

let tracker = EvolutionTracker::new(llm, storage);
let result = tracker.detect(&new_entity, &existing, DetectionOptions::default()).await?;
if let Some(detection) = result {
    println!("Evolution: {:?}", detection.evolution_type());
}

Implementations

impl<L: LLMProvider, S: StorageBackend> EvolutionTracker<L, S>

pub fn new(llm: L) -> Self

Create a new evolution tracker.

Arguments

• llm - LLM provider for evolution detection

pub async fn detect( &self, new_entity: &Entity, existing_entities: &[Entity], options: DetectionOptions, ) -> Result<Option<DetectionResult>, EvolutionError>

Detect evolution relationship between new and existing entities.

Arguments

• new_entity - Newly created entity
• existing_entities - Related existing entities to compare against
• options - Detection options

Returns

Ok(Some(DetectionResult)) if evolution detected above threshold, Ok(None) if no relationship found or detection failed (graceful degradation), Err(EvolutionError) for invalid options.

Graceful Degradation

LLM failures return Ok(None) instead of errors to avoid breaking the calling code’s flow.