pub struct Edge {
pub from: String,
pub to: String,
pub relation: String,
pub evidence: String,
pub evidence_refs: Vec<EdgeEvidence>,
pub basis: EdgeBasis,
pub asserted_at: u64,
pub expires_at: Option<u64>,
}Expand description
A directed, evidence-bearing edge — a synapse in the knowledge graph.
§Bi-temporal fields
asserted_at and expires_at are the temporal axis (the Graphiti idea, deterministic).
Human-authored edges keep expires_at = None (stable forever). Sigil-accepted files can receive
a half-life from EKF trust.agent_accepted_ttl_days: expires_at = asserted_at + TTL. The edge
is not deleted — when expired, Engine policy can de-rank it and flag it for re-verification.
The runtime properties (use_count, last_used) are NOT stored here — they live in the
Ryn metadata overlay (SQLite), keyed by edge identity. The graph stays deterministic; the
overlay breathes.
Fields§
§from: String§to: String§relation: String§evidence: StringBackward-compatible compact evidence summary. When several sources assert the same edge, summaries are merged instead of dropping later evidence.
evidence_refs: Vec<EdgeEvidence>Structured receipts for why this edge exists. The graph keeps the compact evidence string
for old consumers, while agents that need auditability can inspect these receipt records.
basis: EdgeBasisProvenance basis — the synaptic strength class. Defaults to Resolved (backward-compatible).
asserted_at: u64When this edge was asserted (compile time, unix seconds). 0 = unknown/stable.
Deterministic: the same source files always produce the same asserted_at per build.
expires_at: Option<u64>When this edge should be re-verified. None = stable (human-authored, no decay).
Some(t) = agent-accepted, decays at time t. The immune system trigger.