cjm-capability-graph-sqlite

A local, file-backed context-graph storage capability for the cjm-substrate runtime that implements graph storage, traversal, and querying using SQLite.

Modules

• cjm_capability_graph_sqlite.__init__
• cjm_capability_graph_sqlite.capability — Capability implementation for Context Graph using SQLite.
• cjm_capability_graph_sqlite.query_translation — The per-backend translation of the typed query expressions (pass-2 Thread 5; stage 4): NodeQuery/EdgeQuery -> parameterized SQLite SQL over the nodes/edges schema. THIS module is what makes the typed surface portable - the expression is domain- and backend-neutral; every backend tool owns a translation like this one (the ratified stage-4 split: backend owns translation; the adapter stays generic). Pure functions, unit-tested against an in-memory DB with the production schema - no capability runtime needed.

API

cjm_capability_graph_sqlite.capability

• SQLiteGraphCapability class — Local, file-backed Context Graph implementation using SQLite.
• SQLiteGraphCapabilityConfig class — Configuration for SQLite Graph Capability.
• explain_query function — The planner's answer for a typed query, without running it -- the instrument's plan
• ingest_sources function — The source HEADs this db was ingested from, on a fresh read-only connection. A db built
• integrity_check function — Backend self-check (stage 4; the G3 corruption find institutionalized):
• journal_cursors function — This db's applied cursors, on a fresh read-only connection. A db built before the table
• query_edges function — Execute a typed edge query (stage 4) — same contract as query_nodes.
• query_nodes function — Execute a typed node query (stage 4) — translated to parameterized SQL
• raw_query function — Execute the raw escape — refuses backend mismatches (non-portable by
• record_ingest_sources function — Record the source HEADs this db was ingested from, REPLACING any earlier record
• record_journal_cursor function — Record how far into one journal family this db has applied, REPLACING that family's

cjm_capability_graph_sqlite.query_translation

• decode_projected_row function — Zip a projected row, decoding every property column from its JSON representation.
• translate_edge_query function — Translate an EdgeQuery to parameterized SQLite SQL.
• translate_node_query function — Translate a NodeQuery to parameterized SQLite SQL.

Dependencies

Depends on: cjm-context-graph-primitives, cjm-substrate