@wordbricks/velen 0.2.43-darwin-arm64 → 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

@@ -20,7 +20,7 @@
     "url": "git+https://github.com/wordbricks/velen.git",
     "directory": "apps/cli"
   },
-  "version": "0.2.43-darwin-arm64",
+  "version": "0.2.44-darwin-arm64",
   "engines": {
     "node": ">=18"
   }