fallow 2.102.0 → 2.104.0

package/types/output-contract.d.ts

@@ -25,7 +25,7 @@
 
 
 /**
- * Schemas for the JSON output of fallow commands. Object-shaped envelopes covered by the `FallowOutput` contract carry a top-level `kind` discriminator (for example `dead-code`, `dead-code-grouped`, `health`, `dupes`, `combined`, `audit`, `explain`, `inspect_target`, `impact`, `security`, `coverage-setup`, `coverage-analyze`, `list-boundaries`, `review-envelope`, and `review-reconcile`). Consumers should branch on `kind` instead of probing for unique field presence. `--legacy-envelope` removes only the document-root `kind` for one compatibility cycle. `CodeClimateOutput` is a bare JSON array (per the Code Climate / GitLab Code Quality spec) and stays a sibling root branch discriminated by checking whether the document root is an array.
+ * Schemas for the JSON output of fallow commands. Object-shaped envelopes covered by the `FallowOutput` contract carry a top-level `kind` discriminator (for example `dead-code`, `dead-code-grouped`, `health`, `dupes`, `combined`, `audit`, `explain`, `inspect_target`, `impact`, `security`, `coverage-setup`, `coverage-analyze`, `list-boundaries`, `review-envelope`, and `review-reconcile`). Consumers should branch on `kind` instead of probing for unique field presence. `CodeClimateOutput` is a bare JSON array (per the Code Climate / GitLab Code Quality spec) and stays a sibling root branch discriminated by checking whether the document root is an array.
  */
 export type FallowJsonOutput = (FallowOutput | CodeClimateOutput)
 /**
@@ -34,11 +34,9 @@ export type FallowJsonOutput = (FallowOutput | CodeClimateOutput)
  * schema derived from this enum drives the document-root `oneOf` in
  * `docs/output-schema.json`.
  *
- * The default wire shape now carries a top-level `kind` discriminator so
- * agents and schema-validating clients can select the variant in O(1) instead
- * of probing for unique field presence. `--legacy-envelope` is a one-cycle
- * compatibility flag that removes only this document-root `kind` field from
- * CLI JSON output; nested report objects are not rewritten.
+ * The wire shape carries a top-level `kind` discriminator so agents and
+ * schema-validating clients can select the variant in O(1) instead of probing
+ * for unique field presence.
  *
  * One envelope is intentionally NOT in this enum:
  * - `CodeClimateOutput` serializes as a bare JSON array
@@ -119,6 +117,9 @@ export type SchemaVersion = 7
  * a bare string (e.g. `"2.74.0"`).
  */
 export type ToolVersion = string
+/**
+ * Audit command singleton carried by [`AuditOutput`].
+ */
 export type AuditCommand = "audit"
 /**
  * Verdict for the audit command.
@@ -450,7 +451,8 @@ export type UntestedFileActionType = ("add-tests" | "suppress-file")
  */
 export type UntestedExportActionType = ("add-test-import" | "suppress-file")
 /**
- * Churn trend indicator based on comparing recent vs older halves of the analysis period.
+ * Churn trend indicator based on comparing recent vs older halves of the
+ * analysis period.
  */
 export type ChurnTrend = ("accelerating" | "stable" | "cooling")
 export type ContributorIdentifierFormat = ("raw" | "handle" | "anonymized" | "hash")
@@ -597,6 +599,24 @@ export type CssCandidateActionType = ("verify-unused" | "verify-undefined" | "co
  * Discriminant for [`UnusedAtRule::kind`].
  */
 export type UnusedAtRuleKind = ("property-registration" | "layer")
+/**
+ * The surface through which a design token is consumed. The `theme-var` /
+ * `css-var` / `utility` / `apply` kinds are Tailwind v4 `@theme` consumption; the
+ * `js-member` kind is CSS-in-JS consumption (a cross-module member access on an
+ * imported StyleX/vanilla-extract token binding). The kind is the disjoint origin
+ * signal that distinguishes a Tailwind token entry from a CSS-in-JS token entry in
+ * the shared `token_consumers` list.
+ */
+export type ConsumerKind = ("theme-var" | "css-var" | "utility" | "apply" | "js-member")
+/**
+ * Trust level for a [`StylingHealth`] grade. TWO variants (not the three-tier
+ * `high`/`medium`/`low` of [`crate::Confidence`] / `FeatureFlagConfidence`) ON
+ * PURPOSE: styling confidence is binary (the grade is either reliable for the
+ * analyzed surface or it is not), not three distinct evidence tiers, so a
+ * never-emitted `Medium` would be dead surface. Serializes lowercase (`"high"` /
+ * `"low"`), matching the sibling confidence enums' vocabulary.
+ */
+export type StylingHealthConfidence = ("high" | "low")
 export type InspectTargetDescriptor = ({
 file: string
 type: "file"
@@ -784,12 +804,14 @@ export type RiskClass = ("low" | "medium" | "high")
  */
 export type ReviewEffort = ("glance" | "review" | "deep_dive")
 /**
- * The focus label for a review unit. EXACTLY two variants: `Skip` is NOT
- * representable, so the type system is the guarantee that free mode never emits
- * a `skip` label (safe explicit-skip is paid, runtime-backed only). Mirrors
- * the decision surface's "cut category not representable" structural posture.
+ * The focus label for a review unit. `Skip` is the SAFE explicit-skip label and
+ * is runtime-backed ONLY: it is producible solely on the paid runtime path
+ * and solely for a unit runtime-proves cold with zero risk signals. Free mode
+ * (no runtime evidence) emits only `ReviewHere` / `NotPrioritized`, never `Skip`
+ * (the build-focus-map labeller cannot reach the `Skip` arm without runtime
+ * input), so the free-tier "rank but never skip" stance holds by construction.
  */
-export type FocusLabel = ("review-here" | "not-prioritized")
+export type FocusLabel = ("review-here" | "not-prioritized" | "skip")
 /**
  * A per-unit confidence flag. The EXACT panel-decided strings: a dynamically-
  * wired or re-export-heavy unit carries one so its static-reachability signal is
@@ -851,7 +873,7 @@ duplication?: (DupesReportPayload | null)
 complexity?: (HealthReport | null)
 /**
  * Read-only follow-up commands computed from this run's findings. See
- * [`CheckOutput::next_steps`] for the contract.
+ * `CheckOutput::next_steps` for the contract.
  */
 next_steps?: NextStep[]
 }
@@ -3611,7 +3633,7 @@ reason: string
 }
 /**
  * Wire-shape payload for `fallow dupes --format json` (the body that
- * flattens into [`crate::output_envelope::DupesOutput`] and is also
+ * flattens into the `DupesOutput` envelope and is also
  * emitted under the `dupes` / `duplication` key inside the combined and
  * audit envelopes).
  *
@@ -3627,8 +3649,8 @@ export interface DupesReportPayload {
 clone_groups: CloneGroupFinding[]
 /**
  * Clone families, each wrapped with typed actions. Inner `groups`
- * inside each [`CloneFamilyFinding`] are themselves wrapped as
- * [`CloneGroupFinding`] entries carrying their own `actions[]` (and
+ * inside each `CloneFamilyFinding` are themselves wrapped as
+ * `CloneGroupFinding` entries carrying their own `actions[]` (and
  * optional audit-mode `introduced` flag), so JSON-Schema strict
  * consumers and TS consumers reading `clone_families[].groups[]` see
  * the same shape as the top-level `clone_groups[]` array (preserves
@@ -3718,8 +3740,8 @@ end_col: number
 fragment: string
 }
 /**
- * Per-action wire shape attached to each [`CloneGroupFinding`] and
- * [`AttributedCloneGroupFinding`]. Mirrors the action types previously
+ * Per-action wire shape attached to each `CloneGroupFinding` and
+ * `AttributedCloneGroupFinding`. Mirrors the action types previously
  * emitted by `inject_dupes_actions::build_clone_group_actions` in
  * `crates/cli/src/report/json.rs`: `extract-shared` plus `suppress-line`.
  */
@@ -3748,7 +3770,7 @@ comment?: (string | null)
  * Unlike most `*Finding` wrappers this one is NOT `#[serde(flatten)]` over
  * the bare [`CloneFamily`], because the family's nested
  * `groups: Vec<CloneGroup>` field needs to carry the typed
- * [`CloneGroupFinding`] wrapper too (so every nested clone group gets its
+ * `CloneGroupFinding` wrapper too (so every nested clone group gets its
  * own `actions[]` array, matching the legacy post-pass behavior; see issue
  * #393 regression test). The wire shape stays byte-identical to the
  * previous post-pass output. No `introduced` field because `fallow audit`
@@ -3756,7 +3778,7 @@ comment?: (string | null)
  */
 export interface CloneFamilyFinding {
 /**
- * The files involved in this family (sorted for stable output).
+ * The files involved in this family.
  */
 files: string[]
 /**
@@ -3779,7 +3801,7 @@ total_duplicated_tokens: number
 suggestions: RefactoringSuggestion[]
 /**
  * Suggested next steps: an `extract-shared` primary, one
- * `apply-suggestion` per [`RefactoringSuggestion`] on the family, and
+ * `apply-suggestion` per `RefactoringSuggestion` on the family, and
  * a trailing `suppress-line`. Always emitted (possibly empty for
  * forward-compat).
  */
@@ -3800,10 +3822,10 @@ description: string
 estimated_savings: number
 }
 /**
- * Per-action wire shape attached to each [`CloneFamilyFinding`]. Mirrors
+ * Per-action wire shape attached to each `CloneFamilyFinding`. Mirrors
  * the action types previously emitted by
  * `build_clone_family_actions`: `extract-shared`, one `apply-suggestion`
- * per [`RefactoringSuggestion`] on the family, and a trailing
+ * per `RefactoringSuggestion` on the family, and a trailing
  * `suppress-line`.
  */
 export interface CloneFamilyAction {
@@ -3912,7 +3934,7 @@ export interface HealthReport {
 /**
  * Functions and synthetic template entries exceeding complexity
  * thresholds, sorted by the --sort criteria. Each entry wraps its
- * inner [`ComplexityViolation`] payload (flattened on the wire) with
+ * inner `ComplexityViolation` payload (flattened on the wire) with
  * the typed `actions` list and an optional audit-mode `introduced`
  * flag.
  */
@@ -3957,7 +3979,7 @@ prop_drilling_chains?: PropDrillingChainFinding[]
 /**
  * Hotspot entries combining git churn with complexity. Only present when
  * --hotspots is used. Sorted by score descending (highest risk first).
- * Each entry wraps its inner [`HotspotEntry`] payload (flattened on the
+ * Each entry wraps its inner `HotspotEntry` payload (flattened on the
  * wire) with a typed `actions` list.
  */
 hotspots?: HotspotFinding[]
@@ -3982,7 +4004,7 @@ large_functions?: LargeFunctionEntry[]
 /**
  * Ranked refactoring recommendations. Only present when --targets is used.
  * Sorted by efficiency (priority/effort) descending. Each entry wraps
- * its inner [`RefactoringTarget`] payload (flattened on the wire) with
+ * its inner `RefactoringTarget` payload (flattened on the wire) with
  * a typed `actions` list.
  */
 targets?: RefactoringTargetFinding[]
@@ -4013,6 +4035,14 @@ framework_health?: (FrameworkHealthDiagnostics | null)
  * over-complex selectors, deep nesting). Present only with `--css`.
  */
 css_analytics?: (CssAnalyticsReport | null)
+/**
+ * Styling-health score and letter grade: a SECOND health axis derived from
+ * the CSS analytics (the design-system axis), orthogonal to the JS/TS code
+ * `health_score`. Present only with `--css` (the same condition as
+ * `css_analytics`), so a plain `fallow health` run is byte-unchanged. The
+ * code score is never affected by this field.
+ */
+styling_health?: (StylingHealth | null)
 }
 /**
  * Wire envelope for a single complexity finding.
@@ -4189,7 +4219,7 @@ max_crap: number
  * `comment` plus `placement`, and the coverage-leaning actions
  * (`add-tests`, `increase-coverage`) carry only `note`.
  *
- * [`ComplexityViolation`]: ../../fallow-cli/src/health_types/scores.rs
+ * [`ComplexityViolation`]: ../../fallow-output/src/health_scores.rs
  */
 export interface HealthFindingAction {
 type: HealthFindingActionType
@@ -4287,7 +4317,7 @@ cognitive: number
 crap?: (number | null)
 }
 /**
- * Project-wide vital signs , a fixed set of metrics for trend tracking.
+ * Project-wide vital signs: a fixed set of metrics for trend tracking.
  *
  * Metrics are `Option` when the data source was not available in the current run
  * (e.g., `duplication_pct` is `None` unless the duplication pipeline was run,
@@ -4328,7 +4358,7 @@ hotspot_count?: (number | null)
  */
 hotspot_top_pct_count?: (number | null)
 /**
- * Average maintainability index across all scored files (0–100).
+ * Average maintainability index across all scored files (0-100).
  */
 maintainability_avg?: (number | null)
 /**
@@ -4616,7 +4646,7 @@ path: string
 value_export_count: number
 /**
  * Suggested next steps: an `add-tests` primary and a `suppress-file`
- * secondary. Always emitted (possibly empty for forward-compat).
+ * secondary. Always emitted for the current wire contract.
  */
 actions: UntestedFileAction[]
 }
@@ -4630,7 +4660,7 @@ actions: UntestedFileAction[]
  * struct shape; the field that is populated (`note` for `add-tests`,
  * `comment` for `suppress-file`) depends on the `kind`.
  *
- * [`UntestedFile`]: ../../fallow-cli/src/health_types/coverage.rs
+ * [`UntestedFile`]: ../../fallow-output/src/health_coverage_gaps.rs
  */
 export interface UntestedFileAction {
 type: UntestedFileActionType
@@ -4693,7 +4723,7 @@ actions: UntestedExportAction[]
  * `add-test-import` reflects that a test-reachable reference chain, not
  * just any test coverage, is what closes the gap.
  *
- * [`UntestedExport`]: ../../fallow-cli/src/health_types/coverage.rs
+ * [`UntestedExport`]: ../../fallow-output/src/health_coverage_gaps.rs
  */
 export interface UntestedExportAction {
 type: UntestedExportActionType
@@ -4784,7 +4814,7 @@ commits: number
  * `ownership-drift`) are appended only when `--ownership` is active AND
  * the corresponding signal fires for the hotspot.
  *
- * [`HotspotEntry`]: ../../fallow-cli/src/health_types/scores.rs
+ * [`HotspotEntry`]: ../../fallow-output/src/health_scores.rs
  */
 export interface HotspotAction {
 type: HotspotActionType
@@ -4870,6 +4900,27 @@ watermark?: (RuntimeCoverageWatermark | null)
  * Non-fatal merge or coverage diagnostics. Omitted when empty.
  */
 warnings?: RuntimeCoverageMessage[]
+/**
+ * Whether an autonomous agent may act on this report (fallow-rs/fallow-cloud#316,
+ * mirrors the cloud runtime-context contract). `false` when the capture
+ * carries no usable runtime evidence (no tracked functions); then
+ * `actionability_verdict` is `insufficient_evidence` and
+ * `actionability_reason` explains. F4: a non-action floor, never a gate on a
+ * positive verdict.
+ */
+actionable: boolean
+/**
+ * Why the report is non-actionable; `null` when `actionable` is true.
+ */
+actionability_reason?: (string | null)
+/**
+ * First-class non-action verdict (`insufficient_evidence`) when not
+ * actionable; `null` otherwise. Mirrors the cloud runtime-context `verdict`;
+ * named distinctly from the report-context `verdict` above to avoid a
+ * collision.
+ */
+actionability_verdict?: (string | null)
+provenance: RuntimeCoverageProvenance
 }
 /**
  * Summary block mirroring `fallow_cov_protocol::Summary` (0.3 shape).
@@ -4910,7 +4961,7 @@ coverage_percent: number
 trace_count: number
 /**
  * Days of observation covered by the supplied dump (Phase 2 local analysis
- * emits 0 , set by the beacon/cloud in Phase 3+).
+ * emits 0, set by the beacon/cloud in Phase 3+).
  */
 period_days: number
 /**
@@ -5005,6 +5056,13 @@ evidence: RuntimeCoverageEvidence
  * Suggested actions for this finding. Omitted when empty.
  */
 actions?: RuntimeCoverageAction[]
+/**
+ * The discriminator inputs that produced this verdict (#321), emitted so an
+ * agent can reproduce it and see the confidence cap. `None` for findings
+ * not built from the merge pipeline (e.g. baseline round-trips). Omitted
+ * from JSON when absent.
+ */
+discriminators?: (RuntimeCoverageDiscriminators | null)
 }
 /**
  * Supporting evidence for a finding (mirrors `fallow_cov_protocol::Evidence`).
@@ -5057,6 +5115,48 @@ description: string
  */
 auto_fixable: boolean
 }
+/**
+ * Discriminator inputs that PRODUCED a finding's verdict (fallow-rs/fallow-cloud#321),
+ * emitted alongside the verdict so an agent can reproduce it and see the
+ * minimum-observation confidence cap instead of re-deriving them from scratch.
+ * F4: these make the EXISTING Fallow-owned discriminators legible; they are not
+ * a new or external signal and gate nothing. Pairs with `evidence.static_status`
+ * (the static half of the discriminator set).
+ */
+export interface RuntimeCoverageDiscriminators {
+/**
+ * Three-state runtime tracking: `called` (invocations > 0), `never_called`
+ * (V8 tracked it, invocations == 0), or `untracked` (V8 never saw it). The
+ * ONLY signal that can issue a deletion verdict.
+ */
+tracking_state: string
+/**
+ * `invocations / trace_count` for this function; `null` when untracked (no
+ * invocation count). The per-function value behind the low-traffic split.
+ */
+invocation_ratio?: (number | null)
+/**
+ * Active/low_traffic split ratio in effect (CLI default 0.001). A tracked
+ * function whose `invocation_ratio` is below this reads `low_traffic`, else
+ * `active`.
+ */
+low_traffic_threshold: number
+/**
+ * Total observed invocations across all functions (the `invocation_ratio`
+ * denominator), echoed per finding so the verdict is self-contained.
+ */
+trace_count: number
+/**
+ * High-confidence verdict floor (CLI default 5000). When `trace_count` is
+ * below it, confidence is capped regardless of the per-function signal.
+ */
+min_observation_volume: number
+/**
+ * `trace_count >= min_observation_volume`: whether the dump cleared the
+ * confidence floor. `false` means this verdict's confidence is capped.
+ */
+meets_observation_volume: boolean
+}
 export interface RuntimeCoverageHotPath {
 /**
  * Stable content-hash ID of the form `fallow:hot:<hash>`.
@@ -5194,6 +5294,44 @@ code: string
  */
 message: string
 }
+/**
+ * Provenance of a runtime-coverage report (fallow-rs/fallow-cloud#319), mirroring
+ * the cloud runtime-context `provenance` block so the local-capture and cloud
+ * surfaces present one portable shape. F4: provenance is context only; it never
+ * gates a verdict or confidence.
+ */
+export interface RuntimeCoverageProvenance {
+data_source: RuntimeCoverageDataSource
+/**
+ * `true` / `false` / `unknown`. Always `unknown` for a local capture: the
+ * local path has no deployment-origin signal (the cloud may resolve it).
+ */
+is_production: string
+/**
+ * Age in whole days of the most recent evidence; `0` for a fresh local
+ * capture, `null` when no runtime data is present.
+ */
+freshness_days?: (number | null)
+/**
+ * `functions_untracked / (functions_tracked + functions_untracked)`, in
+ * `[0, 1]`. High ratios mark a thin / partial capture.
+ */
+untracked_ratio: number
+/**
+ * Fraction of resolution-attempted functions whose position could not be
+ * mapped to source, in `[0, 1]`. `0` for a local capture (positions resolve
+ * natively or via the sidecar).
+ */
+unresolved_ratio: number
+/**
+ * Whether `freshness_days` exceeds `stale_after_days`.
+ */
+stale: boolean
+/**
+ * The documented staleness cutoff (days), echoed so the rule travels in-band.
+ */
+stale_after_days: number
+}
 /**
  * Combined coverage, runtime, complexity, and change-scope verdicts.
  */
@@ -5465,7 +5603,7 @@ fingerprint: string
  * the target's `evidence.complex_functions` back to the matching
  * `ComplexityViolation` and read placement from THAT action instead.
  *
- * [`RefactoringTarget`]: ../../fallow-cli/src/health_types/targets.rs
+ * [`RefactoringTarget`]: ../../fallow-output/src/health_targets.rs
  */
 export interface RefactoringTargetAction {
 type: RefactoringTargetActionType
@@ -5483,7 +5621,7 @@ description: string
 /**
  * Recommendation category for `apply-refactoring` actions. Mirrors
  * the parent target's
- * [`category`](../../fallow-cli/src/health_types/targets.rs.html)
+ * [`category`](../../fallow-output/src/health_targets.rs.html)
  * field so consumers can route on the action alone.
  */
 category?: (string | null)
@@ -5567,11 +5705,11 @@ snapshot_schema_version?: (number | null)
  */
 export interface TrendMetric {
 /**
- * Metric identifier (e.g., `"score"`, `"dead_file_pct"`).
+ * Metric identifier, e.g. `"score"` or `"dead_file_pct"`.
  */
 name: string
 /**
- * Human-readable label (e.g., `"Health Score"`, `"Dead Files"`).
+ * Human-readable label, e.g. `"Health Score"` or `"Dead Files"`.
  */
 label: string
 /**
@@ -5583,12 +5721,12 @@ previous: number
  */
 current: number
 /**
- * Absolute change (current − previous).
+ * Absolute change (current - previous).
  */
 delta: number
 direction: TrendDirection
 /**
- * Unit for display (e.g., `"%"`, `""`, `"pts"`).
+ * Unit for display, e.g. `"%"`, `""`, or `"pts"`.
  */
 unit: string
 /**
@@ -5605,11 +5743,11 @@ current_count?: (TrendCount | null)
  */
 export interface TrendCount {
 /**
- * The numerator (e.g., dead files count).
+ * The numerator, e.g. dead files count.
  */
 value: number
 /**
- * The denominator (e.g., total files).
+ * The denominator, e.g. total files.
  */
 total: number
 }
@@ -5617,10 +5755,10 @@ total: number
  * Auditable breadcrumb recording when health-finding `suppress-line`
  * action hints were omitted from the report.
  *
- * Set at construction time on [`HealthReport::actions_meta`] (and on
- * each [`HealthGroup::actions_meta`](crate::health_types::HealthGroup)
+ * Set at construction time on `HealthReport::actions_meta` (and on
+ * each `HealthGroup::actions_meta`
  * when grouped) by the report builder, derived from the active
- * [`HealthActionContext`]. Lets consumers see "where did the
+ * `HealthActionContext`. Lets consumers see "where did the
  * suppress-line hints go?" without having to grep the config or CLI
  * history.
  *
@@ -5632,8 +5770,8 @@ total: number
  */
 export interface HealthActionsMeta {
 /**
- * Always `true` when the breadcrumb is emitted. Absent from the wire
- * when no suppression occurred.
+ * Always `true` when the breadcrumb is emitted. Absent from the wire when
+ * no suppression occurred.
  */
 suppression_hints_omitted: boolean
 /**
@@ -5770,6 +5908,18 @@ unused_font_faces?: UnusedFontFace[]
  * downstream repo. Sorted by `(path, line, token)`.
  */
 unused_theme_tokens?: UnusedThemeToken[]
+/**
+ * A location-aware reverse index of Tailwind v4 `@theme` token consumers:
+ * per token, where it is consumed (`var()` reads, `@apply` bodies, generated
+ * utility classes) and through which surface, plus the full `consumer_count`
+ * (a static lower bound) and the defining site. Built from the same gated
+ * candidate set as `unused_theme_tokens` (v4 + non-plugin + non-published +
+ * whole-scope), so a token with `consumer_count: 0` is the same "nothing
+ * consumes this" signal. Sorted by token; empty when the project is not
+ * Tailwind v4 or a plugin / published-library / partial-scope run gated the
+ * scan out.
+ */
+token_consumers?: TokenConsumers[]
 /**
  * The project authors `font-size` values in several units (`px`, `rem`,
  * `em`, `%`), with a per-unit distinct-value count: a type-scale
@@ -5956,11 +6106,16 @@ nesting_depth: number
 /**
  * Project-wide CSS analytics aggregates across every analyzed stylesheet
  * (including stylesheets with no notable rule, which are not listed
- * individually).
+ * individually in `files`).
  */
 export interface CssAnalyticsSummary {
 /**
- * Stylesheets analyzed (standard CSS only; SCSS is skipped).
+ * Stylesheets analyzed: standard `.css` files, Vue/Svelte SFC `<style>`
+ * blocks, and (dep-gated) CSS-in-JS, both the tagged-template form and the
+ * object form (`style({...})` / `stylex.create({...})` / `css({...})`). SCSS
+ * is skipped. Note: flat atomic object CSS-in-JS (StyleX/Panda) is counted
+ * here and contributes to these aggregates, but has no notable rules, so its
+ * files never appear in the per-file `files` list.
  */
 files_analyzed: number
 /**
@@ -6414,6 +6569,92 @@ line: number
  */
 actions: CssCandidateAction[]
 }
+/**
+ * A location-aware reverse index of where one design token is consumed, so an
+ * agent editing the token can see its blast radius before changing or removing
+ * it. Covers TWO token origins. The always-available discriminator is the `token`
+ * SHAPE: a Tailwind token is the `--`-prefixed custom property (`--color-brand`),
+ * a CSS-in-JS token is a dotted access path with no `--` prefix
+ * (`vars.color.primary`). The per-consumer `kind` also discriminates origin, but
+ * only when `consumer_count > 0` (a `consumer_count: 0` entry has an empty
+ * `consumers` array and thus no `kind`), so branch on the `token` prefix for the
+ * zero-consumer case. The two origins:
+ *
+ * - Tailwind v4 `@theme` tokens (kinds `theme-var` / `css-var` / `utility` /
+ *   `apply`), built from the same gated candidate set as `unused_theme_tokens`
+ *   (v4 + non-plugin + non-published + whole-scope), so a `consumer_count: 0`
+ *   corroborates the `unused_theme_tokens` "nothing consumes this" finding.
+ * - CSS-in-JS tokens (kind `js-member`) from StyleX `defineVars` /
+ *   vanilla-extract `createTheme` family definitions, consumed via cross-module
+ *   member access. NOTE: CSS-in-JS has NO corroborating dead-token finding (there
+ *   is no `unused_theme_tokens` analogue), so a CSS-in-JS `consumer_count: 0` is a
+ *   weaker signal than the Tailwind case (and the cross-file scan is relative-import
+ *   only, so alias / bare-package imports are not counted).
+ *
+ * This is DESCRIPTIVE context (a blast-radius lookup), not a finding, so it
+ * deliberately carries no `actions` array (unlike the cleanup-candidate types in
+ * this module). `consumer_count` is always a STATIC lower bound (a computed class
+ * name like `bg-${color}`, or a CSS-in-JS access through an unresolved alias
+ * import, is not counted).
+ */
+export interface TokenConsumers {
+/**
+ * The token identity. For a Tailwind `@theme` token this is the full custom
+ * property as authored, INCLUDING the `--` prefix (`--color-brand`). For a
+ * CSS-in-JS token (kind `js-member`) this is the binding-qualified dotted
+ * access path, NO `--` prefix (`vars.color.primary`), matching how consumers
+ * read it. The presence of the `--` prefix distinguishes the two origins.
+ */
+token: string
+/**
+ * For a Tailwind token, the v4 theme namespace (`color`, `radius`,
+ * `font-weight`, ...). For a CSS-in-JS token (kind `js-member`), the defining
+ * export BINDING the token set is accessed through (`vars`), which identifies
+ * the token set, NOT a semantic group. (The field is thus overloaded by
+ * origin; branch on `consumers[].kind` or the `token` shape.)
+ */
+namespace: string
+/**
+ * Project-root-relative, forward-slash path to the declaring stylesheet
+ * (Tailwind) or the JS/TS token-definition file (CSS-in-JS).
+ */
+definition_path: string
+/**
+ * 1-based line of the token's definition (inside the `@theme` block for
+ * Tailwind; the token key inside the `defineVars`/`createTheme` object for
+ * CSS-in-JS).
+ */
+definition_line: number
+/**
+ * The FULL number of consumer locations found, a STATIC LOWER BOUND: a
+ * computed class name (`bg-${color}`) or a value read outside CSS/markup the
+ * scan never sees is not counted. This is the aggregate over every consumer,
+ * computed BEFORE [`consumers`](Self::consumers) is capped to a sample.
+ */
+consumer_count: number
+/**
+ * A capped, deterministically-sorted sample of consumer locations (at most
+ * [`TOKEN_CONSUMER_SAMPLE_CAP`]). The full count lives in
+ * [`consumer_count`](Self::consumer_count); use this list to jump to
+ * representative consumers, not to enumerate every one.
+ */
+consumers: TokenConsumerLocation[]
+}
+/**
+ * Where one Tailwind v4 `@theme` token is consumed, and through which surface.
+ * One entry in a [`TokenConsumers::consumers`] sample.
+ */
+export interface TokenConsumerLocation {
+/**
+ * Project-root-relative, forward-slash path to the consuming file.
+ */
+path: string
+/**
+ * 1-based line of the consuming reference in that file.
+ */
+line: number
+kind: ConsumerKind
+}
 /**
  * A design-token notation-consistency candidate: the distinct notations used
  * across the codebase for one value axis (today, length units on `font-size`),
@@ -6452,6 +6693,75 @@ notation: string
  */
 count: number
 }
+/**
+ * Project-level styling-health score: a SECOND health axis computed purely from
+ * the structural CSS analytics (`CssAnalyticsReport`), orthogonal to the JS/TS
+ * code-health [`HealthScore`]. Surfaced only alongside the `--css` analytics, so
+ * a plain `fallow health` run is byte-unchanged. The code score and grade stay
+ * untouched: styling health is additive, never folded into the code score.
+ *
+ * Like [`HealthScore`], the score starts at 100 and subtracts capped per-category
+ * penalties; the grade reuses the shared [`letter_grade`] thresholds verbatim
+ * (A>=85, B>=70, C>=55, D>=40, F<40), so the two axes are read on one scale.
+ */
+export interface StylingHealth {
+formula_version: number
+score: number
+grade: string
+penalties: StylingHealthPenalties
+confidence: StylingHealthConfidence
+/**
+ * Human-readable reason the grade is low-confidence: either the declaration
+ * and stylesheet counts a thin grade was computed from, or that structure is
+ * not assessable for compile-time-atomic CSS-in-JS. `None` when confidence is
+ * `High`. Prose, not a stable machine field: gate on `confidence`, not on
+ * this string.
+ */
+confidence_reason?: (string | null)
+}
+/**
+ * Per-category penalty breakdown for the styling-health score. Each field is the
+ * number of points subtracted from a starting 100 for one CSS signal family,
+ * already capped at its category ceiling. A `0.0` field means "the signal was
+ * evaluated and clean"; the whole struct is only ever built when CSS analytics
+ * were produced, so there is no "missing pipeline" ambiguity to model with
+ * `Option` here (the parent `StylingHealth` is itself `Option` on the report).
+ */
+export interface StylingHealthPenalties {
+/**
+ * Copy-paste declaration blocks (`duplicate_declaration_blocks`), scaled by
+ * total removable declarations. Capped at 20pt.
+ */
+duplication: number
+/**
+ * Dead styling surface, two independently-normalized terms summed and capped
+ * at 20pt: (a) unused `@theme` tokens as a share of the total `@theme` token
+ * population (size-independent, so a declaration-sparse Tailwind project is
+ * not penalized for a few dead tokens); plus (b) the other dead entities
+ * (unreferenced classes, unused `@property`/`@layer` at-rules, dead
+ * `@font-face` families) as a share of `total_declarations`.
+ */
+dead_surface: number
+/**
+ * Broken references: markup classes one edit from a defined class
+ * (`unresolved_class_references`) and animations referencing a `@keyframes`
+ * defined nowhere (`undefined_keyframes`). Capped at 15pt.
+ */
+broken_references: number
+/**
+ * Design-token erosion: mixed `font-size` units (`font_size_unit_mix`),
+ * Tailwind arbitrary-value bypasses (`tailwind_arbitrary_values`), and
+ * distinct HARDCODED `box-shadow`/`border-radius`/`line-height` values above
+ * per-axis baselines (the v3 value-sprawl drift sub-term; `var(--*)`-
+ * referenced values are not counted). Capped at 10pt.
+ */
+token_erosion: number
+/**
+ * Structural smells from the summary aggregates: `!important` density and
+ * deep style-rule nesting. Capped at 10pt.
+ */
+structural: number
+}
 /**
  * Envelope emitted by `fallow explain <issue-type> --format json`.
  *
@@ -6648,10 +6958,9 @@ _meta?: (Meta | null)
 }
 /**
  * Envelope emitted by `fallow list --boundaries --format json`. Surfaces
- * the architecture boundary zones, rules, and (issue #373) the user's
- * pre-expansion `autoDiscover` logical groups so consumers can render
- * grouping intent that `expand_auto_discover` would otherwise flatten out
- * of `zones[]`.
+ * the architecture boundary zones, rules, and the user's pre-expansion
+ * `autoDiscover` logical groups so consumers can render grouping intent that
+ * expansion would otherwise flatten out of `zones[]`.
  */
 export interface ListBoundariesOutput {
 boundaries: BoundariesListing
@@ -6688,10 +6997,10 @@ from: string
 allow: string[]
 }
 /**
- * A pre-expansion `autoDiscover` logical group surfaced for observability
- * (issue #373). Captured during `expand_auto_discover` so consumers can
- * see the user-authored parent name and grouping intent after expansion
- * would otherwise flatten it out of [`BoundariesListing::zones`].
+ * A pre-expansion `autoDiscover` logical group surfaced for observability.
+ * Captured during expansion so consumers can see the user-authored parent
+ * name and grouping intent after expansion would otherwise flatten it out of
+ * [`BoundariesListing::zones`].
  */
 export interface BoundariesListLogicalGroup {
 name: string
@@ -6779,7 +7088,7 @@ elapsed_ms: ElapsedMs
 /**
  * Functions and synthetic template entries exceeding complexity
  * thresholds, sorted by the --sort criteria. Each entry wraps its
- * inner [`ComplexityViolation`] payload (flattened on the wire) with
+ * inner `ComplexityViolation` payload (flattened on the wire) with
  * the typed `actions` list and an optional audit-mode `introduced`
  * flag.
  */
@@ -6824,7 +7133,7 @@ prop_drilling_chains?: PropDrillingChainFinding[]
 /**
  * Hotspot entries combining git churn with complexity. Only present when
  * --hotspots is used. Sorted by score descending (highest risk first).
- * Each entry wraps its inner [`HotspotEntry`] payload (flattened on the
+ * Each entry wraps its inner `HotspotEntry` payload (flattened on the
  * wire) with a typed `actions` list.
  */
 hotspots?: HotspotFinding[]
@@ -6849,7 +7158,7 @@ large_functions?: LargeFunctionEntry[]
 /**
  * Ranked refactoring recommendations. Only present when --targets is used.
  * Sorted by efficiency (priority/effort) descending. Each entry wraps
- * its inner [`RefactoringTarget`] payload (flattened on the wire) with
+ * its inner `RefactoringTarget` payload (flattened on the wire) with
  * a typed `actions` list.
  */
 targets?: RefactoringTargetFinding[]
@@ -6880,13 +7189,21 @@ framework_health?: (FrameworkHealthDiagnostics | null)
  * over-complex selectors, deep nesting). Present only with `--css`.
  */
 css_analytics?: (CssAnalyticsReport | null)
+/**
+ * Styling-health score and letter grade: a SECOND health axis derived from
+ * the CSS analytics (the design-system axis), orthogonal to the JS/TS code
+ * `health_score`. Present only with `--css` (the same condition as
+ * `css_analytics`), so a plain `fallow health` run is byte-unchanged. The
+ * code score is never affected by this field.
+ */
+styling_health?: (StylingHealth | null)
 grouped_by?: (GroupByMode | null)
 groups?: (HealthGroup[] | null)
 _meta?: (Meta | null)
 workspace_diagnostics?: WorkspaceDiagnostic[]
 /**
  * Read-only follow-up commands computed from this run's findings. See
- * [`CheckOutput::next_steps`] for the contract.
+ * `CheckOutput::next_steps` for the contract.
  */
 next_steps?: NextStep[]
 }
@@ -6901,7 +7218,7 @@ next_steps?: NextStep[]
  * files in the group, so they answer "what is the health of workspace X" in
  * a single invocation. `files_analyzed` and `functions_above_threshold`
  * summarise the subset for parity with the project-level
- * [`crate::health_types::HealthSummary`].
+ * project-level health summary.
  */
 export interface HealthGroup {
 /**
@@ -6948,7 +7265,7 @@ health_score?: (HealthScore | null)
 /**
  * Findings restricted to files in this group. Each entry is the typed
  * [`HealthFinding`] wrapper around a
- * [`ComplexityViolation`](crate::health_types::ComplexityViolation)
+ * `ComplexityViolation`
  * payload.
  */
 findings?: HealthFinding[]
@@ -6959,7 +7276,7 @@ file_scores?: FileHealthScore[]
 /**
  * Hotspots restricted to files in this group. Each entry is the typed
  * [`HotspotFinding`] wrapper around a
- * [`HotspotEntry`](crate::health_types::HotspotEntry) payload.
+ * `HotspotEntry` payload.
  */
 hotspots?: HotspotFinding[]
 /**
@@ -6969,7 +7286,7 @@ large_functions?: LargeFunctionEntry[]
 /**
  * Refactoring targets in files belonging to this group. Each entry is
  * the typed [`RefactoringTargetFinding`] wrapper around a
- * [`RefactoringTarget`](crate::health_types::RefactoringTarget)
+ * `RefactoringTarget`
  * payload.
  */
 targets?: RefactoringTargetFinding[]
@@ -6977,21 +7294,17 @@ targets?: RefactoringTargetFinding[]
  * Auditable breadcrumb recording why `suppress-line` action hints
  * were omitted from this group's findings. Mirrors the project-level
  * `HealthReport.actions_meta`; populated at construction time when the
- * per-group [`HealthActionContext`](crate::health_types::HealthActionContext)
+ * per-group `HealthActionContext`
  * suppresses inline hints.
  */
 actions_meta?: (HealthActionsMeta | null)
 }
 /**
- * Wire-shape payload for `fallow dupes --format json` (the body that
- * flattens into [`crate::output_envelope::DupesOutput`] and is also
- * emitted under the `dupes` / `duplication` key inside the combined and
- * audit envelopes).
+ * Envelope emitted by `fallow dupes --format json`.
  *
- * Mirrors [`DuplicationReport`] field-for-field, except `clone_groups`
- * and `clone_families` carry the typed wrapper envelopes instead of bare
- * findings, so the schema (and any TS / agent consumer) sees the typed
- * `actions[]` natively.
+ * `Report` and `Group` are generic so the envelope can live in
+ * `fallow-output` while duplication report wrappers and grouped output
+ * internals continue to migrate out of CLI/API-specific crates.
  */
 export interface DupesOutput {
 schema_version: SchemaVersion
@@ -7003,8 +7316,8 @@ elapsed_ms: ElapsedMs
 clone_groups: CloneGroupFinding[]
 /**
  * Clone families, each wrapped with typed actions. Inner `groups`
- * inside each [`CloneFamilyFinding`] are themselves wrapped as
- * [`CloneGroupFinding`] entries carrying their own `actions[]` (and
+ * inside each `CloneFamilyFinding` are themselves wrapped as
+ * `CloneGroupFinding` entries carrying their own `actions[]` (and
  * optional audit-mode `introduced` flag), so JSON-Schema strict
  * consumers and TS consumers reading `clone_families[].groups[]` see
  * the same shape as the top-level `clone_groups[]` array (preserves
@@ -7026,7 +7339,7 @@ groups?: (DuplicationGroup[] | null)
 _meta?: (Meta | null)
 /**
  * Workspace-discovery diagnostics surfaced during config load
- * (issue #473). See [`CheckOutput::workspace_diagnostics`] for the full
+ * (issue #473). See `CheckOutput::workspace_diagnostics` for the full
  * contract; the same list is repeated on each top-level command's
  * envelope so single-command consumers see it without having to look at
  * a separate top-level field.
@@ -7034,7 +7347,7 @@ _meta?: (Meta | null)
 workspace_diagnostics?: WorkspaceDiagnostic[]
 /**
  * Read-only follow-up commands computed from this run's findings. See
- * [`CheckOutput::next_steps`] for the contract.
+ * `CheckOutput::next_steps` for the contract.
  */
 next_steps?: NextStep[]
 }
@@ -7067,7 +7380,7 @@ clone_families: CloneFamilyFinding[]
  * Wire-shape envelope for an [`AttributedCloneGroup`] finding (per-bucket
  * duplication attribution emitted under `fallow dupes --group-by`).
  * Flattens the attributed group and carries the same typed
- * `CloneGroupAction` array as [`CloneGroupFinding`]; no `introduced`
+ * `CloneGroupAction` array as `CloneGroupFinding`; no `introduced`
  * field because `fallow audit` does not run on grouped output.
  */
 export interface AttributedCloneGroupFinding {
@@ -7076,7 +7389,13 @@ export interface AttributedCloneGroupFinding {
  * this clone group. Ties broken alphabetically (smallest key wins).
  */
 primary_owner: string
+/**
+ * Number of tokens in the clone group.
+ */
 token_count: number
+/**
+ * Number of source lines in the clone group.
+ */
 line_count: number
 /**
  * Each instance carries its own `owner` field alongside the standard
@@ -7486,7 +7805,7 @@ thin_wrappers?: ThinWrapperFinding[]
 duplicate_prop_shapes?: DuplicatePropShapeFinding[]
 }
 /**
- * The rendered impact report, derived purely from the store (no analysis run).
+ * The rendered impact report, derived purely from the store.
  */
 export interface ImpactReport {
 schema_version: ImpactReportSchemaVersion
@@ -7582,18 +7901,24 @@ duplication: number
 export interface TrendSummary {
 direction: ImpactTrendDirection
 /**
- * Signed delta in total issues (current minus previous).
+ * Signed delta in total issues, current minus previous.
  */
 total_delta: number
 previous_total: number
 current_total: number
 }
+/**
+ * A commit-gate containment event recorded by `fallow impact`.
+ */
 export interface ContainmentEvent {
 blocked_at: string
 cleared_at: string
 git_sha?: (string | null)
 blocked_counts: ImpactCounts
 }
+/**
+ * A resolved or suppressed finding attribution event.
+ */
 export interface ResolutionEvent {
 kind: string
 path: string
@@ -7602,7 +7927,7 @@ git_sha?: (string | null)
 timestamp: string
 }
 /**
- * The cross-repo aggregate report (`fallow impact --all --format json`).
+ * The cross-repo aggregate report, `fallow impact --all --format json`.
  */
 export interface CrossRepoImpactReport {
 schema_version: CrossRepoImpactSchemaVersion
@@ -8235,17 +8560,8 @@ top_files_limit: number
  * One sampled unresolved-callee row.
  */
 export interface SecurityUnresolvedCalleeSample {
-/**
- * Project-relative source path.
- */
 path: string
-/**
- * 1-based source line.
- */
 line: number
-/**
- * 0-based byte column.
- */
 col: number
 reason: SkippedSecurityCalleeReason
 expression_kind: SkippedSecurityCalleeExpressionKind
@@ -8254,9 +8570,6 @@ expression_kind: SkippedSecurityCalleeExpressionKind
  * Count of unresolved callees in one file.
  */
 export interface SecurityUnresolvedCalleeTopFile {
-/**
- * Project-relative source path.
- */
 path: string
 /**
  * Number of unresolved callees in this file.
@@ -8397,13 +8710,7 @@ export interface SecuritySurvivor {
  */
 finding_id: string
 verdict: SecurityVerifierVerdictStatus
-/**
- * Short verifier reason.
- */
 reason?: (string | null)
-/**
- * Short verifier rationale.
- */
 rationale?: (string | null)
 /**
  * Optional verifier-provided confidence or review priority.
@@ -8463,9 +8770,6 @@ suggestion: string
  * One file inside a blind-spot group.
  */
 export interface SecurityBlindSpotFile {
-/**
- * Project-relative source path.
- */
 path: string
 /**
  * Count in the bounded diagnostic sample.
@@ -8485,10 +8789,13 @@ dupes?: (DupesReportPayload | null)
 health?: (HealthReport | null)
 /**
  * Read-only follow-up commands aggregated across the combined run's
- * findings. See [`CheckOutput::next_steps`] for the contract.
+ * findings. See `CheckOutput::next_steps` for the contract.
  */
 next_steps?: NextStep[]
 }
+/**
+ * Optional `_meta` block for [`CombinedOutput`].
+ */
 export interface CombinedMeta {
 check?: (Meta | null)
 dupes?: (Meta | null)
@@ -8677,10 +8984,11 @@ export interface FocusMap {
  */
 review_here: FocusUnit[]
 /**
- * EVERY `not-prioritized` unit (the escape hatch). Always present and fully
+ * EVERY de-prioritized unit (`not-prioritized`, plus runtime-backed `skip`
+ * units on the paid path) -- the escape hatch. Always present and fully
  * enumerated so a reviewer can always "show me what you de-prioritized"; the
  * human brief collapses it by default and re-expands under
- * `--show-deprioritized`.
+ * `--show-deprioritized`. Nothing is ever hidden, including a `skip`.
  */
 deprioritized: FocusUnit[]
 }
@@ -8705,9 +9013,9 @@ reason: string
 confidence?: ConfidenceFlag[]
 }
 /**
- * The composite attention score, with the four deterministic component
- * sub-scores kept on the wire so the runtime seam can re-weight `total`
- * without recomputing the signals.
+ * The composite attention score, with the deterministic component sub-scores
+ * kept on the wire so the runtime layer adds its weight without recomputing the
+ * signals.
  */
 export interface FocusScore {
 /**
@@ -8728,7 +9036,16 @@ risk_zone: number
  */
 change_shape: number
 /**
- * The summed total. The paid runtime layer multiplies a runtime hot/cold weight in here.
+ * Runtime-weight component (paid): a hot path (runtime evidence of high
+ * invocation) adds an invocation-bucketed weight so it amplifies the blast
+ * and outranks an otherwise-equal cold unit. `0` in free mode (no runtime
+ * input), so the free-tier total stays the four deterministic components and
+ * is byte-identical to the no-runtime baseline.
+ */
+runtime?: number
+/**
+ * The summed total of every present component (the four deterministic ones
+ * plus the runtime weight).
  */
 total: number
 }
@@ -8786,7 +9103,7 @@ export interface RoutingFacts {
 units: RoutingUnit[]
 }
 /**
- * One routed unit (a changed file) with its experts and bus-factor flag.
+ * One routed unit with its experts and bus-factor flag.
  */
 export interface RoutingUnit {
 /**
@@ -8810,11 +9127,11 @@ bus_factor_one?: boolean
  */
 export interface DecisionSurface {
 /**
- * Up to `cap` ranked decisions, highest consequence first.
+ * Ranked decisions, highest consequence first.
  */
 decisions: Decision[]
 /**
- * Present when more than `cap` decisions were extracted.
+ * Present when more than the cap were extracted.
  */
 truncated?: (TruncationNote | null)
 /**
@@ -8840,7 +9157,7 @@ category: DecisionCategory
  */
 question: string
 /**
- * Root-relative file the decision is anchored at (for suppression + routing).
+ * Root-relative file the decision is anchored at.
  */
 anchor_file: string
 /**
@@ -8848,7 +9165,7 @@ anchor_file: string
  */
 anchor_line: number
 /**
- * The raw fallow-emitted candidate key the `signal_id` hashes (the evidence).
+ * The raw fallow-emitted candidate key the `signal_id` hashes.
  */
 signal_key: string
 /**
@@ -8873,7 +9190,7 @@ consequence: number
  */
 expert: string[]
 /**
- * Whether the anchor file's only qualified owner is one person (bus-factor-1).
+ * Whether the anchor file's only qualified owner is one person.
  */
 bus_factor_one?: boolean
 /**
@@ -8894,7 +9211,7 @@ internal_consumer_count: number
 tradeoff: string
 }
 /**
- * A note for the decisions collapsed below the cap.
+ * A note for decisions collapsed below the cap.
  */
 export interface TruncationNote {
 /**
@@ -8955,7 +9272,7 @@ export interface ReviewDirection {
  */
 order: string[]
 /**
- * The coherent review units, in `order`.
+ * Coherent review units, in `order`.
  */
 units: DirectionUnit[]
 }
@@ -8986,7 +9303,7 @@ scoring_budget: number
  */
 out_of_diff: string[]
 /**
- * The routed expert(s) to ask, from ownership routing.
+ * Routed expert(s), when ownership signals are available.
  */
 expert: string[]
 }
@@ -9041,7 +9358,7 @@ judgment_shape: string
  */
 echo_field: string
 /**
- * The constant naming the anti-hallucination rule.
+ * The anchoring rule name.
  */
 anchoring_rule: string
 }
@@ -9114,11 +9431,11 @@ change_anchor: string
  */
 anchor_kind: string
 /**
- * The agent's framing, FENCED: this is non-deterministic agent prose.
+ * The agent's fenced free-text framing.
  */
 agent_framing: string
 /**
- * The agent's optional concern category (advisory).
+ * The agent's optional concern category.
  */
 concern?: (string | null)
 /**
@@ -9159,6 +9476,15 @@ categories: string[]
 severity: CodeClimateSeverity
 fingerprint: string
 location: CodeClimateLocation
+/**
+ * Optional owner attribution used by grouped dead-code output.
+ */
+owner?: (string | null)
+/**
+ * Optional grouping attribution used by grouped health and duplication
+ * output.
+ */
+group?: (string | null)
 }
 /**
  * Location block inside [`CodeClimateIssue::location`].