Arguments: $ARGUMENTS. --accept means the developer accepts the breaking-change list in advance; proceed at step 4 without stopping.
Apply patch and minor upgrades only. Never apply a major; list it as held: major.
1. Read the workspace
- Package manager: root
package.jsonfieldpackageManager(pnpm@11.25.0meanspnpm). Call it<pm>below. - Manifests: root
package.json,apps/*/package.json,packages/*/package.json. - Pins: entries in
dependencies,devDependencies,optionalDependencies. Skipworkspace:*,link:,file:,git,npm:alias and URL specs. - Minimum age in minutes:
minimumReleaseAgeinpnpm-workspace.yamlor.npmrc; if unset,1440.
2. Find upgrades
Run once per distinct package name:
npm view <pkg> versions time --json
{
"versions": ["5.9.2", "5.9.3", "6.0.0-beta", "6.0.2", "6.0.3"],
"time": {
"created": "2012-10-01T15:35:39.553Z",
"modified": "2026-10-10T08:24:07.208Z",
"5.9.3": "2025-09-30T21:19:38.784Z",
"6.0.0-beta": "2026-02-11T18:26:37.557Z",
"6.0.2": "2026-03-23T16:14:45.521Z",
"6.0.3": "2026-04-16T23:38:27.905Z"
}
}
A package with one version returns versions as a string, not an array.
Candidates: versions without a - prerelease suffix, with time[version] at least the minimum age before now.
- Same major as the pin, newer than the pin: take the highest. Type is
minorif the minor differs, elsepatch. - Higher major exists: record
held: majorwith the highest eligible version. Do not apply it. - No candidate newer than the pin: current.
If every pin is current, change no files, report all pins current, and stop.
3. Read release notes
For each package to upgrade, read the notes for every release after the old version up to and including the new one.
gh release view v<version> --repo <owner>/<repo> --json body
- Repository:
npm view <pkg> repository.url. - No GitHub release for the tag: read
CHANGELOG.mdin the repository for the same range. - Record each breaking change, deprecation and migration step per package.
4. Surface and stop
Print one list: package, old version, new version, type, breaking changes and migrations (or none found). Then:
- Without
--accept: stop and ask the developer to accept or exclude packages. Edit nothing before the answer. - With
--accept: continue.
5. Apply
- Set each upgraded pin to the exact new version: no
^, no~, nolatest. - Run
<pm> install. - Run each project script with
<pm> run <script>in this order:build,check,typecheck,test. Skip a script the rootpackage.jsondoes not define.
6. Handle a failing check
For each failure:
- The release notes read in step 3 name the change and its migration: apply the migration, then re-run
<pm> installand all four scripts. - Otherwise: set the package that caused the failure back to its old version, re-run
<pm> installand all four scripts. Report it asheld: check failedwith the error text.
Repeat until build, check, typecheck and test all exit 0. Never finish with a failing check.
7. Report
Print a table of changed packages:
| Package | Old | New | Type |
|---|---|---|---|
| typescript | 5.9.2 | 5.9.3 | patch |
Below it list:
held: major: package, current version, newest eligible major.held: check failed: package, old version, attempted version, error text.- Migrations applied, with the file changed.