mneme-brain 0.3.1

Persistent memory system for AI coding agents — Rust + SQLite + FTS5 + MCP. Hybrid search, age encryption, CRDT P2P sync, WASM plugins, TUI with knowledge graph.
Documentation 
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

/// Calcula similitud coseno entre dos vectores f32.
pub fn cosine_similarity(a: &[f32], b: &[f32]) -> f32 {
    debug_assert_eq!(a.len(), b.len(), "vectors must have same dimension");

    let dot: f32 = a.iter().zip(b.iter()).map(|(x, y)| x * y).sum();
    let norm_a: f32 = a.iter().map(|x| x * x).sum::<f32>().sqrt();
    let norm_b: f32 = b.iter().map(|x| x * x).sum::<f32>().sqrt();

    if norm_a == 0.0 || norm_b == 0.0 {
        return 0.0;
    }
    dot / (norm_a * norm_b)
}

/// Resultado de coincidencia semantica.
#[derive(Debug, Clone)]
pub struct SemanticMatch {
    /// ID de la memoria.
    pub memory_id: uuid::Uuid,
    /// Score de similitud coseno.
    pub cosine_score: f32,
    /// Score combinado (coseno * boost * decaimiento).
    pub combined_score: f64,
}

/// Ordena coincidencias semanticas por score combinado descendente.
pub fn rank_by_combined_score(matches: &mut [SemanticMatch]) {
    matches.sort_by(|a, b| {
        b.combined_score
            .partial_cmp(&a.combined_score)
            .unwrap_or(std::cmp::Ordering::Equal)
    });
}