openbitdo/RC_CHECKLIST.md

OpenBitdo RC Checklist (v0.0.1-rc.4)

This checklist defines the release-candidate gate for the current public RC tag.

Release Policy

• Tag format: v*
• Current RC tag: v0.0.1-rc.4
• Tag source: main only
• Release trigger: tag push
• Public RC rule: zero open issues labeled release-blocker

Required CI Checks

• guard
• aur-validate
• tui-smoke-test
• build-macos-arm64
• test

Clean Tree Gate

From cleanroom/:

git status --porcelain
git clean -ndX

Expected:

• no tracked modifications or staged changes
• ignored-output review only from git clean -ndX

Artifact Expectations

Release assets must include:

• openbitdo-v0.0.1-rc.4-linux-x86_64.tar.gz
• openbitdo-v0.0.1-rc.4-linux-x86_64
• openbitdo-v0.0.1-rc.4-linux-aarch64.tar.gz
• openbitdo-v0.0.1-rc.4-linux-aarch64
• openbitdo-v0.0.1-rc.4-macos-arm64.tar.gz
• openbitdo-v0.0.1-rc.4-macos-arm64
• openbitdo-v0.0.1-rc.4-macos-arm64.pkg
• .sha256 files for every artifact above

Distribution Gate

• GitHub prerelease assets must be published successfully.
• AUR publish must render checksum-pinned metadata and update openbitdo-bin.
• Homebrew publish must render a checksum-pinned formula and update bybrooklyn/homebrew-openbitdo.

macOS Packaging Gate

• .pkg remains unsigned and non-notarized for this RC.
• Gatekeeper friction is expected and must be documented.
• Tarball and standalone binary remain the fallback paths.

Manual Smoke Expectations

1. Linux x86_64: launch openbitdo --mock
2. Linux aarch64: launch openbitdo --mock
3. macOS arm64 standalone binary: launch openbitdo --mock
4. macOS arm64 .pkg: confirm payload installation path and launch behavior where possible

Current Status Snapshot

Gate	Status	Notes
Required CI checks	Pass	Current required checks are configured in GitHub branch protection.
GitHub prerelease assets	Pending	Verify v0.0.1-rc.4 assets after the tag workflow completes.
AUR publication	Pending	Verify openbitdo-bin updates to v0.0.1-rc.4 after release publication.
Homebrew publication	Pending	Verify bybrooklyn/homebrew-openbitdo updates to v0.0.1-rc.4 after release publication.
macOS notarization	Deferred	Explicitly out of scope until Apple credentials exist.

Historical Notes

• Historical RC activity for earlier candidates is preserved in commit history and the changelog.
• Troubleshooting for AUR SSH publication lives in process/aur_publish_troubleshooting.md.