Struct TraversalProvenanceTrace 

pub struct TraversalProvenanceTrace {
    pub graph_version: GraphVersion,
    pub source_scope: Option<String>,
    pub routed_intent: String,
    pub visited_nodes: Vec<TraversalTraceNode>,
    pub visited_edges: Vec<TraversalTraceEdge>,
    pub cited_evidence: Vec<TraversalTraceEvidence>,
    pub visited_but_uncited: Vec<TraversalTraceEvidence>,
    pub ranking_contributions: Vec<TraversalRankingContribution>,
    pub truncated: bool,
    pub stale: bool,
    pub degraded_reason: Option<String>,
    pub redaction: TraversalTraceRedaction,
}

Bounded explanation of the graph traversal and candidate path used for an answer.

Fields

graph_version: GraphVersion

source_scope: Option<String>

routed_intent: String

visited_nodes: Vec<TraversalTraceNode>

visited_edges: Vec<TraversalTraceEdge>

cited_evidence: Vec<TraversalTraceEvidence>

visited_but_uncited: Vec<TraversalTraceEvidence>

ranking_contributions: Vec<TraversalRankingContribution>

truncated: bool

stale: bool

degraded_reason: Option<String>

redaction: TraversalTraceRedaction

Implementations

impl TraversalProvenanceTrace

pub fn from_hits( graph_version: GraphVersion, source_scope: Option<String>, routed_intent: String, hits: &[RetrievalHit], ) -> Self

Builds a traversal trace from storage candidates before answer-level citation is known.

pub fn mark_citations<I>(&mut self, cited_result_ids: I)

where I: IntoIterator, I::Item: AsRef<str>,

Marks which visited evidence items are cited by the final context pack.

pub fn apply_budget(&mut self, max_trace_items: usize)

Truncates low-priority trace detail without dropping cited evidence first.

Trait Implementations

impl Clone for TraversalProvenanceTrace

fn clone(&self) -> TraversalProvenanceTrace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraversalProvenanceTrace

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TraversalProvenanceTrace

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TraversalProvenanceTrace

fn eq(&self, other: &TraversalProvenanceTrace) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TraversalProvenanceTrace

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TraversalProvenanceTrace