@chrysb/alphaclaw 0.9.29 → 0.9.31

package/README.md

@@ -219,7 +219,7 @@ npm run test:watch      # Watch mode
 npm run test:coverage   # Coverage report
 ```
 
-**Requirements:** Node.js ≥ 22.14.0
+**Requirements:** Node.js ≥ 22.22.3 on Node 22, ≥ 24.15.0 on Node 24, or ≥ 25.9.0
 
 ## Official Website
 

package/bin/alphaclaw.js

@@ -26,6 +26,7 @@ const {
 const {
   migrateManagedInternalFiles,
 } = require("../lib/server/internal-files-migration");
+const { assertSupportedNodeVersion } = require("../lib/node-runtime");
 
 const kUsageTrackerPluginPath = path.resolve(
   __dirname,
@@ -137,6 +138,15 @@ Examples:
   process.exit(0);
 }
 
+if (command === "start") {
+  try {
+    assertSupportedNodeVersion();
+  } catch (error) {
+    console.error(`[alphaclaw] ${error.message}`);
+    process.exit(1);
+  }
+}
+
 const quoteArg = (value) => `'${String(value || "").replace(/'/g, "'\"'\"'")}'`;
 const resolveGithubRepoPath = (value) =>
   String(value || "")
@@ -792,6 +802,30 @@ if (fs.existsSync(path.join(openclawDir, ".git"))) {
   }
 }
 
+// Persist config-shape migrations before any OpenClaw import or CLI command.
+// Newer OpenClaw releases validate config eagerly and cannot repair a shape
+// that prevents the CLI from starting.
+if (fs.existsSync(configPath)) {
+  try {
+    const cfg = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    if (migrateLegacyTelegramStreamingConfig(cfg)) {
+      let content = `${JSON.stringify(cfg, null, 2)}\n`;
+      for (const [secret, envRef] of buildSecretReplacements(process.env)) {
+        if (!secret) continue;
+        content = content
+          .split(JSON.stringify(secret))
+          .join(JSON.stringify(envRef));
+      }
+      fs.writeFileSync(configPath, content, "utf8");
+      console.log("[alphaclaw] Migrated legacy Telegram streaming config");
+    }
+  } catch (error) {
+    console.error(
+      `[alphaclaw] Preflight config migration failed: ${error.message}`,
+    );
+  }
+}
+
 if (fs.existsSync(configPath)) {
   try {
     execFileSync(process.execPath, [

package/lib/node-runtime.js

@@ -0,0 +1,38 @@
+const parseNodeVersion = (value = process.versions.node) => {
+  const match = String(value || "").trim().match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!match) return null;
+  return match.slice(1).map((part) => Number.parseInt(part, 10));
+};
+
+const isAtLeast = (version, minimum) => {
+  for (let index = 0; index < minimum.length; index += 1) {
+    if (version[index] > minimum[index]) return true;
+    if (version[index] < minimum[index]) return false;
+  }
+  return true;
+};
+
+const isSupportedNodeVersion = (value = process.versions.node) => {
+  const version = parseNodeVersion(value);
+  if (!version) return false;
+  const [major] = version;
+  if (major === 22) return isAtLeast(version, [22, 22, 3]);
+  if (major === 24) return isAtLeast(version, [24, 15, 0]);
+  if (major === 25) return isAtLeast(version, [25, 9, 0]);
+  return major >= 26;
+};
+
+const getUnsupportedNodeMessage = (value = process.versions.node) =>
+  `Node.js ${value} is not supported. AlphaClaw requires Node.js >=22.22.3 <23, >=24.15.0 <25, or >=25.9.0.`;
+
+const assertSupportedNodeVersion = (value = process.versions.node) => {
+  if (isSupportedNodeVersion(value)) return;
+  throw new Error(getUnsupportedNodeMessage(value));
+};
+
+module.exports = {
+  assertSupportedNodeVersion,
+  getUnsupportedNodeMessage,
+  isSupportedNodeVersion,
+  parseNodeVersion,
+};