@tanagram/lore 0.1.67 → 0.1.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanagram/lore",
-  "version": "0.1.67",
+  "version": "0.1.69",
   "description": "Lore CLI",
   "type": "module",
   "bin": {
@@ -9,11 +9,15 @@
   "files": [
     "dist",
     "skills",
+    "scripts/nodeVersionGuard.mjs",
     "scripts/runPostinstallCommand.mjs"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=20"
+  },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@sentry/esbuild-plugin": "^5.2.1",
@@ -24,8 +28,8 @@
     "ink-testing-library": "^4.0.0",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
-    "@lore/transcripts": "0.1.0",
-    "@lore/contracts": "0.1.0"
+    "@lore/contracts": "0.1.0",
+    "@lore/transcripts": "0.1.0"
   },
   "dependencies": {
     "@sentry/node": "^10.47.0",

package/scripts/nodeVersionGuard.mjs

@@ -0,0 +1,27 @@
+// Shared by the runtime CLI guard (src/lib/requireNode20.ts) and the
+// postinstall shim (scripts/runPostinstallCommand.mjs). Kept as `.mjs`
+// so the postinstall script — which runs plain Node, no bundler — can
+// import it directly; esbuild bundles it into the CLI for the runtime
+// guard.
+//
+// The minimum is driven by Ink 6 and its transitive deps (notably
+// string-width 8), which use the RegExp `v` (unicodeSets) flag at
+// module init. That flag requires Node >= 20; on Node 18 the module
+// crashes with `SyntaxError: Invalid flags supplied to RegExp
+// constructor 'v'` before any of our code runs.
+export const MIN_NODE_MAJOR = 20;
+
+export function checkNodeVersion(version = process.versions.node) {
+  const major = Number.parseInt(version.split('.')[0] ?? '', 10);
+  if (!Number.isFinite(major) || major <= 0) {
+    return { ok: true, currentVersion: version, message: null };
+  }
+  if (major < MIN_NODE_MAJOR) {
+    return {
+      ok: false,
+      currentVersion: version,
+      message: `requires Node.js >= ${MIN_NODE_MAJOR}.0.0 (found ${version})`,
+    };
+  }
+  return { ok: true, currentVersion: version, message: null };
+}

package/scripts/runPostinstallCommand.mjs

@@ -4,6 +4,17 @@ import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+import { checkNodeVersion } from './nodeVersionGuard.mjs';
+
+// Skip postinstall (rather than crashing it) on unsupported Node so
+// `npm install` finishes and the user only sees the engines warning.
+// The CLI's runtime guard reports the same constraint on next run.
+const nodeVersion = checkNodeVersion();
+if (!nodeVersion.ok) {
+  console.warn(`lore: skipping postinstall — ${nodeVersion.message}.`);
+  process.exit(0);
+}
+
 const allowedCommands = new Set([
   'postinstall:install-skills',
   'postinstall:refresh-background-binary',