Skip to main content

Module schema

Module schema 

Source
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 in compile::REL_FIELDS.)

Structs§

Edge
A directed, evidence-bearing edge — a synapse in the knowledge graph.
EdgeEvidence
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.
RelationProfile
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 carry Some so read_doc can return just the symbol body — every code node traceable to an exact file:line provenance span.

Enums§

EdgeBasis
The provenance basis of an edge — where the evidence comes from. This is the synaptic strength signal: Resolved edges (from syntax/authoring) are trusted and strong; Lexical edges (from co-occurrence heuristics) are candidates, weak until verified.
Kind
The 9 native base kinds, plus a tolerant Unknown sink.

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 power callers/impact traversal 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.