The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Set node version to minimum 22.14 (#391)
Chirag Jainfba6129b3f3c
diff --git a/.changeset/node-engines-22-14.md b/.changeset/node-engines-22-14.mdnew file mode 100644index 000000000..cea0d9fbd--- /dev/null+++ b/.changeset/node-engines-22-14.md@@ -0,0 +1,5 @@+---+'@truefoundry/trueforge': patch+---++Require Node.js 22.14+ (`better-sqlite3` v13 is built for Node-API 10 and SIGSEGVs on 22.13 and below).diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 157410061..7776ead64 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -45,7 +45,7 @@ Open a feature request in the issue tracker, or upvote an existing request that## Prerequisites-- **Node.js 22.13+** (see [`.nvmrc`](.nvmrc); required by pnpm 11.16)+- **Node.js 22.14+** (see [`.nvmrc`](.nvmrc); pnpm 11.16 needs 22.13+, and `better-sqlite3` v13 needs Node-API 10)- **pnpm** (version pinned via `packageManager` in [`package.json`](package.json); `corepack enable` handles it)- **Docker** — only needed for Postgres/Redis dev infra, the smoke test, and local SDK generation (maintainers). Fork contributors do not generate the SDK.diff --git a/README.md b/README.mdindex 1bfde2f13..75ff41020 100644--- a/README.md+++ b/README.md@@ -11,7 +11,7 @@<p align="center"><a href="https://github.com/truefoundry/trueforge/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License: MIT"></a>- <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%3E%3D22.13-green.svg?style=flat-square" alt="Node.js >= 22.13"></a>+ <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%3E%3D22.14-green.svg?style=flat-square" alt="Node.js >= 22.14"></a><a href="https://trueforge.dev"><img src="https://img.shields.io/badge/Documentation-trueforge.dev-blue.svg?style=flat-square" alt="Documentation"></a><a href="https://trueforge.dev/quickstart"><img src="https://img.shields.io/badge/Quickstart-trueforge.dev/quickstart-blue.svg?style=flat-square" alt="Quickstart"></a><a href="https://trueforge.dev/api/overview"><img src="https://img.shields.io/badge/SDK-trueforge.dev/api/overview-blue.svg?style=flat-square" alt="SDK"></a>diff --git a/docs/quickstart.mdx b/docs/quickstart.mdxindex ab6c6fd49..d32991f99 100644--- a/docs/quickstart.mdx+++ b/docs/quickstart.mdx@@ -10,7 +10,7 @@ TrueForge runs in [two modes](/introduction#two-ways-to-run-it): **local mode**<Tabs><Tab title="Local mode (npx)">- Requires [Node.js](https://nodejs.org) 22 or newer. One command, no other infrastructure — the UI and backend run locally, and data is stored in a local SQLite file:+ Requires [Node.js](https://nodejs.org) 22.14 or newer. One command, no other infrastructure — the UI and backend run locally, and data is stored in a local SQLite file:```bashnpx @truefoundry/trueforgediff --git a/package.json b/package.jsonindex 8440ec19f..c54fe7d9b 100644--- a/package.json+++ b/package.json@@ -3,7 +3,7 @@"private": true,"packageManager": "[email protected]+sha512.b767e9a98fc87aec0f42daefcd0e84941c2cdb45d73c4e1e68860fb2bdfdbe032ab592105479e5e05c237f740c8a5ffdbbb52385797ddc2296745a1bbb883e8d","engines": {- "node": ">=22.13.0"+ "node": ">=22.14.0"},"scripts": {"build": "pnpm --filter @truefoundry/trueforge-core build && pnpm --filter @truefoundry/trueforge-sdk build && pnpm --filter @truefoundry/trueforge-ui build && pnpm --filter frontend build && pnpm --filter @truefoundry/trueforge build",diff --git a/packages/trueforge/README.md b/packages/trueforge/README.mdindex 4f7f111c8..5820f1039 100644--- a/packages/trueforge/README.md+++ b/packages/trueforge/README.md@@ -8,7 +8,7 @@ TrueForge runs the agent loop (model calls, MCP tools, skills, sandboxing, appro## Quick start-Requires [Node.js](https://nodejs.org) 22+.+Requires [Node.js](https://nodejs.org) 22.14+.```bashnpx @truefoundry/trueforgediff --git a/packages/trueforge/package.json b/packages/trueforge/package.jsonindex a1def7185..5d86136aa 100644--- a/packages/trueforge/package.json+++ b/packages/trueforge/package.json@@ -25,7 +25,7 @@"README.md"],"engines": {- "node": ">=22"+ "node": ">=22.14.0"},"scripts": {"build:frontend-assets": "node scripts/copy-frontend.mjs",