CLI exit codes in CI

Gate a pipeline on the evidence report without executing a replay.

Back to overview

Command

node src/cli.mjs fixtures/missing-data/post-write-timeout-reconcile.json
echo $?   # 3 — unknown / reconcile_required

Exit codes

CodeStatusMeaning
0passreplay_safe / replay_stored — safe to proceed
2failbrake / reject_conflict — an unsafe condition was detected
3unknownreconcile_required — safety cannot be determined without reconciliation
1unverifiedmalformed input — the request could not be evaluated

A CI job that must not ship an uncertain write should fail on exit 3 as well as exit 2. Exit 0 is the only proceed signal.

Next

Full field list: contract reference.