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

💡 feat: read build annotations from the CLI

Đang mở
  • Có gì không ổn?
#962 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 1 ngày

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

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
68/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ệ
go
Lĩnh vực
api, cli

Hướng nghiên cứu

Bắt đầu bằng cách kiểm tra các lệnh list hiện có và hành vi của bk job log, sau đó so sánh các quy ước của chúng với REST endpoint của annotations. Triển khai bk annotation list <build-number> -p <pipeline> với đầu ra JSON, --no-pager, phân giải pipeline, lọc theo style và lập ngân sách token cho agent; hoàn tất khi có thể truy xuất annotations mà không cần sử dụng trực tiếp bk api.

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

Mô tả

Is your feature request related to a problem?

There is no way to read build or job annotations from the CLI. bk --help on 3.55.0 lists no
annotation subcommand, and no existing command surfaces them.

Annotations are where most pipelines put the human-readable version of a failure — the test
summary table, the lint diff, the "here is what broke and where" block that a buildkite-agent annotate call emits precisely so a person does not have to read the raw log. Losing that in
the CLI means falling back to the full job log for information the pipeline already
summarised.

The REST API exposes them (GET /organizations/{org}/pipelines/{pipeline}/builds/{number}/annotations),
and the official MCP server exposes list_annotations, so this is a CLI surface gap rather
than a missing capability.

Describe the solution you'd like.

bk annotation list <build-number> -p <pipeline>, following the conventions the other list
commands already use — JSON by default, --no-pager, and honouring the same -p resolution.

Two things that would make it substantially more useful for the agent-oriented direction the
CLI is already heading in:

  • Filter by style: --style error,warning — an agent triaging a failure wants the error
    annotations, not the informational ones.
  • Participate in --agent / --max-tokens the way bk job log now does, since annotation
    bodies can be large.
Describe alternatives you've considered.

bk api can reach the endpoint directly, but that gives up the org/pipeline resolution,
output formatting, and token budgeting that the rest of the CLI provides, and it means
hand-constructing the path. It works as a workaround, not as the answer.

Additional context

Version bk 3.55.0.

Ngôn ngữ chính
Go
Star
206
Fork
73
Merge trung bình
13 giờ 46 phút
Pull request đã merge (30 ngày)
50

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 buildkite/cli

Tất cả issue của buildkite/cli

Issue tương tự

Thêm issue về Go

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.