diff --git a/docs/reference/RELEASING.md b/docs/reference/RELEASING.md index 6e30f14b64b..6319ffe14a1 100644 --- a/docs/reference/RELEASING.md +++ b/docs/reference/RELEASING.md @@ -47,9 +47,13 @@ OpenClaw has three public release lanes: `node --import tsx scripts/openclaw-npm-postpublish-verify.ts YYYY.M.D` (or the matching beta/correction version) to verify the published registry install path in a fresh temp prefix -- Maintainer workflows may reuse a successful preflight run for the real - publish so the publish step promotes prepared release artifacts instead of - rebuilding them again +- Maintainer release automation now uses preflight-then-promote: + - real npm publish must pass a successful npm `preflight_run_id` + - public `macOS Release` is validation-only + - real private mac publish must pass successful private mac + `preflight_run_id` and `validate_run_id` + - the real publish paths promote prepared artifacts instead of rebuilding + them again - For stable correction releases like `YYYY.M.D-N`, the post-publish verifier also checks the same temp-prefix upgrade path from `YYYY.M.D` to `YYYY.M.D-N` so release corrections cannot silently leave older global installs on the