docs(release): document automatic PR healer - #951
Merged
Conversation
Replace the superseded per-run rerun ritual with the automatic Release PR checks path proven on #948. Record the non-empty check rollup as the healthy state, point empty-rollup diagnosis at the healer workflow, and keep release completion gated on the later tag and attestation receipt. Gate-Passed: kanon 0.1.0
forkwright
commented
Aug 26, 2026
forkwright
left a comment
OwnerAuthor
There was a problem hiding this comment.
APPROVE — exact-head review
Reviewed merge head a2b797ae69e1cf188acb2407dac4031830163bb7 against strict base 1d6e812e8b6d4bd0dd531cab5791ce65dbb6e245. GitHub cannot attach a formal approval because the authenticated reviewer is also the PR author, so this comment records the explicit semantic verdict.
No findings.
- Merge provenance is exact. The head parents are authored
f1b1c2e4fedf3a28949a60a341c252bd88fdc794and base1d6e812e8b6d4bd0dd531cab5791ce65dbb6e245, with common ancestor4680d75c373149671db25518f3b0492e4077f10c. Relative to base, the head changes onlyCONTRIBUTING.md; relative to the authored parent, it adds only #950s.github/workflows/ci.ymldelta. Both files are byte-identical to their owning parent, and a freshgit merge-tree --write-treeproduced the heads exact tree4b4342078c04489d6d4a2fd6e2a832cd1dc5a492, proving there is no hidden conflict-resolution delta. - The healer description matches #930 and the automatic receipt. #930 installed the
workflow_runpath plus hourly backstop and the requiredactions: writepermission. Run 33015579668 fired asworkflow_runimmediately after Release Please run 33015547810, identified #948 atc187fde44, approved five held runs, and reported rollup0 -> 9; #948 now has a non-empty, terminal-green required-check rollup. - The normal path no longer advises manual reruns. The only fallback commands inspect
Release PR checksand failed logs; a repository search found no remaining release-PRgh run rerunritual. The documentedgh run list --workflow Release PR checksandgh run view --log-failedforms execute successfully. - Release completion remains correctly stricter than merging the release PR: confirm the tag, require the same Release Please runs
release-attestjob to succeed, require its source tarball plus both CycloneDX SBOM assets, then download the tarball and independently verify its default SLSA provenance withgh attestation verify ... --repo forkwright/thumos. Those requirements match.github/workflows/release-please.yml. - Required contexts are deliberately not copied into prose; current branch protection confirms
Dependabot Auto-Mergeis not required.
Local git diff --check, scripts/check-doc-inventory.sh, and kanon gate --tier=nobuild --paths CONTRIBUTING.md pass. All exact-head hosted checks are terminal green, with expected docs-only skips.
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 freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
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
gh run rerunritual with the automaticRelease PR checkshealer pathrelease-attestreceipt plus independent provenance verification before calling a release completeEvidence
.github/workflows/release-pr-checks.ymlc187fde44ddd9f1d0396d8750f2e29c337f073baworkflow_runhealer 33015579668 completed successfully, and chore(main): release 0.9.1 #948 acquired a non-empty check rollup without human approval or rerunsValidation
kanon gate --tier=nobuild --paths CONTRIBUTING.md— PASS, zero scoped findingsscripts/check-doc-inventory.sh— PASSgh run list --workflow "Release PR checks"diagnostic — exercised successfully against the receiptgit diff --check— PASS--no-verifyonly after that identical baseline failure; scoped lint is clean.Closes#949