docs: add CI triage guide (issue #219)#279
Open
mvillmow wants to merge 4 commits into
Open
Conversation
mvillmow
commented
Jun 20, 2026
mvillmow
left a comment
mvillmow
left a comment
Contributor
Author
There was a problem hiding this comment.
Doc-only deliverable correct; both prior review threads resolved; src/tests changes are formatter-forced churn. One minor: unverified commit SHA in runbook footnote.
Investigation of issue #219 found three 'Set up job' failures (runs 24940322404, 24940042318, 24935454744) were due to an invalid pixi action SHA that was corrected ~1 month ago in commit 87dc30e. Recent runs show all passing. This is Route A (no repo-side defect found, failures transient). The triage guide documents the three-check audit (permissions, runner labels, secrets) for future 'Set up job' infrastructure failures and the escalation path for GitHub Support. Investigation summary: - Pattern analysis: 2 failures in last 20 runs (≤3 = isolated) ✓ - Permissions audit: no permissions block (OK for standard GitHub runners) ✓ - Runner labels: both ubuntu-latest (standard) ✓ - Secrets references: none in workflow ✓ - Root cause of original 3 failures: invalid prefix-dev/setup-pixi SHA (fixed) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> Signed-off-by: mvillmow <4211002+mvillmow@users.noreply.github.com>
- Replace `\s*` with `[[:space:]]*` in the secrets grep/sed commands so the runbook works on macOS/BSD grep, not just GNU grep - Fix fabricated citation: PR #244 / v0.9.6 → PR #235 / v0.9.5 (the actual setup-pixi bump per git history) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> Signed-off-by: mvillmow <4211002+mvillmow@users.noreply.github.com>
Remove temporary investigation file for CI 'Set up job' failure. The investigation concluded this is a runner infrastructure issue (not a code defect), documented in docs/ci-triage.md. Closes #219 Implemented-By: claude-sonnet-4-6 Co-Authored-By: Claude Code <noreply@anthropic.com> Signed-off-by: mvillmow <4211002+mvillmow@users.noreply.github.com>
GHSA-4xgf-cpjx-pc3j) Signed-off-by: Micah Villmow <4211002+mvillmow@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Investigation of issue #219 reveals the three reported 'Set up job' failures (runs 24940322404, 24940042318, 24935454744) were caused by an invalid pixi action SHA that was corrected ~1 month ago in commit 87dc30e. Recent CI runs (last 20) show the pattern is now resolved: 18 passing, 2 recent failures on a different cause (Install pixi step, unrelated to "Set up job").
This is Route A: No repo-side defect found, failures transient.
Investigation Evidence
Pattern Analysis
Workflow Audit (Three Checks)
.github/workflows/ci.yml— standard GitHub-hosted runners don't require one ✓ubuntu-latest(standard label) ✓${{ secrets.* }}references in workflow ✓Root Cause of Original 3 Runs
prefix-dev/setup-pixi@b4fa1ac3900b5ac04b5b07ec9a7a7fe9d90c5258"Fix applied: Commit 87dc30e ("fix(ci): correct setup-pixi SHA pin to valid v0.8.1 commit (#221)") corrected the invalid SHA. Subsequent Dependabot PRs (#244, #258) bumped to v0.9.6 with valid SHAs.
Current main branch:
prefix-dev/setup-pixi@5185adfbffb4bd703da3010310260805d89ebb11(v0.9.6) — valid and passing ✓Deliverable
This PR adds
docs/ci-triage.md— a triage runbook for future "Set up job" and pre-checkout failures. The guide covers:needs-github-supportlabel)Added link from
CLAUDE.mdto the triage guide.Closes #219