Skip to content
Fallow home
All docs pages

Docs home

Exit codes

Find the exit codes of fallow: the codes that each command shares and the codes that one command defines.

Each fallow command exits with one of these codes. Findings explains the gates that set code 1.

Shared exit codes

CodeNameMeaning
0successSuccess: no enforced gate failed. Bare fallow in a machine format (json, sarif, codeclimate, the GitHub formats, the comment and review formats) does not enforce findings without --fail-on-issues, so it exits 0 on findings. Read gate_outcomes: status "fail" with enforced false is a failing gate that did not set the exit code.
1gate-failedAn enforced gate failed, for example error-severity findings (per rules config, or --fail-on-issues promotes warn to error). This is an analysis result, not a tool failure.
2invalid-inputInvalid input or an execution error, for example an invalid config. With --format json, fallow writes the error to stdout as a JSON object with error true, a message and the exit_code.
3resource-unavailableRequested resource unavailable: config --path found no config, or a license is missing, invalid, or beyond its offline hard-fail window.
4runtime-coverage-sidecarThe runtime coverage add-on is unavailable, unverifiable, protocol-incompatible, or stopped unexpectedly.
5runtime-coverage-inputRuntime coverage input could not be prepared or parsed.
6runtime-coverage-internalThe runtime coverage add-on reported an internal error.
7network-failureNetwork or cloud request failed during a license, coverage, or CI operation.
8security-gateSecurity gate matched a candidate selected by --gate.
10coverage-upload-validationCoverage inventory or static-findings upload input or project validation failed.
11coverage-upload-payload-too-largeCoverage inventory or static-findings upload exceeded the server payload limit.
12coverage-upload-auth-rejectedCoverage inventory or static-findings upload authentication or authorization was rejected.
13coverage-upload-server-errorCoverage inventory or static-findings upload failed after retries or returned another server error.

Exit codes of one command

These commands define the codes in their own table. A code that a table does not list keeps its shared meaning.

fallow mutation

CodeNameMeaning
1min-score--min-score or mutation.minScore is set, and the mutation score is lower. Survivors alone do not fail a run.
2invalid-inputInvalid input or an execution error, for example a dirty worktree without --allow-dirty, a missing runner, or a run in which baseline failures leave each mutant without a test result.

fallow coverage setup

CodeNameMeaning
1wait-timeout--cloud --wait timed out before every setup step was done.

fallow coverage upload-source-maps

CodeNameMeaning
1upload-incompleteAt least one source map was not uploaded. The summary on stderr names each failed map. With --fail-fast, the command stops at the first failed map.