Goal
Make the approved v2 release line the repository default and stable release source while keeping v1 independently maintainable.
Scope
- Ensure old or conflicting release pull requests are completed or closed.
- Include the post-cutover workflow configuration in the reviewed v2 promotion pull request:
release-v2.yml: main, stable 2.x, latest
release-v1.yml: release/v1, 1.x, v1
- Promote
v2 to main through a reviewed pull request.
- Do not force-push or replace
main history.
- Wait for post-merge CI before approving a stable v2 release.
- Create and separately approve the stable v2 release pull request.
- Publish stable
2.x under latest.
- Verify versions, tags, changelog, GitHub Release, npm artifacts, and dist-tags.
- Install the stable v2 packages from npm in isolated consumer fixtures.
- Update rulesets, previews, documentation, issue templates, and contribution routing.
- Keep
v2 during the observation window, then remove it through the protected-branch process.
- Document rollback:
- before npm publication: reviewed revert of the promotion merge or fix-forward;
- after npm publication: restore
latest to the last approved package, then use a reviewed revert or fix-forward because a published version cannot be removed safely.
Acceptance criteria
Goal
Make the approved v2 release line the repository default and stable release source while keeping v1 independently maintainable.
Scope
release-v2.yml:main, stable2.x,latestrelease-v1.yml:release/v1,1.x,v1v2tomainthrough a reviewed pull request.mainhistory.2.xunderlatest.v2during the observation window, then remove it through the protected-branch process.latestto the last approved package, then use a reviewed revert or fix-forward because a published version cannot be removed safely.Acceptance criteria
maincontains the approved v2 promotion and remains the default branch.2.xis published only after separate release approval.release-v2.ymlownsmain/2.x/latest.release-v1.ymlownsrelease/v1/1.x/v1.v2is removed.