diff --git a/.github/workflows/main-estate-audit.yml b/.github/workflows/main-estate-audit.yml index 9a16a26..793d4f0 100644 --- a/.github/workflows/main-estate-audit.yml +++ b/.github/workflows/main-estate-audit.yml @@ -22,7 +22,31 @@ jobs: # a snapshot that is already stale (cicd-suite has since replaced # zig-hexadeca-check with zig-unified-api-adapter-check). # - # The SHA below is cicd-suite main as of 2026-09-21 and is the head of a - # green run of that workflow. Re-pin when the gate set changes. + # The SHA below is cicd-suite main as of 2026-09-22. Choosing it is necessary + # and NOT sufficient, and the reason is the whole point of this comment. + # + # That reusable invokes its 26 gates by BRANCH ref: + # + # uses: hyperpolymath/cicd-suite/actions/@main + # + # Under gh-actions-lock a branch ref is trusted from the lockfile, and the + # runner executes THE COMMIT THE LOCKFILE NAMES, not the branch tip. So the + # gates this repo actually runs are chosen by cicd-suite's actions.lock AT + # THE SHA BELOW -- not by the SHA below. + # + # Measured, not assumed. Pinning 0c1bc9f (the head of a run whose `Gate + # controls` job executed 14 steps) left this audit dying EXACTLY as before: + # run 35787980954, Required Files Gate, 82ms, silent exit 1, 25 gates + # skipped. The lock at 0c1bc9f still pinned cicd-suite@main at 9adb3908 -- + # four commits stale, carrying ZERO of the harness `-e` guards. The cure had + # merged and reached nobody. + # + # 6cb08dd is cicd-suite#35, which re-pinned that entry at 0c1bc9f (3 guards + # in required-files-check, 1 in spdx-license-check; 9adb3908 had 0 and 0). + # + # When re-pinning: check the LOCK at the candidate SHA, not the SHA's own + # tree, and check the STEP COUNT, not the square. cicd-suite#35 added + # tests/lock-transitive-closure.sh so that drift goes red there rather than + # silently here. call-estate-audit: - uses: hyperpolymath/cicd-suite/.github/workflows/main-estate-audit.yml@3b4afafa969103279ee580572626a175ec9dc0d0 + uses: hyperpolymath/cicd-suite/.github/workflows/main-estate-audit.yml@6cb08dde98b70d20ad2d506e77dd6a517503eb08