{
  "slug": "bk-build-annotations-lists-build-and-job-annotations-ad620e411ce8",
  "title": "bk build annotations lists build and job annotations",
  "tools": [
    "bk"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-10-20T22:17:17.000Z",
  "announced_at": "2026-10-20T22:17:17.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When inspecting or scripting against annotations for a Buildkite build, run `bk build annotations` with a build number, qualified selector, or Buildkite build URL. Add `--pipeline` if pipeline inference is ambiguous, then choose a text, JSON, or YAML output format.",
    "examples": [
      "bk build annotations 123 --pipeline <pipeline> --json",
      "bk build annotations <org>/<pipeline>/123 --text",
      "bk build annotations <buildkite-build-url> --yaml"
    ],
    "gotchas": [
      "Version: v3.64.2",
      "build argument (required): Build number, `<org>/<pipeline>/<number>` selector, or Buildkite build URL.",
      "--pipeline, -p: Pipeline slug or `<org>/<pipeline>`; inferred from configuration or repository if omitted. Use when inference is ambiguous.",
      "--json: Output as JSON.",
      "--yaml: Output as YAML.",
      "--text: Output as text.",
      "--output, -o: Select `json`, `yaml`, or `text`; the format flags are mutually exclusive with each other.",
      "Prerequisite: An authenticated Buildkite CLI configuration; targeting another organization requires credentials for that organization.",
      "Prerequisite: The token must have the `read_builds` scope.",
      "Requires the `read_builds` token scope.",
      "JSON/YAML never prompts for pipeline selection; specify `--pipeline` when inference is ambiguous.",
      "Qualified selectors use the target organization's credentials.",
      "Annotation bodies are rendered HTML, not original Markdown; text output also preserves HTML.",
      "Errors, including a failed later page, return a nonzero exit status with no partial results on stdout."
    ]
  },
  "why_it_matters": "Inspect or script against annotations attached to a Buildkite build.",
  "before": "Annotations were available inside `bk build view`; there was no standalone command to retrieve them for inspection or scripting.",
  "sources": [
    "https://github.com/buildkite/cli/releases/tag/v3.64.2",
    "https://github.com/buildkite/cli/pull/1051",
    "https://github.com/buildkite/cli/blob/v3.64.2/cmd/build/annotations.go",
    "https://github.com/buildkite/cli/blob/v3.64.2/pkg/output/flags.go",
    "https://github.com/buildkite/cli/blob/v3.64.2/README.md"
  ],
  "rank": 0.98032,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "daily-20261026-04",
    "verdict_id": "daily-20261026-04:daily-20261026-04-c6a48706f49c7374-2:gate",
    "evidence_hash": "9514c8805d925d463a66cf298230f5dfd0eaa11dd8da5d6a620f1a3220b0782b"
  },
  "review": {
    "draft_hash": "c6c7e50479b94bd657b8a026fcec0e4b3828bbfe1c4b47b469b488f81159a463",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-20T22:17:17.000Z",
    "decision": "daily-20261026-04:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.84 (>= 0.6 needed)."
  }
}