sqlite-graphrag 1.2.8

Persistent GraphRAG memory for Claude Code, Codex, Cursor, and 27 AI agents — one self-contained ~19 MiB Rust binary, zero daemon. Never re-explain your codebase again. Hybrid retrieval (FTS5 BM25 + cosine similarity + multi-hop graph traversal) surfaces the right memory in milliseconds. Embedding and entity enrichment run as parallel REST calls against your cloud LLM — no fragile headless subprocesses, no ONNX runtime, no model downloads. Soft-delete with full version history, transactional atomic writes, BLAKE3-tracked mutations. OAuth-only: raw API keys ABORT the spawn.
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

//! GAP-SG-141 residual (v1.2.4): re-embed dry-run reports a live backlog on an
//! isolated TempDir database — no monorepo job singleton, no network.

use std::process::Command;
use tempfile::TempDir;

fn bin() -> Command {
    let mut c = Command::new(env!("CARGO_BIN_EXE_sqlite-graphrag"));
    c.env_remove("OPENROUTER_API_KEY");
    c.env_remove("SQLITE_GRAPHRAG_API_KEY");
    c
}

#[test]
fn reembed_dry_run_reports_items_total_on_isolated_db() {
    let tmp = TempDir::new().unwrap();
    let db = tmp.path().join("t.sqlite");
    let init = bin()
        .args(["init", "--db"])
        .arg(&db)
        .arg("-q")
        .status()
        .expect("init");
    assert!(init.success(), "init must succeed");

    // Remember without embedding backend produces missing vectors.
    for i in 0..5 {
        let body = format!("body for memory {i} with enough text to store");
        let out = bin()
            .args(["remember", "--db"])
            .arg(&db)
            .args([
                "--name",
                &format!("m-{i}"),
                "--type",
                "note",
                "--description",
                &format!("desc {i}"),
                "--body",
                &body,
                "--llm-backend",
                "none",
                "--embedding-backend",
                "auto",
                "--skip-embedding-on-failure",
                "-q",
                "--no-input",
            ])
            .output()
            .expect("remember");
        assert!(
            out.status.success(),
            "remember {i}: {}",
            String::from_utf8_lossy(&out.stderr)
        );
    }

    let out = bin()
        .args(["enrich", "--db"])
        .arg(&db)
        .args([
            "--operation",
            "re-embed",
            "--target",
            "memories",
            "--dry-run",
            "--llm-backend",
            "none",
            "--embedding-backend",
            "auto",
            "-q",
            "--no-input",
            "--scan-page-size",
            "2",
        ])
        .output()
        .expect("enrich dry-run");
    let stdout = String::from_utf8_lossy(&out.stdout);
    let stderr = String::from_utf8_lossy(&out.stderr);
    assert!(
        out.status.success(),
        "dry-run must succeed: stderr={stderr} stdout={stdout}"
    );
    assert!(
        stdout.contains("items_total") || stdout.contains("\"total\""),
        "expected items_total in dry-run output: {stdout}"
    );
    // At least one preview / total > 0
    let has_positive = stdout.lines().any(|l| {
        l.contains("items_total")
            && (l.contains(":5")
                || l.contains(": 5")
                || l.contains("\"items_total\":5")
                || l.contains("\"items_total\": 5"))
            || (l.contains("\"status\":\"preview\"") || l.contains("\"status\": \"preview\""))
    });
    assert!(
        has_positive || stdout.matches("preview").count() >= 1,
        "expected non-zero re-embed backlog in dry-run: {stdout}"
    );
    eprintln!("GAP-SG-141 isolated dry-run stdout_len={}", stdout.len());
}