sqlite-graphrag 1.2.1

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
103
104
105

//! Extracted `fase_g_parsing_tests` (Wave C1).

use super::Cli;
use clap::Parser;

/// GAP-SG-31(b): `enrich --status` parses without --operation/--mode.
#[test]
fn enrich_status_optional_operation_and_mode() {
    assert!(
        Cli::try_parse_from(["sqlite-graphrag", "enrich", "--status"]).is_ok(),
        "--status alone must not require --operation/--mode"
    );
    assert!(
        Cli::try_parse_from(["sqlite-graphrag", "enrich", "--list-dead"]).is_ok(),
        "--list-dead is read-only and must not require --operation/--mode"
    );
    // Write path still requires both: bare `enrich` is rejected.
    assert!(
        Cli::try_parse_from(["sqlite-graphrag", "enrich"]).is_err(),
        "bare enrich (no status/list-dead/requeue-dead) must require --operation/--mode"
    );
    // Full write invocation still parses.
    assert!(Cli::try_parse_from([
        "sqlite-graphrag",
        "enrich",
        "--operation",
        "memory-bindings",
        "--mode",
        "openrouter",
    ])
    .is_ok());
}

/// GAP-SG-34(c): `config doctor --json` parses (no-op flag accepted).
#[test]
fn config_doctor_accepts_json() {
    assert!(Cli::try_parse_from(["sqlite-graphrag", "config", "doctor", "--json"]).is_ok());
    assert!(Cli::try_parse_from(["sqlite-graphrag", "config", "list-keys", "--json"]).is_ok());
}

/// GAP-SG-33(d): a hyphen-led --description value is accepted, not parsed
/// as a flag.
#[test]
fn remember_description_allows_leading_hyphen() {
    assert!(Cli::try_parse_from([
        "sqlite-graphrag",
        "remember",
        "--name",
        "mem",
        "--type",
        "note",
        "--description",
        "- bullet description",
    ])
    .is_ok());
}

/// GAP-SG-35(e): `remember-batch --llm-parallelism N` parses.
#[test]
fn remember_batch_accepts_llm_parallelism() {
    assert!(Cli::try_parse_from([
        "sqlite-graphrag",
        "remember-batch",
        "--llm-parallelism",
        "4"
    ])
    .is_ok());
}

/// GAP-SG-30: --graph-file combines with a body source but conflicts with
/// the other graph-input flags.
#[test]
fn remember_graph_file_combines_with_body_but_conflicts_with_graph_stdin() {
    assert!(
        Cli::try_parse_from([
            "sqlite-graphrag",
            "remember",
            "--name",
            "mem",
            "--type",
            "note",
            "--body",
            "inline body",
            "--graph-file",
            "/tmp/graph.json",
        ])
        .is_ok(),
        "--body + --graph-file must coexist"
    );
    assert!(
        Cli::try_parse_from([
            "sqlite-graphrag",
            "remember",
            "--name",
            "mem",
            "--type",
            "note",
            "--graph-file",
            "/tmp/graph.json",
            "--graph-stdin",
        ])
        .is_err(),
        "--graph-file conflicts with --graph-stdin"
    );
}