Struct Finding 

pub struct Finding {
    pub severity: Severity,
    pub category: FindingCategory,
    pub path: Option<PropagationPath>,
    pub nodes_involved: Vec<NodeId>,
    pub message: String,
    pub recommendation: Recommendation,
    pub source: FindingSource,
    pub extras: FindingExtras,
}

A finding is a concrete, actionable authority issue.

Fields

severity: Severity

category: FindingCategory

path: Option<PropagationPath>

nodes_involved: Vec<NodeId>

message: String

recommendation: Recommendation

source: FindingSource

Provenance of this finding. Defaults to BuiltIn for backward compatibility with code/JSON that predates the field — every in-tree built-in rule sets this explicitly. Deserialization of older JSON without the field treats the finding as built-in.

extras: FindingExtras

Optional metadata (group id, time-to-fix, compensating controls, suppression markers). Flattens into the JSON object so consumers see top-level fields — see FindingExtras for individual semantics.

Implementations

impl Finding

pub fn with_time_to_fix(self, effort: FixEffort) -> Self

Builder helper: attach a time_to_fix annotation to this finding. Call sites: let f = Finding { ... }.with_time_to_fix(FixEffort::Trivial);

pub fn with_compensating_control(self, control: impl Into<String>) -> Self

Builder helper: append a compensating control description and downgrade severity by one tier (Critical -> High -> Medium -> Low -> Info). Records the original severity so the audit trail survives.

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.