Struct SymbolChainTrace 

pub struct SymbolChainTrace {
    pub file: PathBuf,
    pub symbol: String,
    pub symbol_found: bool,
    pub depth: u32,
    pub best_effort: bool,
    pub callers: Option<Vec<ChainHop>>,
    pub callees: Option<Vec<ChainHop>>,
    pub unresolved_callees: Option<Vec<UnresolvedCallee>>,
    pub reason: String,
}

The result of a symbol-level call-chain trace. Its own surface (kind: "trace"), NOT folded into the ranked brief.

Fields

file: PathBuf

The file containing the traced symbol (project-root-relative).

symbol: String

The traced symbol name.

symbol_found: bool

Whether the symbol’s defining export was found in the graph. When false, the chains are empty and reason explains why.

depth: u32

The chain depth applied to both directions.

best_effort: bool

Whether this trace is best-effort (always true: symbol-level chains are labeled best-effort, syntactic per ADR-001).

callers: Option<Vec<ChainHop>>

Caller chain hops (UP). Present only when --callers was requested.

callees: Option<Vec<ChainHop>>

Callee chain hops (DOWN) resolved to an import-symbol edge. Present only when --callees was requested.

unresolved_callees: Option<Vec<UnresolvedCallee>>

Callees referenced at a call site in the symbol’s module that the syntactic walk could NOT resolve to an import-symbol edge (locals, globals, dynamic dispatch, re-bound callees). Reported, never dropped. Present only when --callees was requested.

reason: String

A human-readable summary of the trace outcome.

Trait Implementations

impl Clone for SymbolChainTrace

fn clone(&self) -> SymbolChainTrace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SymbolChainTrace

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

Formats the value using the given formatter.

impl Serialize for SymbolChainTrace

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

where __S: Serializer,

Serialize this value into the given Serde serializer.