Struct DiffResult 

pub struct DiffResult {

    pub summary: DiffSummary,
    pub components: ChangeSet<ComponentChange>,
    pub dependencies: ChangeSet<DependencyChange>,
    pub licenses: LicenseChanges,
    pub vulnerabilities: VulnerabilityChanges,
    pub semantic_score: f64,
    pub metadata_changes: Vec<MetadataChange>,
    pub graph_changes: Vec<DependencyGraphChange>,
    pub graph_summary: Option<GraphChangeSummary>,
    pub rules_applied: usize,
    pub quality_delta: Option<QualityDelta>,
    pub match_metrics: Option<MatchMetrics>,
    pub ml_regressions: Vec<MlRegression>,
}

Complete result of an SBOM diff operation.

Fields

summary: DiffSummary

Summary statistics

components: ChangeSet<ComponentChange>

Component changes

dependencies: ChangeSet<DependencyChange>

Dependency changes

licenses: LicenseChanges

License changes

vulnerabilities: VulnerabilityChanges

Vulnerability changes

semantic_score: f64

Overall semantic similarity of the two documents, 0.0-100.0 (100 = identical). This is the single-diff scale used by every diff output; the multi-SBOM commands rescale it to a 0.0-1.0 fraction (MatrixResult::similarity_scores, and 1 - similarity for MultiDiffSummary::deviation_scores).

metadata_changes: Vec<MetadataChange>

Document-level metadata changes (author, tool, timestamp, spec version, lifecycle phase, signature, document/primary-component version)

graph_changes: Vec<DependencyGraphChange>

Graph structural changes (only populated if graph diffing is enabled)

graph_summary: Option<GraphChangeSummary>

Summary of graph changes

rules_applied: usize

Number of custom matching rules applied

quality_delta: Option<QualityDelta>

Quality impact of this diff (computed post-diff)

match_metrics: Option<MatchMetrics>

Matching quality metrics (populated during diff)

ml_regressions: Vec<MlRegression>

Supported numeric ML performance metrics that moved in the adverse direction.

Implementations

impl DiffResult

pub fn new() -> Self

Create a new empty diff result

pub fn calculate_summary(&mut self)

Calculate and update summary statistics

pub fn has_changes(&self) -> bool

Check if there are any changes.

Checks both the pre-computed summary and the source-of-truth fields to be safe regardless of whether calculate_summary() was called.

Unchanged inventory entries (produced under --include-unchanged) are not changes: a zero-change diff reports false regardless of the flag.

pub fn refresh_derived_day_counts(&mut self) -> bool

Recompute date-derived vulnerability day counts for today.

Cached results embed the day they were computed; the incremental engine calls this on cache hits so counts (and the SLA statuses derived from them) do not go stale across midnight. Returns true if anything changed.

pub fn day_counts_stale(&self) -> bool

Whether any vulnerability day-count field is stale for today.

pub fn find_component_by_id(&self, id: &CanonicalId) -> Option<&ComponentChange>

Find a component change by canonical ID

pub fn find_component_by_id_str(&self, id_str: &str) -> Option<&ComponentChange>

Find a component change by ID string

pub fn all_component_changes(&self) -> Vec<&ComponentChange>

Get all component changes as a flat list with their indices for navigation

pub fn find_vulns_for_component( &self, component_id: &CanonicalId, ) -> Vec<&VulnerabilityDetail>

Find vulnerabilities affecting a specific component by ID

pub fn build_component_id_index(&self) -> HashMap<String, &ComponentChange>

Build an index of component IDs to their changes for fast lookup

pub fn filter_by_severity(&mut self, min_severity: &str)

Filter vulnerabilities by minimum severity level

pub fn filter_by_vex(&mut self)

Filter out vulnerabilities where VEX status is NotAffected or Fixed.

Keeps vulnerabilities that are Affected, UnderInvestigation, or have no VEX status.

Trait Implementations

impl Clone for DiffResult

fn clone(&self) -> DiffResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiffResult

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

Formats the value using the given formatter.

impl Default for DiffResult

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DiffResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DiffResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.