@command-center/command-center 0.7.2 → 0.7.3-rc1

package/README.md

@@ -9,6 +9,7 @@ Binary distribution of UpToSpeed Command Center, a desktop-friendly interface fo
 - Linux arm64
 - Linux x64
 - Windows x64
+- Windows arm64
 
 If your platform is missing, please open an issue so we can add another target.
 
@@ -25,6 +26,7 @@ This command places a `command-center` executable on your `$PATH`. During instal
 - `@command-center/command-center-linux-arm64`
 - `@command-center/command-center-linux-x64`
 - `@command-center/command-center-win-x64`
+- `@command-center/command-center-win-arm64`
 
 Each optional package ships exactly one prebuilt binary. The wrapper resolves the right package at runtime and forwards all CLI arguments to its binary.
 
@@ -69,3 +71,4 @@ directly from the printed path.
 - **“Unsupported platform”** – The wrapper could not map your `process.platform`/`process.arch` combination. Please file an issue with your OS and architecture.
 - **“Expected binary … was not found”** – Reinstall the package. If you are developing locally, run `npm run prepare:dist` from the repository root to refresh the optional binary packages.
 - **Permission errors** – On POSIX systems, ensure the binaries remain executable (`chmod +x node_modules/@command-center/command-center-*/dist/command-center-*`).
+- **AVX crash on Windows** – If the Windows x64 binary crashes immediately (e.g. in Parallels or on older CPUs without AVX), the wrapper automatically installs and runs `@command-center/command-center-win-x64-baseline`, a build without AVX instructions.

package/bin/command-center.js

@@ -1,16 +1,41 @@
 #!/usr/bin/env node
 
-import { spawn } from "node:child_process";
+// Thin Node.js wrapper around the precompiled Command Center binary.
+//
+// This script resolves the correct platform-specific binary from npm optional
+// dependencies and spawns it, forwarding all CLI arguments and stdio.
+//
+// COMMENT_AVX_Fallback (Windows x64 only), 2026.03.04
+// --------------------------------
+// Parallels Desktop x86_64 emulation on Apple Silicon does not support AVX.
+// When run: will exit with STATUS_ILLEGAL_INSTRUCTION.
+// Solution: Have another binary that is compiled without AVX instructions (baseline),
+// download it on demand.
+
+// #######################################
+// Imports
+// #######################################
+
+import { execSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
 
+// #######################################
+// Constants
+// #######################################
+
 const require = createRequire(import.meta.url);
 const packageMetadata = require("../package.json");
 
 const PACKAGE_VERSION = packageMetadata.version ?? "0.0.0";
 const PLATFORM_KEY = `${process.platform}:${process.arch}`;
 
+// STATUS_ILLEGAL_INSTRUCTION (0xC000001D) as an unsigned 32-bit integer.
+// Windows returns this when a process hits an unsupported CPU instruction
+// (e.g. AVX on a system without AVX support, such as Parallels x86_64 emulation).
+const STATUS_ILLEGAL_INSTRUCTION = 3_221_225_501;
+
 // TAG_PLATFORM_MATRIX 2025.10.14: Keep entries in sync with scripts/build-all.ts outputs.
 const PLATFORM_PACKAGES = new Map([
   [
@@ -46,15 +71,51 @@ const PLATFORM_PACKAGES = new Map([
     {
       packageName: "@command-center/command-center-win-x64",
       binaryName: "command-center-win-x64.exe",
+      // On-demand fallback: only downloaded if the primary binary crashes with
+      // STATUS_ILLEGAL_INSTRUCTION (no AVX support). See file header for details.
+      fallbackPackageName: "@command-center/command-center-win-x64-baseline",
+      fallbackBinaryName: "command-center-win-x64-baseline.exe",
+    },
+  ],
+  [
+    "win32:arm64",
+    {
+      packageName: "@command-center/command-center-win-arm64",
+      binaryName: "command-center-win-arm64.exe",
     },
   ],
 ]);
 
+// #######################################
+// Utility Functions
+// #######################################
+
 function fail(message) {
   console.error(`command-center (wrapper): ${message}`);
   process.exit(1);
 }
 
+// #######################################
+// Binary Resolution
+// #######################################
+
+function resolvePackageRoot(packageName) {
+  const packageJsonPath = require.resolve(`${packageName}/package.json`);
+  return path.dirname(packageJsonPath);
+}
+
+function resolveBinaryInPackage(packageName, binaryName) {
+  let packageRoot;
+  try {
+    packageRoot = resolvePackageRoot(packageName);
+  } catch {
+    return null;
+  }
+
+  const binaryPath = path.join(packageRoot, "dist", binaryName);
+  return existsSync(binaryPath) ? binaryPath : null;
+}
+
 function resolveBinary() {
   const entry = PLATFORM_PACKAGES.get(PLATFORM_KEY);
   if (!entry) {
@@ -65,61 +126,161 @@ function resolveBinary() {
     );
   }
 
-  let packageRoot = "";
-  try {
-    const packageJsonPath = require.resolve(
-      `${entry.packageName}/package.json`,
-    );
-    packageRoot = path.dirname(packageJsonPath);
-  } catch (error) {
+  const binaryPath = resolveBinaryInPackage(
+    entry.packageName,
+    entry.binaryName,
+  );
+  if (!binaryPath) {
     fail(
       `missing optional dependency '${entry.packageName}'.` +
         "\n  • npm should install it automatically on supported platforms." +
-        "\n  • Try reinstalling the CLI or running 'npm install @command-center/command-center' again." +
-        `\n  • Underlying error: ${error instanceof Error ? error.message : String(error)}`,
+        "\n  • Try reinstalling the CLI or running 'npm install @command-center/command-center' again.",
     );
   }
 
-  const binaryPath = path.join(packageRoot, "dist", entry.binaryName);
-  if (!existsSync(binaryPath)) {
-    fail(
-      `expected binary '${entry.binaryName}' was not found in ${entry.packageName}.` +
-        "\n  • Ensure the optional dependency was published with binaries (run 'bun run build:binary' before publishing)." +
-        "\n  • If you are developing locally, run 'npm run prepare:dist' to refresh optional packages.",
+  return { binaryPath, entry };
+}
+
+// #######################################
+// Process Spawning
+// #######################################
+
+function spawnBinary(binaryPath, argv) {
+  return new Promise((resolve) => {
+    const child = spawn(binaryPath, argv, { stdio: "inherit" });
+
+    child.on("error", (error) => {
+      resolve({ code: null, signal: null, error });
+    });
+
+    child.on("exit", (code, signal) => {
+      resolve({ code, signal, error: null });
+    });
+  });
+}
+
+// #######################################
+// AVX Fallback
+// #######################################
+
+// Downloads the baseline binary package on demand via `npm install -g`.
+// This only runs once per machine — after installation, subsequent launches
+// find the package locally and skip this step.
+function installFallbackPackage(packageName) {
+  console.error(
+    `command-center (wrapper): installing fallback package ${packageName}@${PACKAGE_VERSION}...`,
+  );
+  try {
+    execSync(`npm install -g ${packageName}@${PACKAGE_VERSION}`, {
+      stdio: "inherit",
+    });
+    return true;
+  } catch {
+    console.error(
+      `command-center (wrapper): failed to install ${packageName}. You can install it manually:` +
+        `\n  npm install -g ${packageName}@${PACKAGE_VERSION}`,
     );
+    return false;
   }
-
-  return binaryPath;
 }
 
+// #######################################
+// Main
+// #######################################
+
 const argv = process.argv.slice(2);
 
 const printVersionBanner = () => {
   console.log(`command-center ${PACKAGE_VERSION}`);
 };
 
+// ##############################
+// Handle --version flag
+// ##############################
+
 if (argv.some((arg) => arg === "--version" || arg === "-v")) {
   printVersionBanner();
   process.exit(0);
 }
 
-const binaryPath = resolveBinary();
+// ##############################
+// Resolve and spawn primary binary
+// ##############################
+
+const { binaryPath, entry } = resolveBinary();
 printVersionBanner();
 
-const child = spawn(binaryPath, argv, {
-  stdio: "inherit",
-});
+const result = await spawnBinary(binaryPath, argv);
+
+if (result.error) {
+  fail(`failed to launch bundled binary (${result.error.message}).`);
+}
+
+// ##############################
+// AVX fallback for Windows
+// ##############################
+
+// The AVX binary crashes immediately on CPUs/emulators without AVX support.
+// Node's `spawn` reports the Windows NTSTATUS code as an unsigned 32-bit exit
+// code (3221225501), not the signed representation (-1073741795).
+// When we see this specific exit code AND the platform entry has a fallback
+// configured, we install (if needed) and launch the baseline binary instead.
+if (result.code === STATUS_ILLEGAL_INSTRUCTION && entry.fallbackPackageName) {
+  console.error(
+    "command-center (wrapper): binary crashed (CPU does not support AVX instructions).",
+  );
+
+  // ####################
+  // Resolve or install fallback binary
+  // ####################
 
-child.on("error", (error) => {
-  fail(`failed to launch bundled binary (${error.message}).`);
-});
+  let fallbackPath = resolveBinaryInPackage(
+    entry.fallbackPackageName,
+    entry.fallbackBinaryName,
+  );
 
-child.on("exit", (code, signal) => {
-  if (signal) {
+  if (!fallbackPath) {
+    const installed = installFallbackPackage(entry.fallbackPackageName);
+    if (installed) {
+      fallbackPath = resolveBinaryInPackage(
+        entry.fallbackPackageName,
+        entry.fallbackBinaryName,
+      );
+    }
+  }
+
+  if (!fallbackPath) {
+    fail("failed to resolve fallback binary after installation.");
+  }
+
+  // ####################
+  // Spawn fallback binary
+  // ####################
+
+  console.error("command-center (wrapper): retrying with baseline binary...");
+  const fallbackResult = await spawnBinary(fallbackPath, argv);
+
+  if (fallbackResult.error) {
+    fail(`failed to launch fallback binary (${fallbackResult.error.message}).`);
+  }
+  if (fallbackResult.signal) {
     console.error(
-      `command-center (wrapper): process terminated with signal ${signal}.`,
+      `command-center (wrapper): process terminated with signal ${fallbackResult.signal}.`,
     );
     process.exit(1);
   }
-  process.exit(code === null ? 1 : code);
-});
+  process.exit(fallbackResult.code === null ? 1 : fallbackResult.code);
+}
+
+// ##############################
+// Exit with primary binary result
+// ##############################
+
+if (result.signal) {
+  console.error(
+    `command-center (wrapper): process terminated with signal ${result.signal}.`,
+  );
+  process.exit(1);
+}
+
+process.exit(result.code === null ? 1 : result.code);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@command-center/command-center",
-  "version": "0.7.2",
+  "version": "0.7.3-rc1",
   "type": "module",
   "description": "Binary distribution of UpToSpeed Command Center",
   "bin": {
@@ -23,11 +23,12 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@command-center/command-center-linux-arm64": "0.7.2",
-    "@command-center/command-center-linux-x64": "0.7.2",
-    "@command-center/command-center-macos-arm64": "0.7.2",
-    "@command-center/command-center-macos-x64": "0.7.2",
-    "@command-center/command-center-win-x64": "0.7.2"
+    "@command-center/command-center-linux-arm64": "0.7.3-rc1",
+    "@command-center/command-center-linux-x64": "0.7.3-rc1",
+    "@command-center/command-center-macos-arm64": "0.7.3-rc1",
+    "@command-center/command-center-macos-x64": "0.7.3-rc1",
+    "@command-center/command-center-win-arm64": "0.7.3-rc1",
+    "@command-center/command-center-win-x64": "0.7.3-rc1"
   },
   "scripts": {}
 }