Skip to content

docs(release): record v0.9.0's missing archives and the dist-v0.9.0 recovery - #63

Merged
moriyoshi merged 1 commit into
mainfrom
docs/v0.9.0-dist-archives
Oct 18, 2026
Merged

moriyoshi merged 1 commit into
mainfrom
docs/v0.9.0-dist-archives

Conversation

@moriyoshi

Copy link
Copy Markdown
Owner

Summary

The v0.9.0 GitHub Release was created and published by hand shortly before the tag was pushed. Under immutable releases that froze it with no assets, so when release run 34788914182 finished building all five targets, the publish job refused at its preflight. The archives were recovered from the run's workflow artifacts and published under the companion tag dist-v0.9.0 on the same commit. The binaries in them are byte-identical to the ones in ghcr.io/moriyoshi/imbh:0.9.0.

This PR only changes docs:

  • README.md: says 0.9.0's archives live at dist-v0.9.0 (set BASE=…/download/dist-v0.9.0 in the download recipe). Adds a ⚠️ to the Releasing section: never create a published Release for a version tag ahead of CD. If one has to exist early, leave it as a draft, which release.yml already reuses.
  • CHANGELOG.md: adds a note at the top of [0.9.0] pointing to the companion tag.
  • .agents/docs/TODO.md: closes the "v0.9.0 is prepared but not cut" item.
  • .agents/docs/JOURNAL.md: appends an entry on how it happened, why recovery depended on the 90-day artifact retention, and why the tag is named dist-v0.9.0 and not v0.9.0-dist. A v* name would trigger release.yml and fall under the Version tags ruleset, and semver would sort it as a pre-release.

release.yml is unchanged. The failure happened outside the pipeline.

Test plan

  • Docs only, no Rust or workflow changes, so the cargo gate doesn't apply
  • The dist-v0.9.0 links resolve, and the download recipe works with the overridden BASE

🤖 Generated with Claude Code

…ecovery

The v0.9.0 GitHub Release was published by hand before the tag push, so
the immutable release froze empty and the CD `publish` job refused at its
preflight. The archives were recovered from the run's workflow artifacts
and published under the companion tag `dist-v0.9.0`.

- README: point the download recipe at `dist-v0.9.0` for 0.9.0, and warn
  never to create a published Release for a version tag ahead of CD.
- CHANGELOG: note under `[0.9.0]` where the archives live.
- TODO: close the v0.9.0 release item.
- JOURNAL: record the mechanism, the recovery, and the tag-name choice.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@moriyoshi
moriyoshi enabled auto-merge October 18, 2026 10:10
@moriyoshi
moriyoshi merged commit a7c02c4 into main Oct 18, 2026
5 checks passed
@moriyoshi
moriyoshi deleted the docs/v0.9.0-dist-archives branch October 18, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant