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

Epic: AI-native build interface — make the build model and run results machine-readable

Đang mở
  • Có gì không ổn?
#648 0 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
25/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
csharp
Lĩnh vực
build-system, tooling

Hướng nghiên cứu

Bắt đầu bằng cách đọc Build.cs và trình phân giải plan hiện có, cùng các tham chiếu đến ExecutableTarget, Parameter, Host.WriteTargetOutcome và Host.WriteBuildOutcome được nêu trong issue. Sau đó xem lại các issue #642, #643, #644, #647 và #646 để hiểu các khả năng và phần phụ thuộc được theo dõi riêng. Hoàn tất có nghĩa là model có thể đọc được bằng máy, bản tóm tắt lần chạy, effects, caching và phần việc MCP của milestone được phối hợp mà không trùng lặp #391, #104 hoặc #156.

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

Fallout already holds a complete model of a build in memory. The plan resolver walks the dependency graph, ExecutableTarget carries per-target status and tool requirements, and [Parameter] declares typed inputs with defaults. None of that is reachable as data.

Everything leaves the process as human-oriented console text through Host.WriteTargetOutcome and Host.WriteBuildOutcome. A caller that is a program rather than a person has to infer the build from Build.cs and guess at results by pattern-matching a large log. That is slow, expensive in tokens for an AI consumer, and easy to get confidently wrong — reporting "tests failed" when restore was what actually failed.

Outcome

A machine consumer can ask Fallout three questions and get answers as data:

  • What can this build do?
  • What would this run do?
  • What did this run do?

Plus two capabilities that make automated use safe and fast enough to be worth having: declared target effects, and target-level caching.

Scope
Capability Issue
Build model as data: describe --json, plan --json #642
Durable run summary plus semantic exit codes #643
Declared target effects, gated at plan time #644
Content-addressed target caching #647
MCP server as a standalone product #646

The MCP server is deliberately last. It is a thin layer over #642 (the build model as data) and #643 (the durable run summary), and building it first would mean screen-scraping the console output this milestone exists to replace.

Already tracked elsewhere

Structured console output is covered and is not re-filed here:

  • #391 (Serilog event core, Spectre console frame, NDJSON machine path) — the streaming half, with a concrete task list
  • #104 (AI-friendly terse and structured output modes) — the output-mode design and its open questions
  • #156 (IOutputSink extension point) — the plugin extension point these land on
Notes

Every item in this milestone is a serialisation of, or a gate on, a model the engine already has. None of them needs a new execution engine. Dogfooding them also pressure-tests the IOutputSink and related extension points before the plugin SDK (milestone #7) makes those shapes public API.

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.