Enum FallowOutput 

pub enum FallowOutput {
    Audit(AuditOutput),
    Explain(ExplainOutput),
    ReviewEnvelope(ReviewEnvelopeOutput),
    ReviewReconcile(ReviewReconcileOutput),
    CoverageSetup(CoverageSetupOutput),
    CoverageAnalyze(CoverageAnalyzeOutput),
    ListBoundaries(ListBoundariesOutput),
    Health(HealthOutput),
    Dupes(DupesOutput),
    CheckGrouped(CheckGroupedOutput),
    Check(CheckOutput),
    Combined(CombinedOutput),
}

Typed root of every fallow --format json envelope shape that serializes as a JSON object. The schema derived from this enum drives the document-root oneOf in docs/output-schema.json, replacing the previously hand-maintained block.

#[serde(untagged)] preserves wire compatibility: consumers see exactly the same top-level keys today (schema_version, version, plus the per-envelope shape). The schema’s oneOf lets agents narrow by trying variants in order; field sets differ enough that the first matching variant is the correct one in practice. Note that HealthOutput and DupesOutput flatten their inner body (HealthReport / DuplicationReport) into top-level fields, so the actual discriminators are nested-body keys such as health_score (health) and clone_groups (dupes), NOT report or groups.

Variant order is most-specific first. Schemars 1 preserves declaration order in the emitted oneOf, and validators that enforce strict oneOf (and any future migration that adds Deserialize) will try branches top-to-bottom. The required-field sets shrink as we move down the list, with CombinedOutput last because its three required fields (schema_version, version, elapsed_ms) are a strict subset of every other variant’s required set; placing it earlier would let a CheckOutput payload silently match CombinedOutput first.

One envelope is intentionally NOT in this enum:

• CodeClimateOutput serializes as a bare JSON array (#[serde(transparent)]) per the Code Climate / GitLab Code Quality spec; #[serde(tag = ...)] cannot internally tag a non-object variant and wrapping the array would break the spec. The root schema carries it as a sibling oneOf branch alongside FallowOutput.

A future major release plans to switch this to #[serde(tag = "kind")] for true O(1) discriminability on AI / agent consumers, paired with a one-cycle --legacy-envelope opt-out flag. Tracked under issue #384.

Variants

Audit(AuditOutput)

fallow audit --format json. Required command: "audit" singleton plus verdict and summary.

Explain(ExplainOutput)

fallow explain <issue-type> --format json. Required id, name, rationale, example, how_to_fix, docs; no schema_version.

ReviewEnvelope(ReviewEnvelopeOutput)

fallow --format review-github / --format review-gitlab. Required body, comments, meta; no schema_version.

ReviewReconcile(ReviewReconcileOutput)

fallow ci reconcile-review --format json. Required schema singleton plus provider, comments, and the various *_fingerprints arrays.

CoverageSetup(CoverageSetupOutput)

fallow coverage setup --json. Required schema_version singleton plus framework_detected, members, commands, snippets.

CoverageAnalyze(CoverageAnalyzeOutput)

fallow coverage analyze --format json. Required schema_version: "1" singleton plus version, elapsed_ms, runtime_coverage. The runtime_coverage discriminator field is uniquely present here; ordered before broader variants so untagged narrowing matches CoverageAnalyzeOutput first.

ListBoundaries(ListBoundariesOutput)

fallow list --boundaries --format json. Required boundaries sub-object; no schema_version.

Health(HealthOutput)

fallow health --format json. Required report: HealthReport.

Dupes(DupesOutput)

fallow dupes --format json. Required report: DupesReportPayload (typed wrapper payload carrying clone_groups[]: CloneGroupFinding and clone_families[]: CloneFamilyFinding).

CheckGrouped(CheckGroupedOutput)

fallow check --format json --group-by <mode>. Required grouped_by plus a groups array; ordered before Self::Check because the grouped_by discriminator field is uniquely present here.

Check(CheckOutput)

fallow check --format json / fallow dead-code --format json. Required total_issues plus summary: CheckSummary.

Combined(CombinedOutput)

Bare fallow --format json (combined dead-code + dupes + health). LAST because its required-field set (schema_version, version, elapsed_ms) is a strict subset of every other variant’s required set; placing it earlier would let untagged narrowing match a CheckOutput payload against CombinedOutput first.

Trait Implementations

impl Clone for FallowOutput

fn clone(&self) -> FallowOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FallowOutput

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

Formats the value using the given formatter.

impl Serialize for FallowOutput

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

where __S: Serializer,

Serialize this value into the given Serde serializer.