Struct HealthConfig 

pub struct HealthConfig {
    pub max_cyclomatic: u16,
    pub max_cognitive: u16,
    pub max_crap: f64,
    pub crap_refactor_band: u16,
    pub max_unit_size: u32,
    pub coverage: Option<PathBuf>,
    pub coverage_root: Option<PathBuf>,
    pub ignore: Vec<String>,
    pub threshold_overrides: Vec<HealthThresholdOverride>,
    pub ownership: OwnershipConfig,
    pub suggest_inline_suppression: bool,
}

Configuration for complexity health metrics (fallow health).

Fields

max_cyclomatic: u16

Maximum allowed cyclomatic complexity per function (default: 20). Functions exceeding this threshold are reported. Governs findings only; the health score’s complexity penalties use fixed calibration (use health.ignore to remove a file from the score).

max_cognitive: u16

Maximum allowed cognitive complexity per function (default: 15). Functions exceeding this threshold are reported. Governs findings only, never the health score.

max_crap: f64

Maximum allowed CRAP (Change Risk Anti-Patterns) score per function (default: 30.0). CRAP combines cyclomatic complexity with test coverage: high complexity plus low coverage produces a high CRAP score. Functions meeting or exceeding this threshold are reported. Use --coverage with Istanbul data for accurate per-function CRAP; otherwise fallow estimates coverage from the module graph. Governs findings and the threshold-relative file-score signals (crap_above_threshold, the risk triage tag, and the add_test_coverage refactoring target); measured values such as crap_max and the overall health score never move with it. Set to 0 to disable CRAP enforcement entirely: no findings, nothing counts above threshold, and file-score rows disclose baseline breaches as exempt instead. The complexity-crap rule is different: it decides if a finding fails the run, and off hides the findings but keeps the file-score signals.

crap_refactor_band: u16

Band below maxCyclomatic where CRAP-only findings also receive a secondary refactor-function action (default: 5). Set to 0 to only suggest refactoring when cyclomatic already meets the configured threshold.

max_unit_size: u32

Maximum function length in lines of code before it is reported as an oversized “large function” (default: 60). Raise it globally, or per file via thresholdOverrides[].maxUnitSize, to relax the bar for generated or test files (where a describe() block spans hundreds of lines) without disabling complexity checks on those files. This filters the reported large-functions list only; the descriptive unit-size profile and the health score still reflect raw sizes against fixed calibration (the unit_size penalty keeps its >60 LOC very-high-risk edge so grades stay comparable across projects; use health.ignore to remove a file from the score entirely).

coverage: Option<PathBuf>

Path to Istanbul coverage data (coverage-final.json) or raw V8 coverage (a NODE_V8_COVERAGE directory or one V8 JSON file) for accurate per-function CRAP scores. Relative paths resolve against the project root. The CLI --coverage flag and FALLOW_COVERAGE environment variable override this value. Consulted by fallow health, bare fallow, fallow audit, fallow viz, and the MCP audit / check_health tools.

coverage_root: Option<PathBuf>

Absolute prefix to strip from Istanbul file paths before CRAP matching. Use when coverage was generated under a different checkout root in CI or Docker. The CLI --coverage-root flag and FALLOW_COVERAGE_ROOT environment variable override this value. Consulted by fallow health, bare fallow, fallow audit, fallow viz, and the MCP audit / check_health tools.

ignore: Vec<String>

Glob patterns to exclude from complexity analysis.

threshold_overrides: Vec<HealthThresholdOverride>

Per-file or per-function threshold overrides. These keep exceptional functions visible as configured numeric ceilings instead of hiding them behind binary suppressions.

ownership: OwnershipConfig

Ownership analysis configuration. Controls bot filtering and email privacy mode for --ownership output.

suggest_inline_suppression: bool

Whether health JSON output emits suppress-line action hints alongside complexity findings (default: true). Set to false to opt out across the project: useful for teams that manage suppressions exclusively through // fallow-ignore-* comments authored by hand or through the fallow.suppress LSP code action, but who do not want CI-driven suppress-line action hints in their JSON output. --baseline activates auto-omission regardless of this setting, since baseline files are a separate suppression mechanism.

Implementations

impl HealthConfig

pub fn threshold_override_errors(&self) -> Vec<String>

Validate semantic constraints that serde cannot express.

Trait Implementations

impl Clone for HealthConfig

fn clone(&self) -> HealthConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HealthConfig

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

Formats the value using the given formatter.

impl Default for HealthConfig

fn default() -> HealthConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HealthConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<HealthConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for HealthConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for HealthConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.