fix(build): align engines.node with SUPPORTED_NODE_RANGE (#7446)

README.md

@@ -892,7 +892,7 @@ Compression: aggressive (~50%) → double your free quota · Cost: $0/mo
 | OAuth token expired                       | Auto-refreshed; if stuck, delete + re-auth in Providers                            |
 | `unsupported_country_region_territory`    | Configure proxy in Settings → Proxy                                                |
 | Docker SQLite locks                       | Use `--stop-timeout 40` for clean WAL checkpoint                                   |
-| Node runtime errors                       | Use Node `>=22.0.0 <23` or `>=24.0.0 <27`                                          |
+| Node runtime errors                       | Use Node `>=22.22.2 <23` or `>=24.0.0 <27`                                         |
 
 🐛 **Reporting a bug?** Run `npm run system-info` and attach `system-info.txt`. 📖 [`docs/guides/TROUBLESHOOTING.md`](docs/guides/TROUBLESHOOTING.md)
 
@@ -936,7 +936,7 @@ Compression: aggressive (~50%) → double your free quota · Cost: $0/mo
 
 </div>
 
-- **Runtime**: Node.js 22.x or 24.x LTS (24 LTS recommended) — `>=22.0.0 <23 || >=24.0.0 <27`
+- **Runtime**: Node.js 22.x or 24.x LTS (24 LTS recommended) — `>=22.22.2 <23 || >=24.0.0 <27`
 - **Language**: TypeScript 6.0 — **100% TypeScript** across `src/` and `open-sse/` (zero `any` in core modules since v2.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **Database**: better-sqlite3 (SQLite) + LowDB (JSON legacy) — domain state, proxy logs, MCP audit, routing decisions, memory, skills
@@ -1251,7 +1251,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 **[⬆ Back to top](#-omniroute)** · Built with ❤️ for the open-source AI community.
 
-<sub>OmniRoute v3.8.43 · Node ≥22.0.0 · MIT License · <a href="https://omniroute.online">omniroute.online</a></sub>
+<sub>OmniRoute v3.8.43 · Node ≥22.22.2 · MIT License · <a href="https://omniroute.online">omniroute.online</a></sub>
 
 </div>
 <!-- GitHub Discussions enabled for community Q&A -->

changelog.d/fixes/7490-align-engines-node.md

@@ -0,0 +1 @@
+- fix(build): align `engines.node` supported range (>=22.22.2 <23 || >=24.0.0 <27) across package.json, lockfile, README engine references and the node-runtime support test, so install-time engine checks match the actually-tested runtimes (#7446)

package.json

@@ -49,7 +49,7 @@
     "open-sse"
   ],
   "engines": {
-    "node": ">=22.0.0 <23 || >=24.0.0 <27"
+    "node": ">=22.22.2 <23 || >=24.0.0 <27"
   },
   "keywords": [
     "ai",

tests/unit/node-runtime-support.test.ts

@@ -1,5 +1,6 @@
 import test from "node:test";
 import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
 
 import {
   SUPPORTED_NODE_RANGE,
@@ -82,3 +83,11 @@ test("CLI runtime support stays aligned with the shared runtime policy", () => {
   assert.deepEqual(getCliNodeRuntimeSupport("22.22.2"), getNodeRuntimeSupport("22.22.2"));
   assert.equal(getCliNodeRuntimeWarning("27.1.0"), getNodeRuntimeWarning("27.1.0"));
 });
+
+test("package.json engines.node equals SUPPORTED_NODE_RANGE (install gate == runtime gate)", () => {
+  // Regression guard for #7446: npm consults `engines.node` at install time while the
+  // runtime rejects anything outside SUPPORTED_NODE_RANGE. If the two drift, npm installs
+  // OmniRoute on a Node version the runtime then refuses to run (the Node 22.0.0–22.22.1 gap).
+  const pkg = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+  assert.equal(pkg.engines.node, SUPPORTED_NODE_RANGE);
+});