Expand description
Graph schema — nodes, edges, kinds. Defines the Aun graph-artifact contract.
The Rust engine emits NATIVE kinds (the 9 base kinds) from day one; legacy kind
strings are mapped on ingest. Unknown kinds degrade to Unknown rather than crash.
Modules§
- relation
- The structural edge-relation vocabulary, defined ONCE so the producer (compile) and the
consumers (retrieval) can’t drift on a typo’d string literal. (Typed frontmatter relations —
depends_on,produces, … — live incompile::REL_FIELDS.)
Structs§
- Edge
- A directed, evidence-bearing edge — a synapse in the knowledge graph.
- Edge
Evidence - Graph
- The compiled graph. (Extended graph-artifact fields — stats/aliases/built_at — are added when structure parity is wired.)
- Node
- A graph node. Optional fields default so partial/external JSON never panics.
- Relation
Profile - Retrieval/traversal semantics for a relation name.
- Span
- A code node’s location: the byte/line span it occupies in a source file. Doc nodes (whole-file
units) carry
None; Glyph symbol nodes carrySomesoread_doccan return just the symbol body — every code node traceable to an exactfile:lineprovenance span.
Enums§
- Edge
Basis - The provenance basis of an edge — where the evidence comes from. This is the synaptic
strength signal:
Resolvededges (from syntax/authoring) are trusted and strong;Lexicaledges (from co-occurrence heuristics) are candidates, weak until verified. - Kind
- The 9 native base kinds, plus a tolerant
Unknownsink.
Constants§
- TRAVERSAL_
ONLY_ EVIDENCE - Evidence marker for a reference edge that exists PURELY as a call-graph relationship — a
self.attr.method()call resolved by inferred receiver type. Such edges powercallers/impacttraversal but are excluded from the BM25F grounding relation-surface: a callee’s “used by X” is call structure, not “aboutness”, and including it would let a caller bleed into the callee’s grounding (and vice-versa). Single source of truth so the extractor and the scorer agree.
Functions§
- core_
relation_ profile - Return the built-in profile for one native relation.
- core_
relation_ profiles - Built-in relation profiles for Eidos’ native graph vocabulary.