@rom-weaver/cli 0.11.0 → 0.12.0

package/README.md

@@ -7,7 +7,7 @@
 <p align="center">
   <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/users/brandonocasey/packages/container/package/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/orgs/rom-weaver/packages/container/package/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/rom-weaver/homebrew-tap"><img alt="Homebrew tap" src="https://img.shields.io/badge/homebrew-rom--weaver%2Ftap-d9690f?logo=homebrew&amp;logoColor=white"></a>
 </p>
 
@@ -20,18 +20,20 @@
 
 <p align="center">
   <a href="https://rom-weaver.com/apply">Open the webapp</a>
-  · <a href="docs/README.md">Docs index</a>
   · <a href="https://github.com/sponsors/brandonocasey">Sponsor on GitHub</a>
   · <a href="https://ko-fi.com/brandonocasey">Support on Ko-fi</a>
 </p>
 
 <!-- START doctoc -->
 
+- [Install](#install)
+- [Webapp](#webapp)
+- [Self-hosting](#self-hosting)
+- [CLI](#cli)
 - [Why](#why)
 - [Performance](#performance)
 - [Features](#features)
 - [Notices](#notices)
-- [Install](#install)
 - [Screenshots](#screenshots)
 - [Documentation](#documentation)
 - [Contributing and support](#contributing-and-support)
@@ -39,145 +41,31 @@
 
 <!-- END doctoc -->
 
-## Why
-
-Every console generation brought its own compressed format, and each one came
-with its own tool. CHD for discs, RVZ for GameCube and Wii, Z3DS for 3DS, CSO
-and PBP for PSP, plus the usual ZIP and 7z on top. Those tools are scattered
-across projects, most are command-line only, and plenty of them only ship
-builds for one or two platforms. If you are on a Mac, or on Windows without a
-compiler handy, half of them are out of reach. Anyone who has tried to shrink a
-disc collection knows the routine: track down five programs, learn five sets of
-flags, and hope each one still builds.
-
-Patching has the same problem from a different angle. Most patchers take one
-patch at a time, so a translation plus a bugfix plus an undub means running the
-tool three times and keeping the intermediate files straight yourself. And
-because almost no patcher reads compressed input, the real sequence is
-decompress, patch, recompress - every time you want to try a different patch or
-redo one you already applied. That is a lot of disk churn and waiting for what
-should be a single step.
-
-The last piece is curation. Keeping a collection in order means storing ROMs
-compressed, keeping the patches next to them, and being able to prove months
-later that a patched file came from the ROM you think it did. rom-weaver
-handles all of it in one place: read and write every format above, chain as
-many patches as you want in a single pass without unpacking to disk first, and
-record the whole recipe - patch order, checksums, output names - in a bundle
-file you can hand to someone else. It runs the same on Linux, macOS, and
-Windows, and in the browser if you would rather not install anything.
-
-For the current measurements and trade-offs, see the [performance brief](#performance).
-
-## Performance
-
-rom-weaver uses the same Rust engine in the CLI and threaded WASM webapp. In a
-representative 128 MiB GameCube ISO test, native RVZ compression completed in
-about 93 ms with four threads. The browser build completed the same operation
-in about 221 ms with one thread; four-thread RVZ creation is currently limited
-by a browser/OPFS threaded-I/O issue, so these numbers are not apples-to-apples.
-
-Production WASM runs `wasm-opt -O4`. In matched artifact measurements, that
-reduced the raw Wasm from 7.12 MB to 6.44 MB and the Brotli transfer size from
-1.73 MB to 1.71 MB. The full browser codec matrix remains the source of truth
-for runtime comparisons, so these figures are indicative rather than a
-general speed claim.
-
-## Features
-
-- **Apply and create patches.** Twenty-one formats, including IPS, BPS, UPS,
-  xdelta/VCDIFF, PPF, RUP, BDF/BSDIFF40, APS, and DCP (Dreamcast), with ordered
-  multi-patch chains, strict checksum validation, and cheat-code baking. Three
-  of them (DCP, BSP, and HDiffPatch) can only be applied, not created.
-- **Inspect and extract containers.** ZIP, 7z, RAR, the tar family, CHD, RVZ,
-  Z3DS, CSO, PBP, GCZ, WIA, WBFS, and more, including nested archives.
-- **Create compressed containers.** ZIP, 7z, CHD, RVZ, and Z3DS with
-  codec-aware compression settings, validated against reference tools such as
-  chdman and dolphin-tool.
-- **Checksum and verify.** CRC32, MD5, SHA-1, SHA-256, BLAKE3, and friends,
-  with copier-header detection, header repair, and header-aware checksum
-  variants.
-- **Trim and restore.** Trimming for NDS, GBA, 3DS, XISO, and RVZ scrub. NDS,
-  GBA, and 3DS can be reverted, with an opt-in footer that restores the
-  original file byte-for-byte.
-- **Share workflows.** Distributable [`rom-weaver-bundle.json`](./docs/rom-weaver-bundle-v1.schema.json)
-  bundles pin patch order, checksums, and output naming so others can replay
-  the exact workflow.
-- **Local-first and private.** Everything runs on your machine. The webapp is
-  an installable PWA that works offline and never uploads your files.
-- **One engine, two frontends.** The same Rust core powers the terminal CLI
-  and the threaded WASM webapp, with line-delimited JSON output for scripting.
-
-The complete format, codec, and checksum compatibility tables are maintained
-in the [CLI guide](./docs/reference/formats.md).
-
-## Notices
-
-### Beta status
-
-rom-weaver is beta software and follows Semantic Versioning, but until v1.0,
-breaking changes may still happen between minor releases. Patching,
-compressing, extracting, and bundling have all been tested extensively. That
-hands-on testing happens on macOS and Linux; Windows runs the same automated
-test suite in CI but has seen much less real-world use, so expect rougher
-edges there and please report anything Windows-specific. If you
-rely on the APIs or CLI flags, expect things to be a bit tougher: those
-interfaces may still change as the project heads toward v1.0. Trim and Tools are
-currently untested but theoretically working, so they are disabled in the
-current webapp. The `rom-weaver-core`, `-checksum`, `-containers`, and
-`-patches` crates are published to crates.io only so `rom-weaver-cli` can use
-them. The CLI and the webapp are the supported interfaces; using those crates as
-libraries in another project is not supported.
-
-### First public release
-
-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
-
-rom-weaver is built by a full-time software engineer in my spare time. Claude
-and ChatGPT are used during development for brainstorming, implementation,
-debugging, and review. I make the engineering decisions and review and test
-the resulting work myself; the goal is high-quality, dependable software, but
-AI-assisted code may still need extra scrutiny.
-
-### Translations
-
-Localized translations are early and may be entirely wrong in places. Manual
-edits and corrections are welcome.
-
 ## Install
 
-### Webapp
+Choose the [webapp](#webapp), [self-hosting](#self-hosting), or [CLI](#cli)
+path below.
+
+## Webapp
 
 Open the hosted webapp at **[rom-weaver.com/apply](https://rom-weaver.com/apply)**. You
-do not need to install anything or create an account. Choose **Weave**, add a
+do not need to install anything or create an account. Choose **Apply**, add a
 ROM and one or more patches, review the detected formats and checksums, then run
 the workflow and save the result. Use **Create** to generate a distributable
 patch from an original and a modified file. Your files are processed locally
 and never 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/apply?bundle=first-weave.zip)
+New here? [Try the sample workflow](https://rom-weaver.com/apply?bundle=first-weave.zip)
 with a tiny original homebrew NES ROM and two patches that change “HELLO WORLD” to “MODIFIED ROM.”
 For a guided explanation, use
 [guided Apply](https://rom-weaver.com/apply?guide=apply),
 [guided Create](https://rom-weaver.com/create?guide=create), or
 [guided Bundle](https://rom-weaver.com/apply?guide=bundle).
 To run the webapp on your own host, see the
-[self-hosting guide](./docs/hosting/self-hosting.md) for the release tarball,
-Docker, and Docker Compose setups.
+[Self-hosting](#self-hosting) section below or the
+[full self-hosting guide](./docs/hosting/self-hosting.md).
 
-<a name="self-host-the-webapp"></a>
-
-<details>
-<summary>Self-host the webapp</summary>
+## Self-hosting
 
 For a quick setup, choose static files, Docker Run, or Docker Compose. The
 [full self-hosting guide](./docs/hosting/self-hosting.md) covers reverse proxies,
@@ -197,36 +85,42 @@ tar --extract --gzip --file rom-weaver-webapp.tar.gz --directory rom-weaver-weba
 Serve the extracted `rom-weaver-webapp` directory from an HTTPS static host.
 For a pinned release, replace `latest` in the URL with its tag.
 
-Docker Run:
+Docker Run using the published GitHub Container Registry (GHCR) image:
 
 ```bash
 docker run --detach --name rom-weaver-webapp \
   --publish 8080:8080 \
-  ghcr.io/brandonocasey/rom-weaver-webapp:latest
+  ghcr.io/rom-weaver/rom-weaver-webapp:latest
 ```
 
-Docker Compose, building from source:
+Docker Compose using the same published GitHub Container Registry (GHCR) image:
+Download the [Docker Compose template](https://github.com/rom-weaver/rom-weaver/blob/main/docker-compose.yml)
+into a new directory:
 
 ```bash
-git clone https://github.com/rom-weaver/rom-weaver.git
-cd rom-weaver
-docker compose up --build --detach
+mkdir -p rom-weaver-compose
+cd rom-weaver-compose
+curl --fail --location --proto '=https' --tlsv1.2 \
+  --output docker-compose.yml \
+  https://raw.githubusercontent.com/rom-weaver/rom-weaver/main/docker-compose.yml
+docker compose pull
+docker compose up --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`.
+Only Docker with Compose is required. Set `PORT` to change the host port, for
+example `PORT=3000 docker compose up --detach`. To build the image from source
+instead, clone the repository and add `--build` to the `docker compose up`
+command from its checkout; that path is slower and intended for development.
 For standalone TLS, mount a trusted certificate as described in the guide and
 set `HTTPS_PORT` instead.
 
-</details>
-
-### CLI
+## CLI
 
-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.
+Native release assets cover macOS arm64 and x86-64; Linux x86-64 GNU plus
+x86-64, arm64, and i686 musl; and Windows arm64, x86-64, and x86. The package
+manager and installer options below select the matching asset unless their
+description says otherwise.
 
 <details>
 <summary>Homebrew (macOS arm64/Intel, Linux arm64/x86-64)</summary>
@@ -250,7 +144,8 @@ scoop install rom-weaver
 <details>
 <summary>Install script (macOS, Linux)</summary>
 
-Downloads the latest release to `~/.local/bin` and verifies its checksum.
+Downloads the latest release to `~/.local/bin` and checks its GitHub build
+attestation.
 Override with `ROM_WEAVER_INSTALL_DIR` or pin with `ROM_WEAVER_VERSION`.
 The script also installs manpages and shell completions for the current user.
 
@@ -298,8 +193,7 @@ npm install --save-dev @rom-weaver/cli
 <details>
 <summary>cargo-binstall</summary>
 
-Downloads the same release binary rather than compiling the workspace, so it is
-minutes faster than `cargo install`:
+Downloads the same release binary rather than compiling the workspace:
 
 ```bash
 cargo binstall rom-weaver-cli
@@ -331,14 +225,13 @@ Runs from the published Linux image without installing anything:
 docker run --rm \
   --user "$(id -u):$(id -g)" \
   --volume "$PWD:/work" \
-  ghcr.io/brandonocasey/rom-weaver-cli:latest \
+  ghcr.io/rom-weaver/rom-weaver-cli:latest \
   probe --input /work/game.iso
 ```
 
-Mount your ROM directory at `/work` and pass paths under it. `--user` matters:
-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/install.md#run-in-docker).
+Mount your ROM directory at `/work` and pass paths under it. On Linux and
+macOS, `--user` keeps files created in the bind mount owned by your host user.
+See [Run in Docker](./docs/how-to/install-cli.md#run-in-docker).
 
 </details>
 
@@ -360,11 +253,120 @@ toolchain.
 </details>
 
 Hitting `Permission denied`? See
-[File permissions](./docs/cli/reference.md#file-permissions).
+[File permissions](./docs/reference/cli.md#file-permissions).
 
 The [development guide](./docs/development/development.md) covers the full toolchain setup,
 webapp builds, and tests.
 
+## Why
+
+Every console generation brought its own compressed format: CHD for discs, RVZ
+for GameCube and Wii, Z3DS for 3DS ROMs, CSO and PBP for PSP, plus the usual ZIP
+and 7z on top. Working across them can mean finding several separate programs,
+learning different flags, and checking which builds are available for your
+platform.
+
+Patching adds another manual sequence. A translation, bugfix, and undub may
+need to run in a specific order, with intermediate files kept straight and a
+compressed input unpacked before the first patch and recompressed afterward.
+Repeating that setup whenever the patch combination changes adds disk churn and
+room for mistakes to what should be one workflow.
+
+The last piece is curation. Keeping a collection in order means storing ROMs
+compressed, keeping the patches next to them, and being able to prove months
+later that a patched file came from the ROM you think it did. rom-weaver
+handles all of it in one place. It reads every format above. It writes CHD, RVZ,
+Z3DS, ZIP, and 7z archives. It chains as many patches as you want in a single pass
+without manually unpacking first, and records the whole recipe - patch order,
+checksums, and output names - in a bundle file you can hand to someone else.
+Native CLI builds are
+available for Linux, macOS, and Windows. The browser webapp handles patching
+and bundle workflows without an install.
+
+For the current measurements and trade-offs, see the [performance brief](#performance).
+
+## Performance
+
+rom-weaver uses the same Rust engine in the CLI and threaded WASM webapp, but
+browser worker, storage, and OPFS costs make cross-frontend timing comparisons
+misleading. The [performance guide](./docs/development/performance.md) records
+the machine, corpus, settings, reference-tool versions, and repeated runs for
+each published result, and includes the commands needed to reproduce them.
+Production WASM is optimized with `wasm-opt -O4`; the browser codec matrix is
+the runtime check for the shipped worker and storage path.
+
+## Features
+
+- **Apply and create patches.** Twenty-one formats, including IPS, BPS, UPS,
+  xdelta/VCDIFF, PPF, RUP, BDF/BSDIFF40, APS, and DCP (Dreamcast), with ordered
+  multi-patch chains, checksum validation when the format or bundle supplies
+  expected values, and cheat-code baking. Three of them (DCP, BSP, and
+  HDiffPatch) can only be applied, not created.
+- **Inspect and extract containers.** ZIP, 7z, RAR, the tar family, CHD, RVZ,
+  Z3DS, CSO, PBP, GCZ, WIA, WBFS, and more, including nested archives.
+- **Create format-specific compressed containers.** ZIP, 7z, CHD, RVZ, and Z3DS with
+  codec-aware compression settings. CHD and RVZ outputs are checked for
+  round-trip compatibility with chdman and dolphin-tool.
+- **Checksum and verify.** CRC32, MD5, SHA-1, SHA-256, BLAKE3, and friends,
+  with copier-header detection, header repair, and header-aware checksum
+  variants.
+- **Trim and restore.** Trimming for NDS, GBA, 3DS, XISO, and RVZ scrub. NDS,
+  GBA, and 3DS can be reverted, with an opt-in footer that restores the
+  original file byte-for-byte.
+- **Share workflows.** Distributable [`rom-weaver-bundle.json`](./docs/rom-weaver-bundle-v1.schema.json)
+  bundles pin patch order, checksums, and output naming so others can replay
+  the exact workflow.
+- **Local-first and private.** Everything runs on your machine. The webapp is
+  an installable PWA that works offline and never uploads your files.
+- **One engine, two frontends.** The same Rust core powers the terminal CLI
+  and the threaded WASM webapp. CLI operation commands can emit line-delimited
+  JSON for scripting.
+
+The complete format, codec, and checksum compatibility tables are maintained
+in the [CLI guide](./docs/reference/formats.md).
+
+## Notices
+
+### Beta status
+
+rom-weaver is beta software and follows Semantic Versioning, but until v1.0,
+breaking changes may still happen between minor releases. Patching,
+compressing, extracting, and bundling are covered by automated tests. Hands-on
+testing happens on macOS and Linux; Windows is covered by hosted CI but has seen
+much less real-world use, so expect rougher edges there and please report
+anything Windows-specific. If you
+rely on the APIs or CLI flags, expect things to be a bit tougher: those
+interfaces may still change as the project heads toward v1.0. Trim and Tools are
+still beta, so they are disabled by default in the webapp and can be enabled in
+Settings. The `rom-weaver-core`, `-checksum`, `-containers`, and
+`-patches` crates are published to crates.io only so `rom-weaver-cli` can use
+them. The CLI and the webapp are the supported interfaces; using those crates as
+libraries in another project is not supported.
+
+### First complete public release
+
+v0.7.2 was the first complete public release. 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. Starting with v0.7.2, all public install methods were intended
+to work together. Install commands below resolve the current release unless you
+explicitly pin a version.
+
+### LLM-assisted development
+
+rom-weaver is built by a full-time software engineer in my spare time. Claude
+and ChatGPT are used during development for brainstorming, implementation,
+debugging, and review. I make the engineering decisions and review and test
+the resulting work myself; the goal is high-quality, dependable software, but
+AI-assisted code may still need extra scrutiny.
+
+### Translations
+
+Localized translations are early and may be entirely wrong in places. Manual
+edits and corrections are welcome.
+
 ## Screenshots
 
 [View every screenshot at full size.](./docs/development/screenshots.md)
@@ -381,8 +383,8 @@ webapp builds, and tests.
       <td>Desktop: ordered patch stack</td>
       <td>
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="packages/rom-weaver-webapp/design/apply-patches-desktop-dark.webp">
-          <img src="packages/rom-weaver-webapp/design/apply-patches-desktop-light.webp" alt="Focused Weave patch stack with two ordered sample patches on desktop">
+          <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/apply-patches-desktop-dark.webp">
+          <img src="docs/screenshots/apply-patches-desktop-light.webp" alt="Focused Apply patch stack with two ordered sample patches on desktop">
         </picture>
       </td>
     </tr>
@@ -390,8 +392,8 @@ webapp builds, and tests.
       <td>Desktop: create output</td>
       <td>
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="packages/rom-weaver-webapp/design/create-output-desktop-dark.webp">
-          <img src="packages/rom-weaver-webapp/design/create-output-desktop-light.webp" alt="Focused Create output card with BPS selected on desktop">
+          <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/create-output-desktop-dark.webp">
+          <img src="docs/screenshots/create-output-desktop-light.webp" alt="Focused Create output card with BPS selected on desktop">
         </picture>
       </td>
     </tr>
@@ -399,8 +401,8 @@ webapp builds, and tests.
       <td>Mobile: Original and Modified</td>
       <td align="center">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="packages/rom-weaver-webapp/design/create-inputs-mobile-dark.webp">
-          <img src="packages/rom-weaver-webapp/design/create-inputs-mobile-light.webp" alt="Focused Create Original and Modified cards on mobile" width="390">
+          <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/create-inputs-mobile-dark.webp">
+          <img src="docs/screenshots/create-inputs-mobile-light.webp" alt="Focused Create Original and Modified cards on mobile" width="390">
         </picture>
       </td>
     </tr>
@@ -408,8 +410,8 @@ webapp builds, and tests.
       <td>Mobile: bundle output options</td>
       <td align="center">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="packages/rom-weaver-webapp/design/bundle-output-mobile-dark.webp">
-          <img src="packages/rom-weaver-webapp/design/bundle-output-mobile-light.webp" alt="Focused patch-only bundle controls on mobile" width="390">
+          <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/bundle-output-mobile-dark.webp">
+          <img src="docs/screenshots/bundle-output-mobile-light.webp" alt="Focused patch-only bundle controls on mobile" width="390">
         </picture>
       </td>
     </tr>
@@ -421,7 +423,7 @@ webapp builds, and tests.
 Start with the browser-first [documentation home](https://rom-weaver.com/docs)
 or the repository [documentation index](./docs/README.md). The web docs include
 a task and tool picker, guided samples, focused screenshots, and a
-[FAQ](./docs/usage/faq.md). CLI, deployment, integration, development,
+[FAQ](./docs/faq.md). CLI, deployment, integration, development,
 architecture, and format references each have their own guides.
 
 ## Contributing and support
@@ -430,10 +432,10 @@ Bug reports and contributions are welcome. Read the
 [contribution guide](CONTRIBUTING.md) and [code of conduct](.github/CODE_OF_CONDUCT.md)
 before submitting a change. Because rom-weaver is dual-licensed, code and
 documentation changes need a one-time signature on the
-[Contributor License Agreement](CLA.md) - the `CLA Signed` check asks for
-it on your first pull request, it covers every repository in the
-[`rom-weaver` organization](https://github.com/rom-weaver), and you keep the
-copyright in your work. Report
+[Contributor License Agreement](CLA.md). The `CLA Signed` check asks for
+it on your first pull request. One signature covers every repository in the
+[`rom-weaver` organization](https://github.com/rom-weaver) whose contribution
+process references the agreement. You keep the copyright in your work. Report
 suspected vulnerabilities through GitHub's private reporting form in the
 [security policy](.github/SECURITY.md). If rom-weaver has been useful to you, you can
 support continued development through
@@ -442,7 +444,7 @@ support continued development through
 
 ## License
 
-Copyright (C) Brandon Casey and rom-weaver contributors
+Copyright © Brandon Casey and rom-weaver contributors
 
 The public distribution is licensed under
 [AGPL-3.0-or-later](LICENSE). [Commercial licensing](COMMERCIAL.md) is

package/docs/completions/_rom-weaver

@@ -89,8 +89,8 @@ _arguments "${_arguments_options[@]}" : \
 ;;
 (extract)
 _arguments "${_arguments_options[@]}" : \
-'-i+[Archive or disc image to unpack]:INPUT:_files' \
-'--input=[Archive or disc image to unpack]:INPUT:_files' \
+'-i+[Archive or single-payload compressed format to unpack]:INPUT:_files' \
+'--input=[Archive or single-payload compressed format to unpack]:INPUT:_files' \
 '*-s+[Extract only these files, by exact name, prefix, or glob (repeatable). For example\: --select '\''game.disc0?.bin'\'']:SELECT:_default' \
 '*--select=[Extract only these files, by exact name, prefix, or glob (repeatable). For example\: --select '\''game.disc0?.bin'\'']:SELECT:_default' \
 '*--filter=[Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
@@ -518,7 +518,7 @@ _arguments "${_arguments_options[@]}" : \
 '--input=[ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle]:INPUT:_files' \
 '*--assume-in=[Take the ROM'\''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '--rom-url=[Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url]:ROM_URL:_default' \
-'--rom-name=[File name to show for the ROM, and to base the output name on]:ROM_NAME:_default' \
+'--rom-name=[Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns]:ROM_NAME:_default' \
 '*--patch=[Patch to list in the bundle. Repeat once per patch, in the order they should be applied]:PATCH:_files' \
 '*--patch-id=[Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings]:PATCH_ID:_default' \
 '*--patch-version=[Version of the preceding --patch, in whatever form its author uses]:PATCH_VERSION:_default' \
@@ -949,10 +949,10 @@ _rom-weaver_commands() {
     local commands; commands=(
 'probe:Identify a file\: its format, its platform, and any header it carries' \
 'inspect:Identify a file\: its format, its platform, and any header it carries' \
-'extract:Unpack an archive or disc image' \
+'extract:Unpack an archive or single-payload compressed format' \
 'checksum:Compute checksums for a file, or for a ROM inside an archive' \
 'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
-'compress:Pack files into an archive or a compressed disc image' \
+'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
 'trim:Cut the padding off a ROM, or put it back' \
 'patch:Apply, create, or check ROM patches' \
 'bundle:Build and read rom-weaver-bundle.json patch recipes' \
@@ -1043,10 +1043,10 @@ _rom-weaver__subcmd__extract_commands() {
 _rom-weaver__subcmd__help_commands() {
     local commands; commands=(
 'probe:Identify a file\: its format, its platform, and any header it carries' \
-'extract:Unpack an archive or disc image' \
+'extract:Unpack an archive or single-payload compressed format' \
 'checksum:Compute checksums for a file, or for a ROM inside an archive' \
 'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
-'compress:Pack files into an archive or a compressed disc image' \
+'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
 'trim:Cut the padding off a ROM, or put it back' \
 'patch:Apply, create, or check ROM patches' \
 'bundle:Build and read rom-weaver-bundle.json patch recipes' \

package/docs/completions/rom-weaver.elv

@@ -35,10 +35,10 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand --version 'Print version'
             cand probe 'Identify a file: its format, its platform, and any header it carries'
             cand inspect 'Identify a file: its format, its platform, and any header it carries'
-            cand extract 'Unpack an archive or disc image'
+            cand extract 'Unpack an archive or single-payload compressed format'
             cand checksum 'Compute checksums for a file, or for a ROM inside an archive'
             cand ingest 'Sort a file into ROMs and patches, unpacking and hashing along the way'
-            cand compress 'Pack files into an archive or a compressed disc image'
+            cand compress 'Pack files into an archive, disc image, or ROM-specific compressed format'
             cand trim 'Cut the padding off a ROM, or put it back'
             cand patch 'Apply, create, or check ROM patches'
             cand bundle 'Build and read rom-weaver-bundle.json patch recipes'
@@ -93,8 +93,8 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand --help 'Print help (see more with ''--help'')'
         }
         &'rom-weaver;extract'= {
-            cand -i 'Archive or disc image to unpack'
-            cand --input 'Archive or disc image to unpack'
+            cand -i 'Archive or single-payload compressed format to unpack'
+            cand --input 'Archive or single-payload compressed format to unpack'
             cand -s 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin'''
             cand --select 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin'''
             cand --filter 'Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
@@ -471,7 +471,7 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand --input 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle'
             cand --assume-in 'Take the ROM''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)'
             cand --rom-url 'Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url'
-            cand --rom-name 'File name to show for the ROM, and to base the output name on'
+            cand --rom-name 'Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns'
             cand --patch 'Patch to list in the bundle. Repeat once per patch, in the order they should be applied'
             cand --patch-id 'Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings'
             cand --patch-version 'Version of the preceding --patch, in whatever form its author uses'
@@ -698,10 +698,10 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         }
         &'rom-weaver;help'= {
             cand probe 'Identify a file: its format, its platform, and any header it carries'
-            cand extract 'Unpack an archive or disc image'
+            cand extract 'Unpack an archive or single-payload compressed format'
             cand checksum 'Compute checksums for a file, or for a ROM inside an archive'
             cand ingest 'Sort a file into ROMs and patches, unpacking and hashing along the way'
-            cand compress 'Pack files into an archive or a compressed disc image'
+            cand compress 'Pack files into an archive, disc image, or ROM-specific compressed format'
             cand trim 'Cut the padding off a ROM, or put it back'
             cand patch 'Apply, create, or check ROM patches'
             cand bundle 'Build and read rom-weaver-bundle.json patch recipes'

package/docs/completions/rom-weaver.fish

@@ -42,10 +42,10 @@ complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -s h -l help -d 'Pri
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -s V -l version -d 'Print version'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "probe" -d 'Identify a file: its format, its platform, and any header it carries'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "inspect" -d 'Identify a file: its format, its platform, and any header it carries'
-complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "extract" -d 'Unpack an archive or disc image'
+complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "extract" -d 'Unpack an archive or single-payload compressed format'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "checksum" -d 'Compute checksums for a file, or for a ROM inside an archive'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "ingest" -d 'Sort a file into ROMs and patches, unpacking and hashing along the way'
-complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "compress" -d 'Pack files into an archive or a compressed disc image'
+complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "compress" -d 'Pack files into an archive, disc image, or ROM-specific compressed format'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "trim" -d 'Cut the padding off a ROM, or put it back'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "patch" -d 'Apply, create, or check ROM patches'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "bundle" -d 'Build and read rom-weaver-bundle.json patch recipes'
@@ -96,7 +96,7 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand inspect" -l dep-tr
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand inspect" -l color -d 'Keep colors even when output is piped'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand inspect" -l no-color -d 'Turn colors off'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand inspect" -s h -l help -d 'Print help (see more with \'--help\')'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand extract" -s i -l input -d 'Archive or disc image to unpack' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand extract" -s i -l input -d 'Archive or single-payload compressed format to unpack' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand extract" -s s -l select -d 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select \'game.disc0?.bin\'' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand extract" -l filter -d 'Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)' -r -f -a "rom\t''
 patch\t''"
@@ -479,7 +479,7 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and not __
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -s i -l input -d 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l assume-in -d 'Take the ROM\'s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l rom-url -d 'Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url' -r
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l rom-name -d 'File name to show for the ROM, and to base the output name on' -r
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l rom-name -d 'Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l patch -d 'Patch to list in the bundle. Repeat once per patch, in the order they should be applied' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l patch-id -d 'Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand bundle; and __fish_seen_subcommand_from create" -l patch-version -d 'Version of the preceding --patch, in whatever form its author uses' -r
@@ -702,10 +702,10 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -l co
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -l no-color -d 'Turn colors off'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -s h -l help -d 'Print help (see more with \'--help\')'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "probe" -d 'Identify a file: its format, its platform, and any header it carries'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "extract" -d 'Unpack an archive or disc image'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "extract" -d 'Unpack an archive or single-payload compressed format'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "checksum" -d 'Compute checksums for a file, or for a ROM inside an archive'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "ingest" -d 'Sort a file into ROMs and patches, unpacking and hashing along the way'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "compress" -d 'Pack files into an archive or a compressed disc image'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "compress" -d 'Pack files into an archive, disc image, or ROM-specific compressed format'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "trim" -d 'Cut the padding off a ROM, or put it back'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "patch" -d 'Apply, create, or check ROM patches'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum ingest compress trim patch bundle tools plan-extract-batch weave completions help" -f -a "bundle" -d 'Build and read rom-weaver-bundle.json patch recipes'

package/docs/completions/rom-weaver.ps1

@@ -38,10 +38,10 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--version', '--version', [CompletionResultType]::ParameterName, 'Print version')
             [CompletionResult]::new('probe', 'probe', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
             [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
-            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or disc image')
+            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
             [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
             [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
-            [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive or a compressed disc image')
+            [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
             [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
             [CompletionResult]::new('patch', 'patch', [CompletionResultType]::ParameterValue, 'Apply, create, or check ROM patches')
             [CompletionResult]::new('bundle', 'bundle', [CompletionResultType]::ParameterValue, 'Build and read rom-weaver-bundle.json patch recipes')
@@ -99,8 +99,8 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             break
         }
         'rom-weaver;extract' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Archive or disc image to unpack')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Archive or disc image to unpack')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Archive or single-payload compressed format to unpack')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Archive or single-payload compressed format to unpack')
             [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin''')
             [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin''')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
@@ -493,7 +493,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle')
             [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take the ROM''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)')
             [CompletionResult]::new('--rom-url', '--rom-url', [CompletionResultType]::ParameterName, 'Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url')
-            [CompletionResult]::new('--rom-name', '--rom-name', [CompletionResultType]::ParameterName, 'File name to show for the ROM, and to base the output name on')
+            [CompletionResult]::new('--rom-name', '--rom-name', [CompletionResultType]::ParameterName, 'Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to list in the bundle. Repeat once per patch, in the order they should be applied')
             [CompletionResult]::new('--patch-id', '--patch-id', [CompletionResultType]::ParameterName, 'Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings')
             [CompletionResult]::new('--patch-version', '--patch-version', [CompletionResultType]::ParameterName, 'Version of the preceding --patch, in whatever form its author uses')
@@ -736,10 +736,10 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;help' {
             [CompletionResult]::new('probe', 'probe', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
-            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or disc image')
+            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
             [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
             [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
-            [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive or a compressed disc image')
+            [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
             [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
             [CompletionResult]::new('patch', 'patch', [CompletionResultType]::ParameterValue, 'Apply, create, or check ROM patches')
             [CompletionResult]::new('bundle', 'bundle', [CompletionResultType]::ParameterValue, 'Build and read rom-weaver-bundle.json patch recipes')

package/docs/man/rom-weaver-bundle-create.1

@@ -10,7 +10,7 @@ Write a rom\-weaver\-bundle.json recipe from local ROM and patch files.
 .PP
 A bundle records which ROM the patches are for, what order they run in, and
 what the result should hash to. Hand it to someone else and
-`rom\-weaver weave \-\-bundle` reproduces your exact result.
+`rom\-weaver patch apply \-\-bundle` reproduces your exact result.
 .PP
 Checksums come from the real files, so nothing here is taken on faith. Every
 \-\-patch\-* flag describes the \-\-patch before it.
@@ -29,7 +29,7 @@ Take the ROM\*(Aqs checksum and size on trust rather than reading it, as in crc3
 Where the ROM can be downloaded from. With \-\-input, the local file still supplies the checksums; on its own, the bundle records only this url
 .TP
 \fB\-\-rom\-name\fR \fI<ROM_NAME>\fR
-File name to show for the ROM, and to base the output name on
+Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns
 .TP
 \fB\-\-patch\fR \fI<PATCH>\fR
 Patch to list in the bundle. Repeat once per patch, in the order they should be

package/docs/man/rom-weaver-bundle-parse.1

@@ -17,7 +17,7 @@ Entries that name a file are looked for in the archive, or next to the recipe.
 Pass \-\-output to write those files out and get real paths back. Entries that
 name a url are reported as they are; nothing is downloaded.
 .PP
-To actually run a bundle, use `rom\-weaver weave \-\-bundle` instead.
+To actually run a bundle, use `rom\-weaver patch apply \-\-bundle` instead.
 .SH OPTIONS
 .TP
 \fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR

package/docs/man/rom-weaver-compress.1

@@ -2,17 +2,18 @@
 .el .ds Aq '
 .TH rom-weaver-compress 1  "rom-weaver-compress "
 .SH NAME
-rom\-weaver\-compress \- Pack files into an archive or a compressed disc image
+rom\-weaver\-compress \- Pack files into an archive, disc image, or ROM\-specific compressed format
 .SH SYNOPSIS
 \fBrom\-weaver compress\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-f\fR|\fB\-\-format\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fB\-\-codec\fR] [\fB\-\-log\-level\fR] [\fB\-\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-h\fR|\fB\-\-help\fR]
 .SH DESCRIPTION
-Pack files into an archive or a compressed disc image.
+Pack files into an archive, disc image, or ROM\-specific compressed format.
 .PP
 The format comes from the \-\-output extension, so `\-\-output game.chd` writes a
 CHD. Formats that can be written: zip, 7z, chd, rvz, and z3ds.
 .PP
-Repeat \-\-input to put several files in one archive. Disc images take a single
-input instead: point \-\-input at the .cue or .gdi and its tracks come along.
+Repeat \-\-input to put several files in one archive. Single\-payload formats take
+one input instead: point \-\-input at the .cue or .gdi for a disc image, or at a
+single 3DS ROM for Z3DS.
 .PP
   rom\-weaver compress \-\-input game.cue \-\-output game.chd
 .PP

package/docs/man/rom-weaver-extract.1

@@ -2,11 +2,11 @@
 .el .ds Aq '
 .TH rom-weaver-extract 1  "rom-weaver-extract "
 .SH NAME
-rom\-weaver\-extract \- Unpack an archive or disc image
+rom\-weaver\-extract \- Unpack an archive or single\-payload compressed format
 .SH SYNOPSIS
 \fBrom\-weaver extract\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fB\-\-split\-bin\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-nested\-extract\fR] [\fB\-\-color\fR] [\fB\-\-force\fR] [\fB\-\-checksum\fR] [\fB\-\-no\-color\fR] [\fB\-\-checksum\-rom\fR] [\fB\-\-probe\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
 .SH DESCRIPTION
-Unpack an archive or disc image into a directory.
+Unpack an archive or single\-payload compressed format into a directory.
 .PP
 Archives found inside the input are unpacked too, up to eight levels deep. Pass
 \-\-no\-nested\-extract to stop after the first layer.
@@ -16,7 +16,7 @@ whole extraction stops before writing. Pass \-\-force to overwrite instead.
 .SH OPTIONS
 .TP
 \fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR
-Archive or disc image to unpack
+Archive or single\-payload compressed format to unpack
 .TP
 \fB\-s\fR, \fB\-\-select\fR \fI<SELECT>\fR
 Extract only these files, by exact name, prefix, or glob (repeatable). For example: \-\-select \*(Aqgame.disc0?.bin\*(Aq

package/docs/man/rom-weaver-patch-apply.1

@@ -8,13 +8,14 @@ rom\-weaver\-patch\-apply \- Apply one or more patches to a ROM, in order
 .SH DESCRIPTION
 Apply one or more patches to a ROM, in order.
 .PP
-`rom\-weaver weave` runs this same command under a shorter name, and is what
-most of the examples use.
+Use `rom\-weaver patch apply` for the canonical command. The compatibility
+spelling `rom\-weaver weave` runs the same command.
 .PP
 Repeat \-\-patch once per patch. They run left to right, each one on the result
-of the last. \-\-input takes a plain ROM, an archive or disc image (the ROM
-inside is found for you), or a rom\-weaver\-bundle.json that already names the
-ROM, the patches, and the output.
+of the last. \-\-input takes a plain ROM, an archive, or a single\-payload
+compressed format (the ROM inside is found for you), or a
+rom\-weaver\-bundle.json that already names the ROM, the patches, and the
+output.
 .PP
 The result is compressed by default, into whatever container the \-\-output
 extension names. Pass \-\-no\-compress for a plain ROM file.
@@ -340,17 +341,17 @@ Turn colors off
 .SH EXTRA
 Examples:
   # One patch, plain ROM out
-  rom\-weaver weave \-\-input game.sfc \-\-patch hack.bps \\
+  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
     \-\-output hacked.sfc \-\-no\-compress
 
   # Two patches in order, straight out of and back into a zip
-  rom\-weaver weave \-\-input game.zip \\
+  rom\-weaver patch apply \-\-input game.zip \\
     \-\-patch translation.bps \-\-patch fixes.ips \-\-output hacked.zip
 
   # Replay someone else\*(Aqs published recipe
-  rom\-weaver weave \-\-bundle rom\-weaver\-bundle.json \-\-input game.sfc
+  rom\-weaver patch apply \-\-bundle rom\-weaver\-bundle.json \-\-input game.sfc
 
   # Check the result against a checksum the patch author published
-  rom\-weaver weave \-\-input game.sfc \-\-patch hack.bps \\
+  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
     \-\-output hacked.sfc \-\-no\-compress \\
     \-\-expect\-out sha1=0123456789abcdef0123456789abcdef01234567

package/docs/man/rom-weaver-weave.1

@@ -8,13 +8,14 @@ rom\-weaver\-weave \- Apply one or more patches to a ROM, in order (same as `pat
 .SH DESCRIPTION
 Apply one or more patches to a ROM, in order.
 .PP
-`rom\-weaver weave` runs this same command under a shorter name, and is what
-most of the examples use.
+Use `rom\-weaver patch apply` for the canonical command. The compatibility
+spelling `rom\-weaver weave` runs the same command.
 .PP
 Repeat \-\-patch once per patch. They run left to right, each one on the result
-of the last. \-\-input takes a plain ROM, an archive or disc image (the ROM
-inside is found for you), or a rom\-weaver\-bundle.json that already names the
-ROM, the patches, and the output.
+of the last. \-\-input takes a plain ROM, an archive, or a single\-payload
+compressed format (the ROM inside is found for you), or a
+rom\-weaver\-bundle.json that already names the ROM, the patches, and the
+output.
 .PP
 The result is compressed by default, into whatever container the \-\-output
 extension names. Pass \-\-no\-compress for a plain ROM file.
@@ -340,17 +341,17 @@ Turn colors off
 .SH EXTRA
 Examples:
   # One patch, plain ROM out
-  rom\-weaver weave \-\-input game.sfc \-\-patch hack.bps \\
+  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
     \-\-output hacked.sfc \-\-no\-compress
 
   # Two patches in order, straight out of and back into a zip
-  rom\-weaver weave \-\-input game.zip \\
+  rom\-weaver patch apply \-\-input game.zip \\
     \-\-patch translation.bps \-\-patch fixes.ips \-\-output hacked.zip
 
   # Replay someone else\*(Aqs published recipe
-  rom\-weaver weave \-\-bundle rom\-weaver\-bundle.json \-\-input game.sfc
+  rom\-weaver patch apply \-\-bundle rom\-weaver\-bundle.json \-\-input game.sfc
 
   # Check the result against a checksum the patch author published
-  rom\-weaver weave \-\-input game.sfc \-\-patch hack.bps \\
+  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
     \-\-output hacked.sfc \-\-no\-compress \\
     \-\-expect\-out sha1=0123456789abcdef0123456789abcdef01234567

package/docs/man/rom-weaver.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH rom-weaver 1  "rom-weaver 0.11.0"
+.TH rom-weaver 1  "rom-weaver 0.12.0"
 .SH NAME
 rom\-weaver \- Inspect, extract, checksum, compress, trim, and patch ROMs and disc images
 .SH SYNOPSIS
@@ -9,8 +9,8 @@ rom\-weaver \- Inspect, extract, checksum, compress, trim, and patch ROMs and di
 Inspect, extract, checksum, compress, trim, and patch ROMs and disc images.
 .PP
 rom\-weaver reads compressed input directly, so you rarely have to unpack a file
-first. Point \-\-input at an archive or disc image and the ROM inside it is found
-for you; pass \-\-no\-extract to work on the raw bytes instead.
+first. Point \-\-input at an archive or single\-payload compressed format; the ROM
+inside it is found for you. Pass \-\-no\-extract to work on the raw bytes instead.
 .PP
 Everything runs on your machine. Nothing is uploaded.
 .SH OPTIONS
@@ -72,7 +72,7 @@ rom\-weaver\-probe(1)
 Identify a file: its format, its platform, and any header it carries
 .TP
 rom\-weaver\-extract(1)
-Unpack an archive or disc image
+Unpack an archive or single\-payload compressed format
 .TP
 rom\-weaver\-checksum(1)
 Compute checksums for a file, or for a ROM inside an archive
@@ -81,7 +81,7 @@ rom\-weaver\-ingest(1)
 Sort a file into ROMs and patches, unpacking and hashing along the way
 .TP
 rom\-weaver\-compress(1)
-Pack files into an archive or a compressed disc image
+Pack files into an archive, disc image, or ROM\-specific compressed format
 .TP
 rom\-weaver\-trim(1)
 Cut the padding off a ROM, or put it back
@@ -106,11 +106,11 @@ Examples:
   rom\-weaver probe \-\-input game.iso
 
   # Apply a patch, writing a plain ROM
-  rom\-weaver weave \-\-input game.sfc \-\-patch hack.bps \\
+  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
     \-\-output hacked.sfc \-\-no\-compress
 
   # Two patches in order; the .zip extension compresses the result
-  rom\-weaver weave \-\-input game.sfc \\
+  rom\-weaver patch apply \-\-input game.sfc \\
     \-\-patch base.ips \-\-patch fixes.ups \-\-output hacked.zip
 
   # Hash a ROM, including one inside an archive
@@ -119,6 +119,6 @@ Examples:
   # Shrink a disc image; the .cue brings its tracks along
   rom\-weaver compress \-\-input game.cue \-\-output game.chd
 
-Full guide: https://github.com/rom\-weaver/rom\-weaver/blob/main/docs/cli/reference.md
+Full guide: https://rom\-weaver.com/docs/cli
 .SH VERSION
-v0.11.0
+v0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rom-weaver/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "author": "Brandon Casey",
   "license": "AGPL-3.0-or-later",
   "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.",
@@ -64,15 +64,15 @@
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@rom-weaver/darwin-arm64": "0.11.0",
-    "@rom-weaver/darwin-x64": "0.11.0",
-    "@rom-weaver/linux-arm64-musl": "0.11.0",
-    "@rom-weaver/linux-ia32-musl": "0.11.0",
-    "@rom-weaver/linux-x64-gnu": "0.11.0",
-    "@rom-weaver/linux-x64-musl": "0.11.0",
-    "@rom-weaver/win32-arm64-msvc": "0.11.0",
-    "@rom-weaver/win32-ia32-msvc": "0.11.0",
-    "@rom-weaver/win32-x64-msvc": "0.11.0"
+    "@rom-weaver/darwin-arm64": "0.12.0",
+    "@rom-weaver/darwin-x64": "0.12.0",
+    "@rom-weaver/linux-arm64-musl": "0.12.0",
+    "@rom-weaver/linux-ia32-musl": "0.12.0",
+    "@rom-weaver/linux-x64-gnu": "0.12.0",
+    "@rom-weaver/linux-x64-musl": "0.12.0",
+    "@rom-weaver/win32-arm64-msvc": "0.12.0",
+    "@rom-weaver/win32-ia32-msvc": "0.12.0",
+    "@rom-weaver/win32-x64-msvc": "0.12.0"
   },
   "scripts": {
     "docs:lint": "markdownlint-cli2",
@@ -82,6 +82,7 @@
     "hooks:install": "node scripts/lefthook-install.mjs",
     "hooks:run": "lefthook run pre-commit --force",
     "hooks:validate": "lefthook validate",
+    "lint:code": "oxlint scripts packages/rom-weaver-alias/bin --deny-warnings",
     "prepack": "mise run manpages",
     "test": "node --test scripts/*.test.mjs scripts/ci/*.test.mjs scripts/wasm/*.test.mjs",
     "audit:deps": "npm audit --audit-level=high",
@@ -95,6 +96,7 @@
     "cross-spawn": "7.0.6",
     "doctoc": "2.5.0",
     "lefthook": "2.1.10",
-    "markdownlint-cli2": "0.23.2"
+    "markdownlint-cli2": "0.23.2",
+    "oxlint": "1.76.0"
   }
 }