@antfly/cli 0.2.1-rc2 → 0.2.2

package/README.md

@@ -8,6 +8,9 @@ antfly --version
 ```
 
 This package is separate from `@antfly/sdk`, which contains the TypeScript SDK.
-The CLI package depends on a platform-specific package that carries the native
-`antfly` executable, Antfarm dashboard assets, and the Antfly C ABI
-header/library.
+The CLI package selects a platform-specific package by OS and CPU. Linux npm
+installations require glibc 2.28 or newer, matching the supported Node.js 24
+runtime. On musl systems, install the portable archive with
+`https://releases.antfly.io/antfly/latest/install.sh` instead. The platform
+package carries the native `antfly` executable, Antfarm dashboard assets, and
+the Antfly C ABI header/library.

package/bin/antfly.js

@@ -5,18 +5,21 @@ import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { join } from "node:path";
 
-const require = createRequire(import.meta.url);
+import { detectLinuxLibc, resolvePlatformPackage } from "./platform.js";
 
-const packageByPlatform = {
-  "darwin-arm64": "@antfly/cli-darwin-arm64",
-  "linux-arm64": "@antfly/cli-linux-arm64",
-  "linux-x64": "@antfly/cli-linux-x64"
-};
+const require = createRequire(import.meta.url);
 
 const platformKey = `${process.platform}-${process.arch}`;
-const packageName = packageByPlatform[platformKey];
+const packageName = resolvePlatformPackage(process.platform, process.arch);
 
 if (!packageName) {
+  if (process.platform === "linux" && detectLinuxLibc() !== "glibc") {
+    console.error("The npm Antfly CLI supports glibc Linux only.");
+    console.error(
+      "Install the portable musl build with https://releases.antfly.io/antfly/latest/install.sh instead."
+    );
+    process.exit(1);
+  }
   console.error(`Unsupported Antfly CLI platform: ${platformKey}`);
   process.exit(1);
 }
@@ -30,7 +33,12 @@ try {
   process.exit(1);
 }
 
-const executable = join(packageJsonPath, "..", "bin", process.platform === "win32" ? "antfly.exe" : "antfly");
+const executable = join(
+  packageJsonPath,
+  "..",
+  "bin",
+  process.platform === "win32" ? "antfly.exe" : "antfly"
+);
 if (!existsSync(executable)) {
   console.error(`Antfly CLI executable is missing: ${executable}`);
   process.exit(1);

package/bin/platform.js

@@ -0,0 +1,24 @@
+export function detectLinuxLibc(report = process.report) {
+  try {
+    // Node 24's supported GNU/Linux floor is glibc 2.28, matching the GNU
+    // Antfly archive. The shell installer separately handles older glibc by
+    // selecting the portable musl build.
+    return report?.getReport()?.header?.glibcVersionRuntime ? "glibc" : "musl";
+  } catch {
+    return "musl";
+  }
+}
+
+export function resolvePlatformPackage(platform, arch, report = process.report) {
+  if (platform === "darwin" && arch === "arm64") {
+    return "@antfly/cli-darwin-arm64";
+  }
+  if (platform !== "linux" || (arch !== "arm64" && arch !== "x64")) {
+    return undefined;
+  }
+
+  if (detectLinuxLibc(report) !== "glibc") {
+    return undefined;
+  }
+  return `@antfly/cli-linux-${arch}`;
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@antfly/cli",
-  "version": "0.2.1-rc2",
+  "version": "0.2.2",
+  "type": "module",
   "description": "Native Antfly CLI installer package",
   "license": "Elastic-2.0",
   "repository": {
@@ -20,12 +21,12 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --check ./bin/antfly.js"
+    "test": "node --test ./test/*.test.js && node --check ./bin/antfly.js"
   },
   "optionalDependencies": {
-    "@antfly/cli-darwin-arm64": "0.2.1-rc2",
-    "@antfly/cli-linux-arm64": "0.2.1-rc2",
-    "@antfly/cli-linux-x64": "0.2.1-rc2"
+    "@antfly/cli-darwin-arm64": "0.2.2",
+    "@antfly/cli-linux-arm64": "0.2.2",
+    "@antfly/cli-linux-x64": "0.2.2"
   },
   "engines": {
     "node": ">=24.0"