github-ci-fixlisted

# GitHub CI Fix ## Overview Systematic workflow for debugging failing PR checks using `gh` CLI. Identifies GitHub Actions failures with logs, scopes external checks (Buildkite, etc.) as out-of-scope, then uses existing plan workflow for fixes. ## Prerequisites ```bash gh auth status # Required scopes: repo, workflow ``` **STOP if unauthenticated:** `gh auth login --scopes repo,workflow` ## Quick Reference | Task | Command | |------|---------| | Find current PR | `gh pr view --json number,url` | | Check PR status | `gh pr checks <pr>` | | View run details | `gh run view <run-id>` | | Get failed logs | `gh run view <run-id> --log-failed` | | Full run log | `gh run view <run-id> --log` | | Recent runs for this check | `gh run list --workflow <name> --branch <branch> --json conclusion,headSha,createdAt -L 20` | | Rerun without code changes (flakiness probe) | `gh run rerun <run-id> --failed` | ## Workflow ### 1. Verify Auth → 2. Find PR → 3. Inspect ```bash gh auth status # If fails: ask user to authenticate gh pr view --json number,url # Or use user-provided PR number gh pr checks <pr> # Shows check name, status, details URL ``` ### 4. Scope: GitHub Actions vs External **GitHub Actions** (`detailsUrl` has `/actions/runs/`): Pull logs, extract snippets, fix **External CI** (Buildkite, CircleCI): Report URL only, request user to share logs **STOP:** Do not attempt external CI log access. ### 4.5. Flaky or Real? Scope the Breaking Commit Before treating a failure