This directory holds change-intent files consumed by pnpm-native workspace
versioning (pnpm version -r). One file per change, authored with:
pnpm change --bump <none|patch|minor|major> --summary "<changelog entry>" [<pkg>...]
- A PR that changes a publishable package's turbo
buildhash MUST ship with an intent here — thechangeset-checkworkflow compares each package'sbuildtask hash between the PR's pinned base and the run's checked-out head tree, and blocks the PR when a changed hash is not named. The hash is turbo's own verdict: source and config files, the manifest, the build command, and dependency-task changes all re-hash; a README or lockfile-only edit does not. --bump nonerecords a change that needs no release. A devDependency-only or script-only bump is the canonicalnoneclass; anoneon a behavior-visible change is the same silent non-release the gate exists to catch.- Edits that re-hash every package at once (a shared
@systemfsoftware/tsconfigfile,turbo.json, the globalpatch-tsgo-if-needed.mjs, or a file inside a nested-workspace fixture undertestResources) demand an intent per package. - Catalog value flips in
pnpm-workspace.yamlchange no package hash and are outside this verdict — they are reviewed in the release pass instead. - Intents are consumed (deleted) by
pnpm version -rwhen the Release PR lands. - This README is NOT a changeset: the gate requires a file whose frontmatter
parses as
"<pkg>": <none|patch|minor|major>.
See docs/plans/2026-08-10-003-refactor-pnpm-native-release-migration-plan.md
for the full release design.