From aa46a29cdda62274da93903f1a89fb52f664ca96 Mon Sep 17 00:00:00 2001 From: Mikael Hugo Date: Fri, 8 May 2026 07:17:33 +0200 Subject: [PATCH] docs(runtime): align source docs with node 26 --- README.md | 4 ++-- bin/sf-from-source | 5 +++-- docs/dev/SETUP.md | 2 +- docs/user-docs/getting-started.md | 6 +++--- 4 files changed, 9 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 5910508dd..c16631c43 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ One command. Walk away. Come back to a built project with clean git history. > SF now provisions a managed [RTK](https://github.com/rtk-ai/rtk) binary on supported macOS, Linux, and Windows installs to compress shell-command output in `bash`, `async_bash`, `bg_shell`, and verification flows. SF forces `RTK_TELEMETRY_DISABLED=1` for all managed invocations. Set `SF_RTK_DISABLED=1` to disable the integration. -> **📋 NOTICE: New to Node on Mac?** If you installed Node.js via Homebrew, you may be running a development release instead of LTS. **[Read this guide](./docs/user-docs/node-lts-macos.md)** to pin Node 24 LTS and avoid compatibility issues. +> **Node runtime:** SF targets Node.js 26.1+. Use the repo `.mise.toml`, `.node-version`, or `.nvmrc` pins when developing from source. @@ -737,7 +737,7 @@ sf (CLI binary) ## Requirements -- **Node.js** ≥ 24.0.0 (24 LTS recommended) +- **Node.js** ≥ 26.1.0 - **An LLM provider** — any of the 20+ supported providers (see [Use Any Model](#use-any-model)) - **Git** — initialized automatically if missing diff --git a/bin/sf-from-source b/bin/sf-from-source index 2e5ef2649..e9ccd1df0 100755 --- a/bin/sf-from-source +++ b/bin/sf-from-source @@ -16,7 +16,8 @@ # derivation degraded mode under bun). # - bun's native-addon loader doesn't inherit the system library # search path under Nix (libz.so.1 not found for forge_engine.node). -# - node 24+ has node:sqlite built-in and supports +# - node 26.1+ has stable enough node:sqlite coverage for SF's database-first +# runtime and supports # --experimental-strip-types so .ts runs directly. # - The src/resources/extensions/sf/tests/resolve-ts.mjs loader hook # already handles .js → .ts import-specifier remapping for runtime @@ -27,7 +28,7 @@ # - Exports SF_BIN_PATH=dist/loader.js so all child processes (including # subagent pi instances) use the Node.js entry point directly. # -# Requirements: node >= 24 on PATH, +# Requirements: node >= 26.1 on PATH, # node_modules populated. set -euo pipefail diff --git a/docs/dev/SETUP.md b/docs/dev/SETUP.md index 9091f9c56..3cc160613 100644 --- a/docs/dev/SETUP.md +++ b/docs/dev/SETUP.md @@ -5,7 +5,7 @@ checked out and want a working local SF development environment. ## Prerequisites -- Node.js 24 or newer +- Node.js 26.1 or newer - npm - Git - Rust toolchain for native engine work diff --git a/docs/user-docs/getting-started.md b/docs/user-docs/getting-started.md index 99f63232c..f00fa06f7 100644 --- a/docs/user-docs/getting-started.md +++ b/docs/user-docs/getting-started.md @@ -8,7 +8,7 @@ SF is a purpose-to-software compiler. It turns bounded intent into PDD contracts | Requirement | Minimum | Recommended | |-------------|---------|-------------| -| **[Node.js](https://nodejs.org/)** | 24.0.0 | 24 LTS | +| **[Node.js](https://nodejs.org/)** | 26.1.0 | 26.1+ | | **[Git](https://git-scm.com/)** | 2.20+ | Latest | | **LLM API key** | Any supported provider | Anthropic (Claude) | @@ -27,7 +27,7 @@ Pick your distro, then follow the steps. **Step 1 — Install Node.js and Git:** ```bash -curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - +curl -fsSL https://deb.nodesource.com/setup_26.x | sudo -E bash - sudo apt-get install -y nodejs git ``` @@ -36,7 +36,7 @@ sudo apt-get install -y nodejs git **Step 1 — Install Node.js and Git:** ```bash -curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash - +curl -fsSL https://rpm.nodesource.com/setup_26.x | sudo bash - sudo dnf install -y nodejs git ```