release-beta: CHANGELOG-before-tag rule is documented, not enforced

Aperta Adatta ai principianti

#1,282 aperta il 9/9/2026 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà: 2/5
Tempo stimato: 1-3 ore
Idoneità per principianti: 82/100

Tipo di issue: Funzionalità
Chiarezza: Specificata chiaramente
Stato di attività: Attiva
Stack tecnologico: typescript
Ambito: release, tooling

Direzione di ricerca

Inizia da script/release-preflight.ts e confronta come fallisce già nella fase di tag per collisioni di tag, validità della versione, ascendenza delle prerelease e protezioni dei marker. Aggiungi un controllo di CHANGELOG.md per la versione da taggare, corrispondente a una sezione come ## [X.Y.Z] o X.Y.Z-beta.N. È completato quando il preflight fallisce prima del tagging se la sezione manca e passa quando esiste.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

What happened

v0.11.0-beta.5 was tagged and published without a CHANGELOG.md entry. Every prior beta (beta.1, beta.3, beta.4) had shipped with its own dedicated section; beta.5 didn't, because the release-beta skill's pre-tag gate checklist never asked for one. Nothing caught it before the tag existed — the changelog is baked into the compiled binary at build time (packages/opencode/script/build.ts reads CHANGELOG.md into OPENCODE_CHANGELOG), so by the time anyone noticed, the fix could only apply to the next beta, not the one already built and published.

What #1281 fixes

Adds the missing beta.5 entry, and adds an explicit gate + Hard Rule to .claude/commands/release-beta.md telling whoever runs the release to check for a CHANGELOG.md entry before tagging.

What's still open

That's a documentation fix, not an enforced one — it relies on whoever (human or agent) runs the release actually reading and following that step. script/release-preflight.ts already automates several other pre-tag checks (tag collision, version sanity vs npm, prerelease ancestry, marker guard) that used to be the same kind of "remember to check this" gate. This should be one more: have release-preflight.ts parse CHANGELOG.md and fail the tag stage if there's no ## [X.Y.Z] (or X.Y.Z-beta.N) section for the version being tagged, the same way it already fails on a tag collision.

That would make this a hard, automatic stop instead of a step someone can skip under release pressure — which is exactly how beta.5 shipped without one.

Related: #1281

🤖 Generated with Claude Code

https://claude.ai/code/session_01H8gZMvZunXzx4LPSZzCafq

Lingua principale: TypeScript
Stelle: 813
Fork: 134
Merge medio: 2g 5h
PR unite (30g): 62

Guida per i contributori

Apri la guida per i contributori

Come iniziare

Leggi tutta la issue e poi la guida ai contributi del progetto.
Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
Fai un fork del repository e lavora su un branch.
Apri una pull request che faccia riferimento al numero della issue.