Struct Finding 

pub struct Finding {

    pub id: String,
    pub file: PathBuf,
    pub line: usize,
    pub column: Option<usize>,
    pub title: String,
    pub description: String,
    pub severity: FindingSeverity,
    pub category: DefectCategory,
    pub suspiciousness: f64,
    pub discovered_by: HuntMode,
    pub evidence: Vec<FindingEvidence>,
    pub suggested_fix: Option<String>,
    pub related: Vec<String>,
    pub regression_risk: Option<f64>,
    pub blame_author: Option<String>,
    pub blame_commit: Option<String>,
    pub blame_date: Option<String>,
}

A single bug finding.

Fields

id: String

Unique identifier

file: PathBuf

File path where the finding was located

line: usize

Line number (1-indexed)

column: Option<usize>

Column number (1-indexed, optional)

title: String

Finding title

description: String

Detailed description

severity: FindingSeverity

Severity level

category: DefectCategory

Defect category

suspiciousness: f64

Suspiciousness score (0.0 - 1.0)

discovered_by: HuntMode

Hunt mode that discovered this finding

evidence: Vec<FindingEvidence>

Evidence supporting the finding

suggested_fix: Option<String>

Suggested fix (if available)

related: Vec<String>

Related findings (by ID)

regression_risk: Option<f64>

Regression risk score (0.0 - 1.0) from PMAT quality data (BH-24)

blame_author: Option<String>

Git blame information: author name

blame_commit: Option<String>

Git blame information: commit hash (short)

blame_date: Option<String>

Git blame information: date of last change

Implementations

impl Finding

pub fn new( id: impl Into<String>, file: impl Into<PathBuf>, line: usize, title: impl Into<String>, ) -> Self

Create a new finding.

pub fn with_column(self, column: usize) -> Self

Set column.

pub fn with_description(self, desc: impl Into<String>) -> Self

Set description.

pub fn with_severity(self, severity: FindingSeverity) -> Self

Set severity.

pub fn with_category(self, category: DefectCategory) -> Self

Set category.

pub fn with_suspiciousness(self, score: f64) -> Self

Set suspiciousness score.

pub fn with_discovered_by(self, mode: HuntMode) -> Self

Set discovery mode.

pub fn with_evidence(self, evidence: FindingEvidence) -> Self

Add evidence.

pub fn with_fix(self, fix: impl Into<String>) -> Self

Set suggested fix.

pub fn with_regression_risk(self, risk: f64) -> Self

Set regression risk score (BH-24).

pub fn with_blame( self, author: impl Into<String>, commit: impl Into<String>, date: impl Into<String>, ) -> Self

Set git blame information.

pub fn location(&self) -> String

Get location string.

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.