@lgtm-hq/lintro 0.155.0 → 0.156.0

package/lib/resolve.js

@@ -18,11 +18,29 @@
  */
 const PLATFORM_PACKAGES = Object.freeze({
   'darwin-arm64': '@lgtm-hq/lintro-darwin-arm64',
-  'darwin-x64': '@lgtm-hq/lintro-darwin-x64',
   'linux-arm64': '@lgtm-hq/lintro-linux-arm64',
   'linux-x64': '@lgtm-hq/lintro-linux-x64',
 });
 
+/**
+ * Platforms that ship no npm binary but have a supported install route
+ * elsewhere. Intel macOS lost its prebuilt binary in #2579: the `cryptography`
+ * dependency the MCP bundle needs ships no Intel macOS wheel from 49.0.0 on.
+ * Homebrew is the recommended route there because the formula's `on_intel`
+ * branch owns the PyPI install; a bare `pip install` works too but compiles
+ * cryptography from source, which needs a Rust toolchain on the machine.
+ *
+ * @type {Readonly<Record<string, string>>}
+ */
+const UNSUPPORTED_PLATFORM_HINTS = Object.freeze({
+  'darwin-x64':
+    'Intel Macs have no npm binary. Install with Homebrew ' +
+    '(`brew tap lgtm-hq/tap && brew install lintro`), which is the ' +
+    'recommended route. Installing from PyPI (`pip install lintro` or ' +
+    '`uv tool install lintro`) also works, but on an Intel Mac it builds ' +
+    'cryptography from source and needs a Rust toolchain.',
+});
+
 /**
  * Resolve the scoped package name for a platform/arch pair.
  *
@@ -38,6 +56,21 @@ function packageForPlatform(platform, arch) {
     : null;
 }
 
+/**
+ * Explain why a platform has no npm binary and where to install from.
+ *
+ * @param {string} platform - Value of `process.platform` (e.g. `"darwin"`).
+ * @param {string} arch - Value of `process.arch` (e.g. `"x64"`).
+ * @returns {string | null} A one-line pointer to another install route, or
+ *   `null` when the platform has none documented.
+ */
+function unsupportedPlatformHint(platform, arch) {
+  const key = `${platform}-${arch}`;
+  return Object.prototype.hasOwnProperty.call(UNSUPPORTED_PLATFORM_HINTS, key)
+    ? UNSUPPORTED_PLATFORM_HINTS[key]
+    : null;
+}
+
 /**
  * List of platform keys supported by the current distribution.
  *
@@ -65,8 +98,10 @@ function resolveBinary(requireFn, platform, arch) {
   const pkg = packageForPlatform(plat, cpu);
 
   if (!pkg) {
+    const hint = unsupportedPlatformHint(plat, cpu);
     throw new Error(
       `lintro: unsupported platform ${plat}-${cpu}. ` +
+        (hint ? `${hint} ` : '') +
         `Supported platforms: ${supportedPlatforms().join(', ')}.`
     );
   }
@@ -98,7 +133,9 @@ function resolveBinary(requireFn, platform, arch) {
 
 module.exports = {
   PLATFORM_PACKAGES,
+  UNSUPPORTED_PLATFORM_HINTS,
   packageForPlatform,
+  unsupportedPlatformHint,
   supportedPlatforms,
   resolveBinary,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lgtm-hq/lintro",
-  "version": "0.155.0",
+  "version": "0.156.0",
   "description": "A unified CLI for code formatting, linting, and quality assurance. Ships self-contained platform binaries — no Python required.",
   "keywords": [
     "lint",
@@ -30,10 +30,9 @@
     "lib/resolve.js"
   ],
   "optionalDependencies": {
-    "@lgtm-hq/lintro-darwin-arm64": "0.155.0",
-    "@lgtm-hq/lintro-darwin-x64": "0.155.0",
-    "@lgtm-hq/lintro-linux-arm64": "0.155.0",
-    "@lgtm-hq/lintro-linux-x64": "0.155.0"
+    "@lgtm-hq/lintro-darwin-arm64": "0.156.0",
+    "@lgtm-hq/lintro-linux-arm64": "0.156.0",
+    "@lgtm-hq/lintro-linux-x64": "0.156.0"
   },
   "engines": {
     "node": ">=18"