chore: migrate to trunk-based development and tag-triggered npm releases#26
Merged
Conversation
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR migrates the repository from the two-branch (
next+main) + release-please flow to trunk-based development onmainwith tag-triggered npm releases, mirroring the model used intests-untp.The rationale, scope, and migration sequence are documented in the new ADR at
docs/adrs/001-trunk-based-development-and-tag-triggered-releases.md. In short: every release becomes a single tag push (v<X.Y.Z>); a pipeline-side script asserts the tag matchespackage.jsonbefore publishing; a disaster-recovery workflow handlesunpublish(within 72h) ordeprecate(after).This PR is infrastructure only.
package.jsonstays at2.0.0. A follow-up PR will bring the digest-multibase work fromnextontomain, bump to2.1.0, and tag for the first tag-triggered release.What changes
docs/adrs/001-...md,.github/workflows/release.yml,.github/workflows/unpublish-or-deprecate.yml,scripts/check-tag-version-match.mjsplus tests,RELEASE_NOTES.md..github/workflows/release-and-publish.yml,.github/workflows/changelog.yml,.github/workflows/release-please-config.json,.github/workflows/.release-please-manifest.json.CHANGELOG.md(rewritten to Keep-a-Changelog, prior version history preserved),test-and-build.yml(PRs targetmain),eslint.config.js(recognises.mjs),README.md(new Releasing section).Operator follow-up after merge
@pyx-industries/vc-render-template-utilsto trust this repository'sReleaseworkflow.2.1.0, pushv2.1.0tag to trigger the first release.origin/nextoncemainis at parity. Update branch protection to protectmain.Test plan
yarn lint,yarn format,yarn test,yarn buildall pass locally (80 tests across 10 suites, 100% lines/statements coverage on the existing source, 7 new tests covering the version-match script).scripts/check-tag-version-match.mjssmoke-tested locally with match, version mismatch, wrong prefix, non-SemVer suffix, andGITHUB_REF_NAME-precedence cases. All seven automated tests inscripts/__tests__/check-tag-version-match.test.tspass.Releaseworkflow is the only workflow that runs on av*tag push (no leftoverrelease-and-publishjob).