@fabr-client/core 1.0.0 → 1.0.2

package/README.md

@@ -48,6 +48,7 @@ Published platform packages:
 - `@fabr-client/core-win32-x64`
 - `@fabr-client/core-darwin-x64`
 - `@fabr-client/core-darwin-arm64`
+- `@fabr-client/core-linux-arm64`
 
 ## Publish Checklist
 
@@ -85,6 +86,17 @@ On macOS, build both `darwin-x64` and `darwin-arm64` payloads:
   --codex-runtime-repo /path/to/codex-runtime
 ```
 
+On Linux ARM64, build the `linux-arm64` payload on an ARM64 Linux build host:
+
+```bash
+./scripts/package-fabr-client.sh \
+  --profile release \
+  --target aarch64-unknown-linux-gnu \
+  --pack-npm \
+  --codex-runtime-mode build \
+  --codex-runtime-repo /path/to/codex-runtime
+```
+
 Validate and publish:
 
 ```bash

package/bin/fabr-client.js

@@ -13,181 +13,182 @@ const packageByPlatform = {
   "win32-x64": "@fabr-client/core-win32-x64",
   "darwin-x64": "@fabr-client/core-darwin-x64",
   "darwin-arm64": "@fabr-client/core-darwin-arm64",
+  "linux-arm64": "@fabr-client/core-linux-arm64",
 };
 
-function resolvePlatformPackageBinary(pkg) {
-  if (!pkg) {
-    return null;
-  }
-  try {
-    return path.join(path.dirname(require.resolve(`${pkg}/package.json`)), "bin", exe);
-  } catch {
-    return null;
-  }
-}
-
-function npmCommand() {
-  const npmExecPath = process.env.npm_execpath;
-  if (npmExecPath) {
-    return { command: process.execPath, args: [npmExecPath] };
-  }
-  return {
-    command: platform === "win32" ? "npm.cmd" : "npm",
-    args: [],
-  };
-}
-
-function npmSpawnOptions(cwd) {
-  const npm = npmCommand();
-  return {
-    npm,
-    options: {
-      cwd,
-      env: process.env,
-      shell: platform === "win32" && npm.command.endsWith(".cmd"),
-      stdio: "inherit",
-      windowsHide: true,
-    },
-  };
-}
-
-function packageSpec(pkg) {
-  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC) {
-    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC;
-  }
-  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL) {
-    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL;
-  }
-
-  const ownPackage = require("../package.json");
-  const version = ownPackage.optionalDependencies?.[pkg] || ownPackage.version;
-  return `${pkg}@${version}`;
-}
-
-function runNpmInstall(label, args, cwd) {
-  const { npm, options } = npmSpawnOptions(cwd);
-  console.error(label);
-  const result = spawnSync(npm.command, [...npm.args, ...args], options);
-
-  if (result.error || result.status !== 0) {
-    const message = result.error ? result.error.message : `npm exited with status ${result.status}`;
-    console.error(`${label} failed: ${message}`);
-    return false;
-  }
-
-  return true;
-}
-
-function installPlatformPackageLocal(spec) {
-  return runNpmInstall(
-    `Installing Fabr Client native payload: ${spec}`,
-    [
-      "install",
-      spec,
-      "--no-save",
-      "--package-lock=false",
-      "--include=optional",
-    ],
-    path.join(__dirname, ".."),
-  );
-}
-
-function installPlatformPackageGlobal(spec) {
-  return runNpmInstall(
-    `Installing Fabr Client native payload globally: ${spec}`,
-    [
-      "install",
-      "-g",
-      spec,
-      "--include=optional",
-    ],
-    path.join(__dirname, ".."),
-  );
-}
-
-function installPlatformPackageGlobalFromFallbackRegistry(spec) {
-  if (process.env.FABR_CLIENT_SKIP_REGISTRY_FALLBACK === "1") {
-    return false;
-  }
-  const registry =
-    process.env.FABR_CLIENT_NPM_FALLBACK_REGISTRY || "https://registry.npmjs.org";
-  return runNpmInstall(
-    `Installing Fabr Client native payload globally from fallback registry: ${spec}`,
-    [
-      "install",
-      "-g",
-      spec,
-      "--include=optional",
-      `--registry=${registry}`,
-    ],
-    path.join(__dirname, ".."),
-  );
-}
-
-function resolveInstalledBinary(pkg) {
-  const binary = resolvePlatformPackageBinary(pkg);
-  return binary && fs.existsSync(binary) ? binary : null;
-}
-
-function installAndResolvePlatformPackage(pkg) {
-  if (!pkg || process.env.FABR_CLIENT_SKIP_PLATFORM_INSTALL === "1") {
-    return null;
-  }
-
-  const spec = packageSpec(pkg);
-  if (installPlatformPackageLocal(spec)) {
-    const binary = resolveInstalledBinary(pkg);
-    if (binary) {
-      return binary;
-    }
-  }
-
-  if (installPlatformPackageGlobal(spec)) {
-    const binary = resolveInstalledBinary(pkg);
-    if (binary) {
-      return binary;
-    }
-  }
-
-  if (installPlatformPackageGlobalFromFallbackRegistry(spec)) {
-    const binary = resolveInstalledBinary(pkg);
-    if (binary) {
-      return binary;
-    }
-  }
-
-  return null;
-}
-
-const pkg = packageByPlatform[platformDir];
-const candidates = [
-  process.env.FABR_CLIENT_BIN,
-  resolvePlatformPackageBinary(pkg),
-  // Local development fallback: package payloads staged next to this repo.
-  path.join(__dirname, "..", "..", "npm-platforms", platformDir, "bin", exe),
-  path.join(__dirname, platformDir, exe),
+function resolvePlatformPackageBinary(pkg) {
+  if (!pkg) {
+    return null;
+  }
+  try {
+    return path.join(path.dirname(require.resolve(`${pkg}/package.json`)), "bin", exe);
+  } catch {
+    return null;
+  }
+}
+
+function npmCommand() {
+  const npmExecPath = process.env.npm_execpath;
+  if (npmExecPath) {
+    return { command: process.execPath, args: [npmExecPath] };
+  }
+  return {
+    command: platform === "win32" ? "npm.cmd" : "npm",
+    args: [],
+  };
+}
+
+function npmSpawnOptions(cwd) {
+  const npm = npmCommand();
+  return {
+    npm,
+    options: {
+      cwd,
+      env: process.env,
+      shell: platform === "win32" && npm.command.endsWith(".cmd"),
+      stdio: "inherit",
+      windowsHide: true,
+    },
+  };
+}
+
+function packageSpec(pkg) {
+  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC) {
+    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC;
+  }
+  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL) {
+    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL;
+  }
+
+  const ownPackage = require("../package.json");
+  const version = ownPackage.optionalDependencies?.[pkg] || ownPackage.version;
+  return `${pkg}@${version}`;
+}
+
+function runNpmInstall(label, args, cwd) {
+  const { npm, options } = npmSpawnOptions(cwd);
+  console.error(label);
+  const result = spawnSync(npm.command, [...npm.args, ...args], options);
+
+  if (result.error || result.status !== 0) {
+    const message = result.error ? result.error.message : `npm exited with status ${result.status}`;
+    console.error(`${label} failed: ${message}`);
+    return false;
+  }
+
+  return true;
+}
+
+function installPlatformPackageLocal(spec) {
+  return runNpmInstall(
+    `Installing Fabr Client native payload: ${spec}`,
+    [
+      "install",
+      spec,
+      "--no-save",
+      "--package-lock=false",
+      "--include=optional",
+    ],
+    path.join(__dirname, ".."),
+  );
+}
+
+function installPlatformPackageGlobal(spec) {
+  return runNpmInstall(
+    `Installing Fabr Client native payload globally: ${spec}`,
+    [
+      "install",
+      "-g",
+      spec,
+      "--include=optional",
+    ],
+    path.join(__dirname, ".."),
+  );
+}
+
+function installPlatformPackageGlobalFromFallbackRegistry(spec) {
+  if (process.env.FABR_CLIENT_SKIP_REGISTRY_FALLBACK === "1") {
+    return false;
+  }
+  const registry =
+    process.env.FABR_CLIENT_NPM_FALLBACK_REGISTRY || "https://registry.npmjs.org";
+  return runNpmInstall(
+    `Installing Fabr Client native payload globally from fallback registry: ${spec}`,
+    [
+      "install",
+      "-g",
+      spec,
+      "--include=optional",
+      `--registry=${registry}`,
+    ],
+    path.join(__dirname, ".."),
+  );
+}
+
+function resolveInstalledBinary(pkg) {
+  const binary = resolvePlatformPackageBinary(pkg);
+  return binary && fs.existsSync(binary) ? binary : null;
+}
+
+function installAndResolvePlatformPackage(pkg) {
+  if (!pkg || process.env.FABR_CLIENT_SKIP_PLATFORM_INSTALL === "1") {
+    return null;
+  }
+
+  const spec = packageSpec(pkg);
+  if (installPlatformPackageLocal(spec)) {
+    const binary = resolveInstalledBinary(pkg);
+    if (binary) {
+      return binary;
+    }
+  }
+
+  if (installPlatformPackageGlobal(spec)) {
+    const binary = resolveInstalledBinary(pkg);
+    if (binary) {
+      return binary;
+    }
+  }
+
+  if (installPlatformPackageGlobalFromFallbackRegistry(spec)) {
+    const binary = resolveInstalledBinary(pkg);
+    if (binary) {
+      return binary;
+    }
+  }
+
+  return null;
+}
+
+const pkg = packageByPlatform[platformDir];
+const candidates = [
+  process.env.FABR_CLIENT_BIN,
+  resolvePlatformPackageBinary(pkg),
+  // Local development fallback: package payloads staged next to this repo.
+  path.join(__dirname, "..", "..", "npm-platforms", platformDir, "bin", exe),
+  path.join(__dirname, platformDir, exe),
   path.join(__dirname, "..", platformDir, exe),
   path.join(__dirname, exe),
 ].filter(Boolean);
-
-let binary = candidates.find((candidate) => fs.existsSync(candidate));
-
-if (!binary) {
-  binary = installAndResolvePlatformPackage(pkg);
-}
-
-if (!binary) {
-  const spec = pkg ? packageSpec(pkg) : null;
-  const installHint = pkg
-    ? `Try: npm install -g ${spec}`
-    : "This platform is not currently supported by @fabr-client/core.";
-  console.error(
-    `Fabr Client does not include a binary for ${platformDir}.\n` +
-      "Please reinstall @fabr-client/core with optional dependencies enabled, or install the matching platform package.\n" +
-      installHint
-  );
-  process.exit(1);
-}
+
+let binary = candidates.find((candidate) => fs.existsSync(candidate));
+
+if (!binary) {
+  binary = installAndResolvePlatformPackage(pkg);
+}
+
+if (!binary) {
+  const spec = pkg ? packageSpec(pkg) : null;
+  const installHint = pkg
+    ? `Try: npm install -g ${spec}`
+    : "This platform is not currently supported by @fabr-client/core.";
+  console.error(
+    `Fabr Client does not include a binary for ${platformDir}.\n` +
+      "Please reinstall @fabr-client/core with optional dependencies enabled, or install the matching platform package.\n" +
+      installHint
+  );
+  process.exit(1);
+}
 
 const result = spawnSync(binary, process.argv.slice(2), {
   stdio: "inherit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabr-client/core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Cross-platform launcher for Fabr Client",
   "license": "MIT",
   "homepage": "https://pivot.enclaws.com",
@@ -18,11 +18,12 @@
     "postinstall": "node postinstall.js",
     "smoke": "node bin/fabr-client.js --help"
   },
-  "optionalDependencies": {
-    "@fabr-client/core-win32-x64": "1.0.0",
-    "@fabr-client/core-darwin-x64": "1.0.0",
-    "@fabr-client/core-darwin-arm64": "1.0.0"
-  },
+  "optionalDependencies": {
+    "@fabr-client/core-win32-x64": "1.0.2",
+    "@fabr-client/core-darwin-x64": "1.0.2",
+    "@fabr-client/core-darwin-arm64": "1.0.2",
+    "@fabr-client/core-linux-arm64": "1.0.2"
+  },
   "files": [
     "bin/",
     "postinstall.js",
@@ -36,7 +37,8 @@
   },
   "os": [
     "darwin",
-    "win32"
+    "win32",
+    "linux"
   ],
   "cpu": [
     "arm64",

package/postinstall.js

@@ -1,94 +1,95 @@
-"use strict";
-
-const { spawnSync } = require("node:child_process");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const platform = process.platform;
-const arch = process.arch;
-const exe = platform === "win32" ? "fabr-client.exe" : "fabr-client";
-const platformDir = `${platform}-${arch}`;
-const packageByPlatform = {
-  "win32-x64": "@fabr-client/core-win32-x64",
-  "darwin-x64": "@fabr-client/core-darwin-x64",
-  "darwin-arm64": "@fabr-client/core-darwin-arm64",
-};
-
-function resolvePlatformPackageBinary(pkg) {
-  try {
-    return path.join(path.dirname(require.resolve(`${pkg}/package.json`)), "bin", exe);
-  } catch {
-    return null;
-  }
-}
-
-function npmCommand() {
-  const npmExecPath = process.env.npm_execpath;
-  if (npmExecPath) {
-    return { command: process.execPath, args: [npmExecPath] };
-  }
-  return {
-    command: platform === "win32" ? "npm.cmd" : "npm",
-    args: [],
-  };
-}
-
-function packageSpec(pkg) {
-  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC) {
-    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC;
-  }
-  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL) {
-    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL;
-  }
-
-  const ownPackage = require("./package.json");
-  const version = ownPackage.optionalDependencies?.[pkg] || ownPackage.version;
-  return `${pkg}@${version}`;
-}
-
-const pkg = packageByPlatform[platformDir];
-if (!pkg || process.env.FABR_CLIENT_SKIP_PLATFORM_INSTALL === "1") {
-  process.exit(0);
-}
-
-const existingBinary = resolvePlatformPackageBinary(pkg);
-if (existingBinary && fs.existsSync(existingBinary)) {
-  process.exit(0);
-}
-
-const spec = packageSpec(pkg);
-const npm = npmCommand();
-const args = [
-  ...npm.args,
-  "install",
-  spec,
-  "--no-save",
-  "--package-lock=false",
-  "--include=optional",
-];
-
-console.log(`Installing Fabr Client native payload: ${spec}`);
-const result = spawnSync(npm.command, args, {
-  cwd: __dirname,
-  env: process.env,
-  shell: platform === "win32" && npm.command.endsWith(".cmd"),
-  stdio: "inherit",
-  windowsHide: true,
-});
-
-if (result.error || result.status !== 0) {
-  const message = result.error ? result.error.message : `npm exited with status ${result.status}`;
-  console.warn(
-    `Unable to install ${pkg} automatically: ${message}\n` +
-      `Run "npm install -g ${pkg}" if "fabr-client" cannot find its native binary.`
-  );
-  process.exit(0);
-}
-
-const installedBinary = resolvePlatformPackageBinary(pkg);
-if (!installedBinary || !fs.existsSync(installedBinary)) {
-  console.warn(
-    `Installed ${pkg}, but ${exe} was not found.\n` +
-      `Run "npm install -g ${pkg}" if "fabr-client" cannot find its native binary.`
-  );
-}
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const platform = process.platform;
+const arch = process.arch;
+const exe = platform === "win32" ? "fabr-client.exe" : "fabr-client";
+const platformDir = `${platform}-${arch}`;
+const packageByPlatform = {
+  "win32-x64": "@fabr-client/core-win32-x64",
+  "darwin-x64": "@fabr-client/core-darwin-x64",
+  "darwin-arm64": "@fabr-client/core-darwin-arm64",
+  "linux-arm64": "@fabr-client/core-linux-arm64",
+};
+
+function resolvePlatformPackageBinary(pkg) {
+  try {
+    return path.join(path.dirname(require.resolve(`${pkg}/package.json`)), "bin", exe);
+  } catch {
+    return null;
+  }
+}
+
+function npmCommand() {
+  const npmExecPath = process.env.npm_execpath;
+  if (npmExecPath) {
+    return { command: process.execPath, args: [npmExecPath] };
+  }
+  return {
+    command: platform === "win32" ? "npm.cmd" : "npm",
+    args: [],
+  };
+}
+
+function packageSpec(pkg) {
+  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC) {
+    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_SPEC;
+  }
+  if (process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL) {
+    return process.env.FABR_CLIENT_PLATFORM_PACKAGE_TARBALL;
+  }
+
+  const ownPackage = require("./package.json");
+  const version = ownPackage.optionalDependencies?.[pkg] || ownPackage.version;
+  return `${pkg}@${version}`;
+}
+
+const pkg = packageByPlatform[platformDir];
+if (!pkg || process.env.FABR_CLIENT_SKIP_PLATFORM_INSTALL === "1") {
+  process.exit(0);
+}
+
+const existingBinary = resolvePlatformPackageBinary(pkg);
+if (existingBinary && fs.existsSync(existingBinary)) {
+  process.exit(0);
+}
+
+const spec = packageSpec(pkg);
+const npm = npmCommand();
+const args = [
+  ...npm.args,
+  "install",
+  spec,
+  "--no-save",
+  "--package-lock=false",
+  "--include=optional",
+];
+
+console.log(`Installing Fabr Client native payload: ${spec}`);
+const result = spawnSync(npm.command, args, {
+  cwd: __dirname,
+  env: process.env,
+  shell: platform === "win32" && npm.command.endsWith(".cmd"),
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+if (result.error || result.status !== 0) {
+  const message = result.error ? result.error.message : `npm exited with status ${result.status}`;
+  console.warn(
+    `Unable to install ${pkg} automatically: ${message}\n` +
+      `Run "npm install -g ${pkg}" if "fabr-client" cannot find its native binary.`
+  );
+  process.exit(0);
+}
+
+const installedBinary = resolvePlatformPackageBinary(pkg);
+if (!installedBinary || !fs.existsSync(installedBinary)) {
+  console.warn(
+    `Installed ${pkg}, but ${exe} was not found.\n` +
+      `Run "npm install -g ${pkg}" if "fabr-client" cannot find its native binary.`
+  );
+}