feat: version lifecycle tooling#145
Open
filvecchiato wants to merge 17 commits into
Open
Conversation
- Add scripts/cut-version.sh for cutting protocol releases - Add rust/crates/truapi/src/next/ as a staging module for upcoming types - Move docs/design/v02-changes.md to docs/design/releases/v0.2.md Closes #138
pgherveou
reviewed
May 29, 2026
Signals the unstable next protocol version under development.
pgherveou
reviewed
May 30, 2026
Merged
# Conflicts: # rust/crates/truapi/src/versioned/mod.rs
Remove redundant file copy loop in crystallize step, add missing local declaration for items variable, and clarify final message to show both the released and bumped versions.
# Conflicts: # scripts/cut-version.sh
pgherveou
reviewed
Jun 4, 2026
The next/ module is unnecessary — new wire types can be added directly to v01/ or a future vNN/ module when needed. Removes the module, its lib.rs declaration, and the crystallize/reset steps from cut-version.sh.
pgherveou
reviewed
Jun 5, 2026
pgherveou
approved these changes
Jun 5, 2026
auto-merge was automatically disabled
June 5, 2026 19:28
Pull request was converted to draft
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
filvecchiato
changed the title
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
2 participants
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.
Summary
Adds version-cutting tooling and an explorer version snapshot script for the TrUAPI release process.
Closes #138
What's included
scripts/cut-version.shA single command to cut a protocol release. It performs two steps:
scripts/snapshot-version.shto archive the current API surface for the explorer's version selector.CHANGELOG.md— builds the changelog from scratch using conventional commit messages and git tags. Commits are classified into changelog sections (see table below) following the Keep a Changelog format. An RFCs section is also generated by diffingdocs/rfcs/between tags to show which RFCs were accepted or withdrawn in each release.Version bumping is handled separately by the changeset release process (
npm run changeset+npm run version-packages).Usage:
docs/design/releases/v0.2.mdMoved
docs/design/v02-changes.mdinto areleases/directory to establish a convention for per-version release notes.PR and commit conventions
For the changelog generation to produce meaningful output, commits should follow Conventional Commits:
feat:fix:refactor:,perf:remove:,revert:docs:,chore:,ci:,test:,style:,build:type!:(breaking)Merge commits are always skipped.
Additionally, the changelog includes an RFCs section per release, generated automatically by diffing
docs/rfcs/between git tags:RFC titles are extracted from YAML frontmatter (
title:) or the first#heading in each file.Test plan
scripts/cut-version.sh --dry-runcompletes without errorscargo build -p truapisucceeds