@command-center/command-center 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# 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.
+
+## Supported Platforms
+
+- macOS arm64
+- macOS x64
+- Linux arm64
+- Linux x64
+- Windows x64
+
+If your platform is missing, please open an issue so we can add another target.
+
+## Installation
+
+```bash
+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.
+
+## Usage
+
+```bash
+command-center [flags]
+```
+
+Common flags:
+
+- `--debug` – print embedded asset information after startup
+- `--help` – show runtime help from the bundled binary
+
+The application starts an HTTP server (defaults to port `9000`). Open the printed URL in your browser to launch the UI. Environment variables are loaded from `.env` in the directory where you run the command; create that file to provide API keys or override the port.
+
+## Upgrade
+
+```bash
+npm update -g @command-center/command-center
+```
+
+After updating, run `command-center --version` to verify the new binary.
+
+## 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-*`).
+
+## Developing From Source
+
+The npm package does not include development tooling or source code. To contribute or build your own binaries, clone the repository and follow the instructions in `README.dev.md`.
+
+### Release Workflow
+
+Run these commands from `packages/command-center-cli/`:
+
+1. `npm install`
+2. `npm run prepare:dist`
+3. `npm run check:dist`
+4. `npm pack` (optional)
+5. Install the tarball to smoke-test (optional):
+   - `npm install -g ./@command-center-command-center-<version>.tgz`
+   - `command-center --version`
+   - `npm uninstall -g @command-center/command-center`
+6. `npm publish --access public`
+
+Use `npm run bump:minor` (or patch/major) beforehand to increment the version as needed.

package/bin/command-center.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+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"],
+]);
+
+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) {
+    fail(
+      `unsupported platform '${process.platform}' with architecture '${process.arch}'.` +
+        "\n  • Please open an issue so we can add build support." +
+        "\n  • As a workaround, you can run 'bun run build:binary' and execute the output manually.",
+    );
+  }
+
+  const binaryPath = path.join(__dirname, "..", "dist", 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.",
+    );
+  }
+
+  return binaryPath;
+}
+
+const binaryPath = resolveBinary();
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (error) => {
+  fail(`failed to launch bundled binary (${error.message}).`);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    console.error(`command-center (wrapper): process terminated with signal ${signal}.`);
+    process.exit(1);
+  }
+  process.exit(code === null ? 1 : code);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@command-center/command-center",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Binary distribution of UpToSpeed Command Center",
+  "bin": {
+    "command-center": "./bin/command-center.js"
+  },
+  "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",
+    "release": "npm run prepare:dist && npm run check:dist && npm publish"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "command-center",
+    "uptospeed",
+    "cli"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}