Skip to content

docs: RELEASE.md — owner-side runbook for the npm publish (I-6)#91

Open
danzeroum wants to merge 1 commit into
mainfrom
claude/bpmn-library-audit-dwamlr
Open

docs: RELEASE.md — owner-side runbook for the npm publish (I-6)#91
danzeroum wants to merge 1 commit into
mainfrom
claude/bpmn-library-audit-dwamlr

Conversation

@danzeroum

Copy link
Copy Markdown
Owner

Closing gift — the I-6 runbook

A single doc, RELEASE.md, describing the owner-side steps to publish the @buildtovalue/* packages to npm, so I-6 can be run without me:

  • Step 0 — own/reserve the @buildtovalue scope on npm (corrects the stale @bpmn-react reference still in release.yml).
  • Step 1 — auth: automation token → NPM_TOKEN secret (Path A), or OIDC trusted publishing (Path B).
  • Step 2 — the one small release.yml edit that enables npm provenance (id-token: write + --provenance), with the exact diff.
  • Step 3 → 4 — dry-run (default) then real run via Actions → Release → Run workflow; version-bump note for later releases.
  • Step 5 — verify version, provenance panel / npm audit signatures, and the CycloneDX SBOM artifact on npm.
  • Troubleshooting table for the common publish errors.

The 18 publishable packages and the 3 private (skipped) ones are enumerated so the dry-run log can be checked at a glance. Docs-only — no code paths touched.

🤖 Generated with Claude Code


Generated by Claude Code

Step-by-step for the human side of item I-6 so it can be executed without
further help: own the @Buildtovalue scope, choose auth (automation token or
OIDC trusted publishing), the one small release.yml edit that turns on npm
provenance (id-token: write + --provenance), the dry-run → real-run flow, and
how to verify version + provenance + SBOM on npm. Also corrects the stale
@bpmn-react scope reference to @Buildtovalue.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HzdCZjy74aPffQwEkKQNAb
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.

2 participants