Struct Finding 

#[non_exhaustive]
pub struct Finding {
    pub id: String,
    pub file: String,
    pub function: String,
    pub line: u32,
    pub verdict: Verdict,
    pub invocations: Option<u64>,
    pub confidence: Confidence,
    pub evidence: Evidence,
    pub actions: Vec<Action>,
    pub identity: Option<FunctionIdentity>,
}

A per-function finding combining static analysis and runtime coverage.

Marked #[non_exhaustive] in 0.6.0: downstream Rust consumers must stop using struct-literal construction. The wire shape is unchanged.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: String

Deterministic content hash of shape fallow:prod:<hash>. See finding_id for the canonical helper. Continues to ship through 0.6 alongside Finding::identity.

Finding::id vs FunctionIdentity::stable_id. They serve different join axes and must not be conflated:

• Finding::id is the canonical per-finding suppression key. It hashes file + function + line + "prod", so the same function produces a different id when its line changes. Agents writing suppression files / baselines / CI dedup state key on this value to suppress THIS specific finding, not every finding on the function.
• FunctionIdentity::stable_id is the canonical cross-surface join key. The same function gets ONE stable_id across findings, hot paths, blast-radius entries, and importance entries. Cloud aggregation, traffic-weighted ranking, and any “show me this function’s history” join uses it.

New agent suppression formats SHOULD write identity.stable_id when present (stable across line moves) AND retain Finding::id for backwards-compatibility with 0.5-era baselines. Readers MUST accept both forms during the grace window.

file: String

Path to the source file, relative to Request::project_root.

function: String

Function name as reported by the static analyzer. Matches StaticFunction::name and FunctionIdentity::name.

line: u32

1-indexed line number the function starts on. Included in the ID hash so anonymous functions with identical names but different locations get distinct IDs.

verdict: Verdict

Per-finding verdict. Describes what the agent should do with this specific function.

invocations: Option<u64>

Raw invocation count from the V8 dump. None when the function was not tracked (lazy-parsed, worker-thread isolate, etc.).

confidence: Confidence

Confidence the sidecar has in this finding’s Finding::verdict.

evidence: Evidence

Evidence rows the sidecar used to arrive at the finding.

actions: Vec<Action>

Machine-readable next-step hints for AI agents.

identity: Option<FunctionIdentity>

Canonical function identity introduced in 0.6.0. Optional for forward-compat with 0.5-shape sidecars. See FunctionIdentity for the canonical join semantics.

Trait Implementations

impl Clone for Finding

fn clone(&self) -> Finding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Finding

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Finding

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Finding

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

where __S: Serializer,

Serialize this value into the given Serde serializer.