Reference

Orbit schema

Riven uses Orbit Local as its graph source of truth. It does not assume the graph blindly; it validates the required schema at runtime before traversing.

Confirmed fields

gl_edge.source_id BIGINT
gl_edge.source_kind VARCHAR
gl_edge.relationship_kind VARCHAR
gl_edge.target_id BIGINT
gl_edge.target_kind VARCHAR
gl_edge.traversal_path VARCHAR

gl_definition.id BIGINT
gl_definition.file_path VARCHAR
gl_definition.fqn VARCHAR
gl_definition.name VARCHAR
gl_definition.definition_type VARCHAR
gl_definition.start_line BIGINT
gl_definition.end_line BIGINT

Relationship discovery query

SELECT relationship_kind, count(*) AS n
FROM gl_edge
GROUP BY relationship_kind
ORDER BY n DESC;

The edge that matters for V0

Definition -CALLS-> Definition

Riven discovers real relationship kinds at runtime and then walks inbound static CALLS edges to find impacted callers.

Why this matters

The claim is intentionally narrow and honest: graph-proven static impact. This is stronger than file-level similarity, but it is not a claim of perfect runtime behavior.

Next: Architecture.