Crate rto_graph 

Provenance-tagged knowledge graph store.

Every edge in a Roteiro graph carries a Provenance tag recording how it was produced: deterministically derived from source ASTs, authored by a human or agent in an ADR/blueprint, or inferred heuristically from docs and other artifacts. See ADR-0001.

The graph is a set of Nodes addressed by a deterministic natural Node::key, connected by Edges. Facts extracted from one source blob are grouped into a FactSet and applied atomically to a Store.

Structs

BlobRef

A blob in a tree: its repository-relative path and hex object id.

Edge

An edge in the knowledge graph, connecting two nodes by their keys.

FactSet

The set of nodes and edges extracted from a single source blob (or otherwise assembled together). Applying a fact set to a crate::Store is atomic.

FileNodeExtractor

Placeholder extractor: emits a single file node per blob, tagged with its blob hash and basic size metadata. Produces no edges. Superseded by the tree-sitter extractor in a later stage.

Node

A node in the knowledge graph.

ObjectCache

A content-addressed store of fact sets on disk.

Repo

A discovered git repository.

Span

A byte-offset range within a source blob (start..end).

Store

A Roteiro graph store backed by a single SQLite database.

SyncReport

A summary of the work a sync performed.

Enums

CacheError

Errors raised by the object cache.

Direction

Direction of traversal when querying a node’s neighbours.

EdgeKind

The kind of a graph edge (the relationship it records).

GitError

Errors raised while reading from a git repository.

NodeKind

The kind of a graph node.

Provenance

How an edge in the graph was produced.

StoreError

Errors raised by the store.

SyncError

Errors raised while syncing.

Traits

Extractor

Turns one source blob into the nodes and edges derived from it.

Functions

sync

Sync store to the repository’s HEAD tree, extracting changed blobs with extractor and caching results in cache.