Struct ComplexityViolation 

pub struct ComplexityViolation {

    pub path: PathBuf,
    pub name: String,
    pub line: u32,
    pub col: u32,
    pub cyclomatic: u16,
    pub cognitive: u16,
    pub line_count: u32,
    pub param_count: u8,
    pub react_hook_count: u16,
    pub react_jsx_max_depth: u16,
    pub react_prop_count: u16,
    pub react_hook_profile: Option<ReactHookProfile>,
    pub exceeded: ExceededThreshold,
    pub severity: FindingSeverity,
    pub effective_severity: Option<EffectiveSeverity>,
    pub crap: Option<f64>,
    pub coverage_pct: Option<f64>,
    pub coverage_tier: Option<CoverageTier>,
    pub coverage_source: Option<CoverageSource>,
    pub inherited_from: Option<PathBuf>,
    pub component_rollup: Option<ComponentRollup>,
    pub contributions: Vec<ComplexityContribution>,
    pub effective_thresholds: Option<HealthEffectiveThresholds>,
    pub threshold_source: Option<ThresholdSource>,
}

Inner complexity-violation payload.

Fields

path: PathBuf

File path relative to the project root.

name: String

Function name, or a synthesized name for anonymous functions.

line: u32

1-based line the function starts on.

col: u32

1-based column the function starts on.

cyclomatic: u16

Cyclomatic complexity of the function.

cognitive: u16

Cognitive complexity of the function.

line_count: u32

Lines of code in the function body.

param_count: u8

Number of declared parameters.

react_hook_count: u16

Number of React hook calls in this function’s body (useState / useEffect / useMemo / useCallback / custom use*). Descriptive hotspot context for React components; omitted when zero (non-React).

react_jsx_max_depth: u16

Deepest JSX element nesting reached in this function’s body. Descriptive hotspot context; omitted when zero (renders no JSX).

react_prop_count: u16

Number of props destructured from this component’s first parameter. Descriptive hotspot context; omitted when zero.

react_hook_profile: Option<ReactHookProfile>

Per-kind React hook breakdown (state/effect/memo/callback/custom) plus the max useEffect dependency-array arity, derived from the cached hook_uses IR at the health layer. Descriptive refinement of react_hook_count; present only when at least one component-scope hook was attributed, so non-React findings stay byte-identical.

exceeded: ExceededThreshold

Which metric crossed its threshold.

severity: FindingSeverity

Finding severity derived from how far thresholds were crossed.

effective_severity: Option<EffectiveSeverity>

Gate severity after the complexity-* rules and their overrides[].rules entries: error fails the run, warn does not. The most severe rule of the kinds in exceeded wins. It is separate from the band in severity, which ranks the finding and does not gate it. Absent in reports from older versions.

crap: Option<f64>

CRAP score (change risk anti-pattern), when coverage data exists.

coverage_pct: Option<f64>

Test coverage percentage (0-100) backing the CRAP score.

coverage_tier: Option<CoverageTier>

Coverage tier bucket.

Derived from coverage_pct when coverage was measured. When coverage_source is estimated, coverage_pct is absent and the tier describes the static estimate behind the CRAP score rather than an observation, so read the two fields together.

coverage_source: Option<CoverageSource>

Provenance of the coverage signal.

inherited_from: Option<PathBuf>

Component file the inherited coverage estimate came from, for component-inherited coverage.

component_rollup: Option<ComponentRollup>

Aggregate of the enclosing component’s findings, when rolled up.

contributions: Vec<ComplexityContribution>

Per-decision-point complexity breakdown explaining WHICH constructs drove the cyclomatic and cognitive scores. Populated only when the caller opts in via health --complexity-breakdown; empty (and omitted from JSON) otherwise so default and CI output stay lean.

effective_thresholds: Option<HealthEffectiveThresholds>

Resolved thresholds used for this finding when a config override changed at least one ceiling. Omitted for findings using global thresholds.

threshold_source: Option<ThresholdSource>

Source of the effective thresholds. Omitted when thresholds are global.

Implementations

impl ComplexityViolation

pub fn blocks(&self) -> bool

Whether the finding fails the run.

A warn gate severity does not block. A finding without the field, for example from an older saved report, blocks as before.

pub fn resolved_thresholds( &self, summary: &HealthSummary, ) -> HealthEffectiveThresholds

Ceilings this finding was actually evaluated against: the per-file thresholdOverrides result when an override matched, otherwise the run’s global summary ceilings.

Every renderer that prints or compares a threshold must go through this so a finding is never described against a ceiling it was not measured with.

Trait Implementations

impl Clone for ComplexityViolation

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 ComplexityViolation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ComplexityViolation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ComplexityViolation> for HealthFinding

fn from(violation: ComplexityViolation) -> Self

Wrap a violation with empty actions and no introduced flag.

impl Serialize for ComplexityViolation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.