Skip to content

ci: gate build step on changeset-release PRs; rewrite RELEASING for changesets - #133

Merged
JamesLawton merged 1 commit into
mainfrom
fix/release-ci-and-docs
Jul 24, 2026
Merged

ci: gate build step on changeset-release PRs; rewrite RELEASING for changesets#133
JamesLawton merged 1 commit into
mainfrom
fix/release-ci-and-docs

Conversation

@JamesLawton

Copy link
Copy Markdown
Collaborator

Two fixes from the first release on the new Changesets pipeline.

1. CI false-red on version PRs

The shared 0xPolygon/pipelines/.github/actions/ci action gates every step (including pnpm setup) with if: "!startsWith(github.head_ref, 'changeset-release/')", because those branches carry only version/changelog changes. The inline build step we add in ci-trigger.yml was not gated, so on the changeset-release/main PR it ran with no pnpm on PATH and failed with pnpm: command not found (exit 127). This showed the version PR as red even though nothing was wrong.

Fix: gate the build step with the same head_ref guard, so it skips on changeset-release/* (nothing to build there) and runs normally on real PRs.

2. RELEASING.md described the retired Lerna flow

docs/RELEASING.md still documented the old "Actions → Run workflow → pick a channel" Lerna dispatch and conventional-commit-driven versioning. Rewritten to describe the actual Changesets cycle:

  • add a changeset (pnpm changeset); the bump level comes from the changeset, not commit messages
  • merge to main → Release workflow opens the Version Packages PR → merge that → OIDC publish + git tags + GitHub Release
  • private packages are versioned/tagged but not published
  • snapshot prereleases via the manual workflow_dispatch (non-semver dist-tag)
  • idempotent re-run recovery if a publish step fails

Docs + CI only; no package source changes.

…hangesets

The inline build step in ci-trigger.yml ran on changeset-release/* PRs where
the shared ci action skips pnpm setup, failing with "pnpm: command not found".
Gate it with the same head_ref guard the shared action uses.

Also rewrite docs/RELEASING.md: it still described the old Lerna manual-dispatch
flow. Document the actual changesets cycle (version PR -> merge -> OIDC publish),
snapshot prereleases, and that changesets (not commit messages) drive versions.
@claude

claude Bot commented Jul 23, 2026

Copy link
Copy Markdown

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@JamesLawton
JamesLawton merged commit 0906d4a into main Jul 24, 2026
6 checks passed
@JamesLawton
JamesLawton deleted the fix/release-ci-and-docs branch July 24, 2026 11:21
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