docs: a release procedure from a green main to tagged, packaged artifacts (closes #387) #395

Merged
clawbot merged 1 commits from issue-387-release-procedure into next 2026-09-21 22:00:19 +02:00
Collaborator

Adds docs/RELEASE.md, linked from the Release Artifacts section of README.md, giving the release procedure as a numbered list a newcomer can follow: confirm main is green in CI, confirm the one version in package.json and the two manifests matches the intended tag, make package from a clean checkout, verify SHA256SUMS, create the annotated tag vX.Y.Z, then distribute per browser. Each step names who performs it, marks the owner-only ones, and states the check that it worked.

The per-browser distribution step is written as pending the owner's choice on #386, naming the Firefox (AMO unlisted / AMO listed / ship unsigned) and Chrome (Web Store / self-hosted CRX / load-unpacked) options with none presented as settled; it records that the chosen steps and the README.md installation sections are updated once that issue is decided.

What a reader should know:

  • The repo commands cited (make setup, make check, make package) all exist on next. The tag, digest-verify and CRX-pack steps use standard git and sha256sum and the chrome --pack-extension line README.md already documents, since the repo provides no target for those outward-facing acts.
  • Judgement call: I did not rotate the current Next Step (the broad pre-1.0 security review) into Completed Steps, because this docs unit did not do that work; I added a new Completed Steps entry for the release doc and left Next Step and Future Steps unchanged.
  • Docs only: no code or test changes.

Model: opus-4-8

Adds `docs/RELEASE.md`, linked from the Release Artifacts section of `README.md`, giving the release procedure as a numbered list a newcomer can follow: confirm `main` is green in CI, confirm the one version in `package.json` and the two manifests matches the intended tag, `make package` from a clean checkout, verify `SHA256SUMS`, create the annotated tag `vX.Y.Z`, then distribute per browser. Each step names who performs it, marks the owner-only ones, and states the check that it worked. The per-browser distribution step is written as pending the owner's choice on https://git.eeqj.de/sneak/AutistMask/issues/386, naming the Firefox (AMO unlisted / AMO listed / ship unsigned) and Chrome (Web Store / self-hosted CRX / load-unpacked) options with none presented as settled; it records that the chosen steps and the `README.md` installation sections are updated once that issue is decided. What a reader should know: - The repo commands cited (`make setup`, `make check`, `make package`) all exist on `next`. The tag, digest-verify and CRX-pack steps use standard `git` and `sha256sum` and the `chrome --pack-extension` line `README.md` already documents, since the repo provides no target for those outward-facing acts. - Judgement call: I did not rotate the current Next Step (the broad pre-1.0 security review) into Completed Steps, because this docs unit did not do that work; I added a new Completed Steps entry for the release doc and left Next Step and Future Steps unchanged. - Docs only: no code or test changes. Model: opus-4-8
clawbot added the needs-review label 2026-09-21 09:55:10 +02:00
clawbot self-assigned this 2026-09-21 09:55:11 +02:00
Author
Collaborator

FAIL — needs-rebase.

The single commit does not rebase onto the current next head (fix: honour a transaction response only for a transaction approval (closes #262), #262). Both that commit and this PR insert a new bullet at the very top of the # Completed Steps list in TODO.md, at the same anchor, so git cannot order the two independent insertions and the merge conflicts (Gitea reports the PR unmergeable). Acceptable: rebase onto the current next and place the release-doc Completed Steps entry adjacent to the entries now there rather than at the identical position, then re-run the checks.

No other defect found; the rebase is the only action needed. docs/RELEASE.md and the README.md link apply cleanly, every command, path and check in the document matches the tree, and the per-browser distribution step is written as pending the owner's choice on #386.

Model: opus-4-8

FAIL — needs-rebase. The single commit does not rebase onto the current `next` head (`fix: honour a transaction response only for a transaction approval (closes #262)`, https://git.eeqj.de/sneak/AutistMask/issues/262). Both that commit and this PR insert a new bullet at the very top of the `# Completed Steps` list in `TODO.md`, at the same anchor, so git cannot order the two independent insertions and the merge conflicts (Gitea reports the PR unmergeable). Acceptable: rebase onto the current `next` and place the release-doc Completed Steps entry adjacent to the entries now there rather than at the identical position, then re-run the checks. No other defect found; the rebase is the only action needed. `docs/RELEASE.md` and the `README.md` link apply cleanly, every command, path and check in the document matches the tree, and the per-browser distribution step is written as pending the owner's choice on https://git.eeqj.de/sneak/AutistMask/issues/386. Model: opus-4-8
clawbot added needs-rebase and removed needs-review labels 2026-09-21 10:00:36 +02:00
clawbot added 1 commit 2026-09-21 15:00:26 +02:00
docs: a release procedure from a green main to tagged, packaged artifacts (closes #387)
check / check (push) Failing after 0s
e2e / e2e-firefox (push) Failing after 0s
e2e / e2e-chrome (push) Successful in 2m3s
041b8feb89
Add docs/RELEASE.md, linked from README.md's Release Artifacts section, giving
the release procedure as a numbered list: confirm main is green in CI, confirm
the one version in package.json and the two manifests matches the intended tag,
make package from a clean checkout, verify SHA256SUMS, create the annotated tag
vX.Y.Z, then distribute per browser. Each step names who performs it, marks the
owner-only ones, and states the check that it worked. Every repo command cited
(make setup, make check, make package) exists on next; tagging and verification
use standard git and coreutils, and the CRX pack line is README's own.

The per-browser distribution step is written as pending the owner's choice on
issue 386, with the Firefox and Chrome options named but none presented as
settled. Docs only: no code or test changes.

Model: opus-4-8
clawbot force-pushed issue-387-release-procedure from feb79659cd to 041b8feb89 2026-09-21 15:00:26 +02:00 Compare
clawbot added needs-review and removed needs-rebase labels 2026-09-21 15:00:32 +02:00
clawbot added needs-rebase and removed needs-review labels 2026-09-21 18:31:56 +02:00
clawbot added needs-review and removed needs-rebase labels 2026-09-21 21:28:32 +02:00
Author
Collaborator

PASS — rebased cleanly onto current next and make check is green on that head; every command, file, version location and check named in docs/RELEASE.md exists and behaves as written, the per-browser distribution step is written as pending the owner's choice on #386 with the options named and none settled, and the README/TODO links resolve.

Model: opus-4-8

PASS — rebased cleanly onto current `next` and `make check` is green on that head; every command, file, version location and check named in `docs/RELEASE.md` exists and behaves as written, the per-browser distribution step is written as pending the owner's choice on https://git.eeqj.de/sneak/AutistMask/issues/386 with the options named and none settled, and the README/TODO links resolve. Model: opus-4-8
clawbot merged commit a1f082d686 into next 2026-09-21 22:00:19 +02:00
clawbot deleted branch issue-387-release-procedure 2026-09-21 22:00:20 +02:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sneak/AutistMask#395