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

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/danilo-aguiar-br/sqlite-graphrag/schemas/deep-research-output-ack.schema.json",
  "title": "DeepResearchOutputAck",
  "description": "v1.1.05 (ADR-0065, Bug 2): short stdout ack emitted by `sqlite-graphrag deep-research --output PATH` after the full research envelope is written atomically to PATH (tempfile → fsync → rename via `atomic_io::write_json_atomic`). When `--output` is omitted, stdout is the full DeepResearchResponse instead (see deep-research.schema.json).",
  "type": "object",
  "required": [
    "written",
    "bytes",
    "blake3",
    "sub_queries_total",
    "unique_memories_found",
    "elapsed_ms"
  ],
  "additionalProperties": false,
  "properties": {
    "agent_surface": { "$ref": "https://github.com/danilo-aguiar-br/sqlite-graphrag/schemas/agent-surface.schema.json#/$defs/AgentSurfaceMeta" },
    "truncated": { "type": "boolean", "description": "GAP-SG-142: raised by the agent-native surface whenever it removed data from this envelope." },
    "count": { "type": "integer", "minimum": 0, "description": "GAP-SG-142: emitted under --count-only, which replaces the payload. See agent-surface.schema.json#/$defs/CountOnlyEnvelope." },
    "written": {
      "type": "string",
      "description": "Path string of the file that received the full deep-research JSON envelope."
    },
    "bytes": {
      "type": "integer",
      "minimum": 0,
      "description": "On-disk size of the written envelope file in bytes."
    },
    "blake3": {
      "type": "string",
      "description": "Hex-encoded BLAKE3 checksum of the envelope file bytes (integrity check for agent pipelines)."
    },
    "sub_queries_total": {
      "type": "integer",
      "minimum": 0,
      "description": "Total number of sub-queries generated for this run (mirrors stats.sub_queries_total)."
    },
    "unique_memories_found": {
      "type": "integer",
      "minimum": 0,
      "description": "Count of unique memories found across all sub-queries (mirrors stats.unique_memories_found)."
    },
    "elapsed_ms": {
      "type": "integer",
      "minimum": 0,
      "description": "Wall-clock duration of the deep-research handler in milliseconds."
    }
  },
  "examples": [
    {
      "written": "/tmp/research.json",
      "bytes": 18432,
      "blake3": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
      "sub_queries_total": 7,
      "unique_memories_found": 42,
      "elapsed_ms": 812
    }
  ]
}