Skip to content

chore: tag-based npm release workflow + CHANGELOG 0.1.0#15

Merged
olivrg merged 1 commit into
mainfrom
chore/release-workflow
Jun 18, 2026
Merged

chore: tag-based npm release workflow + CHANGELOG 0.1.0#15
olivrg merged 1 commit into
mainfrom
chore/release-workflow

Conversation

@olivrg

@olivrg olivrg commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Builds the release machinery deferred to Part C (per the locked "manual tag-based release" decision). No tag is cut here — tagging is held until the final code review.

.github/workflows/release.yml

  • Triggers on v* tag push only (no tag → no publish).
  • Runs the full verify gate via prepublishOnly (lint + typecheck + test + build) before packing.
  • Asserts the tag matches package.json version before publishing (guards against mismatched tags).
  • Publishes with provenance (permissions: id-token: write); publishConfig (access: public, provenance: true) is already set in package.json.
  • Auth via the NPM_TOKEN repo secret (NODE_AUTH_TOKEN).
  • Uses the same pinned toolchain as ci.yml (pnpm 10, Node from .nvmrc, frozen lockfile).

CHANGELOG

  • Rolls [Unreleased][0.1.0] - 2026-06-18 with the full adapter feature set, leaving an empty [Unreleased] at top and adding Keep-a-Changelog compare/release links.

Prerequisites to actually release (NOT in this PR)

  • NPM_TOKEN secret configured on the repo (automation token with publish rights to the @gethelio org).
  • @gethelio npm org exists and the package name is claimable.
  • Final code review complete, then cut + push v0.1.0.

Verification

pnpm verify green (185 tests, 0 type errors, build ✓); format:check clean (validates the workflow YAML + CHANGELOG).

Adds .github/workflows/release.yml: pushing an annotated `vX.Y.Z` tag runs the
full verify gate (via prepublishOnly) and publishes @gethelio/helio-openclaw to
npm with provenance. The workflow asserts the tag matches package.json version
before publishing, and uses id-token: write for provenance attestation.

Auth uses the NPM_TOKEN repo secret; publishConfig (access:public,
provenance:true) is already set in package.json.

Rolls CHANGELOG [Unreleased] → [0.1.0] with the full adapter feature set and
adds Keep-a-Changelog compare/release links.

No tag is cut here — tagging is held until the final code review.
@olivrg olivrg merged commit 73ca7dc into main Jun 18, 2026
1 check passed
@olivrg olivrg deleted the chore/release-workflow branch June 18, 2026 13:34
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