| name | release-mperf |
| description | Prepare, validate, publish, and verify an mperf GitHub release. Use when Codex is asked to cut, publish, retry, or audit an mperf release, create a release tag, or verify release JARs, checksums, and provenance attestations. |
Release mperf
Publish only from an up-to-date, clean main branch. Treat tag creation and pushing as external mutations: confirm the requested version before performing them.
Prepare
- Confirm
gh auth status succeeds for benjaminromano/mperf and the user has permission to push tags.
- Select a SemVer value without a leading
v, such as 1.2.3 or 1.2.3-rc.1.
- Run
scripts/preflight.sh <version> from this skill directory. Resolve every failure; do not bypass tests, lint, generated-doc checks, artifact smoke tests, or the clean-tree check.
- Summarize user-visible changes since the previous
v* tag and confirm the candidate version with the user if it was not explicitly supplied.
Publish
Create and push one annotated tag. Do not create a GitHub Release manually; .github/workflows/release.yml owns release construction, checksum generation, provenance attestation, and publication.
git tag -a "v<VERSION>" -m "Release v<VERSION>"
git push origin "v<VERSION>"
gh run list --workflow Release --limit 1
gh run watch <RUN_ID> --exit-status
If the workflow fails, diagnose and fix the underlying problem. Delete or move a published tag only with explicit user approval.
Verify
Verify the release after the workflow succeeds:
tmp_dir=$(mktemp -d)
gh release view "v<VERSION>" --json isDraft,isPrerelease,tagName,url
gh release download "v<VERSION>" --dir "$tmp_dir"
(cd "$tmp_dir" && shasum -a 256 -c "mperf-<VERSION>-all.jar.sha256")
gh attestation verify "$tmp_dir/mperf-<VERSION>-all.jar" --repo benjaminromano/mperf
java -jar "$tmp_dir/mperf-<VERSION>-all.jar" --help
rm -rf "$tmp_dir"
Report the release URL, workflow run, checksum result, attestation result, and smoke-test result. Prerelease versions containing - must be marked as prereleases; stable versions must be the latest release.
