centralu 0.1.0-beta.23 → 0.1.0-beta.24

package/bin/centralu.mjs

@@ -56,6 +56,7 @@ import {
   SERVE_HELP,
 } from './serve.mjs'
 import { swapInto } from './swap.mjs'
+import { belowFloor, floorOf, oldNodeSentence } from './node-floor.mjs'
 import { chmodSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import { homedir } from 'node:os'
@@ -65,6 +66,8 @@ const require = createRequire(import.meta.url)
 const pkg = require('../package.json')
 
 const APP_NAME = 'Centralu'
+/** The oldest Node the host runs on: this package's own `engines.node` (node-floor.mjs) */
+const NODE_FLOOR = floorOf(pkg.engines.node)
 const BUNDLE = `${APP_NAME}.app`
 /*
  * `CENTRALU_INSTALLED_COPY` points `install` and the copy checks at another bundle path. It exists
@@ -591,7 +594,7 @@ const HELP = `${APP_NAME} ${pkg.version}
                         to reach over SSH (\`centralu serve --help\`)
   centralu --version    Prints the version
 
-Requires: Node 22+, and the claude or codex CLI (the app's first screen reports the status)`
+Requires: Node ${NODE_FLOOR}+, and the claude or codex CLI (the app's first screen reports the status)`
 
 const [cmd, ...rest] = process.argv.slice(2)
 switch (cmd) {
@@ -621,6 +624,26 @@ switch (cmd) {
         process.exitCode = rotateToken({ env: process.env, home: HOME })
         break
       }
+      /*
+       * Before anything spawns a host: under a Node below the floor the host crashes on its first
+       * database call, with nothing in its log (issue #699). `--detach` also answers in the line the
+       * hub reads, so it can offer its managed install instead of quoting a crash. `--autostart on`
+       * writes a boot entry that would start that host. `--connection`, `--stop`, `--autostart
+       * off|status` and `--rotate-token` start no host and keep working, so the hub can still ask this
+       * machine what Node it has.
+       */
+      const startsHost = args.mode === 'serve' || args.mode === 'detach' || (args.mode === 'autostart' && args.autostart === 'on')
+      if (startsHost && belowFloor(process.versions.node, NODE_FLOOR)) {
+        const message = oldNodeSentence(process.versions.node, NODE_FLOOR)
+        console.error(`centralu serve: ${message}`)
+        if (args.mode === 'detach') {
+          const line = { v: 1, detach: { ok: false, how: null, reason: 'node_too_old', message, node: process.versions.node, floor: NODE_FLOOR } }
+          process.stdout.write(`${JSON.stringify(line)}\n`)
+        }
+        // Not process.exit: the line above is on a pipe, and exiting at once may cut it
+        process.exitCode = 1
+        break
+      }
       // A launcher `--detach` started: what it carried (the data folder, a host entry) applies before
       // anything below reads the environment
       const spec = args.child !== undefined ? decodeChildSpec(args.child) : null

package/bin/node-floor.mjs

@@ -0,0 +1,42 @@
+/**
+ * The oldest Node the bundled host runs on, and what the launcher says when it is run on an older one.
+ *
+ * **The floor is `engines.node` of this package, read here and nowhere restated.** The host's native
+ * database module (better-sqlite3 13) declares Node-API 10, which Node has from 22.14.0. Under an
+ * older 22.x (and under 20) it loads, then crashes on its first use with an access violation
+ * (`0xC0000005`, exit 3221225477, on Windows) or SIGSEGV (measured on 22.12.0, Windows and macOS,
+ * issue #699), before the host logs a line. The hub reads the same value from its copy of this
+ * package's `package.json` (`packages/agent-host/src/links/node-floor.ts`), and
+ * `tooling/engines.test.ts` keeps the other declarations equal to it.
+ *
+ * Lives in its own file so it can be tested (tooling/launcher-node-floor.test.ts): the launcher
+ * itself runs commands at import time. Plain JavaScript on Node's own modules and `semver.mjs`.
+ */
+import { isNewer } from './semver.mjs'
+
+/** `>=22.14.0` or `>=22.14` → `22.14.0`; throws on any other shape, which `engines` must not take */
+export function floorOf(range) {
+  const m = /^>=\s*(\d+)\.(\d+)(?:\.(\d+))?$/.exec(String(range).trim())
+  if (!m) throw new Error(`engines.node must be a plain floor like ">=22.14.0", not ${JSON.stringify(range)}`)
+  return `${m[1]}.${m[2]}.${m[3] ?? '0'}`
+}
+
+/** Whether `found` (`22.12.0` or `v22.12.0`) is older than `floor`; a version that does not parse is let through */
+export function belowFloor(found, floor) {
+  const v = String(found).trim().replace(/^v/i, '')
+  if (!/^\d+\.\d+\.\d+/.test(v)) return false
+  return isNewer(floor, v)
+}
+
+/**
+ * The one sentence for a launcher that will not start the host on this Node: the Node it found, the
+ * floor, and the two ways out. It names no command, since it is also what the hub reads out of the
+ * `--detach` answer.
+ */
+export function oldNodeSentence(found, floor) {
+  const v = String(found).replace(/^v/i, '')
+  return (
+    `centralu serve needs Node ${floor} or newer and this is Node ${v}: update Node on this machine, ` +
+    'or link this machine from a Centralu window on another computer, which installs a Node of its own there.'
+  )
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "centralu",
-  "version": "0.1.0-beta.23",
+  "version": "0.1.0-beta.24",
   "description": "Run, watch and steer several Claude Code and Codex CLI sessions from one window",
   "license": "MIT",
   "author": "ijun17",
@@ -21,6 +21,7 @@
     "windows",
     "desktop"
   ],
+  "protocolVersion": 1,
   "type": "module",
   "bin": {
     "centralu": "bin/centralu.mjs"
@@ -29,7 +30,7 @@
     "bin"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=22.14.0"
   },
   "os": [
     "darwin",
@@ -37,9 +38,9 @@
     "win32"
   ],
   "optionalDependencies": {
-    "@centralu/darwin-arm64": "0.1.0-beta.23",
-    "@centralu/linux-arm64": "0.1.0-beta.23",
-    "@centralu/linux-x64": "0.1.0-beta.23",
-    "@centralu/win32-x64": "0.1.0-beta.23"
+    "@centralu/darwin-arm64": "0.1.0-beta.24",
+    "@centralu/linux-arm64": "0.1.0-beta.24",
+    "@centralu/linux-x64": "0.1.0-beta.24",
+    "@centralu/win32-x64": "0.1.0-beta.24"
   }
 }