docs: require release tags for GitHub pushes

This commit is contained in:
lofyer
2026-08-07 10:58:00 +08:00
parent 17e66a3369
commit 32aba176c8
+10 -2
View File
@@ -87,6 +87,13 @@ Keep Electron security boundaries intact:
CommonJS macOS icon tool. CommonJS macOS icon tool.
- Tag builds must use `v${package.version}`. The workflow also supports manual - Tag builds must use `v${package.version}`. The workflow also supports manual
dispatch and main-branch changes to release tooling. dispatch and main-branch changes to release tooling.
- Every push that updates the `github` remote is a release push. Before pushing,
verify that `package.json` and `package-lock.json` contain the same release
version, create `v${package.version}` at the exact commit being pushed, and
push that tag so the native package matrix and GitHub Release run.
- Never move or reuse an existing release tag. If `v${package.version}` already
exists locally or on a remote at another commit, increment the package
version and create a new matching tag before pushing.
- Verified baseline on 2026-08-04: commit `2f54938`, GitHub Actions run - Verified baseline on 2026-08-04: commit `2f54938`, GitHub Actions run
`30893805567` succeeded for validation and all six package targets, producing `30893805567` succeeded for validation and all six package targets, producing
six release artifacts plus the shared production bundle. six release artifacts plus the shared production bundle.
@@ -111,5 +118,6 @@ credentials, or private user artifacts.
This repository has two synchronized remotes, `origin` and `github`. Unless the This repository has two synchronized remotes, `origin` and `github`. Unless the
user explicitly names a remote, every requested push must update the current user explicitly names a remote, every requested push must update the current
branch on both remotes, plus any tags explicitly included in the request. branch on both remotes. Any push that includes `github` must also push the
Verify both remote refs after pushing. required `v${package.version}` release tag to every remote receiving the branch
update. Verify all updated branch and tag refs after pushing.