@rom-weaver/cli 0.6.7 → 0.7.2

package/README.md

@@ -1,11 +1,18 @@
 <h1 align="center"><img src="packages/rom-weaver-webapp/src/assets/app/root/logo.svg" alt="rom-weaver logo" width="64" height="64" align="middle"> rom-weaver</h1>
 
 <p align="center">
-  A local-first offline toolkit for ROMs and ROM hack patches. Inspect, extract, checksum, compress, trim, apply patches, create patches, or bundle shareable patch manifests at native speed. In your browser or terminal.
+  Local-first toolkit for ROMs and disc images: inspect, extract, compress, and apply, create, or bundle patches. Offline via a browser service-worker PWA or CLI.
 </p>
 
 <p align="center">
-  <a href="https://github.com/brandonocasey/rom-weaver/tags"><img alt="Latest tag" src="https://img.shields.io/github/v/tag/brandonocasey/rom-weaver?sort=semver&amp;label=version&amp;color=d9690f"></a>
+  <a href="https://www.npmjs.com/package/rom-weaver"><img alt="npm version" src="https://img.shields.io/npm/v/rom-weaver?logo=npm&amp;logoColor=white&amp;label=npm&amp;color=d9690f"></a>
+  <a href="https://crates.io/crates/rom-weaver-cli"><img alt="crates.io version" src="https://img.shields.io/crates/v/rom-weaver-cli?logo=rust&amp;logoColor=white&amp;label=crates.io&amp;color=d9690f"></a>
+  <a href="https://github.com/brandonocasey/rom-weaver/pkgs/container/rom-weaver-cli"><img alt="Container images on GitHub Container Registry" src="https://img.shields.io/badge/ghcr.io-rom--weaver-d9690f?logo=docker&amp;logoColor=white"></a>
+  <a href="https://github.com/brandonocasey/homebrew-tap"><img alt="Homebrew tap" src="https://img.shields.io/badge/homebrew-brandonocasey%2Ftap-d9690f?logo=homebrew&amp;logoColor=white"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/brandonocasey/rom-weaver/actions/workflows/ci.yml"><img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/brandonocasey/rom-weaver/ci.yml?branch=main&amp;logo=githubactions&amp;logoColor=white&amp;label=CI&amp;color=4a6d63"></a>
   <a href="package.json"><img alt="Node.js 22 or newer" src="https://img.shields.io/badge/Node.js-22%2B-4a6d63?logo=nodedotjs&logoColor=white"></a>
   <a href=".mise.toml"><img alt="Rust 1.95" src="https://img.shields.io/badge/Rust-1.95-2c323b?logo=rust&logoColor=white"></a>
   <a href="LICENSE.md"><img alt="AGPL-3.0-or-later license" src="https://img.shields.io/badge/license-AGPL--3.0--or--later-4a6d63"></a>
@@ -77,12 +84,14 @@ libraries elsewhere is not supported.
 
 ### First public release
 
-v0.6.7 is the first public release available to install. The changelog and the
-git history go back further, but v0.6.0 through v0.6.6 failed partway through
-the release pipeline or were only partially published. v0.6.7 is the first
-release with a complete set of artifacts across npm, Homebrew, and the
-container registry. Earlier version numbers describe development history or
-incomplete releases only.
+v0.7.2 is the first public version to install. The changelog and the git
+history go back further, but v0.6.0 through v0.7.1 failed partway through the
+release pipeline or were only partially published. v0.7.1 completed most of
+the pipeline, but it still missed the crates.io CLI package, shipped a broken
+unscoped npm launcher, and built the static webapp archive with mismatched
+release metadata. v0.7.2 is the first release intended to have all public
+install methods working together. Earlier version numbers describe development
+history or incomplete releases only.
 
 ### LLM-assisted development
 
@@ -105,27 +114,135 @@ leave the device. Install it as a PWA from the browser menu to use it offline.
 New here? [Try the sample weave](https://rom-weaver.com/?bundle=first-weave.zip#/weave)
 with tiny synthetic files.
 
-To run the webapp on your own infrastructure, see
-[Self-host the webapp](#self-host-the-webapp) below.
+<a name="self-host-the-webapp"></a>
+
+<details>
+<summary>Self-host the webapp</summary>
+
+The Docker source build serves the full webapp — WASM build, cross-origin
+isolation headers, SPA fallback, and precompressed assets included. The
+[self-hosting guide](docs/self-hosting.md) covers reverse proxies, subpath
+routing, HTTPS certificates, service-worker scope, and the required COOP/COEP
+headers.
+
+Build and start it with Docker Compose:
+
+```bash
+git clone https://github.com/brandonocasey/rom-weaver.git
+cd rom-weaver
+docker compose up --build --detach
+curl --fail --silent --show-error http://localhost:8080/health
+```
+
+Only Docker with Compose is required; the image installs its own build
+toolchains. Set `PORT` to change the host port, for example
+`PORT=3000 docker compose up --build --detach`.
+For standalone TLS, mount a trusted certificate as described in the guide and
+set `HTTPS_PORT` instead.
+
+</details>
 
 ### CLI
 
-Prebuilt installers will become available with the first GitHub Release.
+Every method below installs the same prebuilt binary from the GitHub release.
+The release covers macOS arm64 and x86-64; Linux x86-64 GNU plus x86-64,
+arm64, and i686 musl; and Windows arm64, x86-64, and x86.
 
-Install with Homebrew on macOS or x86-64 Linux:
+<details>
+<summary>Homebrew (macOS arm64/Intel, Linux arm64/x86-64)</summary>
 
 ```bash
 brew install brandonocasey/tap/rom-weaver
 ```
 
-Or download the latest release to `~/.local/bin`:
+</details>
+
+<details>
+<summary>Scoop (Windows)</summary>
+
+```powershell
+scoop bucket add brandonocasey https://github.com/brandonocasey/scoop-bucket
+scoop install rom-weaver
+```
+
+</details>
+
+<details>
+<summary>Install script (macOS, Linux)</summary>
+
+Downloads the latest release to `~/.local/bin` and verifies its checksum.
+Override with `ROM_WEAVER_INSTALL_DIR` or pin with `ROM_WEAVER_VERSION`.
 
 ```bash
 curl --proto '=https' --tlsv1.2 -LsSf \
   https://raw.githubusercontent.com/brandonocasey/rom-weaver/main/install.sh | sh
 ```
 
-Or run it from the published Linux image, without installing anything:
+</details>
+
+<details>
+<summary>Install script (Windows)</summary>
+
+The same thing for PowerShell, installing to `%LOCALAPPDATA%\rom-weaver\bin`.
+
+```powershell
+irm https://raw.githubusercontent.com/brandonocasey/rom-weaver/main/install.ps1 | iex
+```
+
+</details>
+
+<details>
+<summary>npm</summary>
+
+Cross-platform, and the only channel that covers every supported target at
+once. Needs Node.js 22+. The package is a launcher that pulls the right
+prebuilt binary through platform-specific optional dependencies, so only your
+platform's binary is downloaded.
+
+```bash
+npm install --global rom-weaver
+```
+
+For a one-off run, or to add the scoped launcher for a repository's scripts,
+use the scoped package directly:
+
+```bash
+npx @rom-weaver/cli probe --input game.iso
+npm install --save-dev @rom-weaver/cli
+```
+
+</details>
+
+<details>
+<summary>cargo-binstall</summary>
+
+Downloads the same release binary rather than compiling the workspace, so it is
+minutes faster than `cargo install`:
+
+```bash
+cargo binstall rom-weaver-cli
+```
+
+</details>
+
+<details>
+<summary>mise</summary>
+
+Useful when you want the CLI managed per project in `mise.toml`. mise verifies
+the release's GitHub artifact attestations on install. The
+`minimum_release_age=0s` option lets new releases resolve immediately on release
+day; omit it if you prefer mise's default release-age delay.
+
+```bash
+mise use 'github:brandonocasey/rom-weaver[minimum_release_age=0s]'
+```
+
+</details>
+
+<details>
+<summary>Docker</summary>
+
+Runs from the published Linux image without installing anything:
 
 ```bash
 docker run --rm \
@@ -140,7 +257,12 @@ bind-mounted files keep their host ownership, so without it the container cannot
 read files it does not own and leaves anything it writes owned by an unknown uid.
 See [Run in Docker](docs/cli.md#run-in-docker).
 
-To install the current source build instead:
+</details>
+
+<a name="build-from-source"></a>
+
+<details>
+<summary>Build from source</summary>
 
 ```bash
 git clone https://github.com/brandonocasey/rom-weaver.git
@@ -152,32 +274,14 @@ rom-weaver --help
 The source build requires Rust 1.95+, CMake, Clang, and a native compiler
 toolchain.
 
+</details>
+
 Hitting `Permission denied`? See
 [File permissions](docs/cli.md#file-permissions).
 
 The [development guide](docs/development.md) covers the full toolchain setup,
 webapp builds, and tests.
 
-### Self-host the webapp
-
-The Docker source build serves the full webapp — WASM build, cross-origin
-isolation headers, SPA fallback, and precompressed assets included. The
-[self-hosting guide](docs/self-hosting.md) covers reverse proxies, subpath
-routing, service-worker scope, and the required COOP/COEP headers.
-
-Build and start it with Docker Compose:
-
-```bash
-git clone https://github.com/brandonocasey/rom-weaver.git
-cd rom-weaver
-docker compose up --build --detach
-curl --fail --silent --show-error http://localhost:8080/health
-```
-
-Only Docker with Compose is required; the image installs its own build
-toolchains. Set `PORT` to change the host port, for example
-`PORT=3000 docker compose up --build --detach`.
-
 ## Screenshots
 
 [View every screenshot at full size.](docs/screenshots.md)

package/bin/rom-weaver.mjs

@@ -17,8 +17,10 @@ const linuxLibc = () => {
 const platformPackage = (() => {
   if (process.platform === "darwin") return `@rom-weaver/darwin-${process.arch}`;
   if (process.platform === "win32") return `@rom-weaver/win32-${process.arch}-msvc`;
-  if (process.platform === "linux" && process.arch === "x64" && linuxLibc() === "gnu")
-    return "@rom-weaver/linux-x64-gnu";
+  if (process.platform === "linux" && ["arm64", "ia32", "x64"].includes(process.arch)) {
+    const libc = process.arch === "x64" ? linuxLibc() : "musl";
+    return `@rom-weaver/linux-${process.arch}-${libc}`;
+  }
   return null;
 })();
 

package/package.json

@@ -1,9 +1,21 @@
 {
   "name": "@rom-weaver/cli",
-  "version": "0.6.7",
+  "version": "0.7.2",
   "author": "Brandon Casey",
   "license": "AGPL-3.0-or-later",
-  "description": "A local-first offline toolkit for ROMs and ROM hack patches. Inspect, extract, checksum, compress, trim, apply patches, create patches, or bundle shareable patch manifests at native speed. In your browser or terminal.",
+  "description": "Local-first toolkit for ROMs and disc images: inspect, extract, compress, and apply, create, or bundle patches. Offline via a browser service-worker PWA or CLI.",
+  "keywords": [
+    "rom",
+    "rom-hack",
+    "patch",
+    "ips",
+    "bps",
+    "chd",
+    "rvz",
+    "z3ds",
+    "disc-image",
+    "cli"
+  ],
   "homepage": "https://rom-weaver.com",
   "funding": "https://ko-fi.com/brandonocasey",
   "repository": {
@@ -48,10 +60,15 @@
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@rom-weaver/darwin-arm64": "0.6.7",
-    "@rom-weaver/darwin-x64": "0.6.7",
-    "@rom-weaver/linux-x64-gnu": "0.6.7",
-    "@rom-weaver/win32-x64-msvc": "0.6.7"
+    "@rom-weaver/darwin-arm64": "0.7.2",
+    "@rom-weaver/darwin-x64": "0.7.2",
+    "@rom-weaver/linux-arm64-musl": "0.7.2",
+    "@rom-weaver/linux-ia32-musl": "0.7.2",
+    "@rom-weaver/linux-x64-gnu": "0.7.2",
+    "@rom-weaver/linux-x64-musl": "0.7.2",
+    "@rom-weaver/win32-arm64-msvc": "0.7.2",
+    "@rom-weaver/win32-ia32-msvc": "0.7.2",
+    "@rom-weaver/win32-x64-msvc": "0.7.2"
   },
   "scripts": {
     "docs:toc": "bash scripts/update-markdown-toc.sh",