@wordbricks/velen 0.2.43 → 0.2.44-darwin-arm64

package/README.md

@@ -74,8 +74,19 @@ Install:
 - `npx @wordbricks/velen --help`
 - `velen update` updates the globally installed Velen binary and Velen CLI agent skill.
 - `velen skill add` installs or updates the Velen CLI agent skill globally.
-- Linux npm installs ship musl-linked binaries so the CLI runs on both glibc and musl-based distributions, including Alpine.
-- Windows npm installs ship both x64 and arm64 platform binaries.
+
+Official npm release targets:
+
+| Platform | Node architecture | Rust target | npm optional dependency alias |
+| --- | --- | --- | --- |
+| macOS | `arm64` | `aarch64-apple-darwin` | `velen-darwin-arm64` |
+| Linux | `x64` | `x86_64-unknown-linux-musl` | `velen-linux-x64` |
+| Linux | `arm64` | `aarch64-unknown-linux-musl` | `velen-linux-arm64` |
+
+- Linux npm installs use musl-linked targets so the same platform
+  packages run on glibc distributions and musl distributions such as Alpine.
+- Other platform and architecture pairs are not included in the official npm
+  release and the launcher reports them as unsupported.
 
 Release:
 
@@ -85,5 +96,9 @@ Release:
 - After the release is tagged, close or delete that temporary release branch/PR so `origin/main` stays at `0.0.0`.
 - Configure npm trusted publishing for `@wordbricks/velen` with GitHub Actions using the workflow filename `cli-release.yml`.
 - Push a tag like `cli-v0.1.0` or `cli-v0.1.0-alpha.1`.
-- The `cli-release` workflow validates `cli-v<version>` against `apps/cli/Cargo.toml`, builds GNU and musl Linux binaries plus the other platform binaries, stages npm tarballs, creates a GitHub release, and publishes them to npm with `npm publish --provenance`.
-- Linux npm platform tarballs are staged from musl artifacts for the broadest runtime compatibility.
+- The `cli-release` workflow validates `cli-v<version>` against
+  `apps/cli/Cargo.toml`, builds macOS arm64 plus Linux x64/arm64 musl binaries,
+  stages the root and platform-specific npm tarballs, creates a GitHub release,
+  and publishes the platform packages before the root package.
+- Linux npm platform tarballs are staged from the musl artifacts for the
+  broadest runtime compatibility.

package/package.json

@@ -1,28 +1,27 @@
 {
-  "name": "@wordbricks/velen",
-  "version": "0.2.43",
+  "cpu": [
+    "arm64"
+  ],
   "description": "Velen CLI",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wordbricks/velen.git",
-    "directory": "apps/cli"
-  },
-  "bin": {
-    "velen": "bin/velen.js"
-  },
   "files": [
-    "bin",
+    "vendor",
     "README.md"
   ],
-  "type": "module",
+  "license": "Apache-2.0",
+  "name": "@wordbricks/velen",
+  "os": [
+    "darwin"
+  ],
   "publishConfig": {
     "access": "public"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wordbricks/velen.git",
+    "directory": "apps/cli"
+  },
+  "version": "0.2.44-darwin-arm64",
   "engines": {
     "node": ">=18"
-  },
-  "optionalDependencies": {
-    "velen-darwin-arm64": "npm:@wordbricks/velen@0.2.43-darwin-arm64"
   }
 }

package/bin/velen.js

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-
-import { spawn } from "node:child_process";
-import { chmodSync, existsSync, statSync } from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const require = createRequire(import.meta.url);
-
-const CLI_PACKAGE_NAME = "@wordbricks/velen";
-const PLATFORM_PACKAGE_BY_TARGET = {
-  "aarch64-apple-darwin": "velen-darwin-arm64",
-};
-
-const { platform, arch } = process;
-let targetTriple = null;
-if (platform === "darwin" && arch === "arm64") {
-  targetTriple = "aarch64-apple-darwin";
-}
-
-if (!targetTriple) {
-  throw new Error(`Unsupported platform: ${platform} (${arch})`);
-}
-
-const platformPackage = PLATFORM_PACKAGE_BY_TARGET[targetTriple];
-if (!platformPackage) {
-  throw new Error(`Unsupported target triple: ${targetTriple}`);
-}
-
-// COMMENT: This target map is intentionally duplicated here so the published
-// Node launcher stays self-contained, while the typed helper lives in src/.
-
-// CONTEXT: platform packages are installed through npm alias names so the
-// launcher resolves the alias folder, not the underlying published package id.
-const binaryName = "velen";
-const localVendorRoot = path.join(__dirname, "..", "vendor");
-const localBinaryPath = path.join(
-  localVendorRoot,
-  targetTriple,
-  "velen",
-  binaryName
-);
-
-let vendorRoot;
-try {
-  const packageJsonPath = require.resolve(`${platformPackage}/package.json`);
-  vendorRoot = path.join(path.dirname(packageJsonPath), "vendor");
-} catch {
-  if (existsSync(localBinaryPath)) {
-    vendorRoot = localVendorRoot;
-  } else {
-    const packageManager = detectPackageManager();
-    const reinstallCommand =
-      packageManager === "bun"
-        ? `bun install -g ${CLI_PACKAGE_NAME}@latest`
-        : `npm install -g ${CLI_PACKAGE_NAME}@latest`;
-    throw new Error(
-      `Missing optional dependency ${platformPackage}. Reinstall Velen CLI: ${reinstallCommand}`
-    );
-  }
-}
-
-const binaryPath = path.join(vendorRoot, targetTriple, "velen", binaryName);
-
-ensureExecutable(binaryPath);
-
-const child = spawn(binaryPath, process.argv.slice(2), {
-  env: process.env,
-  stdio: "inherit",
-});
-
-child.on("error", (error) => {
-  console.error(error);
-  process.exit(1);
-});
-
-const forwardSignal = (signal) => {
-  if (child.killed) {
-    return;
-  }
-
-  try {
-    child.kill(signal);
-  } catch {
-    // Ignore forwarding failures if the child already exited.
-  }
-};
-
-["SIGINT", "SIGTERM", "SIGHUP"].forEach((signal) => {
-  process.on(signal, () => forwardSignal(signal));
-});
-
-const childResult = await new Promise((resolve) => {
-  child.on("exit", (code, signal) => {
-    if (signal) {
-      resolve({ signal, type: "signal" });
-      return;
-    }
-
-    resolve({ exitCode: code ?? 1, type: "code" });
-  });
-});
-
-if (childResult.type === "signal") {
-  process.kill(process.pid, childResult.signal);
-} else {
-  process.exit(childResult.exitCode);
-}
-
-function detectPackageManager() {
-  const userAgent = process.env.npm_config_user_agent ?? "";
-  if (/\bbun\//.test(userAgent)) {
-    return "bun";
-  }
-
-  const execPath = process.env.npm_execpath ?? "";
-  if (execPath.includes("bun")) {
-    return "bun";
-  }
-
-  if (
-    __dirname.includes(".bun/install/global") ||
-    __dirname.includes(".bun\\install\\global")
-  ) {
-    return "bun";
-  }
-
-  return userAgent ? "npm" : null;
-}
-
-function ensureExecutable(filePath) {
-  const currentMode = statSync(filePath).mode & 0o777;
-  if ((currentMode & 0o111) !== 0) {
-    return;
-  }
-
-  // CONTEXT: npm tarballs store vendored native binaries without execute bits,
-  // so restore the expected mode before spawning the packaged CLI binary.
-  chmodSync(filePath, currentMode | 0o755);
-}