Skip to content

chore: switch npm release to Trusted Publishing (OIDC), matching @gethelio/proxy#21

Merged
olivrg merged 1 commit into
mainfrom
chore/npm-trusted-publishing
Jun 20, 2026
Merged

chore: switch npm release to Trusted Publishing (OIDC), matching @gethelio/proxy#21
olivrg merged 1 commit into
mainfrom
chore/npm-trusted-publishing

Conversation

@olivrg

@olivrg olivrg commented Jun 20, 2026

Copy link
Copy Markdown
Contributor

Migrates this repo's release auth from the long-lived NPM_TOKEN to tokenless OIDC Trusted Publishing, mirroring @gethelio/proxy's release.yml (verified: proxy publishes via OIDC under environment: npm, no stored token).

Changes to release.yml

  • Run the publish job under environment: npm with permissions: id-token: write
  • Add "Upgrade npm for trusted publishing" (npm install -g npm@latest)
  • Publish via npm publish --access public (was pnpm publish --no-git-checks + NODE_AUTH_TOKEN)
  • Remove the NODE_AUTH_TOKEN env entirely

Provenance is generated automatically by the OIDC publish. The tag↔version guard and the prepublishOnly verify gate are unchanged. Trigger is still v* tags only.

⚠️ Required before the next release

Configure the Trusted Publisher on npm before tagging the next version, or the publish will fail:

  • Package @gethelio/helio-openclaw → Settings → Trusted Publisher → GitHub Actions
  • Repository: gethelio/helio-openclaw
  • Workflow: release.yml
  • Environment: npm

This PR is inert until then (it only runs on a tag, and 0.1.0 is already out).

Cleanup after the next successful OIDC release

  • Delete the now-unused NPM_TOKEN repo secret
  • Revoke the helio-openclaw-release-ci npm token

format:check clean (validates the workflow YAML).

…helio/proxy

Replace the long-lived NPM_TOKEN (granular, bypass-2FA, @gethelio-scope) with
tokenless OIDC trusted publishing, mirroring the proxy package's release.yml:

- run the publish job under `environment: npm` with `id-token: write`
- add "Upgrade npm for trusted publishing" (npm@latest) for OIDC support
- publish via `npm publish --access public` (was `pnpm publish` + NODE_AUTH_TOKEN)
- drop the NODE_AUTH_TOKEN env entirely

Provenance is generated automatically by the OIDC publish. The tag↔version guard
and the prepublishOnly verify gate are unchanged.

Prereq before the next release: configure this repo + workflow (environment `npm`)
as a Trusted Publisher on the @gethelio/helio-openclaw npm package settings. After
the next release confirms OIDC works, the NPM_TOKEN secret can be deleted and the
helio-openclaw-release-ci token revoked.
@olivrg olivrg merged commit f105f1c into main Jun 20, 2026
1 check passed
@olivrg olivrg deleted the chore/npm-trusted-publishing branch June 20, 2026 12:35
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