feat: add strict Node.js version compatibility checks

packages/cli/bin/dev.js

@@ -1,5 +1,17 @@
 #!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
 
-import { execute } from "@oclif/core";
+const MIN_NODE_MAJOR = 18;
+const currentVersion = process.versions.node;
+const currentMajor = parseInt(currentVersion.split(".")[0], 10);
+
+if (currentMajor < MIN_NODE_MAJOR) {
+  console.error(
+    `\nError: ecloud requires Node.js v${MIN_NODE_MAJOR} or later, but you are running v${currentVersion}.\n` +
+      `Please upgrade Node.js: https://nodejs.org/\n`,
+  );
+  process.exit(1);
+}
+
+const { execute } = await import("@oclif/core");
 
 await execute({ development: true, dir: import.meta.url });

packages/cli/bin/run.js

@@ -1,5 +1,20 @@
 #!/usr/bin/env node
 
-import { execute } from "@oclif/core";
+// Preflight: check Node.js version before loading dependencies.
+// Without this, an incompatible Node version surfaces as a cryptic
+// "ReferenceError: crypto is not defined" deep in the workflow.
+const MIN_NODE_MAJOR = 18;
+const currentVersion = process.versions.node;
+const currentMajor = parseInt(currentVersion.split(".")[0], 10);
+
+if (currentMajor < MIN_NODE_MAJOR) {
+  console.error(
+    `\nError: ecloud requires Node.js v${MIN_NODE_MAJOR} or later, but you are running v${currentVersion}.\n` +
+      `Please upgrade Node.js: https://nodejs.org/\n`,
+  );
+  process.exit(1);
+}
+
+const { execute } = await import("@oclif/core");
 
 await execute({ dir: import.meta.url });

packages/cli/package.json

@@ -2,6 +2,9 @@
   "name": "@layr-labs/ecloud-cli",
   "version": "0.0.0-development",
   "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "files": [
     "dist",
     "bin",

packages/sdk/package.json

@@ -2,6 +2,9 @@
   "name": "@layr-labs/ecloud-sdk",
   "version": "0.0.0-development",
   "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",