Fallout-build / Fallout-build/Fallout

Durable run summary on disk plus semantic exit codes

Open
#643 1 comment 0 reactions 0 assignees View on GitHub
enhancement target/backlog
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.