Skip to content

Release process: RELEASING.md, pre-releases under next, 0.1.1-beta.0 - #1

Merged
gabemule merged 9 commits into
mainfrom
docs/releasing
Oct 19, 2026
Merged

gabemule merged 9 commits into
mainfrom
docs/releasing

Conversation

@gabemule

Copy link
Copy Markdown
Contributor

What

  • RELEASING.md: the release process (GitHub Release → publish.yml with npm Trusted Publishing and provenance), the one-time setup and its status, pre-releases, and troubleshooting. The Publishing section of CONTRIBUTING.md now points to it.
  • Pre-releases: a version with a semver pre-release suffix (x.y.z-beta.N) on a Release marked "Set as a pre-release" publishes under the next dist-tag, never latest. scripts/check-release.mjs refuses the release before any build when the suffix and the flag disagree.
  • 0.1.1-beta.0: version bump and CHANGELOG entry for the first publish from the workflow.

Why now

The trusted publisher on npmjs.com is configured but pending validation: npm needs one publish from this workflow before 2026-10-21 23:20 UTC. Releasing v0.1.1-beta.0 as a pre-release validates it without touching latest (0.1.0).

Verified

  • npm run typecheck clean; npm test 150/150 pass; npm run verify:pack ok (26 files).
  • check-release by hand: beta + pre-release ok, beta + not pre-release refused, stable + pre-release refused, stable ok, build metadata (+build) not treated as a pre-release, missing/invalid flag refused.
  • Not verified: actionlint (not available locally) and a real run on Actions; that happens with the release.

After merging

Publish a GitHub Release from main: tag v0.1.1-beta.0, title v0.1.1-beta.0, notes from the CHANGELOG, "Set as a pre-release" checked. Then npm view @the-coded/llm-adapters dist-tags should show next: 0.1.1-beta.0 and latest: 0.1.0.

A pre-release must never become `latest`, and npm 11 refuses to publish
one without an explicit --tag. The workflow now passes the GitHub
Release's prerelease flag to check-release, which refuses the release
before any build when the flag and the version suffix disagree, and
npm publish takes --tag next or latest from that same flag.

The flag is required as true or false: a missing value would otherwise
read as stable and let the first mistake through.
First version published by the workflow, as a pre-release under the next dist-tag, to validate Trusted Publishing before its deadline without moving latest.
@gabemule
gabemule merged commit 4b7923a into main Oct 19, 2026
3 checks passed
@gabemule
gabemule deleted the docs/releasing branch October 19, 2026 23:28
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