@rom-weaver/cli 0.14.1 → 0.15.1

package/README.md

@@ -47,46 +47,13 @@ Choose the [webapp](#webapp), [self-hosting](#self-hosting), or [CLI](#cli) path
 
 ## 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 **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 workflow](https://rom-weaver.com/apply?bundle=first-weave.zip) with a tiny original homebrew NES ROM and two independent patches that change “HELLO WORLD” to “ROM WEAVER.” 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](#self-hosting) section below or the [full self-hosting guide](./docs/hosting/self-hosting.md).
+Open [rom-weaver.com/apply](https://rom-weaver.com/apply). Add your ROM and patches, then download the result. Files are processed on your device. No install or account is needed.
 
-## 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, subpath routing, HTTPS certificates, service-worker scope, and the required COOP/COEP headers.
-
-Static release files:
+Start with [your first patch](docs/tutorials/first-patch.md) to practise on supplied homebrew files. The [browser guides](docs/README.md#in-the-browser) cover applying, creating, bundling, and testing ROM patches.
 
-```bash
-mkdir -p rom-weaver-webapp
-curl --fail --location --proto '=https' --tlsv1.2 \
-  --output rom-weaver-webapp.tar.gz \
-  https://github.com/rom-weaver/rom-weaver/releases/latest/download/rom-weaver-webapp.tar.gz
-tar --extract --gzip --file rom-weaver-webapp.tar.gz --directory rom-weaver-webapp
-```
-
-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 using the published GitHub Container Registry (GHCR) image:
-
-```bash
-docker run --detach --name rom-weaver-webapp \
-  --publish 8080:8080 \
-  ghcr.io/rom-weaver/rom-weaver-webapp:latest
-```
-
-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
-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
-```
+## Self-hosting
 
-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.
+Use the published Docker image or static release archive. The [self-hosting guide](docs/hosting/self-hosting.md) covers both, including HTTPS, reverse proxies, and subpaths.
 
 ## CLI
 
@@ -108,7 +75,7 @@ npm install --global rom-weaver
 ```
 
 
-Homebrew covers macOS arm64/Intel and Linux arm64/x86-64. The install script covers macOS and Linux: it downloads the latest release to `~/.local/bin` and checks its build provenance, refusing to install a binary this repository did not publish. npm is the only channel covering every supported target at once, and needs Node.js 22+.
+Homebrew covers macOS arm64/Intel and Linux arm64/x86-64. The install script covers macOS and Linux: it downloads the latest release to `~/.local/bin` and checks its build provenance, refusing a definite verification failure. If the check cannot run, it warns and continues unless strict verification is enabled; see [Verify a download](docs/how-to/verify-downloads.md). npm is the only channel covering every supported target at once, and needs Node.js 22+.
 
 <a name="build-from-source"></a>
 
@@ -120,19 +87,15 @@ The [development guide](./docs/development/development.md) covers the full toolc
 
 ## 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.
+A patch job can require extraction, several patches in order, checksum checks, and compression. rom-weaver runs those steps together and can save the recipe as a bundle.
 
-For the current measurements and trade-offs, see the [performance brief](#performance). For how rom-weaver lines up against the tools you may already use, the [comparison with similar tools](./docs/explanation/comparisons.md) puts it beside RomPatcher.js, Flips, MultiPatch, xdelta3, chdman, and Dolphin tool, format by format and feature by feature.
+[Browser and CLI](docs/explanation/browser-and-cli.md) explains the two interfaces. [Comparison with similar tools](docs/explanation/comparisons.md) covers alternatives.
 
 ## Performance
 
-rom-weaver matches or beats the reference tools on every measured axis: extraction time, compression time, and output size. On the measured arm64 corpus, extraction is faster in all four formats. CHD extracts 3.1–5.8× faster, RVZ 1.6–2.0×, ZIP 1.6–2.7×, and 7z 1.0–4.7×. RVZ and ZIP compression are 1.1–1.3× faster. 7z compression is even with its reference. CHD compression ranges from even to 1.3× faster. Output sizes match the references to within a fraction of a percent.
+The [performance guide](docs/development/performance.md) records measured compression and extraction times, output sizes, hardware, and test settings. Results vary by format and input; some compression cases are slower than the reference tool.
 
-The CLI and the threaded WASM webapp share one Rust engine. The browser adds worker, storage, and OPFS costs, so CLI and browser timings are not comparable. The [performance guide](./docs/development/performance.md) records the machine, corpus, settings, reference-tool versions, and repeated runs for each published result. It also lists the commands that 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.
+The CLI and browser share one Rust engine. Browser workers and storage add costs, so native timings do not predict browser performance.
 
 ## Features
 
@@ -145,7 +108,7 @@ The CLI and the threaded WASM webapp share one Rust engine. The browser adds wor
 - **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).
+The complete format, codec, and checksum compatibility tables are maintained in [Supported formats](./docs/reference/formats.md).
 
 ## Notices
 

package/docs/completions/_rom-weaver

@@ -561,6 +561,27 @@ esac
     ;;
 esac
 ;;
+(setup)
+_arguments "${_arguments_options[@]}" : \
+'--database-dir=[Install into this directory instead of the per-user data directory]:DIR:_files' \
+'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'--force[Download the database again even when it is already installed]' \
+'--json[Print one JSON object per line instead of human-readable output]' \
+'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(--progress)--no-progress[Hide progress]' \
+'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
+'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
+'(--log-level -v --verbose)-q[Log errors only]' \
+'(--log-level -v --verbose)--quiet[Log errors only]' \
+'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
+'(--no-color)--color[Keep colors even when output is piped]' \
+'(--color)--no-color[Turn colors off]' \
+'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
+'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
+'-h[Print help (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
 (ingest)
 _arguments "${_arguments_options[@]}" : \
 '-i+[File to sort into ROMs and patches]:INPUT:_files' \
@@ -700,11 +721,12 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '-i+[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
 '--input=[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
-'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
 '--target=[For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track]:TARGET:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
+'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
 '-o+[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--output=[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
@@ -760,11 +782,12 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '-i+[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
 '--input=[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
-'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
 '--target=[For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track]:TARGET:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
+'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
 '-o+[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--output=[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
@@ -820,10 +843,11 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '-i+[ROM to check the patches against. May be an archive]:PATH:_files' \
 '--input=[ROM to check the patches against. May be an archive]:PATH:_files' \
-'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '*--patch=[Patch to check. Repeat once per patch; they are checked in the order given]:PATCHES:_files' \
+'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
 '*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--expect-in=[Fail unless the ROM matches\: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable]:ALGO=HEX:_default' \
 '--n64-byte-order=[Byte order to put an N64 ROM in before checking\: auto, keep, big-endian, little-endian, or byte-swapped \[default\: auto\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
@@ -1206,11 +1230,12 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '-i+[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
 '--input=[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
-'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
 '--target=[For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track]:TARGET:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
+'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
 '-o+[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--output=[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
@@ -1282,6 +1307,28 @@ _arguments "${_arguments_options[@]}" : \
 ':shell -- Shell to print completions for:(bash elvish fish powershell zsh)' \
 && ret=0
 ;;
+(man)
+_arguments "${_arguments_options[@]}" : \
+'--man-dir=[Directory to install pages into]:DIR:_files' \
+'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'--install[Install the generated pages instead of printing one]' \
+'--json[Print one JSON object per line instead of human-readable output]' \
+'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(--progress)--no-progress[Hide progress]' \
+'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
+'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
+'(--log-level -v --verbose)-q[Log errors only]' \
+'(--log-level -v --verbose)--quiet[Log errors only]' \
+'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
+'(--no-color)--color[Keep colors even when output is piped]' \
+'(--color)--no-color[Turn colors off]' \
+'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
+'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
+'-h[Print help (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+'*::command -- Command path to print:_default' \
+&& ret=0
+;;
 (formats)
 _arguments "${_arguments_options[@]}" : \
 '(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
@@ -1393,6 +1440,10 @@ esac
     ;;
 esac
 ;;
+(setup)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
 (ingest)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
@@ -1493,6 +1544,10 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
+(man)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
 (formats)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
@@ -1518,6 +1573,7 @@ _rom-weaver_commands() {
 'extract:Unpack an archive or single-payload compressed format' \
 'checksum:Compute checksums for a file, or for a ROM inside an archive' \
 'identify:Identify a ROM title from its checksums' \
+'setup:Install the offline identify database' \
 'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
 'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
 'trim:Cut the padding off a ROM, or put it back' \
@@ -1527,6 +1583,7 @@ _rom-weaver_commands() {
 'plan-extract-batch:Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)' \
 'weave:Apply one or more patches to a ROM, in order (same as \`patch apply\`)' \
 'completions:Print a tab-completion script for your shell' \
+'man:Print or install the generated CLI man pages' \
 'formats:List the formats, codecs, and checksum algorithms this build supports' \
 'help:Print this message or the help of the given subcommand(s)' \
     )
@@ -1619,6 +1676,7 @@ _rom-weaver__subcmd__help_commands() {
 'extract:Unpack an archive or single-payload compressed format' \
 'checksum:Compute checksums for a file, or for a ROM inside an archive' \
 'identify:Identify a ROM title from its checksums' \
+'setup:Install the offline identify database' \
 'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
 'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
 'trim:Cut the padding off a ROM, or put it back' \
@@ -1628,6 +1686,7 @@ _rom-weaver__subcmd__help_commands() {
 'plan-extract-batch:Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)' \
 'weave:Apply one or more patches to a ROM, in order (same as \`patch apply\`)' \
 'completions:Print a tab-completion script for your shell' \
+'man:Print or install the generated CLI man pages' \
 'formats:List the formats, codecs, and checksum algorithms this build supports' \
 'help:Print this message or the help of the given subcommand(s)' \
     )
@@ -1759,6 +1818,11 @@ _rom-weaver__subcmd__help__subcmd__ingest_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver help ingest commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__help__subcmd__man_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__man_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help man commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__help__subcmd__patch_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__patch_commands() {
     local commands; commands=(
@@ -1793,6 +1857,11 @@ _rom-weaver__subcmd__help__subcmd__probe_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver help probe commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__help__subcmd__setup_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__setup_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help setup commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__help__subcmd__tools_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__tools_commands() {
     local commands; commands=(
@@ -2028,6 +2097,11 @@ _rom-weaver__subcmd__ingest_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver ingest commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__man_commands] )) ||
+_rom-weaver__subcmd__man_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver man commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__patch_commands] )) ||
 _rom-weaver__subcmd__patch_commands() {
     local commands; commands=(
@@ -2094,6 +2168,11 @@ _rom-weaver__subcmd__probe_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver probe commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__setup_commands] )) ||
+_rom-weaver__subcmd__setup_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver setup commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__tools_commands] )) ||
 _rom-weaver__subcmd__tools_commands() {
     local commands; commands=(

package/docs/completions/rom-weaver.bash

@@ -46,6 +46,9 @@ _rom__weaver() {
             rom__weaver,inspect)
                 cmd="rom__weaver__subcmd__probe"
                 ;;
+            rom__weaver,man)
+                cmd="rom__weaver__subcmd__man"
+                ;;
             rom__weaver,patch)
                 cmd="rom__weaver__subcmd__patch"
                 ;;
@@ -55,6 +58,9 @@ _rom__weaver() {
             rom__weaver,probe)
                 cmd="rom__weaver__subcmd__probe"
                 ;;
+            rom__weaver,setup)
+                cmd="rom__weaver__subcmd__setup"
+                ;;
             rom__weaver,tools)
                 cmd="rom__weaver__subcmd__tools"
                 ;;
@@ -115,6 +121,9 @@ _rom__weaver() {
             rom__weaver__subcmd__help,ingest)
                 cmd="rom__weaver__subcmd__help__subcmd__ingest"
                 ;;
+            rom__weaver__subcmd__help,man)
+                cmd="rom__weaver__subcmd__help__subcmd__man"
+                ;;
             rom__weaver__subcmd__help,patch)
                 cmd="rom__weaver__subcmd__help__subcmd__patch"
                 ;;
@@ -124,6 +133,9 @@ _rom__weaver() {
             rom__weaver__subcmd__help,probe)
                 cmd="rom__weaver__subcmd__help__subcmd__probe"
                 ;;
+            rom__weaver__subcmd__help,setup)
+                cmd="rom__weaver__subcmd__help__subcmd__setup"
+                ;;
             rom__weaver__subcmd__help,tools)
                 cmd="rom__weaver__subcmd__help__subcmd__tools"
                 ;;
@@ -329,7 +341,7 @@ _rom__weaver() {
 
     case "${cmd}" in
         rom__weaver)
-            opts="-v -q -y -h -V --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help --version probe inspect extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help"
+            opts="-v -q -y -h -V --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help --version probe inspect extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 1 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -875,7 +887,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__help)
-            opts="probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help"
+            opts="probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -1196,6 +1208,20 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__help__subcmd__man)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
         rom__subcmd__weaver__subcmd__help__subcmd__patch)
             opts="apply validate create"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
@@ -1280,6 +1306,20 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__help__subcmd__setup)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
         rom__subcmd__weaver__subcmd__help__subcmd__tools)
             opts="ppf-undo"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
@@ -2030,6 +2070,28 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__man)
+            opts="-v -q -y -h --install --man-dir --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --man-dir)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
+                --log-level)
+                    COMPREPLY=($(compgen -W "off error warn info debug trace" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
         rom__subcmd__weaver__subcmd__patch)
             opts="-v -q -y -h --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help apply weave validate create help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
@@ -2049,7 +2111,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__patch__subcmd__apply)
-            opts="-i -s -o -j -n -v -q -y -h --input --select --target --filter --no-extract --no-ignore --patch --output --bundle --with --without --raw --no-compress --format --compress-format --codec --compress-codec --level --compress-level --assume-in --expect-in --patch-header --patch-basis --output-header --repair-checksum --n64-byte-order --ignore-checksum-validation --expect-out --code --code-system --code-kind --emit-bundle --tui --threads --force --dry-run --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
+            opts="-i -s -o -j -n -v -q -y -h --input --select --target --filter --no-extract --no-ignore --patch --patch-select --output --bundle --with --without --raw --no-compress --format --compress-format --codec --compress-codec --level --compress-level --assume-in --expect-in --patch-header --patch-basis --output-header --repair-checksum --n64-byte-order --ignore-checksum-validation --expect-out --code --code-system --code-kind --emit-bundle --tui --threads --force --dry-run --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -2083,6 +2145,10 @@ _rom__weaver() {
                     COMPREPLY=($(compgen -f "${cur}"))
                     return 0
                     ;;
+                --patch-select)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
                 --output)
                     COMPREPLY=($(compgen -f "${cur}"))
                     return 0
@@ -2359,7 +2425,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__patch__subcmd__validate)
-            opts="-i -s -j -v -q -y -h --input --select --filter --no-extract --no-ignore --patch --assume-in --expect-in --strip-header --n64-byte-order --ignore-checksum-validation --independent --plan --patch-basis --patch-input-check --patch-output-check --threads --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
+            opts="-i -s -j -v -q -y -h --input --select --filter --no-extract --no-ignore --patch --patch-select --assume-in --expect-in --strip-header --n64-byte-order --ignore-checksum-validation --independent --plan --patch-basis --patch-input-check --patch-output-check --threads --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -2389,6 +2455,10 @@ _rom__weaver() {
                     COMPREPLY=($(compgen -f "${cur}"))
                     return 0
                     ;;
+                --patch-select)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
                 --assume-in)
                     COMPREPLY=($(compgen -f "${cur}"))
                     return 0
@@ -2512,6 +2582,28 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__setup)
+            opts="-v -q -y -h --database-dir --force --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --database-dir)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
+                --log-level)
+                    COMPREPLY=($(compgen -W "off error warn info debug trace" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
         rom__subcmd__weaver__subcmd__tools)
             opts="-v -q -y -h --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help ppf-undo help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
@@ -2665,7 +2757,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__weave)
-            opts="-i -s -o -j -n -v -q -y -h --input --select --target --filter --no-extract --no-ignore --patch --output --bundle --with --without --raw --no-compress --format --compress-format --codec --compress-codec --level --compress-level --assume-in --expect-in --patch-header --patch-basis --output-header --repair-checksum --n64-byte-order --ignore-checksum-validation --expect-out --code --code-system --code-kind --emit-bundle --tui --threads --force --dry-run --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
+            opts="-i -s -o -j -n -v -q -y -h --input --select --target --filter --no-extract --no-ignore --patch --patch-select --output --bundle --with --without --raw --no-compress --format --compress-format --codec --compress-codec --level --compress-level --assume-in --expect-in --patch-header --patch-basis --output-header --repair-checksum --n64-byte-order --ignore-checksum-validation --expect-out --code --code-system --code-kind --emit-bundle --tui --threads --force --dry-run --json --progress --no-progress --log-level --verbose --quiet --dep-trace --color --no-color --yes --help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -2699,6 +2791,10 @@ _rom__weaver() {
                     COMPREPLY=($(compgen -f "${cur}"))
                     return 0
                     ;;
+                --patch-select)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
                 --output)
                     COMPREPLY=($(compgen -f "${cur}"))
                     return 0