Module health_types 

Health / complexity analysis report types. Health / complexity analysis report types.

Separated from the health command module so that report formatters (which are compiled as part of both the lib and bin targets) can reference these types without pulling in binary-only dependencies.

Structs

ContributingFactor

A contributing factor that triggered or strengthened a recommendation.

ContributorEntry

Per-author summary emitted in OwnershipMetrics::top_contributor and OwnershipMetrics::recent_contributors.

CoverageGapSummary

Aggregate coverage-gap counters for the current analysis scope.

CoverageGaps

Static test coverage gaps derived from the module graph.

EvidenceFunction

A function referenced in target evidence.

FileHealthScore

Per-file health score combining complexity, coupling, and dead code metrics.

HealthFinding

A single function that exceeds a complexity threshold.

HealthReport

Result of complexity analysis for reporting.

HealthScore

Project-level health score: a single 0–100 number with letter grade.

HealthScorePenalties

Per-component penalty breakdown for the health score.

HealthSummary

Summary statistics for the health report.

HealthTimings

Detailed timing breakdown for the health pipeline.

HealthTrend

Health trend comparison: current run vs. a previous snapshot.

HotspotEntry

A hotspot: a file that is both complex and frequently changing.

HotspotSummary

Summary statistics for hotspot analysis.

LargeFunctionEntry

A function exceeding the very-high-risk size threshold (>60 LOC).

OwnershipMetrics

Per-file ownership signals attached to hotspot entries when the user passes --ownership. All fields are derived from git history and the repository’s CODEOWNERS file (if any).

ProductionCoverageAction

ProductionCoverageEvidence

Supporting evidence for a finding (mirrors fallow_cov_protocol::Evidence).

ProductionCoverageFinding

ProductionCoverageHotPath

ProductionCoverageMessage

ProductionCoverageReport

ProductionCoverageSummary

Summary block mirroring fallow_cov_protocol::Summary (0.2 shape).

RefactoringTarget

RiskProfile

Risk profile: percentage of functions in each risk bin.

TargetEvidence

Evidence linking a target back to specific analysis data.

TargetThresholds

Adaptive thresholds used for refactoring target scoring.

TrendCount

Raw numerator/denominator for a percentage metric.

TrendMetric

A single metric’s trend between two snapshots.

TrendPoint

A reference to a snapshot used in trend comparison.

UntestedExport

Runtime export that no test-reachable module references.

UntestedFile

Runtime code that no test dependency path reaches.

VitalSigns

Project-wide vital signs — a fixed set of metrics for trend tracking.

VitalSignsCounts

Raw counts backing the vital signs percentages.

VitalSignsSnapshot

A point-in-time snapshot of project vital signs, persisted to disk.

Enums

Confidence

Confidence level for a refactoring recommendation.

ContributorIdentifierFormat

Format discriminator for ContributorEntry::identifier.

CoverageModel

Coverage model used for CRAP score computation.

EffortEstimate

A ranked refactoring recommendation for a file.

ExceededThreshold

Which complexity threshold was exceeded.

FindingSeverity

Severity tier indicating how far a function exceeds complexity thresholds.

ProductionCoverageConfidence

ProductionCoverageReportVerdict

Top-level verdict for the whole production-coverage report. Mirrors fallow_cov_protocol::ReportVerdict.

ProductionCoverageVerdict

Per-finding verdict. Replaces the 0.1 state field.

ProductionCoverageWatermark

RecommendationCategory

Category of refactoring recommendation.

TrendDirection

Direction of a metric’s change, semantically (improving/declining/stable).

Constants

COGNITIVE_EXTRACTION_THRESHOLD

Cognitive complexity threshold above which a function is flagged for extraction.

DEFAULT_COGNITIVE_CRITICAL

Default cognitive complexity threshold for “critical” severity.

DEFAULT_COGNITIVE_HIGH

Default cognitive complexity threshold for “high” severity (warning tier).

DEFAULT_CYCLOMATIC_CRITICAL

Default cyclomatic complexity threshold for “critical” severity.

DEFAULT_CYCLOMATIC_HIGH

Default cyclomatic complexity threshold for “high” severity (warning tier).

HOTSPOT_SCORE_THRESHOLD

Hotspot score threshold for counting a file as a hotspot in vital signs.

MI_DENSITY_MIN_LINES

Minimum lines of code for full complexity density weight in the MI formula. Files smaller than this get a proportional dampening factor to prevent density from dominating the score on trivially small files.

SNAPSHOT_SCHEMA_VERSION

Current snapshot schema version. Independent of the report’s SCHEMA_VERSION. v2: Added score and grade fields. v3: Added coverage_model field. v4: Added risk profiles (unit_size_profile, unit_interfacing_profile) and coupling concentration (p95_fan_in, coupling_high_pct). v5: Added duplication penalty to health score formula. v6: Added total_loc to vital signs (always computed from parsed modules). v7: MI formula dampening for small files (values change for files < 50 lines).

Functions

compute_finding_severity

Compute the severity tier for a complexity finding.

letter_grade

Map a numeric score (0–100) to a letter grade.