@openrig/cli 0.1.11 → 0.2.0

package/dist/tmux-health.js

@@ -0,0 +1,105 @@
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function isTmuxNoServerMessage(message) {
+    const normalized = message.toLowerCase();
+    return normalized.includes("no server running")
+        || normalized.includes("failed to connect to server")
+        || (normalized.includes("error connecting to") && normalized.includes("no such file or directory"));
+}
+export function buildTmuxControlFailure(message) {
+    return {
+        message: "tmux installed, but the default control socket is unhealthy.",
+        reason: `OpenRig uses tmux control commands to launch, inspect, and manage agent sessions. The default tmux socket is returning: ${message}`,
+        fix: "Capture any needed state from visible tmux panes, then restart the default tmux server before retrying OpenRig. If this happened after a machine restore, treat it as attention required rather than a healthy running state.",
+    };
+}
+export function probeTmuxControl(exec) {
+    let version;
+    try {
+        version = exec("tmux -V").trim();
+    }
+    catch (err) {
+        return {
+            installed: false,
+            available: false,
+            version: null,
+            detail: errorMessage(err),
+            code: "not_installed",
+        };
+    }
+    try {
+        exec("tmux list-sessions");
+        return {
+            installed: true,
+            available: true,
+            version,
+            detail: null,
+            code: "available",
+        };
+    }
+    catch (err) {
+        const detail = errorMessage(err).trim();
+        if (isTmuxNoServerMessage(detail)) {
+            return {
+                installed: true,
+                available: true,
+                version,
+                detail,
+                code: "no_server",
+            };
+        }
+        return {
+            installed: true,
+            available: false,
+            version,
+            detail,
+            code: "unhealthy",
+        };
+    }
+}
+export async function probeTmuxControlAsync(exec) {
+    let version;
+    try {
+        version = (await exec("tmux -V")).trim();
+    }
+    catch (err) {
+        return {
+            installed: false,
+            available: false,
+            version: null,
+            detail: errorMessage(err),
+            code: "not_installed",
+        };
+    }
+    try {
+        await exec("tmux list-sessions");
+        return {
+            installed: true,
+            available: true,
+            version,
+            detail: null,
+            code: "available",
+        };
+    }
+    catch (err) {
+        const detail = errorMessage(err).trim();
+        if (isTmuxNoServerMessage(detail)) {
+            return {
+                installed: true,
+                available: true,
+                version,
+                detail,
+                code: "no_server",
+            };
+        }
+        return {
+            installed: true,
+            available: false,
+            version,
+            detail,
+            code: "unhealthy",
+        };
+    }
+}
+//# sourceMappingURL=tmux-health.js.map

package/dist/tmux-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-health.js","sourceRoot":"","sources":["../src/tmux-health.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrig/cli",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "type": "module",
   "description": "Local control plane for multi-agent coding topologies",
   "keywords": [
@@ -31,10 +31,12 @@
   "files": [
     "dist",
     "daemon",
-    "ui"
+    "ui",
+    "scripts"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && chmod +x dist/bin-wrapper.js && mkdir -p dist/schemas && cp src/schemas/*.json dist/schemas/",
+    "postinstall": "node scripts/check-abi.mjs",
     "prepublishOnly": "bash ../../scripts/build-package.sh",
     "test": "vitest run",
     "test:watch": "vitest"
@@ -42,6 +44,8 @@
   "dependencies": {
     "@hono/node-server": "^1.13.0",
     "@modelcontextprotocol/sdk": "^1.28.0",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
     "better-sqlite3": "^11.8.0",
     "commander": "^13.0.0",
     "hono": "^4.7.0",
@@ -55,5 +59,8 @@
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": "^20 || ^22 || ^24"
   }
 }

package/scripts/check-abi.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+// Postinstall ABI sanity check for @openrig/cli.
+// Fails loudly if better-sqlite3 native binary does not match the active
+// Node runtime. Layered on top of the engines.node constraint in
+// package.json — engines warns at npm level; this hard-blocks at install
+// time with a copy-paste fix.
+
+/**
+ * @param {{ nodeVersion: string, loadNativeAddon: () => void }} deps
+ * @returns {{ ok: true } | { ok: false, message: string }}
+ */
+export function checkAbi({ nodeVersion, loadNativeAddon }) {
+  // Phase 1: version-range check (fast path).
+  // Even-numbered Node majors (20, 22, 24) are LTS lines with native addon
+  // prebuilds. Odd-numbered majors (21, 23, 25) generally lack them.
+  const match = nodeVersion.match(/^v?(\d+)/);
+  const major = match ? parseInt(match[1], 10) : 0;
+
+  if (major < 20) {
+    return {
+      ok: false,
+      message: [
+        "",
+        "  ╔══════════════════════════════════════════════════════════════╗",
+        `  ║  @openrig/cli requires Node.js 20, 22, or 24 (LTS).       ║`,
+        `  ║  Current: ${nodeVersion.padEnd(49)}║`,
+        "  ║                                                            ║",
+        "  ║  Fix:  nvm install 22 && npm install -g @openrig/cli       ║",
+        "  ╚══════════════════════════════════════════════════════════════╝",
+        "",
+      ].join("\n"),
+    };
+  }
+
+  if (major % 2 !== 0) {
+    return {
+      ok: false,
+      message: [
+        "",
+        "  ╔══════════════════════════════════════════════════════════════╗",
+        `  ║  @openrig/cli does not support odd-numbered Node releases.  ║`,
+        `  ║  Current: ${nodeVersion.padEnd(49)}║`,
+        "  ║                                                            ║",
+        "  ║  Odd Node versions (21, 23, 25, …) lack native addon       ║",
+        "  ║  prebuilds for better-sqlite3. The daemon will fail.       ║",
+        "  ║                                                            ║",
+        "  ║  Fix:  nvm install 22 && npm install -g @openrig/cli       ║",
+        "  ╚══════════════════════════════════════════════════════════════╝",
+        "",
+      ].join("\n"),
+    };
+  }
+
+  // Phase 2: ABI load check (catches edge cases like local Node builds
+  // or prebuild packaging gaps on supported versions).
+  try {
+    loadNativeAddon();
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    const isAbiMismatch = detail.includes("NODE_MODULE_VERSION");
+
+    if (isAbiMismatch) {
+      return {
+        ok: false,
+        message: [
+          "",
+          "  ╔══════════════════════════════════════════════════════════════╗",
+          "  ║  better-sqlite3 native binary does not match this Node.    ║",
+          `  ║  Current: ${nodeVersion.padEnd(49)}║`,
+          "  ║                                                            ║",
+          "  ║  Fix:  npm rebuild better-sqlite3                          ║",
+          "  ║   or:  nvm install 22 && npm install -g @openrig/cli       ║",
+          "  ╚══════════════════════════════════════════════════════════════╝",
+          "",
+          `  Detail: ${detail}`,
+          "",
+        ].join("\n"),
+      };
+    }
+
+    return {
+      ok: false,
+      message: [
+        "",
+        "  ╔══════════════════════════════════════════════════════════════╗",
+        "  ║  better-sqlite3 native addon failed to load.               ║",
+        `  ║  Current: ${nodeVersion.padEnd(49)}║`,
+        "  ║                                                            ║",
+        "  ║  Fix:  npm rebuild better-sqlite3                          ║",
+        "  ║  If that fails, reinstall with a supported Node version:   ║",
+        "  ║        nvm install 22 && npm install -g @openrig/cli       ║",
+        "  ╚══════════════════════════════════════════════════════════════╝",
+        "",
+        `  Detail: ${detail}`,
+        "",
+      ].join("\n"),
+    };
+  }
+
+  return { ok: true };
+}
+
+// --- Run when executed as postinstall script ---
+const isMain =
+  process.argv[1] &&
+  (import.meta.url === `file://${process.argv[1]}` ||
+    process.argv[1].endsWith("check-abi.mjs"));
+
+if (isMain) {
+  const { createRequire } = await import("node:module");
+  const require = createRequire(import.meta.url);
+
+  const result = checkAbi({
+    nodeVersion: process.version,
+    loadNativeAddon: () => require("better-sqlite3"),
+  });
+
+  if (!result.ok) {
+    console.error(result.message);
+    process.exitCode = 1;
+  }
+}