Struct HealthExecutionOptions 

pub struct HealthExecutionOptions<'a> {

    pub root: &'a Path,
    pub config_path: &'a Option<PathBuf>,
    pub output: OutputFormat,
    pub no_cache: bool,
    pub threads: usize,
    pub quiet: bool,
    pub complexity_breakdown: bool,
    pub thresholds: HealthThresholdOverrides,
    pub top: Option<usize>,
    pub sort: HealthSort,
    pub production: bool,
    pub production_override: Option<bool>,
    pub allow_remote_extends: bool,
    pub changed_since: Option<&'a str>,
    pub diff_index: Option<&'a DiffIndex>,
    pub use_shared_diff_index: bool,
    pub workspace: Option<&'a [String]>,
    pub changed_workspaces: Option<&'a str>,
    pub scope: Option<PathBuf>,
    pub baseline: Option<&'a Path>,
    pub save_baseline: Option<&'a Path>,
    pub baseline_mode: HealthBaselineMode,
    pub baseline_mode_explicit: bool,
    pub complexity: bool,
    pub file_scores: bool,
    pub coverage_gaps: bool,
    pub config_activates_coverage_gaps: bool,
    pub hotspots: bool,
    pub ownership: bool,
    pub ownership_emails: Option<EmailMode>,
    pub targets: bool,
    pub css: bool,
    pub css_deep: bool,
    pub force_full: bool,
    pub score_only_output: bool,
    pub enforce_coverage_gap_gate: bool,
    pub effort: Option<EffortEstimate>,
    pub score: bool,
    pub gates: HealthGateOptions,
    pub since: Option<&'a str>,
    pub min_commits: Option<u32>,
    pub explain: bool,
    pub summary: bool,
    pub save_snapshot: Option<PathBuf>,
    pub trend: bool,
    pub coverage_inputs: HealthCoverageInputs<'a>,
    pub performance: bool,
    pub runtime_coverage: Option<RuntimeCoverageOptions>,
    pub churn_file: Option<&'a Path>,
    pub analysis_identity: SemanticAnalysisIdentity,
    pub group_by: Option<GroupByMode>,
}

Command-neutral inputs needed to execute a health analysis.

These fields are shared runner inputs rather than rendering concerns.

Fields

root: &'a Path

Project root to analyze.

config_path: &'a Option<PathBuf>

Explicit config file path; None triggers automatic discovery.

output: OutputFormat

Output format of the run; badge output implies the score section.

no_cache: bool

Bypass the parse cache for this run.

threads: usize

Worker thread count for parsing and analysis.

quiet: bool

Suppress progress notes on stderr.

complexity_breakdown: bool

Include per-decision-point complexity contributions in typed findings.

This changes the produced health result shape, so it belongs to the runner input contract rather than CLI rendering options.

thresholds: HealthThresholdOverrides

Complexity threshold overrides on top of the resolved config.

top: Option<usize>

Cap on rendered findings per section.

sort: HealthSort

Sort criteria for complexity findings.

production: bool

Raw production-only request flag; folded into production_override when the tri-state override is unset.

production_override: Option<bool>

Tri-state production override: Some forces production-only analysis on or off regardless of config, None defers to the config value.

allow_remote_extends: bool

Permit extends config inheritance from remote URLs.

changed_since: Option<&'a str>

Git ref limiting findings to files changed since it.

diff_index: Option<&'a DiffIndex>

Pre-built diff index scoping findings to changed lines.

use_shared_diff_index: bool

True when diff_index came from the process-shared diff source rather than a health-specific one.

workspace: Option<&'a [String]>

Workspace member paths limiting the analysis scope.

changed_workspaces: Option<&'a str>

Git ref selecting only workspaces with changes since it.

scope: Option<PathBuf>

Positional [PATH] scope: root-joined absolute file or directory inside the root. Consumed CLI-side as one more workspace root (prefix scope), so it composes with workspace the way multiple workspace roots compose. None means whole-project scope.

baseline: Option<&'a Path>

Baseline file to compare finding counts against.

save_baseline: Option<&'a Path>

Path to write the run’s finding counts as a new baseline.

baseline_mode: HealthBaselineMode

Controls both halves of the baseline lifecycle: which buckets save_baseline writes and how a loaded baseline is matched. An identity save writes count and identity buckets, a count save writes count buckets only.

baseline_mode_explicit: bool

Whether baseline_mode was requested explicitly rather than defaulted. A defaulted count save refuses to overwrite a baseline that carries identity buckets, because dropping them breaks later identity-mode comparisons; an explicit count request is treated as intent to downgrade.

complexity: bool

Render the complexity findings section.

file_scores: bool

Render the per-file health scores section.

coverage_gaps: bool

Render the static coverage gaps section.

config_activates_coverage_gaps: bool

Let config-enabled coverage settings activate the coverage gaps section even when it was not requested on this run.

hotspots: bool

Render the churn-based hotspots section.

ownership: bool

Attribute hotspots to owners.

ownership_emails: Option<EmailMode>

How owner identities are rendered (names or emails).

targets: bool

Render the refactoring targets section.

css: bool

Render the CSS / styling analytics section.

css_deep: bool

Scan all stylesheets for the CSS section instead of only changed files.

force_full: bool

Analyze the full project even when only a subset of sections was requested, because scores and snapshots need complete data.

score_only_output: bool

True when the score is the only requested surface, so output can skip section rendering entirely.

enforce_coverage_gap_gate: bool

Fail the run on coverage gaps instead of reporting them advisorily.

effort: Option<EffortEstimate>

Effort estimation mode for refactoring targets.

score: bool

Compute and render the overall health score.

gates: HealthGateOptions

Exit gate thresholds.

since: Option<&'a str>

Churn lookback window for hotspots (90d, 6m, 1y, or an ISO date).

min_commits: Option<u32>

Minimum commit count for a file to qualify as churn evidence.

explain: bool

Include score-derivation explanations in the rendered output.

summary: bool

Render the condensed summary view instead of full sections.

save_snapshot: Option<PathBuf>

Path to persist a health snapshot for later trend comparison.

trend: bool

Render the score trend against previously saved snapshots.

coverage_inputs: HealthCoverageInputs<'a>

Istanbul coverage inputs for CRAP scoring.

performance: bool

Print per-phase timing diagnostics.

runtime_coverage: Option<RuntimeCoverageOptions>

Runtime coverage sidecar options, when runtime analysis was requested.

churn_file: Option<&'a Path>

Pre-recorded churn data file replacing live git log analysis.

analysis_identity: SemanticAnalysisIdentity

Compatibility identity persisted with snapshots and checked by trends.

group_by: Option<GroupByMode>

Optional grouping mode for typed health output.

Trait Implementations

impl<'a> Clone for HealthExecutionOptions<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for HealthExecutionOptions<'a>

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

Formats the value using the given formatter.