Struct Finding 

pub struct Finding {
    pub id: Option<String>,
    pub primary_path: PathBuf,
    pub kind: Option<String>,
    pub confidence: Option<f64>,
    pub severity: Option<String>,
    pub tier: Option<String>,
    pub evidence: Option<String>,
    pub suggested_action: Option<String>,
}

One finding in a cargo-impact envelope.

Every field except primary_path is optional. Upstream schema additions are ignored; removed fields decay to None without breaking the parse.

Fields

id: Option<String>

Content-hashed id (e.g. f-abcd1234...). Stable across runs for the same finding — consumers can use it to dedupe or exclude.

primary_path: PathBuf

Repo-relative path to the primary source file for this finding.

kind: Option<String>

Discriminant name (e.g. trait_impl, doc_drift_link). When upstream serializes kind as an internally-tagged object, we keep the tag name; when it’s a bare string, we keep the string.

confidence: Option<f64>

Confidence in [0.0, 1.0]. None when upstream omits it — treat that as “unknown”, not as zero.

severity: Option<String>

"high" / "medium" / "low" / "unknown".

tier: Option<String>

"proven" / "likely" / "possible" / "unknown".

evidence: Option<String>

Human-readable justification. Free-form UTF-8.

suggested_action: Option<String>

Optional shell command hint (e.g. cargo nextest run -E ...).

Implementations

impl Finding

pub fn language_hint(&self) -> &'static str

Language hint for the fenced block that renders this finding’s primary file.

Kind-aware overrides win over extension-based detection — a doc_drift_link finding always renders as markdown even when the file has no extension. For every other kind we fall back to the shared extension map so .rs → rust, .toml → toml, etc.

pub fn descriptor(&self) -> String

Short descriptor for section headers: kind + severity/tier + confidence, whichever pieces are present.

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.