Require Node 22 and use yarn 4 locally

Author: ecraig12345

.github/workflows/docsite.yml

@@ -32,11 +32,11 @@ jobs:
             exit 1
           fi
 
-      # The docs have a separate installation using Node 22 due to needing newer dependencies
+      # The docs have a separate installation
       - name: Install Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version-file: docs/.nvmrc
+          node-version-file: .nvmrc
 
       - run: yarn --immutable
         working-directory: ./docs

.github/workflows/pr.yml

@@ -22,26 +22,20 @@ jobs:
       fail-fast: false
       matrix:
         include:
+          # node 22/npm 10 on ubuntu and windows
           - os: ubuntu-latest
-            # npm 6 and 8 have slightly different behavior with verdaccio in publishing tests.
-            # It's unclear if this translates to meaningful differences in behavior in actual scenarios,
-            # but test against both versions to be safe. (Only do this on the ubuntu build for speed.)
-            npm: 6
-            node: 14
-          # node 14/npm 8 on ubuntu and windows
-          - os: ubuntu-latest
-            npm: 8
-            node: 14
+            npm: 10
+            node: 22
           - os: windows-latest
-            npm: 8
-            node: 14
-          # node 20/npm 11 on ubuntu and windows (can't use 22 for reasons described in release.yml)
+            npm: 10
+            node: 22
+          # node 24/npm 11 on ubuntu and windows
           - os: ubuntu-latest
             npm: 11
-            node: 20
+            node: 24
           - os: windows-latest
             npm: 11
-            node: 20
+            node: 24
 
     name: build (${{ matrix.os }}, node ${{ matrix.node }}, npm ${{ matrix.npm }})
 
@@ -57,21 +51,21 @@ jobs:
           cache: yarn
           node-version: ${{ matrix.node }}
 
-      # Guarantee a predictable version of npm for the first round of tests
+      # Guarantee a predictable version of npm
       - name: Install npm@${{ matrix.npm }}
         run: npm install --global npm@${{ matrix.npm }}
 
-      - run: yarn --frozen-lockfile
+      - run: yarn --immutable
 
       - run: yarn build --verbose
 
       - run: yarn checkchange --verbose
 
       - run: yarn format:check
-        if: matrix.os == 'ubuntu-latest' && matrix.node == 14 && matrix.npm == 8
+        if: matrix.os == 'ubuntu-latest' && matrix.node == 22
 
       - run: yarn lint:ci
-        if: matrix.os == 'ubuntu-latest' && matrix.node == 14 && matrix.npm == 8
+        if: matrix.os == 'ubuntu-latest' && matrix.node == 22
 
       - run: yarn test --verbose
         id: test
@@ -97,7 +91,7 @@ jobs:
           path: ${{ env.NPM_CACHE_DIR }}/_logs
           retention-days: 3
 
-  # The docs have a separate installation using Node 22 due to needing newer dependencies
+  # The docs have a separate installation
   docs:
     name: build docs
 
@@ -111,7 +105,7 @@ jobs:
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
           cache: yarn
-          node-version-file: ./docs/.nvmrc
+          node-version-file: .nvmrc
 
       - run: yarn --immutable
         working-directory: ./docs

.github/workflows/release.yml

@@ -4,11 +4,8 @@ name: Release
 on:
   workflow_dispatch:
 
-# Use newer node and npm for trusted publishing support. Can't use node 22 yet because of test issues.
-# (`npm login` hangs with the current verdaccio version; this is fixed in latest verdaccio, but it's
-# not compatible with old node)
 env:
-  nodeVersion: 20
+  nodeVersion: 24
   npmVersion: 11
 
 concurrency:
@@ -50,7 +47,7 @@ jobs:
       - name: Install npm@${{ env.npmVersion }}
         run: npm install --global npm@${{ env.npmVersion }}
 
-      - run: yarn --frozen-lockfile
+      - run: yarn --immutable
 
       - run: yarn build --verbose
 

.gitignore

@@ -9,11 +9,13 @@ lib/
 package-lock.json
 target
 .claude/settings.local.json
-# ignore when switching between yarn 1/4 branches
-/.yarn
 
 docs/.vuepress/.cache
 docs/.vuepress/.temp
-docs/.yarn/*
-!docs/.yarn/patches/
-!docs/.yarn/releases/
+docs/.yarn
+
+.yarn/*
+!.yarn/patches/
+!.yarn/releases/
+# Ignore this in case a local .npmrc is added with a token for publishing
+.npmrc

.nvmrc

@@ -1 +1 @@
-14
+22

.prettierignore

@@ -1,3 +1,4 @@
+.yarn/
 *.log
 *.patch
 *.snap

.vscode/launch.json

@@ -14,10 +14,7 @@
       "args": ["--", "--runInBand", "--watch", "--testTimeout=1000000", "${file}"],
       "sourceMaps": true,
       "outputCapture": "std",
-      "console": "integratedTerminal",
-      // Debug with Node 14 via nvm.
-      // On Windows, you might have to change this to a specific version.
-      "runtimeVersion": "14"
+      "console": "integratedTerminal"
     },
     {
       "type": "node",
@@ -56,8 +53,7 @@
         "--runTestsByPath",
         "${jest.testFile}"
       ],
-      "console": "integratedTerminal",
-      "runtimeVersion": "14"
+      "console": "integratedTerminal"
     }
   ]
 }

docs/.yarn/releases/yarn-4.14.1.cjs .yarn/releases/yarn-4.14.1.cjsdocs/.yarn/releases/yarn-4.14.1.cjs renamed to .yarn/releases/yarn-4.14.1.cjs

@@ -0,0 +1,16 @@
+approvedGitRepositories:
+  - '**'
+
+enableScripts: true
+
+nodeLinker: node-modules
+
+npmMinimalAgeGate: 3d
+
+npmPreapprovedPackages:
+  - lage
+  - workspace-tools
+
+preferReuse: true
+
+yarnPath: .yarn/releases/yarn-4.14.1.cjs

.yarnrc.yml

@@ -6,15 +6,18 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 Beachball is a CLI tool for automating semantic version bumping, changelog generation, and npm publishing in monorepos and single-package repos.
 
+## Branches
+
+- `v2`: the current stable release branch from `beachball@latest` and the doc site are published.
+- `main`: contains development work for the next major release of beachball, version 3. Breaking changes are allowed if necessary.
+
 ## Monorepo structure
 
 - `packages/beachball`: `beachball` package
 - `scripts`: repo-internal scripts (`@microsoft/beachball-scripts`)
 
 ## Commands
 
-Beachball currently uses Node 14. Before running tests, you may need to activate `nvm`: on Mac or Linux, `source ~/.nvm/nvm.sh && nvm use`.
-
 ### Top-level
 
 These commands work at the top level of the monorepo.
@@ -124,7 +127,7 @@ Test helpers in `src/__fixtures__/` provide mock factories for repos, logs, pack
 
 ## Documentation site
 
-The doc site uses Vuepress and is located under `/docs`. It uses a separate yarn installation with Node 22 + Yarn 4 to get rid of very outdated deps while keeping beachball v2 on Node 14.
+The doc site uses Vuepress and is located under `/docs`. It uses a separate yarn installation to keep the docs dependencies separate.
 
 ### Editing and validating docs