Revert "chore(node): upgrade repo runtime to Node.js 24"

.github/workflows/chromatic.yml

@@ -56,7 +56,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -100,7 +100,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/ci.yml

@@ -35,7 +35,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
 
       - name: Detect changes
         id: filter
@@ -82,7 +82,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -106,7 +106,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -133,7 +133,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -161,7 +161,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -209,7 +209,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -237,7 +237,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -282,7 +282,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Setup Bun
@@ -317,7 +317,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Setup Bun
@@ -356,7 +356,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/deploy-kiloclaw.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/deploy-production.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -65,7 +65,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -119,7 +119,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/deploy-workers.yml

@@ -54,7 +54,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -148,7 +148,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/kilo-app-ci.yml

@@ -41,7 +41,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -67,7 +67,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -93,7 +93,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -120,7 +120,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/kilo-app-release.yml

@@ -65,7 +65,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
-          node-version-file: '.nvmrc'
+          node-version: 22
           cache: 'pnpm'
 
       - name: Install dependencies

.nvmrc

@@ -1 +1 @@
-24.14.1
+22

DEVELOPMENT.md

@@ -32,9 +32,9 @@ git lfs install --skip-repo
 
 The `--skip-repo` flag avoids conflicts with the project's Husky hooks. Git LFS is used for large binary files (videos).
 
-### Node.js 24.14.1 (via nvm)
+### Node.js 22 (via nvm)
 
-The project requires Node.js 24.14.1 locally (see `.nvmrc`) and accepts any Node.js 24.x runtime in `package.json` `engines`.
+The project requires Node.js 22 (see `.nvmrc` and `package.json` `engines` field).
 
 ```bash
 brew install nvm
@@ -50,10 +50,12 @@ export NVM_DIR="$HOME/.nvm"
 [ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"
 ```
 
-Then reload your shell:
+Then reload your shell and install Node 22:
 
 ```bash
 source ~/.zshrc
+nvm install 22
+nvm use 22
 ```
 
 ### pnpm
@@ -95,13 +97,12 @@ brew install stripe/stripe-cli/stripe
 ```bash
 git clone git@github.com:Kilo-Org/cloud.git
 cd cloud
-nvm install
-nvm use
 ```
 
 ### 2. Install dependencies and pull LFS assets
 
 ```bash
+nvm use 22
 pnpm install
 git lfs pull
 ```
@@ -368,11 +369,11 @@ With `auto`, the primary worktree gets offset 0 (default ports), and secondary w
 
 ### Node version mismatch
 
-If you see errors about unsupported Node.js versions, ensure you're using the pinned Node 24 release:
+If you see errors about unsupported Node.js versions, ensure you're using Node 22:
 
 ```bash
-nvm use
-node --version  # Should output v24.14.1
+nvm use 22
+node --version  # Should output v22.x.x
 ```
 
 ### Database connection errors
@@ -392,7 +393,7 @@ The dev server won't start without environment variables. Run `vercel env pull`
 
 ### `pnpm install` fails with engine mismatch
 
-This means your active Node.js version doesn't match the supported 24.x range in `package.json`. Switch to the pinned local version with `nvm use`.
+This means your active Node.js version doesn't match the `engines` field in `package.json`. Switch to Node 22 with `nvm use 22`.
 
 ### Git LFS files show as pointer files
 

cloud-agent-next/package.json

@@ -44,7 +44,7 @@
     "@cloudflare/containers": "0.1.1",
     "@cloudflare/vitest-pool-workers": "^0.12.21",
     "@types/jsonwebtoken": "catalog:",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "@vitest/ui": "^3.2.4",
     "drizzle-kit": "catalog:",

cloud-agent/package.json

@@ -41,7 +41,7 @@
     "@cloudflare/vitest-pool-workers": "^0.12.21",
     "@cloudflare/workers-types": "catalog:",
     "@types/jsonwebtoken": "catalog:",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "@vitest/ui": "^3.2.4",
     "drizzle-kit": "catalog:",

cloudflare-app-builder/package.json

@@ -28,7 +28,7 @@
     "@cloudflare/sandbox": "0.7.13",
     "@cloudflare/workers-types": "catalog:",
     "@types/jsonwebtoken": "catalog:",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "drizzle-kit": "catalog:",
     "tsx": "^4.21.0",

cloudflare-db-proxy/package.json

@@ -20,7 +20,7 @@
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.12.21",
     "@types/jest": "^30.0.0",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "jest": "^30.3.0",
     "ts-jest": "^29.4.6",

cloudflare-deploy-infra/builder-docker-container/Dockerfile

@@ -28,8 +28,8 @@ ENV PATH="/root/.local/bin:${PATH}"
 # These are fallback versions when .tool-versions is not present
 # Users can override by providing .tool-versions in their project
 
-# Node.js versions (18, 20, 22, 24)
-RUN mise install node@18 node@20 node@22 node@24
+# Node.js versions (18, 20, 22)
+RUN mise install node@18 node@20 node@22
 
 # Ruby versions (3.2, 3.3)
 RUN mise install ruby@3.2 ruby@3.3
@@ -41,7 +41,7 @@ RUN mise install hugo@0.152.2 hugo@0.120.0
 RUN mise install go@1.25.4
 
 # Set default global versions (can be overridden by .tool-versions)
-RUN mise use -g node@24 ruby@3.3 hugo@0.152.2 go@1.25.4
+RUN mise use -g node@22 ruby@3.3 hugo@0.152.2 go@1.25.4
 
 # Build tool versions
 ARG OPENNEXTJS_VERSION=1.14.8

cloudflare-deploy-infra/builder/package.json

@@ -28,7 +28,7 @@
     "@cloudflare/workers-types": "catalog:",
     "@sentry/cli": "^2.58.5",
     "@types/jest": "^29.5.14",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@types/tar-stream": "^3.1.4",
     "@typescript/native-preview": "catalog:",
     "jest": "^29.7.0",

cloudflare-gastown/container/Dockerfile

@@ -3,7 +3,7 @@ FROM oven/bun:1-slim
 # Install git, gh CLI, and Node.js (required by @kilocode/cli which uses #!/usr/bin/env node)
 RUN apt-get update && \
     apt-get install -y --no-install-recommends git git-lfs curl ca-certificates && \
-    curl -fsSL https://deb.nodesource.com/setup_24.x | bash - && \
+    curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
     apt-get install -y --no-install-recommends nodejs && \
     curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
       -o /usr/share/keyrings/githubcli-archive-keyring.gpg && \

cloudflare-gastown/container/Dockerfile.dev

@@ -3,7 +3,7 @@ FROM --platform=linux/arm64 oven/bun:1-slim
 # Install git, gh CLI, and Node.js (required by @kilocode/cli which uses #!/usr/bin/env node)
 RUN apt-get update && \
     apt-get install -y --no-install-recommends git git-lfs curl ca-certificates && \
-    curl -fsSL https://deb.nodesource.com/setup_24.x | bash - && \
+    curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
     apt-get install -y --no-install-recommends nodejs && \
     curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
       -o /usr/share/keyrings/githubcli-archive-keyring.gpg && \

cloudflare-gastown/package.json

@@ -43,7 +43,7 @@
     "@cloudflare/workers-types": "catalog:",
     "@sentry/cli": "^2.58.2",
     "@types/jsonwebtoken": "catalog:",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22",
     "@typescript/native-preview": "7.0.0-dev.20251019.1",
     "typescript": "catalog:",
     "vitest": "^3.2.4",

cloudflare-images-mcp/package.json

@@ -21,7 +21,7 @@
   "devDependencies": {
     "@cloudflare/workers-types": "catalog:",
     "@types/jsonwebtoken": "catalog:",
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "typescript": "catalog:",
     "vitest": "^3.2.4",

cloudflare-security-auto-analysis/package.json

@@ -18,7 +18,7 @@
     "zod": "catalog:"
   },
   "devDependencies": {
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "typescript": "catalog:",
     "vitest": "^3.2.4",

cloudflare-security-sync/package.json

@@ -16,7 +16,7 @@
     "zod": "catalog:"
   },
   "devDependencies": {
-    "@types/node": ">=24 <25",
+    "@types/node": "^22.19.15",
     "@typescript/native-preview": "catalog:",
     "typescript": "catalog:",
     "wrangler": "^4.73.0"