Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Durable run summary on disk plus semantic exit codes

Đang mở
  • Có gì không ổn?
#643 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 5 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
38/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
csharp
Lĩnh vực
build-system, cli

Hướng nghiên cứu

Bắt đầu bằng việc đọc #391 để hiểu event core hiện có của Serilog và machine path của NDJSON, sau đó kiểm tra các CI workflow nơi .fallout/temp được cache. Xác định schema cho .fallout/last-run.json, các trường chẩn đoán ổn định và bảng exit-code; được xem là hoàn tất khi mỗi lần chạy đều ghi summary có version và các test bao phủ tất cả các lớp lỗi được liệt kê.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement target/backlog
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.

Ngôn ngữ chính
C#
Star
169
Fork
21
Merge trung bình
3 ngày 7 giờ
Pull request đã merge (30 ngày)
9

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Fallout-build/Fallout

Tất cả issue của Fallout-build/Fallout

Issue tương tự

Thêm issue về C#

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.