Adopt frankenbit/release-toolkit — adds structured release-cut + closes #157 #162

Closed
opened 2026-06-24 09:06:51 +02:00 by quartermaster · 0 comments

Scope

Adopt frankenbit/release-toolkit (alcatraz-infra#65 + Bosun 13b1) as cellblock's release-cut machinery. Closes cellblock#157 by adoption (the toolkit's _manifest-check.yml reusable is the manifest-vs-tag CI check #157 wants).

Blocked on: frankenbit/release-toolkit v0.1.0 cut.

Current state

  • v1.0.0 cut manually (PR #156 caught manifest-vs-tag mismatch opportunistically)
  • No structured CHANGELOG (commit history is the cadence record)
  • No release-CI check (#157 tracker filed)
  • Future cuts need both substrate-honesty + author-cadence

Acceptance criteria

  • Add release-toolkit.yml config in repo root with release_type: node, version_files: [client/package.json, server/version.go] (if present), changelog: CHANGELOG.md
  • Add changelog.d/.keep to seed the fragment directory
  • (Optional) Backfill retro-fragments for v1.0.0's substantive content as a one-off
  • Add CHANGELOG.md skeleton with ## [Unreleased] section + ## [v1.0.0] for the already-cut release
  • Add consumer workflow .forgejo/workflows/release.yml referencing _release-prep.yml@vX.Y.Z
  • Add consumer workflow .forgejo/workflows/release-draft.yml referencing _release-draft.yml@vX.Y.Z
  • Add consumer workflow .forgejo/workflows/release-publish.yml referencing _release-publish.yml@vX.Y.Z
  • Add consumer workflow .forgejo/workflows/manifest-check.yml referencing _manifest-check.yml@vX.Y.Z for PR CI
  • Document fragment + conventional-commits convention in cellblock/CLAUDE.md for chamber authors
  • Cut v1.0.1 (or v1.1.0) using the toolkit as the first end-to-end validation
  • Close #157 (manifest-vs-tag CI check) — this issue's manifest-check.yml adoption IS the resolution

Open questions

  • Do we backfill v1.0.0's CHANGELOG section retroactively, or start from v1.0.1 cleanly? (Operator preference TBD; either works.)
  • Does cellblock want conventional-commits adoption ALSO (Shipwright's chamber-author shape) or just fragments-for-rich-prose? Both are supported by the toolkit.

— QM, 2026-06-24, per Bosun ratification 13b1.

## Scope Adopt `frankenbit/release-toolkit` (alcatraz-infra#65 + Bosun 13b1) as cellblock's release-cut machinery. **Closes cellblock#157** by adoption (the toolkit's `_manifest-check.yml` reusable is the manifest-vs-tag CI check #157 wants). Blocked on: frankenbit/release-toolkit v0.1.0 cut. ## Current state - v1.0.0 cut manually (PR #156 caught manifest-vs-tag mismatch opportunistically) - No structured CHANGELOG (commit history is the cadence record) - No release-CI check (#157 tracker filed) - Future cuts need both substrate-honesty + author-cadence ## Acceptance criteria - [ ] Add `release-toolkit.yml` config in repo root with `release_type: node`, `version_files: [client/package.json, server/version.go]` (if present), `changelog: CHANGELOG.md` - [ ] Add `changelog.d/.keep` to seed the fragment directory - [ ] (Optional) Backfill retro-fragments for v1.0.0's substantive content as a one-off - [ ] Add `CHANGELOG.md` skeleton with `## [Unreleased]` section + `## [v1.0.0]` for the already-cut release - [ ] Add consumer workflow `.forgejo/workflows/release.yml` referencing `_release-prep.yml@vX.Y.Z` - [ ] Add consumer workflow `.forgejo/workflows/release-draft.yml` referencing `_release-draft.yml@vX.Y.Z` - [ ] Add consumer workflow `.forgejo/workflows/release-publish.yml` referencing `_release-publish.yml@vX.Y.Z` - [ ] Add consumer workflow `.forgejo/workflows/manifest-check.yml` referencing `_manifest-check.yml@vX.Y.Z` for PR CI - [ ] Document fragment + conventional-commits convention in `cellblock/CLAUDE.md` for chamber authors - [ ] Cut v1.0.1 (or v1.1.0) using the toolkit as the first end-to-end validation - [ ] Close #157 (manifest-vs-tag CI check) — this issue's `manifest-check.yml` adoption IS the resolution ## Open questions - Do we backfill v1.0.0's CHANGELOG section retroactively, or start from v1.0.1 cleanly? (Operator preference TBD; either works.) - Does cellblock want conventional-commits adoption ALSO (Shipwright's chamber-author shape) or just fragments-for-rich-prose? Both are supported by the toolkit. — QM, 2026-06-24, per Bosun ratification 13b1.
alex closed this issue 2026-06-26 22:27:53 +02:00
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
frankenbit/cellblock#162
No description provided.