{
  "slug": "eas-checkout-accepts-a-ref-input-fdc9782c8a29",
  "title": "eas/checkout accepts a ref input",
  "tools": [
    "eas"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-03T19:40:56.000Z",
  "announced_at": "2026-08-03T19:40:56.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a workflow job needs to run against a Git ref other than the triggering ref, set `ref` on its first `eas/checkout` step to the desired branch, tag, or full commit SHA.",
    "examples": [
      "jobs:\n  <job_id>:\n    steps:\n      - uses: eas/checkout\n        with:\n          ref: <branch_tag_or_full_commit_sha>"
    ],
    "gotchas": [
      "Version: v21.5.0",
      "ref: Git branch, tag, or full commit SHA to check out. Defaults to the ref that triggered the build or workflow job. Must be set on the job's first `eas/checkout` step.",
      "Prerequisite: Project sources must come from a Git repository, such as a job triggered through the GitHub integration; local builds and uploaded project tarballs do not support `ref`.",
      "Prerequisite: The requested ref must be reachable from the source repository's `origin`; checkout uses a shallow fetch (`--depth 1`).",
      "The `ref` input selects a branch, tag, or commit SHA."
    ]
  },
  "why_it_matters": "Run a build job against a branch, tag, or commit other than the ref that triggered the job.",
  "sources": [
    "https://github.com/expo/eas-cli/releases/tag/v21.5.0",
    "https://docs.expo.dev/eas/workflows/syntax/"
  ],
  "rank": 0.95028,
  "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": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-61bfc06a63e1bd44-2:gate",
    "evidence_hash": "eefbc43b658cd8f2db9fd77a1a8ccb3af3a98d9c70106be1b187a7d8bdc228eb"
  },
  "review": {
    "draft_hash": "7a010103c6cb79f2ac088a9d96d72a7308ddd8bdc21f1177506669a162dfe6b9",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.95 >= 0.9; 2 needed) and Jev gave 0.71 (>= 0.6 needed)."
  }
}