Skip to content

release: promote 0.2.1-alpha to unstable - #577

Merged
mberrys merged 3 commits into
unstablefrom
dev
Sep 14, 2026
Merged

release: promote 0.2.1-alpha to unstable#577
mberrys merged 3 commits into
unstablefrom
dev

Conversation

@mberrys

@mberrys mberrys commented Sep 14, 2026 •
edited by blacksmith-sh Bot
Loading

Copy link
Copy Markdown
Contributor

Promote the merged 0.2.1-alpha release preparation from dev to unstable.

  • Source head: 37b1ec3594f527266c0639a717d1797a5c77ecd5
  • Includes the 0.2.1-alpha version bump and repaired draft-release workflow.
  • PR release: prepare 0.2.1-alpha draft packaging #576 merged with hosted agent-fast build, source integrity, policy, package script, architecture, CodeQL, and security checks passing.
  • Fuzz was still running at merge time; its result remains tracked separately.

This promotion is required before final stable qualification and exact-SHA package dispatch.

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

@mberrys
docs: define the canonical Loop release changelog format
93a179c 
Promotion and release changelogs had no written shape, so each one was
rebuilt from scratch and their closure claims were unauditable. Add
docs/CHANGELOG_FORMAT.md: title and measured scope line, the fragment
Category vocabulary as sections, one item per outcome naming its issue and
mechanism, a Closes/Refs block that tracks acceptance criteria rather than
commits, verification naming workflows and SHAs, and a stated
breaking-change answer. Point the PR template at it for promotion and
release PRs; topic PRs keep answering with their changes/<branch>.md
fragment.

Docs only: no behaviour, contract, or schema change.
@mberrys
release: prepare 0.2.1-alpha draft packaging
52ee1bc
@mberrys
release: prepare 0.2.1-alpha draft packaging (#576)
37b1ec3 
## Release preparation

Prepares the Loop 0.2.1 alpha release line and repairs the release
assembly workflow.

### Changes

- bumps the canonical product version and generated version policy
records to `0.2.1-alpha`
- authenticates GitHub CLI and release creation with the workflow
`GITHUB_TOKEN`
- derives prerelease status from `LOOP_VERSION_PRERELEASE`
- verifies the checked-out source SHA, tag identity, and existing draft
target before asset mutation
- stages only the requested AppImage, MSI, MSIX, Windows archive,
checksums, SBOMs, and third-party notices
- verifies final package names, sizes, SHA-256 digests, and paired
Linux/Windows evidence before release upload
- adds behavioral coverage for asset substitution, missing assets,
unexpected CI evidence, and draft assembly

### Verification

- `python -m unittest scripts.ci.test_verify_release_assets
scripts.ci.test_workflow_contracts scripts.ci.test_check_version_policy
scripts.ci.test_compare_package_boundary_evidence -q` — 44 passed
- `python scripts/ci/check_version_policy.py` — passed
- `python scripts/ci/check_supply_chain_pins.py` — passed
- workflow YAML and shell syntax checks — passed
- required `check-change.py --base origin/dev` — source, policy,
architecture, preflight, QML, search, and independent-validation checks
passed; build/test checks are incomplete because this isolated worktree
has no configured build directory

Packaging will be dispatched after this repair is promoted, using the
final stable source SHA.

<!-- codesmith:footer -->
---
<a
href="https://app.blacksmith.sh/studio-berry/codesmith/loop/pr/576"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-dark-v2.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-light-v2.svg"><img
alt="View with [code]smith"
src="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-dark-v2.svg"></picture></a>
<a
href="https://backend.blacksmith.sh/track/enable-autofix?expires=1791982488&installation_model_id=435800&pr_number=576&repository=studio-berry%2Floop&return_to=https%3A%2F%2Fgithub.com%2Fstudio-berry%2Floop%2Fpull%2F576&signature=c11d7ed5a103cf7a8a5b96026ce3505c1226c72d95f7e53bb35bdbb22dd93423"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-light.svg"><img
alt="Autofix with [code]smith"
src="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-dark.svg"></picture></a>
<sup>Need help on this PR? Tag <code>@codesmith-bot</code> with what you
need. Autofix is disabled.</sup>

<!-- codesmith:autofix:disabled -->
<!-- /codesmith:footer -->
@mberrys
mberrys merged commit 4d0cb17 into unstable Sep 14, 2026
23 of 24 checks passed
@mberrys mberrys mentioned this pull request Sep 14, 2026
Merged
mberrys added a commit that referenced this pull request Sep 14, 2026
@mberrys
release: promote 0.2.1-alpha to stable (#580)
1e8d5ec 
Promote the qualified 0.2.1-alpha release from `unstable` to `stable`.

- Exact source head: `614af044925b4df1fe7bdebf7523b52b8e36015b`
- Includes the reviewed release preparation (#576), the unstable
promotion (#577), and the required stable-history reconciliation (#579).
- The stable branch is now an ancestor of this head, so the protected
promotion is up to date.

After merge, dispatch Linux and Windows package workflows with this
exact stable SHA, then create the draft `v0.2.1-alpha` release.

<!-- codesmith:footer -->
---
<a
href="https://app.blacksmith.sh/studio-berry/codesmith/loop/pr/580"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-dark-v2.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-light-v2.svg"><img
alt="View with [code]smith"
src="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-dark-v2.svg"></picture></a>
<a
href="https://backend.blacksmith.sh/track/enable-autofix?expires=1791984741&installation_model_id=435800&pr_number=580&repository=studio-berry%2Floop&return_to=https%3A%2F%2Fgithub.com%2Fstudio-berry%2Floop%2Fpull%2F580&signature=ce77127e2d7cb85cfda6b65a80541589ac92cea134b4712a8be21cd6ecc1cc6f"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-light.svg"><img
alt="Autofix with [code]smith"
src="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-dark.svg"></picture></a>
<sup>Need help on this PR? Tag <code>@codesmith-bot</code> with what you
need. Autofix is disabled.</sup>

<!-- codesmith:autofix:disabled -->
<!-- /codesmith:footer -->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@mberrys