@command-center/command-center 0.7.1-rc.3 → 0.7.2-rc.0

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,6 +1,6 @@
 #!/usr/bin/env node
 
-import { spawn } from "node:child_process";
+import { execSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
@@ -11,6 +11,11 @@ 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,6 +51,15 @@ const PLATFORM_PACKAGES = new Map([
     {
       packageName: "@command-center/command-center-win-x64",
       binaryName: "command-center-win-x64.exe",
+      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",
     },
   ],
 ]);
@@ -55,6 +69,23 @@ function fail(message) {
   process.exit(1);
 }
 
+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,31 +96,51 @@ 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 };
+}
+
+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 });
+    });
+  });
+}
+
+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;
 }
 
 const argv = process.argv.slice(2);
@@ -103,23 +154,63 @@ if (argv.some((arg) => arg === "--version" || arg === "-v")) {
   process.exit(0);
 }
 
-const binaryPath = resolveBinary();
+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}).`);
+}
+
+// If the binary crashed with STATUS_ILLEGAL_INSTRUCTION and a fallback exists,
+// the CPU likely doesn't support AVX. Download and run the baseline binary.
+if (result.code === STATUS_ILLEGAL_INSTRUCTION && entry.fallbackPackageName) {
+  console.error(
+    "command-center (wrapper): binary crashed (CPU does not support AVX instructions).",
+  );
+
+  // Check if fallback is already installed
+  let fallbackPath = resolveBinaryInPackage(
+    entry.fallbackPackageName,
+    entry.fallbackBinaryName,
+  );
+
+  // If not installed, download it
+  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.");
+  }
 
-child.on("error", (error) => {
-  fail(`failed to launch bundled binary (${error.message}).`);
-});
+  console.error("command-center (wrapper): retrying with baseline binary...");
+  const fallbackResult = await spawnBinary(fallbackPath, argv);
 
-child.on("exit", (code, signal) => {
-  if (signal) {
+  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);
+}
+
+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.1-rc.3",
+  "version": "0.7.2-rc.0",
   "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.1-rc.3",
-    "@command-center/command-center-linux-x64": "0.7.1-rc.3",
-    "@command-center/command-center-macos-arm64": "0.7.1-rc.3",
-    "@command-center/command-center-macos-x64": "0.7.1-rc.3",
-    "@command-center/command-center-win-x64": "0.7.1-rc.3"
+    "@command-center/command-center-linux-arm64": "0.7.2-rc.0",
+    "@command-center/command-center-linux-x64": "0.7.2-rc.0",
+    "@command-center/command-center-macos-arm64": "0.7.2-rc.0",
+    "@command-center/command-center-macos-x64": "0.7.2-rc.0",
+    "@command-center/command-center-win-arm64": "0.7.2-rc.0",
+    "@command-center/command-center-win-x64": "0.7.2-rc.0"
   },
   "scripts": {}
 }