@rom-weaver/cli 0.10.2 → 0.11.1

package/docs/completions/rom-weaver.elv

@@ -0,0 +1,763 @@
+
+use builtin;
+use str;
+
+set edit:completion:arg-completer[rom-weaver] = {|@words|
+    fn spaces {|n|
+        builtin:repeat $n ' ' | str:join ''
+    }
+    fn cand {|text desc|
+        edit:complex-candidate $text &display=$text' '(spaces (- 14 (wcswidth $text)))$desc
+    }
+    var command = 'rom-weaver'
+    for word $words[1..-1] {
+        if (str:has-prefix $word '-') {
+            break
+        }
+        set command = $command';'$word
+    }
+    var completions = [
+        &'rom-weaver'= {
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+            cand -V 'Print version'
+            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 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 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'
+            cand tools 'One-off recovery tools'
+            cand plan-extract-batch 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
+            cand weave 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
+            cand completions 'Print a tab-completion script for your shell'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;probe'= {
+            cand -i 'File to identify. Use - to read from stdin'
+            cand --input 'File to identify. Use - to read from stdin'
+            cand -s 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; identify the file itself'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;inspect'= {
+            cand -i 'File to identify. Use - to read from stdin'
+            cand --input 'File to identify. Use - to read from stdin'
+            cand -s 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; identify the file itself'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            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 -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)'
+            cand -o 'Directory to write the extracted files into'
+            cand --output 'Directory to write the extracted files into'
+            cand --checksum 'Also hash every extracted file (repeatable, comma-separable)'
+            cand --checksum-rom 'Like --checksum, but hash only the ROMs and skip sidecar files. Ignored when --checksum is also given'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --split-bin 'Write a CD-format CHD as a CUE plus one BIN per track (*.trackNN.bin), rather than one merged BIN'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --no-nested-extract 'Stop after one layer; leave any archive found inside the input packed'
+            cand --force 'Overwrite files already in the output directory (without this, extraction stops instead)'
+            cand --probe 'Also report the format and platform of what was extracted, and fail if a lone payload matches no known platform'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;checksum'= {
+            cand -i 'File to hash. Use - to read from stdin'
+            cand --input 'File to hash. Use - to read from stdin'
+            cand -a 'Which checksum to compute: crc32, md5, sha1, sha256, blake3, crc32c, crc16, or adler32 (repeatable, comma-separable)'
+            cand --algo 'Which checksum to compute: crc32, md5, sha1, sha256, blake3, crc32c, crc16, or adler32 (repeatable, comma-separable)'
+            cand -s 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --start 'Start hashing at this byte offset, counting from 0'
+            cand --length 'How many bytes to hash from --start. Defaults to the rest of the file'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; hash the file itself'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --no-trim-fix 'Skip the extra checksums computed for how a trimmable ROM would hash trimmed or untrimmed'
+            cand --probe 'Also report the platform of the hashed bytes, and fail if it matches no known platform'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;ingest'= {
+            cand -i 'File to sort into ROMs and patches'
+            cand --input 'File to sort into ROMs and patches'
+            cand -o 'Directory to write anything unpacked along the way into'
+            cand --output 'Directory to write anything unpacked along the way into'
+            cand -s 'Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)'
+            cand --sidecar-name 'Optional loose patch names to match against `source` without ingesting it. This keeps the browser''s sibling-sidecar lookup on the ingest command surface while reusing Rust''s matcher'
+            cand --split-bin 'For a multi-track CD-format CHD, write one BIN per track (--split-bin) or one merged BIN (--split-bin false). Omit to be asked'
+            cand --checksum 'Which checksums to compute for each ROM found (repeatable, comma-separable) [default: crc32,md5,sha1]'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --sidecar-only 'sidecar-only'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --no-nested-extract 'Stop after one layer; leave any archive found inside the input packed'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;compress'= {
+            cand -i 'File to put in the archive; repeat for each one. For a disc image, pass the .cue or .gdi alone and its tracks come along'
+            cand --input 'File to put in the archive; repeat for each one. For a disc image, pass the .cue or .gdi alone and its tracks come along'
+            cand -f 'Output format, such as zip, 7z, chd, rvz, or z3ds [default: from the --output extension]'
+            cand --format 'Output format, such as zip, 7z, chd, rvz, or z3ds [default: from the --output extension]'
+            cand -o 'Where to write the archive'
+            cand --output 'Where to write the archive'
+            cand --codec 'Compression method to use, as codec or codec:level (repeatable, comma-separable)'
+            cand --level 'How hard to compress: min, very-low, low, medium, high, very-high, or max'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;trim'= {
+            cand -i 'File or folder to trim. Repeat for each one'
+            cand --input 'File or folder to trim. Repeat for each one'
+            cand -o 'Where to write the trimmed file. Only valid with a single trimmable input'
+            cand --output 'Where to write the trimmed file. Only valid with a single trimmable input'
+            cand -e 'Save next to each original under this extension. {ext} stands for the original one, as in trim.{ext}'
+            cand --extension 'Save next to each original under this extension. {ext} stands for the original one, as in trim.{ext}'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --in-place 'Overwrite the original instead of writing a new file'
+            cand -n 'Report what would be trimmed without writing anything'
+            cand --dry-run 'Report what would be trimmed without writing anything'
+            cand --revert 'Pad a trimmed file back to full size (NDS, GBA, and 3DS only)'
+            cand --untrim 'Pad a trimmed file back to full size (NDS, GBA, and 3DS only)'
+            cand --restore 'Pad a trimmed file back to full size (NDS, GBA, and 3DS only)'
+            cand --no-recursive 'When an input is a folder, look only at its top level'
+            cand --no-filter 'Consider every file inside an archive, not just the ones that look like ROMs'
+            cand --no-extract 'Do not look inside archives; trim only the files named directly'
+            cand --revert-marker 'Add a small footer recording what was cut, so --revert can restore the original exactly'
+            cand --reversible 'Add a small footer recording what was cut, so --revert can restore the original exactly'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;patch'= {
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help'
+            cand --help 'Print help'
+            cand apply 'Apply one or more patches to a ROM, in order'
+            cand weave 'Apply one or more patches to a ROM, in order'
+            cand validate 'Check that patches would apply cleanly, without writing anything'
+            cand create 'Build a patch from an original ROM and a changed one'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;patch;apply'= {
+            cand -i 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
+            cand --input 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --target 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --patch 'Patch to apply. Repeat once per patch; they run in the order given'
+            cand -o 'Where to write the patched ROM. Optional when a bundle already names the output'
+            cand --output 'Where to write the patched ROM. Optional when a bundle already names the output'
+            cand --bundle 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL'
+            cand --with 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)'
+            cand --without 'Turn off a bundle patch, matched by name or file name (repeatable)'
+            cand --compress-format 'Format to compress the patched ROM into [default: from the --output extension]'
+            cand --compress-codec 'Compression method to use, as codec or codec:level (repeatable, comma-separable)'
+            cand --compress-level 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]'
+            cand --assume-in 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --expect-in 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --patch-header 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]'
+            cand --patch-basis 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]'
+            cand --output-header 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]'
+            cand --n64-byte-order 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]'
+            cand --expect-out 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)'
+            cand --code 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code'
+            cand --code-system 'Console the --code values are for (nes, snes, genesis, gameboy), when the ROM header does not say'
+            cand --code-kind 'Which cheat scheme the --code values use: auto, game-genie, or gameshark/par'
+            cand --emit-bundle 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; treat the input and every patch as raw files'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --no-compress 'Write a plain ROM instead of compressing the result'
+            cand --repair-checksum 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)'
+            cand --ignore-checksum-validation 'Apply the patch even when its own checksums do not match. Can produce a broken ROM'
+            cand --tui 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;patch;weave'= {
+            cand -i 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
+            cand --input 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --target 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --patch 'Patch to apply. Repeat once per patch; they run in the order given'
+            cand -o 'Where to write the patched ROM. Optional when a bundle already names the output'
+            cand --output 'Where to write the patched ROM. Optional when a bundle already names the output'
+            cand --bundle 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL'
+            cand --with 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)'
+            cand --without 'Turn off a bundle patch, matched by name or file name (repeatable)'
+            cand --compress-format 'Format to compress the patched ROM into [default: from the --output extension]'
+            cand --compress-codec 'Compression method to use, as codec or codec:level (repeatable, comma-separable)'
+            cand --compress-level 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]'
+            cand --assume-in 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --expect-in 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --patch-header 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]'
+            cand --patch-basis 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]'
+            cand --output-header 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]'
+            cand --n64-byte-order 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]'
+            cand --expect-out 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)'
+            cand --code 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code'
+            cand --code-system 'Console the --code values are for (nes, snes, genesis, gameboy), when the ROM header does not say'
+            cand --code-kind 'Which cheat scheme the --code values use: auto, game-genie, or gameshark/par'
+            cand --emit-bundle 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; treat the input and every patch as raw files'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --no-compress 'Write a plain ROM instead of compressing the result'
+            cand --repair-checksum 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)'
+            cand --ignore-checksum-validation 'Apply the patch even when its own checksums do not match. Can produce a broken ROM'
+            cand --tui 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;patch;validate'= {
+            cand -i 'ROM to check the patches against. May be an archive'
+            cand --input 'ROM to check the patches against. May be an archive'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --patch 'Patch to check. Repeat once per patch; they are checked in the order given'
+            cand --assume-in 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --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'
+            cand --n64-byte-order 'Byte order to put an N64 ROM in before checking: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]'
+            cand --patch-basis 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]'
+            cand --patch-input-check 'Checksum the preceding --patch expects to see going in, when the patch does not carry one (comma-separable; empty means none)'
+            cand --patch-output-check 'Checksum the preceding --patch should produce, when the patch does not carry one (comma-separable; empty means none)'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; treat the input and every patch as raw files'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --strip-header 'Remove the ROM''s copier header before checking (A78, LNX, NES, FDS, SMC signatures, plus the SNES and PCE size rules)'
+            cand --ignore-checksum-validation 'Report a patch as usable even when its own checksums do not match'
+            cand --independent 'Check every patch against the original ROM rather than as a chain, and report a verdict for each instead of stopping at the first failure'
+            cand --plan 'Report the order the patches would run in and what each would be checked against, without reading the ROM more than needed'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;patch;create'= {
+            cand --original 'The unmodified ROM'
+            cand --modified 'The changed ROM. Leave out when using --code, which produces the changed ROM for you'
+            cand -f 'Patch format, such as bps, ips, or xdelta [default: from the --output extension]'
+            cand --format 'Patch format, such as bps, ips, or xdelta [default: from the --output extension]'
+            cand -o 'Where to write the patch. Required unless --plan is used'
+            cand --output 'Where to write the patch. Required unless --plan is used'
+            cand --assume-in 'Take the original ROM''s checksum on trust rather than reading the file, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --code 'Build the patch from a Game Genie or GameShark/Pro Action Replay code instead of a second ROM. Repeat for each code; cannot be used with --modified'
+            cand --code-system 'Console the --code values are for (nes, snes, genesis, gameboy), when the ROM header does not say'
+            cand --code-kind 'Which cheat scheme the --code values use: auto, game-genie, or gameshark/par'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --solid-system 'SOLID patches only: console the ROM is for'
+            cand --solid-game 'SOLID patches only: name of the game'
+            cand --solid-hack 'SOLID patches only: name of the hack'
+            cand --solid-version 'SOLID patches only: version of the hack. Switches the patch to its extended header'
+            cand --solid-author 'SOLID patches only: who made the hack. Switches the patch to its extended header'
+            cand --solid-contact 'SOLID patches only: how to reach the author. Switches the patch to its extended header'
+            cand --solid-comment 'SOLID patches only: free-form note. Switches the patch to its extended header'
+            cand --xdelta-secondary 'xdelta patches only: compress the patch''s own contents'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --plan 'Only report which formats suit these two ROMs; write nothing'
+            cand --ignore-checksum-validation 'Write the patch even when the format''s own consistency checks fail, and leave its checksums out'
+            cand --checksum-name 'Put the original ROM''s crc32 in the patch file name, as [crc32:HEX]'
+            cand --solid-extended 'SOLID patches only: use the extended header even with none of the extended fields filled in'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;patch;help'= {
+            cand apply 'Apply one or more patches to a ROM, in order'
+            cand validate 'Check that patches would apply cleanly, without writing anything'
+            cand create 'Build a patch from an original ROM and a changed one'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;patch;help;apply'= {
+        }
+        &'rom-weaver;patch;help;validate'= {
+        }
+        &'rom-weaver;patch;help;create'= {
+        }
+        &'rom-weaver;patch;help;help'= {
+        }
+        &'rom-weaver;bundle'= {
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help'
+            cand --help 'Print help'
+            cand create 'Write a rom-weaver-bundle.json recipe from local ROM and patch files'
+            cand parse 'Read a rom-weaver-bundle.json recipe and report what it points at'
+            cand schema 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;bundle;create'= {
+            cand -i 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle'
+            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 --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'
+            cand --patch-name 'Name to show for the preceding --patch'
+            cand --patch-description 'What the preceding --patch does'
+            cand --patch-author 'Who made the preceding --patch'
+            cand --patch-label 'Short status note for the preceding --patch, such as beta or recommended'
+            cand --patch-optional 'Mark the preceding --patch optional, so it starts switched off and needs --with to run'
+            cand --patch-source-url 'Where the preceding --patch can be downloaded from. The local file is still read to build the bundle'
+            cand --patch-header 'Whether the preceding --patch applies to the ROM with or without its copier header: auto, keep, or strip'
+            cand --patch-basis 'Which ROM the preceding --patch was built against: base (the bundle''s ROM) or previous (the patch before it). Use auto to leave it out and let apply infer it'
+            cand --patch-expect-in 'Checksum the ROM should have before the preceding --patch runs. Recorded only when it differs from the bundle''s ROM checksums (repeatable, comma-separable)'
+            cand --patch-expect-out 'Checksum the ROM should have after the preceding --patch runs. Recorded only when it differs from the final output checksums (repeatable, comma-separable)'
+            cand --expect-out 'Checksum the ROM should have once every patch has run, so users can confirm they got the right result (repeatable, comma-separable)'
+            cand --output-name 'File name the bundle suggests for the patched ROM'
+            cand --output-header 'Whether the patched ROM should keep its copier header: auto, keep, or strip'
+            cand -o 'Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it'
+            cand --output 'Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it'
+            cand --bundle 'Also pack the bundle and its ROM and patches into one shareable archive, such as release.zip'
+            cand --bundle-rom 'Pack this file into --bundle as the ROM, while --input supplies the checksums and metadata'
+            cand --checksum 'Which checksums to record for the ROM (repeatable) [default: crc32,md5,sha1]'
+            cand --from 'Build the bundle from a hand-written rom-weaver-bundle.json instead of flags. Use - to read it from stdin'
+            cand --schema-ref 'Record this $schema URL in the bundle so editors can validate it. Left out unless asked for'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-bundle-rom 'Keep the ROM out of --bundle and record only its checksums, so whoever applies the bundle brings their own copy'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;bundle;parse'= {
+            cand -i 'Bundle file, or an archive with a bundle at its root'
+            cand --input 'Bundle file, or an archive with a bundle at its root'
+            cand -s 'Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)'
+            cand --select 'Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)'
+            cand --filter 'Handle only the bundle''s rom entry or only its patch entries (repeatable, comma-separable)'
+            cand -o 'Directory to unpack the bundle''s files into. Without it, files packed in an archive are listed but not written out'
+            cand --output 'Directory to unpack the bundle''s files into. Without it, files packed in an archive are listed but not written out'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Report what the bundle contains without unpacking any of it'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;bundle;schema'= {
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;bundle;help'= {
+            cand create 'Write a rom-weaver-bundle.json recipe from local ROM and patch files'
+            cand parse 'Read a rom-weaver-bundle.json recipe and report what it points at'
+            cand schema 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;bundle;help;create'= {
+        }
+        &'rom-weaver;bundle;help;parse'= {
+        }
+        &'rom-weaver;bundle;help;schema'= {
+        }
+        &'rom-weaver;bundle;help;help'= {
+        }
+        &'rom-weaver;tools'= {
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help'
+            cand --help 'Print help'
+            cand ppf-undo 'Undo a PPF3 patch, using the undo data stored inside it'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;tools;ppf-undo'= {
+            cand -i 'The already-patched ROM to undo'
+            cand --input 'The already-patched ROM to undo'
+            cand --patch 'The PPF3 patch that was applied. It must carry undo data'
+            cand -o 'Where to write the restored ROM'
+            cand --output 'Where to write the restored ROM'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;tools;help'= {
+            cand ppf-undo 'Undo a PPF3 patch, using the undo data stored inside it'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;tools;help;ppf-undo'= {
+        }
+        &'rom-weaver;tools;help;help'= {
+        }
+        &'rom-weaver;plan-extract-batch'= {
+            cand --job-size 'Source size in bytes for one job; repeat once per job, in input order'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --max-concurrency 'Hard cap on jobs running at once; defaults to the thread budget'
+            cand --total-memory-bytes 'Total memory budget concurrent jobs may reserve (e.g. browser device memory); defaults to the platform''s physical memory'
+            cand --memory-ceiling-bytes 'Combined working-set ceiling to plan against, used verbatim (no fraction/clamp). The browser passes its own resolved, mobile-capped ceiling here; when set it overrides --total-memory-bytes'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help'
+            cand --help 'Print help'
+        }
+        &'rom-weaver;weave'= {
+            cand -i 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
+            cand --input 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand --target 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track'
+            cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
+            cand --patch 'Patch to apply. Repeat once per patch; they run in the order given'
+            cand -o 'Where to write the patched ROM. Optional when a bundle already names the output'
+            cand --output 'Where to write the patched ROM. Optional when a bundle already names the output'
+            cand --bundle 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL'
+            cand --with 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)'
+            cand --without 'Turn off a bundle patch, matched by name or file name (repeatable)'
+            cand --compress-format 'Format to compress the patched ROM into [default: from the --output extension]'
+            cand --compress-codec 'Compression method to use, as codec or codec:level (repeatable, comma-separable)'
+            cand --compress-level 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]'
+            cand --assume-in 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --expect-in 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)'
+            cand --patch-header 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]'
+            cand --patch-basis 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]'
+            cand --output-header 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]'
+            cand --n64-byte-order 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]'
+            cand --expect-out 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)'
+            cand --code 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code'
+            cand --code-system 'Console the --code values are for (nes, snes, genesis, gameboy), when the ROM header does not say'
+            cand --code-kind 'Which cheat scheme the --code values use: auto, game-genie, or gameshark/par'
+            cand --emit-bundle 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it'
+            cand -j 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --threads 'How many threads to use at most. auto uses every core; a format may still use fewer'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --no-extract 'Do not look inside archives; treat the input and every patch as raw files'
+            cand --no-ignore 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store'
+            cand --no-compress 'Write a plain ROM instead of compressing the result'
+            cand --repair-checksum 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)'
+            cand --ignore-checksum-validation 'Apply the patch even when its own checksums do not match. Can produce a broken ROM'
+            cand --tui 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'rom-weaver;completions'= {
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
+        &'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 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 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'
+            cand tools 'One-off recovery tools'
+            cand plan-extract-batch 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
+            cand weave 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
+            cand completions 'Print a tab-completion script for your shell'
+            cand help 'Print this message or the help of the given subcommand(s)'
+        }
+        &'rom-weaver;help;probe'= {
+        }
+        &'rom-weaver;help;extract'= {
+        }
+        &'rom-weaver;help;checksum'= {
+        }
+        &'rom-weaver;help;ingest'= {
+        }
+        &'rom-weaver;help;compress'= {
+        }
+        &'rom-weaver;help;trim'= {
+        }
+        &'rom-weaver;help;patch'= {
+            cand apply 'Apply one or more patches to a ROM, in order'
+            cand validate 'Check that patches would apply cleanly, without writing anything'
+            cand create 'Build a patch from an original ROM and a changed one'
+        }
+        &'rom-weaver;help;patch;apply'= {
+        }
+        &'rom-weaver;help;patch;validate'= {
+        }
+        &'rom-weaver;help;patch;create'= {
+        }
+        &'rom-weaver;help;bundle'= {
+            cand create 'Write a rom-weaver-bundle.json recipe from local ROM and patch files'
+            cand parse 'Read a rom-weaver-bundle.json recipe and report what it points at'
+            cand schema 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring'
+        }
+        &'rom-weaver;help;bundle;create'= {
+        }
+        &'rom-weaver;help;bundle;parse'= {
+        }
+        &'rom-weaver;help;bundle;schema'= {
+        }
+        &'rom-weaver;help;tools'= {
+            cand ppf-undo 'Undo a PPF3 patch, using the undo data stored inside it'
+        }
+        &'rom-weaver;help;tools;ppf-undo'= {
+        }
+        &'rom-weaver;help;plan-extract-batch'= {
+        }
+        &'rom-weaver;help;weave'= {
+        }
+        &'rom-weaver;help;completions'= {
+        }
+        &'rom-weaver;help;help'= {
+        }
+    ]
+    $completions[$command]
+}