@command-center/command-center 0.2.3 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # Command Center CLI
 
-Binary distribution of UpToSpeed Command Center, a desktop-friendly interface for reviewing repositories and generating walkthroughs. This package installs a thin Node.js wrapper that launches the precompiled Command Center binary for your platform.
+Binary distribution of UpToSpeed Command Center, a desktop-friendly interface for reviewing repositories and generating walkthroughs. This package installs a thin Node.js wrapper that launches the precompiled Command Center binary for your platform via platform-specific optional dependencies.
 
 ## Supported Platforms
 
@@ -18,7 +18,15 @@ If your platform is missing, please open an issue so we can add another target.
 npm install -g @command-center/command-center
 ```
 
-This command places a `command-center` executable on your `$PATH`. The wrapper selects the appropriate binary from the package’s `dist/` directory and forwards all CLI arguments to it.
+This command places a `command-center` executable on your `$PATH`. During installation npm/yarn/pnpm automatically adds the matching optional dependency:
+
+- `@command-center/command-center-macos-arm64`
+- `@command-center/command-center-macos-x64`
+- `@command-center/command-center-linux-arm64`
+- `@command-center/command-center-linux-x64`
+- `@command-center/command-center-win-x64`
+
+Each optional package ships exactly one prebuilt binary. The wrapper resolves the right package at runtime and forwards all CLI arguments to its binary.
 
 ## Usage
 
@@ -41,8 +49,23 @@ npm update -g @command-center/command-center
 
 After updating, run `command-center --version` to verify the new binary.
 
+## Maintainer Utilities
+
+If you are working from the repository and want to validate the packaged
+artifacts before publishing, run:
+
+```bash
+npm run build-and-install
+```
+
+This command rebuilds the binaries, generates platform-specific packages under
+`artifacts/platform-packages/`, and installs both the matching platform binary
+package and the CLI in a temporary directory. Finish by running
+`command-center --version` (the script does this for you) or launching the app
+directly from the printed path.
+
 ## Troubleshooting
 
 - **“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 working from a git checkout, run `bun run build:binary` before linking with `npm link`.
-- **Permission errors** – On POSIX systems, ensure the binaries in `dist/` remain executable (`chmod +x dist/command-center-*`).
+- **“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-*`).

package/bin/command-center.js

@@ -4,35 +4,60 @@ import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 
 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}`;
 
-// TAG_PLATFORM_MATRIX 2025.10.02: Keep binary names in sync with scripts/build-all.ts outputs.
-const PLATFORM_BINARIES = new Map([
-  ["darwin:arm64", "command-center-macos-arm64"],
-  ["darwin:x64", "command-center-macos-x64"],
-  ["linux:arm64", "command-center-linux-arm64"],
-  ["linux:x64", "command-center-linux-x64"],
-  // ["win32:x64", "command-center-win-x64.exe"],
+// TAG_PLATFORM_MATRIX 2025.10.14: Keep entries in sync with scripts/build-all.ts outputs.
+const PLATFORM_PACKAGES = new Map([
+  [
+    "darwin:arm64",
+    {
+      packageName: "@command-center/command-center-macos-arm64",
+      binaryName: "command-center-macos-arm64",
+    },
+  ],
+  [
+    "darwin:x64",
+    {
+      packageName: "@command-center/command-center-macos-x64",
+      binaryName: "command-center-macos-x64",
+    },
+  ],
+  [
+    "linux:arm64",
+    {
+      packageName: "@command-center/command-center-linux-arm64",
+      binaryName: "command-center-linux-arm64",
+    },
+  ],
+  [
+    "linux:x64",
+    {
+      packageName: "@command-center/command-center-linux-x64",
+      binaryName: "command-center-linux-x64",
+    },
+  ],
+  [
+    "win32:x64",
+    {
+      packageName: "@command-center/command-center-win-x64",
+      binaryName: "command-center-win-x64.exe",
+    },
+  ],
 ]);
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
 function fail(message) {
   console.error(`command-center (wrapper): ${message}`);
   process.exit(1);
 }
 
 function resolveBinary() {
-  const binaryName = PLATFORM_BINARIES.get(PLATFORM_KEY);
-  if (!binaryName) {
+  const entry = PLATFORM_PACKAGES.get(PLATFORM_KEY);
+  if (!entry) {
     fail(
       `unsupported platform '${process.platform}' with architecture '${process.arch}'.` +
         "\n  • Please open an issue so we can add build support." +
@@ -40,12 +65,27 @@ function resolveBinary() {
     );
   }
 
-  const binaryPath = path.join(__dirname, "..", "dist", binaryName);
+  let packageRoot = "";
+  try {
+    const packageJsonPath = require.resolve(
+      `${entry.packageName}/package.json`,
+    );
+    packageRoot = path.dirname(packageJsonPath);
+  } catch (error) {
+    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)}`,
+    );
+  }
+
+  const binaryPath = path.join(packageRoot, "dist", entry.binaryName);
   if (!existsSync(binaryPath)) {
     fail(
-      `expected binary '${binaryName}' was not found at ${binaryPath}.` +
-        "\n  • Ensure the package was published with binaries (run 'bun run build:binary' before publishing)." +
-        "\n  • If you are developing locally, rebuild the binaries and try again.",
+      `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.",
     );
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@command-center/command-center",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "Binary distribution of UpToSpeed Command Center",
   "bin": {
@@ -8,17 +8,8 @@
   },
   "files": [
     "bin/",
-    "dist/",
     "README.md"
   ],
-  "scripts": {
-    "prepare:dist": "node ./scripts/prepare-dist.cjs",
-    "check:dist": "node ./scripts/assert-dist-binaries.cjs",
-    "prepublishOnly": "npm run prepare:dist && npm run check:dist",
-    "bump:minor": "npm version minor",
-    "bump:patch": "npm version patch",
-    "release": "npm publish"
-  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -30,5 +21,13 @@
   "license": "MIT",
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "optionalDependencies": {
+    "@command-center/command-center-linux-arm64": "0.3.0",
+    "@command-center/command-center-linux-x64": "0.3.0",
+    "@command-center/command-center-macos-arm64": "0.3.0",
+    "@command-center/command-center-macos-x64": "0.3.0",
+    "@command-center/command-center-win-x64": "0.3.0"
+  },
+  "scripts": {}
 }