recall-echo 3.13.0

Persistent memory system with knowledge graph — for any LLM tool
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

//! Integration tests for EPHEMERAL.md FIFO window management.

use recall_echo::ephemeral::{self, EphemeralEntry};
use tempfile::TempDir;

fn make_entry(id: u32) -> EphemeralEntry {
    EphemeralEntry {
        session_id: format!("session-{id:03}"),
        date: format!("2026-04-{id:02}T10:00:00Z"),
        duration: "30m".to_string(),
        message_count: 10 + id,
        archive_file: format!("conversation-{id:03}.md"),
        summary: format!("Session {id} discussed topic {id}."),
    }
}

#[test]
fn append_to_empty_file() {
    let dir = TempDir::new().unwrap();
    let path = dir.path().join("EPHEMERAL.md");

    ephemeral::append_entry(&path, &make_entry(1)).unwrap();

    let count = ephemeral::count_entries(&path).unwrap();
    assert_eq!(count, 1);
}

#[test]
fn append_multiple_entries() {
    let dir = TempDir::new().unwrap();
    let path = dir.path().join("EPHEMERAL.md");

    for i in 1..=3 {
        ephemeral::append_entry(&path, &make_entry(i)).unwrap();
    }

    let count = ephemeral::count_entries(&path).unwrap();
    assert_eq!(count, 3);
}

#[test]
fn trim_evicts_oldest() {
    let dir = TempDir::new().unwrap();
    let path = dir.path().join("EPHEMERAL.md");

    // Add 6 entries
    for i in 1..=6 {
        ephemeral::append_entry(&path, &make_entry(i)).unwrap();
    }

    assert_eq!(ephemeral::count_entries(&path).unwrap(), 6);

    // Trim to 5 (default max)
    ephemeral::trim_to_limit(&path, 5).unwrap();

    let count = ephemeral::count_entries(&path).unwrap();
    assert_eq!(count, 5, "should have trimmed to 5");

    // Verify oldest (session-001) was evicted
    let content = std::fs::read_to_string(&path).unwrap();
    assert!(
        !content.contains("session-001"),
        "oldest entry should be evicted"
    );
    assert!(
        content.contains("session-006"),
        "newest entry should remain"
    );
}

#[test]
fn trim_noop_when_under_limit() {
    let dir = TempDir::new().unwrap();
    let path = dir.path().join("EPHEMERAL.md");

    for i in 1..=3 {
        ephemeral::append_entry(&path, &make_entry(i)).unwrap();
    }

    ephemeral::trim_to_limit(&path, 5).unwrap();

    assert_eq!(ephemeral::count_entries(&path).unwrap(), 3);
}

#[test]
fn trim_nonexistent_file_is_ok() {
    let dir = TempDir::new().unwrap();
    let path = dir.path().join("EPHEMERAL.md");

    // Should not error on missing file
    ephemeral::trim_to_limit(&path, 5).unwrap();
}

#[test]
fn count_nonexistent_file_is_zero() {
    let dir = TempDir::new().unwrap();
    let path = dir.path().join("EPHEMERAL.md");

    assert_eq!(ephemeral::count_entries(&path).unwrap(), 0);
}

#[test]
fn parse_entries_empty_content() {
    let entries = ephemeral::parse_entries("");
    assert!(entries.is_empty());
}

#[test]
fn parse_entries_whitespace_only() {
    let entries = ephemeral::parse_entries("   \n\n  ");
    assert!(entries.is_empty());
}

#[test]
fn entry_render_contains_key_fields() {
    let entry = make_entry(42);
    let rendered = entry.render();

    assert!(rendered.contains("session-042"));
    assert!(rendered.contains("conversation-042.md"));
    assert!(rendered.contains("Session 42 discussed"));
}