Fallout-build / Fallout-build/Fallout
Durable run summary on disk plus semantic exit codes
- Dominant language
- C#
- Stars
- 154
- Forks
- 19
- Avg merge
- 1d 22h
- Merged PRs (30d)
- 15
Description
### Problem
A run's result exists only as console text. Once the terminal buffer is gone, or when the caller is a program that did not capture stdout, there is no way to find out what happened except to run the build again. Exit codes are coarse as well: a restore failure, a compile error, and a failing test are indistinguishable to the caller.
### Outcome
Every run leaves a machine-readable record on disk, and the exit code says what class of failure occurred.
- A summary at a known path (proposal: `.fallout/last-run.json`) with per-target status, duration, the diagnostics that target produced, and the artifacts it wrote.
- Diagnostics carry a stable identity — severity, code, file, line, message — rather than prose.
- Distinct exit codes per failure class, documented and stable.
### Acceptance criteria
- [ ] Every run writes a schema-versioned summary to a known path, including runs that fail
- [ ] Each failed target names the tool invocation that failed and the diagnostics it produced
- [ ] Diagnostics carry code, file, and line wherever the underlying tool reports them
- [ ] Exit codes distinguish at least: success, target failure, build-project load failure, invalid arguments, unmet tool requirement
- [ ] The exit-code table is documented and covered by tests
### Notes
This complements #391 (Serilog event core plus NDJSON machine path), which covers the live event stream but not a durable artifact or exit codes. `.fallout/temp` is already cached by every CI workflow, so a sibling path needs no new workflow plumbing.
Contributor guide
Assessment
This issue has not been assessed yet.