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 exceeded: ExceededThreshold,
    pub severity: FindingSeverity,
    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>,
}

Inner complexity-violation payload, wrapped by HealthFinding.

Carries the raw measured signals for a single function or synthetic template entry that crossed a complexity threshold. The wrapper adds the typed actions list and the audit-mode introduced flag using #[serde(flatten)] so findings[] items expose these fields at the top level for wire continuity with the pre-wrapper shape.

Fields

path: PathBuf

Absolute file path.

name: String

Function name, "<anonymous>" for unnamed functions/arrows, or "<template>" for synthetic Angular template findings.

line: u32

1-based line number.

col: u32

0-based column.

cyclomatic: u16

Cyclomatic complexity.

cognitive: u16

SonarSource cognitive complexity (structural + nesting penalty).

line_count: u32

Number of lines in the function.

param_count: u8

Number of parameters (excluding TypeScript’s this parameter).

exceeded: ExceededThreshold

Which threshold(s) this finding exceeds. crap and its combinations are emitted when max_crap_threshold is crossed.

severity: FindingSeverity

How far above the threshold: moderate (just above), high (recommended for extraction), or critical (immediate extraction candidate). Defaults: cognitive 25/40, cyclomatic 30/50.

crap: Option<f64>

CRAP score (CC^2 * (1 - cov/100)^3 + CC), rounded to one decimal. Present when the function also exceeded --max-crap, otherwise absent.

coverage_pct: Option<f64>

Per-function statement coverage percentage (0.0 to 100.0) used to derive crap. Present when Istanbul data matched the function, otherwise absent (estimated model or unmatched functions).

coverage_tier: Option<CoverageTier>

Bucketed coverage tier used to drive action selection. Present whenever CRAP triggered the finding (Istanbul or estimated), absent otherwise. none = coverage is at most 0% (file not test-reachable, or Istanbul reports 0); partial = coverage is in (0, 70); high = coverage is at or above the high watermark (default >= 70, or the estimated 85% band).

coverage_source: Option<CoverageSource>

Provenance of the coverage signal. Present whenever CRAP triggered the finding. istanbul = direct fnMap match; estimated = graph-based estimate against the finding’s own file; estimated_component_inherited = graph-based estimate inherited from an Angular component .ts reached via the inverse templateUrl edge (synthetic <template> findings on .html files only).

inherited_from: Option<PathBuf>

Owning component file that contributed reachability when coverage_source == "estimated_component_inherited". Always paired with that variant of coverage_source and absent otherwise. The value is the .ts file fallow walked to via the inverse templateUrl edge (e.g. permissions.component.ts); the JSON serializer strips it to project-relative form just like other path fields. Lets human and AI consumers explain “the template scored partial because the component it belongs to is tested” without re-deriving the link.

component_rollup: Option<ComponentRollup>

Breakdown of a synthetic <component> rollup finding into its worst-class-function and template contributions. Present only on findings whose name is the literal string "<component>" (Angular components whose class AND template both contributed to a per-component complexity rollup); absent on every other finding kind.

The owning HealthFinding’s cyclomatic / cognitive totals are class_worst_function + template, so consumers ranking by complexity see the component as one unit. The breakdown carries the pre-summation numbers plus the worst class function’s name so consumers can explain “this component ranked high because the template added 6 cyclomatic on top of the worst class function’s 3”.

Trait Implementations

impl Clone for ComplexityViolation

fn clone(&self) -> ComplexityViolation

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 From<ComplexityViolation> for HealthFinding

fn from(violation: ComplexityViolation) -> Self

Convenience conversion: wrap a violation with an empty actions list and no introduced flag. Used by tests and fixture builders that don’t exercise the action-selection path. Production code should call HealthFinding::with_actions (or HealthFinding::new when the action list is already computed) so the wire shape carries the typed actions.

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.