Struct UnusedFileFinding 

pub struct UnusedFileFinding {
    pub file: UnusedFile,
    pub finding_id: Option<String>,
    pub actions: Vec<IssueAction>,
    pub introduced: Option<AuditIntroduced>,
    pub effective_severity: Option<EffectiveSeverity>,
    pub reachability_caveats: Vec<ReachabilityCaveat>,
}

Wire-shape envelope for an UnusedFile finding. The bare finding flattens in via #[serde(flatten)], with a typed actions array populated at construction time and the audit-pass introduced flag attached as an optional sibling.

Fields

file: UnusedFile

The underlying dead-code entry.

finding_id: Option<String>

Stable id of this finding: dc1:<rule>:<16 hex digits>, with a ~<k> suffix when several findings of one type share an identity. Line and column are not inputs, so the id survives line shifts, reformats and reorders. A rename of the file or the symbol gives a new id. Absent in output from older versions.

actions: Vec<IssueAction>

Suggested next steps: a delete-file primary and a suppress-file secondary. Always emitted (possibly empty for forward-compat).

introduced: Option<AuditIntroduced>

Set by the audit pass when this finding is introduced relative to the merge-base. None when serialized directly from Rust.

effective_severity: Option<EffectiveSeverity>

Gate severity of this finding after rules and overrides[].rules resolve for its path. CI formats read it for the annotation, SARIF and CodeClimate level. Absent in output from older versions. Not part of the finding identity, baseline keys or fingerprints.

reachability_caveats: Vec<ReachabilityCaveat>

Advisory caveats on the reachability verdict behind this finding. Sorted, deduplicated, and omitted from the wire when empty, so a run that analyzed every discovered file is byte-identical. Never gates the finding or the delete-file action, though fallow fix does withhold the removal of a caveated finding as low confidence.

Implementations

impl UnusedFileFinding

pub fn with_actions(file: UnusedFile) -> Self

Build the wrapper from a raw UnusedFile, computing the typed actions array inline. introduced stays None and is set later by annotate_dead_code_json if the audit pass runs.

Trait Implementations

impl CaveatedFinding for UnusedFileFinding

fn set_reachability_caveats(&mut self, caveats: Vec<ReachabilityCaveat>)

Store caveats and downgrade every mutating action the gate now withholds. The field itself stays pub (a renderer test builds an already-caveated fixture directly, without running the annotation pass); every non-test writer goes through this setter instead of the field so the downgrade travels with the write.

impl Clone for UnusedFileFinding

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnusedFileFinding

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UnusedFileFinding

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl GatedFinding for UnusedFileFinding

fn effective_severity(&self) -> Option<EffectiveSeverity>

The gate severity, or None when no value was written.

fn set_effective_severity(&mut self, severity: Option<EffectiveSeverity>)

Write the gate severity.

impl IdentifiedFinding for UnusedFileFinding

fn rule_token(&self) -> &'static str

The canonical issue code of this finding.

fn identity_parts(&self, p: &IdentityPaths<'_>) -> Vec<String>

The parts that name the subject of this finding. Never a line or a column.

fn tiebreak_position(&self) -> (u32, u32, u32)

Line, column and span start. Used only to order findings that share a base id.

fn finding_id(&self) -> Option<&str>

The stamped id, or None before the stamping pass.

fn set_finding_id(&mut self, id: Option<String>)

Write the id.

fn canonical_key(&self, paths: &IdentityPaths<'_>) -> String

The canonical key of this finding: the readable form of the id input. See dead_code_canonical_key.

impl MutationEvidence for UnusedFileFinding

fn reachability_caveats(&self) -> &[ReachabilityCaveat]

The advisory caveats recorded on the reachability verdict behind this finding. Empty when the run analyzed every file it discovered.

fn may_auto_apply_mutation(&self) -> bool

Whether this finding’s mutation may be applied without a human first being told the evidence is incomplete. THE gate: never re-derive it, never widen it per surface.

impl Serialize for UnusedFileFinding

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

where __S: Serializer,

Serialize this value into the given Serde serializer.