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

//! Regression tests for GAP-SG-272: `purge` accepts the name positionally.
//!
//! Three cases are covered:
//! 1. The positional `NAME` alone is captured and `--name` stays `None`.
//! 2. The `--name` flag alone keeps working, preserving every existing caller.
//! 3. Supplying both spellings is refused by clap, which exits with code 2.
//!
//! Omitting both spellings must stay valid, because that is what selects the
//! bulk mode driven by `--retention-days`.

use clap::Parser;
use sqlite_graphrag::cli::{Cli, Commands};

#[test]
fn regression_purge_args_accepts_name_positional() {
    let cli = Cli::try_parse_from(["sqlite-graphrag", "purge", "old-memory"])
        .expect("positional NAME must parse");
    let Some(Commands::Purge(args)) = cli.command else {
        panic!("expected the Purge command");
    };
    assert_eq!(
        args.name_positional.as_deref(),
        Some("old-memory"),
        "PurgeArgs must capture the positional NAME"
    );
    assert!(
        args.name.is_none(),
        "PurgeArgs.name must be None when the positional is used"
    );
}

#[test]
fn regression_purge_args_accepts_flag_name() {
    let cli = Cli::try_parse_from(["sqlite-graphrag", "purge", "--name", "old-memory"])
        .expect("--name must parse");
    let Some(Commands::Purge(args)) = cli.command else {
        panic!("expected the Purge command");
    };
    assert_eq!(
        args.name.as_deref(),
        Some("old-memory"),
        "PurgeArgs must keep capturing --name for back-compat"
    );
    assert!(
        args.name_positional.is_none(),
        "PurgeArgs.name_positional must be None when --name is used"
    );
}

#[test]
fn regression_purge_args_rejects_both_spellings_with_exit_code_2() {
    // `Cli` does not implement `Debug`, so the Ok arm cannot be unwrapped here.
    let parsed = Cli::try_parse_from([
        "sqlite-graphrag",
        "purge",
        "old-memory",
        "--name",
        "old-memory",
    ]);
    let err = match parsed {
        Ok(_) => panic!("supplying both spellings must be refused"),
        Err(err) => err,
    };
    assert_eq!(
        err.kind(),
        clap::error::ErrorKind::ArgumentConflict,
        "the refusal must come from the parser conflict, not from the handler"
    );
    assert_eq!(
        err.exit_code(),
        2,
        "a bad command line must exit with code 2"
    );
}

#[test]
fn regression_purge_args_without_name_keeps_bulk_mode() {
    let cli = Cli::try_parse_from(["sqlite-graphrag", "purge", "--retention-days", "30"])
        .expect("bulk mode must parse without any name");
    let Some(Commands::Purge(args)) = cli.command else {
        panic!("expected the Purge command");
    };
    assert!(args.name_positional.is_none());
    assert!(args.name.is_none());
    assert_eq!(args.retention_days, 30);
}