OKF Workbench
Release checklist
Release checklist
- Candidate: OKF Workbench
0.4.0 - Identifier:
straydog.okf-workbench - Status: Published and verified; remaining scope is recorded in the release record
- Authority: the maintainer requested this release on 2026-09-05; publication uses a
matching version tag on reviewed
main, per ADR 0006.
This release raises the extension target to Node 24 and the VS Code floor to 1.123, updates development dependencies, and qualifies VSCodium 1.126.04524. The minor version advance makes the changed editor requirement visible. The native CLI and OKF contract are unchanged. The completed predecessor record is 0.3.0.
Before tagging
- Maintainer authorized release preparation and publication.
- Manifest, npm/Cargo lockfiles, package checks, and version assertions use 0.4.0.
- Changelog contains the dated 0.4.0 entry and explains the editor requirement.
- Packaged-input revision
0628712passes source, Rust, unit, acceptance, security, browser, minimum/current editor integration, notices, production audit, and package checks. - Genuine headed VS Code 1.129.1 schema-v3 evidence passes the strict evaluator:
QR-002 p95 851 ms across 20 samples, QR-003
d3, and zero remote Webview requests. All 13 hosted VSIX payload files, including canonical Wasm, match the measured runtime. Raw JSON and the CI receipt are retained in the performance record. - Hosted Compatibility passes all seven editor/OS lifecycle lanes, using the published v0.3.0 universal VSIX and its verified checksum as the upgrade input.
- Hosted Package smoke passes the browser boundary, four target packages, and aggregate consistency on the same packaged-input revision.
- Version and evidence changes are reviewed and merged into protected main (#59).
- Repository secret names OPEN_VSX_TOKEN, STRAY_TOOLS_TOKEN, and TAP_REPO exist. Only the tagged workflow verifies their values and publisher authorization.
- Tag-triggered publication follows ADR 0006; a signature is not a workflow prerequisite.
The previous PR #47 validation predates the version change. It does not qualify 0.4.0 package bytes. Any changed packaged input requires the affected gates to run again.
Publication
- Confirm v0.4.0 does not exist locally, remotely, or in Open VSX.
- Confirm the final commit is reviewed, in main, and has passing required CI.
- Create
git tag -a v0.4.0 -m "OKF Workbench 0.4.0", inspect its target withgit rev-parse v0.4.0^{commit}, confirm main containment, then push that tag. - Wait for all tagged release jobs to pass. They publish the GitHub Release, universal and four target VSIX packages, four CLI archives and checksums, Open VSX package set, and Homebrew/Scoop manifests.
Never print tokens, use local ovsx publication as a fallback, or reuse a version/tag for different bytes. Missing credentials fail closed.
After publication
- Verify tag identity, release workflow, all 18 release assets, and checksums.
- Match all five Open VSX packages to their GitHub Release bytes.
- Run a clean published VSCodium Windows lifecycle, including 0.3.0 upgrade, untrusted/offline behavior, uninstall, and workspace/settings preservation.
- Verify Homebrew/Scoop manifest version and archive checksums.
- Run an isolated clean Scoop install,
okf version, and uninstall. - Record any unavailable post-publication checks and credential-disposition gaps.
Record results in the 0.4.0 release record. Existing 0.3.0 receipts remain historical. Open VSX versions are immutable; preserve evidence and fix forward with a higher version if publication reveals a defect.