Expand description
Property Graph Engine — SQLite-backed code knowledge graph.
Stores nodes (File, Symbol, Module) and edges (imports, calls, defines,
exports) extracted by deep_queries + import_resolver. Provides
efficient traversal queries for impact analysis, architecture discovery,
and graph-driven context loading.
Re-exports§
pub use file_catalog::FileCatalogEntry;
Modules§
- file_
catalog - snapshot
- Versioned, committable graph snapshots — Context-as-Code (GL#451).
Structs§
Enums§
Constants§
- GRAPH_
ENGINE_ VERSION - Property-graph engine generation. Bump whenever edge extraction changes
(e.g. the
type_refedges that connect C#/Java same-namespace consumers to their definers, GH #398) so an existing graph built by an older engine is transparently rebuilt on the next query instead of being served without the new edges. Graphs whosegraph.meta.jsonpredates this stamp deserialize to engine version0, so the first query after an upgrade rebuilds once.
Functions§
- edge_
weight - Weight multiplier per edge kind for impact scoring.
- engine_
outdated truewhen the persisted graph was built by an engine older thanGRAPH_ENGINE_VERSION— or predates the version stamp entirely (missing or unreadable meta) — and must therefore be rebuilt before its edges can be trusted. Callers pair this with a node-count check: an empty graph is rebuilt regardless; a non-empty-but-outdated graph is rebuilt by this gate.- file_
connectivity - Graph connectivity stats for a file: incoming/outgoing edge counts by kind.
- graph_
dir - Resolve the directory for graph.db and graph.meta.json.
- load_
meta - meta_
path - related_
files - Related files for a given path: direct neighbors via any structural edge, sorted by edge weight (strongest relationship first). Returns (path, weight) pairs.
- write_
meta