|
| 1 | +# Change Contract: GitHub Actions Node 24 Runtime |
| 2 | + |
| 3 | +## Summary |
| 4 | + |
| 5 | +Move official checkout and Python setup actions to their Node 24 runtime |
| 6 | +majors after GitHub began warning that the previous actions depended on the |
| 7 | +retired Node 20 runner runtime. |
| 8 | + |
| 9 | +## Scope |
| 10 | + |
| 11 | +Expected changes: |
| 12 | + |
| 13 | +- official action major references under `.github/workflows/`; |
| 14 | +- the golden baseline hash for `industrial_guardian.yml`; |
| 15 | +- this reviewed change contract. |
| 16 | + |
| 17 | +Out of scope: |
| 18 | + |
| 19 | +- product Python versions and dependency matrices; |
| 20 | +- Chronolith runtime, cryptography, CLI and package behavior; |
| 21 | +- release publishing or credential policy; |
| 22 | +- ICHIRO and every visual asset. |
| 23 | + |
| 24 | +## Reason |
| 25 | + |
| 26 | +GitHub-hosted runs completed successfully but emitted deprecation warnings for |
| 27 | +`actions/checkout@v4` and `actions/setup-python@v5`. The official succeeding |
| 28 | +majors use Node 24 and support the current hosted runner version. |
| 29 | + |
| 30 | +## Risk |
| 31 | + |
| 32 | +Risk level: low. |
| 33 | + |
| 34 | +Potential failure modes: |
| 35 | + |
| 36 | +- a changed action input contract; |
| 37 | +- runner incompatibility; |
| 38 | +- cache behavior drift; |
| 39 | +- an unreviewed governance baseline change. |
| 40 | + |
| 41 | +## Verification |
| 42 | + |
| 43 | +Required checks: |
| 44 | + |
| 45 | +```text |
| 46 | +python scripts/health_guard.py --strict |
| 47 | +python scripts/golden_baseline.py verify |
| 48 | +python scripts/audit_all.py --install |
| 49 | +``` |
| 50 | + |
| 51 | +GitHub must also complete the full Industrial Guardian matrix on the exact PR |
| 52 | +head without Node 20 action-runtime warnings. |
| 53 | + |
| 54 | +## Rollback |
| 55 | + |
| 56 | +Revert the action-major commit and this contract, then refresh the golden |
| 57 | +baseline using an explicit rollback contract. No history rewrite is required. |
| 58 | + |
| 59 | +## Handoff |
| 60 | + |
| 61 | +Record the exact PR head, CI result and any remaining GitHub annotations before |
| 62 | +promotion to `main`. |
| 63 | + |
| 64 | +## Baseline Refresh |
| 65 | + |
| 66 | +This contract approves: |
| 67 | + |
| 68 | +```text |
| 69 | +python scripts/golden_baseline.py refresh --contract docs/change-contracts/2026-08-01-actions-node24-runtime.md |
| 70 | +``` |
0 commit comments