Struct Finding 

#[non_exhaustive]
pub struct Finding {
    pub severity: Option<Severity>,
    pub category: Category,
    pub code: Cow<'static, str>,
    pub note: String,
    pub source: Source,
    pub subjects: Vec<SubjectRef>,
    pub evidence: Vec<Evidence>,
    pub context: FindingContext,
}

A normalized forensic finding — an observation, never an assertion of intent.

Construct via Finding::observation / Finding::unrated; the type is #[non_exhaustive] so adding fields later does not break consumers.

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.

severity: Option<Severity>

Severity, or None when the analyzer deliberately did not score it.

category: Category

Analytical lens.

code: Cow<'static, str>

Stable machine-readable, scheme-prefixed code, e.g. GPT-PARTITION-OVERLAP.

note: String

Human-readable observation (consistent-with language, never “proves”).

source: Source

Producing analyzer + scope.

subjects: Vec<SubjectRef>

Non-disk subjects the finding is about (empty for disk findings).

evidence: Vec<Evidence>

Backing evidence (lossless per-analyzer detail).

context: FindingContext

Behavioral / aggregation context (default-empty for disk findings).

Implementations

impl Finding

pub fn observation( severity: Severity, category: Category, code: impl Into<Cow<'static, str>>, ) -> FindingBuilder

Begin a rated finding.

pub fn unrated( category: Category, code: impl Into<Cow<'static, str>>, ) -> FindingBuilder

Begin a finding the analyzer deliberately leaves unrated (severity: None).

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 PartialEq for Finding

fn eq(&self, other: &Finding) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Finding