Expand description
Stack-trace frame resolution output contracts (fallow trace-error).
Stack-trace frame resolution contract for fallow trace-error.
The verb answers one narrow question: for each frame of a runtime stack trace, which definitions in the analysed project does that frame’s identifier name? It is deliberately easy to overclaim here, so the wire shape is built so that it cannot:
- a frame that matches several definitions reports
ambiguousand lists every candidate, instead of picking one and calling it the answer; - a frame that matches nothing reports
not_foundinstead of being dropped; - a frame that matches one definition but whose own line sits at a
different declaration carries
line_mismatch, because the look-up asks about the identifier and not about the line; - a frame the project graph was never asked about (a dependency frame, a
runtime-internal frame, a generated bundle, or a frame carrying no
identifier to look up) reports
not_attemptedrather than borrowingnot_found’s meaning; - every frame read from the input appears in
frames, in input order, andErrorTraceCountspublishes the per-outcome totals, so a caller can see exactly how much of its trace went unanswered.
No source-map resolution is performed. A frame pointing into a build artifact is reported as such, because a stale map rebinds silently to the wrong line and a wrong line is worse than an honest refusal.
Structs§
- Error
Trace - Result of resolving a runtime stack trace against the project graph.
- Error
Trace Candidate - One definition a frame’s identifier could name.
- Error
Trace Counts - Per-outcome totals for an
ErrorTrace. - Error
Trace Frame - One frame read from the input stack trace.
Enums§
- Error
Trace Schema Version - Wire-version discriminator for
ErrorTrace. Independent from the globalSchemaVersionand from the other trace payloads, likecrate::trace::ImportPathTraceSchemaVersion. Serializes as a stringconstso JSON consumers can switch on it. - Frame
Origin - Where a frame’s source location sits relative to the analysed project.
- Frame
Resolution - What the project graph could say about a frame’s identifier.