Skip to content

Commit 18de120

Browse files
authored
docs: require Release Please permission preflight
Record the external Actions permission as a durable pre-release invariant and fail closed before main merges when it drifts.
1 parent d02b1db commit 18de120

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

RELEASING.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,21 @@ violations in one run and still returns non-zero when any violation exists.
184184
per generation, a 30-second request timeout, concurrency one, a ten-minute
185185
workflow timeout, and stop on the first failure. Every trigger requires
186186
`LIVE_SMOKE_ENABLED=true`.
187+
- Before enabling `RELEASE_PLEASE_ENABLED` or merging the change intended to
188+
open or update a release PR, verify the effective repository setting:
189+
190+
```bash
191+
gh api repos/cometapi-dev/cometapi-python/actions/permissions/workflow \
192+
| jq -e '.default_workflow_permissions == "read" and .can_approve_pull_request_reviews == true'
193+
```
194+
195+
The organization policy must permit this repository setting, and the
196+
repository setting must remain enabled as a release-automation invariant.
197+
It does not grant default write access: workflow permissions remain read-only
198+
unless a job explicitly requests a narrower write scope. Do not disable this
199+
setting during release cleanup. If the check fails or is unavailable, stop
200+
before the default-branch merge; do not rerun the failed release workflow or
201+
manually replace its Release Please PR.
187202
- The `release-please` job in `publish.yml` maintains a human-reviewed version
188203
and changelog pull request from Conventional Commits after maintainers enable
189204
the `RELEASE_PLEASE_ENABLED` repository variable. A reviewed one-time

0 commit comments

Comments
 (0)