@@ -232,10 +232,10 @@ then returns non-zero if any violation exists. It must require
232232` git+https://github.com/cometapi-dev/cometapi-node.git ` as ` repository.url ` , the
233233same value required by publish validation.
234234
235- Maintainers perform this transition in the reviewed implementation or
236- finalization PR before Release Please preparation; the generated release PR
237- remains limited to its four release files. Validate the exact committed state
238- with:
235+ Maintainers land this transition in a reviewed implementation or finalization
236+ PR before Release Please preparation. After Release Please creates or refreshes
237+ the generated four-file release PR, validate that PR's exact final committed
238+ state with:
239239
240240``` bash
241241release_version=" $( node -p " require('./package.json').version" ) "
@@ -535,19 +535,19 @@ and post-action validation; a later `COMMENTED` or `CHANGES_REQUESTED` review,
535535or any head change, invalidates the approval.
536536
537537The release-PR merge creates the only `push` run that may call Release Please in
538- release mode. From that merge through post-action validation, do not edit the
538+ release mode. From that merge through successful registry verification and the
539+ final readback, do not start a new Release Please workflow or rerun any run
540+ except the bounded source-run retry described below; publication freezes the
541+ complete Release Please run set. Through post-action validation, do not edit the
539542release PR, change its labels or review, or mutate its branch. Keep `main` frozen
540543at the release commit through successful registry verification and the final
541544variable and Environment-policy readback; every handoff, tag, and pre-publish
542- gate requires that exact identity. Do not start or rerun any other Release
543- Please workflow from the tag handoff through registry verification and final
544- readback because publication freezes the complete Release Please run set. A
545- rerun may retry the same release candidate only while no tag or Release exists.
546- If an earlier attempt of that same run already created the Release, same-run
547- reconciliation is allowed only after proving the exact run ID, SHA, tag, bot
548- author, immutable state, target, URL, notes, and publication time inside one
549- earlier Release Please step. It may only reconcile labels and write the
550- attempt-qualified result artifact.
545+ gate requires that exact identity. A rerun may retry the same release candidate
546+ only while no tag or Release exists. If an earlier attempt of that same run
547+ already created the Release, same-run reconciliation is allowed only after
548+ proving the exact run ID, SHA, tag, bot author, immutable state, target, URL,
549+ notes, and publication time inside one earlier Release Please step. It may only
550+ reconcile labels and write the attempt-qualified result artifact.
551551
552552The successful Release Please `workflow_run` enters an unprivileged handoff,
553553which validates the exact result and immutable Release before dispatching
0 commit comments