loci-mcp 0.2.3

Cognitive memory MCP server — persistent, structured, cross-session memory for AI agents
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! CLI maintenance commands — `compact` and `cleanup` for memory lifecycle management.

use anyhow::Result;

use crate::config::LociConfig;
use crate::memory::maintenance;

/// Run full compaction cycle: decay + compact + promote.
///
/// Async because compaction and promotion need the embedding provider.
pub async fn compact(config: &LociConfig) -> Result<()> {
    let db_path = config.resolved_db_path();
    let mut conn = crate::db::open_database(&db_path)?;
    let embedding = crate::embedding::create_provider(&config.embedding)?;

    // 1. Confidence decay
    println!("Applying confidence decay...");
    let decay_result = maintenance::apply_decay(&conn, &config.maintenance)?;

    let total_decayed: usize = decay_result.affected_by_type.values().sum();
    if total_decayed > 0 {
        println!("  Decayed {total_decayed} memories:");
        for (mem_type, count) in &decay_result.affected_by_type {
            if *count > 0 {
                println!("    {mem_type}: {count}");
            }
        }
    } else {
        println!("  No memories to decay.");
    }

    // 2. Episodic compaction
    println!("Running episodic compaction...");
    let compact_result =
        maintenance::compact_episodic(&mut conn, embedding.as_ref(), &config.maintenance)?;

    if compact_result.summaries_created > 0 {
        println!(
            "  Compacted {} memories across {} groups into {} summaries.",
            compact_result.memories_compacted,
            compact_result.groups_compacted,
            compact_result.summaries_created,
        );
    } else {
        println!("  No episodic groups eligible for compaction.");
    }

    // 3. Episodic-to-semantic promotion
    println!("Checking for episodic-to-semantic promotions...");
    let promote_result = maintenance::promote_episodic_to_semantic(
        &mut conn,
        embedding.as_ref(),
        &config.maintenance,
    )?;

    if promote_result.semantics_created > 0 {
        println!(
            "  Found {} clusters, created {} semantic memories.",
            promote_result.clusters_found, promote_result.semantics_created,
        );
    } else {
        println!("  No episodic clusters eligible for promotion.");
    }

    println!("Compaction complete.");
    Ok(())
}

/// Run cleanup of stale, low-confidence memories.
pub fn cleanup(config: &LociConfig, dry_run: bool) -> Result<()> {
    let db_path = config.resolved_db_path();
    let mut conn = crate::db::open_database(&db_path)?;

    let result = maintenance::cleanup_stale(&mut conn, &config.maintenance, dry_run)?;

    if result.candidates.is_empty() {
        println!("No stale memories found.");
        return Ok(());
    }

    if dry_run {
        println!(
            "Found {} candidate(s) for cleanup (dry run — nothing deleted):\n",
            result.candidates.len()
        );
        println!(
            "{:<38} {:<12} {:<10} {}",
            "ID", "Type", "Confidence", "Preview"
        );
        println!("{}", "-".repeat(90));
        for c in &result.candidates {
            println!(
                "{:<38} {:<12} {:<10.4} {}",
                c.id, c.memory_type, c.confidence, c.content_preview
            );
        }
    } else {
        println!("Deleted {} stale memories.", result.deleted);
    }

    Ok(())
}