fallow 3.34.1 → 3.36.0

package/types/output-contract.d.ts

@@ -149,6 +149,11 @@ export type ElapsedMs = number
  * Value of `audit.gate`: which findings drive the `fallow audit` verdict.
  */
 export type AuditGate = ("new-only" | "all")
+/**
+ * Value of `audit.worsened`: how a worsened complexity finding affects the
+ * `fallow audit` verdict.
+ */
+export type AuditWorsened = ("warn" | "error" | "off")
 /**
  * What a gate concluded on this run.
  *
@@ -159,6 +164,10 @@ export type AuditGate = ("new-only" | "all")
  * is decided here.
  */
 export type GateStatus = ("pass" | "warn" | "fail" | "skipped")
+/**
+ * Why a file counts for the `parse-error` gate, other than a parser error.
+ */
+export type GateFileReason = "nesting-too-deep"
 /**
  * Analysis mode stored with baselines, snapshots, audit sides, and impact data.
  */
@@ -406,6 +415,7 @@ export type PolicyViolationSeverity = ("error" | "warn")
  * The origin of a stale suppression: inline comment or JSDoc tag.
  */
 export type SuppressionOrigin = ({
+type: "comment"
 /**
  * The issue kind token from the comment (e.g., "unused-exports"), or None for blanket.
  */
@@ -427,8 +437,8 @@ is_file_level: boolean
  * adopted the field stay byte-compatible. See issue #449.
  */
 kind_known?: boolean
-type: "comment"
 } | {
+type: "jsdoc_tag"
 /**
  * The name of the export that was tagged.
  */
@@ -437,7 +447,6 @@ export_name: string
  * Human-authored reason after `--`, when present.
  */
 reason?: (string | null)
-type: "jsdoc_tag"
 })
 /**
  * Where an override entry was declared. Serialized as the filename label
@@ -559,58 +568,67 @@ degrades_analysis?: boolean
 export type WorkspaceDiagnostic1 = ({
 kind: "undeclared-workspace"
 } | {
+kind: "malformed-package-json"
 /**
  * `serde_json` parse error text.
  */
 error: string
-kind: "malformed-package-json"
 } | {
+kind: "glob-matched-no-package-json"
 /**
  * The glob pattern that matched the directory.
  */
 pattern: string
-kind: "glob-matched-no-package-json"
 } | {
+kind: "workspace-glob-outside-root"
 /**
  * The workspace entry, as written in the file.
  */
 pattern: string
-kind: "workspace-glob-outside-root"
 } | {
+kind: "workspace-pattern-dir-missing"
+/**
+ * The workspace pattern, as written in the file.
+ */
+pattern: string
+} | {
+kind: "nested-project-root"
+} | {
+kind: "malformed-tsconfig"
 /**
  * JSONC parse error text.
  */
 error: string
-kind: "malformed-tsconfig"
 } | {
 kind: "tsconfig-reference-dir-missing"
 } | {
+kind: "malformed-pnpm-workspace-yaml"
 /**
  * YAML parse error text.
  */
 error: string
-kind: "malformed-pnpm-workspace-yaml"
 } | {
+kind: "skipped-large-file"
 /**
  * On-disk size of the skipped file in bytes.
  */
 size_bytes: number
-kind: "skipped-large-file"
 } | {
+kind: "skipped-minified-file"
 /**
  * On-disk size of the skipped file in bytes.
  */
 size_bytes: number
-kind: "skipped-minified-file"
 } | {
 kind: "skipped-source-dotdir"
 } | {
+kind: "source-read-failure"
 /**
  * Filesystem or UTF-8 decoding error from `read_to_string`.
  */
 error: string
-kind: "source-read-failure"
 } | {
+kind: "source-parse-degraded"
 /**
  * Number of parser diagnostics reported for the file.
  */
@@ -620,7 +638,12 @@ error_count: number
  * the extracted module is a fragment at best.
  */
 panicked: boolean
-kind: "source-parse-degraded"
+} | {
+kind: "source-nesting-too-deep"
+/**
+ * The bracket nesting cap of the pre-parse scan.
+ */
+limit: number
 } | {
 kind: "bun-lockb-override-resolution-skipped"
 } | {
@@ -632,8 +655,8 @@ kind: "npm-lock-override-resolution-skipped"
 } | {
 kind: "bun-resolutions-shadowed-by-overrides"
 } | {
-cause: PnpmWorkspaceOverridesIgnoredCause
 kind: "pnpm-workspace-overrides-ignored"
+cause: PnpmWorkspaceOverridesIgnoredCause
 } | {
 kind: "node-modules-missing"
 } | {
@@ -641,6 +664,7 @@ kind: "boundaries-not-configured"
 } | {
 kind: "rule-packs-not-configured"
 } | {
+kind: "excluded-by-default-ignore"
 /**
  * The built-in glob that matched, verbatim (for example
  * `** /build/**`).
@@ -664,22 +688,22 @@ file_count: number
  * one matched location out of several.
  */
 directory_count: number
-kind: "excluded-by-default-ignore"
 } | {
+kind: "no-source-files-analyzed"
 /**
  * Candidate source files the built-in ignore patterns removed from
  * this walk, summed across every pattern. `0` when the walk found no
  * candidate to exclude in the first place.
  */
 excluded_file_count: number
-kind: "no-source-files-analyzed"
 } | {
+kind: "file-scores-unavailable"
 /**
  * Scoring error text.
  */
 error: string
-kind: "file-scores-unavailable"
 } | {
+kind: "hotspots-skipped"
 /**
  * Which input stopped it, as a kebab-case token: `not-a-repository`,
  * `no-commits`, `invalid-since` or `churn-file-unreadable`. The set is
@@ -693,25 +717,25 @@ kind: "file-scores-unavailable"
  * remedy for all four.
  */
 cause: string
-kind: "hotspots-skipped"
 } | {
+kind: "change-coupling-skipped"
 /**
  * Kebab-case token: `shallow-clone` (the fetched history is
  * incomplete) or `too-few-commits` (fewer analyzed commits than the
  * minimum revisions of one file). The set is open.
  */
 cause: string
-kind: "change-coupling-skipped"
 } | {
+kind: "shallow-clone"
 /**
  * `true` when the run also asked for ownership attribution, which a
  * shallow clone skews further by inflating single-author dominance.
  */
 ownership_requested: boolean
-kind: "shallow-clone"
 } | {
 kind: "unpinned-clock"
 } | {
+kind: "ownership-unavailable"
 /**
  * Which input failed, as a kebab-case token: `invalid-bot-pattern` or
  * `codeowners-parse-failed`. The set is open.
@@ -721,21 +745,21 @@ cause: string
  * Underlying error text.
  */
 error: string
-kind: "ownership-unavailable"
 } | {
+kind: "trend-snapshot-unreadable"
 /**
  * Filesystem or JSON error text.
  */
 error: string
-kind: "trend-snapshot-unreadable"
 } | {
+kind: "trend-group-baseline-unavailable"
 /**
  * Why the groups have no baseline, as a kebab-case token:
  * `snapshot-has-no-groups` or `grouped-by-mismatch`. The set is open.
  */
 cause: string
-kind: "trend-group-baseline-unavailable"
 } | {
+kind: "plugin-config-unreadable"
 /**
  * The plugin that read the config, as it labels itself:
  * `module-federation` for a standalone `module-federation.config.*`,
@@ -762,8 +786,8 @@ key: string
  * option the message points at.
  */
 reason: string
-kind: "plugin-config-unreadable"
 } | {
+kind: "plugin-effect-not-modeled"
 /**
  * The plugin that read the config, as it labels itself (`nuxt`).
  */
@@ -782,36 +806,64 @@ key: string
  * be classified at all. The set is open.
  */
 reason: string
-kind: "plugin-effect-not-modeled"
 } | {
 kind: "coverage-auto-detected"
 } | {
 kind: "flag-age-shallow-clone"
 } | {
+kind: "flag-age-unavailable"
 /**
  * Why no history is available, as a kebab-case token:
  * `not-a-repository` or `no-commits`. The set is open.
  */
 cause: string
-kind: "flag-age-unavailable"
 } | {
+kind: "ignore-dependencies-glob-unmatched"
 /**
  * The `ignoreDependencies` entry, as written in the config.
  */
 pattern: string
-kind: "ignore-dependencies-glob-unmatched"
 } | {
+kind: "ignore-findings-pattern-unmatched"
 /**
  * The `ignoreFindings` entry, as written in the config.
  */
 pattern: string
-kind: "ignore-findings-pattern-unmatched"
+} | {
+kind: "entry-pattern-redundant"
+/**
+ * The `entry` pattern, as written in the config.
+ */
+pattern: string
+} | {
+kind: "ignore-dependencies-entry-redundant"
+/**
+ * The `ignoreDependencies` entry, as written in the config.
+ */
+pattern: string
+} | {
+kind: "ignore-patterns-entry-redundant"
+/**
+ * The `ignorePatterns` glob, as written in the config.
+ */
+pattern: string
+} | {
+kind: "baseline-install-state-mismatch"
+baseline_node_modules: NodeModulesState
+run_node_modules: NodeModulesState
 })
 /**
  * Why the declared pnpm version ignores the `overrides` section of
  * `pnpm-workspace.yaml`.
  */
 export type PnpmWorkspaceOverridesIgnoredCause = ("package-json-overrides" | "pnpm-version")
+/**
+ * Whether the project had a `node_modules` directory at a point in time.
+ *
+ * A dead-code baseline records this when it is saved, so a later run in a
+ * different install state can say that its results can differ.
+ */
+export type NodeModulesState = ("present" | "missing")
 /**
  * Discriminant for [`CloneGroupAction::kind`]. Mirrors the action types
  * emitted by the legacy `build_clone_group_actions` walker.
@@ -886,6 +938,27 @@ export type ThresholdSource = "override"
  * `suppress-line`.
  */
 export type HealthFindingActionType = ("refactor-function" | "add-tests" | "increase-coverage" | "suppress-file" | "suppress-line")
+/**
+ * Audit-mode class of a complexity finding against the base snapshot.
+ */
+export type AuditFindingAttribution = ("introduced" | "worsened" | "inherited")
+/**
+ * A measured metric of a complexity finding.
+ */
+export type WorsenedMetricKind = ("cyclomatic" | "cognitive" | "crap" | "line_count")
+/**
+ * Audit-mode reason why a complexity finding does not gate the verdict.
+ */
+export type AuditGateExemption = "test-file"
+/**
+ * How `fallow health` counts cyclomatic complexity for its gates.
+ *
+ * The policy changes the cyclomatic value that the `maxCyclomatic` gate reads
+ * and the cyclomatic value in every CRAP score. It does not change the health
+ * score, the complexity density, or the hotspot ranking: those keep the
+ * standard count so that grades stay comparable across projects.
+ */
+export type CyclomaticPolicy = ("standard" | "literal-membership")
 /**
  * Coverage model used for CRAP score computation.
  */
@@ -1153,12 +1226,13 @@ export type DiffRiskActionType = ("suppress-line" | "suppress-file" | "suppress-
  * `target` block of [`InspectOutput`], tagged by `type`.
  */
 export type InspectTargetDescriptor = ({
+type: "file"
 /**
  * File path relative to the analysed root.
  */
 file: string
-type: "file"
 } | {
+type: "symbol"
 /**
  * File path relative to the analysed root.
  */
@@ -1167,7 +1241,6 @@ file: string
  * Name of the inspected export.
  */
 export_name: string
-type: "symbol"
 })
 /**
  * `identity` block of [`InspectOutput`]; shape follows the target type.
@@ -1691,7 +1764,7 @@ export type MutationSchemaVersion = "1"
 /**
  * Why a run is partial.
  */
-export type MutationIncompleteReason = ("runtime-error" | "mutant-limit" | "time-budget" | "skipped-files" | "unloaded-files" | "baseline-failure" | "worktree-changed" | "typecheck-failed" | "worktree-unchecked")
+export type MutationIncompleteReason = ("runtime-error" | "mutant-limit" | "time-budget" | "skipped-files" | "unloaded-files" | "test-files-not-discovered" | "baseline-failure" | "worktree-changed" | "typecheck-failed" | "worktree-unchecked")
 /**
  * Which code a run mutates.
  */
@@ -1700,6 +1773,10 @@ export type MutationScopeKind = ("changed" | "all" | "paths")
  * The result of one mutant.
  */
 export type MutantStatus = ("killed" | "timeout" | "survived" | "no_coverage" | "runtime_error" | "flaky" | "pruned" | "pending" | "equivalent" | "compile_error")
+/**
+ * How a run detected a mutant.
+ */
+export type MutantFailureKind = ("assertion" | "error" | "timeout")
 /**
  * Why the type check did not check a survivor.
  */
@@ -1864,6 +1941,7 @@ duplication_clone_groups: number
  */
 export interface AuditAttribution {
 gate: AuditGate
+worsened?: AuditWorsened
 /**
  * Dead-code findings absent from the base snapshot.
  */
@@ -1880,6 +1958,12 @@ complexity_introduced: number
  * Complexity findings already present in the base snapshot.
  */
 complexity_inherited: number
+/**
+ * Complexity findings whose `attribution` is `worsened`. These findings
+ * are in the base snapshot, and a measured value is higher now. They are
+ * also counted in `complexity_inherited`.
+ */
+complexity_worsened?: number
 /**
  * Clone groups absent from the base snapshot.
  */
@@ -1984,7 +2068,8 @@ files?: GateFile[]
  *
  * Today only `parse-error` emits it. The item carries the same facts as the
  * `source-parse-degraded` entry in `workspace_diagnostics[]` for that file,
- * so a consumer can act on the gate without a join.
+ * so a consumer can act on the gate without a join. With `reason` set, the
+ * count and the parser outcome are placeholders.
  */
 export interface GateFile {
 /**
@@ -1992,14 +2077,19 @@ export interface GateFile {
  */
 path: string
 /**
- * The number of parser errors for the file.
+ * The number of parser errors for the file. `1` when `reason` is set.
  */
 error_count: number
 /**
  * True when the parser stopped in the file instead of recovering, so the
- * analysis saw only the part before the error.
+ * analysis saw only the part before the error. `true` when `reason` is set.
  */
 panicked: boolean
+/**
+ * Why the file counts when it is not a parser error. Absent for a parser
+ * error, the only reason before this field existed.
+ */
+reason?: (GateFileReason | null)
 }
 /**
  * Metric and rule definitions emitted under `_meta` when `--explain` is
@@ -3378,12 +3468,13 @@ _meta?: (Meta | null)
  *
  * - workspace discovery, at config load: `undeclared-workspace`,
  *   `malformed-package-json`, `glob-matched-no-package-json`,
- *   `workspace-glob-outside-root`, `malformed-tsconfig`,
+ *   `workspace-glob-outside-root`, `workspace-pattern-dir-missing`,
+ *   `nested-project-root`, `malformed-tsconfig`,
  *   `tsconfig-reference-dir-missing`;
  * - source discovery, during the file walk: `skipped-large-file`,
  *   `skipped-minified-file`, `skipped-source-dotdir`,
  *   `excluded-by-default-ignore`, `source-read-failure`,
- *   `source-parse-degraded`;
+ *   `source-parse-degraded`, `source-nesting-too-deep`;
  * - dead-code analysis, from the dependency-catalog and override
  *   detectors: `malformed-pnpm-workspace-yaml`,
  *   `bun-lockb-override-resolution-skipped`;
@@ -3402,10 +3493,11 @@ _meta?: (Meta | null)
  *
  * A diagnostic here is advisory and never withholds a finding. Where an
  * entry reports a source file this run never fully analyzed
- * (`source-parse-degraded`, `source-read-failure`, `skipped-large-file`,
- * `skipped-minified-file`, `skipped-source-dotdir`) it can distort a
- * verdict, so the affected `unused_files[]`, `unused_exports[]`, and
- * dependency entries additionally carry the caveat themselves in their own
+ * (`source-parse-degraded`, `source-nesting-too-deep`,
+ * `source-read-failure`, `skipped-large-file`, `skipped-minified-file`,
+ * `skipped-source-dotdir`) it can distort a verdict, so the affected
+ * `unused_files[]`, `unused_exports[]`, and dependency entries
+ * additionally carry the caveat themselves in their own
  * optional `reachability_caveats[]` array, and a reader who never scrolls
  * back up to this list still sees it. `fallow fix` reads the same array
  * and withholds the removal while a caveat stands.
@@ -7939,9 +8031,17 @@ line: number
  */
 col: number
 /**
- * Cyclomatic complexity of the function.
+ * Cyclomatic complexity of the function, as the cyclomatic gate and the
+ * CRAP score read it. Under the `literal-membership` value of
+ * `health.cyclomaticPolicy`, this is the value after literal membership
+ * chains count as one predicate.
  */
 cyclomatic: number
+/**
+ * Standard `McCabe` cyclomatic complexity, present only when the
+ * `health.cyclomaticPolicy` value gave `cyclomatic` a different value.
+ */
+standard_cyclomatic?: (number | null)
 /**
  * Cognitive complexity of the function.
  */
@@ -7985,7 +8085,9 @@ severity: FindingSeverity
  * `overrides[].rules` entries: `error` fails the run, `warn` does not.
  * The most severe rule of the kinds in `exceeded` wins. It is separate
  * from the band in `severity`, which ranks the finding and does not gate
- * it. Absent in reports from older versions.
+ * it. Under `audit --gate new-only`, a finding that exceeds only CRAP
+ * from estimated coverage has `warn`. Absent in reports from older
+ * versions.
  */
 effective_severity?: (EffectiveSeverity | null)
 /**
@@ -8048,10 +8150,33 @@ actions: HealthFindingAction[]
 /**
  * Audit-mode flag indicating whether the finding is new versus the base
  * snapshot. A complexity finding is new when no base finding has the same
- * path and function name, or when a metric that it exceeds has a higher
- * value than in that base finding.
+ * path and function name, when a grown metric exceeds a threshold that
+ * the base finding did not exceed, or when the growth of an exceeded
+ * metric moves it to a higher severity tier. A CRAP score from estimated
+ * coverage, or a CRAP score that the base finding does not have, is not
+ * growth.
  */
 introduced?: (boolean | null)
+/**
+ * Audit-mode class of the finding against the base snapshot:
+ * `introduced`, `worsened` or `inherited`. A worsened finding matches a
+ * base finding, is not introduced, and has a higher value in at least one
+ * measured metric. Absent outside an audit with a base snapshot.
+ */
+attribution?: (AuditFindingAttribution | null)
+/**
+ * Audit-mode list of the measured metrics that are higher than in the
+ * matched base finding, with the base value and the head value. Present
+ * on a worsened finding, and on an introduced finding that matches a base
+ * finding. Absent when no metric grew.
+ */
+worsened_metrics?: WorsenedMetric[]
+/**
+ * Audit-mode reason why the finding does not gate the verdict. With
+ * `test-file`, the finding is in a test file and `effective_severity` is
+ * `warn`. Absent outside `audit`, and on a finding that gates.
+ */
+gate_exemption?: (AuditGateExemption | null)
 }
 /**
  * Per-component React hook profile derived from the cached `hook_uses` IR at
@@ -8232,6 +8357,15 @@ weight: number
  * consumer explain a cognitive `+3` as "+1 base, +2 nesting".
  */
 nesting: number
+/**
+ * This cyclomatic `||` increment is part of a literal membership chain:
+ * strict equality checks of one identifier against primitive literals
+ * (`kind === "a" || kind === "b"`). The `literal-membership` value of
+ * `health.cyclomaticPolicy` removes these increments from the effective
+ * cyclomatic value. Omitted when `false`, and always `false` under the
+ * default `standard` policy.
+ */
+literal_membership?: boolean
 }
 /**
  * Resolved thresholds used to evaluate a health finding.
@@ -8323,6 +8457,21 @@ placement?: (string | null)
  */
 target_path?: (string | null)
 }
+/**
+ * One measured metric that is higher at head than in the matched base
+ * finding.
+ */
+export interface WorsenedMetric {
+metric: WorsenedMetricKind
+/**
+ * Value in the matched base finding.
+ */
+base: number
+/**
+ * Value in the head finding. Always higher than `base`.
+ */
+head: number
+}
 /**
  * Summary statistics for the health report.
  */
@@ -8347,6 +8496,11 @@ functions_above_threshold: number
  * Global cyclomatic-complexity ceiling for this run.
  */
 max_cyclomatic_threshold: number
+/**
+ * Cyclomatic policy of the gates (`health.cyclomaticPolicy`). Absent
+ * under the default `standard` policy.
+ */
+cyclomatic_policy?: (CyclomaticPolicy | null)
 /**
  * Global cognitive-complexity ceiling for this run.
  */
@@ -12178,6 +12332,13 @@ star_export_ambiguity?: (StarExportAmbiguity | null)
  * Re-export chains that pass through this export.
  */
 re_export_chains: ReExportChain[]
+/**
+ * The framework plugin rules that mark this export as used. The
+ * framework calls or reads the export, so no import is necessary. A
+ * credit sets `is_used` when the file is reachable. Absent when no
+ * plugin credits the export.
+ */
+plugin_credits?: PluginExportCredit[]
 /**
  * Human-readable reason summary.
  */
@@ -12270,6 +12431,19 @@ exported_as: string
  */
 reference_count: number
 }
+/**
+ * A framework plugin rule that marks an export as used.
+ */
+export interface PluginExportCredit {
+/**
+ * The plugin that gives the rule, for example `nextjs`.
+ */
+plugin: string
+/**
+ * The project-relative file pattern of the rule.
+ */
+pattern: string
+}
 /**
  * Result of tracing a class / enum / store MEMBER: the `--trace FILE:NAME`
  * fallback when `NAME` is not a top-level export but a member declared on one
@@ -12389,6 +12563,11 @@ reference_count: number
  * Files that reference this export.
  */
 referenced_by: ExportReference[]
+/**
+ * The framework plugin rules that mark this export as used. Absent when
+ * no plugin credits the export.
+ */
+plugin_credits?: PluginExportCredit[]
 }
 /**
  * A re-export with source information.
@@ -16650,12 +16829,13 @@ _meta?: (Meta | null)
  *
  * - workspace discovery, at config load: `undeclared-workspace`,
  *   `malformed-package-json`, `glob-matched-no-package-json`,
- *   `workspace-glob-outside-root`, `malformed-tsconfig`,
+ *   `workspace-glob-outside-root`, `workspace-pattern-dir-missing`,
+ *   `nested-project-root`, `malformed-tsconfig`,
  *   `tsconfig-reference-dir-missing`;
  * - source discovery, during the file walk: `skipped-large-file`,
  *   `skipped-minified-file`, `skipped-source-dotdir`,
  *   `excluded-by-default-ignore`, `source-read-failure`,
- *   `source-parse-degraded`;
+ *   `source-parse-degraded`, `source-nesting-too-deep`;
  * - dead-code analysis, from the dependency-catalog and override
  *   detectors: `malformed-pnpm-workspace-yaml`,
  *   `bun-lockb-override-resolution-skipped`;
@@ -16674,10 +16854,11 @@ _meta?: (Meta | null)
  *
  * A diagnostic here is advisory and never withholds a finding. Where an
  * entry reports a source file this run never fully analyzed
- * (`source-parse-degraded`, `source-read-failure`, `skipped-large-file`,
- * `skipped-minified-file`, `skipped-source-dotdir`) it can distort a
- * verdict, so the affected `unused_files[]`, `unused_exports[]`, and
- * dependency entries additionally carry the caveat themselves in their own
+ * (`source-parse-degraded`, `source-nesting-too-deep`,
+ * `source-read-failure`, `skipped-large-file`, `skipped-minified-file`,
+ * `skipped-source-dotdir`) it can distort a verdict, so the affected
+ * `unused_files[]`, `unused_exports[]`, and dependency entries
+ * additionally carry the caveat themselves in their own
  * optional `reachability_caveats[]` array, and a reader who never scrolls
  * back up to this list still sees it. `fallow fix` reads the same array
  * and withholds the removal while a caveat stands.
@@ -16715,10 +16896,12 @@ elapsed_ms: ElapsedMs
 /**
  * The verdict of every gate this run evaluated, keyed by name. The CLI
  * always emits it, with the default exit rule of each section that ran
- * (`error-severity-findings`, `health-findings`). Without
+ * (`error-severity-findings`, `health-findings`). A `coverage-gaps` rule
+ * at `error` adds `health-coverage-gaps`. Without
  * `--fail-on-issues` or `--ci`, the machine formats of the combined run
  * exit 0 for findings, so most entries have `enforced: false`. With one of
- * these flags, the findings rules and `duplication-threshold` are
+ * these flags, the findings rules, `health-coverage-gaps` and
+ * `duplication-threshold` are
  * `enforced`, the dupes section adds an enforced `duplication-findings`
  * entry, and every format exits 1 when one fails. For the default
  * exit rules (`error-severity-findings`,
@@ -16870,8 +17053,8 @@ total_flags: number
  * A flags run walks and parses the project like every other analysis, so
  * it records the same discovery kinds: a `skipped-large-file`,
  * `skipped-minified-file`, or `source-read-failure` file was never
- * scanned for flags, and a `source-parse-degraded` file was scanned from
- * a partial module. Each is a reason a flag can be missing from
+ * scanned for flags, a `source-parse-degraded` file was scanned from a
+ * partial module, and a `source-nesting-too-deep` file was not scanned. Each is a reason a flag can be missing from
  * `feature_flags[]`, which is exactly what a consumer reading a
  * zero-result run needs to know. The analysis-stage kinds appear here
  * too: the scan correlates flags with dead exports, so it runs the
@@ -19931,6 +20114,11 @@ function_line?: (number | null)
  * The 1-based execution rank of a planned mutant.
  */
 rank?: (number | null)
+/**
+ * The edit of the mutant, without project text. Absent in a report
+ * that an older version wrote.
+ */
+change?: (MutantChange | null)
 status: MutantStatus
 /**
  * The static rule of a `pruned` mutant, kebab-case.
@@ -19944,6 +20132,9 @@ prune_reason?: (string | null)
  * first failing test, and it runs the fastest covering test first, so a
  * second run on the same code can name another covering test. No
  * fingerprint or baseline comparison uses this field.
+ *
+ * The retry of a survivor also runs the other tests of its test files,
+ * so this test can be absent from `covering_tests`.
  */
 killed_by?: (string | null)
 /**
@@ -19970,6 +20161,13 @@ test_reach?: (MutantTestReach | null)
  * retry, because the time budget ended first.
  */
 retried?: boolean
+/**
+ * The runs that gave the status of a `retried` mutant: the first run,
+ * then the retry. Absent when the mutant got no retry, and absent for a
+ * `cached` mutant. Each duration is evidence of one run, so no
+ * fingerprint or baseline comparison uses this field.
+ */
+attempts?: MutantAttempt[]
 /**
  * True when the status comes from the result cache of an earlier run.
  * The mutant did not run in this run. `--no-cache` runs each mutant.
@@ -19981,6 +20179,25 @@ cached?: boolean
  */
 type_error_codes?: number[]
 }
+/**
+ * The edit of a mutant, without project text.
+ *
+ * Each side is an operator token (for example `??` or `<=`), a fixed literal
+ * (`true`, `undefined`, `""`, `"fallow"`, `void 0`), a regular expression
+ * token (`^`, `$`, `[`, `[^`, `\d`), or a placeholder for a side that is
+ * project code: `<condition>`, `<call>`, `<expression>` or `<string>`. An
+ * empty side means that the edit removes the token.
+ */
+export interface MutantChange {
+/**
+ * The token or placeholder before the edit.
+ */
+from: string
+/**
+ * The token or placeholder after the edit.
+ */
+to: string
+}
 /**
  * How tests reach the code of one mutant in the module graph. The class
  * gives a static reason why no test covers the mutant.
@@ -20009,6 +20226,30 @@ tests?: string[]
  */
 mocked_targets?: string[]
 }
+/**
+ * One run of a retried mutant.
+ */
+export interface MutantAttempt {
+status: MutantStatus
+/**
+ * The duration of this run in milliseconds. A watchdog timeout reports
+ * the wait of the watchdog.
+ */
+duration_ms?: (number | null)
+/**
+ * The test that killed the mutant in this run.
+ */
+killed_by?: (string | null)
+/**
+ * How the run detected the mutant. Absent for a run that did not detect
+ * it, and absent when the runner did not state the kind.
+ */
+failure_kind?: (MutantFailureKind | null)
+/**
+ * The first line of the reason of a `runtime_error` run.
+ */
+detail?: (string | null)
+}
 /**
  * The results of the mutants of one function.
  */
@@ -20364,6 +20605,11 @@ function_line?: (number | null)
  * The 1-based execution rank of a planned mutant.
  */
 rank?: (number | null)
+/**
+ * The edit of the mutant, without project text. Absent in a report
+ * that an older version wrote.
+ */
+change?: (MutantChange | null)
 disposition: MutationPlanDisposition
 /**
  * The static rule of a `pruned` mutant, kebab-case.
@@ -20425,6 +20671,11 @@ function_line?: (number | null)
  * The 1-based execution rank of a planned mutant.
  */
 rank?: (number | null)
+/**
+ * The edit of the mutant, without project text. Absent in a report
+ * that an older version wrote.
+ */
+change?: (MutantChange | null)
 /**
  * The status of the mutant in the report. Absent for a plan.
  */