@loredotlink/cli 0.1.180

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@loredotlink/cli",
+  "version": "0.1.180",
+  "description": "Lore CLI",
+  "type": "module",
+  "bin": {
+    "lore": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts/nodeVersionGuard.mjs",
+    "scripts/runPostinstallCommand.mjs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@sentry/esbuild-plugin": "^5.2.1",
+    "@ts-rest/core": "3.53.0-rc.1",
+    "@types/node": "^22.16.5",
+    "@types/react": "^19.0.0",
+    "drizzle-orm": "^0.45.2",
+    "esbuild": "^0.28.1",
+    "ink-testing-library": "^4.0.0",
+    "smol-toml": "^1.6.1",
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.3",
+    "@lore/identity-store": "0.1.0",
+    "@lore/contracts": "0.1.0",
+    "@lore/transcript-locate": "0.1.0",
+    "@lore/transcripts": "0.1.0",
+    "@lore/db": "0.1.0"
+  },
+  "dependencies": {
+    "@sentry/node": "^10.47.0",
+    "citty": "^0.2.2",
+    "ink": "^6.0.0",
+    "react": "^19.0.0",
+    "yaml": "2.8.3",
+    "zod": "^4.4.3"
+  },
+  "scripts": {
+    "bootstrap:dev-auth": "tsx scripts/bootstrapDevAuth.mjs",
+    "dev": "node scripts/runDev.mjs",
+    "dev:reload": "SENTRY_SPOTLIGHT=1 pnpm run postinstall && node scripts/runDev.mjs",
+    "dev:watch": "tsx src/index.ts _run_upload --watch",
+    "postinstall": "node scripts/runPostinstallCommand.mjs postinstall:migrate && node scripts/runPostinstallCommand.mjs postinstall:refresh-background-binary",
+    "build": "node scripts/build.mjs",
+    "build:prod": "node scripts/build.mjs --prod",
+    "gen:scrubber-rules": "node scripts/generateBaselineRules.mjs",
+    "start": "node dist/index.js",
+    "tui:stories": "tsx src/index.ts tui:stories",
+    "lint": "biome check src",
+    "typecheck": "tsc --noEmit",
+    "test": "node scripts/runTests.mjs",
+    "test:skill-sync:e2e": "env NODE_ENV=test S3_BUCKET=test AWS_ACCESS_KEY_ID=test AWS_SECRET_ACCESS_KEY=test tsx --test --experimental-test-isolation=none --import ../api/src/test/setup.ts src/skills/skillSync.e2e.ts"
+  }
+}

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

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+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:migrate',
+  'postinstall:refresh-background-binary',
+]);
+
+const command = process.argv[2];
+const commandArgs = process.argv.slice(3);
+
+if (!allowedCommands.has(command)) {
+  console.error(
+    `expected one of ${Array.from(allowedCommands).join(', ')}, got ${command ?? 'nothing'}`,
+  );
+  process.exit(1);
+}
+
+const packageRoot = fileURLToPath(new URL('..', import.meta.url));
+const distEntrypoint = path.join(packageRoot, 'dist', 'index.js');
+const sourceEntrypoint = path.join(packageRoot, 'src', 'index.ts');
+const localTsxBin = path.join(
+  packageRoot,
+  'node_modules',
+  '.bin',
+  process.platform === 'win32' ? 'tsx.cmd' : 'tsx',
+);
+// If `sourceEntrypoint` exists, run that; otherwise run `distEntrypoint`.
+// `src` is not distributed through NPM, so in prod only `distEntrypoint` will exist.
+// This may be brittle for other environments if/when we introduce other environments.
+// https://ampcode.com/threads/T-019dfafa-c2db-72e5-a874-dc50f383b5c0
+const useSource = existsSync(sourceEntrypoint);
+const entrypoint = useSource ? sourceEntrypoint : distEntrypoint;
+const executable = useSource
+  ? existsSync(localTsxBin)
+    ? localTsxBin
+    : 'tsx'
+  : process.execPath;
+
+if (!existsSync(entrypoint)) {
+  console.error(`CLI entrypoint not found at ${entrypoint}`);
+  process.exit(1);
+}
+
+const result = spawnSync(
+  executable,
+  [entrypoint, command, ...commandArgs],
+  {
+    cwd: packageRoot,
+    stdio: 'inherit',
+    shell: process.platform === 'win32' && useSource,
+  },
+);
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  console.error(`postinstall command terminated by ${result.signal}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);