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

//! Shared harness for the PRD-compliance suites (GAP-SG-208).
//!
//! Extracted from `prd_compliance.rs`, which carried 1367 lines and 32 tests,
//! past the 800-line ceiling the project sets for itself. Each test isolates
//! itself with an exclusive TempDir plus a planted `db.path` / `--config-dir`.

#![allow(dead_code)]

use assert_cmd::Command;

use std::path::PathBuf;
use tempfile::TempDir;

/// Builds a fresh `Command` with the mock LLM PATH prepended.
///
/// v1.0.76 spawns `claude` or `codex` on every `remember` / `ingest` /
/// `edit`. The bundled mocks under `tests/mock-llm/` return a fixed
/// 64-dim zero vector so the binary finishes without a real OAuth
/// login. The mock directory is leaked (no TempDir cleanup) so the
/// spawned subprocess always finds the mocks.
pub fn sgr_cmd() -> Command {
    let mock_dir = common::mock_llm_path();
    let mut c = Command::cargo_bin("sqlite-graphrag").expect("sqlite-graphrag binary not found");
    c.env("PATH", common::prepend_path(&mock_dir));
    c
}

#[path = "../common/mod.rs"]
pub mod common;

// ---------------------------------------------------------------------------
// helpers
// ---------------------------------------------------------------------------

pub fn cmd_base(tmp: &TempDir) -> Command {
    // GAP-SG-101: product env is not read (G-T-XDG-04).
    let mut c = sgr_cmd();
    common::wire_assert_cmd(tmp, &mut c, "test.sqlite");
    c.arg("--lang").arg("en");
    c.arg("--skip-memory-guard");
    c
}

pub fn init_db(tmp: &TempDir) {
    cmd_base(tmp).arg("init").assert().success();
}

pub fn remember_ok(tmp: &TempDir, name: &str, body: &str) {
    cmd_base(tmp)
        .args([
            "remember",
            "--name",
            name,
            "--type",
            "user",
            "--description",
            "desc for prd test",
            "--namespace",
            "global",
            "--body",
            body,
            "--skip-extraction",
        ])
        .assert()
        .success();
}

pub fn db_path(tmp: &TempDir) -> PathBuf {
    tmp.path().join("test.sqlite")
}

// ---------------------------------------------------------------------------