@solidnumber/cli 2.11.12 → 2.11.14

package/dist/lib/editor-preflight.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preflightEditor = preflightEditor;
+/**
+ * Editor preflight — "on PATH" is not the same as "can actually run."
+ *
+ * Real-world failure this exists for (2026-06-04, Adam's older iMac):
+ * Claude Code was installed via npm, so `command -v claude` succeeded —
+ * setup reported ✓ green for the MCP wiring and the SessionStart hook —
+ * but the `claude` native binary requires macOS 13+ and the machine was
+ * older, so every launch aborted with:
+ *
+ *   dyld: Symbol not found: _ubrk_clone
+ *     Referenced from: .../bin/claude (which was built for Mac OS X 13.0)
+ *     Expected in: /usr/lib/libicucore.A.dylib
+ *
+ * A new user reads that as "Solid is broken." This module runs
+ * `<binary> --version` once and translates launch failures into a plain
+ * reason + remediation hint, so `solid setup` / `solid ai` can say what
+ * is actually wrong and what to do about it.
+ */
+const child_process_1 = require("child_process");
+const defaultRunner = (binary, args) => {
+    const r = (0, child_process_1.spawnSync)(binary, args, {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        timeout: 15_000,
+        env: { ...process.env, SOLID_SKIP_VERSION_CHECK: '1' },
+    });
+    return {
+        status: r.status,
+        signal: r.signal,
+        stdout: (r.stdout || '').toString(),
+        stderr: (r.stderr || '').toString(),
+        error: r.error,
+    };
+};
+// Per-editor alternatives shown when the binary can't run on this machine.
+const ALTERNATIVES = {
+    claude: 'Use claude.ai/code in the browser, or Cursor on this machine.',
+    cursor: 'Use claude.ai/code in the browser, or Claude Code on this machine.',
+    codex: 'Use another editor on this machine.',
+};
+/**
+ * Run `<binary> --version` and translate any launch failure into a
+ * human-readable reason + hint. ok=true means the binary genuinely
+ * starts on this machine.
+ */
+function preflightEditor(binary, runner = defaultRunner) {
+    let r;
+    try {
+        r = runner(binary, ['--version']);
+    }
+    catch (e) {
+        return {
+            ok: false,
+            reason: `${binary} failed to launch: ${e.message}`,
+            hint: `Reinstall ${binary}, then re-run this command.`,
+        };
+    }
+    if (r.error) {
+        return {
+            ok: false,
+            reason: `${binary} failed to launch: ${r.error.message}`,
+            hint: `Reinstall ${binary}, then re-run this command.`,
+        };
+    }
+    if (r.status === 0)
+        return { ok: true };
+    const output = `${r.stderr}\n${r.stdout}`;
+    // dyld symbol/link errors = the binary was built for a newer macOS than
+    // this machine runs. Extract the "built for Mac OS X 13.0" version when
+    // present so the message names the real requirement.
+    if (/dyld|Symbol not found|Library not loaded/i.test(output)) {
+        const built = output.match(/built for (?:Mac OS X|macOS) (\d+(?:\.\d+)?)/i);
+        const needs = built ? `macOS ${built[1]}+` : 'a newer macOS than this machine is running';
+        return {
+            ok: false,
+            reason: `${binary} is installed but cannot run on this Mac — its binary requires ${needs}.`,
+            hint: `Update macOS${built ? ` to ${built[1]} or later` : ''}, or: ${ALTERNATIVES[binary] || 'use another editor.'}`,
+        };
+    }
+    if (r.signal) {
+        return {
+            ok: false,
+            reason: `${binary} is installed but crashed on launch (signal ${r.signal}).`,
+            hint: `Reinstall ${binary}. If it keeps crashing: ${ALTERNATIVES[binary] || 'use another editor.'}`,
+        };
+    }
+    const firstLine = output.trim().split('\n')[0]?.slice(0, 160) || `exit code ${r.status}`;
+    return {
+        ok: false,
+        reason: `${binary} is installed but exited with an error on launch: ${firstLine}`,
+        hint: `Reinstall ${binary}, then re-run this command.`,
+    };
+}
+//# sourceMappingURL=editor-preflight.js.map

package/dist/lib/editor-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-preflight.js","sourceRoot":"","sources":["../../src/lib/editor-preflight.ts"],"names":[],"mappings":";;AAkEA,0CAsDC;AAxHD;;;;;;;;;;;;;;;;;GAiBG;AACH,iDAA0C;AAoB1C,MAAM,aAAa,GAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;IACtD,MAAM,CAAC,GAAG,IAAA,yBAAS,EAAC,MAAM,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,OAAO,EAAE,MAAM;QACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE;KACvD,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;QACnC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;QACnC,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC;AACJ,CAAC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,YAAY,GAA2B;IAC3C,MAAM,EAAE,+DAA+D;IACvE,MAAM,EAAE,oEAAoE;IAC5E,KAAK,EAAE,qCAAqC;CAC7C,CAAC;AAEF;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,MAAc,EACd,SAA0B,aAAa;IAEvC,IAAI,CAA8B,CAAC;IACnC,IAAI,CAAC;QACH,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,MAAM,sBAAuB,CAAW,CAAC,OAAO,EAAE;YAC7D,IAAI,EAAE,aAAa,MAAM,6BAA6B;SACvD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;YACxD,IAAI,EAAE,aAAa,MAAM,6BAA6B;SACvD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAExC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAE1C,wEAAwE;IACxE,wEAAwE;IACxE,qDAAqD;IACrD,IAAI,2CAA2C,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,4CAA4C,CAAC;QAC1F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,MAAM,kEAAkE,KAAK,GAAG;YAC3F,IAAI,EAAE,eAAe,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,YAAY,CAAC,MAAM,CAAC,IAAI,qBAAqB,EAAE;SACrH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,MAAM,+CAA+C,CAAC,CAAC,MAAM,IAAI;YAC5E,IAAI,EAAE,aAAa,MAAM,2BAA2B,YAAY,CAAC,MAAM,CAAC,IAAI,qBAAqB,EAAE;SACpG,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC;IACzF,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,GAAG,MAAM,qDAAqD,SAAS,EAAE;QACjF,IAAI,EAAE,aAAa,MAAM,6BAA6B;KACvD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidnumber/cli",
-  "version": "2.11.12",
+  "version": "2.11.14",
   "description": "Be There — the system that answers, books, and takes payment when you can't. CLI + SDK + MCP tools for SMBs, agencies, and AI agents. solid clone plumber → working business in 30 seconds.",
   "main": "dist/index.js",
   "type": "commonjs",

package/platform-docs/llms.txt

@@ -128,7 +128,7 @@ Developer funnel: Free signup → API key → MCP config → manage client busin
 
 <!-- CLI:AUTO:BEGIN -->
 
-- [npm](https://www.npmjs.com/package/@solidnumber/cli): `@solidnumber/cli` v2.11.12
+- [npm](https://www.npmjs.com/package/@solidnumber/cli): `@solidnumber/cli` v2.11.14
 - [GitHub](https://github.com/Adam-Camp-King/solid-cli): Open-source TypeScript CLI (BUSL-1.1)
 - [CLI Documentation](https://solidnumber.com/docs/cli): Full command reference
 - **Machine-readable verb tree**: `solid schema verbs --json` — every command, every flag, every description, in one JSON dump. Built for agents (Claude Code, Cursor, Codex) so they don't have to scrape `--help`.
@@ -263,7 +263,7 @@ Developer funnel: Free signup → API key → MCP config → manage client busin
 - **webmcp** (4 subcommands) — Manage the in-browser MCP transport — manifest, dispatch test, invocations, consent: `consent, invocations, manifest, test`
 - **widget** (7 subcommands) — Widgets — embeddable business widgets: `activate, create, delete, embed, get, list, update`
 
-*Auto-generated from the live commander tree at build time. CLI version 2.11.12, manifest schema 1.0, generated 2026-05-26. Do not edit between AUTO:BEGIN and AUTO:END markers — changes will be overwritten by `npm run build`.*
+*Auto-generated from the live commander tree at build time. CLI version 2.11.14, manifest schema 1.0, generated 2026-06-04. Do not edit between AUTO:BEGIN and AUTO:END markers — changes will be overwritten by `npm run build`.*
 
 <!-- CLI:AUTO:END -->