docs(runtime): align source docs with node 26

This commit is contained in:
Mikael Hugo 2026-05-08 07:17:33 +02:00
parent 0cfe839f7a
commit aa46a29cdd
4 changed files with 9 additions and 8 deletions

View file

@ -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. > 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.
</div> </div>
@ -737,7 +737,7 @@ sf (CLI binary)
## Requirements ## 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)) - **An LLM provider** — any of the 20+ supported providers (see [Use Any Model](#use-any-model))
- **Git** — initialized automatically if missing - **Git** — initialized automatically if missing

View file

@ -16,7 +16,8 @@
# derivation degraded mode under bun). # derivation degraded mode under bun).
# - bun's native-addon loader doesn't inherit the system library # - bun's native-addon loader doesn't inherit the system library
# search path under Nix (libz.so.1 not found for forge_engine.node). # 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. # --experimental-strip-types so .ts runs directly.
# - The src/resources/extensions/sf/tests/resolve-ts.mjs loader hook # - The src/resources/extensions/sf/tests/resolve-ts.mjs loader hook
# already handles .js → .ts import-specifier remapping for runtime # 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 # - Exports SF_BIN_PATH=dist/loader.js so all child processes (including
# subagent pi instances) use the Node.js entry point directly. # subagent pi instances) use the Node.js entry point directly.
# #
# Requirements: node >= 24 on PATH, # Requirements: node >= 26.1 on PATH,
# node_modules populated. # node_modules populated.
set -euo pipefail set -euo pipefail

View file

@ -5,7 +5,7 @@ checked out and want a working local SF development environment.
## Prerequisites ## Prerequisites
- Node.js 24 or newer - Node.js 26.1 or newer
- npm - npm
- Git - Git
- Rust toolchain for native engine work - Rust toolchain for native engine work

View file

@ -8,7 +8,7 @@ SF is a purpose-to-software compiler. It turns bounded intent into PDD contracts
| Requirement | Minimum | Recommended | | 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 | | **[Git](https://git-scm.com/)** | 2.20+ | Latest |
| **LLM API key** | Any supported provider | Anthropic (Claude) | | **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:** **Step 1 — Install Node.js and Git:**
```bash ```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 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:** **Step 1 — Install Node.js and Git:**
```bash ```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 sudo dnf install -y nodejs git
``` ```