@rom-weaver/cli 0.16.1 → 0.18.0

package/README.md

@@ -61,7 +61,7 @@ Open [rom-weaver.com/apply-patches](https://rom-weaver.com/apply-patches). Add y
 
 For offline use, first cache the app and any needed identify packs, cheat databases, and emulator cores. Remote files still need a connection. See [offline behavior](docs/explanation/local-first.md#offline) and [privacy](docs/legal/privacy.md).
 
-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.
+Start with [your first patch](docs/tutorials/first-patch.md) to practise on supplied homebrew files. Use the [task chooser](docs/README.md#choose-a-task) for the other browser workflows.
 
 ## Self-hosting
 
@@ -112,25 +112,18 @@ The CLI and browser share one Rust engine. Browser workers and storage add costs
 
 ## Features
 
-- **Apply and create patches.** Twenty-one formats, including IPS, BPS, UPS, xdelta/VCDIFF, PPF, RUP, BDF/BSDIFF40, APS, and DCP (Dreamcast), with ordered multi-patch chains, checksum validation when the format or bundle supplies expected values, and cheat-code baking. Three of them (DCP, BSP, and HDiffPatch) can only be applied, not created.
-- **Play and test in the browser.** Run supported games with EmulatorJS, including patched output. Keep game saves and save states in browser storage, and import or export them. See [browser testing](docs/how-to/test-roms-in-browser.md) and [supported platforms](docs/reference/formats.md#browser-emulator-support).
-- **Use cheat codes.** Select codes from the built-in database or enter your own. Bake supported ROM cheats into a game or export them as a patch. Codes that require runtime memory writes cannot be baked. See [browser cheats](docs/how-to/use-browser-cheats.md).
-- **Edit supported game saves.** The beta Save Editor inspects and edits supported fields, validates checksums, and writes an edited copy. Game and layout support is specific; emulator save states are not editable game saves. See the [Save Editor reference](docs/reference/save-editor.md) and [CLI save guide](docs/how-to/cli-save.md).
-- **Inspect and extract containers.** ZIP, 7z, RAR, the tar family, CHD, RVZ, Z3DS, CSO, PBP, GCZ, WIA, WBFS, and more, including nested archives.
-- **Create format-specific compressed containers.** ZIP, 7z, CHD, RVZ, and Z3DS with codec-aware compression settings. CHD and RVZ outputs are checked for round-trip compatibility with chdman and dolphin-tool.
-- **Checksum and verify.** CRC32, MD5, SHA-1, SHA-256, BLAKE3, and friends, with copier-header detection, header repair, and header-aware checksum variants.
-- **Trim and restore.** Trimming for NDS, GBA, 3DS, XISO, and RVZ scrub. NDS, GBA, and 3DS can be padded back out. An optional footer records the original length and one padding byte; exact restoration has [limits](docs/how-to/cli-trim.md#make-the-trim-reversible).
-- **Share workflows.** Distributable [`rom-weaver-bundle.json`](./docs/rom-weaver-bundle-v2.schema.json) bundles pin patch order, checksums, and output naming so others can replay the exact workflow.
-- **Local-first and private.** Everything runs on your machine. The webapp is an installable PWA that works offline with cached assets. Your files are never uploaded, and rom-weaver sends no telemetry.
-- **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.
+- **Change games.** Apply or create patches, arrange patch chains, bake supported cheats, and share patch bundles.
+- **Prepare files.** Identify games and revisions, compare checksums, extract archives, convert containers, compress files, trim padding, and undo PPF3 patches with undo data.
+- **Play and manage progress.** Test supported games in the browser. Import or export emulator saves, edit supported game saves, and create fresh supported saves.
+- **Work locally.** Process files without uploads or accounts. Cached app assets work offline; CLI commands support scripts and JSON output.
 
-The complete format, codec, and checksum compatibility tables are maintained in [Supported formats](./docs/reference/formats.md).
+The [plain-language feature map](docs/reference/features.md) links every feature to its browser or CLI guide. Exact limits live in the [format tables](docs/reference/formats.md), [cheat reference](docs/reference/cheat-database.md), and [save reference](docs/reference/save-editor.md).
 
 ## Notices
 
 ### Beta status
 
-rom-weaver is beta software and follows Semantic Versioning, but until v1.0, breaking changes may still happen between minor releases. Patching, compressing, extracting, and bundling are covered by automated tests. Hands-on testing happens on macOS and Linux; Windows is covered by hosted CI but has seen much less real-world use, so expect rougher edges there and please report anything Windows-specific. If you rely on the APIs or CLI flags, expect things to be a bit tougher: those interfaces may still change as the project heads toward v1.0. Trim and Tools are still beta, so they are disabled by default in the webapp and can be enabled in Settings. The `rom-weaver-core`, `-checksum`, `-containers`, and `-patches` crates are published to crates.io only so `rom-weaver-cli` can use them. The CLI and the webapp are the supported interfaces; using those crates as libraries in another project is not supported.
+rom-weaver is beta software and follows Semantic Versioning, but until v1.0, breaking changes may still happen between minor releases. Patching, compressing, extracting, and bundling are covered by automated tests. Hands-on testing happens on macOS and Linux; Windows is covered by hosted CI but has seen much less real-world use, so expect rougher edges there and please report anything Windows-specific. If you rely on the APIs or CLI flags, expect things to be a bit tougher: those interfaces may still change as the project heads toward v1.0. Some browser features are hidden behind [the beta setting](docs/how-to/browser-settings.md#enable-beta-tools). The [feature map](docs/reference/features.md#app-and-automation) lists them. The `rom-weaver-core`, `-checksum`, `-containers`, and `-patches` crates are published to crates.io only so `rom-weaver-cli` can use them. The CLI and the webapp are the supported interfaces; using those crates as libraries in another project is not supported.
 
 ### First complete public release
 
@@ -146,7 +139,7 @@ Localized translations are early and may be entirely wrong in places. Manual edi
 
 ## Screenshots
 
-[View every screenshot at full size.](./docs/development/screenshots.md)
+[Screenshot inventory and capture instructions.](./docs/development/screenshots.md)
 
 <table>
   <thead>
@@ -197,7 +190,7 @@ Localized translations are early and may be entirely wrong in places. Manual edi
 
 ## Documentation
 
-Start with the browser-first [documentation home](https://rom-weaver.com/docs) or the repository [documentation index](./docs/README.md). The web docs include a task and tool picker, guided samples, focused screenshots, and a [FAQ](./docs/faq.md). CLI, deployment, integration, development, architecture, and format references each have their own guides.
+Start with the browser-first [documentation home](https://rom-weaver.com/docs) or the repository [documentation index](./docs/README.md). Both link to the task chooser, feature map, guided samples, and [FAQ](./docs/faq.md). CLI, deployment, integration, development, architecture, and format references have their own pages.
 
 ## Contributing and support
 

package/docs/completions/_rom-weaver

@@ -440,6 +440,7 @@ _arguments "${_arguments_options[@]}" : \
 '(-v --verbose --debug -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: warn\]]:LOG_LEVEL:(off error warn info debug trace)' \
 '--no-extract[Do not look inside archives; identify the file itself]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
+'--split-bin[List per-track BIN files for a CD-format CHD]' \
 '-n[Plan the command without changing files or downloading data]' \
 '--dry-run[Plan the command without changing files or downloading data]' \
 '(--jsonl)--json[Print one complete JSON report; progress and diagnostics use stderr]' \
@@ -471,6 +472,7 @@ _arguments "${_arguments_options[@]}" : \
 '(-v --verbose --debug -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: warn\]]:LOG_LEVEL:(off error warn info debug trace)' \
 '--no-extract[Do not look inside archives; identify the file itself]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
+'--split-bin[List per-track BIN files for a CD-format CHD]' \
 '-n[Plan the command without changing files or downloading data]' \
 '--dry-run[Plan the command without changing files or downloading data]' \
 '(--jsonl)--json[Print one complete JSON report; progress and diagnostics use stderr]' \
@@ -1022,6 +1024,7 @@ _arguments "${_arguments_options[@]}" : \
 ;;
 (compress)
 _arguments "${_arguments_options[@]}" : \
+'*--entry-name=[]:ENTRY_NAMES:_default' \
 '-f+[Output format, such as zip, 7z, chd, rvz, or z3ds \[default\: from the --output extension\]]:FORMAT:(zip 7z chd rvz z3ds)' \
 '--format=[Output format, such as zip, 7z, chd, rvz, or z3ds \[default\: from the --output extension\]]:FORMAT:(zip 7z chd rvz z3ds)' \
 '*--codec=[Compression method to use, as codec or codec\:level (repeatable, comma-separable)]:CODEC:(store deflate zstd lzma lzma2 zlib huff flac cdzs cdlz cdzl cdfl avhuff)' \
@@ -1130,7 +1133,7 @@ _arguments "${_arguments_options[@]}" : \
 '*--expect-out=[Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--code=[Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code]:CODES:_default' \
 '--code-system=[Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_default' \
-'--code-kind=[Which cheat scheme the --code values use\: auto, game-genie, gameshark/par, or xploder]:CODE_KIND:_default' \
+'--code-kind=[Cheat scheme\: auto, game-genie, gameshark/par, xploder, pro-action-rocky, gold-finger, game-shark-v1\[-raw\], or action-replay-v3\[-raw\]]:CODE_KIND:_default' \
 '*--cheat=[Database cheat to use, by record ID or exact description. Repeat for each cheat]:ID_OR_DESCRIPTION:_default' \
 '--cheat-database=[Directory holding manifest.json and the <system>.json cheat shards. Defaults to \$ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory]:DIR:_files' \
 '--cheat-system=[Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say]:SYS:_default' \
@@ -1278,7 +1281,7 @@ _arguments "${_arguments_options[@]}" : \
 '*--expect-out=[Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--code=[Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code]:CODES:_default' \
 '--code-system=[Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_default' \
-'--code-kind=[Which cheat scheme the --code values use\: auto, game-genie, gameshark/par, or xploder]:CODE_KIND:_default' \
+'--code-kind=[Cheat scheme\: auto, game-genie, gameshark/par, xploder, pro-action-rocky, gold-finger, game-shark-v1\[-raw\], or action-replay-v3\[-raw\]]:CODE_KIND:_default' \
 '*--cheat=[Database cheat to use, by record ID or exact description. Repeat for each cheat]:ID_OR_DESCRIPTION:_default' \
 '--cheat-database=[Directory holding manifest.json and the <system>.json cheat shards. Defaults to \$ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory]:DIR:_files' \
 '--cheat-system=[Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say]:SYS:_default' \
@@ -1350,7 +1353,7 @@ _arguments "${_arguments_options[@]}" : \
 '*--expect-out=[Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--code=[Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code]:CODES:_default' \
 '--code-system=[Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_default' \
-'--code-kind=[Which cheat scheme the --code values use\: auto, game-genie, gameshark/par, or xploder]:CODE_KIND:_default' \
+'--code-kind=[Cheat scheme\: auto, game-genie, gameshark/par, xploder, pro-action-rocky, gold-finger, game-shark-v1\[-raw\], or action-replay-v3\[-raw\]]:CODE_KIND:_default' \
 '*--cheat=[Database cheat to use, by record ID or exact description. Repeat for each cheat]:ID_OR_DESCRIPTION:_default' \
 '--cheat-database=[Directory holding manifest.json and the <system>.json cheat shards. Defaults to \$ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory]:DIR:_files' \
 '--cheat-system=[Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say]:SYS:_default' \
@@ -1400,7 +1403,7 @@ _arguments "${_arguments_options[@]}" : \
 '*--assume-in=[Take the original ROM'\''s checksum on trust rather than reading the file, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--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]:CODES:_default' \
 '--code-system=[Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_default' \
-'--code-kind=[Which cheat scheme the --code values use\: auto, game-genie, gameshark/par, or xploder]:CODE_KIND:_default' \
+'--code-kind=[Cheat scheme\: auto, game-genie, gameshark/par, xploder, pro-action-rocky, gold-finger, game-shark-v1\[-raw\], or action-replay-v3\[-raw\]]:CODE_KIND:_default' \
 '*--cheat=[Database cheat to use, by record ID or exact description. Repeat for each cheat]:ID_OR_DESCRIPTION:_default' \
 '--cheat-database=[Directory holding manifest.json and the <system>.json cheat shards. Defaults to \$ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory]:DIR:_files' \
 '--cheat-system=[Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say]:SYS:_default' \
@@ -1511,7 +1514,59 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-save-command-$line[1]:"
         case $line[1] in
-            (identify)
+            (list-games)
+_arguments "${_arguments_options[@]}" : \
+'(-v --verbose --debug -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: warn\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-n[Plan the command without changing files or downloading data]' \
+'--dry-run[Plan the command without changing files or downloading data]' \
+'(--jsonl)--json[Print one complete JSON report; progress and diagnostics use stderr]' \
+'(--json)--jsonl[Stream JSON events, including progress, one object per line]' \
+'(--no-progress)--progress[Show progress on stderr (off by default; JSONL includes progress)]' \
+'(--progress)--no-progress[Hide progress]' \
+'(--log-level --debug)*-v[Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)]' \
+'(--log-level --debug)*--verbose[Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)]' \
+'(--log-level -v --verbose -q --quiet)--debug[Show developer diagnostics and trace events on stderr (same as -vvv)]' \
+'(--log-level --debug)-q[Hide optional diagnostics and progress; keep results, warnings, and errors]' \
+'(--log-level --debug)--quiet[Hide optional diagnostics and progress; keep results, warnings, and errors]' \
+'--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]' \
+'--help[Print help]' \
+&& ret=0
+;;
+(create)
+_arguments "${_arguments_options[@]}" : \
+'--game=[Game to generate or use with a template]:GAME_ID:_default' \
+'--template=[Existing save to copy before setting fields]:SAVE:_files' \
+'-o+[Where to write the new save]:PATH:_files' \
+'--output=[Where to write the new save]:PATH:_files' \
+'(-v --verbose --debug -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: warn\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-n[Check the new save without writing it]' \
+'--dry-run[Check the new save without writing it]' \
+'--force[Replace an existing output file]' \
+'(--jsonl)--json[Print one complete JSON report; progress and diagnostics use stderr]' \
+'(--json)--jsonl[Stream JSON events, including progress, one object per line]' \
+'(--no-progress)--progress[Show progress on stderr (off by default; JSONL includes progress)]' \
+'(--progress)--no-progress[Hide progress]' \
+'(--log-level --debug)*-v[Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)]' \
+'(--log-level --debug)*--verbose[Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)]' \
+'(--log-level -v --verbose -q --quiet)--debug[Show developer diagnostics and trace events on stderr (same as -vvv)]' \
+'(--log-level --debug)-q[Hide optional diagnostics and progress; keep results, warnings, and errors]' \
+'(--log-level --debug)--quiet[Hide optional diagnostics and progress; keep results, warnings, and errors]' \
+'--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]' \
+'--help[Print help]' \
+'*::assignments -- Save property to set in the new file:_default' \
+&& ret=0
+;;
+(identify)
 _arguments "${_arguments_options[@]}" : \
 '--game=[Force a game id instead of detecting one]:GAME_ID:_default' \
 '--rom-sha1=[SHA-1 of the matching ROM, used to pick a game]:SHA1:_default' \
@@ -1658,7 +1713,15 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-save-help-command-$line[1]:"
         case $line[1] in
-            (identify)
+            (list-games)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(create)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(identify)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -1977,7 +2040,15 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-help-save-command-$line[1]:"
         case $line[1] in
-            (identify)
+            (list-games)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(create)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(identify)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -2343,6 +2414,8 @@ _rom-weaver__subcmd__help__subcmd__probe_commands() {
 (( $+functions[_rom-weaver__subcmd__help__subcmd__save_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__save_commands() {
     local commands; commands=(
+'list-games:List supported games and fresh save generation support' \
+'create:Create a fresh save or a copy of an existing save template' \
 'identify:Identify a supported game save without changing it' \
 'inspect:Show the sections and fields in a supported game save' \
 'get:Read one field from a supported game save' \
@@ -2351,6 +2424,11 @@ _rom-weaver__subcmd__help__subcmd__save_commands() {
     )
     _describe -t commands 'rom-weaver help save commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__create_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__save__subcmd__create_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help save create commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__export-schema_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__save__subcmd__export-schema_commands() {
     local commands; commands=()
@@ -2371,6 +2449,11 @@ _rom-weaver__subcmd__help__subcmd__save__subcmd__inspect_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver help save inspect commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__list-games_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__save__subcmd__list-games_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help save list-games commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__set_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__save__subcmd__set_commands() {
     local commands; commands=()
@@ -2690,6 +2773,8 @@ _rom-weaver__subcmd__probe_commands() {
 (( $+functions[_rom-weaver__subcmd__save_commands] )) ||
 _rom-weaver__subcmd__save_commands() {
     local commands; commands=(
+'list-games:List supported games and fresh save generation support' \
+'create:Create a fresh save or a copy of an existing save template' \
 'identify:Identify a supported game save without changing it' \
 'inspect:Show the sections and fields in a supported game save' \
 'get:Read one field from a supported game save' \
@@ -2699,6 +2784,11 @@ _rom-weaver__subcmd__save_commands() {
     )
     _describe -t commands 'rom-weaver save commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__save__subcmd__create_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__create_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save create commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__save__subcmd__export-schema_commands] )) ||
 _rom-weaver__subcmd__save__subcmd__export-schema_commands() {
     local commands; commands=()
@@ -2712,6 +2802,8 @@ _rom-weaver__subcmd__save__subcmd__get_commands() {
 (( $+functions[_rom-weaver__subcmd__save__subcmd__help_commands] )) ||
 _rom-weaver__subcmd__save__subcmd__help_commands() {
     local commands; commands=(
+'list-games:List supported games and fresh save generation support' \
+'create:Create a fresh save or a copy of an existing save template' \
 'identify:Identify a supported game save without changing it' \
 'inspect:Show the sections and fields in a supported game save' \
 'get:Read one field from a supported game save' \
@@ -2721,6 +2813,11 @@ _rom-weaver__subcmd__save__subcmd__help_commands() {
     )
     _describe -t commands 'rom-weaver save help commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__create_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help__subcmd__create_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save help create commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__export-schema_commands] )) ||
 _rom-weaver__subcmd__save__subcmd__help__subcmd__export-schema_commands() {
     local commands; commands=()
@@ -2746,6 +2843,11 @@ _rom-weaver__subcmd__save__subcmd__help__subcmd__inspect_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver save help inspect commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__list-games_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help__subcmd__list-games_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save help list-games commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__set_commands] )) ||
 _rom-weaver__subcmd__save__subcmd__help__subcmd__set_commands() {
     local commands; commands=()
@@ -2761,6 +2863,11 @@ _rom-weaver__subcmd__save__subcmd__inspect_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver save inspect commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__save__subcmd__list-games_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__list-games_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save list-games commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__save__subcmd__set_commands] )) ||
 _rom-weaver__subcmd__save__subcmd__set_commands() {
     local commands; commands=()

package/docs/completions/rom-weaver.bash

@@ -205,6 +205,9 @@ _rom__weaver() {
             rom__weaver__subcmd__help__subcmd__patch,validate)
                 cmd="rom__weaver__subcmd__help__subcmd__patch__subcmd__validate"
                 ;;
+            rom__weaver__subcmd__help__subcmd__save,create)
+                cmd="rom__weaver__subcmd__help__subcmd__save__subcmd__create"
+                ;;
             rom__weaver__subcmd__help__subcmd__save,export-schema)
                 cmd="rom__weaver__subcmd__help__subcmd__save__subcmd__export__subcmd__schema"
                 ;;
@@ -217,6 +220,9 @@ _rom__weaver() {
             rom__weaver__subcmd__help__subcmd__save,inspect)
                 cmd="rom__weaver__subcmd__help__subcmd__save__subcmd__inspect"
                 ;;
+            rom__weaver__subcmd__help__subcmd__save,list-games)
+                cmd="rom__weaver__subcmd__help__subcmd__save__subcmd__list__subcmd__games"
+                ;;
             rom__weaver__subcmd__help__subcmd__save,set)
                 cmd="rom__weaver__subcmd__help__subcmd__save__subcmd__set"
                 ;;
@@ -349,6 +355,9 @@ _rom__weaver() {
             rom__weaver__subcmd__patch__subcmd__help,validate)
                 cmd="rom__weaver__subcmd__patch__subcmd__help__subcmd__validate"
                 ;;
+            rom__weaver__subcmd__save,create)
+                cmd="rom__weaver__subcmd__save__subcmd__create"
+                ;;
             rom__weaver__subcmd__save,export-schema)
                 cmd="rom__weaver__subcmd__save__subcmd__export__subcmd__schema"
                 ;;
@@ -364,9 +373,15 @@ _rom__weaver() {
             rom__weaver__subcmd__save,inspect)
                 cmd="rom__weaver__subcmd__save__subcmd__inspect"
                 ;;
+            rom__weaver__subcmd__save,list-games)
+                cmd="rom__weaver__subcmd__save__subcmd__list__subcmd__games"
+                ;;
             rom__weaver__subcmd__save,set)
                 cmd="rom__weaver__subcmd__save__subcmd__set"
                 ;;
+            rom__weaver__subcmd__save__subcmd__help,create)
+                cmd="rom__weaver__subcmd__save__subcmd__help__subcmd__create"
+                ;;
             rom__weaver__subcmd__save__subcmd__help,export-schema)
                 cmd="rom__weaver__subcmd__save__subcmd__help__subcmd__export__subcmd__schema"
                 ;;
@@ -382,6 +397,9 @@ _rom__weaver() {
             rom__weaver__subcmd__save__subcmd__help,inspect)
                 cmd="rom__weaver__subcmd__save__subcmd__help__subcmd__inspect"
                 ;;
+            rom__weaver__subcmd__save__subcmd__help,list-games)
+                cmd="rom__weaver__subcmd__save__subcmd__help__subcmd__list__subcmd__games"
+                ;;
             rom__weaver__subcmd__save__subcmd__help,set)
                 cmd="rom__weaver__subcmd__save__subcmd__help__subcmd__set"
                 ;;
@@ -874,12 +892,16 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__compress)
-            opts="-f -j -i -o -n -v -q -y -h --format --codec --level --force --threads --stdin-name --input --output --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
+            opts="-f -j -i -o -n -v -q -y -h --entry-name --format --codec --level --force --threads --stdin-name --input --output --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --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
+                --entry-name)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
                 --format)
                     COMPREPLY=($(compgen -W "zip 7z chd rvz z3ds" -- "${cur}"))
                     return 0
@@ -1458,7 +1480,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__help__subcmd__save)
-            opts="identify inspect get export-schema set"
+            opts="list-games create identify inspect get export-schema set"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -1471,6 +1493,20 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__help__subcmd__save__subcmd__create)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; 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__save__subcmd__export__subcmd__schema)
             opts=""
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
@@ -1527,6 +1563,20 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__help__subcmd__save__subcmd__list__subcmd__games)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; 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__save__subcmd__set)
             opts=""
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
@@ -2840,7 +2890,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__probe)
-            opts="-s -i -n -v -q -y -h --select --filter --no-extract --no-ignore --input --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
+            opts="-s -i -n -v -q -y -h --select --filter --no-extract --no-ignore --split-bin --input --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -2878,7 +2928,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__save)
-            opts="-n -v -q -y -h --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help identify inspect get export-schema set help"
+            opts="-n -v -q -y -h --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help list-games create identify inspect get export-schema set help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -2895,6 +2945,40 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__save__subcmd__create)
+            opts="-o -n -v -q -y -h --game --template --output --dry-run --force --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --game)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
+                --template)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
+                --output)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
+                -o)
+                    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__save__subcmd__export__subcmd__schema)
             opts="-n -v -q -y -h --game --rom-sha1 --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
@@ -2948,7 +3032,7 @@ _rom__weaver() {
             return 0
             ;;
         rom__subcmd__weaver__subcmd__save__subcmd__help)
-            opts="identify inspect get export-schema set help"
+            opts="list-games create identify inspect get export-schema set help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
                 COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                 return 0
@@ -2961,6 +3045,20 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__save__subcmd__help__subcmd__create)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; 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__save__subcmd__help__subcmd__export__subcmd__schema)
             opts=""
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
@@ -3031,6 +3129,20 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__save__subcmd__help__subcmd__list__subcmd__games)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; 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__save__subcmd__help__subcmd__set)
             opts=""
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
@@ -3097,6 +3209,24 @@ _rom__weaver() {
             COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
             return 0
             ;;
+        rom__subcmd__weaver__subcmd__save__subcmd__list__subcmd__games)
+            opts="-n -v -q -y -h --dry-run --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --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__save__subcmd__set)
             opts="-n -o -v -q -y -h --game --rom-sha1 --dry-run --force --output --json --jsonl --progress --no-progress --log-level --verbose --debug --quiet --dep-trace --color --no-color --yes --help"
             if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then