-
Confirm the release branch is clean and all CI checks pass.
-
Update the version in
package.json, regeneratepackage-lock.jsonwith npm, and add release notes toCHANGELOG.md. -
Run the full local verification suite:
npm run format:check npm run lint npm run typecheck npm run test:coverage npm run package:check
-
Create and push an annotated
vX.Y.Ztag. -
The release workflow publishes with npm provenance.
Configure npm trusted publishing for this repository and the release.yml workflow before creating the first tag. The workflow uses GitHub OIDC (id-token: write) and intentionally does not require an NPM_TOKEN. Confirm the npm package owner and trusted-publisher settings in npm before release.
If trusted publishing is unavailable for the target registry, stop and configure a least-privilege automation token outside this repository; do not add a token to source control.