Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

fix: require patched Node 24.22.1 across images and validation

Alfredo Lopez18656c9d575b
diff --git a/.github/workflows/ci-public.yml b/.github/workflows/ci-public.yml
index 5be8cc649..3b61e2319 100644
--- a/.github/workflows/ci-public.yml
+++ b/.github/workflows/ci-public.yml
@@ -36,6 +36,95 @@ jobs:
exit 1
fi
+ node-runtime-images:
+ name: Node image runtime (${{ matrix.variant.name }}, ${{ matrix.arch }})
+ runs-on: ${{ matrix.arch == 'arm64' && 'ubuntu-24.04-arm' || 'ubuntu-latest' }}
+ timeout-minutes: 45
+ strategy:
+ fail-fast: false
+ matrix:
+ arch: [amd64, arm64]
+ variant:
+ - name: host-alpine
+ dockerfile: mcp-host/Dockerfile
+ context: .
+ host: true
+ - name: host-slim
+ dockerfile: mcp-host/Dockerfile.slim
+ context: .
+ host: true
+ - name: host-full
+ dockerfile: mcp-host/Dockerfile.full
+ context: .
+ host: true
+ - name: host-desktop
+ dockerfile: mcp-host/Dockerfile.desktop
+ context: .
+ host: true
+ - name: playwright
+ dockerfile: mcp-servers/playwright/Dockerfile
+ context: mcp-servers/playwright
+ - name: reference-hook
+ dockerfile: hooks/reference-guardrail-hook/Dockerfile
+ context: hooks/reference-guardrail-hook
+ - name: sandbox-ui
+ dockerfile: workflow-recipes/samples/sandbox-ui-test-harness/Dockerfile
+ context: workflow-recipes/samples/sandbox-ui-test-harness
+ steps:
+ - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+ - name: Build the final runtime image
+ run: timeout 2400 docker build --pull -f '${{ matrix.variant.dockerfile }}' -t runtime-smoke '${{ matrix.variant.context }}'
+ - name: Verify the effective Node runtime
+ run: |
+ actual=$(timeout 30 docker run --rm --network none --entrypoint node runtime-smoke -p 'process.versions.node')
+ test "$actual" = "$(tr -d '[:space:]' < .nvmrc)"
+ - name: Verify Host native modules and default SDK transport
+ if: matrix.variant.host == true
+ run: |
+ timeout 60 docker run --rm -i --network none --entrypoint node --workdir /app/mcp-host runtime-smoke <<'NODE'
+ const assert = require('node:assert/strict');
+ const { createServer } = require('node:http');
+ const { gzipSync } = require('node:zlib');
+ const Database = require('better-sqlite3');
+ const { createCanvas } = require('@napi-rs/canvas');
+ const { OpenAICompatibleProvider } = require('./dist/llm/openaiCompatible.js');
+ const db = new Database(':memory:');
+ assert.equal(db.prepare('SELECT 42 AS value').get().value, 42);
+ db.close();
+ const canvas = createCanvas(10, 10);
+ canvas.getContext('2d').fillRect(0, 0, 10, 10);
+ assert.ok(canvas.toBuffer('image/png').length > 0);
+ let requests = 0;
+ const server = createServer((request, response) => {
+ request.resume();
+ request.on('end', () => {
+ requests++;
+ const body = gzipSync(Buffer.from(JSON.stringify({ choices: [{ message: { content: 'complete' }, finish_reason: 'stop' }] })));
+ response.writeHead(200, { 'Content-Type': 'application/json', 'Content-Encoding': 'gzip' });
+ response.write(body.subarray(0, 7));
+ setImmediate(() => response.end(body.subarray(7)));
+ });
+ });
+ server.listen(0, '127.0.0.1', async () => {
+ try {
+ const baseURL = `http://127.0.0.1:${server.address().port}/v1`;
+ const provider = new OpenAICompatibleProvider({ id: 'zai', baseURL, defaultModel: 'runtime-http-test' }, 'local-http-fixture');
+ const result = await provider.completeSingleTurn([{ role: 'user', content: 'read' }], { signal: AbortSignal.timeout(5000) });
+ assert.equal(result.content, 'complete');
+ assert.equal(requests, 1);
+ } catch (error) {
+ console.error(error);
+ process.exitCode = 1;
+ } finally {
+ server.closeAllConnections();
+ server.close();
+ }
+ });
+ NODE
+ - name: Verify the Playwright application loads on the patched runtime
+ if: matrix.variant.name == 'playwright'
+ run: timeout 30 docker run --rm --network none --entrypoint node runtime-smoke /app/cli.js --version
+
test:
name: Build / test / typecheck (${{ matrix.service }})
runs-on: ubuntu-latest
@@ -99,7 +188,7 @@ jobs:
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
- node-version: '24'
+ node-version-file: .nvmrc
cache: npm
cache-dependency-path: ${{ matrix.service }}/package-lock.json
@@ -287,7 +376,7 @@ jobs:
timeout-minutes: 10
run: |
node ../../scripts/minikube/run-with-deadline.mjs --timeout-seconds 300 --heartbeat-seconds 20 --kill-grace-seconds 5 --label web-search-ci-image-build -- \
- docker build --build-arg NODE_IMAGE=mirror.gcr.io/library/node:24-alpine -t issue198-ci-image:test .
+ docker build --build-arg NODE_IMAGE=mirror.gcr.io/library/node:24.22.1-alpine -t issue198-ci-image:test .
web_search_image_id="$(node ../../scripts/minikube/run-with-deadline.mjs --timeout-seconds 10 --heartbeat-seconds 5 --kill-grace-seconds 5 --label web-search-ci-image-inspect -- \
docker image inspect issue198-ci-image:test --format '{{.Id}}')"
node test/run-network.mjs --image "$web_search_image_id"
@@ -386,7 +475,7 @@ jobs:
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
- node-version: '24'
+ node-version-file: .nvmrc
cache: npm
cache-dependency-path: control-api/package-lock.json
@@ -545,7 +634,7 @@ jobs:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
- node-version: '24'
+ node-version-file: .nvmrc
cache: npm
cache-dependency-path: control-ui/package-lock.json
- name: Install frontend components dependencies
@@ -568,7 +657,7 @@ jobs:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
- node-version: '24'
+ node-version-file: .nvmrc
cache: npm
cache-dependency-path: tests/e2e/package-lock.json
- name: Run descriptor-bound fixture unit suites
@@ -629,7 +718,7 @@ jobs:
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
if: steps.token_check.outputs.skip != 'true'
with:
- node-version: '24'
+ node-version-file: .nvmrc
cache: 'npm'
cache-dependency-path: |
workflow-recipes/package-lock.json
@@ -688,7 +777,7 @@ jobs:
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
- node-version: '24'
+ node-version-file: .nvmrc
- name: Run bash -n on all .sh files
run: |
@@ -702,6 +791,9 @@ jobs:
done < <(find deploy/scripts scripts -type f -name '*.sh' 2>/dev/null)
exit $fail
+ - name: Verify Node security version policy
+ run: node --test scripts/tests/node-runtime-version.test.mjs
+
- name: Validate governed tracing operations gate orchestration
run: bash scripts/tests/test-governed-tracing-operations-gate.sh
diff --git a/.nvmrc b/.nvmrc
index a45fd52cc..ce62013c3 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-24
+24.22.1
diff --git a/channel-reader/Dockerfile b/channel-reader/Dockerfile
index 44ca2ef9a..741265187 100644
--- a/channel-reader/Dockerfile
+++ b/channel-reader/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -16,7 +16,7 @@ COPY src ./src
RUN npm run build
# Production image
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/channel-reader/package-lock.json b/channel-reader/package-lock.json
index 0094f5a57..c631bb390 100644
--- a/channel-reader/package-lock.json
+++ b/channel-reader/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-channel-reader",
- "version": "0.1.108",
+ "version": "0.1.109",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-channel-reader",
- "version": "0.1.108",
+ "version": "0.1.109",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@kubernetes/client-node": "^1.0.0",
@@ -22,7 +22,7 @@
"vitest": "^4.1.0"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/channel-reader/package.json b/channel-reader/package.json
index 2bdc46f47..a8c7beea3 100644
--- a/channel-reader/package.json
+++ b/channel-reader/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-channel-reader",
- "version": "0.1.108",
+ "version": "0.1.109",
"description": "Watches CommunicationChannel CRDs and fetches messages from Telegram, Email, and Slack",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/codex-llm-proxy/Dockerfile b/codex-llm-proxy/Dockerfile
index cfa0e53b3..a8bf43f5d 100644
--- a/codex-llm-proxy/Dockerfile
+++ b/codex-llm-proxy/Dockerfile
@@ -1,6 +1,6 @@
# BUILD CONTEXT = repo root. The proxy consumes
# @clerum/llm-provider-attempt-contract via file:.
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a AS builder
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS builder
WORKDIR /app
COPY packages/llm-provider-attempt-contract ./packages/llm-provider-attempt-contract
@@ -11,7 +11,7 @@ COPY codex-llm-proxy/tsconfig.json codex-llm-proxy/tsconfig.build.json ./
COPY codex-llm-proxy/src ./src
RUN npm run build
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53
WORKDIR /app
COPY packages/llm-provider-attempt-contract ./packages/llm-provider-attempt-contract
diff --git a/codex-llm-proxy/package-lock.json b/codex-llm-proxy/package-lock.json
index a33542536..9649ed8af 100644
--- a/codex-llm-proxy/package-lock.json
+++ b/codex-llm-proxy/package-lock.json
@@ -27,7 +27,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/llm-provider-attempt-contract": {
diff --git a/codex-llm-proxy/package.json b/codex-llm-proxy/package.json
index 7db200526..ceb9b1e5c 100644
--- a/codex-llm-proxy/package.json
+++ b/codex-llm-proxy/package.json
@@ -4,7 +4,7 @@
"description": "Bounded Codex subscription transport process. No database, Kubernetes, or tool execution.",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc -p tsconfig.build.json",
diff --git a/codex-llm-proxy/test/requestLimits.test.ts b/codex-llm-proxy/test/requestLimits.test.ts
index b1d22487a..eeea022af 100644
--- a/codex-llm-proxy/test/requestLimits.test.ts
+++ b/codex-llm-proxy/test/requestLimits.test.ts
@@ -12,7 +12,7 @@ import {
} from '../src/requestLimits.js'
import { DEFAULT_HEARTBEAT_INTERVAL_MS, MAX_HEARTBEAT_INTERVAL_MS } from '../src/sseHeartbeat.js'
-// undici's default headersTimeout and bodyTimeout in the Node 24.16.0 image the
+// undici's default headersTimeout and bodyTimeout in the Node 24.22.1 image the
// Host runs; the Host sets neither for its proxy calls.
const HOST_UNDICI_TIMEOUT_MS = 300_000
diff --git a/control-api/Dockerfile b/control-api/Dockerfile
index e4b41c64c..ebe73d4b5 100644
--- a/control-api/Dockerfile
+++ b/control-api/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
# Prebuilt policy and POSIX store: copy only the production exports and types.
@@ -40,7 +40,7 @@ RUN npm prune --production
# TypeScript/Vitest toolchain was needed only until both package/service builds.
RUN npm --prefix /app/packages/workflow-runtime-core prune --omit=dev
-FROM node:24-alpine
+FROM node:24.22.1-alpine
RUN addgroup -S app && adduser -S app -G app
WORKDIR /app
diff --git a/control-api/package-lock.json b/control-api/package-lock.json
index a45491636..7a33a995d 100644
--- a/control-api/package-lock.json
+++ b/control-api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-api",
- "version": "0.1.786",
+ "version": "0.1.787",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-api",
- "version": "0.1.786",
+ "version": "0.1.787",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/grok-provider-attempt-contract": "file:../packages/grok-provider-attempt-contract",
@@ -43,7 +43,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/display-field": {
diff --git a/control-api/package.json b/control-api/package.json
index 8b27b361e..739bca36c 100644
--- a/control-api/package.json
+++ b/control-api/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-control-api",
- "version": "0.1.786",
+ "version": "0.1.787",
"description": "Internal Clerum control plane REST API + UI for managing CRDs and secrets",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc && node -e \"const fs=require('fs'); for (const file of ['dist/main.js','dist/migrate.js','dist/traceMaintenance.js']) { if (!fs.existsSync(file)) { throw new Error('Missing build artifact: ' + file); } }\"",
diff --git a/control-ui/Dockerfile b/control-ui/Dockerfile
index 4a817202b..89a75fce8 100644
--- a/control-ui/Dockerfile
+++ b/control-ui/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
ARG CONTROL_API_INTERNAL_URL=http://control-api.control-plane.svc.cluster.local:8090
@@ -34,7 +34,7 @@ COPY scripts/qa-recorder /app/scripts/qa-recorder
COPY control-ui ./
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
RUN addgroup -S app && adduser -S app -G app
WORKDIR /app
diff --git a/control-ui/package-lock.json b/control-ui/package-lock.json
index 15c63a871..c8e6c55d0 100644
--- a/control-ui/package-lock.json
+++ b/control-ui/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-ui",
- "version": "0.1.735",
+ "version": "0.1.736",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-ui",
- "version": "0.1.735",
+ "version": "0.1.736",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/frontend-components": "file:../packages/frontend-components",
diff --git a/control-ui/package.json b/control-ui/package.json
index aedbdfe14..e0dec5632 100644
--- a/control-ui/package.json
+++ b/control-ui/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-ui",
- "version": "0.1.735",
+ "version": "0.1.736",
"private": true,
"scripts": {
"dev": "NEXT_IGNORE_INCORRECT_LOCKFILE=1 next dev",
diff --git a/deploy/overlays/minikube/fake-telegram/deployment.yaml b/deploy/overlays/minikube/fake-telegram/deployment.yaml
index b466e390a..7c2e64d82 100644
--- a/deploy/overlays/minikube/fake-telegram/deployment.yaml
+++ b/deploy/overlays/minikube/fake-telegram/deployment.yaml
@@ -24,7 +24,7 @@ spec:
type: RuntimeDefault
containers:
- name: server
- image: node:24-alpine
+ image: node:24.22.1-alpine
imagePullPolicy: IfNotPresent
command: ["node", "/app/server.cjs"]
securityContext:
diff --git a/desktop-app/README.md b/desktop-app/README.md
index a71458199..840717f10 100644
--- a/desktop-app/README.md
+++ b/desktop-app/README.md
@@ -127,7 +127,7 @@ npm run start
## Package and Sign
-Desktop builds need Node 24, an `npm ci` with lifecycle scripts enabled (never
+Desktop builds need Node 24.22.1 or later in the Node 24 line, an `npm ci` with lifecycle scripts enabled (never
`--ignore-scripts`, never `ELECTRON_SKIP_BINARY_DOWNLOAD`), and a passing
`npm run verify:electron` before any build or test result counts.
diff --git a/desktop-app/package-lock.json b/desktop-app/package-lock.json
index a05eec175..3d0de031e 100644
--- a/desktop-app/package-lock.json
+++ b/desktop-app/package-lock.json
@@ -53,7 +53,7 @@
"wait-on": "^8.0.5"
},
"engines": {
- "node": "24.x"
+ "node": "^24.22.1"
}
},
"../packages/desktop-app-links": {
diff --git a/desktop-app/package.json b/desktop-app/package.json
index d5b86f643..39cb8c133 100644
--- a/desktop-app/package.json
+++ b/desktop-app/package.json
@@ -91,7 +91,7 @@
"wait-on": "^8.0.5"
},
"engines": {
- "node": "24.x"
+ "node": "^24.22.1"
},
"overrides": {
"@tootallnate/once": "^3.0.1",
diff --git a/desktop-app/scripts/verify-electron-runtime.mjs b/desktop-app/scripts/verify-electron-runtime.mjs
index 861b9e187..dd70f5db8 100644
--- a/desktop-app/scripts/verify-electron-runtime.mjs
+++ b/desktop-app/scripts/verify-electron-runtime.mjs
@@ -1,18 +1,13 @@
import fs from 'node:fs'
+import { assertNodeVersion } from '../../scripts/check-node-version.mjs'
// Desktop validation is the one place the Node major is contractual: the
// Electron postinstall and the prebuilt runtime are matched to Node 24, and CI
-// pins node-version 24. The quickstart prereq check only enforces a >= 24
-// floor, so assert the exact major here instead of blocking the whole install.
+// pins the security patch in .nvmrc. The quickstart permits newer majors;
+// Desktop requires the same patched runtime within Node 24.
// This runs before Electron is imported: a static import hoists above the check
// and would report ERR_MODULE_NOT_FOUND on a wrong runtime instead of saying so.
-const nodeMajor = Number.parseInt(process.versions.node.split('.')[0], 10)
-if (nodeMajor !== 24) {
- throw new Error(
- `Desktop validation requires Node 24.x; found v${process.versions.node}. ` +
- 'Switch to Node 24 and rerun npm ci with lifecycle scripts enabled.'
- )
-}
+assertNodeVersion(process.versions.node, { major: 24 })
let electronPath
try {
diff --git a/desktop-app/test/e2e-playwright/third-party-authn-third-party-mcphost/figureDProviderResources.ts b/desktop-app/test/e2e-playwright/third-party-authn-third-party-mcphost/figureDProviderResources.ts
index 4232f1d6e..c800b8f3a 100644
--- a/desktop-app/test/e2e-playwright/third-party-authn-third-party-mcphost/figureDProviderResources.ts
+++ b/desktop-app/test/e2e-playwright/third-party-authn-third-party-mcphost/figureDProviderResources.ts
@@ -67,7 +67,7 @@ spec:
spec:
containers:
- name: ${app}
- image: node:24-alpine
+ image: node:24.22.1-alpine
command: ["node", "/app/server.js"]
ports:
- containerPort: 8099
diff --git a/docs/deploy/minikube.md b/docs/deploy/minikube.md
index bdc35599c..40276e254 100644
--- a/docs/deploy/minikube.md
+++ b/docs/deploy/minikube.md
@@ -48,7 +48,7 @@ Ready before E2E results are interpreted.
- **minikube** v1.30+ (`brew install minikube`)
- **kubectl** (`brew install kubectl`)
- **python3** (for JWT key sync)
-- **Node.js** 24+ (for building services and desktop app)
+- **Node.js** 24.22.1 or later (Node 24 is required for Desktop and the validation harness)
- **git**, **make**, and **ruby** (ruby renders the control-api DB migration overlay)
- `.env` file at project root with LLM API keys (optional — uses placeholders if missing)
diff --git a/docs/get-started/dev-mode.md b/docs/get-started/dev-mode.md
index 85a69a07c..1d3573dfc 100644
--- a/docs/get-started/dev-mode.md
+++ b/docs/get-started/dev-mode.md
@@ -14,7 +14,7 @@ native tool, guardrails or an MCP server.
## Run mcp-host locally
-You need Node.js 24 and an API key for one
+You need Node.js 24.22.1 or later in the Node 24 line and an API key for one
[supported provider](../llm-providers/README.md).
mcp-host has no setting to bind only to localhost, and with
diff --git a/docs/get-started/quickstart.md b/docs/get-started/quickstart.md
index d3cb9b559..237869488 100644
--- a/docs/get-started/quickstart.md
+++ b/docs/get-started/quickstart.md
@@ -15,7 +15,7 @@ named `chatllm` you can message immediately.
- **minikube** v1.30+ (`brew install minikube`)
- **kubectl**
- **python3** (used by the JWT key sync)
-- **Node.js 24+** (service builds; desktop app)
+- **Node.js 24.22.1 or later** (use the Node 24 version pinned in `.nvmrc` for Desktop and the validation harness)
- **git**, **make**, and **ruby** (ruby renders the control-api DB migration
overlay; ships with macOS, `apt-get install ruby` on Debian/Ubuntu)
- One LLM API key. Setup picks the agent's provider automatically from
diff --git a/docs/surfaces/desktop-app.md b/docs/surfaces/desktop-app.md
index aa7586a34..c4efb0f16 100644
--- a/docs/surfaces/desktop-app.md
+++ b/docs/surfaces/desktop-app.md
@@ -182,15 +182,15 @@ makers:
### Prepare the toolchain
-Packaging uses the same guard as every other Desktop build. Use Node 24
-(`engines.node` is `24.x`), install with `npm ci` **without**
+Packaging uses the same guard as every other Desktop build. Use Node 24.22.1 or later in the Node 24 line
+(`engines.node` is `^24.22.1`), install with `npm ci` **without**
`--ignore-scripts` so Electron's `postinstall` downloads the runtime, then run
the check:
```bash
cd desktop-app
npm ci
-npm run verify:electron # fails unless Node is 24.x and `electron` resolves to a runtime
+npm run verify:electron # fails unless Node is 24.x >=24.22.1 and `electron` resolves to a runtime
```
A skipped `postinstall` still lets `npm ci` exit 0; `verify:electron` is what
diff --git a/docs/testing/e2e-guide.md b/docs/testing/e2e-guide.md
index 16913bc9c..835cb8cbc 100644
--- a/docs/testing/e2e-guide.md
+++ b/docs/testing/e2e-guide.md
@@ -16,7 +16,7 @@ From root `README.md` §Testing prerequisites:
- **Docker Desktop** running
- **minikube** installed (`brew install minikube`)
- **kubectl** configured
-- **Node.js 24+** for unit tests
+- **Node.js 24.22.1 or later in the Node 24 line** for unit tests
- `.env` file at repo root with LLM API keys:
| Variable | Required For | How to Get |
diff --git a/external-rest-api/Dockerfile b/external-rest-api/Dockerfile
index 1cc43c85a..a63453de3 100644
--- a/external-rest-api/Dockerfile
+++ b/external-rest-api/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
COPY packages/jwt-key-policy/package.json packages/jwt-key-policy/index.cjs packages/jwt-key-policy/index.d.ts packages/jwt-key-policy/dev-store.cjs packages/jwt-key-policy/dev-store.d.ts ./packages/jwt-key-policy/
@@ -11,7 +11,7 @@ COPY external-rest-api/src ./src
RUN npm run build
RUN npm prune --production
-FROM node:24-alpine
+FROM node:24.22.1-alpine
RUN addgroup -S app && adduser -S app -G app
WORKDIR /app
diff --git a/external-rest-api/package-lock.json b/external-rest-api/package-lock.json
index 8646f53c4..01e66f3e1 100644
--- a/external-rest-api/package-lock.json
+++ b/external-rest-api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-external-rest-api",
- "version": "0.1.135",
+ "version": "0.1.136",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-external-rest-api",
- "version": "0.1.135",
+ "version": "0.1.136",
"dependencies": {
"@clerum/jwt-key-policy": "file:../packages/jwt-key-policy",
"cors": "^2.8.5",
@@ -30,7 +30,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/jwt-key-policy": {
diff --git a/external-rest-api/package.json b/external-rest-api/package.json
index fd6ea41a9..43a2d4544 100644
--- a/external-rest-api/package.json
+++ b/external-rest-api/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-external-rest-api",
- "version": "0.1.135",
+ "version": "0.1.136",
"description": "External REST API for profile, team management, and RPC token brokerage",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/external-rest-api/src/releaseManifest.ts b/external-rest-api/src/releaseManifest.ts
index a789c7299..4b6d9a401 100644
--- a/external-rest-api/src/releaseManifest.ts
+++ b/external-rest-api/src/releaseManifest.ts
@@ -8,8 +8,8 @@ export type ReleaseManifest = {
export const releaseManifest: ReleaseManifest = {
releaseId: 'v0.11.0',
- externalRestApiVersion: '0.1.135',
- rpcProxyVersion: '0.1.126',
+ externalRestApiVersion: '0.1.136',
+ rpcProxyVersion: '0.1.127',
desktopVersion: '0.11.0',
minimumDesktopVersion: '0.1.252',
}
diff --git a/gfs-controller/Dockerfile b/gfs-controller/Dockerfile
index f7db558b0..55a135d18 100644
--- a/gfs-controller/Dockerfile
+++ b/gfs-controller/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -11,7 +11,7 @@ COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/gfs-controller/package-lock.json b/gfs-controller/package-lock.json
index 4bc69f9eb..94f8ebb40 100644
--- a/gfs-controller/package-lock.json
+++ b/gfs-controller/package-lock.json
@@ -20,7 +20,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/gfs-controller/package.json b/gfs-controller/package.json
index 7961e4fd0..41bd3254a 100644
--- a/gfs-controller/package.json
+++ b/gfs-controller/package.json
@@ -4,7 +4,7 @@
"description": "gfs-controller (gfsc) — brokered HTTP file API over the Global File System drive",
"main": "dist/index.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/grok-llm-proxy/Dockerfile b/grok-llm-proxy/Dockerfile
index aa43e7a1c..4a5ab2ff5 100644
--- a/grok-llm-proxy/Dockerfile
+++ b/grok-llm-proxy/Dockerfile
@@ -1,6 +1,6 @@
# BUILD CONTEXT = repo root. The proxy consumes
# @clerum/grok-provider-attempt-contract via file:.
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a AS builder
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS builder
WORKDIR /app
COPY packages/grok-provider-attempt-contract ./packages/grok-provider-attempt-contract
@@ -11,7 +11,7 @@ COPY grok-llm-proxy/tsconfig.json grok-llm-proxy/tsconfig.build.json ./
COPY grok-llm-proxy/src ./src
RUN npm run build
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53
WORKDIR /app
COPY packages/grok-provider-attempt-contract ./packages/grok-provider-attempt-contract
diff --git a/grok-llm-proxy/package-lock.json b/grok-llm-proxy/package-lock.json
index de4c92c9d..3a5e8ba44 100644
--- a/grok-llm-proxy/package-lock.json
+++ b/grok-llm-proxy/package-lock.json
@@ -27,7 +27,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/grok-provider-attempt-contract": {
diff --git a/grok-llm-proxy/package.json b/grok-llm-proxy/package.json
index 21c2fe3e0..5b69af5d1 100644
--- a/grok-llm-proxy/package.json
+++ b/grok-llm-proxy/package.json
@@ -4,7 +4,7 @@
"description": "Bounded Grok subscription transport process. No database, Kubernetes, or tool execution.",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc -p tsconfig.build.json",
diff --git a/grok-llm-proxy/test/requestLimits.test.ts b/grok-llm-proxy/test/requestLimits.test.ts
index 05c0decb0..abe6a831d 100644
--- a/grok-llm-proxy/test/requestLimits.test.ts
+++ b/grok-llm-proxy/test/requestLimits.test.ts
@@ -12,7 +12,7 @@ import {
} from '../src/requestLimits.js'
import { DEFAULT_HEARTBEAT_INTERVAL_MS, MAX_HEARTBEAT_INTERVAL_MS } from '../src/sseHeartbeat.js'
-// undici's default headersTimeout and bodyTimeout in the Node 24.16.0 image the
+// undici's default headersTimeout and bodyTimeout in the Node 24.22.1 image the
// Host runs; the Host sets neither for its proxy calls.
const HOST_UNDICI_TIMEOUT_MS = 300_000
diff --git a/hooks/reference-guardrail-hook/Dockerfile b/hooks/reference-guardrail-hook/Dockerfile
index 2d665ecc1..5780671fb 100644
--- a/hooks/reference-guardrail-hook/Dockerfile
+++ b/hooks/reference-guardrail-hook/Dockerfile
@@ -1,5 +1,5 @@
# Reference guardrail hook — real `/v1` LLM-lane hook for E2E testing.
-FROM node:20-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
COPY server.js ./
ENV PORT=8080
diff --git a/host-context-controller/Dockerfile b/host-context-controller/Dockerfile
index 8cae96d18..3b4100de5 100644
--- a/host-context-controller/Dockerfile
+++ b/host-context-controller/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -27,7 +27,7 @@ COPY host-context-controller/src ./src
RUN npm run build
# Production stage
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/host-context-controller/package-lock.json b/host-context-controller/package-lock.json
index c49f0f750..ce305b997 100644
--- a/host-context-controller/package-lock.json
+++ b/host-context-controller/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-host-context-controller",
- "version": "0.1.403",
+ "version": "0.1.404",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-host-context-controller",
- "version": "0.1.403",
+ "version": "0.1.404",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@clerum/codex-catalog-projection": "file:../packages/codex-catalog-projection",
@@ -27,7 +27,7 @@
"yaml": "^2.9.0"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/codex-catalog-projection": {
diff --git a/host-context-controller/package.json b/host-context-controller/package.json
index 4bcd62ee5..bdfe1b9f0 100644
--- a/host-context-controller/package.json
+++ b/host-context-controller/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-host-context-controller",
- "version": "0.1.403",
+ "version": "0.1.404",
"description": "Host Context Controller - provides McpServer CRDs to mcp-host via REST API",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc -p tsconfig.build.json",
diff --git a/mcp-host/Dockerfile b/mcp-host/Dockerfile
index 683072054..745a5b328 100644
--- a/mcp-host/Dockerfile
+++ b/mcp-host/Dockerfile
@@ -5,10 +5,10 @@
# build must COPY packages/ alongside mcp-host/. Mirrors control-api /
# workflow-recipes. Build invocations pass `-f mcp-host/Dockerfile .`.
#
-# Pinned to Node 24.16.0 by digest: Node 24.17.0 ships an undici bump that
-# regresses node-fetch@2 (ERR_STREAM_PREMATURE_CLOSE). Keep the runtime frozen
-# so a floating `node:24-alpine` tag can't move the patch out from under us.
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a AS builder
+# Pinned to Node 24.22.1 by digest for the October 2026 Node.js security
+# release. The HTTP regression covers the SDK and native fetch separately;
+# the CI runtime image gate also checks the effective version and native modules.
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS builder
WORKDIR /app
@@ -34,7 +34,7 @@ COPY mcp-host/src ./src
RUN npm run build && npm prune --omit=dev
# Production image
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53
WORKDIR /app
diff --git a/mcp-host/Dockerfile.desktop b/mcp-host/Dockerfile.desktop
index 36b291b0b..9fec59f63 100644
--- a/mcp-host/Dockerfile.desktop
+++ b/mcp-host/Dockerfile.desktop
@@ -1,8 +1,8 @@
# ─── Builder stage (same as other Dockerfiles) ─────────────────────────────
# BUILD CONTEXT = repo root (see Dockerfile). COPY packages/ alongside mcp-host/.
-# Pinned to Node 24.16.0 by digest: 24.17.0's undici bump regresses node-fetch@2
-# (ERR_STREAM_PREMATURE_CLOSE). Keep the runtime frozen.
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a AS builder
+# Pinned to Node 24.22.1 by digest for the October 2026 security release.
+# node-fetch@2 / undici compatibility is not established; parent validation is pending.
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS builder
WORKDIR /app
COPY packages/llm-providers ./packages/llm-providers
COPY packages/llm-provider-attempt-contract ./packages/llm-provider-attempt-contract
@@ -23,11 +23,11 @@ RUN npm run build
# '{{index .RepoDigests 0}}' lscr.io/linuxserver/webtop:ubuntu-xfce`.
FROM lscr.io/linuxserver/webtop:ubuntu-xfce@sha256:3c052ffab7a7b28ff7a592237c066a3985ff7d2c2345b2d5bbd36b82cface0ab
-# Node.js 24.16.0 (matches builder stage). Pin the exact NodeSource patch:
-# `setup_24.x` otherwise installs the latest 24.x (24.17.0+), whose undici bump
-# regresses node-fetch@2 (ERR_STREAM_PREMATURE_CLOSE).
+# Node.js 24.22.1 matches the builder. Pin published nodejs=24.22.1-1nodesource1
+# so setup_24.x cannot select another 24.x package. The CI runtime image gate
+# also checks the effective version, native modules and SDK HTTP transport.
RUN curl -fsSL https://deb.nodesource.com/setup_24.x | bash - \
- && apt-get install -y nodejs=24.16.0-1nodesource1 && rm -rf /var/lib/apt/lists/*
+ && apt-get install -y nodejs=24.22.1-1nodesource1 && rm -rf /var/lib/apt/lists/*
# Dev tools
RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/mcp-host/Dockerfile.full b/mcp-host/Dockerfile.full
index 60991fe21..85b6ea3ca 100644
--- a/mcp-host/Dockerfile.full
+++ b/mcp-host/Dockerfile.full
@@ -1,12 +1,12 @@
# MCP Host Dockerfile — Full variant
-# Base: node:24 (full Debian, glibc + apt + python3/gcc/make/curl/perl, ~400-500MB)
+# Base: node:24.22.1 (Debian bookworm, glibc + apt + python3/gcc/make/curl/perl, ~400-500MB)
# Use case: full dev workstation for agent shell execution
#
# BUILD CONTEXT = repo root (see Dockerfile). COPY packages/ alongside mcp-host/.
#
-# Pinned to Node 24.16.0 by digest: 24.17.0's undici bump regresses node-fetch@2
-# (ERR_STREAM_PREMATURE_CLOSE). Keep the runtime frozen.
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a AS builder
+# Pinned to Node 24.22.1 by digest for the October 2026 security release.
+# node-fetch@2 / undici compatibility is not established; parent validation is pending.
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS builder
WORKDIR /app
@@ -31,7 +31,7 @@ COPY mcp-host/src ./src
RUN npm run build
# Production image — full Debian (git, python3, gcc, make, curl, perl included)
-FROM node:24.16.0@sha256:40ad9f3064e67d6860b4bc3fe1880b2953934fd6320ada990e45fe0efa6badd7
+FROM node:24.22.1@sha256:6449e19d8184d84062525b6a7524def03146c2cb04a7f08b076680d0e8e4240a
WORKDIR /app
diff --git a/mcp-host/Dockerfile.slim b/mcp-host/Dockerfile.slim
index d2f197b0e..99f0a645e 100644
--- a/mcp-host/Dockerfile.slim
+++ b/mcp-host/Dockerfile.slim
@@ -1,12 +1,12 @@
# MCP Host Dockerfile — Slim variant
-# Base: node:24-slim (Debian slim, glibc + apt, ~200-250MB)
+# Base: node:24.22.1-slim (Debian bookworm slim, glibc + apt, ~200-250MB)
# Use case: agent shell execution with common Unix tools
#
# BUILD CONTEXT = repo root (see Dockerfile). COPY packages/ alongside mcp-host/.
#
-# Pinned to Node 24.16.0 by digest: 24.17.0's undici bump regresses node-fetch@2
-# (ERR_STREAM_PREMATURE_CLOSE). Keep the runtime frozen.
-FROM node:24.16.0-alpine@sha256:21f403ab171f2dc89bad4dd69d7721bfd15f084ccb46cdd225f31f2bc59b5c9a AS builder
+# Pinned to Node 24.22.1 by digest for the October 2026 security release.
+# node-fetch@2 / undici compatibility is not established; parent validation is pending.
+FROM node:24.22.1-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS builder
WORKDIR /app
@@ -31,7 +31,7 @@ COPY mcp-host/src ./src
RUN npm run build
# Production image — Debian slim (glibc + apt available)
-FROM node:24.16.0-slim@sha256:2c87ef9bd3c6a3bd4b472b4bec2ce9d16354b0c574f736c476489d09f560a203
+FROM node:24.22.1-slim@sha256:55fb5f5a527ea2c5c4a95f963e48ef90aa38c7b346054fdc8ee9957a2b55d205
WORKDIR /app
diff --git a/mcp-host/package-lock.json b/mcp-host/package-lock.json
index fdd0c8f29..609568215 100644
--- a/mcp-host/package-lock.json
+++ b/mcp-host/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.594",
+ "version": "0.1.595",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-mcp-host",
- "version": "0.1.594",
+ "version": "0.1.595",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@anthropic-ai/sdk": "^0.32.0",
@@ -62,7 +62,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/codex-catalog-projection": {
diff --git a/mcp-host/package.json b/mcp-host/package.json
index 7a4f1ff0c..18cc97ede 100644
--- a/mcp-host/package.json
+++ b/mcp-host/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.594",
+ "version": "0.1.595",
"description": "MCP Host - reads Host CRD and provides LLM access via OpenAI/Claude",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc -p tsconfig.build.json",
diff --git a/mcp-host/src/llm/__tests__/nodeRuntimeCompatibility.test.ts b/mcp-host/src/llm/__tests__/nodeRuntimeCompatibility.test.ts
new file mode 100644
index 000000000..c112e1c6e
--- /dev/null
+++ b/mcp-host/src/llm/__tests__/nodeRuntimeCompatibility.test.ts
@@ -0,0 +1,174 @@
+import { afterEach, describe, expect, it } from 'vitest'
+import { type Server, createServer } from 'node:http'
+import type { AddressInfo } from 'node:net'
+import { brotliCompressSync, gzipSync } from 'node:zlib'
+import { getRuntime } from 'openai/_shims/node-runtime'
+import { OpenAICompatibleProvider } from '../openaiCompatible'
+
+const completion = {
+ id: 'runtime-http-test',
+ object: 'chat.completion',
+ model: 'runtime-http-test',
+ choices: [
+ {
+ index: 0,
+ message: { role: 'assistant', content: 'complete response' },
+ finish_reason: 'stop',
+ },
+ ],
+ usage: { prompt_tokens: 1, completion_tokens: 2, total_tokens: 3 },
+}
+
+const servers: Server[] = []
+afterEach(async () => {
+ for (const server of servers.splice(0)) {
+ server.closeAllConnections()
+ await new Promise<void>((resolve, reject) =>
+ server.close(error => (error ? reject(error) : resolve()))
+ )
+ }
+})
+
+async function listen(server: Server): Promise<string> {
+ servers.push(server)
+ await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve))
+ return `http://127.0.0.1:${(server.address() as AddressInfo).port}/v1`
+}
+
+function provider(baseURL: string): OpenAICompatibleProvider {
+ // A local protocol fixture needs a non-secret key because the real SDK
+ // requires one. The provider and SDK transport are never mocked or replaced.
+ return new OpenAICompatibleProvider(
+ { id: 'zai', baseURL, defaultModel: 'runtime-http-test' },
+ 'local-http-fixture'
+ )
+}
+
+describe('Node runtime HTTP compatibility', () => {
+ it('reads fragmented plain, gzip and Brotli responses over the SDK keep-alive transport', async () => {
+ let requests = 0
+ const connections = new Set<number>()
+ const server = createServer((request, response) => {
+ connections.add(request.socket.remotePort!)
+ request.resume()
+ request.on('end', () => {
+ const encoding = ['identity', 'gzip', 'br'][requests++ % 3]
+ const json = Buffer.from(JSON.stringify(completion))
+ const body =
+ encoding === 'gzip' ? gzipSync(json) : encoding === 'br' ? brotliCompressSync(json) : json
+ response.writeHead(200, {
+ 'Content-Type': 'application/json',
+ 'Content-Encoding': encoding,
+ })
+ response.write(body.subarray(0, 7))
+ setImmediate(() => response.end(body.subarray(7)))
+ })
+ })
+ const client = provider(await listen(server))
+ const sdk = (client as unknown as { client: { fetch: unknown } }).client
+ expect(sdk.fetch).toBe(getRuntime().fetch)
+ for (let index = 0; index < 6; index += 1) {
+ const result = await client.completeSingleTurn(
+ [{ role: 'user', content: 'read the response' }],
+ {
+ signal: AbortSignal.timeout(2_000),
+ }
+ )
+ expect(result.content).toBe('complete response')
+ expect(result.usage_reported).toBe(true)
+ }
+ expect(requests).toBe(6)
+ expect(connections.size).toBe(1)
+ })
+
+ it('bounds a truncated SDK response by the caller deadline without accepting its JSON', async () => {
+ let requests = 0
+ const body = JSON.stringify(completion)
+ const server = createServer((request, response) => {
+ requests += 1
+ request.resume()
+ request.on('end', () => {
+ response.writeHead(200, {
+ 'Content-Type': 'application/json',
+ 'Content-Length': String(Buffer.byteLength(body) + 64),
+ Connection: 'close',
+ })
+ // Valid JSON rules out a parsing failure. The SDK's node-fetch@2 can
+ // stall here on older Node releases too, so this case checks caller
+ // cancellation, not early detection of incomplete HTTP framing.
+ response.end(body)
+ })
+ })
+ const client = provider(await listen(server))
+ const signal = AbortSignal.timeout(3_000)
+ const error = await client
+ .completeSingleTurn([{ role: 'user', content: 'read the response' }], {
+ signal,
+ })
+ .then(
+ () => undefined,
+ failure => failure as Error
+ )
+ expect(error).toBeInstanceOf(Error)
+ expect(error).not.toBeInstanceOf(SyntaxError)
+ expect(error?.message).toMatch(/premature|aborted|closed|reset/i)
+ expect(requests).toBeGreaterThan(0)
+ })
+
+ it('detects truncated HTTP framing in native fetch before caller cancellation', async () => {
+ const body = JSON.stringify(completion)
+ let requests = 0
+ const server = createServer((_request, response) => {
+ requests += 1
+ response.writeHead(200, {
+ 'Content-Type': 'application/json',
+ 'Content-Length': String(Buffer.byteLength(body) + 64),
+ Connection: 'close',
+ })
+ response.end(body)
+ })
+ const baseURL = await listen(server)
+ const signal = AbortSignal.timeout(3_000)
+ const response = await fetch(baseURL, { signal })
+ const error = await response.json().then(
+ () => undefined,
+ failure => failure as Error
+ )
+ expect(error).toBeInstanceOf(TypeError)
+ expect(error?.message).toMatch(/terminated|closed|reset/i)
+ expect(signal.aborted).toBe(false)
+ expect(requests).toBe(1)
+ })
+
+ it('honors cancellation after the server has received the request', async () => {
+ const abort = new AbortController()
+ let requests = 0
+ const server = createServer(request => {
+ requests += 1
+ request.resume()
+ abort.abort()
+ })
+ const client = provider(await listen(server))
+ await expect(
+ client.completeSingleTurn([{ role: 'user', content: 'read the response' }], {
+ signal: abort.signal,
+ })
+ ).rejects.toThrow()
+ expect(requests).toBe(1)
+ })
+
+ it('reads compressed responses through the native fetch runtime too', async () => {
+ let requests = 0
+ const server = createServer((_request, response) => {
+ requests += 1
+ const body = brotliCompressSync(Buffer.from(JSON.stringify(completion)))
+ response.writeHead(200, { 'Content-Type': 'application/json', 'Content-Encoding': 'br' })
+ response.write(body.subarray(0, 7))
+ setImmediate(() => response.end(body.subarray(7)))
+ })
+ const baseURL = await listen(server)
+ const result = await fetch(baseURL, { signal: AbortSignal.timeout(2_000) })
+ expect(await result.json()).toEqual(completion)
+ expect(requests).toBe(1)
+ })
+})
diff --git a/mcp-proxy/Dockerfile b/mcp-proxy/Dockerfile
index fcfdb06a8..e08e8aa08 100644
--- a/mcp-proxy/Dockerfile
+++ b/mcp-proxy/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -11,7 +11,7 @@ COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/mcp-proxy/package-lock.json b/mcp-proxy/package-lock.json
index addd86e52..4b409b70d 100644
--- a/mcp-proxy/package-lock.json
+++ b/mcp-proxy/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-mcp-proxy",
- "version": "0.1.7",
+ "version": "0.1.8",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-mcp-proxy",
- "version": "0.1.7",
+ "version": "0.1.8",
"license": "SEE LICENSE IN LICENSE",
"devDependencies": {
"@types/node": "^20.10.0",
@@ -14,7 +14,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/mcp-proxy/package.json b/mcp-proxy/package.json
index e76f0296a..06c1bb471 100644
--- a/mcp-proxy/package.json
+++ b/mcp-proxy/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-mcp-proxy",
- "version": "0.1.7",
+ "version": "0.1.8",
"description": "MCP Proxy - centralized HTTP router for MCP servers",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/mcp-servers/airtable/Dockerfile b/mcp-servers/airtable/Dockerfile
index 3c7cc1501..4ff03056c 100644
--- a/mcp-servers/airtable/Dockerfile
+++ b/mcp-servers/airtable/Dockerfile
@@ -1,5 +1,5 @@
# --- Build stage ---
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -19,7 +19,7 @@ RUN npm run build
RUN npm prune --production
# --- Release stage ---
-FROM node:24-alpine
+FROM node:24.22.1-alpine
# Security: run as non-root user
RUN addgroup -S mcp && adduser -S mcp -G mcp
diff --git a/mcp-servers/doc-generator/Dockerfile b/mcp-servers/doc-generator/Dockerfile
index 6fccaa541..6d29f82c1 100644
--- a/mcp-servers/doc-generator/Dockerfile
+++ b/mcp-servers/doc-generator/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -9,7 +9,7 @@ COPY tsconfig.json ./
COPY src/ ./src/
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/mcp-servers/doc-generator/package-lock.json b/mcp-servers/doc-generator/package-lock.json
index 22529d961..daea0025c 100644
--- a/mcp-servers/doc-generator/package-lock.json
+++ b/mcp-servers/doc-generator/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@clerum/doc-generator-mcp",
- "version": "1.0.8",
+ "version": "1.0.9",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@clerum/doc-generator-mcp",
- "version": "1.0.8",
+ "version": "1.0.9",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"exceljs": "^4.4.0",
diff --git a/mcp-servers/doc-generator/package.json b/mcp-servers/doc-generator/package.json
index 2455324ef..ee432fd4b 100644
--- a/mcp-servers/doc-generator/package.json
+++ b/mcp-servers/doc-generator/package.json
@@ -1,6 +1,6 @@
{
"name": "@clerum/doc-generator-mcp",
- "version": "1.0.8",
+ "version": "1.0.9",
"type": "module",
"main": "dist/index.js",
"scripts": {
diff --git a/mcp-servers/package-lock.json b/mcp-servers/package-lock.json
index 347302fdb..51499716c 100644
--- a/mcp-servers/package-lock.json
+++ b/mcp-servers/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@clerum/mcp-servers",
- "version": "1.0.9",
+ "version": "1.0.10",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@clerum/mcp-servers",
- "version": "1.0.9",
+ "version": "1.0.10",
"dependencies": {
"js-yaml": "^4.1.1"
},
diff --git a/mcp-servers/package.json b/mcp-servers/package.json
index d397b964b..fd58e9098 100644
--- a/mcp-servers/package.json
+++ b/mcp-servers/package.json
@@ -1,6 +1,6 @@
{
"name": "@clerum/mcp-servers",
- "version": "1.0.9",
+ "version": "1.0.10",
"description": "MCP servers for Clerum testing",
"type": "module",
"main": "index.ts",
diff --git a/mcp-servers/playwright/Dockerfile b/mcp-servers/playwright/Dockerfile
index e7060e4fc..5ef8d3f7e 100644
--- a/mcp-servers/playwright/Dockerfile
+++ b/mcp-servers/playwright/Dockerfile
@@ -1,2 +1,9 @@
+FROM node:24.22.1-slim@sha256:55fb5f5a527ea2c5c4a95f963e48ef90aa38c7b346054fdc8ee9957a2b55d205 AS node-runtime
+
FROM mcr.microsoft.com/playwright/mcp@sha256:a9d607e571d70954acc36de7a45e7f424a94cebdfba973b1f404435108c60f3f
+# The pinned MCP image bundles Node 22.22.0. Keep its browser dependencies
+# and application, but run them with the patched official glibc Node binary.
+COPY --from=node-runtime /usr/local/bin/node /usr/local/bin/node
+ENV NODE_VERSION=24.22.1
+RUN node -e "if (process.versions.node !== '24.22.1') throw new Error('Unexpected Node runtime')"
RUN node /app/node_modules/playwright/cli.js install chromium
diff --git a/mcp-servers/playwright/README.md b/mcp-servers/playwright/README.md
index f463ac32b..b8700c5bc 100644
--- a/mcp-servers/playwright/README.md
+++ b/mcp-servers/playwright/README.md
@@ -2,7 +2,7 @@
MCP server for browser automation, packaging the upstream Microsoft Playwright MCP image (`mcr.microsoft.com/playwright/mcp`, digest-pinned). Uses StreamableHTTP transport on port 8931.
-This is upstream-image packaging, not first-party source: the [`Dockerfile`](./Dockerfile) extends the pinned upstream image and pre-installs the Chromium browser (`playwright install chromium`). There is no `src/` in this directory, so the tool list is defined by the upstream image — per the CRD description, it provides browser automation tools for navigation, DOM interaction, code execution, and screenshot capture. See the upstream [Playwright MCP](https://github.com/microsoft/playwright-mcp) project for the current tool set.
+The [`Dockerfile`](./Dockerfile) keeps the pinned upstream application and browser dependencies, replaces its Node 22.22.0 binary with the official digest-pinned Node 24.22.1 glibc binary, and pre-installs Chromium (`playwright install chromium`). CI verifies the effective Node version and CLI loading on amd64 and arm64. There is no `src/` in this directory, so the tool list remains defined by the upstream [Playwright MCP](https://github.com/microsoft/playwright-mcp) application.
## Environment Variables / Secrets
@@ -21,7 +21,7 @@ docker build -t playwright-mcp-server:latest .
- `scripts/minikube/build-images.sh` optionally builds/reuses it as `clerum/playwright-mcp-server:test` (gated by `MINIKUBE_BUILD_PLAYWRIGHT_MCP_IMAGE`; the default minikube overlay does not deploy it).
- `.github/workflows/build-publish.yml` publishes it to `ghcr.io/evenfire-ai/playwright-server` on changes under `mcp-servers/playwright/`.
-Note: the in-tree `mcpserver.yaml` currently points directly at the upstream digest-pinned image rather than the locally built one.
+The in-tree `mcpserver.yaml` still pins the upstream image with Node 22.22.0. A security rollout must publish the validated repository image and replace that reference with its multiarch digest. Changing the Dockerfile alone does not update that manifest, and a mutable `latest` reference does not bind it to the validated artifact.
## Kubernetes Deployment
diff --git a/mcp-servers/web-search/Dockerfile b/mcp-servers/web-search/Dockerfile
index 3a22eb890..4ee7a5cb1 100644
--- a/mcp-servers/web-search/Dockerfile
+++ b/mcp-servers/web-search/Dockerfile
@@ -1,4 +1,4 @@
-ARG NODE_IMAGE=node:24-alpine
+ARG NODE_IMAGE=node:24.22.1-alpine
FROM ${NODE_IMAGE} AS builder
WORKDIR /app
COPY package*.json ./
diff --git a/mcp-servers/web-search/package-lock.json b/mcp-servers/web-search/package-lock.json
index bceaf304d..caafb4dcb 100644
--- a/mcp-servers/web-search/package-lock.json
+++ b/mcp-servers/web-search/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@clerum/web-search-mcp",
- "version": "1.0.20",
+ "version": "1.0.21",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@clerum/web-search-mcp",
- "version": "1.0.20",
+ "version": "1.0.21",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.12.1",
"express": "^4.21.2"
diff --git a/mcp-servers/web-search/package.json b/mcp-servers/web-search/package.json
index 208ceac82..6be36e4c6 100644
--- a/mcp-servers/web-search/package.json
+++ b/mcp-servers/web-search/package.json
@@ -1,6 +1,6 @@
{
"name": "@clerum/web-search-mcp",
- "version": "1.0.20",
+ "version": "1.0.21",
"type": "module",
"main": "dist/index.js",
"scripts": {
diff --git a/mcp-servers/web-search/test/run-network.mjs b/mcp-servers/web-search/test/run-network.mjs
index b2db64863..35ff160b5 100644
--- a/mcp-servers/web-search/test/run-network.mjs
+++ b/mcp-servers/web-search/test/run-network.mjs
@@ -85,7 +85,7 @@ try {
`type=bind,src=${realpathSync(path.join(root, part))},dst=/app/${part},readonly`
)
args.push(
- image ?? 'node:24-alpine',
+ image ?? 'node:24.22.1-alpine',
'sh',
'-ec',
'ip addr add 11.198.0.2/32 dev lo; ip -6 addr add 2606:4700::198/128 dev lo; test -z "$(ip -6 route show default)"; test -z "$(ip route show default)"; printf "nameserver 127.0.0.1\\n" > /etc/resolv.conf; node --test /app/test/mcp.network.mjs'
diff --git a/packages/jwt-key-policy/package-lock.json b/packages/jwt-key-policy/package-lock.json
index 9e724b659..8e9dbba72 100644
--- a/packages/jwt-key-policy/package-lock.json
+++ b/packages/jwt-key-policy/package-lock.json
@@ -9,7 +9,7 @@
"version": "0.1.0",
"license": "MIT",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
}
}
diff --git a/packages/jwt-key-policy/package.json b/packages/jwt-key-policy/package.json
index 7d3937106..b98d86a69 100644
--- a/packages/jwt-key-policy/package.json
+++ b/packages/jwt-key-policy/package.json
@@ -18,7 +18,7 @@
}
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "node --check index.cjs && node --check dev-store.cjs",
diff --git a/packages/workflow-sdk/Dockerfile.base b/packages/workflow-sdk/Dockerfile.base
index 15fdbce41..bc7b839be 100644
--- a/packages/workflow-sdk/Dockerfile.base
+++ b/packages/workflow-sdk/Dockerfile.base
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS sdk-builder
+FROM node:24.22.1-alpine AS sdk-builder
WORKDIR /app
@@ -20,7 +20,7 @@ COPY packages/workflow-sdk/src ./packages/workflow-sdk/src
WORKDIR /app/packages/workflow-sdk
RUN npm ci --ignore-scripts && npm run build:docker
-FROM node:24-alpine AS base
+FROM node:24.22.1-alpine AS base
LABEL org.opencontainers.image.title="clerum-workflow-base" \
org.opencontainers.image.description="Base image for Clerum workflow coordinators with @clerum/workflow-sdk pre-installed" \
diff --git a/packages/workflow-sdk/package-lock.json b/packages/workflow-sdk/package-lock.json
index f976b5ecd..b0f20f1b7 100644
--- a/packages/workflow-sdk/package-lock.json
+++ b/packages/workflow-sdk/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@clerum/workflow-sdk",
- "version": "1.0.32-beta.0",
+ "version": "1.0.33-beta.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@clerum/workflow-sdk",
- "version": "1.0.32-beta.0",
+ "version": "1.0.33-beta.0",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@clerum/workflow-runtime-core": "file:../workflow-runtime-core"
diff --git a/packages/workflow-sdk/package.json b/packages/workflow-sdk/package.json
index db0c37e1c..15ace1aa6 100644
--- a/packages/workflow-sdk/package.json
+++ b/packages/workflow-sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "@clerum/workflow-sdk",
- "version": "1.0.32-beta.0",
+ "version": "1.0.33-beta.0",
"description": "Clerum Workflow SDK — TypeScript library for workflow coordinator Pods",
"main": "dist/index.js",
"types": "dist/index.d.ts",
diff --git a/profile-ui/Dockerfile b/profile-ui/Dockerfile
index 1564ae99a..c37314eb6 100644
--- a/profile-ui/Dockerfile
+++ b/profile-ui/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
COPY packages/desktop-app-links ./packages/desktop-app-links
@@ -19,7 +19,7 @@ ARG PROFILE_DESKTOP_HANDOFF_ENABLED=false
ENV NEXT_PUBLIC_PROFILE_DESKTOP_HANDOFF_ENABLED=${PROFILE_DESKTOP_HANDOFF_ENABLED}
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
RUN addgroup -S app && adduser -S app -G app
WORKDIR /app/profile-ui
diff --git a/profile-ui/package-lock.json b/profile-ui/package-lock.json
index b78143e7d..d57b859d3 100644
--- a/profile-ui/package-lock.json
+++ b/profile-ui/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-profile-ui",
- "version": "0.1.181",
+ "version": "0.1.182",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-profile-ui",
- "version": "0.1.181",
+ "version": "0.1.182",
"dependencies": {
"@clerum/desktop-app-links": "file:../packages/desktop-app-links",
"@clerum/frontend-components": "file:../packages/frontend-components",
diff --git a/profile-ui/package.json b/profile-ui/package.json
index 6ae0a2d4d..cd2c535b5 100644
--- a/profile-ui/package.json
+++ b/profile-ui/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-profile-ui",
- "version": "0.1.181",
+ "version": "0.1.182",
"private": true,
"scripts": {
"dev": "next dev",
diff --git a/rpc-proxy/Dockerfile b/rpc-proxy/Dockerfile
index 733f658f8..06f56dc03 100644
--- a/rpc-proxy/Dockerfile
+++ b/rpc-proxy/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
COPY packages/jwt-key-policy/package.json packages/jwt-key-policy/index.cjs packages/jwt-key-policy/index.d.ts packages/jwt-key-policy/dev-store.cjs packages/jwt-key-policy/dev-store.d.ts ./packages/jwt-key-policy/
@@ -11,7 +11,7 @@ COPY rpc-proxy/src ./src
RUN npm run build
RUN npm prune --production
-FROM node:24-alpine
+FROM node:24.22.1-alpine
RUN addgroup -S app && adduser -S app -G app
WORKDIR /app
diff --git a/rpc-proxy/package-lock.json b/rpc-proxy/package-lock.json
index 5fe41f9e4..9a9e1f4ae 100644
--- a/rpc-proxy/package-lock.json
+++ b/rpc-proxy/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-rpc-proxy",
- "version": "0.1.126",
+ "version": "0.1.127",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-rpc-proxy",
- "version": "0.1.126",
+ "version": "0.1.127",
"dependencies": {
"@clerum/jwt-key-policy": "file:../packages/jwt-key-policy",
"cors": "^2.8.5",
@@ -27,7 +27,7 @@
"vitest": "^3.2.4"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/jwt-key-policy": {
diff --git a/rpc-proxy/package.json b/rpc-proxy/package.json
index 886e22f60..2d61a7674 100644
--- a/rpc-proxy/package.json
+++ b/rpc-proxy/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-rpc-proxy",
- "version": "0.1.126",
+ "version": "0.1.127",
"description": "External-facing RPC proxy for tenant-scoped MCP access",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/scripts/check-node-version.mjs b/scripts/check-node-version.mjs
new file mode 100644
index 000000000..b5884adb4
--- /dev/null
+++ b/scripts/check-node-version.mjs
@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export const minimumNodeVersion = readFileSync(new URL('../.nvmrc', import.meta.url), 'utf8').trim()
+
+export function assertNodeVersion(version = process.versions.node, { major } = {}) {
+ const parse = value => /^(\d+)\.(\d+)\.(\d+)$/.exec(value)?.slice(1).map(Number)
+ const current = parse(version)
+ const minimum = parse(minimumNodeVersion)
+ if (!minimum) throw new Error('.nvmrc must pin a complete Node.js version')
+ const comparison = current?.findIndex((part, index) => part !== minimum[index])
+ if (
+ !current ||
+ (major !== undefined && current[0] !== major) ||
+ (comparison !== -1 && current[comparison] < minimum[comparison])
+ ) {
+ throw new Error(
+ `Node.js ${major === undefined ? '' : `${major}.x `}>=${minimumNodeVersion} is required; found v${version}`
+ )
+ }
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+ const args = process.argv.slice(2)
+ if (args.length > 1 || (args.length === 1 && args[0] !== '--major=24')) {
+ throw new Error('Usage: node scripts/check-node-version.mjs [--major=24]')
+ }
+ assertNodeVersion(process.versions.node, args.length ? { major: 24 } : {})
+}
diff --git a/scripts/check-prereqs.sh b/scripts/check-prereqs.sh
index b876bc8a0..fb65527c5 100755
--- a/scripts/check-prereqs.sh
+++ b/scripts/check-prereqs.sh
@@ -91,27 +91,27 @@ else
MISSING=$((MISSING + 1))
fi
-# ── Node.js (>= 24; Desktop/Electron validation wants 24.x) ───────────
+# ── Node.js (patched minimum; Desktop/Electron validation wants 24.x) ──
# The platform itself runs in containers, so the quickstart only needs a
# floor here. Pinning the whole install to 24.x would lock out newer runtimes
# for a Desktop-only concern. Desktop validation is where 24.x is contractual:
-# CI pins node-version 24 and desktop-app/scripts/verify-electron-runtime.mjs
+# CI reads .nvmrc and desktop-app/scripts/verify-electron-runtime.mjs
# enforces it before any Desktop test/build result counts.
if command -v node >/dev/null 2>&1; then
NODE_VER="$(node --version | sed 's/^v//')"
NODE_MAJOR="${NODE_VER%%.*}"
- if version_ge "$NODE_VER" "24.0.0"; then
+ if node "$SCRIPT_DIR/check-node-version.mjs" >/dev/null 2>&1; then
ok "node v${NODE_VER}"
if [ "$NODE_MAJOR" != "24" ]; then
warn "node v${NODE_VER} runs the quickstart, but Desktop/Electron validation requires 24.x"
fi
else
- err "node v${NODE_VER} (need >= 24)"
+ err "node v${NODE_VER} (need >= $(tr -d '[:space:]' < "$PROJECT_DIR/.nvmrc"))"
hint "brew install node@24" "curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs"
MISSING=$((MISSING + 1))
fi
else
- err "node not found (need >= 24)"
+ err "node not found (need >= $(tr -d '[:space:]' < "$PROJECT_DIR/.nvmrc"))"
hint "brew install node@24" "curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs"
MISSING=$((MISSING + 1))
fi
diff --git a/scripts/e2e/fixtures/subscription-image-runner.Dockerfile b/scripts/e2e/fixtures/subscription-image-runner.Dockerfile
index 77e1fef5e..69421425a 100644
--- a/scripts/e2e/fixtures/subscription-image-runner.Dockerfile
+++ b/scripts/e2e/fixtures/subscription-image-runner.Dockerfile
@@ -11,12 +11,14 @@ ARG RUNNER_BASE_IMAGE
FROM ${RUNNER_BASE_IMAGE} AS build
USER 0:0
WORKDIR /opt/evenfire
+COPY .nvmrc ./.nvmrc
+COPY scripts/check-node-version.mjs ./scripts/check-node-version.mjs
# Reviewed SocketDev/sfw-free binary staged by the host admission writer. It is
# a third-party artifact with its own receipt and hash binding, never part of
# the Git source manifest, and it is the only sfw in the image.
COPY third-party/sfw-free /usr/local/bin/sfw
RUN chmod 0755 /usr/local/bin/sfw \
- && node -e "if (process.versions.node.split('.')[0] !== '24') process.exit(1)" \
+ && node scripts/check-node-version.mjs --major=24 \
&& command -v apt-get && command -v sfw
RUN sfw apt-get update && sfw apt-get install -y --no-install-recommends \
ca-certificates git python3 make g++ pkg-config libsecret-1-dev \
@@ -58,6 +60,8 @@ RUN node --input-type=module -e "import fs from 'node:fs'; import {verifyInputSo
FROM ${RUNNER_BASE_IMAGE} AS runner
USER 0:0
WORKDIR /opt/evenfire
+COPY --from=build /opt/evenfire/.nvmrc ./.nvmrc
+COPY --from=build /opt/evenfire/scripts/check-node-version.mjs ./scripts/check-node-version.mjs
COPY third-party/sfw-free /usr/local/bin/sfw
# Runtime X/dbus/keyring and Electron shared libraries. ca-certificates is
# required because node:*-slim purges it after fetching Node.
@@ -69,7 +73,7 @@ RUN chmod 0755 /usr/local/bin/sfw \
libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2 libgtk-3-0 \
libx11-xcb1 libxcb-dri3-0 libxshmfence1 fonts-liberation \
&& rm -rf /var/lib/apt/lists/* \
- && node -e "if (process.versions.node.split('.')[0] !== '24') process.exit(1)" \
+ && node scripts/check-node-version.mjs --major=24 \
&& command -v Xvfb && command -v xauth && command -v dbus-daemon \
&& command -v gnome-keyring-daemon
RUN test ! -e /home/evenfire-e2e \
diff --git a/scripts/e2e/fixtures/subscription-image-runner.base-image b/scripts/e2e/fixtures/subscription-image-runner.base-image
index 8f108a22d..645948c38 100644
--- a/scripts/e2e/fixtures/subscription-image-runner.base-image
+++ b/scripts/e2e/fixtures/subscription-image-runner.base-image
@@ -1,8 +1,8 @@
{
"kind": "evenfire-subscription-image-base-image-v1",
- "reference": "node:24.16.0-slim@sha256:2c87ef9bd3c6a3bd4b472b4bec2ce9d16354b0c574f736c476489d09f560a203",
+ "reference": "node:24.22.1-slim@sha256:55fb5f5a527ea2c5c4a95f963e48ef90aa38c7b346054fdc8ee9957a2b55d205",
"nodeMajor": 24,
- "provenance": "mcp-host/Dockerfile.slim:34 pins this Node 24.16.0 slim digest in the same repository; reuse avoids inventing a new base",
+ "provenance": "mcp-host/Dockerfile.slim:34 pins this Node 24.22.1 slim digest in the same repository; reuse avoids inventing a new base",
"requiredCommands": [
"sfw",
"apt-get",
@@ -13,7 +13,7 @@
"gnome-keyring-daemon"
],
"unprovedPrerequisites": [
- "node:24.16.0-slim does not ship sfw; main must supply a reviewed base that does or approve staging the host sfw into the build context",
+ "node:24.22.1-slim does not ship sfw; main must supply a reviewed base that does or approve staging the host sfw into the build context",
"the apt package names are proved by the build command and ldd checks against the pinned Debian suite"
]
}
diff --git a/scripts/e2e/real-postgres-local-preflight.sh b/scripts/e2e/real-postgres-local-preflight.sh
index ba4acb104..2548237c7 100755
--- a/scripts/e2e/real-postgres-local-preflight.sh
+++ b/scripts/e2e/real-postgres-local-preflight.sh
@@ -43,9 +43,10 @@ real_pg_local_preflight() {
# CI and the local runtime contract pin Node 24. Newer majors have already
# changed deep-JSON behavior and must fail before T0 rather than pass the
# old ">=24" check and break package suites mid-flight.
- if ! [[ "$node_major" =~ ^[0-9]+$ ]] || (( node_major != 24 )); then
+ if ! [[ "$node_major" =~ ^[0-9]+$ ]] || (( node_major != 24 )) ||
+ ! node "$REAL_PG_PREFLIGHT_SCRIPT_DIR/../check-node-version.mjs" --major=24 >/dev/null 2>&1; then
real_pg_preflight_fail LOCAL_DEPENDENCY_MISSING \
- "Node.js 24.x is required for the canonical T0/T1/T2 harness; found ${node_major:-unknown}"
+ "Node.js 24.x at or above the .nvmrc security patch is required for the canonical T0/T1/T2 harness; found ${node_major:-unknown}"
return 1
fi
diff --git a/scripts/minikube/build-images.sh b/scripts/minikube/build-images.sh
index af75fb00c..eb9cf1b80 100755
--- a/scripts/minikube/build-images.sh
+++ b/scripts/minikube/build-images.sh
@@ -591,9 +591,9 @@ fi
# them avoids repeated BuildKit metadata/blob downloads from Docker Hub during
# pre-gate sync, which can fail on transient Cloudflare/R2 timeouts.
BUILD_BASE_IMAGES=(
- "node:24-alpine"
- "node:24"
- "node:24-slim"
+ "node:24.22.1-alpine"
+ "node:24.22.1"
+ "node:24.22.1-slim"
"nginx:1.30.1-alpine"
)
diff --git a/scripts/tests/lib/subscription-image-runner-contract.mjs b/scripts/tests/lib/subscription-image-runner-contract.mjs
index d4cff7d0b..ebcbb4c02 100644
--- a/scripts/tests/lib/subscription-image-runner-contract.mjs
+++ b/scripts/tests/lib/subscription-image-runner-contract.mjs
@@ -6,6 +6,7 @@ import fs from 'node:fs'
import os from 'node:os'
import path from 'node:path'
import { isDeepStrictEqual } from 'node:util'
+import { assertNodeVersion } from '../../check-node-version.mjs'
export class RunnerAdmissionError extends Error {
constructor(code) {
@@ -368,7 +369,11 @@ export function verifyAccount(passwd, uid, gid, home, username) {
export function observeLinuxRunner() {
if (process.platform !== 'linux' || !integer(process.getuid?.()) || !integer(process.getgid?.()))
refuse('NONROOT_LINUX_REQUIRED')
- if (Number(process.versions.node.split('.')[0]) !== 24) refuse('NODE24_REQUIRED')
+ try {
+ assertNodeVersion(process.versions.node, { major: 24 })
+ } catch {
+ refuse('NODE24_REQUIRED')
+ }
const user = os.userInfo(),
home = fs.realpathSync(user.homedir)
verifyAccount(
diff --git a/scripts/tests/lib/subscription-image-source-context.mjs b/scripts/tests/lib/subscription-image-source-context.mjs
index ff8e5b2d2..0ce86d8dd 100644
--- a/scripts/tests/lib/subscription-image-source-context.mjs
+++ b/scripts/tests/lib/subscription-image-source-context.mjs
@@ -11,6 +11,8 @@ const refuse = code => {
throw new RunnerAdmissionError(code)
}
const fixedFiles = [
+ '.nvmrc',
+ 'scripts/check-node-version.mjs',
'desktop-app/package.json',
'desktop-app/package-lock.json',
'desktop-app/tsconfig.json',
diff --git a/scripts/tests/node-runtime-version.test.mjs b/scripts/tests/node-runtime-version.test.mjs
new file mode 100644
index 000000000..a5033c77d
--- /dev/null
+++ b/scripts/tests/node-runtime-version.test.mjs
@@ -0,0 +1,181 @@
+import assert from 'node:assert/strict'
+import { execFileSync, spawnSync } from 'node:child_process'
+import {
+ chmodSync,
+ copyFileSync,
+ mkdirSync,
+ mkdtempSync,
+ readFileSync,
+ rmSync,
+ writeFileSync,
+} from 'node:fs'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+import test from 'node:test'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { assertNodeVersion, minimumNodeVersion } from '../check-node-version.mjs'
+
+const root = fileURLToPath(new URL('../../', import.meta.url))
+
+test('the repository pins the October 2026 Node 24 security release', () => {
+ assert.equal(minimumNodeVersion, '24.22.1')
+})
+
+test('the minimum rejects earlier patches, older majors and prereleases', () => {
+ for (const version of [
+ '20.19.0',
+ '23.11.0',
+ '24.0.0',
+ '24.16.0',
+ '24.18.0',
+ '24.21.0',
+ '24.22.0',
+ '24.22.1-rc.1',
+ '24',
+ 'invalid',
+ ]) {
+ assert.throws(() => assertNodeVersion(version), /is required/)
+ assert.throws(() => assertNodeVersion(version, { major: 24 }), /is required/)
+ }
+})
+
+test('the patched runtime and later Node 24 patches satisfy both contracts', () => {
+ for (const version of ['24.22.1', '24.22.2', '24.23.0']) {
+ assert.doesNotThrow(() => assertNodeVersion(version))
+ assert.doesNotThrow(() => assertNodeVersion(version, { major: 24 }))
+ }
+})
+
+test('the quickstart permits newer majors while Desktop retains Node 24', () => {
+ assert.doesNotThrow(() => assertNodeVersion('26.12.1'))
+ assert.throws(() => assertNodeVersion('26.12.1', { major: 24 }), /24.x/)
+})
+
+test('the staged Desktop verifier keeps its policy and rejects missing policy files', () => {
+ const context = mkdtempSync(path.join(tmpdir(), 'node-runtime-context-'))
+ try {
+ for (const filename of [
+ '.nvmrc',
+ 'scripts/check-node-version.mjs',
+ 'desktop-app/scripts/verify-electron-runtime.mjs',
+ ]) {
+ const destination = path.join(context, filename)
+ mkdirSync(path.dirname(destination), { recursive: true })
+ copyFileSync(path.join(root, filename), destination)
+ }
+ // This unit fixture supplies an executable path without launching Electron.
+ // It exercises version admission and the staged source-file closure.
+ const electron = path.join(context, 'desktop-app/node_modules/electron')
+ mkdirSync(electron, { recursive: true })
+ const runtime = path.join(electron, 'runtime')
+ writeFileSync(runtime, '#!/bin/sh\nexit 0\n')
+ chmodSync(runtime, 0o755)
+ writeFileSync(
+ path.join(electron, 'package.json'),
+ JSON.stringify({ type: 'module', main: 'index.js' })
+ )
+ writeFileSync(path.join(electron, 'index.js'), `export default ${JSON.stringify(runtime)};\n`)
+ const verifier = pathToFileURL(
+ path.join(context, 'desktop-app/scripts/verify-electron-runtime.mjs')
+ ).href
+ const run = version =>
+ spawnSync(
+ process.execPath,
+ [
+ '--input-type=module',
+ '-e',
+ "Object.defineProperty(process.versions, 'node', { value: process.argv[1] }); await import(process.argv[2])",
+ version,
+ verifier,
+ ],
+ { encoding: 'utf8', timeout: 5_000 }
+ )
+ assert.equal(run('24.22.1').status, 0)
+ const unpatched = run('24.22.0')
+ assert.equal(unpatched.status, 1)
+ assert.match(unpatched.stderr, /24\.22\.1 is required/)
+ rmSync(path.join(context, '.nvmrc'))
+ assert.equal(run('24.22.1').status, 1)
+ copyFileSync(path.join(root, '.nvmrc'), path.join(context, '.nvmrc'))
+ rmSync(path.join(context, 'scripts/check-node-version.mjs'))
+ assert.equal(run('24.22.1').status, 1)
+ } finally {
+ rmSync(context, { recursive: true, force: true })
+ }
+})
+
+test('every CI setup-node step uses the repository pin', () => {
+ const workflow = readFileSync(
+ new URL('../../.github/workflows/ci-public.yml', import.meta.url),
+ 'utf8'
+ )
+ const setups = workflow.split(/\n\s+- uses: actions\/setup-node@[^\n]+/).slice(1)
+ assert.ok(setups.length > 0)
+ for (const setup of setups) {
+ const configuration = setup.split(/\n\s+- (?:name:|uses:)/)[0]
+ assert.match(configuration, /node-version-file: \.nvmrc/)
+ assert.doesNotMatch(configuration, /node-version:/)
+ }
+})
+
+function checkNodeImages(source, filename) {
+ // Builtin module imports are not image references. Retain complete image
+ // tags so aliases such as latest/alpine cannot disappear from the gate.
+ const images =
+ source
+ .split('\n')
+ .filter(line => !/^\s*(?:#|\/\/|\*)/.test(line))
+ .join('\n')
+ .replace(/--chown=[^\s]+/g, '')
+ .replace(/\b(?:from|import)\s+['"]node:[^'"]+['"]/g, '')
+ .replace(/\b(?:require|import)\(\s*['"]node:[^'"]+['"]\s*\)/g, '')
+ .match(/\bnode(?::[A-Za-z0-9][A-Za-z0-9_.-]*(?:@sha256:[a-f0-9]+)?|@sha256:[a-f0-9]+)/g) ?? []
+ for (const image of images) {
+ const version = /^node:(\d+\.\d+\.\d+)(?:-|@|$)/.exec(image)?.[1]
+ assert.ok(version, `${filename}: image must pin a complete Node version: ${image}`)
+ assert.doesNotThrow(() => assertNodeVersion(version, { major: 24 }), `${filename}: ${image}`)
+ }
+ return images.length
+}
+
+test('image admission rejects floating aliases and old patches in build and executable sources', () => {
+ for (const source of [
+ 'FROM node:latest',
+ 'ARG NODE_IMAGE=node:alpine',
+ 'image: node:24-alpine',
+ "image ?? 'node:24.22.0-alpine'",
+ "const image = 'node:latest'",
+ `FROM node@sha256:${'a'.repeat(64)}`,
+ ])
+ assert.throws(() => checkNodeImages(source, 'unit-image-source'))
+ assert.equal(checkNodeImages("image ?? 'node:24.22.1-alpine'", 'unit-image-source'), 1)
+ assert.equal(
+ checkNodeImages("import fs from 'node:fs'; require('node:http')", 'unit-image-source'),
+ 0
+ )
+ assert.equal(checkNodeImages('COPY --chown=node:node server.js ./', 'unit-image-source'), 0)
+})
+
+test('tracked direct Node images and executable image defaults pin a patched Node 24 version', () => {
+ const files = execFileSync('git', ['ls-files', '-z'], { cwd: root, encoding: 'utf8' }).split('\0')
+ const executableSources = new Set([
+ 'scripts/minikube/build-images.sh',
+ 'mcp-servers/web-search/test/run-network.mjs',
+ 'desktop-app/test/e2e-playwright/third-party-authn-third-party-mcphost/figureDProviderResources.ts',
+ ])
+ let references = 0
+ for (const filename of files) {
+ if (
+ !/(?:Dockerfile(?:\.[^/]*)?|[^/]+\.Dockerfile|[^/]+\.base-image|[^/]+\.ya?ml)$/.test(
+ filename
+ ) &&
+ !executableSources.has(filename)
+ )
+ continue
+ references += checkNodeImages(
+ readFileSync(new URL(`../../${filename}`, import.meta.url), 'utf8'),
+ filename
+ )
+ }
+ assert.ok(references > 0)
+})
diff --git a/scripts/tests/subscription-image-runner.test.mjs b/scripts/tests/subscription-image-runner.test.mjs
index 12f4ec193..7ac5f890c 100644
--- a/scripts/tests/subscription-image-runner.test.mjs
+++ b/scripts/tests/subscription-image-runner.test.mjs
@@ -462,6 +462,8 @@ test('private JSON refuses wrong mode, symlink and hardlink without accepting an
test('minimal source context excludes ignored/private/Git files and unrelated repository paths', () => {
const packages = ['packages/llm-provider-attempt-contract']
for (const filename of [
+ '.nvmrc',
+ 'scripts/check-node-version.mjs',
'desktop-app/src/main.ts',
'desktop-app/ui/src/App.tsx',
'packages/llm-provider-attempt-contract/testImageFixtures.cjs',
@@ -473,6 +475,7 @@ test('minimal source context excludes ignored/private/Git files and unrelated re
'desktop-app/src/session.key',
'desktop-app/src/__tests__/personal.test.ts',
'control-api/src/main.ts',
+ 'scripts/unreviewed-helper.mjs',
'packages/not-in-closure/index.js',
'../escape',
'/outside',
diff --git a/scripts/tests/test-e2e-vitest-node-unit-gate.sh b/scripts/tests/test-e2e-vitest-node-unit-gate.sh
index 8d52ad07e..ac28acc5f 100755
--- a/scripts/tests/test-e2e-vitest-node-unit-gate.sh
+++ b/scripts/tests/test-e2e-vitest-node-unit-gate.sh
@@ -156,8 +156,8 @@ require_contains "${RUNNER}" "npx vitest run --no-color" \
"color-free Vitest output for the zero-test guard"
require_contains "${WORKFLOW}" "E2E Vitest node-unit (tests/e2e)" \
"public CI job"
-require_contains "${WORKFLOW}" "node-version: '24'" \
- "Node 24 setup"
+require_contains "${WORKFLOW}" "node-version-file: .nvmrc" \
+ "repository-pinned Node setup"
require_contains "${WORKFLOW}" "E2E_VITEST_SUITE_GROUP=node-unit bash scripts/e2e/run-vitest-e2e.sh" \
"canonical runner invocation"
require_contains "${WORKFLOW}" "Test image-capabilities fixtures and runner" \
diff --git a/scripts/tests/test-minikube-build-images-hardening.sh b/scripts/tests/test-minikube-build-images-hardening.sh
index 390057056..1f88f5a6b 100755
--- a/scripts/tests/test-minikube-build-images-hardening.sh
+++ b/scripts/tests/test-minikube-build-images-hardening.sh
@@ -524,9 +524,9 @@ run_build "$query_failure_output" valid \
FAKE_DOCKER_QUERY_STATUS=1 \
bash "$BUILD_SCRIPT" --only=control-api || query_failure_status=$?
if [[ "$query_failure_status" -eq 1 ]] \
- && grep -Fq 'images -q node:24-alpine' "$DOCKER_LOG" \
- && ! grep -Fq 'pull node:24-alpine' "$DOCKER_LOG" \
- && ! grep -Fq 'image inspect node:24-alpine' "$DOCKER_LOG" \
+ && grep -Fq 'images -q node:24.22.1-alpine' "$DOCKER_LOG" \
+ && ! grep -Fq 'pull node:24.22.1-alpine' "$DOCKER_LOG" \
+ && ! grep -Fq 'image inspect node:24.22.1-alpine' "$DOCKER_LOG" \
&& ! grep -Fq 'Manifest:' "$query_failure_output" \
&& [[ "$(<"$manifest")" == known-good-manifest ]]; then
pass 'daemon inventory status 1 hard-fails without pull or manifest success'
@@ -565,8 +565,8 @@ run_build "$empty_query_output" valid \
FAKE_DOCKER_PULL_STATUS=55 \
bash "$BUILD_SCRIPT" --only=control-api || empty_query_status=$?
if [[ "$empty_query_status" -eq 55 ]] \
- && grep -Fq 'images -q node:24-alpine' "$DOCKER_LOG" \
- && grep -Fq 'pull node:24-alpine' "$DOCKER_LOG" \
+ && grep -Fq 'images -q node:24.22.1-alpine' "$DOCKER_LOG" \
+ && grep -Fq 'pull node:24.22.1-alpine' "$DOCKER_LOG" \
&& ! grep -Fq 'Manifest:' "$empty_query_output" \
&& [[ "$(<"$manifest")" == known-good-manifest ]]; then
pass 'only a successful empty daemon inventory is treated as image absence'
diff --git a/scripts/tests/test-minikube-docker-cli-env.sh b/scripts/tests/test-minikube-docker-cli-env.sh
index d44034b73..601791c90 100755
--- a/scripts/tests/test-minikube-docker-cli-env.sh
+++ b/scripts/tests/test-minikube-docker-cli-env.sh
@@ -635,14 +635,14 @@ assert_local_image_operations_preserve_status() {
: >"$DOCKER_LOG"
status=0
DOCKER_CONFIG="$AMBIENT_CONFIG" \
- FAKE_DOCKER_MODE=exit FAKE_DOCKER_MATCH='images -q node:24-alpine' \
+ FAKE_DOCKER_MODE=exit FAKE_DOCKER_MATCH='images -q node:24.22.1-alpine' \
FAKE_DOCKER_EXIT_CODE=42 \
bash "$fixture/scripts/minikube/build-images.sh" --only=control-api \
>"$output" 2>&1 || status=$?
if [[ "$status" -eq 42 ]] \
&& grep -Fq 'label=docker-images-query event=exit' "$output" \
&& grep -Fq 'exitCode=42' "$output" \
- && ! grep -Fq '|pull node:24-alpine' "$DOCKER_LOG"; then
+ && ! grep -Fq '|pull node:24.22.1-alpine' "$DOCKER_LOG"; then
pass "bounded base-image inventory preserves status and never falls through to pull"
else
fail "base-image inventory status/fallback contract failed (status=$status)"
diff --git a/scripts/tests/test-real-postgres-local-preflight.sh b/scripts/tests/test-real-postgres-local-preflight.sh
index 1ffa00d88..09af28996 100755
--- a/scripts/tests/test-real-postgres-local-preflight.sh
+++ b/scripts/tests/test-real-postgres-local-preflight.sh
@@ -19,6 +19,9 @@ done
printf '%s\n' '#!/usr/bin/env bash' \
'if [[ "${1:-}" == -p ]]; then printf "%s\n" "${FAKE_NODE_MAJOR:-24}"; exit 0; fi' \
+ 'if [[ "${1:-}" == */check-node-version.mjs ]]; then' \
+ ' exec "$REAL_NODE" --input-type=module -e '\''const {assertNodeVersion}=await import(process.argv[1]); assertNodeVersion(process.env.FAKE_NODE_VERSION || "24.22.1", {major:24})'\'' "$1"' \
+ 'fi' \
'if [[ "${1:-}" == -e ]]; then exit 0; fi' \
'exec "$REAL_NODE" "$@"' >"$fake_bin/node"
printf '%s\n' '#!/usr/bin/env bash' 'exit 0' >"$fake_bin/npm"
@@ -64,6 +67,16 @@ fi
[[ "$REAL_PG_PREFLIGHT_ERROR_CODE" == LOCAL_DEPENDENCY_MISSING ]]
unset FAKE_NODE_MAJOR
+FAKE_NODE_VERSION=24.22.0
+export FAKE_NODE_VERSION
+if real_pg_local_preflight "$project" true >"$tmp/node-patch.out" 2>&1; then
+ echo 'FAIL: preflight accepted an unpatched Node.js 24 runtime' >&2
+ exit 1
+fi
+[[ "$REAL_PG_PREFLIGHT_ERROR_CODE" == LOCAL_DEPENDENCY_MISSING ]]
+unset FAKE_NODE_VERSION
+real_pg_local_preflight "$project" true >/dev/null
+
chmod -x "$project/gfs-controller/node_modules/.bin/vitest"
if real_pg_local_preflight "$project" true >"$tmp/deps.out" 2>&1; then
echo 'FAIL: preflight accepted missing package-local dependencies' >&2
diff --git a/stdio-bridge/Dockerfile b/stdio-bridge/Dockerfile
index fcfdb06a8..e08e8aa08 100644
--- a/stdio-bridge/Dockerfile
+++ b/stdio-bridge/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -11,7 +11,7 @@ COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/stdio-bridge/package-lock.json b/stdio-bridge/package-lock.json
index ce1eab61f..63831dfe9 100644
--- a/stdio-bridge/package-lock.json
+++ b/stdio-bridge/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-stdio-bridge",
- "version": "0.1.8",
+ "version": "0.1.9",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-stdio-bridge",
- "version": "0.1.8",
+ "version": "0.1.9",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.0.0"
@@ -17,7 +17,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/stdio-bridge/package.json b/stdio-bridge/package.json
index bcd751802..69d69e7ff 100644
--- a/stdio-bridge/package.json
+++ b/stdio-bridge/package.json
@@ -1,10 +1,10 @@
{
"name": "clerum-stdio-bridge",
- "version": "0.1.8",
+ "version": "0.1.9",
"description": "stdio-to-StreamableHTTP bridge sidecar for MCP servers",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/tests/e2e/fixtures/codex-subscription/approved-tools/Dockerfile b/tests/e2e/fixtures/codex-subscription/approved-tools/Dockerfile
index c05eba8fc..8e7e3a698 100644
--- a/tests/e2e/fixtures/codex-subscription/approved-tools/Dockerfile
+++ b/tests/e2e/fixtures/codex-subscription/approved-tools/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
COPY tests/e2e/fixtures/codex-subscription/approved-tools/server.mjs ./server.mjs
USER node
diff --git a/tests/e2e/fixtures/codex-subscription/test-upstream/manifest.yaml b/tests/e2e/fixtures/codex-subscription/test-upstream/manifest.yaml
index 3eed38f4b..2ac786f61 100644
--- a/tests/e2e/fixtures/codex-subscription/test-upstream/manifest.yaml
+++ b/tests/e2e/fixtures/codex-subscription/test-upstream/manifest.yaml
@@ -48,7 +48,7 @@ spec:
type: RuntimeDefault
containers:
- name: upstream
- image: node:24.16.0-alpine
+ image: node:24.22.1-alpine
command: ['node', '/fixture/server.mjs']
env:
- name: CODEX_TEST_UPSTREAM_PORT
diff --git a/tests/e2e/fixtures/custom-workflow-coordinator/Dockerfile b/tests/e2e/fixtures/custom-workflow-coordinator/Dockerfile
index 781ada33d..cebcecd0d 100644
--- a/tests/e2e/fixtures/custom-workflow-coordinator/Dockerfile
+++ b/tests/e2e/fixtures/custom-workflow-coordinator/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS sdk-builder
+FROM node:24.22.1-alpine AS sdk-builder
WORKDIR /app
@@ -18,7 +18,7 @@ COPY packages/workflow-sdk/src ./packages/workflow-sdk/src
WORKDIR /app/packages/workflow-sdk
RUN npm ci && npm run build:docker
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/tests/e2e/fixtures/fake-telegram-server/Dockerfile b/tests/e2e/fixtures/fake-telegram-server/Dockerfile
index a58dece49..d85e2b3fb 100644
--- a/tests/e2e/fixtures/fake-telegram-server/Dockerfile
+++ b/tests/e2e/fixtures/fake-telegram-server/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
COPY server.cjs .
EXPOSE 8080
diff --git a/tests/e2e/fixtures/mock-mcp-server/Dockerfile b/tests/e2e/fixtures/mock-mcp-server/Dockerfile
index daec8d048..3e889874b 100644
--- a/tests/e2e/fixtures/mock-mcp-server/Dockerfile
+++ b/tests/e2e/fixtures/mock-mcp-server/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -9,7 +9,7 @@ COPY tsconfig.json ./
COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/tests/e2e/fixtures/mock-mcp-server/package-lock.json b/tests/e2e/fixtures/mock-mcp-server/package-lock.json
index 28477bf53..88571726c 100644
--- a/tests/e2e/fixtures/mock-mcp-server/package-lock.json
+++ b/tests/e2e/fixtures/mock-mcp-server/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "mock-mcp-server",
- "version": "0.1.7",
+ "version": "0.1.8",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "mock-mcp-server",
- "version": "0.1.7",
+ "version": "0.1.8",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.0.0",
"zod": "^3.23.0"
diff --git a/tests/e2e/fixtures/mock-mcp-server/package.json b/tests/e2e/fixtures/mock-mcp-server/package.json
index 647cd7dd1..a2c4d11fe 100644
--- a/tests/e2e/fixtures/mock-mcp-server/package.json
+++ b/tests/e2e/fixtures/mock-mcp-server/package.json
@@ -1,6 +1,6 @@
{
"name": "mock-mcp-server",
- "version": "0.1.7",
+ "version": "0.1.8",
"private": true,
"type": "module",
"scripts": {
diff --git a/tests/e2e/fixtures/mock-stdio-mcp-server/Dockerfile b/tests/e2e/fixtures/mock-stdio-mcp-server/Dockerfile
index bc9940798..5a0a47722 100644
--- a/tests/e2e/fixtures/mock-stdio-mcp-server/Dockerfile
+++ b/tests/e2e/fixtures/mock-stdio-mcp-server/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
COPY package.json package-lock.json* ./
RUN npm install
@@ -6,7 +6,7 @@ COPY tsconfig.json ./
COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
RUN addgroup -S mcp && adduser -S mcp -G mcp
WORKDIR /app
COPY --from=builder /app/dist ./dist
diff --git a/tests/e2e/fixtures/mock-stdio-mcp-server/package-lock.json b/tests/e2e/fixtures/mock-stdio-mcp-server/package-lock.json
index 41a4ccf43..1c4945797 100644
--- a/tests/e2e/fixtures/mock-stdio-mcp-server/package-lock.json
+++ b/tests/e2e/fixtures/mock-stdio-mcp-server/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "mock-stdio-mcp-server",
- "version": "0.1.5",
+ "version": "0.1.6",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "mock-stdio-mcp-server",
- "version": "0.1.5",
+ "version": "0.1.6",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.0.0",
"zod": "^3.23.0"
diff --git a/tests/e2e/fixtures/mock-stdio-mcp-server/package.json b/tests/e2e/fixtures/mock-stdio-mcp-server/package.json
index 1847d543f..04bf3726f 100644
--- a/tests/e2e/fixtures/mock-stdio-mcp-server/package.json
+++ b/tests/e2e/fixtures/mock-stdio-mcp-server/package.json
@@ -1,6 +1,6 @@
{
"name": "mock-stdio-mcp-server",
- "version": "0.1.5",
+ "version": "0.1.6",
"private": true,
"type": "module",
"scripts": {
diff --git a/tests/e2e/fixtures/package-lock.json b/tests/e2e/fixtures/package-lock.json
index 5153d8811..a9554a006 100644
--- a/tests/e2e/fixtures/package-lock.json
+++ b/tests/e2e/fixtures/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@clerum/e2e-test-fixtures",
- "version": "1.0.108",
+ "version": "1.0.109",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@clerum/e2e-test-fixtures",
- "version": "1.0.108",
+ "version": "1.0.109",
"dependencies": {
"@kubernetes/client-node": "^1.0.0"
},
diff --git a/tests/e2e/fixtures/package.json b/tests/e2e/fixtures/package.json
index a1819b160..7290a3939 100644
--- a/tests/e2e/fixtures/package.json
+++ b/tests/e2e/fixtures/package.json
@@ -1,6 +1,6 @@
{
"name": "@clerum/e2e-test-fixtures",
- "version": "1.0.108",
+ "version": "1.0.109",
"description": "E2E test fixtures and utilities for Clerum testing",
"type": "module",
"main": "index.ts",
diff --git a/tests/e2e/fixtures/workflow-plugin-sdk-e2e/Dockerfile b/tests/e2e/fixtures/workflow-plugin-sdk-e2e/Dockerfile
index a4e765fd5..1471db8c6 100644
--- a/tests/e2e/fixtures/workflow-plugin-sdk-e2e/Dockerfile
+++ b/tests/e2e/fixtures/workflow-plugin-sdk-e2e/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/webhook-gateway/Dockerfile b/webhook-gateway/Dockerfile
index fcfdb06a8..e08e8aa08 100644
--- a/webhook-gateway/Dockerfile
+++ b/webhook-gateway/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -11,7 +11,7 @@ COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/webhook-gateway/package-lock.json b/webhook-gateway/package-lock.json
index b9b25aefc..06b9bca30 100644
--- a/webhook-gateway/package-lock.json
+++ b/webhook-gateway/package-lock.json
@@ -14,7 +14,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/webhook-gateway/package.json b/webhook-gateway/package.json
index a61f7fea3..b9f8603b7 100644
--- a/webhook-gateway/package.json
+++ b/webhook-gateway/package.json
@@ -4,7 +4,7 @@
"description": "Per-recipe webhook gateway: verifies provider signatures and forwards to handler workloads.",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/webhook-proxy/Dockerfile b/webhook-proxy/Dockerfile
index fcfdb06a8..e08e8aa08 100644
--- a/webhook-proxy/Dockerfile
+++ b/webhook-proxy/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -11,7 +11,7 @@ COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/webhook-proxy/package-lock.json b/webhook-proxy/package-lock.json
index 6643da51e..3ade49101 100644
--- a/webhook-proxy/package-lock.json
+++ b/webhook-proxy/package-lock.json
@@ -14,7 +14,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/webhook-proxy/package.json b/webhook-proxy/package.json
index b2d5d27fc..4572055a4 100644
--- a/webhook-proxy/package.json
+++ b/webhook-proxy/package.json
@@ -4,7 +4,7 @@
"description": "Cluster-shared webhook ingress: registry-validated, dumb router to per-recipe webhook gateways.",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/workflow-approval-request-reader/Dockerfile b/workflow-approval-request-reader/Dockerfile
index 878541f40..9d90caacf 100644
--- a/workflow-approval-request-reader/Dockerfile
+++ b/workflow-approval-request-reader/Dockerfile
@@ -1,4 +1,4 @@
-FROM node:24-alpine AS build
+FROM node:24.22.1-alpine AS build
WORKDIR /app
@@ -8,7 +8,7 @@ RUN npm ci
COPY src ./src
RUN npm run build
-FROM node:24-alpine AS runtime
+FROM node:24.22.1-alpine AS runtime
ENV NODE_ENV=production
WORKDIR /app
diff --git a/workflow-approval-request-reader/package-lock.json b/workflow-approval-request-reader/package-lock.json
index 940bf147a..39b5c3b7d 100644
--- a/workflow-approval-request-reader/package-lock.json
+++ b/workflow-approval-request-reader/package-lock.json
@@ -13,7 +13,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@emnapi/core": {
diff --git a/workflow-approval-request-reader/package.json b/workflow-approval-request-reader/package.json
index 1e08e5b0a..e640f08c1 100644
--- a/workflow-approval-request-reader/package.json
+++ b/workflow-approval-request-reader/package.json
@@ -4,7 +4,7 @@
"description": "Normalizes third-party approval callbacks and submits decisions to workflow runtime mcp-hosts",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",
diff --git a/workflow-recipes/Dockerfile b/workflow-recipes/Dockerfile
index 94da471ad..cdd101363 100644
--- a/workflow-recipes/Dockerfile
+++ b/workflow-recipes/Dockerfile
@@ -1,5 +1,5 @@
# syntax=docker/dockerfile:1
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -28,7 +28,7 @@ COPY workflow-recipes/tsconfig.json workflow-recipes/tsconfig.build.json ./
COPY workflow-recipes/src ./src
RUN npm run build:docker
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/workflow-recipes/Dockerfile.coordinator b/workflow-recipes/Dockerfile.coordinator
index db1ef0cdd..4017ad3fd 100644
--- a/workflow-recipes/Dockerfile.coordinator
+++ b/workflow-recipes/Dockerfile.coordinator
@@ -1,5 +1,5 @@
# syntax=docker/dockerfile:1
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
@@ -29,7 +29,7 @@ COPY workflow-recipes/tsconfig.json workflow-recipes/tsconfig.build.json ./
COPY workflow-recipes/src ./src
RUN npm run build:docker
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
diff --git a/workflow-recipes/package-lock.json b/workflow-recipes/package-lock.json
index 626cc2cf8..e300086da 100644
--- a/workflow-recipes/package-lock.json
+++ b/workflow-recipes/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "workload-recipes-controller",
- "version": "0.1.477",
+ "version": "0.1.478",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "workload-recipes-controller",
- "version": "0.1.477",
+ "version": "0.1.478",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@aws-sdk/client-s3": "^3.1009.0",
@@ -38,7 +38,7 @@
"vitest": "^3.0.0"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"../packages/codex-catalog-projection": {
diff --git a/workflow-recipes/package.json b/workflow-recipes/package.json
index 0e00f96f1..a01ea1fea 100644
--- a/workflow-recipes/package.json
+++ b/workflow-recipes/package.json
@@ -1,10 +1,10 @@
{
"name": "workload-recipes-controller",
- "version": "0.1.477",
+ "version": "0.1.478",
"description": "Workload Recipes Controller (WRC) - WorkloadRecipe lifecycle management and MCP server interface",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc -b",
diff --git a/workflow-recipes/samples/sandbox-ui-test-harness/Dockerfile b/workflow-recipes/samples/sandbox-ui-test-harness/Dockerfile
index e981f12bc..e942bac5a 100644
--- a/workflow-recipes/samples/sandbox-ui-test-harness/Dockerfile
+++ b/workflow-recipes/samples/sandbox-ui-test-harness/Dockerfile
@@ -6,9 +6,9 @@
# into the recipe's view/* prefix per spec §9.4)
# - /redirect-external returns 302 to https://example.com/ (proxy must
# strip the off-origin Location and coerce to 200 per Decision 5)
-FROM node:20-alpine
+FROM node:24.22.1-alpine
-# node:alpine ships a `node` user (UID 1000) — sandbox-ui ns enforces
+# node:24.22.1-alpine ships a `node` user (UID 1000) — sandbox-ui ns enforces
# runAsNonRoot, this saves us a per-workload security override.
USER node
WORKDIR /home/node/app
diff --git a/workspace-files-controller/Dockerfile b/workspace-files-controller/Dockerfile
index 97c524fb2..9315183d2 100644
--- a/workspace-files-controller/Dockerfile
+++ b/workspace-files-controller/Dockerfile
@@ -1,5 +1,5 @@
# workspace-files-controller — per-SharedFileSystem HTTP IO service.
-FROM node:24-alpine AS builder
+FROM node:24.22.1-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
@@ -7,14 +7,14 @@ COPY tsconfig.json ./
COPY src ./src
RUN npm run build
-FROM node:24-alpine
+FROM node:24.22.1-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY --from=builder /app/dist ./dist
# wfc runs as the security UID configured on the SharedFileSystem (default 1000).
-# node:24-alpine already ships a `node` user at UID 1000 / GID 1000 — reuse it
+# node:24.22.1-alpine already ships a `node` user at UID 1000 / GID 1000 — reuse it
# rather than recreating, which conflicts on UID.
USER 1000:1000
diff --git a/workspace-files-controller/package-lock.json b/workspace-files-controller/package-lock.json
index 0ceb10fbc..9b5407f1a 100644
--- a/workspace-files-controller/package-lock.json
+++ b/workspace-files-controller/package-lock.json
@@ -27,7 +27,7 @@
"vitest": "^4.0.18"
},
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
}
},
"node_modules/@cspotcode/source-map-support": {
diff --git a/workspace-files-controller/package.json b/workspace-files-controller/package.json
index f414392fe..1de4d023f 100644
--- a/workspace-files-controller/package.json
+++ b/workspace-files-controller/package.json
@@ -4,7 +4,7 @@
"description": "Per-SharedFileSystem HTTP IO service: list/stat/download (P2) and upload/replace/mkdir/move/delete (P3)",
"main": "dist/main.js",
"engines": {
- "node": ">=24"
+ "node": ">=24.22.1"
},
"scripts": {
"build": "tsc",