@rom-weaver/cli 0.15.1 → 0.16.1

package/docs/completions/rom-weaver.ps1

@@ -21,14 +21,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
 
     $completions = @(switch ($command) {
         'rom-weaver' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -38,42 +42,83 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             [CompletionResult]::new('-V', '-V ', [CompletionResultType]::ParameterName, 'Print version')
             [CompletionResult]::new('--version', '--version', [CompletionResultType]::ParameterName, 'Print version')
+            [CompletionResult]::new('setup', 'setup', [CompletionResultType]::ParameterValue, 'Install the offline identify database')
+            [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
+            [CompletionResult]::new('cheat', 'cheat', [CompletionResultType]::ParameterValue, 'List the cheat database''s entries for a ROM')
+            [CompletionResult]::new('bundle', 'bundle', [CompletionResultType]::ParameterValue, 'Build and read rom-weaver-bundle.json patch recipes')
+            [CompletionResult]::new('plan-extract-batch', 'plan-extract-batch', [CompletionResultType]::ParameterValue, 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)')
+            [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a tab-completion script for your shell')
+            [CompletionResult]::new('man', 'man', [CompletionResultType]::ParameterValue, 'Print or install the generated CLI man pages')
+            [CompletionResult]::new('formats', 'formats', [CompletionResultType]::ParameterValue, 'List the formats, codecs, and checksum algorithms this build supports')
             [CompletionResult]::new('probe', 'probe', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
             [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
-            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
             [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
             [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a ROM title from its checksums')
-            [CompletionResult]::new('setup', 'setup', [CompletionResultType]::ParameterValue, 'Install the offline identify database')
-            [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
+            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
             [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
             [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
+            [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order (same as `patch apply`)')
             [CompletionResult]::new('patch', 'patch', [CompletionResultType]::ParameterValue, 'Apply, create, or check ROM patches')
-            [CompletionResult]::new('bundle', 'bundle', [CompletionResultType]::ParameterValue, 'Build and read rom-weaver-bundle.json patch recipes')
+            [CompletionResult]::new('save', 'save', [CompletionResultType]::ParameterValue, 'Inspect and edit supported persistent game saves')
             [CompletionResult]::new('tools', 'tools', [CompletionResultType]::ParameterValue, 'One-off recovery tools')
-            [CompletionResult]::new('plan-extract-batch', 'plan-extract-batch', [CompletionResultType]::ParameterValue, 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)')
-            [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order (same as `patch apply`)')
-            [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a tab-completion script for your shell')
-            [CompletionResult]::new('man', 'man', [CompletionResultType]::ParameterValue, 'Print or install the generated CLI man pages')
-            [CompletionResult]::new('formats', 'formats', [CompletionResultType]::ParameterValue, 'List the formats, codecs, and checksum algorithms this build supports')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;probe' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; identify the file itself')
+        'rom-weaver;setup' {
+            [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Install into this directory instead of the per-user data directory')
+            [CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'Local rom-weaver-identify-data.tar.br; omit to download the archive for this version')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Download the database again even when it is already installed')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;ingest' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to sort into ROMs and patches')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to sort into ROMs and patches')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Directory to write anything unpacked along the way into')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Directory to write anything unpacked along the way into')
+            [CompletionResult]::new('-d', '-d', [CompletionResultType]::ParameterName, 'RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)')
+            [CompletionResult]::new('--database', '--database', [CompletionResultType]::ParameterName, 'RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('--sidecar-name', '--sidecar-name', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--split-bin', '--split-bin', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Which checksums to compute for each ROM found (repeatable, comma-separable) [default: crc32,md5,sha1]')
+            [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Which checksums to compute for each ROM found (repeatable, comma-separable) [default: crc32,md5,sha1]')
+            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--sidecar-only', '--sidecar-only', [CompletionResultType]::ParameterName, 'sidecar-only')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--no-nested-extract', '--no-nested-extract', [CompletionResultType]::ParameterName, 'Stop after one layer; leave any archive found inside the input packed')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -83,22 +128,312 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
-        'rom-weaver;inspect' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
+        'rom-weaver;cheat' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'The ROM the cheats are for. Its header picks the cheat shard and its bytes decide each cheat''s delivery')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'The ROM the cheats are for. Its header picks the cheat shard and its bytes decide each cheat''s delivery')
+            [CompletionResult]::new('--cheat', '--cheat', [CompletionResultType]::ParameterName, 'Database cheat to use, by record ID or exact description. Repeat for each cheat')
+            [CompletionResult]::new('--cheat-database', '--cheat-database', [CompletionResultType]::ParameterName, 'Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory')
+            [CompletionResult]::new('--cheat-system', '--cheat-system', [CompletionResultType]::ParameterName, 'Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say')
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Use this database game ID instead of matching the ROM by checksum or title')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--allow-cheat-conflicts', '--allow-cheat-conflicts', [CompletionResultType]::ParameterName, 'Let a later cheat overwrite an earlier one at the same offset instead of failing')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;bundle' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Write a rom-weaver-bundle.json recipe from local ROM and patch files')
+            [CompletionResult]::new('parse', 'parse', [CompletionResultType]::ParameterValue, 'Read a rom-weaver-bundle.json recipe and report what it points at')
+            [CompletionResult]::new('schema', 'schema', [CompletionResultType]::ParameterValue, 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring')
+            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
+            break
+        }
+        'rom-weaver;bundle;create' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle')
+            [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take the ROM''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)')
+            [CompletionResult]::new('--rom-url', '--rom-url', [CompletionResultType]::ParameterName, 'Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url')
+            [CompletionResult]::new('--rom-name', '--rom-name', [CompletionResultType]::ParameterName, 'Expected source ROM file name to show and use for output naming; a mismatch is advisory')
+            [CompletionResult]::new('--rom-member', '--rom-member', [CompletionResultType]::ParameterName, 'Use this exact archive member or disc track as the bundle ROM target')
+            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to list in the bundle. Repeat once per patch, in the order they should be applied')
+            [CompletionResult]::new('--patch-id', '--patch-id', [CompletionResultType]::ParameterName, 'Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings')
+            [CompletionResult]::new('--patch-version', '--patch-version', [CompletionResultType]::ParameterName, 'Version of the preceding --patch, in whatever form its author uses')
+            [CompletionResult]::new('--patch-name', '--patch-name', [CompletionResultType]::ParameterName, 'Name to show for the preceding --patch')
+            [CompletionResult]::new('--patch-description', '--patch-description', [CompletionResultType]::ParameterName, 'What the preceding --patch does')
+            [CompletionResult]::new('--patch-author', '--patch-author', [CompletionResultType]::ParameterName, 'Who made the preceding --patch')
+            [CompletionResult]::new('--patch-label', '--patch-label', [CompletionResultType]::ParameterName, 'Short status note for the preceding --patch, such as beta or recommended')
+            [CompletionResult]::new('--patch-optional', '--patch-optional', [CompletionResultType]::ParameterName, 'Mark the preceding --patch optional, so it starts switched off and needs --with to run')
+            [CompletionResult]::new('--patch-source-url', '--patch-source-url', [CompletionResultType]::ParameterName, 'Where the preceding --patch can be downloaded from. The local file is still read to build the bundle')
+            [CompletionResult]::new('--patch-header', '--patch-header', [CompletionResultType]::ParameterName, 'Whether the preceding --patch applies to the ROM with or without its copier header: auto, keep, or strip')
+            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Override the preceding --patch input rule: base or previous. Use auto to inherit the bundle rule')
+            [CompletionResult]::new('--default-patch-basis', '--default-patch-basis', [CompletionResultType]::ParameterName, 'Shared input ROM rule recorded in the v2 bundle: auto, base, or previous [default: auto]')
+            [CompletionResult]::new('--patch-expect-in', '--patch-expect-in', [CompletionResultType]::ParameterName, 'Checksum the ROM should have before the preceding --patch runs. Recorded only when it differs from the bundle''s ROM checksums (repeatable, comma-separable)')
+            [CompletionResult]::new('--patch-expect-out', '--patch-expect-out', [CompletionResultType]::ParameterName, 'Checksum the ROM should have after the preceding --patch runs. Recorded only when it differs from the final output checksums (repeatable, comma-separable)')
+            [CompletionResult]::new('--expect-out', '--expect-out', [CompletionResultType]::ParameterName, 'Checksum the ROM should have once every patch has run, so users can confirm they got the right result (repeatable, comma-separable)')
+            [CompletionResult]::new('--output-name', '--output-name', [CompletionResultType]::ParameterName, 'File name the bundle suggests for the patched ROM')
+            [CompletionResult]::new('--output-header', '--output-header', [CompletionResultType]::ParameterName, 'Whether the patched ROM should keep its copier header: auto, keep, or strip')
+            [CompletionResult]::new('--cheat', '--cheat', [CompletionResultType]::ParameterName, 'Database cheat to use, by record ID or exact description. Repeat for each cheat')
+            [CompletionResult]::new('--cheat-database', '--cheat-database', [CompletionResultType]::ParameterName, 'Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory')
+            [CompletionResult]::new('--cheat-system', '--cheat-system', [CompletionResultType]::ParameterName, 'Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say')
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Use this database game ID instead of matching the ROM by checksum or title')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it')
+            [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Also pack the bundle and its ROM and patches into one shareable archive, such as release.zip')
+            [CompletionResult]::new('--bundle-rom', '--bundle-rom', [CompletionResultType]::ParameterName, 'Pack this file into --bundle as the ROM, while --input supplies the checksums and metadata')
+            [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Which checksums to record for the ROM (repeatable, comma-separable) [default: crc32,md5,sha1]')
+            [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Which checksums to record for the ROM (repeatable, comma-separable) [default: crc32,md5,sha1]')
+            [CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'Build the bundle from a hand-written rom-weaver-bundle.json instead of flags. Use - to read it from stdin')
+            [CompletionResult]::new('--schema-ref', '--schema-ref', [CompletionResultType]::ParameterName, 'Record this $schema URL in the bundle so editors can validate it. Left out unless asked for')
+            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--allow-cheat-conflicts', '--allow-cheat-conflicts', [CompletionResultType]::ParameterName, 'Let a later cheat overwrite an earlier one at the same offset instead of failing')
+            [CompletionResult]::new('--no-bundle-rom', '--no-bundle-rom', [CompletionResultType]::ParameterName, 'Keep the ROM out of --bundle and record only its checksums, so whoever applies the bundle brings their own copy')
+            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;bundle;parse' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Bundle file, or an archive with a bundle at its root')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Bundle file, or an archive with a bundle at its root')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Handle only the bundle''s rom entry or only its patch entries (repeatable, comma-separable)')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Directory to unpack the bundle''s files into. Without it, files packed in an archive are listed but not written out')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Directory to unpack the bundle''s files into. Without it, files packed in an archive are listed but not written out')
+            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Report what the bundle contains without unpacking any of it')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;bundle;schema' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;bundle;help' {
+            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Write a rom-weaver-bundle.json recipe from local ROM and patch files')
+            [CompletionResult]::new('parse', 'parse', [CompletionResultType]::ParameterValue, 'Read a rom-weaver-bundle.json recipe and report what it points at')
+            [CompletionResult]::new('schema', 'schema', [CompletionResultType]::ParameterValue, 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring')
+            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
+            break
+        }
+        'rom-weaver;bundle;help;create' {
+            break
+        }
+        'rom-weaver;bundle;help;parse' {
+            break
+        }
+        'rom-weaver;bundle;help;schema' {
+            break
+        }
+        'rom-weaver;bundle;help;help' {
+            break
+        }
+        'rom-weaver;plan-extract-batch' {
+            [CompletionResult]::new('--job-size', '--job-size', [CompletionResultType]::ParameterName, 'Source size in bytes for one job; repeat once per job, in input order')
+            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--max-concurrency', '--max-concurrency', [CompletionResultType]::ParameterName, 'Hard cap on jobs running at once; defaults to the thread budget')
+            [CompletionResult]::new('--total-memory-bytes', '--total-memory-bytes', [CompletionResultType]::ParameterName, 'Total memory budget concurrent jobs may reserve (e.g. browser device memory); defaults to the platform''s physical memory')
+            [CompletionResult]::new('--memory-ceiling-bytes', '--memory-ceiling-bytes', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
+            break
+        }
+        'rom-weaver;completions' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;man' {
+            [CompletionResult]::new('--man-dir', '--man-dir', [CompletionResultType]::ParameterName, 'Directory to install pages into')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--install', '--install', [CompletionResultType]::ParameterName, 'Install the generated pages instead of printing one')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;formats' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;probe' {
             [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
             [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; identify the file itself')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -108,32 +443,26 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
-        'rom-weaver;extract' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Archive or single-payload compressed format to unpack')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Archive or single-payload compressed format to unpack')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin''')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin''')
-            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Directory to write the extracted files into')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Directory to write the extracted files into')
-            [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Also hash every extracted file (repeatable, comma-separable)')
-            [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Also hash every extracted file (repeatable, comma-separable)')
-            [CompletionResult]::new('--checksum-rom', '--checksum-rom', [CompletionResultType]::ParameterName, 'Like --checksum, but hash only the ROMs and skip sidecar files. Cannot be combined with --checksum')
-            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--split-bin', '--split-bin', [CompletionResultType]::ParameterName, 'Write a CD-format CHD as a CUE plus one BIN per track (*.trackNN.bin), rather than one merged BIN')
+        'rom-weaver;inspect' {
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to identify. Use - to read from stdin')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; identify the file itself')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
-            [CompletionResult]::new('--no-nested-extract', '--no-nested-extract', [CompletionResultType]::ParameterName, 'Stop after one layer; leave any archive found inside the input packed')
-            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite files already in the output directory (without this, extraction stops instead)')
-            [CompletionResult]::new('--probe', '--probe', [CompletionResultType]::ParameterName, 'Also report the format and platform of what was extracted, and fail if a lone payload matches no known platform')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -144,8 +473,6 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             break
         }
         'rom-weaver;checksum' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to hash. Use - to read from stdin')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to hash. Use - to read from stdin')
             [CompletionResult]::new('-a', '-a', [CompletionResultType]::ParameterName, 'Which checksum to compute (repeatable, comma-separable)')
             [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Which checksum to compute (repeatable, comma-separable)')
             [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Which checksum to compute (repeatable, comma-separable)')
@@ -156,18 +483,25 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--length', '--length', [CompletionResultType]::ParameterName, 'How many bytes to hash from --start. Defaults to the rest of the file')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to hash. Use - to read from stdin')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to hash. Use - to read from stdin')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; hash the file itself')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
             [CompletionResult]::new('--no-trim-fix', '--no-trim-fix', [CompletionResultType]::ParameterName, 'Skip the extra checksums computed for how a trimmable ROM would hash trimmed or untrimmed')
             [CompletionResult]::new('--probe', '--probe', [CompletionResultType]::ParameterName, 'Also report the platform of the hashed bytes, and fail if it matches no known platform')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--digest', '--digest', [CompletionResultType]::ParameterName, 'Print only the digest; requires one --algo (no labels or elapsed time)')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -185,25 +519,32 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('-d', '-d', [CompletionResultType]::ParameterName, 'RWFP1 identify pack, raw or Brotli, to search instead of the built-in data (repeatable)')
             [CompletionResult]::new('--database', '--database', [CompletionResultType]::ParameterName, 'RWFP1 identify pack, raw or Brotli, to search instead of the built-in data (repeatable)')
             [CompletionResult]::new('--system', '--system', [CompletionResultType]::ParameterName, 'Search only this system''s pack. Takes a canonical platform name or a common alias (e.g. `snes`, `psx`)')
+            [CompletionResult]::new('--name', '--name', [CompletionResultType]::ParameterName, 'Search the database for games whose name matches QUERY, instead of identifying a file or checksum')
+            [CompletionResult]::new('--title-index', '--title-index', [CompletionResultType]::ParameterName, 'Search a cross-platform title index with --name instead of database packs')
+            [CompletionResult]::new('--limit', '--limit', [CompletionResultType]::ParameterName, 'Maximum number of matches --name returns [default: 50]')
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Directory of installed identify packs (*.pack plus optional catalog.json). Defaults to the per-user data directory')
             [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
             [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--offline', '--offline', [CompletionResultType]::ParameterName, 'Assert that identify performs no network access (it never does natively; this flag records the guarantee)')
             [CompletionResult]::new('--exhaustive-database-search', '--exhaustive-database-search', [CompletionResultType]::ParameterName, 'Search every installed pack instead of only the packs the detected platform routes to')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; identify the file itself')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
             [CompletionResult]::new('--no-trim-fix', '--no-trim-fix', [CompletionResultType]::ParameterName, 'Skip extra checksums for trimmed and untrimmed ROM forms')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -216,14 +557,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             break
         }
         'rom-weaver;identify;database' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -245,14 +590,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;identify;database;list' {
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -264,14 +613,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;identify;database;status' {
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -283,14 +636,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;identify;database;path' {
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -302,14 +659,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;identify;database;remove' {
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -321,14 +682,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;identify;database;import-redump' {
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -340,14 +705,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         }
         'rom-weaver;identify;database;install-all' {
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -360,14 +729,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;identify;database;install-group' {
             [CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'Local group archive; omit to download the archive for this version')
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -380,15 +753,19 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;identify;database;install' {
             [CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'Local Redump DAT ZIP file; omit to download from Redump')
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--all', '--all', [CompletionResultType]::ParameterName, 'Install every platform in the dump')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -401,14 +778,18 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;identify;database;update' {
             [CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'Local Redump DAT ZIP file; omit to download from Redump')
             [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Identify database directory. Defaults to the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -508,52 +889,37 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;identify;help;help' {
             break
         }
-        'rom-weaver;setup' {
-            [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Install into this directory instead of the per-user data directory')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Download the database again even when it is already installed')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
-            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
-            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
-            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
-            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            break
-        }
-        'rom-weaver;ingest' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to sort into ROMs and patches')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to sort into ROMs and patches')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Directory to write anything unpacked along the way into')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Directory to write anything unpacked along the way into')
-            [CompletionResult]::new('-d', '-d', [CompletionResultType]::ParameterName, 'RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)')
-            [CompletionResult]::new('--database', '--database', [CompletionResultType]::ParameterName, 'RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--sidecar-name', '--sidecar-name', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--split-bin', '--split-bin', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Which checksums to compute for each ROM found (repeatable, comma-separable) [default: crc32,md5,sha1]')
-            [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Which checksums to compute for each ROM found (repeatable, comma-separable) [default: crc32,md5,sha1]')
+        'rom-weaver;extract' {
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin''')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Extract only these files, by exact name, prefix, or glob (repeatable). For example: --select ''game.disc0?.bin''')
+            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Extract only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
+            [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Also hash every extracted file (repeatable, comma-separable)')
+            [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Also hash every extracted file (repeatable, comma-separable)')
+            [CompletionResult]::new('--checksum-rom', '--checksum-rom', [CompletionResultType]::ParameterName, 'Like --checksum, but hash only the ROMs and skip sidecar files. Cannot be combined with --checksum')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--sidecar-only', '--sidecar-only', [CompletionResultType]::ParameterName, 'sidecar-only')
+            [CompletionResult]::new('--stdin-name', '--stdin-name', [CompletionResultType]::ParameterName, 'Filename for input - (default: stdin.bin); one filename, no directories')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Input path; - reads stdin using a temporary file')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Input path; - reads stdin using a temporary file')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one binary result to stdout (compress requires --format)')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one binary result to stdout (compress requires --format)')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--split-bin', '--split-bin', [CompletionResultType]::ParameterName, 'Write a CD-format CHD as a CUE plus one BIN per track (*.trackNN.bin), rather than one merged BIN')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
             [CompletionResult]::new('--no-nested-extract', '--no-nested-extract', [CompletionResultType]::ParameterName, 'Stop after one layer; leave any archive found inside the input packed')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite files already in the output directory (without this, extraction stops instead)')
+            [CompletionResult]::new('--probe', '--probe', [CompletionResultType]::ParameterName, 'Also report the format and platform of what was extracted, and fail if a lone payload matches no known platform')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -564,27 +930,30 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             break
         }
         'rom-weaver;compress' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, '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')
             [CompletionResult]::new('-f', '-f', [CompletionResultType]::ParameterName, 'Output format, such as zip, 7z, chd, rvz, or z3ds [default: from the --output extension]')
             [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'Output format, such as zip, 7z, chd, rvz, or z3ds [default: from the --output extension]')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the archive')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the archive')
             [CompletionResult]::new('--codec', '--codec', [CompletionResultType]::ParameterName, 'Compression method to use, as codec or codec:level (repeatable, comma-separable)')
             [CompletionResult]::new('--level', '--level', [CompletionResultType]::ParameterName, 'How hard to compress: min, very-low, low, medium, high, very-high, or max')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('--stdin-name', '--stdin-name', [CompletionResultType]::ParameterName, 'Filename for input - (default: stdin.bin); one filename, no directories')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Input path; - reads stdin using a temporary file')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Input path; - reads stdin using a temporary file')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one binary result to stdout (compress requires --format)')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one binary result to stdout (compress requires --format)')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Print the plan (inputs, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Print the plan (inputs, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -595,35 +964,37 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             break
         }
         'rom-weaver;trim' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File or folder to trim. Repeat for each one')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File or folder to trim. Repeat for each one')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the trimmed file. Only valid with a single trimmable input')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the trimmed file. Only valid with a single trimmable input')
             [CompletionResult]::new('-e', '-e', [CompletionResultType]::ParameterName, 'Save next to each original under this extension. {ext} stands for the original one, as in trim.{ext}')
             [CompletionResult]::new('--extension', '--extension', [CompletionResultType]::ParameterName, 'Save next to each original under this extension. {ext} stands for the original one, as in trim.{ext}')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File or folder to trim. Repeat for each one')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File or folder to trim. Repeat for each one')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--in-place', '--in-place', [CompletionResultType]::ParameterName, 'Overwrite the original instead of writing a new file')
-            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Report what would be trimmed without writing anything')
-            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Report what would be trimmed without writing anything')
             [CompletionResult]::new('--revert', '--revert', [CompletionResultType]::ParameterName, 'Pad a trimmed file back to full size (NDS, GBA, and 3DS only)')
             [CompletionResult]::new('--untrim', '--untrim', [CompletionResultType]::ParameterName, 'Pad a trimmed file back to full size (NDS, GBA, and 3DS only)')
             [CompletionResult]::new('--restore', '--restore', [CompletionResultType]::ParameterName, 'Pad a trimmed file back to full size (NDS, GBA, and 3DS only)')
             [CompletionResult]::new('--no-recursive', '--no-recursive', [CompletionResultType]::ParameterName, 'When an input is a folder, look only at its top level')
             [CompletionResult]::new('--no-filter', '--no-filter', [CompletionResultType]::ParameterName, 'Consider every file inside an archive, not just the ones that look like ROMs')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; trim only the files named directly')
-            [CompletionResult]::new('--revert-marker', '--revert-marker', [CompletionResultType]::ParameterName, 'Add a small footer recording what was cut, so --revert can restore the original exactly')
-            [CompletionResult]::new('--reversible', '--reversible', [CompletionResultType]::ParameterName, 'Add a small footer recording what was cut, so --revert can restore the original exactly')
+            [CompletionResult]::new('--revert-marker', '--revert-marker', [CompletionResultType]::ParameterName, 'Add a footer with the original size and a fill byte for --revert')
+            [CompletionResult]::new('--reversible', '--reversible', [CompletionResultType]::ParameterName, 'Add a footer with the original size and a fill byte for --revert')
             [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -633,30 +1004,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
-        'rom-weaver;patch' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
-            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
-            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
-            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
-            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
-            [CompletionResult]::new('apply', 'apply', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
-            [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
-            [CompletionResult]::new('validate', 'validate', [CompletionResultType]::ParameterValue, 'Check that patches would apply cleanly, without writing anything')
-            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Build a patch from an original ROM and a changed one')
-            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
-            break
-        }
-        'rom-weaver;patch;apply' {
+        'rom-weaver;weave' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, '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')
@@ -665,8 +1013,6 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
             [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
             [CompletionResult]::new('--with', '--with', [CompletionResultType]::ParameterName, 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)')
             [CompletionResult]::new('--without', '--without', [CompletionResultType]::ParameterName, 'Turn off a bundle patch, matched by name or file name (repeatable)')
@@ -679,34 +1025,47 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)')
             [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)')
             [CompletionResult]::new('--patch-header', '--patch-header', [CompletionResultType]::ParameterName, 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]')
-            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]')
+            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Override the preceding --patch input rule: auto, base, or previous')
+            [CompletionResult]::new('--patch-input-check', '--patch-input-check', [CompletionResultType]::ParameterName, 'Expected input checks for the preceding patch (repeatable, comma-separable)')
+            [CompletionResult]::new('--patch-output-check', '--patch-output-check', [CompletionResultType]::ParameterName, 'Expected output checks for the preceding patch (repeatable, comma-separable)')
+            [CompletionResult]::new('--default-patch-basis', '--default-patch-basis', [CompletionResultType]::ParameterName, 'Shared input ROM rule for every patch: auto, base, or previous [default: auto]')
             [CompletionResult]::new('--output-header', '--output-header', [CompletionResultType]::ParameterName, 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]')
             [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
             [CompletionResult]::new('--expect-out', '--expect-out', [CompletionResultType]::ParameterName, 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)')
             [CompletionResult]::new('--code', '--code', [CompletionResultType]::ParameterName, 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code')
-            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, gameboy, gba, psx), when the ROM header does not say')
+            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say')
             [CompletionResult]::new('--code-kind', '--code-kind', [CompletionResultType]::ParameterName, 'Which cheat scheme the --code values use: auto, game-genie, gameshark/par, or xploder')
+            [CompletionResult]::new('--cheat', '--cheat', [CompletionResultType]::ParameterName, 'Database cheat to use, by record ID or exact description. Repeat for each cheat')
+            [CompletionResult]::new('--cheat-database', '--cheat-database', [CompletionResultType]::ParameterName, 'Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory')
+            [CompletionResult]::new('--cheat-system', '--cheat-system', [CompletionResultType]::ParameterName, 'Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say')
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Use this database game ID instead of matching the ROM by checksum or title')
             [CompletionResult]::new('--emit-bundle', '--emit-bundle', [CompletionResultType]::ParameterName, 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; treat the input and every patch as raw files')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
+            [CompletionResult]::new('--without-cheats', '--without-cheats', [CompletionResultType]::ParameterName, 'Ignore every cheat the bundle records and run only its patch chain')
             [CompletionResult]::new('--no-compress', '--no-compress', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
             [CompletionResult]::new('--raw', '--raw', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
             [CompletionResult]::new('--repair-checksum', '--repair-checksum', [CompletionResultType]::ParameterName, 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)')
             [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Apply the patch even when its own checksums do not match. Can produce a broken ROM')
+            [CompletionResult]::new('--allow-cheat-conflicts', '--allow-cheat-conflicts', [CompletionResultType]::ParameterName, 'Let a later cheat overwrite an earlier one at the same offset instead of failing')
             [CompletionResult]::new('--tui', '--tui', [CompletionResultType]::ParameterName, 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal')
             [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -716,7 +1075,78 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
-        'rom-weaver;patch;weave' {
+        'rom-weaver;patch' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('validate', 'validate', [CompletionResultType]::ParameterValue, 'Check that patches would apply cleanly, without writing anything')
+            [CompletionResult]::new('apply', 'apply', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
+            [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
+            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Build a patch from an original ROM and a changed one')
+            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
+            break
+        }
+        'rom-weaver;patch;validate' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to check the patches against. May be an archive')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to check the patches against. May be an archive')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
+            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to check. Repeat once per patch; they are checked in the order given')
+            [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
+            [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)')
+            [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Fail unless the ROM matches: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable')
+            [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in before checking: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
+            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Override the preceding --patch input rule: auto, base, or previous')
+            [CompletionResult]::new('--default-patch-basis', '--default-patch-basis', [CompletionResultType]::ParameterName, 'Shared input ROM rule for every patch: auto, base, or previous [default: auto]')
+            [CompletionResult]::new('--patch-input-check', '--patch-input-check', [CompletionResultType]::ParameterName, 'Checksum the preceding --patch expects to see going in, when the patch does not carry one (comma-separable; empty means none)')
+            [CompletionResult]::new('--patch-output-check', '--patch-output-check', [CompletionResultType]::ParameterName, 'Checksum the preceding --patch should produce, when the patch does not carry one (comma-separable; empty means none)')
+            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; treat the input and every patch as raw files')
+            [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
+            [CompletionResult]::new('--strip-header', '--strip-header', [CompletionResultType]::ParameterName, 'Remove the ROM''s copier header before checking (A78, LNX, NES, FDS, SMC signatures, plus the SNES and PCE size rules)')
+            [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Report a patch as usable even when its own checksums do not match')
+            [CompletionResult]::new('--independent', '--independent', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--plan', '--plan', [CompletionResultType]::ParameterName, 'Report the order the patches would run in and what each would be checked against, without reading the ROM more than needed')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
+        'rom-weaver;patch;apply' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, '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')
@@ -725,8 +1155,6 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
             [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
             [CompletionResult]::new('--with', '--with', [CompletionResultType]::ParameterName, 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)')
             [CompletionResult]::new('--without', '--without', [CompletionResultType]::ParameterName, 'Turn off a bundle patch, matched by name or file name (repeatable)')
@@ -739,34 +1167,47 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)')
             [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)')
             [CompletionResult]::new('--patch-header', '--patch-header', [CompletionResultType]::ParameterName, 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]')
-            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]')
+            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Override the preceding --patch input rule: auto, base, or previous')
+            [CompletionResult]::new('--patch-input-check', '--patch-input-check', [CompletionResultType]::ParameterName, 'Expected input checks for the preceding patch (repeatable, comma-separable)')
+            [CompletionResult]::new('--patch-output-check', '--patch-output-check', [CompletionResultType]::ParameterName, 'Expected output checks for the preceding patch (repeatable, comma-separable)')
+            [CompletionResult]::new('--default-patch-basis', '--default-patch-basis', [CompletionResultType]::ParameterName, 'Shared input ROM rule for every patch: auto, base, or previous [default: auto]')
             [CompletionResult]::new('--output-header', '--output-header', [CompletionResultType]::ParameterName, 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]')
             [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
             [CompletionResult]::new('--expect-out', '--expect-out', [CompletionResultType]::ParameterName, 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)')
             [CompletionResult]::new('--code', '--code', [CompletionResultType]::ParameterName, 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code')
-            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, gameboy, gba, psx), when the ROM header does not say')
+            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say')
             [CompletionResult]::new('--code-kind', '--code-kind', [CompletionResultType]::ParameterName, 'Which cheat scheme the --code values use: auto, game-genie, gameshark/par, or xploder')
+            [CompletionResult]::new('--cheat', '--cheat', [CompletionResultType]::ParameterName, 'Database cheat to use, by record ID or exact description. Repeat for each cheat')
+            [CompletionResult]::new('--cheat-database', '--cheat-database', [CompletionResultType]::ParameterName, 'Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory')
+            [CompletionResult]::new('--cheat-system', '--cheat-system', [CompletionResultType]::ParameterName, 'Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say')
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Use this database game ID instead of matching the ROM by checksum or title')
             [CompletionResult]::new('--emit-bundle', '--emit-bundle', [CompletionResultType]::ParameterName, 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; treat the input and every patch as raw files')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
+            [CompletionResult]::new('--without-cheats', '--without-cheats', [CompletionResultType]::ParameterName, 'Ignore every cheat the bundle records and run only its patch chain')
             [CompletionResult]::new('--no-compress', '--no-compress', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
             [CompletionResult]::new('--raw', '--raw', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
             [CompletionResult]::new('--repair-checksum', '--repair-checksum', [CompletionResultType]::ParameterName, 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)')
             [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Apply the patch even when its own checksums do not match. Can produce a broken ROM')
+            [CompletionResult]::new('--allow-cheat-conflicts', '--allow-cheat-conflicts', [CompletionResultType]::ParameterName, 'Let a later cheat overwrite an earlier one at the same offset instead of failing')
             [CompletionResult]::new('--tui', '--tui', [CompletionResultType]::ParameterName, 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal')
             [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -776,36 +1217,68 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
-        'rom-weaver;patch;validate' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to check the patches against. May be an archive')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to check the patches against. May be an archive')
+        'rom-weaver;patch;weave' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, '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')
             [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, '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')
+            [CompletionResult]::new('--target', '--target', [CompletionResultType]::ParameterName, 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
-            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to check. Repeat once per patch; they are checked in the order given')
+            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
             [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
+            [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
+            [CompletionResult]::new('--with', '--with', [CompletionResultType]::ParameterName, 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)')
+            [CompletionResult]::new('--without', '--without', [CompletionResultType]::ParameterName, 'Turn off a bundle patch, matched by name or file name (repeatable)')
+            [CompletionResult]::new('--compress-format', '--compress-format', [CompletionResultType]::ParameterName, 'Format to compress the patched ROM into [default: from the --output extension]')
+            [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'Format to compress the patched ROM into [default: from the --output extension]')
+            [CompletionResult]::new('--compress-codec', '--compress-codec', [CompletionResultType]::ParameterName, 'Compression method to use, as codec or codec:level (repeatable, comma-separable)')
+            [CompletionResult]::new('--codec', '--codec', [CompletionResultType]::ParameterName, 'Compression method to use, as codec or codec:level (repeatable, comma-separable)')
+            [CompletionResult]::new('--compress-level', '--compress-level', [CompletionResultType]::ParameterName, 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]')
+            [CompletionResult]::new('--level', '--level', [CompletionResultType]::ParameterName, 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]')
             [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)')
-            [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Fail unless the ROM matches: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable')
-            [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in before checking: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
-            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]')
-            [CompletionResult]::new('--patch-input-check', '--patch-input-check', [CompletionResultType]::ParameterName, 'Checksum the preceding --patch expects to see going in, when the patch does not carry one (comma-separable; empty means none)')
-            [CompletionResult]::new('--patch-output-check', '--patch-output-check', [CompletionResultType]::ParameterName, 'Checksum the preceding --patch should produce, when the patch does not carry one (comma-separable; empty means none)')
+            [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)')
+            [CompletionResult]::new('--patch-header', '--patch-header', [CompletionResultType]::ParameterName, 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]')
+            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Override the preceding --patch input rule: auto, base, or previous')
+            [CompletionResult]::new('--patch-input-check', '--patch-input-check', [CompletionResultType]::ParameterName, 'Expected input checks for the preceding patch (repeatable, comma-separable)')
+            [CompletionResult]::new('--patch-output-check', '--patch-output-check', [CompletionResultType]::ParameterName, 'Expected output checks for the preceding patch (repeatable, comma-separable)')
+            [CompletionResult]::new('--default-patch-basis', '--default-patch-basis', [CompletionResultType]::ParameterName, 'Shared input ROM rule for every patch: auto, base, or previous [default: auto]')
+            [CompletionResult]::new('--output-header', '--output-header', [CompletionResultType]::ParameterName, 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]')
+            [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
+            [CompletionResult]::new('--expect-out', '--expect-out', [CompletionResultType]::ParameterName, 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)')
+            [CompletionResult]::new('--code', '--code', [CompletionResultType]::ParameterName, 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code')
+            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say')
+            [CompletionResult]::new('--code-kind', '--code-kind', [CompletionResultType]::ParameterName, 'Which cheat scheme the --code values use: auto, game-genie, gameshark/par, or xploder')
+            [CompletionResult]::new('--cheat', '--cheat', [CompletionResultType]::ParameterName, 'Database cheat to use, by record ID or exact description. Repeat for each cheat')
+            [CompletionResult]::new('--cheat-database', '--cheat-database', [CompletionResultType]::ParameterName, 'Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory')
+            [CompletionResult]::new('--cheat-system', '--cheat-system', [CompletionResultType]::ParameterName, 'Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say')
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Use this database game ID instead of matching the ROM by checksum or title')
+            [CompletionResult]::new('--emit-bundle', '--emit-bundle', [CompletionResultType]::ParameterName, 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; treat the input and every patch as raw files')
             [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
-            [CompletionResult]::new('--strip-header', '--strip-header', [CompletionResultType]::ParameterName, 'Remove the ROM''s copier header before checking (A78, LNX, NES, FDS, SMC signatures, plus the SNES and PCE size rules)')
-            [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Report a patch as usable even when its own checksums do not match')
-            [CompletionResult]::new('--independent', '--independent', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--plan', '--plan', [CompletionResultType]::ParameterName, 'Report the order the patches would run in and what each would be checked against, without reading the ROM more than needed')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--without-cheats', '--without-cheats', [CompletionResultType]::ParameterName, 'Ignore every cheat the bundle records and run only its patch chain')
+            [CompletionResult]::new('--no-compress', '--no-compress', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
+            [CompletionResult]::new('--raw', '--raw', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
+            [CompletionResult]::new('--repair-checksum', '--repair-checksum', [CompletionResultType]::ParameterName, 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)')
+            [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Apply the patch even when its own checksums do not match. Can produce a broken ROM')
+            [CompletionResult]::new('--allow-cheat-conflicts', '--allow-cheat-conflicts', [CompletionResultType]::ParameterName, 'Let a later cheat overwrite an earlier one at the same offset instead of failing')
+            [CompletionResult]::new('--tui', '--tui', [CompletionResultType]::ParameterName, 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal')
+            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -820,12 +1293,14 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--modified', '--modified', [CompletionResultType]::ParameterName, 'The changed ROM. Leave out when using --code, which produces the changed ROM for you')
             [CompletionResult]::new('-f', '-f', [CompletionResultType]::ParameterName, 'Patch format, such as bps, ips, or xdelta [default: from the --output extension]')
             [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'Patch format, such as bps, ips, or xdelta [default: from the --output extension]')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patch. Required unless --plan is used')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patch. Required unless --plan is used')
             [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take the original ROM''s checksum on trust rather than reading the file, as in crc32=1234abcd (repeatable, comma-separable)')
             [CompletionResult]::new('--code', '--code', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, gameboy, gba, psx), when the ROM header does not say')
+            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, 32x, sms, gamegear, sg1000, gameboy, gba, psx), when the ROM header does not say')
             [CompletionResult]::new('--code-kind', '--code-kind', [CompletionResultType]::ParameterName, 'Which cheat scheme the --code values use: auto, game-genie, gameshark/par, or xploder')
+            [CompletionResult]::new('--cheat', '--cheat', [CompletionResultType]::ParameterName, 'Database cheat to use, by record ID or exact description. Repeat for each cheat')
+            [CompletionResult]::new('--cheat-database', '--cheat-database', [CompletionResultType]::ParameterName, 'Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per-user data directory')
+            [CompletionResult]::new('--cheat-system', '--cheat-system', [CompletionResultType]::ParameterName, 'Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy-color, gba), when the ROM header does not say')
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Use this database game ID instead of matching the ROM by checksum or title')
             [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
             [CompletionResult]::new('--solid-system', '--solid-system', [CompletionResultType]::ParameterName, 'SOLID patches only: console the ROM is for')
@@ -836,19 +1311,26 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--solid-contact', '--solid-contact', [CompletionResultType]::ParameterName, 'SOLID patches only: how to reach the author. Switches the patch to its extended header')
             [CompletionResult]::new('--solid-comment', '--solid-comment', [CompletionResultType]::ParameterName, 'SOLID patches only: free-form note. Switches the patch to its extended header')
             [CompletionResult]::new('--xdelta-secondary', '--xdelta-secondary', [CompletionResultType]::ParameterName, 'xdelta patches only: compress the patch''s own contents')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
             [CompletionResult]::new('--plan', '--plan', [CompletionResultType]::ParameterName, 'Only report which formats suit these two ROMs; write nothing')
             [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Write the patch even when the format''s own consistency checks fail, and leave its checksums out')
             [CompletionResult]::new('--checksum-name', '--checksum-name', [CompletionResultType]::ParameterName, 'Put the original ROM''s crc32 in the patch file name, as [crc32:HEX]')
+            [CompletionResult]::new('--allow-cheat-conflicts', '--allow-cheat-conflicts', [CompletionResultType]::ParameterName, 'Let a later cheat overwrite an earlier one at the same offset instead of failing')
             [CompletionResult]::new('--solid-extended', '--solid-extended', [CompletionResultType]::ParameterName, 'SOLID patches only: use the extended header even with none of the extended fields filled in')
             [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -859,16 +1341,16 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             break
         }
         'rom-weaver;patch;help' {
-            [CompletionResult]::new('apply', 'apply', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
             [CompletionResult]::new('validate', 'validate', [CompletionResultType]::ParameterValue, 'Check that patches would apply cleanly, without writing anything')
+            [CompletionResult]::new('apply', 'apply', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
             [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Build a patch from an original ROM and a changed one')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;patch;help;apply' {
+        'rom-weaver;patch;help;validate' {
             break
         }
-        'rom-weaver;patch;help;validate' {
+        'rom-weaver;patch;help;apply' {
             break
         }
         'rom-weaver;patch;help;create' {
@@ -877,15 +1359,19 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;patch;help;help' {
             break
         }
-        'rom-weaver;bundle' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -893,137 +1379,101 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
-            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Write a rom-weaver-bundle.json recipe from local ROM and patch files')
-            [CompletionResult]::new('parse', 'parse', [CompletionResultType]::ParameterValue, 'Read a rom-weaver-bundle.json recipe and report what it points at')
-            [CompletionResult]::new('schema', 'schema', [CompletionResultType]::ParameterValue, 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring')
+            [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a supported game save without changing it')
+            [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Show the sections and fields in a supported game save')
+            [CompletionResult]::new('get', 'get', [CompletionResultType]::ParameterValue, 'Read one field from a supported game save')
+            [CompletionResult]::new('export-schema', 'export-schema', [CompletionResultType]::ParameterValue, 'Print the generic field schema for a supported game save')
+            [CompletionResult]::new('set', 'set', [CompletionResultType]::ParameterValue, 'Write validated field changes to a new game save')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;bundle;create' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM the patches apply to. Its checksums and size are read from the file and recorded in the bundle')
-            [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take the ROM''s checksum and size on trust rather than reading it, as in crc32=1234abcd,size=1048576 (repeatable, comma-separable)')
-            [CompletionResult]::new('--rom-url', '--rom-url', [CompletionResultType]::ParameterName, 'Where the ROM can be downloaded from. With --input, the local file still supplies the checksums; on its own, the bundle records only this url')
-            [CompletionResult]::new('--rom-name', '--rom-name', [CompletionResultType]::ParameterName, 'Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns')
-            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to list in the bundle. Repeat once per patch, in the order they should be applied')
-            [CompletionResult]::new('--patch-id', '--patch-id', [CompletionResultType]::ParameterName, 'Identifier for the preceding --patch that stays the same across releases, so a replacement keeps its settings')
-            [CompletionResult]::new('--patch-version', '--patch-version', [CompletionResultType]::ParameterName, 'Version of the preceding --patch, in whatever form its author uses')
-            [CompletionResult]::new('--patch-name', '--patch-name', [CompletionResultType]::ParameterName, 'Name to show for the preceding --patch')
-            [CompletionResult]::new('--patch-description', '--patch-description', [CompletionResultType]::ParameterName, 'What the preceding --patch does')
-            [CompletionResult]::new('--patch-author', '--patch-author', [CompletionResultType]::ParameterName, 'Who made the preceding --patch')
-            [CompletionResult]::new('--patch-label', '--patch-label', [CompletionResultType]::ParameterName, 'Short status note for the preceding --patch, such as beta or recommended')
-            [CompletionResult]::new('--patch-optional', '--patch-optional', [CompletionResultType]::ParameterName, 'Mark the preceding --patch optional, so it starts switched off and needs --with to run')
-            [CompletionResult]::new('--patch-source-url', '--patch-source-url', [CompletionResultType]::ParameterName, 'Where the preceding --patch can be downloaded from. The local file is still read to build the bundle')
-            [CompletionResult]::new('--patch-header', '--patch-header', [CompletionResultType]::ParameterName, 'Whether the preceding --patch applies to the ROM with or without its copier header: auto, keep, or strip')
-            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--patch-expect-in', '--patch-expect-in', [CompletionResultType]::ParameterName, 'Checksum the ROM should have before the preceding --patch runs. Recorded only when it differs from the bundle''s ROM checksums (repeatable, comma-separable)')
-            [CompletionResult]::new('--patch-expect-out', '--patch-expect-out', [CompletionResultType]::ParameterName, 'Checksum the ROM should have after the preceding --patch runs. Recorded only when it differs from the final output checksums (repeatable, comma-separable)')
-            [CompletionResult]::new('--expect-out', '--expect-out', [CompletionResultType]::ParameterName, 'Checksum the ROM should have once every patch has run, so users can confirm they got the right result (repeatable, comma-separable)')
-            [CompletionResult]::new('--output-name', '--output-name', [CompletionResultType]::ParameterName, 'File name the bundle suggests for the patched ROM')
-            [CompletionResult]::new('--output-header', '--output-header', [CompletionResultType]::ParameterName, 'Whether the patched ROM should keep its copier header: auto, keep, or strip')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the bundle. Name it rom-weaver-bundle.json, or add .gz or .zst to compress it')
-            [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Also pack the bundle and its ROM and patches into one shareable archive, such as release.zip')
-            [CompletionResult]::new('--bundle-rom', '--bundle-rom', [CompletionResultType]::ParameterName, 'Pack this file into --bundle as the ROM, while --input supplies the checksums and metadata')
-            [CompletionResult]::new('--checksum', '--checksum', [CompletionResultType]::ParameterName, 'Which checksums to record for the ROM (repeatable, comma-separable) [default: crc32,md5,sha1]')
-            [CompletionResult]::new('--algo', '--algo', [CompletionResultType]::ParameterName, 'Which checksums to record for the ROM (repeatable, comma-separable) [default: crc32,md5,sha1]')
-            [CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'Build the bundle from a hand-written rom-weaver-bundle.json instead of flags. Use - to read it from stdin')
-            [CompletionResult]::new('--schema-ref', '--schema-ref', [CompletionResultType]::ParameterName, 'Record this $schema URL in the bundle so editors can validate it. Left out unless asked for')
-            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--no-bundle-rom', '--no-bundle-rom', [CompletionResultType]::ParameterName, 'Keep the ROM out of --bundle and record only its checksums, so whoever applies the bundle brings their own copy')
-            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save;identify' {
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Force a game id instead of detecting one')
+            [CompletionResult]::new('--rom-sha1', '--rom-sha1', [CompletionResultType]::ParameterName, 'SHA-1 of the matching ROM, used to pick a game')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
             [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
             break
         }
-        'rom-weaver;bundle;parse' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'Bundle file, or an archive with a bundle at its root')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'Bundle file, or an archive with a bundle at its root')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Handle only the bundle entries whose file name matches this exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Handle only the bundle''s rom entry or only its patch entries (repeatable, comma-separable)')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Directory to unpack the bundle''s files into. Without it, files packed in an archive are listed but not written out')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Directory to unpack the bundle''s files into. Without it, files packed in an archive are listed but not written out')
-            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Report what the bundle contains without unpacking any of it')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save;inspect' {
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Force a game id instead of detecting one')
+            [CompletionResult]::new('--rom-sha1', '--rom-sha1', [CompletionResultType]::ParameterName, 'SHA-1 of the matching ROM, used to pick a game')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
             [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
             break
         }
-        'rom-weaver;bundle;schema' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save;get' {
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Force a game id instead of detecting one')
+            [CompletionResult]::new('--rom-sha1', '--rom-sha1', [CompletionResultType]::ParameterName, 'SHA-1 of the matching ROM, used to pick a game')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
             [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            break
-        }
-        'rom-weaver;bundle;help' {
-            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Write a rom-weaver-bundle.json recipe from local ROM and patch files')
-            [CompletionResult]::new('parse', 'parse', [CompletionResultType]::ParameterValue, 'Read a rom-weaver-bundle.json recipe and report what it points at')
-            [CompletionResult]::new('schema', 'schema', [CompletionResultType]::ParameterValue, 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring')
-            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
-            break
-        }
-        'rom-weaver;bundle;help;create' {
-            break
-        }
-        'rom-weaver;bundle;help;parse' {
-            break
-        }
-        'rom-weaver;bundle;help;schema' {
-            break
-        }
-        'rom-weaver;bundle;help;help' {
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
             break
         }
-        'rom-weaver;tools' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save;export-schema' {
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Force a game id instead of detecting one')
+            [CompletionResult]::new('--rom-sha1', '--rom-sha1', [CompletionResultType]::ParameterName, 'SHA-1 of the matching ROM, used to pick a game')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -1031,59 +1481,75 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
-            [CompletionResult]::new('ppf-undo', 'ppf-undo', [CompletionResultType]::ParameterValue, 'Undo a PPF3 patch, using the undo data stored inside it')
-            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;tools;ppf-undo' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'The already-patched ROM to undo')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'The already-patched ROM to undo')
-            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'The PPF3 patch that was applied. It must carry undo data')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the restored ROM')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the restored ROM')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save;set' {
+            [CompletionResult]::new('--game', '--game', [CompletionResultType]::ParameterName, 'Force a game id instead of detecting one')
+            [CompletionResult]::new('--rom-sha1', '--rom-sha1', [CompletionResultType]::ParameterName, 'SHA-1 of the matching ROM, used to pick a game')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Validate and preview every change without writing a file')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Validate and preview every change without writing a file')
+            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite an explicit output path if it already exists')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
             [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
             break
         }
-        'rom-weaver;tools;help' {
-            [CompletionResult]::new('ppf-undo', 'ppf-undo', [CompletionResultType]::ParameterValue, 'Undo a PPF3 patch, using the undo data stored inside it')
+        'rom-weaver;save;help' {
+            [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a supported game save without changing it')
+            [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Show the sections and fields in a supported game save')
+            [CompletionResult]::new('get', 'get', [CompletionResultType]::ParameterValue, 'Read one field from a supported game save')
+            [CompletionResult]::new('export-schema', 'export-schema', [CompletionResultType]::ParameterValue, 'Print the generic field schema for a supported game save')
+            [CompletionResult]::new('set', 'set', [CompletionResultType]::ParameterValue, 'Write validated field changes to a new game save')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;tools;help;ppf-undo' {
+        'rom-weaver;save;help;identify' {
             break
         }
-        'rom-weaver;tools;help;help' {
+        'rom-weaver;save;help;inspect' {
             break
         }
-        'rom-weaver;plan-extract-batch' {
-            [CompletionResult]::new('--job-size', '--job-size', [CompletionResultType]::ParameterName, 'Source size in bytes for one job; repeat once per job, in input order')
-            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--max-concurrency', '--max-concurrency', [CompletionResultType]::ParameterName, 'Hard cap on jobs running at once; defaults to the thread budget')
-            [CompletionResult]::new('--total-memory-bytes', '--total-memory-bytes', [CompletionResultType]::ParameterName, 'Total memory budget concurrent jobs may reserve (e.g. browser device memory); defaults to the platform''s physical memory')
-            [CompletionResult]::new('--memory-ceiling-bytes', '--memory-ceiling-bytes', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;save;help;get' {
+            break
+        }
+        'rom-weaver;save;help;export-schema' {
+            break
+        }
+        'rom-weaver;save;help;set' {
+            break
+        }
+        'rom-weaver;save;help;help' {
+            break
+        }
+        'rom-weaver;tools' {
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -1091,59 +1557,28 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
             [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
+            [CompletionResult]::new('ppf-undo', 'ppf-undo', [CompletionResultType]::ParameterValue, 'Undo a PPF3 patch, using the undo data stored inside it')
+            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;weave' {
-            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
-            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, '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')
-            [CompletionResult]::new('--target', '--target', [CompletionResultType]::ParameterName, 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track')
-            [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
-            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
-            [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
-            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
-            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
-            [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
-            [CompletionResult]::new('--with', '--with', [CompletionResultType]::ParameterName, 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)')
-            [CompletionResult]::new('--without', '--without', [CompletionResultType]::ParameterName, 'Turn off a bundle patch, matched by name or file name (repeatable)')
-            [CompletionResult]::new('--compress-format', '--compress-format', [CompletionResultType]::ParameterName, 'Format to compress the patched ROM into [default: from the --output extension]')
-            [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'Format to compress the patched ROM into [default: from the --output extension]')
-            [CompletionResult]::new('--compress-codec', '--compress-codec', [CompletionResultType]::ParameterName, 'Compression method to use, as codec or codec:level (repeatable, comma-separable)')
-            [CompletionResult]::new('--codec', '--codec', [CompletionResultType]::ParameterName, 'Compression method to use, as codec or codec:level (repeatable, comma-separable)')
-            [CompletionResult]::new('--compress-level', '--compress-level', [CompletionResultType]::ParameterName, 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]')
-            [CompletionResult]::new('--level', '--level', [CompletionResultType]::ParameterName, 'How hard to compress: min, very-low, low, medium, high, very-high, or max [default: max]')
-            [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)')
-            [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Stop unless the ROM about to be patched has this checksum, as in crc32=1234abcd (repeatable, comma-separable)')
-            [CompletionResult]::new('--patch-header', '--patch-header', [CompletionResultType]::ParameterName, 'Whether a patch applies to the ROM with or without its copier header: auto, keep, or strip [default: auto]')
-            [CompletionResult]::new('--patch-basis', '--patch-basis', [CompletionResultType]::ParameterName, 'Which ROM the preceding --patch was built against: auto, base, or previous [default: auto]')
-            [CompletionResult]::new('--output-header', '--output-header', [CompletionResultType]::ParameterName, 'Whether the finished ROM keeps its copier header: auto, keep, or strip [default: auto]')
-            [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in for each patch: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
-            [CompletionResult]::new('--expect-out', '--expect-out', [CompletionResultType]::ParameterName, 'Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma-separable)')
-            [CompletionResult]::new('--code', '--code', [CompletionResultType]::ParameterName, 'Game Genie or GameShark/Pro Action Replay code to bake into the ROM. Repeat for each code')
-            [CompletionResult]::new('--code-system', '--code-system', [CompletionResultType]::ParameterName, 'Console the --code values are for (nes, snes, genesis, gameboy, gba, psx), when the ROM header does not say')
-            [CompletionResult]::new('--code-kind', '--code-kind', [CompletionResultType]::ParameterName, 'Which cheat scheme the --code values use: auto, game-genie, gameshark/par, or xploder')
-            [CompletionResult]::new('--emit-bundle', '--emit-bundle', [CompletionResultType]::ParameterName, 'Also write a rom-weaver-bundle.json recording this run, so someone else can repeat it')
-            [CompletionResult]::new('-j', '-j', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--threads', '--threads', [CompletionResultType]::ParameterName, 'How many threads to use at most. auto uses every core; a format may still use fewer')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--no-extract', '--no-extract', [CompletionResultType]::ParameterName, 'Do not look inside archives; treat the input and every patch as raw files')
-            [CompletionResult]::new('--no-ignore', '--no-ignore', [CompletionResultType]::ParameterName, 'Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store')
-            [CompletionResult]::new('--no-compress', '--no-compress', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
-            [CompletionResult]::new('--raw', '--raw', [CompletionResultType]::ParameterName, 'Write a plain ROM instead of compressing the result')
-            [CompletionResult]::new('--repair-checksum', '--repair-checksum', [CompletionResultType]::ParameterName, 'Recompute the ROM''s internal header checksum afterwards, so the console does not reject it (SNES, NES, GB, GBA, Mega Drive, SMS, N64, NDS)')
-            [CompletionResult]::new('--ignore-checksum-validation', '--ignore-checksum-validation', [CompletionResultType]::ParameterName, 'Apply the patch even when its own checksums do not match. Can produce a broken ROM')
-            [CompletionResult]::new('--tui', '--tui', [CompletionResultType]::ParameterName, 'Ask for each patch''s name, version, and author, then apply and write a bundle. Needs a terminal')
-            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Overwrite the output if it already exists (without this, the command stops instead)')
-            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+        'rom-weaver;tools;ppf-undo' {
+            [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'The already-patched ROM to undo')
+            [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'The already-patched ROM to undo')
+            [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'The PPF3 patch that was applied. It must carry undo data')
+            [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Output path; - writes one completed binary file to stdout')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: warn]')
+            [CompletionResult]::new('-n', '-n', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--dry-run', '--dry-run', [CompletionResultType]::ParameterName, 'Plan the command without changing files or downloading data')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one complete JSON report; progress and diagnostics use stderr')
+            [CompletionResult]::new('--jsonl', '--jsonl', [CompletionResultType]::ParameterName, 'Stream JSON events, including progress, one object per line')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress on stderr (off by default; JSONL includes progress)')
             [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Show user diagnostics on stderr; repeat for developer detail (-vv debug, -vvv trace)')
+            [CompletionResult]::new('--debug', '--debug', [CompletionResultType]::ParameterName, 'Show developer diagnostics and trace events on stderr (same as -vvv)')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Hide optional diagnostics and progress; keep results, warnings, and errors')
             [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
             [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
             [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
@@ -1153,86 +1588,76 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
-        'rom-weaver;completions' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
-            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
-            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
-            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
-            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+        'rom-weaver;tools;help' {
+            [CompletionResult]::new('ppf-undo', 'ppf-undo', [CompletionResultType]::ParameterValue, 'Undo a PPF3 patch, using the undo data stored inside it')
+            [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;man' {
-            [CompletionResult]::new('--man-dir', '--man-dir', [CompletionResultType]::ParameterName, 'Directory to install pages into')
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--install', '--install', [CompletionResultType]::ParameterName, 'Install the generated pages instead of printing one')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
-            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
-            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
-            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
-            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+        'rom-weaver;tools;help;ppf-undo' {
             break
         }
-        'rom-weaver;formats' {
-            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
-            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
-            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
-            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
-            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
-            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
-            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
-            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
-            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
-            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
-            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
-            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+        'rom-weaver;tools;help;help' {
             break
         }
         'rom-weaver;help' {
-            [CompletionResult]::new('probe', 'probe', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
-            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
-            [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
-            [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a ROM title from its checksums')
             [CompletionResult]::new('setup', 'setup', [CompletionResultType]::ParameterValue, 'Install the offline identify database')
             [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
-            [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
-            [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
-            [CompletionResult]::new('patch', 'patch', [CompletionResultType]::ParameterValue, 'Apply, create, or check ROM patches')
+            [CompletionResult]::new('cheat', 'cheat', [CompletionResultType]::ParameterValue, 'List the cheat database''s entries for a ROM')
             [CompletionResult]::new('bundle', 'bundle', [CompletionResultType]::ParameterValue, 'Build and read rom-weaver-bundle.json patch recipes')
-            [CompletionResult]::new('tools', 'tools', [CompletionResultType]::ParameterValue, 'One-off recovery tools')
             [CompletionResult]::new('plan-extract-batch', 'plan-extract-batch', [CompletionResultType]::ParameterValue, 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)')
-            [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order (same as `patch apply`)')
             [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a tab-completion script for your shell')
             [CompletionResult]::new('man', 'man', [CompletionResultType]::ParameterValue, 'Print or install the generated CLI man pages')
             [CompletionResult]::new('formats', 'formats', [CompletionResultType]::ParameterValue, 'List the formats, codecs, and checksum algorithms this build supports')
+            [CompletionResult]::new('probe', 'probe', [CompletionResultType]::ParameterValue, 'Identify a file: its format, its platform, and any header it carries')
+            [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
+            [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a ROM title from its checksums')
+            [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
+            [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
+            [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
+            [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order (same as `patch apply`)')
+            [CompletionResult]::new('patch', 'patch', [CompletionResultType]::ParameterValue, 'Apply, create, or check ROM patches')
+            [CompletionResult]::new('save', 'save', [CompletionResultType]::ParameterValue, 'Inspect and edit supported persistent game saves')
+            [CompletionResult]::new('tools', 'tools', [CompletionResultType]::ParameterValue, 'One-off recovery tools')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
         }
-        'rom-weaver;help;probe' {
+        'rom-weaver;help;setup' {
             break
         }
-        'rom-weaver;help;extract' {
+        'rom-weaver;help;ingest' {
+            break
+        }
+        'rom-weaver;help;cheat' {
+            break
+        }
+        'rom-weaver;help;bundle' {
+            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Write a rom-weaver-bundle.json recipe from local ROM and patch files')
+            [CompletionResult]::new('parse', 'parse', [CompletionResultType]::ParameterValue, 'Read a rom-weaver-bundle.json recipe and report what it points at')
+            [CompletionResult]::new('schema', 'schema', [CompletionResultType]::ParameterValue, 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring')
+            break
+        }
+        'rom-weaver;help;bundle;create' {
+            break
+        }
+        'rom-weaver;help;bundle;parse' {
+            break
+        }
+        'rom-weaver;help;bundle;schema' {
+            break
+        }
+        'rom-weaver;help;plan-extract-batch' {
+            break
+        }
+        'rom-weaver;help;completions' {
+            break
+        }
+        'rom-weaver;help;man' {
+            break
+        }
+        'rom-weaver;help;formats' {
+            break
+        }
+        'rom-weaver;help;probe' {
             break
         }
         'rom-weaver;help;checksum' {
@@ -1281,10 +1706,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;help;identify;database;update' {
             break
         }
-        'rom-weaver;help;setup' {
-            break
-        }
-        'rom-weaver;help;ingest' {
+        'rom-weaver;help;extract' {
             break
         }
         'rom-weaver;help;compress' {
@@ -1293,56 +1715,52 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;help;trim' {
             break
         }
+        'rom-weaver;help;weave' {
+            break
+        }
         'rom-weaver;help;patch' {
-            [CompletionResult]::new('apply', 'apply', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
             [CompletionResult]::new('validate', 'validate', [CompletionResultType]::ParameterValue, 'Check that patches would apply cleanly, without writing anything')
+            [CompletionResult]::new('apply', 'apply', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order')
             [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Build a patch from an original ROM and a changed one')
             break
         }
-        'rom-weaver;help;patch;apply' {
-            break
-        }
         'rom-weaver;help;patch;validate' {
             break
         }
-        'rom-weaver;help;patch;create' {
-            break
-        }
-        'rom-weaver;help;bundle' {
-            [CompletionResult]::new('create', 'create', [CompletionResultType]::ParameterValue, 'Write a rom-weaver-bundle.json recipe from local ROM and patch files')
-            [CompletionResult]::new('parse', 'parse', [CompletionResultType]::ParameterValue, 'Read a rom-weaver-bundle.json recipe and report what it points at')
-            [CompletionResult]::new('schema', 'schema', [CompletionResultType]::ParameterValue, 'Print the rom-weaver-bundle.json JSON Schema, for editors and hand-authoring')
-            break
-        }
-        'rom-weaver;help;bundle;create' {
+        'rom-weaver;help;patch;apply' {
             break
         }
-        'rom-weaver;help;bundle;parse' {
+        'rom-weaver;help;patch;create' {
             break
         }
-        'rom-weaver;help;bundle;schema' {
+        'rom-weaver;help;save' {
+            [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a supported game save without changing it')
+            [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Show the sections and fields in a supported game save')
+            [CompletionResult]::new('get', 'get', [CompletionResultType]::ParameterValue, 'Read one field from a supported game save')
+            [CompletionResult]::new('export-schema', 'export-schema', [CompletionResultType]::ParameterValue, 'Print the generic field schema for a supported game save')
+            [CompletionResult]::new('set', 'set', [CompletionResultType]::ParameterValue, 'Write validated field changes to a new game save')
             break
         }
-        'rom-weaver;help;tools' {
-            [CompletionResult]::new('ppf-undo', 'ppf-undo', [CompletionResultType]::ParameterValue, 'Undo a PPF3 patch, using the undo data stored inside it')
+        'rom-weaver;help;save;identify' {
             break
         }
-        'rom-weaver;help;tools;ppf-undo' {
+        'rom-weaver;help;save;inspect' {
             break
         }
-        'rom-weaver;help;plan-extract-batch' {
+        'rom-weaver;help;save;get' {
             break
         }
-        'rom-weaver;help;weave' {
+        'rom-weaver;help;save;export-schema' {
             break
         }
-        'rom-weaver;help;completions' {
+        'rom-weaver;help;save;set' {
             break
         }
-        'rom-weaver;help;man' {
+        'rom-weaver;help;tools' {
+            [CompletionResult]::new('ppf-undo', 'ppf-undo', [CompletionResultType]::ParameterValue, 'Undo a PPF3 patch, using the undo data stored inside it')
             break
         }
-        'rom-weaver;help;formats' {
+        'rom-weaver;help;tools;ppf-undo' {
             break
         }
         'rom-weaver;help;help' {