Module path 

Retrieval-path types — graph-traversal output, optionally enriched with a provenance anchor on each hop.

Returned by crate::KnowledgeGraph::recall_paths. The default PathHop::chain_entry is None; the ProvenanceKnowledgeGraph wrapper in klieo-memory-graph-rag populates the field by looking up each hop’s FactId against a ProvenanceRepository. None is the explicit signal of an unsigned hop (e.g. fact indexed before the projector was wrapped).

Provenance feature gate

klieo-memory-graph exposes the provenance anchor behind the provenance feature (default ON). With the feature enabled, chain_entry carries a real klieo_provenance::ChainEntry. With default-features = false, ChainEntry resolves to a unit-like placeholder so the graph trait surface compiles without pulling the audit-chain crate (ed25519-dalek, sha2, hex). The field shape stays Option<ChainEntry> either way — adapters that emit anchors must enable the feature.

Structs

ChainEntry

One entry in the append-only chain.

PathHop

One step along a retrieval traversal: an entity touched, the fact it mentions, and (optionally) the signed chain entry that proves the index call.

RetrievalPath

A single retrieval traversal — ordered hops from entry entity to the deepest fact reached. Empty hops is a valid no-op result (caller asked but the graph had no matching facts).