MESA Core · v0.9.3
Graph traversal
This guide has equivalent English and Turkish versions. The source sections behind this page are at the bottom.
Canonical facts, derived paths#
SQLite owns entities and assertions. Kùzu projects their relationships for bounded neighbor retrieval. Different assertions between the same entities remain distinct because predicate, source and temporal identity matter. Entity reachability alone is not a supported answer.
Read the path and the runtime flag#
Require supporting assertion IDs, aligned entity paths and edge directions, reconciled against the authorized canonical records. graph_neighbor_retrieval reports operational support; a projection-only adapter does not implement traversal. An operational backend failure is an explicit 503, not silently complete search.
Ablation and limits#
graph_mode=disabled removes the retrieval lane for matched comparisons, but keeps canonical assertion retrieval and graph projection writes. PageRank is telemetry only. Bounds on seeds, hops, fan-out and request time prevent unbounded work; they do not guarantee completeness or latency.
Source reference for this page
The sections of the upstream file that back this page, unchanged. Source section links open the appendix automatically.
Canonical entity and Graph V2#
Entity IDs use a fixed UUID5 namespace:
UUID5(namespace, tenant_id + entity_type + identity_key)identity_key is the normalized ontology URI when supplied; otherwise it is
the Unicode NFKC, whitespace-normalized and case-folded canonical name.
Resolution order is ontology/external ID, registered alias, canonical name,
then create. Collisions produce a deterministic redirect; historical rows are
retained.
Canonical SQLite connections use WAL and synchronous=FULL by default;
weaker synchronization is restricted to the explicit test profile. This does
not create a transaction spanning SQLite, LanceDB and Kùzu.
SQLite is authoritative for v4_entities and immutable v4_assertions.
Kùzu is an idempotent projection. Assertions include subject, predicate,
entity or literal object, document/revision/chunk source, evidence span,
jurisdiction, authority, confidence, validity interval, mutation and pipeline
run. Assertion identity includes predicate, source and temporal context, so
different relations between the same entities remain distinct.
CONTRADICTS and SUPERSEDES connect assertions and preserve provenance.
PageRank only publishes observation telemetry; it cannot quarantine,
tombstone, delete or otherwise change retrieval eligibility.
