@rom-weaver/cli 0.15.0 → 0.16.0

package/docs/completions/_rom-weaver

@@ -15,14 +15,18 @@ _rom-weaver() {
 
     local context curcontext="$curcontext" state line
     _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -41,23 +45,63 @@ _rom-weaver() {
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-command-$line[1]:"
         case $line[1] in
-            (probe)
+            (setup)
 _arguments "${_arguments_options[@]}" : \
-'-i+[File to identify. Use - to read from stdin]:INPUT:_files' \
-'--input=[File to identify. Use - to read from stdin]:INPUT:_files' \
-'*-s+[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--no-extract[Do not look inside archives; identify the file itself]' \
+'--database-dir=[Install into this directory instead of the per-user data directory]:DIR:_files' \
+'--from=[Local rom-weaver-identify-data.tar.br; omit to download the archive for this version]:ARCHIVE:_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)' \
+'--force[Download the database again even when it is already installed]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
+(ingest)
+_arguments "${_arguments_options[@]}" : \
+'-i+[File to sort into ROMs and patches]:INPUT:_files' \
+'--input=[File to sort into ROMs and patches]:INPUT:_files' \
+'-o+[Directory to write anything unpacked along the way into]:DIR:_files' \
+'--output=[Directory to write anything unpacked along the way into]:DIR:_files' \
+'*-d+[RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)]:PACK:_files' \
+'*--database=[RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)]:PACK:_files' \
+'*-s+[Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*--select=[Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*--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]:SIDECAR_NAMES:_default' \
+'--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]::SPLIT_BIN:(true false)' \
+'*--checksum=[Which checksums to compute for each ROM found (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'*--algo=[Which checksums to compute for each ROM found (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'(-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)' \
+'--sidecar-only[]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'--no-nested-extract[Stop after one layer; leave any archive found inside the input packed]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -67,23 +111,346 @@ _arguments "${_arguments_options[@]}" : \
 '--help[Print help (see more with '\''--help'\'')]' \
 && ret=0
 ;;
-(inspect)
+(cheat)
+_arguments "${_arguments_options[@]}" : \
+'-i+[The ROM the cheats are for. Its header picks the cheat shard and its bytes decide each cheat'\''s delivery]:ROM:_files' \
+'--input=[The ROM the cheats are for. Its header picks the cheat shard and its bytes decide each cheat'\''s delivery]:ROM:_files' \
+'*--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' \
+'--game=[Use this database game ID instead of matching the ROM by checksum or title]:ID:_default' \
+'(-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)' \
+'--allow-cheat-conflicts[Let a later cheat overwrite an earlier one at the same offset instead of failing]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+':action -- list\: print the matched game'\''s cheats:((list\:"Print the cheats the database holds for the input ROM"))' \
+&& ret=0
+;;
+(bundle)
+_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]' \
+":: :_rom-weaver__subcmd__bundle_commands" \
+"*::: :->bundle" \
+&& ret=0
+
+    case $state in
+    (bundle)
+        words=($line[1] "${words[@]}")
+        (( CURRENT += 1 ))
+        curcontext="${curcontext%:*:*}:rom-weaver-bundle-command-$line[1]:"
+        case $line[1] in
+            (create)
+_arguments "${_arguments_options[@]}" : \
+'-i+[ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle]:INPUT:_files' \
+'--input=[ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle]:INPUT:_files' \
+'*--assume-in=[Take the ROM'\''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'--rom-url=[Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url]:ROM_URL:_default' \
+'--rom-name=[Expected source ROM file name to show and use for output naming; a mismatch is advisory]:ROM_NAME:_default' \
+'--rom-member=[Use this exact archive member or disc track as the bundle ROM target]:ROM_MEMBER:_default' \
+'*--patch=[Patch to list in the bundle. Repeat once per patch, in the order they should be applied]:PATCH:_files' \
+'*--patch-id=[Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings]:PATCH_ID:_default' \
+'*--patch-version=[Version of the preceding --patch, in whatever form its author uses]:PATCH_VERSION:_default' \
+'*--patch-name=[Name to show for the preceding --patch]:PATCH_NAME:_default' \
+'*--patch-description=[What the preceding --patch does]:PATCH_DESCRIPTION:_default' \
+'*--patch-author=[Who made the preceding --patch]:PATCH_AUTHOR:_default' \
+'*--patch-label=[Short status note for the preceding --patch, such as beta or recommended]:PATCH_LABEL:_default' \
+'*--patch-optional=[Mark the preceding --patch optional, so it starts switched off and needs --with to run]:PATCH_OPTIONAL:(true false)' \
+'*--patch-source-url=[Where the preceding --patch can be downloaded from. The local file is still read to build the bundle]:PATCH_SOURCE_URL:_default' \
+'*--patch-header=[Whether the preceding --patch applies to the ROM with or without its copier header\: auto, keep, or strip]:PATCH_HEADER:(keep strip auto)' \
+'*--patch-basis=[Override the preceding --patch input rule\: base or previous. Use auto to inherit the bundle rule]:PATCH_BASIS:(auto base previous)' \
+'--default-patch-basis=[Shared input ROM rule recorded in the v2 bundle\: auto, base, or previous \[default\: auto\]]:DEFAULT_PATCH_BASIS:(auto base previous)' \
+'*--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)]:ALGO=HEX:_default' \
+'*--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)]:ALGO=HEX:_default' \
+'*--expect-out=[Checksum the ROM should have once every patch has run, so users can confirm they got the right result (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'--output-name=[File name the bundle suggests for the patched ROM]:OUTPUT_NAME:_default' \
+'--output-header=[Whether the patched ROM should keep its copier header\: auto, keep, or strip]:OUTPUT_HEADER:(keep strip auto)' \
+'*--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' \
+'--game=[Use this database game ID instead of matching the ROM by checksum or title]:ID:_default' \
+'-o+[Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it]:OUTPUT:_files' \
+'--output=[Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it]:OUTPUT:_files' \
+'--bundle=[Also pack the bundle and its ROM and patches into one shareable archive, such as release.zip]:BUNDLE:_files' \
+'--bundle-rom=[Pack this file into --bundle as the ROM, while --input supplies the checksums and metadata]:BUNDLE_ROM:_files' \
+'*--checksum=[Which checksums to record for the ROM (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'*--algo=[Which checksums to record for the ROM (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'--from=[Build the bundle from a hand-written rom-weaver-bundle.json instead of flags. Use - to read it from stdin]:FILE:_files' \
+'--schema-ref=[Record this \$schema URL in the bundle so editors can validate it. Left out unless asked for]:URL:_default' \
+'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'(-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)' \
+'--allow-cheat-conflicts[Let a later cheat overwrite an earlier one at the same offset instead of failing]' \
+'--no-bundle-rom[Keep the ROM out of --bundle and record only its checksums, so whoever applies the bundle brings their own copy]' \
+'--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
+(parse)
+_arguments "${_arguments_options[@]}" : \
+'-i+[Bundle file, or an archive with a bundle at its root]:INPUT:_files' \
+'--input=[Bundle file, or an archive with a bundle at its root]:INPUT:_files' \
+'*-s+[Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*--select=[Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*--filter=[Handle only the bundle'\''s rom entry or only its patch entries (repeatable, comma-separable)]:FILTER:(rom patch)' \
+'-o+[Directory to unpack the bundle'\''s files into. Without it, files packed in an archive are listed but not written out]:DIR:_files' \
+'--output=[Directory to unpack the bundle'\''s files into. Without it, files packed in an archive are listed but not written out]:DIR:_files' \
+'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'(-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[Report what the bundle contains without unpacking any of it]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
+(schema)
+_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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
+(help)
+_arguments "${_arguments_options[@]}" : \
+":: :_rom-weaver__subcmd__bundle__subcmd__help_commands" \
+"*::: :->help" \
+&& ret=0
+
+    case $state in
+    (help)
+        words=($line[1] "${words[@]}")
+        (( CURRENT += 1 ))
+        curcontext="${curcontext%:*:*}:rom-weaver-bundle-help-command-$line[1]:"
+        case $line[1] in
+            (create)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(parse)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(schema)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(help)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+        esac
+    ;;
+esac
+;;
+        esac
+    ;;
+esac
+;;
+(plan-extract-batch)
+_arguments "${_arguments_options[@]}" : \
+'*--job-size=[Source size in bytes for one job; repeat once per job, in input order]:BYTES:_default' \
+'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--max-concurrency=[Hard cap on jobs running at once; defaults to the thread budget]:MAX_CONCURRENCY:_default' \
+'--total-memory-bytes=[Total memory budget concurrent jobs may reserve (e.g. browser device memory); defaults to the platform'\''s physical memory]:TOTAL_MEMORY_BYTES:_default' \
+'--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]:MEMORY_CEILING_BYTES:_default' \
+'(-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
+;;
+(completions)
+_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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+':shell -- Shell to print completions for:(bash elvish fish powershell zsh)' \
+&& ret=0
+;;
+(man)
+_arguments "${_arguments_options[@]}" : \
+'--man-dir=[Directory to install pages into]:DIR:_files' \
+'(-v --verbose --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)' \
+'--install[Install the generated pages instead of printing one]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+'*::command -- Command path to print:_default' \
+&& ret=0
+;;
+(formats)
+_arguments "${_arguments_options[@]}" : \
+'(-v --verbose --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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
+(probe)
 _arguments "${_arguments_options[@]}" : \
-'-i+[File to identify. Use - to read from stdin]:INPUT:_files' \
-'--input=[File to identify. Use - to read from stdin]:INPUT:_files' \
 '*-s+[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
 '*--select=[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-i+[File to identify. Use - to read from stdin]:INPUT:_files' \
+'--input=[File to identify. Use - to read from stdin]:INPUT:_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)' \
 '--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]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -91,35 +458,30 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
+'::file -- File input; an alternative to -i, --input:_files' \
 && ret=0
 ;;
-(extract)
+(inspect)
 _arguments "${_arguments_options[@]}" : \
-'-i+[Archive or single-payload compressed format to unpack]:INPUT:_files' \
-'--input=[Archive or single-payload compressed format to unpack]:INPUT:_files' \
-'*-s+[Extract only these files, by exact name, prefix, or glob (repeatable). For example\: --select '\''game.disc0?.bin'\'']:SELECT:_default' \
-'*--select=[Extract only these files, by exact name, prefix, or glob (repeatable). For example\: --select '\''game.disc0?.bin'\'']:SELECT:_default' \
-'*--filter=[Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
-'-o+[Directory to write the extracted files into]:DIR:_files' \
-'--output=[Directory to write the extracted files into]:DIR:_files' \
-'*--checksum=[Also hash every extracted file (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
-'*--algo=[Also hash every extracted file (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
-'(--checksum)*--checksum-rom=[Like --checksum, but hash only the ROMs and skip sidecar files. Cannot be combined with --checksum]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
-'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--split-bin[Write a CD-format CHD as a CUE plus one BIN per track (*.trackNN.bin), rather than one merged BIN]' \
+'*-s+[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*--select=[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
+'*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
+'-i+[File to identify. Use - to read from stdin]:INPUT:_files' \
+'--input=[File to identify. Use - to read from stdin]:INPUT:_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)' \
+'--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]' \
-'--no-nested-extract[Stop after one layer; leave any archive found inside the input packed]' \
-'--force[Overwrite files already in the output directory (without this, extraction stops instead)]' \
-'--probe[Also report the format and platform of what was extracted, and fail if a lone payload matches no known platform]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -127,12 +489,11 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
+'::file -- File input; an alternative to -i, --input:_files' \
 && ret=0
 ;;
 (checksum)
 _arguments "${_arguments_options[@]}" : \
-'-i+[File to hash. Use - to read from stdin]:INPUT:_files' \
-'--input=[File to hash. Use - to read from stdin]:INPUT:_files' \
 '*-a+[Which checksum to compute (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
 '*--algo=[Which checksum to compute (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
 '*--checksum=[Which checksum to compute (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
@@ -143,18 +504,25 @@ _arguments "${_arguments_options[@]}" : \
 '--length=[How many bytes to hash from --start. Defaults to the rest of the file]:BYTES:_default' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-i+[File to hash. Use - to read from stdin]:INPUT:_files' \
+'--input=[File to hash. Use - to read from stdin]:INPUT:_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)' \
 '--no-extract[Do not look inside archives; hash the file itself]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
 '--no-trim-fix[Skip the extra checksums computed for how a trimmable ROM would hash trimmed or untrimmed]' \
 '--probe[Also report the platform of the hashed bytes, and fail if it matches no known platform]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(--json --jsonl -n --dry-run)--digest[Print only the digest; requires one --algo (no labels or elapsed time)]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -162,6 +530,7 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
+'::file -- File input; an alternative to -i, --input:_files' \
 && ret=0
 ;;
 (identify)
@@ -173,25 +542,32 @@ _arguments "${_arguments_options[@]}" : \
 '*-d+[RWFP1 identify pack, raw or Brotli, to search instead of the built-in data (repeatable)]:PACK:_files' \
 '*--database=[RWFP1 identify pack, raw or Brotli, to search instead of the built-in data (repeatable)]:PACK:_files' \
 '--system=[Search only this system'\''s pack. Takes a canonical platform name or a common alias (e.g. \`snes\`, \`psx\`)]:SYSTEM:_default' \
+'--name=[Search the database for games whose name matches QUERY, instead of identifying a file or checksum]:QUERY:_default' \
+'--title-index=[Search a cross-platform title index with --name instead of database packs]:JSON:_files' \
+'--limit=[Maximum number of matches --name returns \[default\: 50\]]:N:_default' \
 '--database-dir=[Directory of installed identify packs (*.pack plus optional catalog.json). Defaults to the per-user data directory]:DIR:_files' \
 '*-s+[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
 '*--select=[Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'(-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)' \
 '--offline[Assert that identify performs no network access (it never does natively; this flag records the guarantee)]' \
 '--exhaustive-database-search[Search every installed pack instead of only the packs the detected platform routes to]' \
 '--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]' \
 '--no-trim-fix[Skip extra checksums for trimmed and untrimmed ROM forms]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -199,26 +575,31 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
+'::file -- File input; an alternative to -i, --input:_files' \
 ":: :_rom-weaver__subcmd__identify_commands" \
 "*::: :->identify" \
 && ret=0
 
     case $state in
     (identify)
-        words=($line[1] "${words[@]}")
+        words=($line[2] "${words[@]}")
         (( CURRENT += 1 ))
-        curcontext="${curcontext%:*:*}:rom-weaver-identify-command-$line[1]:"
-        case $line[1] in
+        curcontext="${curcontext%:*:*}:rom-weaver-identify-command-$line[2]:"
+        case $line[2] in
             (database)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -239,14 +620,18 @@ _arguments "${_arguments_options[@]}" : \
             (list)
 _arguments "${_arguments_options[@]}" : \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -259,14 +644,18 @@ _arguments "${_arguments_options[@]}" : \
 (status)
 _arguments "${_arguments_options[@]}" : \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -279,14 +668,18 @@ _arguments "${_arguments_options[@]}" : \
 (path)
 _arguments "${_arguments_options[@]}" : \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -299,14 +692,18 @@ _arguments "${_arguments_options[@]}" : \
 (remove)
 _arguments "${_arguments_options[@]}" : \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -320,14 +717,18 @@ _arguments "${_arguments_options[@]}" : \
 (import-redump)
 _arguments "${_arguments_options[@]}" : \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -341,14 +742,18 @@ _arguments "${_arguments_options[@]}" : \
 (install-all)
 _arguments "${_arguments_options[@]}" : \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -362,14 +767,18 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '--from=[Local group archive; omit to download the archive for this version]:ARCHIVE:_files' \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -384,15 +793,19 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '--from=[Local Redump DAT ZIP file; omit to download from Redump]:ZIP:_files' \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'(-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)' \
 '()--all[Install every platform in the dump]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -407,14 +820,18 @@ _arguments "${_arguments_options[@]}" : \
 _arguments "${_arguments_options[@]}" : \
 '--from=[Local Redump DAT ZIP file; omit to download from Redump]:ZIP:_files' \
 '--database-dir=[Identify database directory. Defaults to the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -561,54 +978,38 @@ esac
     ;;
 esac
 ;;
-(setup)
-_arguments "${_arguments_options[@]}" : \
-'--database-dir=[Install into this directory instead of the per-user data directory]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--force[Download the database again even when it is already installed]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
-'(--progress)--no-progress[Hide progress]' \
-'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
-'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
-'(--no-color)--color[Keep colors even when output is piped]' \
-'(--color)--no-color[Turn colors off]' \
-'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'-h[Print help (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
-&& ret=0
-;;
-(ingest)
+(extract)
 _arguments "${_arguments_options[@]}" : \
-'-i+[File to sort into ROMs and patches]:INPUT:_files' \
-'--input=[File to sort into ROMs and patches]:INPUT:_files' \
-'-o+[Directory to write anything unpacked along the way into]:DIR:_files' \
-'--output=[Directory to write anything unpacked along the way into]:DIR:_files' \
-'*-d+[RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)]:PACK:_files' \
-'*--database=[RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)]:PACK:_files' \
-'*-s+[Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--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]:SIDECAR_NAMES:_default' \
-'--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]::SPLIT_BIN:(true false)' \
-'*--checksum=[Which checksums to compute for each ROM found (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
-'*--algo=[Which checksums to compute for each ROM found (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'*-s+[Extract only these files, by exact name, prefix, or glob (repeatable). For example\: --select '\''game.disc0?.bin'\'']:SELECT:_default' \
+'*--select=[Extract only these files, by exact name, prefix, or glob (repeatable). For example\: --select '\''game.disc0?.bin'\'']:SELECT:_default' \
+'*--filter=[Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
+'*--checksum=[Also hash every extracted file (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'*--algo=[Also hash every extracted file (repeatable, comma-separable)]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
+'(--checksum)*--checksum-rom=[Like --checksum, but hash only the ROMs and skip sidecar files. Cannot be combined with --checksum]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--sidecar-only[]' \
+'--stdin-name=[Filename for input - (default\: stdin.bin); one filename, no directories]:NAME:_default' \
+'-i+[Input path; - reads stdin using a temporary file]:INPUT:_files' \
+'--input=[Input path; - reads stdin using a temporary file]:INPUT:_files' \
+'-o+[Output path; - writes one binary result to stdout (compress requires --format)]:DIR:_files' \
+'--output=[Output path; - writes one binary result to stdout (compress requires --format)]:DIR:_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)' \
+'--split-bin[Write a CD-format CHD as a CUE plus one BIN per track (*.trackNN.bin), rather than one merged BIN]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
 '--no-nested-extract[Stop after one layer; leave any archive found inside the input packed]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'--force[Overwrite files already in the output directory (without this, extraction stops instead)]' \
+'--probe[Also report the format and platform of what was extracted, and fail if a lone payload matches no known platform]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -616,31 +1017,35 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
+'::file -- File input; an alternative to -i, --input:_files' \
 && ret=0
 ;;
 (compress)
 _arguments "${_arguments_options[@]}" : \
-'*-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]:INPUT:_files' \
-'*--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]:INPUT:_files' \
 '-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)' \
-'-o+[Where to write the archive]:PATH:_files' \
-'--output=[Where to write the archive]:PATH:_files' \
 '*--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)' \
 '--level=[How hard to compress\: min, very-low, low, medium, high, very-high, or max]:LEVEL:(min very-low low medium high very-high max)' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'--stdin-name=[Filename for input - (default\: stdin.bin); one filename, no directories]:NAME:_default' \
+'*-i+[Input path; - reads stdin using a temporary file]:INPUT:_files' \
+'*--input=[Input path; - reads stdin using a temporary file]:INPUT:_files' \
+'-o+[Output path; - writes one binary result to stdout (compress requires --format)]:PATH:_files' \
+'--output=[Output path; - writes one binary result to stdout (compress requires --format)]: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)' \
 '--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'-n[Print the plan (inputs, output, format, codec, level, threads) and stop without writing]' \
-'--dry-run[Print the plan (inputs, output, format, codec, level, threads) and stop without writing]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -648,39 +1053,115 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
+'*::file -- File input; an alternative to -i, --input:_files' \
 && ret=0
 ;;
 (trim)
 _arguments "${_arguments_options[@]}" : \
-'*-i+[File or folder to trim. Repeat for each one]:INPUT:_files' \
-'*--input=[File or folder to trim. Repeat for each one]:INPUT:_files' \
-'(--in-place)-o+[Where to write the trimmed file. Only valid with a single trimmable input]:OUTPUT:_files' \
-'(--in-place)--output=[Where to write the trimmed file. Only valid with a single trimmable input]:OUTPUT:_files' \
 '-e+[Save next to each original under this extension. {ext} stands for the original one, as in trim.{ext}]:EXTENSION:_default' \
 '--extension=[Save next to each original under this extension. {ext} stands for the original one, as in trim.{ext}]:EXTENSION:_default' \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'*-i+[File or folder to trim. Repeat for each one]:INPUT:_files' \
+'*--input=[File or folder to trim. Repeat for each one]:INPUT:_files' \
+'(--in-place)-o+[Output path; - writes one completed binary file to stdout]:OUTPUT:_files' \
+'(--in-place)--output=[Output path; - writes one completed binary file to stdout]:OUTPUT:_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)' \
 '--in-place[Overwrite the original instead of writing a new file]' \
-'-n[Report what would be trimmed without writing anything]' \
-'--dry-run[Report what would be trimmed without writing anything]' \
 '--revert[Pad a trimmed file back to full size (NDS, GBA, and 3DS only)]' \
 '--untrim[Pad a trimmed file back to full size (NDS, GBA, and 3DS only)]' \
 '--restore[Pad a trimmed file back to full size (NDS, GBA, and 3DS only)]' \
 '--no-recursive[When an input is a folder, look only at its top level]' \
 '--no-filter[Consider every file inside an archive, not just the ones that look like ROMs]' \
 '--no-extract[Do not look inside archives; trim only the files named directly]' \
-'--revert-marker[Add a small footer recording what was cut, so --revert can restore the original exactly]' \
-'--reversible[Add a small footer recording what was cut, so --revert can restore the original exactly]' \
+'--revert-marker[Add a footer with the original size and a fill byte for --revert]' \
+'--reversible[Add a footer with the original size and a fill byte for --revert]' \
+'--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+'*::file -- File input; an alternative to -i, --input:_files' \
+&& ret=0
+;;
+(weave)
+_arguments "${_arguments_options[@]}" : \
+'-i+[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
+'--input=[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
+'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'--target=[For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track]:TARGET:_default' \
+'*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
+'*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
+'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
+'--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
+'*--with=[Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)]:GLOB:_default' \
+'*--without=[Turn off a bundle patch, matched by name or file name (repeatable)]:GLOB:_default' \
+'--compress-format=[Format to compress the patched ROM into \[default\: from the --output extension\]]:COMPRESS_FORMAT:(zip 7z chd rvz z3ds)' \
+'--format=[Format to compress the patched ROM into \[default\: from the --output extension\]]:COMPRESS_FORMAT:(zip 7z chd rvz z3ds)' \
+'*--compress-codec=[Compression method to use, as codec or codec\:level (repeatable, comma-separable)]:COMPRESS_CODEC:(store deflate zstd lzma lzma2 zlib huff flac cdzs cdlz cdzl cdfl avhuff)' \
+'*--codec=[Compression method to use, as codec or codec\:level (repeatable, comma-separable)]:COMPRESS_CODEC:(store deflate zstd lzma lzma2 zlib huff flac cdzs cdlz cdzl cdfl avhuff)' \
+'--compress-level=[How hard to compress\: min, very-low, low, medium, high, very-high, or max \[default\: max\]]:COMPRESS_LEVEL:(min very-low low medium high very-high max)' \
+'--level=[How hard to compress\: min, very-low, low, medium, high, very-high, or max \[default\: max\]]:COMPRESS_LEVEL:(min very-low low medium high very-high max)' \
+'*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'*--expect-in=[Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'*--patch-header=[Whether a patch applies to the ROM with or without its copier header\: auto, keep, or strip \[default\: auto\]]:PATCH_HEADER:(keep strip auto)' \
+'*--patch-basis=[Override the preceding --patch input rule\: auto, base, or previous]:PATCH_BASIS:(auto base previous)' \
+'*--patch-input-check=[Expected input checks for the preceding patch (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'*--patch-output-check=[Expected output checks for the preceding patch (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'--default-patch-basis=[Shared input ROM rule for every patch\: auto, base, or previous \[default\: auto\]]:DEFAULT_PATCH_BASIS:(auto base previous)' \
+'--output-header=[Whether the finished ROM keeps its copier header\: auto, keep, or strip \[default\: auto\]]:OUTPUT_HEADER:(keep strip auto)' \
+'*--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\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
+'*--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' \
+'*--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' \
+'--game=[Use this database game ID instead of matching the ROM by checksum or title]:ID:_default' \
+'--emit-bundle=[Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it]:PATH:_files' \
+'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'-o+[Output path; - writes one completed binary file to stdout]:OUTPUT:_files' \
+'--output=[Output path; - writes one completed binary file to stdout]:OUTPUT:_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)' \
+'--no-extract[Do not look inside archives; treat the input and every patch as raw files]' \
+'--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
+'--without-cheats[Ignore every cheat the bundle records and run only its patch chain]' \
+'--no-compress[Write a plain ROM instead of compressing the result]' \
+'--raw[Write a plain ROM instead of compressing the result]' \
+'--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)]' \
+'--ignore-checksum-validation[Apply the patch even when its own checksums do not match. Can produce a broken ROM]' \
+'--allow-cheat-conflicts[Let a later cheat overwrite an earlier one at the same offset instead of failing]' \
+'--tui[Ask for each patch'\''s name, version, and author, then apply and write a bundle. Needs a terminal]' \
 '--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -692,14 +1173,18 @@ _arguments "${_arguments_options[@]}" : \
 ;;
 (patch)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -717,7 +1202,52 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-patch-command-$line[1]:"
         case $line[1] in
-            (apply)
+            (validate)
+_arguments "${_arguments_options[@]}" : \
+'-i+[ROM to check the patches against. May be an archive]:PATH:_files' \
+'--input=[ROM to check the patches against. May be an archive]:PATH:_files' \
+'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
+'*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
+'*--patch=[Patch to check. Repeat once per patch; they are checked in the order given]:PATCHES:_files' \
+'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
+'*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'*--expect-in=[Fail unless the ROM matches\: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable]:ALGO=HEX:_default' \
+'--n64-byte-order=[Byte order to put an N64 ROM in before checking\: auto, keep, big-endian, little-endian, or byte-swapped \[default\: auto\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
+'*--patch-basis=[Override the preceding --patch input rule\: auto, base, or previous]:PATCH_BASIS:(auto base previous)' \
+'--default-patch-basis=[Shared input ROM rule for every patch\: auto, base, or previous \[default\: auto\]]:DEFAULT_PATCH_BASIS:(auto base previous)' \
+'*--patch-input-check=[Checksum the preceding --patch expects to see going in, when the patch does not carry one (comma-separable; empty means none)]:ALGO=HEX:_default' \
+'*--patch-output-check=[Checksum the preceding --patch should produce, when the patch does not carry one (comma-separable; empty means none)]:ALGO=HEX:_default' \
+'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
+'(-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; treat the input and every patch as raw files]' \
+'--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
+'--strip-header[Remove the ROM'\''s copier header before checking (A78, LNX, NES, FDS, SMC signatures, plus the SNES and PCE size rules)]' \
+'--ignore-checksum-validation[Report a patch as usable even when its own checksums do not match]' \
+'--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]' \
+'--plan[Report the order the patches would run in and what each would be checked against, without reading the ROM more than needed]' \
+'-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 (see more with '\''--help'\'')]' \
+'--help[Print help (see more with '\''--help'\'')]' \
+&& ret=0
+;;
+(apply)
 _arguments "${_arguments_options[@]}" : \
 '-i+[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
 '--input=[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
@@ -727,8 +1257,6 @@ _arguments "${_arguments_options[@]}" : \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
 '*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
-'-o+[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
-'--output=[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
 '*--with=[Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)]:GLOB:_default' \
 '*--without=[Turn off a bundle patch, matched by name or file name (repeatable)]:GLOB:_default' \
@@ -741,34 +1269,47 @@ _arguments "${_arguments_options[@]}" : \
 '*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--expect-in=[Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--patch-header=[Whether a patch applies to the ROM with or without its copier header\: auto, keep, or strip \[default\: auto\]]:PATCH_HEADER:(keep strip auto)' \
-'*--patch-basis=[Which ROM the preceding --patch was built against\: auto, base, or previous \[default\: auto\]]:PATCH_BASIS:(auto base previous)' \
+'*--patch-basis=[Override the preceding --patch input rule\: auto, base, or previous]:PATCH_BASIS:(auto base previous)' \
+'*--patch-input-check=[Expected input checks for the preceding patch (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'*--patch-output-check=[Expected output checks for the preceding patch (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'--default-patch-basis=[Shared input ROM rule for every patch\: auto, base, or previous \[default\: auto\]]:DEFAULT_PATCH_BASIS:(auto base previous)' \
 '--output-header=[Whether the finished ROM keeps its copier header\: auto, keep, or strip \[default\: auto\]]:OUTPUT_HEADER:(keep strip auto)' \
 '*--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\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
 '*--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, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_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' \
+'*--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' \
+'--game=[Use this database game ID instead of matching the ROM by checksum or title]:ID:_default' \
 '--emit-bundle=[Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it]:PATH:_files' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-o+[Output path; - writes one completed binary file to stdout]:OUTPUT:_files' \
+'--output=[Output path; - writes one completed binary file to stdout]:OUTPUT:_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)' \
 '--no-extract[Do not look inside archives; treat the input and every patch as raw files]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
+'--without-cheats[Ignore every cheat the bundle records and run only its patch chain]' \
 '--no-compress[Write a plain ROM instead of compressing the result]' \
 '--raw[Write a plain ROM instead of compressing the result]' \
 '--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)]' \
 '--ignore-checksum-validation[Apply the patch even when its own checksums do not match. Can produce a broken ROM]' \
+'--allow-cheat-conflicts[Let a later cheat overwrite an earlier one at the same offset instead of failing]' \
 '--tui[Ask for each patch'\''s name, version, and author, then apply and write a bundle. Needs a terminal]' \
 '--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'-n[Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing]' \
-'--dry-run[Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -788,8 +1329,6 @@ _arguments "${_arguments_options[@]}" : \
 '*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
 '*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
 '*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
-'-o+[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
-'--output=[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
 '--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
 '*--with=[Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)]:GLOB:_default' \
 '*--without=[Turn off a bundle patch, matched by name or file name (repeatable)]:GLOB:_default' \
@@ -802,74 +1341,47 @@ _arguments "${_arguments_options[@]}" : \
 '*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--expect-in=[Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
 '*--patch-header=[Whether a patch applies to the ROM with or without its copier header\: auto, keep, or strip \[default\: auto\]]:PATCH_HEADER:(keep strip auto)' \
-'*--patch-basis=[Which ROM the preceding --patch was built against\: auto, base, or previous \[default\: auto\]]:PATCH_BASIS:(auto base previous)' \
+'*--patch-basis=[Override the preceding --patch input rule\: auto, base, or previous]:PATCH_BASIS:(auto base previous)' \
+'*--patch-input-check=[Expected input checks for the preceding patch (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'*--patch-output-check=[Expected output checks for the preceding patch (repeatable, comma-separable)]:ALGO=HEX:_default' \
+'--default-patch-basis=[Shared input ROM rule for every patch\: auto, base, or previous \[default\: auto\]]:DEFAULT_PATCH_BASIS:(auto base previous)' \
 '--output-header=[Whether the finished ROM keeps its copier header\: auto, keep, or strip \[default\: auto\]]:OUTPUT_HEADER:(keep strip auto)' \
 '*--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\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
 '*--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, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_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' \
+'*--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' \
+'--game=[Use this database game ID instead of matching the ROM by checksum or title]:ID:_default' \
 '--emit-bundle=[Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it]:PATH:_files' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-o+[Output path; - writes one completed binary file to stdout]:OUTPUT:_files' \
+'--output=[Output path; - writes one completed binary file to stdout]:OUTPUT:_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)' \
 '--no-extract[Do not look inside archives; treat the input and every patch as raw files]' \
 '--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
+'--without-cheats[Ignore every cheat the bundle records and run only its patch chain]' \
 '--no-compress[Write a plain ROM instead of compressing the result]' \
 '--raw[Write a plain ROM instead of compressing the result]' \
 '--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)]' \
 '--ignore-checksum-validation[Apply the patch even when its own checksums do not match. Can produce a broken ROM]' \
+'--allow-cheat-conflicts[Let a later cheat overwrite an earlier one at the same offset instead of failing]' \
 '--tui[Ask for each patch'\''s name, version, and author, then apply and write a bundle. Needs a terminal]' \
 '--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'-n[Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing]' \
-'--dry-run[Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
-'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
-'(--no-color)--color[Keep colors even when output is piped]' \
-'(--color)--no-color[Turn colors off]' \
-'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'-h[Print help (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
-&& ret=0
-;;
-(validate)
-_arguments "${_arguments_options[@]}" : \
-'-i+[ROM to check the patches against. May be an archive]:PATH:_files' \
-'--input=[ROM to check the patches against. May be an archive]:PATH:_files' \
-'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
-'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
-'*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
-'*--patch=[Patch to check. Repeat once per patch; they are checked in the order given]:PATCHES:_files' \
-'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
-'*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
-'*--expect-in=[Fail unless the ROM matches\: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable]:ALGO=HEX:_default' \
-'--n64-byte-order=[Byte order to put an N64 ROM in before checking\: auto, keep, big-endian, little-endian, or byte-swapped \[default\: auto\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
-'*--patch-basis=[Which ROM the preceding --patch was built against\: auto, base, or previous \[default\: auto\]]:PATCH_BASIS:(auto base previous)' \
-'*--patch-input-check=[Checksum the preceding --patch expects to see going in, when the patch does not carry one (comma-separable; empty means none)]:ALGO=HEX:_default' \
-'*--patch-output-check=[Checksum the preceding --patch should produce, when the patch does not carry one (comma-separable; empty means none)]:ALGO=HEX:_default' \
-'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--no-extract[Do not look inside archives; treat the input and every patch as raw files]' \
-'--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
-'--strip-header[Remove the ROM'\''s copier header before checking (A78, LNX, NES, FDS, SMC signatures, plus the SNES and PCE size rules)]' \
-'--ignore-checksum-validation[Report a patch as usable even when its own checksums do not match]' \
-'--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]' \
-'--plan[Report the order the patches would run in and what each would be checked against, without reading the ROM more than needed]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
-'(--progress)--no-progress[Hide progress]' \
-'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -885,12 +1397,14 @@ _arguments "${_arguments_options[@]}" : \
 '--modified=[The changed ROM. Leave out when using --code, which produces the changed ROM for you]:MODIFIED:_files' \
 '-f+[Patch format, such as bps, ips, or xdelta \[default\: from the --output extension\]]:FORMAT:_default' \
 '--format=[Patch format, such as bps, ips, or xdelta \[default\: from the --output extension\]]:FORMAT:_default' \
-'-o+[Where to write the patch. Required unless --plan is used]:PATH:_files' \
-'--output=[Where to write the patch. Required unless --plan is used]:PATH:_files' \
 '*--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, gameboy, gba, psx), when the ROM header does not say]:CODE_SYSTEM:_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' \
+'*--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' \
+'--game=[Use this database game ID instead of matching the ROM by checksum or title]:ID:_default' \
 '-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
 '--solid-system=[SOLID patches only\: console the ROM is for]:SOLID_SYSTEM:_default' \
@@ -901,19 +1415,26 @@ _arguments "${_arguments_options[@]}" : \
 '--solid-contact=[SOLID patches only\: how to reach the author. Switches the patch to its extended header]:SOLID_CONTACT:_default' \
 '--solid-comment=[SOLID patches only\: free-form note. Switches the patch to its extended header]:SOLID_COMMENT:_default' \
 '--xdelta-secondary=[xdelta patches only\: compress the patch'\''s own contents]:XDELTA_SECONDARY:(auto lzma djw fgk none)' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
+'-o+[Output path; - writes one completed binary file to stdout]:PATH:_files' \
+'--output=[Output path; - writes one completed binary file to stdout]: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)' \
 '--plan[Only report which formats suit these two ROMs; write nothing]' \
 '--ignore-checksum-validation[Write the patch even when the format'\''s own consistency checks fail, and leave its checksums out]' \
 '--checksum-name[Put the original ROM'\''s crc32 in the patch file name, as \[crc32\:HEX\]]' \
+'--allow-cheat-conflicts[Let a later cheat overwrite an earlier one at the same offset instead of failing]' \
 '--solid-extended[SOLID patches only\: use the extended header even with none of the extended fields filled in]' \
 '--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -935,11 +1456,11 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-patch-help-command-$line[1]:"
         case $line[1] in
-            (apply)
+            (validate)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(validate)
+(apply)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -959,16 +1480,20 @@ esac
     ;;
 esac
 ;;
-(bundle)
+(save)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -976,162 +1501,111 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help]' \
 '--help[Print help]' \
-":: :_rom-weaver__subcmd__bundle_commands" \
-"*::: :->bundle" \
+":: :_rom-weaver__subcmd__save_commands" \
+"*::: :->save" \
 && ret=0
 
     case $state in
-    (bundle)
+    (save)
         words=($line[1] "${words[@]}")
         (( CURRENT += 1 ))
-        curcontext="${curcontext%:*:*}:rom-weaver-bundle-command-$line[1]:"
+        curcontext="${curcontext%:*:*}:rom-weaver-save-command-$line[1]:"
         case $line[1] in
-            (create)
-_arguments "${_arguments_options[@]}" : \
-'-i+[ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle]:INPUT:_files' \
-'--input=[ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle]:INPUT:_files' \
-'*--assume-in=[Take the ROM'\''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)]:ALGO=HEX:_default' \
-'--rom-url=[Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url]:ROM_URL:_default' \
-'--rom-name=[Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns]:ROM_NAME:_default' \
-'*--patch=[Patch to list in the bundle. Repeat once per patch, in the order they should be applied]:PATCH:_files' \
-'*--patch-id=[Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings]:PATCH_ID:_default' \
-'*--patch-version=[Version of the preceding --patch, in whatever form its author uses]:PATCH_VERSION:_default' \
-'*--patch-name=[Name to show for the preceding --patch]:PATCH_NAME:_default' \
-'*--patch-description=[What the preceding --patch does]:PATCH_DESCRIPTION:_default' \
-'*--patch-author=[Who made the preceding --patch]:PATCH_AUTHOR:_default' \
-'*--patch-label=[Short status note for the preceding --patch, such as beta or recommended]:PATCH_LABEL:_default' \
-'*--patch-optional=[Mark the preceding --patch optional, so it starts switched off and needs --with to run]:PATCH_OPTIONAL:(true false)' \
-'*--patch-source-url=[Where the preceding --patch can be downloaded from. The local file is still read to build the bundle]:PATCH_SOURCE_URL:_default' \
-'*--patch-header=[Whether the preceding --patch applies to the ROM with or without its copier header\: auto, keep, or strip]:PATCH_HEADER:(keep strip auto)' \
-'*--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]:PATCH_BASIS:(auto base previous)' \
-'*--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)]:ALGO=HEX:_default' \
-'*--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)]:ALGO=HEX:_default' \
-'*--expect-out=[Checksum the ROM should have once every patch has run, so users can confirm they got the right result (repeatable, comma-separable)]:ALGO=HEX:_default' \
-'--output-name=[File name the bundle suggests for the patched ROM]:OUTPUT_NAME:_default' \
-'--output-header=[Whether the patched ROM should keep its copier header\: auto, keep, or strip]:OUTPUT_HEADER:(keep strip auto)' \
-'-o+[Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it]:OUTPUT:_files' \
-'--output=[Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it]:OUTPUT:_files' \
-'--bundle=[Also pack the bundle and its ROM and patches into one shareable archive, such as release.zip]:BUNDLE:_files' \
-'--bundle-rom=[Pack this file into --bundle as the ROM, while --input supplies the checksums and metadata]:BUNDLE_ROM:_files' \
-'*--checksum=[Which checksums to record for the ROM (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
-'*--algo=[Which checksums to record for the ROM (repeatable, comma-separable) \[default\: crc32,md5,sha1\]]:ALGO:(crc32 md5 sha1 sha256 blake3 crc32c crc16 adler32)' \
-'--from=[Build the bundle from a hand-written rom-weaver-bundle.json instead of flags. Use - to read it from stdin]:FILE:_files' \
-'--schema-ref=[Record this \$schema URL in the bundle so editors can validate it. Left out unless asked for]:URL:_default' \
-'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--no-bundle-rom[Keep the ROM out of --bundle and record only its checksums, so whoever applies the bundle brings their own copy]' \
-'--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+            (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' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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 (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
+'-h[Print help]' \
+'--help[Print help]' \
+':input -- Save file to read:_files' \
 && ret=0
 ;;
-(parse)
+(inspect)
 _arguments "${_arguments_options[@]}" : \
-'-i+[Bundle file, or an archive with a bundle at its root]:INPUT:_files' \
-'--input=[Bundle file, or an archive with a bundle at its root]:INPUT:_files' \
-'*-s+[Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--select=[Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)]:SELECT:_default' \
-'*--filter=[Handle only the bundle'\''s rom entry or only its patch entries (repeatable, comma-separable)]:FILTER:(rom patch)' \
-'-o+[Directory to unpack the bundle'\''s files into. Without it, files packed in an archive are listed but not written out]:DIR:_files' \
-'--output=[Directory to unpack the bundle'\''s files into. Without it, files packed in an archive are listed but not written out]:DIR:_files' \
-'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--no-extract[Report what the bundle contains without unpacking any of it]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'--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' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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 (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
+'-h[Print help]' \
+'--help[Print help]' \
+':input -- Save file to read:_files' \
 && ret=0
 ;;
-(schema)
+(get)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'--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' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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 (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
-&& ret=0
-;;
-(help)
-_arguments "${_arguments_options[@]}" : \
-":: :_rom-weaver__subcmd__bundle__subcmd__help_commands" \
-"*::: :->help" \
-&& ret=0
-
-    case $state in
-    (help)
-        words=($line[1] "${words[@]}")
-        (( CURRENT += 1 ))
-        curcontext="${curcontext%:*:*}:rom-weaver-bundle-help-command-$line[1]:"
-        case $line[1] in
-            (create)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(parse)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(schema)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(help)
-_arguments "${_arguments_options[@]}" : \
+'-h[Print help]' \
+'--help[Print help]' \
+':input -- Save file to read:_files' \
+':field -- Field id to read, such as trainer.money:_default' \
 && ret=0
 ;;
-        esac
-    ;;
-esac
-;;
-        esac
-    ;;
-esac
-;;
-(tools)
+(export-schema)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'--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' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -1139,43 +1613,42 @@ _arguments "${_arguments_options[@]}" : \
 '--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
 '-h[Print help]' \
 '--help[Print help]' \
-":: :_rom-weaver__subcmd__tools_commands" \
-"*::: :->tools" \
-&& ret=0
-
-    case $state in
-    (tools)
-        words=($line[1] "${words[@]}")
-        (( CURRENT += 1 ))
-        curcontext="${curcontext%:*:*}:rom-weaver-tools-command-$line[1]:"
-        case $line[1] in
-            (ppf-undo)
-_arguments "${_arguments_options[@]}" : \
-'-i+[The already-patched ROM to undo]:ROM:_files' \
-'--input=[The already-patched ROM to undo]:ROM:_files' \
-'--patch=[The PPF3 patch that was applied. It must carry undo data]:PPF:_files' \
-'-o+[Where to write the restored ROM]:PATH:_files' \
-'--output=[Where to write the restored ROM]:PATH:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'::input -- Save file to read. Omit it and pass --game instead:_files' \
+&& ret=0
+;;
+(set)
+_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' \
+'-o+[Output path; - writes one completed binary file to stdout]:PATH:_files' \
+'--output=[Output path; - writes one completed binary file to stdout]: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[Validate and preview every change without writing a file]' \
+'--dry-run[Validate and preview every change without writing a file]' \
+'--force[Overwrite an explicit output path if it already exists]' \
+'(--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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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 (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
+'-h[Print help]' \
+'--help[Print help]' \
+':input -- Save file to read:_files' \
+'*::assignments -- Field assignments to apply, such as trainer.money=999999:_default' \
 && ret=0
 ;;
 (help)
 _arguments "${_arguments_options[@]}" : \
-":: :_rom-weaver__subcmd__tools__subcmd__help_commands" \
+":: :_rom-weaver__subcmd__save__subcmd__help_commands" \
 "*::: :->help" \
 && ret=0
 
@@ -1183,162 +1656,90 @@ _arguments "${_arguments_options[@]}" : \
     (help)
         words=($line[1] "${words[@]}")
         (( CURRENT += 1 ))
-        curcontext="${curcontext%:*:*}:rom-weaver-tools-help-command-$line[1]:"
+        curcontext="${curcontext%:*:*}:rom-weaver-save-help-command-$line[1]:"
         case $line[1] in
-            (ppf-undo)
+            (identify)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(help)
+(inspect)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-        esac
-    ;;
-esac
-;;
-        esac
-    ;;
-esac
-;;
-(plan-extract-batch)
+(get)
 _arguments "${_arguments_options[@]}" : \
-'*--job-size=[Source size in bytes for one job; repeat once per job, in input order]:BYTES:_default' \
-'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--max-concurrency=[Hard cap on jobs running at once; defaults to the thread budget]:MAX_CONCURRENCY:_default' \
-'--total-memory-bytes=[Total memory budget concurrent jobs may reserve (e.g. browser device memory); defaults to the platform'\''s physical memory]:TOTAL_MEMORY_BYTES:_default' \
-'--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]:MEMORY_CEILING_BYTES:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
-'(--progress)--no-progress[Hide progress]' \
-'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
-'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
-'(--no-color)--color[Keep colors even when output is piped]' \
-'(--color)--no-color[Turn colors off]' \
-'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'-h[Print help]' \
-'--help[Print help]' \
 && ret=0
 ;;
-(weave)
+(export-schema)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(set)
 _arguments "${_arguments_options[@]}" : \
-'-i+[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
-'--input=[ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle]:PATH:_files' \
-'*-s+[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
-'*--select=[Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows]:SELECT:_default' \
-'--target=[For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track]:TARGET:_default' \
-'*--filter=[Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)]:FILTER:(rom patch)' \
-'*--patch=[Patch to apply. Repeat once per patch; they run in the order given]:PATCHES:_files' \
-'*--patch-select=[Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select]:GLOB:_default' \
-'-o+[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
-'--output=[Where to write the patched ROM. Optional when a bundle already names the output]:OUTPUT:_files' \
-'--bundle=[Follow a rom-weaver-bundle.json recipe\: a file path, or an http(s) URL]:BUNDLE:_files' \
-'*--with=[Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)]:GLOB:_default' \
-'*--without=[Turn off a bundle patch, matched by name or file name (repeatable)]:GLOB:_default' \
-'--compress-format=[Format to compress the patched ROM into \[default\: from the --output extension\]]:COMPRESS_FORMAT:(zip 7z chd rvz z3ds)' \
-'--format=[Format to compress the patched ROM into \[default\: from the --output extension\]]:COMPRESS_FORMAT:(zip 7z chd rvz z3ds)' \
-'*--compress-codec=[Compression method to use, as codec or codec\:level (repeatable, comma-separable)]:COMPRESS_CODEC:(store deflate zstd lzma lzma2 zlib huff flac cdzs cdlz cdzl cdfl avhuff)' \
-'*--codec=[Compression method to use, as codec or codec\:level (repeatable, comma-separable)]:COMPRESS_CODEC:(store deflate zstd lzma lzma2 zlib huff flac cdzs cdlz cdzl cdfl avhuff)' \
-'--compress-level=[How hard to compress\: min, very-low, low, medium, high, very-high, or max \[default\: max\]]:COMPRESS_LEVEL:(min very-low low medium high very-high max)' \
-'--level=[How hard to compress\: min, very-low, low, medium, high, very-high, or max \[default\: max\]]:COMPRESS_LEVEL:(min very-low low medium high very-high max)' \
-'*--assume-in=[Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
-'*--expect-in=[Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)]:ALGO=HEX:_default' \
-'*--patch-header=[Whether a patch applies to the ROM with or without its copier header\: auto, keep, or strip \[default\: auto\]]:PATCH_HEADER:(keep strip auto)' \
-'*--patch-basis=[Which ROM the preceding --patch was built against\: auto, base, or previous \[default\: auto\]]:PATCH_BASIS:(auto base previous)' \
-'--output-header=[Whether the finished ROM keeps its copier header\: auto, keep, or strip \[default\: auto\]]:OUTPUT_HEADER:(keep strip auto)' \
-'*--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\]]:N64_BYTE_ORDER:(auto keep big-endian little-endian byte-swapped)' \
-'*--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, 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' \
-'--emit-bundle=[Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it]:PATH:_files' \
-'-j+[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'--threads=[How many threads to use at most. auto uses every core; a format may still use fewer]:auto|N:_default' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--no-extract[Do not look inside archives; treat the input and every patch as raw files]' \
-'--no-ignore[Also consider files normally skipped inside archives\: readmes, images, checksum sidecars, and OS clutter such as .DS_Store]' \
-'--no-compress[Write a plain ROM instead of compressing the result]' \
-'--raw[Write a plain ROM instead of compressing the result]' \
-'--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)]' \
-'--ignore-checksum-validation[Apply the patch even when its own checksums do not match. Can produce a broken ROM]' \
-'--tui[Ask for each patch'\''s name, version, and author, then apply and write a bundle. Needs a terminal]' \
-'--force[Overwrite the output if it already exists (without this, the command stops instead)]' \
-'-n[Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing]' \
-'--dry-run[Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
-'(--progress)--no-progress[Hide progress]' \
-'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
-'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
-'(--no-color)--color[Keep colors even when output is piped]' \
-'(--color)--no-color[Turn colors off]' \
-'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'-h[Print help (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
 && ret=0
 ;;
-(completions)
+(help)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
-'(--progress)--no-progress[Hide progress]' \
-'(--log-level -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
-'--dep-trace[Also log trace output from bundled libraries (for bug reports)]' \
-'(--no-color)--color[Keep colors even when output is piped]' \
-'(--color)--no-color[Turn colors off]' \
-'-y[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'--yes[Answer yes to every confirmation instead of asking. Does not choose between candidates]' \
-'-h[Print help (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
-':shell -- Shell to print completions for:(bash elvish fish powershell zsh)' \
 && ret=0
 ;;
-(man)
+        esac
+    ;;
+esac
+;;
+        esac
+    ;;
+esac
+;;
+(tools)
 _arguments "${_arguments_options[@]}" : \
-'--man-dir=[Directory to install pages into]:DIR:_files' \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--install[Install the generated pages instead of printing one]' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'(-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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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 (see more with '\''--help'\'')]' \
-'--help[Print help (see more with '\''--help'\'')]' \
-'*::command -- Command path to print:_default' \
+'-h[Print help]' \
+'--help[Print help]' \
+":: :_rom-weaver__subcmd__tools_commands" \
+"*::: :->tools" \
 && ret=0
-;;
-(formats)
+
+    case $state in
+    (tools)
+        words=($line[1] "${words[@]}")
+        (( CURRENT += 1 ))
+        curcontext="${curcontext%:*:*}:rom-weaver-tools-command-$line[1]:"
+        case $line[1] in
+            (ppf-undo)
 _arguments "${_arguments_options[@]}" : \
-'(-v --verbose -q --quiet)--log-level=[How much rom-weaver logs to stderr. Separate from the normal output \[default\: off\]]:LOG_LEVEL:(off error warn info debug trace)' \
-'--json[Print one JSON object per line instead of human-readable output]' \
-'(--no-progress)--progress[Show progress even when output is piped to a file or another program]' \
+'-i+[The already-patched ROM to undo]:ROM:_files' \
+'--input=[The already-patched ROM to undo]:ROM:_files' \
+'--patch=[The PPF3 patch that was applied. It must carry undo data]:PPF:_files' \
+'-o+[Output path; - writes one completed binary file to stdout]:PATH:_files' \
+'--output=[Output path; - writes one completed binary file to stdout]: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[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 -q --quiet)*-v[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -q --quiet)*--verbose[Log more\: -v for info, -vv for debug, -vvv for trace]' \
-'(--log-level -v --verbose)-q[Log errors only]' \
-'(--log-level -v --verbose)--quiet[Log errors only]' \
+'(--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]' \
@@ -1350,6 +1751,34 @@ _arguments "${_arguments_options[@]}" : \
 ;;
 (help)
 _arguments "${_arguments_options[@]}" : \
+":: :_rom-weaver__subcmd__tools__subcmd__help_commands" \
+"*::: :->help" \
+&& ret=0
+
+    case $state in
+    (help)
+        words=($line[1] "${words[@]}")
+        (( CURRENT += 1 ))
+        curcontext="${curcontext%:*:*}:rom-weaver-tools-help-command-$line[1]:"
+        case $line[1] in
+            (ppf-undo)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(help)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+        esac
+    ;;
+esac
+;;
+        esac
+    ;;
+esac
+;;
+(help)
+_arguments "${_arguments_options[@]}" : \
 ":: :_rom-weaver__subcmd__help_commands" \
 "*::: :->help" \
 && ret=0
@@ -1360,11 +1789,63 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-help-command-$line[1]:"
         case $line[1] in
-            (probe)
+            (setup)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(extract)
+(ingest)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(cheat)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(bundle)
+_arguments "${_arguments_options[@]}" : \
+":: :_rom-weaver__subcmd__help__subcmd__bundle_commands" \
+"*::: :->bundle" \
+&& ret=0
+
+    case $state in
+    (bundle)
+        words=($line[1] "${words[@]}")
+        (( CURRENT += 1 ))
+        curcontext="${curcontext%:*:*}:rom-weaver-help-bundle-command-$line[1]:"
+        case $line[1] in
+            (create)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(parse)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(schema)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+        esac
+    ;;
+esac
+;;
+(plan-extract-batch)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(completions)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(man)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(formats)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(probe)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -1440,19 +1921,19 @@ esac
     ;;
 esac
 ;;
-(setup)
+(extract)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(ingest)
+(compress)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(compress)
+(trim)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(trim)
+(weave)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -1468,11 +1949,11 @@ _arguments "${_arguments_options[@]}" : \
         (( CURRENT += 1 ))
         curcontext="${curcontext%:*:*}:rom-weaver-help-patch-command-$line[1]:"
         case $line[1] in
-            (apply)
+            (validate)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(validate)
+(apply)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -1484,27 +1965,35 @@ _arguments "${_arguments_options[@]}" : \
     ;;
 esac
 ;;
-(bundle)
+(save)
 _arguments "${_arguments_options[@]}" : \
-":: :_rom-weaver__subcmd__help__subcmd__bundle_commands" \
-"*::: :->bundle" \
+":: :_rom-weaver__subcmd__help__subcmd__save_commands" \
+"*::: :->save" \
 && ret=0
 
     case $state in
-    (bundle)
+    (save)
         words=($line[1] "${words[@]}")
         (( CURRENT += 1 ))
-        curcontext="${curcontext%:*:*}:rom-weaver-help-bundle-command-$line[1]:"
+        curcontext="${curcontext%:*:*}:rom-weaver-help-save-command-$line[1]:"
         case $line[1] in
-            (create)
+            (identify)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(parse)
+(inspect)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
-(schema)
+(get)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(export-schema)
+_arguments "${_arguments_options[@]}" : \
+&& ret=0
+;;
+(set)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
 ;;
@@ -1532,26 +2021,6 @@ _arguments "${_arguments_options[@]}" : \
     ;;
 esac
 ;;
-(plan-extract-batch)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(weave)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(completions)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(man)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
-(formats)
-_arguments "${_arguments_options[@]}" : \
-&& ret=0
-;;
 (help)
 _arguments "${_arguments_options[@]}" : \
 && ret=0
@@ -1568,23 +2037,25 @@ esac
 (( $+functions[_rom-weaver_commands] )) ||
 _rom-weaver_commands() {
     local commands; commands=(
+'setup:Install the offline identify database' \
+'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
+'cheat:List the cheat database'\''s entries for a ROM' \
+'bundle:Build and read rom-weaver-bundle.json patch recipes' \
+'plan-extract-batch:Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)' \
+'completions:Print a tab-completion script for your shell' \
+'man:Print or install the generated CLI man pages' \
+'formats:List the formats, codecs, and checksum algorithms this build supports' \
 'probe:Identify a file\: its format, its platform, and any header it carries' \
 'inspect:Identify a file\: its format, its platform, and any header it carries' \
-'extract:Unpack an archive or single-payload compressed format' \
 'checksum:Compute checksums for a file, or for a ROM inside an archive' \
 'identify:Identify a ROM title from its checksums' \
-'setup:Install the offline identify database' \
-'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
+'extract:Unpack an archive or single-payload compressed format' \
 'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
 'trim:Cut the padding off a ROM, or put it back' \
+'weave:Apply one or more patches to a ROM, in order (same as \`patch apply\`)' \
 'patch:Apply, create, or check ROM patches' \
-'bundle:Build and read rom-weaver-bundle.json patch recipes' \
+'save:Inspect and edit supported persistent game saves' \
 'tools:One-off recovery tools' \
-'plan-extract-batch:Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)' \
-'weave:Apply one or more patches to a ROM, in order (same as \`patch apply\`)' \
-'completions:Print a tab-completion script for your shell' \
-'man:Print or install the generated CLI man pages' \
-'formats:List the formats, codecs, and checksum algorithms this build supports' \
 'help:Print this message or the help of the given subcommand(s)' \
     )
     _describe -t commands 'rom-weaver commands' commands "$@"
@@ -1644,6 +2115,11 @@ _rom-weaver__subcmd__bundle__subcmd__schema_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver bundle schema commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__cheat_commands] )) ||
+_rom-weaver__subcmd__cheat_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver cheat commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__checksum_commands] )) ||
 _rom-weaver__subcmd__checksum_commands() {
     local commands; commands=()
@@ -1672,22 +2148,24 @@ _rom-weaver__subcmd__formats_commands() {
 (( $+functions[_rom-weaver__subcmd__help_commands] )) ||
 _rom-weaver__subcmd__help_commands() {
     local commands; commands=(
-'probe:Identify a file\: its format, its platform, and any header it carries' \
-'extract:Unpack an archive or single-payload compressed format' \
-'checksum:Compute checksums for a file, or for a ROM inside an archive' \
-'identify:Identify a ROM title from its checksums' \
 'setup:Install the offline identify database' \
 'ingest:Sort a file into ROMs and patches, unpacking and hashing along the way' \
-'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
-'trim:Cut the padding off a ROM, or put it back' \
-'patch:Apply, create, or check ROM patches' \
+'cheat:List the cheat database'\''s entries for a ROM' \
 'bundle:Build and read rom-weaver-bundle.json patch recipes' \
-'tools:One-off recovery tools' \
 'plan-extract-batch:Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)' \
-'weave:Apply one or more patches to a ROM, in order (same as \`patch apply\`)' \
 'completions:Print a tab-completion script for your shell' \
 'man:Print or install the generated CLI man pages' \
 'formats:List the formats, codecs, and checksum algorithms this build supports' \
+'probe:Identify a file\: its format, its platform, and any header it carries' \
+'checksum:Compute checksums for a file, or for a ROM inside an archive' \
+'identify:Identify a ROM title from its checksums' \
+'extract:Unpack an archive or single-payload compressed format' \
+'compress:Pack files into an archive, disc image, or ROM-specific compressed format' \
+'trim:Cut the padding off a ROM, or put it back' \
+'weave:Apply one or more patches to a ROM, in order (same as \`patch apply\`)' \
+'patch:Apply, create, or check ROM patches' \
+'save:Inspect and edit supported persistent game saves' \
+'tools:One-off recovery tools' \
 'help:Print this message or the help of the given subcommand(s)' \
     )
     _describe -t commands 'rom-weaver help commands' commands "$@"
@@ -1716,6 +2194,11 @@ _rom-weaver__subcmd__help__subcmd__bundle__subcmd__schema_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver help bundle schema commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__help__subcmd__cheat_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__cheat_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help cheat commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__help__subcmd__checksum_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__checksum_commands() {
     local commands; commands=()
@@ -1826,8 +2309,8 @@ _rom-weaver__subcmd__help__subcmd__man_commands() {
 (( $+functions[_rom-weaver__subcmd__help__subcmd__patch_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__patch_commands() {
     local commands; commands=(
-'apply:Apply one or more patches to a ROM, in order' \
 'validate:Check that patches would apply cleanly, without writing anything' \
+'apply:Apply one or more patches to a ROM, in order' \
 'create:Build a patch from an original ROM and a changed one' \
     )
     _describe -t commands 'rom-weaver help patch commands' commands "$@"
@@ -1857,6 +2340,42 @@ _rom-weaver__subcmd__help__subcmd__probe_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver help probe commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__help__subcmd__save_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__save_commands() {
+    local commands; commands=(
+'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' \
+'export-schema:Print the generic field schema for a supported game save' \
+'set:Write validated field changes to a new game save' \
+    )
+    _describe -t commands 'rom-weaver help save 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=()
+    _describe -t commands 'rom-weaver help save export-schema commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__get_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__save__subcmd__get_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help save get commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__identify_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__save__subcmd__identify_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help save identify commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__help__subcmd__save__subcmd__inspect_commands] )) ||
+_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__set_commands] )) ||
+_rom-weaver__subcmd__help__subcmd__save__subcmd__set_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver help save set commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__help__subcmd__setup_commands] )) ||
 _rom-weaver__subcmd__help__subcmd__setup_commands() {
     local commands; commands=()
@@ -2105,9 +2624,9 @@ _rom-weaver__subcmd__man_commands() {
 (( $+functions[_rom-weaver__subcmd__patch_commands] )) ||
 _rom-weaver__subcmd__patch_commands() {
     local commands; commands=(
+'validate:Check that patches would apply cleanly, without writing anything' \
 'apply:Apply one or more patches to a ROM, in order' \
 'weave:Apply one or more patches to a ROM, in order' \
-'validate:Check that patches would apply cleanly, without writing anything' \
 'create:Build a patch from an original ROM and a changed one' \
 'help:Print this message or the help of the given subcommand(s)' \
     )
@@ -2126,8 +2645,8 @@ _rom-weaver__subcmd__patch__subcmd__create_commands() {
 (( $+functions[_rom-weaver__subcmd__patch__subcmd__help_commands] )) ||
 _rom-weaver__subcmd__patch__subcmd__help_commands() {
     local commands; commands=(
-'apply:Apply one or more patches to a ROM, in order' \
 'validate:Check that patches would apply cleanly, without writing anything' \
+'apply:Apply one or more patches to a ROM, in order' \
 'create:Build a patch from an original ROM and a changed one' \
 'help:Print this message or the help of the given subcommand(s)' \
     )
@@ -2168,6 +2687,85 @@ _rom-weaver__subcmd__probe_commands() {
     local commands; commands=()
     _describe -t commands 'rom-weaver probe commands' commands "$@"
 }
+(( $+functions[_rom-weaver__subcmd__save_commands] )) ||
+_rom-weaver__subcmd__save_commands() {
+    local commands; commands=(
+'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' \
+'export-schema:Print the generic field schema for a supported game save' \
+'set:Write validated field changes to a new game save' \
+'help:Print this message or the help of the given subcommand(s)' \
+    )
+    _describe -t commands 'rom-weaver save commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__export-schema_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__export-schema_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save export-schema commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__get_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__get_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save get commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help_commands() {
+    local commands; commands=(
+'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' \
+'export-schema:Print the generic field schema for a supported game save' \
+'set:Write validated field changes to a new game save' \
+'help:Print this message or the help of the given subcommand(s)' \
+    )
+    _describe -t commands 'rom-weaver save help 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=()
+    _describe -t commands 'rom-weaver save help export-schema commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__get_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help__subcmd__get_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save help get commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__help_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help__subcmd__help_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save help help commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__identify_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help__subcmd__identify_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save help identify commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__help__subcmd__inspect_commands] )) ||
+_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__set_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__help__subcmd__set_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save help set commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__identify_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__identify_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save identify commands' commands "$@"
+}
+(( $+functions[_rom-weaver__subcmd__save__subcmd__inspect_commands] )) ||
+_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__set_commands] )) ||
+_rom-weaver__subcmd__save__subcmd__set_commands() {
+    local commands; commands=()
+    _describe -t commands 'rom-weaver save set commands' commands "$@"
+}
 (( $+functions[_rom-weaver__subcmd__setup_commands] )) ||
 _rom-weaver__subcmd__setup_commands() {
     local commands; commands=()