Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

Make Node 26 the preferred line for CI and .nvmrc

[._.]/ Adam Eivy13b3f2fc0075
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 0455f770d3..aa1be17c86 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -238,10 +238,10 @@ jobs:
fetch-depth: 0
persist-credentials: false
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
- name: Check shipped stage-prompt history
run: node scripts/migrations/check-shipped-prompt-history.js
@@ -274,10 +274,10 @@ jobs:
- name: Resolve the pull-request diff base
run: node scripts/ci-base-sha.js
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: server/package-lock.json
@@ -292,7 +292,7 @@ jobs:
# manifest-vs-lockfile check, and the key carries the Node *major* rather
# than the resolved patch, because NODE_MODULE_VERSION is stable across
# patches and keying on the patch would discard the entry on every Node
- # 24.x release. The transform-artifact cache below keeps its own key and
+ # 26.x release. The transform-artifact cache below keeps its own key and
# its own restore-keys; this one is about dependencies.
#
# Hit rate comes from the nightly full run: there is no push trigger on
@@ -304,7 +304,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: server/node_modules
- key: server-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: server-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
# A restored tree is only reusable if it was rebuilt before it was saved,
# and that is not answerable by looking at the tree — with today's
@@ -471,10 +471,10 @@ jobs:
- name: Resolve the pull-request diff base
run: node scripts/ci-base-sha.js
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: client/package-lock.json
@@ -498,7 +498,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: client/node_modules
- key: client-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('client/package-lock.json', 'client/package.json', 'client/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: client-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('client/package-lock.json', 'client/package.json', 'client/.npmrc', 'scripts/trusted-rebuilds.js') }}
- name: Install client dependencies
if: steps.client-modules.outputs.cache-hit != 'true'
@@ -592,10 +592,10 @@ jobs:
with:
persist-credentials: false
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: client/package-lock.json
@@ -619,7 +619,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: client/node_modules
- key: client-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('client/package-lock.json', 'client/package.json', 'client/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: client-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('client/package-lock.json', 'client/package.json', 'client/.npmrc', 'scripts/trusted-rebuilds.js') }}
- name: Install client dependencies
if: steps.client-modules.outputs.cache-hit != 'true'
@@ -667,10 +667,10 @@ jobs:
with:
persist-credentials: false
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: server/package-lock.json
@@ -682,7 +682,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: server/node_modules
- key: server-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: server-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
# A restored tree is only reusable if it was rebuilt before it was saved,
# and that is not answerable by looking at the tree — with today's
@@ -819,10 +819,10 @@ jobs:
with:
persist-credentials: false
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: server/package-lock.json
@@ -834,7 +834,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: server/node_modules
- key: server-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: server-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
# A restored tree is only reusable if it was rebuilt before it was saved,
# and that is not answerable by looking at the tree — with today's
@@ -941,7 +941,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: client/node_modules
- key: client-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('client/package-lock.json', 'client/package.json', 'client/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: client-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('client/package-lock.json', 'client/package.json', 'client/.npmrc', 'scripts/trusted-rebuilds.js') }}
- name: Install client dependencies
if: steps.client-modules.outputs.cache-hit != 'true'
@@ -1016,10 +1016,10 @@ jobs:
- name: Resolve the pull-request diff base
run: node scripts/ci-base-sha.js
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: server/package-lock.json
@@ -1031,7 +1031,7 @@ jobs:
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: server/node_modules
- key: server-modules-${{ runner.os }}-${{ runner.arch }}-node24-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
+ key: server-modules-${{ runner.os }}-${{ runner.arch }}-node26-${{ hashFiles('server/package-lock.json', 'server/package.json', 'server/.npmrc', 'scripts/trusted-rebuilds.js') }}
# A restored tree is only reusable if it was rebuilt before it was saved,
# and that is not answerable by looking at the tree — with today's
@@ -1206,7 +1206,7 @@ jobs:
persist-credentials: false
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: server/package-lock.json
- name: Install the containment prerequisite
@@ -1259,7 +1259,7 @@ jobs:
run: node scripts/ci-dependabot-admission.js
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
cache: npm
cache-dependency-path: |
package-lock.json
diff --git a/.github/workflows/eidoverse-acceptance.yml b/.github/workflows/eidoverse-acceptance.yml
index b8d3ed53f0..e8a251175b 100644
--- a/.github/workflows/eidoverse-acceptance.yml
+++ b/.github/workflows/eidoverse-acceptance.yml
@@ -36,7 +36,7 @@ jobs:
persist-credentials: false
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
- name: Read-only native host and resource preflight
run: |
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 417ba13e4d..f63c7b32f0 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -80,10 +80,10 @@ jobs:
fetch-depth: 0
token: ${{ secrets.GITHUB_TOKEN }}
- - name: Use Node.js 24.x
+ - name: Use Node.js 26.x
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
- node-version: 24.x
+ node-version: 26.x
- name: Configure git
run: |
diff --git a/.nvmrc b/.nvmrc
index cabf43b5dd..6f4247a625 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-24
\ No newline at end of file
+26
diff --git a/README.md b/README.md
index 09cc22049e..7c4cbb5106 100644
--- a/README.md
+++ b/README.md
@@ -300,7 +300,7 @@ Track your biological self alongside your digital one.
### Requirements
-- Node.js `^22.22.2 || ^24.15.0 || >=26.0.0` (24 is the preferred LTS used by CI and `.nvmrc`; the supported Node 22 line starts at 22.22.2). `npm run setup`, `npm start` and `npm run dev` check this first and stop immediately on an unsupported release line or patch — a bare `npm install` only warns, so use the commands below.
+- Node.js `^22.22.2 || ^24.15.0 || >=26.0.0` (26 is the preferred LTS used by CI and `.nvmrc`; the supported Node 22 line starts at 22.22.2). `npm run setup`, `npm start` and `npm run dev` check this first and stop immediately on an unsupported release line or patch — a bare `npm install` only warns, so use the commands below.
- npm 11.11.0 or later for dependency authoring (`npm install -g [email protected]` provides the verified minimum and supports the PortOS Node floor). Its Arborist 9.4.0 lockfile writer preserves `libc` metadata; npm 11.10.1 and earlier omit it. See the [npm 11.11.0 writer](https://github.com/npm/cli/blob/v11.11.0/workspaces/arborist/lib/shrinkwrap.js). npm 12 is not required. PortOS-managed setup, update, and dependency-repair installs preserve committed lockfiles with `--no-save`; do not commit metadata-only churn from older npm. Every workspace declares `engines.npm`, and setup/start/dev print an advisory below that floor. These are warnings, never runtime failures. Check `node -v`, `npm -v`, and executable resolution in the environment running PortOS as well as your shell: a Node version manager can select a different toolchain for agent shells. Avoid blindly upgrading to `npm@latest`, whose own Node requirement may exceed PortOS's.
- Git
- PostgreSQL, either installed locally or available through Docker. Setup defaults to Docker and requires a running Docker daemon and Docker Compose; it does not automatically select an existing native database. For a **fresh native install**, set `PGMODE=native` in the repository-root `.env` before setup, preserving any other settings. See [database selection](./docs/SETUP.md#choose-the-database-before-setup).
diff --git a/docs/GITHUB_ACTIONS.md b/docs/GITHUB_ACTIONS.md
index 395cd9252b..c437546aed 100644
--- a/docs/GITHUB_ACTIONS.md
+++ b/docs/GITHUB_ACTIONS.md
@@ -520,7 +520,7 @@ contract; the parts that are not obvious:
own restore-keys, and stays warm across a lockfile bump that misses here.
- **The key pins the Node major, not the resolved patch.**
`NODE_MODULE_VERSION` is stable across patch releases, so keying on
- `steps.node.outputs.node-version` would discard the entry on every Node 24.x
+ `steps.node.outputs.node-version` would discard the entry on every Node 26.x
release for no ABI benefit; the mark carries the exact ABI as a backstop. A
test compares the literal against the job's own `node-version:` pin.
`server/package.json` is in the hash alongside the lockfile so that skipping
diff --git a/scripts/checkNodeVersion.js b/scripts/checkNodeVersion.js
index 1c482cde1a..4c4f345ef9 100644
--- a/scripts/checkNodeVersion.js
+++ b/scripts/checkNodeVersion.js
@@ -22,7 +22,7 @@
* react-router requires Node 22.22, while the Babel toolchain and the
* dependency graph's supported Node 24 line require later patches. Node 23 and
* 25 are intentionally excluded by dependencies with even-major ranges.
- * `.nvmrc`/CI at 24 remains the preferred LTS, while the minimum CI job proves
+ * `.nvmrc`/CI at 26 is the preferred LTS, while the minimum CI job proves
* the lower supported Node 22 line.
*/
diff --git a/scripts/ci-base-sha.test.js b/scripts/ci-base-sha.test.js
index e79d87ccfd..0d9552229c 100644
--- a/scripts/ci-base-sha.test.js
+++ b/scripts/ci-base-sha.test.js
@@ -225,7 +225,7 @@ describe('ci.yml server node_modules cache', () => {
it('pins the key to the Node major the jobs actually install', () => {
// The major, not the resolved patch: NODE_MODULE_VERSION is stable across
// patch releases, so keying on the patch would discard a ~570 MB entry on
- // every Node 24.x release for no ABI benefit. The tradeoff is that the
+ // every Node 26.x release for no ABI benefit. The tradeoff is that the
// literal has to be kept honest, which is what this asserts.
for (const [id, body] of installers) {
const pinned = body.match(/node-version: (?<major>\d+)\.x/);
diff --git a/scripts/node-version-drift.test.js b/scripts/node-version-drift.test.js
index 3e966d0729..fe803470af 100644
--- a/scripts/node-version-drift.test.js
+++ b/scripts/node-version-drift.test.js
@@ -3,7 +3,7 @@
*
* The supported range is owned by scripts/checkNodeVersion.js. This test keeps
* manifests, setup entrypoints, README, CI, and the committed dependency graph
- * aligned with that owner. CI still runs the preferred Node 24 line, while a
+ * aligned with that owner. CI runs the preferred Node 26 line, while a
* dedicated minimum job exercises the lower supported Node 22 line.
*/
import { describe, it, expect } from 'vitest';
diff --git a/server/lib/safeUrlFetch.js b/server/lib/safeUrlFetch.js
index aea87c67f9..efb1519b99 100644
--- a/server/lib/safeUrlFetch.js
+++ b/server/lib/safeUrlFetch.js
@@ -163,7 +163,7 @@ export function buildPinnedLookup(address, family) {
* version speaks. undici 8 dropped v7's implicit wrapping of the legacy
* (onConnect/onHeaders/onComplete) handler shape, so a bare undici-8 `Agent`
* handed to the built-in fetch of any Node that still bundles undici 7 (22, 24,
- * 25 — including the 24.x CI matrix) throws `InvalidArgumentError: invalid
+ * 25 — including the 22.22.2 minimum CI job) throws `InvalidArgumentError: invalid
* onRequestStart method` and the request never leaves. Since fetchGuarded
* swallows network errors to null, that failure would be SILENT: every guarded
* fetch would return null rather than fall back to an unpinned connect, but the