@rom-weaver/cli 0.15.1 → 0.16.1

package/docs/man/rom-weaver-bundle-create.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle\-create \- Write a rom\-weaver\-bundle.json recipe from local ROM and patch files
 .SH SYNOPSIS
-\fBrom\-weaver bundle create\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-\-json\fR] [\fB\-\-assume\-in\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-rom\-url\fR] [\fB\-\-log\-level\fR] [\fB\-\-rom\-name\fR] [\fB\-\-patch\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-patch\-id\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-patch\-version\fR] [\fB\-\-color\fR] [\fB\-\-patch\-name\fR] [\fB\-\-no\-color\fR] [\fB\-\-patch\-description\fR] [\fB\-\-patch\-author\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-patch\-label\fR] [\fB\-\-patch\-optional\fR] [\fB\-\-patch\-source\-url\fR] [\fB\-\-patch\-header\fR] [\fB\-\-patch\-basis\fR] [\fB\-\-patch\-expect\-in\fR] [\fB\-\-patch\-expect\-out\fR] [\fB\-\-expect\-out\fR] [\fB\-\-output\-name\fR] [\fB\-\-output\-header\fR] [\fB\-\-bundle\fR] [\fB\-\-bundle\-rom\fR] [\fB\-\-no\-bundle\-rom\fR] [\fB\-\-checksum\fR] [\fB\-\-from\fR] [\fB\-\-schema\-ref\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-force\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-o\fR|\fB\-\-output\fR>
+\fBrom\-weaver bundle create\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-assume\-in\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-\-rom\-url\fR] [\fB\-\-progress\fR] [\fB\-\-rom\-name\fR] [\fB\-\-no\-progress\fR] [\fB\-\-rom\-member\fR] [\fB\-\-log\-level\fR] [\fB\-\-patch\fR] [\fB\-\-patch\-id\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-\-patch\-version\fR] [\fB\-\-patch\-name\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-patch\-description\fR] [\fB\-\-color\fR] [\fB\-\-patch\-author\fR] [\fB\-\-no\-color\fR] [\fB\-\-patch\-label\fR] [\fB\-\-patch\-optional\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-patch\-source\-url\fR] [\fB\-\-patch\-header\fR] [\fB\-\-patch\-basis\fR] [\fB\-\-default\-patch\-basis\fR] [\fB\-\-patch\-expect\-in\fR] [\fB\-\-patch\-expect\-out\fR] [\fB\-\-expect\-out\fR] [\fB\-\-output\-name\fR] [\fB\-\-output\-header\fR] [\fB\-\-cheat\fR] [\fB\-\-cheat\-database\fR] [\fB\-\-cheat\-system\fR] [\fB\-\-game\fR] [\fB\-\-allow\-cheat\-conflicts\fR] [\fB\-\-bundle\fR] [\fB\-\-bundle\-rom\fR] [\fB\-\-no\-bundle\-rom\fR] [\fB\-\-checksum\fR] [\fB\-\-from\fR] [\fB\-\-schema\-ref\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-force\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-o\fR|\fB\-\-output\fR>
 .SH DESCRIPTION
 Write a rom\-weaver\-bundle.json recipe from local ROM and patch files.
 .PP
@@ -29,7 +29,10 @@ Take the ROM\*(Aqs checksum and size on trust rather than reading it, as in crc3
 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
 .TP
 \fB\-\-rom\-name\fR \fI<ROM_NAME>\fR
-Expected ROM file name to show and use for output naming; a supplied ROM with a different name only warns
+Expected source ROM file name to show and use for output naming; a mismatch is advisory
+.TP
+\fB\-\-rom\-member\fR \fI<ROM_MEMBER>\fR
+Use this exact archive member or disc track as the bundle ROM target
 .TP
 \fB\-\-patch\fR \fI<PATCH>\fR
 Patch to list in the bundle. Repeat once per patch, in the order they should be
@@ -127,13 +130,32 @@ auto
 .RE
 .TP
 \fB\-\-patch\-basis\fR \fI<PATCH_BASIS>\fR
-Which ROM the preceding \-\-patch was built against: base (the bundle\*(Aqs ROM) or previous (the patch before it). Use auto to leave it out and let apply infer it
+Override the preceding \-\-patch input rule: base (the bundle\*(Aqs ROM) or previous (the patch before it). Use auto to inherit the bundle rule
 
 This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
 
   \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .br
 
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+auto
+.IP \(bu 2
+base
+.IP \(bu 2
+previous
+.RE
+.TP
+\fB\-\-default\-patch\-basis\fR \fI<DEFAULT_PATCH_BASIS>\fR
+Record one input ROM rule for every patch. An individual \-\-patch\-basis overrides it.
+
+  base      Every patch was made from the original ROM.
+  previous  Each later patch was made from the previous result.
+  auto      Infer the input ROM from checksums (the default).
+.br
+
 .br
 \fIPossible values:\fR
 .RS 14
@@ -234,19 +256,41 @@ Overwrite the output if it already exists (without this, the command stops inste
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH CHEATS
+.TP
+\fB\-\-cheat\fR \fI<ID_OR_DESCRIPTION>\fR
+Database cheat to use, by record ID or exact description. Repeat for each cheat
+.TP
+\fB\-\-cheat\-database\fR \fI<DIR>\fR
+Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per\-user data directory
+.TP
+\fB\-\-cheat\-system\fR \fI<SYS>\fR
+Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy\-color, gba), when the ROM header does not say
+.TP
+\fB\-\-game\fR \fI<ID>\fR
+Use this database game ID instead of matching the ROM by checksum or title
+.TP
+\fB\-\-allow\-cheat\-conflicts\fR
+Let a later cheat overwrite an earlier one at the same offset instead of failing
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -267,10 +311,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)

package/docs/man/rom-weaver-bundle-parse.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle\-parse \- Read a rom\-weaver\-bundle.json recipe and report what it points at
 .SH SYNOPSIS
-\fBrom\-weaver bundle parse\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-extract\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
+\fBrom\-weaver bundle parse\fR [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-jsonl\fR] [\fB\-\-no\-extract\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
 .SH DESCRIPTION
 Read a rom\-weaver\-bundle.json recipe, check that it is valid, and report the
 ROM and patches it points at.
@@ -52,17 +52,23 @@ How many threads to use at most. auto uses every core; a format may still use fe
 Print help (see a summary with \*(Aq\-h\*(Aq)
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -83,10 +89,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)

package/docs/man/rom-weaver-bundle-schema.1

@@ -4,14 +4,14 @@
 .SH NAME
 rom\-weaver\-bundle\-schema \- Print the rom\-weaver\-bundle.json JSON Schema, for editors and hand\-authoring
 .SH SYNOPSIS
-\fBrom\-weaver bundle schema\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver bundle schema\fR [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR]
 .SH DESCRIPTION
 Print the rom\-weaver\-bundle.json JSON Schema to stdout.
 .PP
 Save it and point your editor at it, and the editor will check and autocomplete
 a bundle as you write it:
 .PP
-  rom\-weaver bundle schema > rom\-weaver\-bundle\-v1.schema.json
+  rom\-weaver bundle schema > rom\-weaver\-bundle\-v2.schema.json
 .PP
 Then `bundle create \-\-from <your file>` turns what you wrote into a finished
 bundle with the checksums filled in.
@@ -21,17 +21,23 @@ bundle with the checksums filled in.
 Print help (see a summary with \*(Aq\-h\*(Aq)
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -52,10 +58,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)

package/docs/man/rom-weaver-bundle.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle \- Build and read rom\-weaver\-bundle.json patch recipes
 .SH SYNOPSIS
-\fBrom\-weaver bundle\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
+\fBrom\-weaver bundle\fR [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
 .SH DESCRIPTION
 Build and read rom\-weaver\-bundle.json patch recipes
 .SH OPTIONS
@@ -13,17 +13,23 @@ Build and read rom\-weaver\-bundle.json patch recipes
 Print help
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -44,10 +50,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)

package/docs/man/rom-weaver-cheat.1

@@ -0,0 +1,107 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-cheat 1  "rom-weaver-cheat "
+.SH NAME
+rom\-weaver\-cheat \- List the cheat database\*(Aqs entries for a ROM
+.SH SYNOPSIS
+\fBrom\-weaver cheat\fR [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-cheat\fR] [\fB\-\-json\fR] [\fB\-\-cheat\-database\fR] [\fB\-\-jsonl\fR] [\fB\-\-cheat\-system\fR] [\fB\-\-progress\fR] [\fB\-\-game\fR] [\fB\-\-no\-progress\fR] [\fB\-\-allow\-cheat\-conflicts\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR> <\fIACTION\fR>
+.SH DESCRIPTION
+List the cheat database\*(Aqs entries for a ROM.
+.PP
+`cheat list` identifies the ROM\*(Aqs system, loads that system\*(Aqs shard from the
+cheat\-database directory, matches the game by checksum and then by title, and
+prints every cheat with whether it can be baked into the ROM.
+.PP
+To use a cheat, bake it: `patch create \-\-code`, then `patch apply`.
+.SH OPTIONS
+.TP
+\fB\-i\fR, \fB\-\-input\fR \fI<ROM>\fR
+The ROM the cheats are for. Its header picks the cheat shard and its bytes decide each cheat\*(Aqs delivery
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.TP
+<\fIACTION\fR>
+list: print the matched game\*(Aqs cheats
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+list: Print the cheats the database holds for the input ROM
+.RE
+.SH CHEATS
+.TP
+\fB\-\-cheat\fR \fI<ID_OR_DESCRIPTION>\fR
+Database cheat to use, by record ID or exact description. Repeat for each cheat
+.TP
+\fB\-\-cheat\-database\fR \fI<DIR>\fR
+Directory holding manifest.json and the <system>.json cheat shards. Defaults to $ROM_WEAVER_CHEAT_DATABASE, then the per\-user data directory
+.TP
+\fB\-\-cheat\-system\fR \fI<SYS>\fR
+Console the cheat shard is for (nes, snes, genesis, gameboy, gameboy\-color, gba), when the ROM header does not say
+.TP
+\fB\-\-game\fR \fI<ID>\fR
+Use this database game ID instead of matching the ROM by checksum or title
+.TP
+\fB\-\-allow\-cheat\-conflicts\fR
+Let a later cheat overwrite an earlier one at the same offset instead of failing
+.SH "GLOBAL OPTIONS"
+.TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
+\fB\-\-json\fR
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
+.TP
+\fB\-\-progress\fR
+Show progress on stderr (off by default; JSONL includes progress)
+.TP
+\fB\-\-no\-progress\fR
+Hide progress
+.TP
+\fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+off
+.IP \(bu 2
+error
+.IP \(bu 2
+warn
+.IP \(bu 2
+info
+.IP \(bu 2
+debug
+.IP \(bu 2
+trace
+.RE
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Hide optional diagnostics and progress; keep results, warnings, and errors
+.TP
+\fB\-\-dep\-trace\fR
+Also log trace output from bundled libraries (for bug reports)
+.TP
+\fB\-\-color\fR
+Keep colors even when output is piped
+.TP
+\fB\-\-no\-color\fR
+Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-checksum.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-checksum \- Compute checksums for a file, or for a ROM inside an archive
 .SH SYNOPSIS
-\fBrom\-weaver checksum\fR [\fB\-\-json\fR] [\fB\-a\fR|\fB\-\-algo\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-extract\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-trim\-fix\fR] [\fB\-\-color\fR] [\fB\-\-start\fR] [\fB\-\-length\fR] [\fB\-\-no\-color\fR] [\fB\-\-probe\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
+\fBrom\-weaver checksum\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-a\fR|\fB\-\-algo\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-progress\fR] [\fB\-\-no\-extract\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-trim\-fix\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-\-start\fR] [\fB\-\-length\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-probe\fR] [\fB\-\-color\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-digest\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIFILE\fR]
 .SH DESCRIPTION
 Compute checksums for a file, so you can tell one dump from another.
 .PP
@@ -82,21 +82,33 @@ Also report the platform of the hashed bytes, and fail if it matches no known pl
 \fB\-j\fR, \fB\-\-threads\fR \fI<auto|N>\fR [default: auto]
 How many threads to use at most. auto uses every core; a format may still use fewer
 .TP
+\fB\-\-digest\fR
+Print only the digest; requires one \-\-algo (no labels or elapsed time)
+.TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help (see a summary with \*(Aq\-h\*(Aq)
+.TP
+[\fIFILE\fR]
+File input; an alternative to \-i, \-\-input
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -117,10 +129,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)

package/docs/man/rom-weaver-completions.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-completions \- Print a tab\-completion script for your shell
 .SH SYNOPSIS
-\fBrom\-weaver completions\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fISHELL\fR>
+\fBrom\-weaver completions\fR [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fISHELL\fR>
 .SH DESCRIPTION
 Print a tab\-completion script for your shell to stdout.
 .PP
@@ -38,17 +38,23 @@ zsh
 .RE
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -69,10 +75,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)

package/docs/man/rom-weaver-compress.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-compress \- Pack files into an archive, disc image, or ROM\-specific compressed format
 .SH SYNOPSIS
-\fBrom\-weaver compress\fR [\fB\-\-json\fR] [\fB\-f\fR|\fB\-\-format\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-codec\fR] [\fB\-\-log\-level\fR] [\fB\-\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-force\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-color\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR> <\fB\-o\fR|\fB\-\-output\fR>
+\fBrom\-weaver compress\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-f\fR|\fB\-\-format\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-\-codec\fR] [\fB\-\-progress\fR] [\fB\-\-level\fR] [\fB\-\-no\-progress\fR] [\fB\-\-force\fR] [\fB\-\-log\-level\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-\-stdin\-name\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fIFILE\fR]
 .SH DESCRIPTION
 Pack files into an archive, disc image, or ROM\-specific compressed format.
 .PP
@@ -22,7 +22,7 @@ for when you want to override that.
 .SH OPTIONS
 .TP
 \fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR
-File to put in the archive; repeat for each one. For a disc image, pass the .cue or .gdi alone and its tracks come along
+Input path; \- reads stdin using a temporary file
 .TP
 \fB\-f\fR, \fB\-\-format\fR \fI<FORMAT>\fR
 Output format, such as zip, 7z, chd, rvz, or z3ds.
@@ -51,7 +51,7 @@ z3ds
 .RE
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fI<PATH>\fR
-Where to write the archive
+Output path; \- writes one binary result to stdout (compress requires \-\-format)
 .TP
 \fB\-\-codec\fR \fI<CODEC>\fR
 Compression method to use, written as codec or codec:level.
@@ -124,27 +124,36 @@ max
 \fB\-\-force\fR
 Overwrite the output if it already exists (without this, the command stops instead)
 .TP
-\fB\-n\fR, \fB\-\-dry\-run\fR
-Print the plan (inputs, output, format, codec, level, threads) and stop without writing
-.TP
 \fB\-j\fR, \fB\-\-threads\fR \fI<auto|N>\fR [default: auto]
 How many threads to use at most. auto uses every core; a format may still use fewer
 .TP
+\fB\-\-stdin\-name\fR \fI<NAME>\fR
+Filename for input \- (default: stdin.bin); one filename, no directories
+.TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help (see a summary with \*(Aq\-h\*(Aq)
+.TP
+[\fIFILE\fR]
+File input; an alternative to \-i, \-\-input
 .SH "GLOBAL OPTIONS"
 .TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Plan the command without changing files or downloading data
+.TP
 \fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
+Print one complete JSON report; progress and diagnostics use stderr
+.TP
+\fB\-\-jsonl\fR
+Stream JSON events, including progress, one object per line
 .TP
 \fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
+Show progress on stderr (off by default; JSONL includes progress)
 .TP
 \fB\-\-no\-progress\fR
 Hide progress
 .TP
 \fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
-How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+How much rom\-weaver logs to stderr. Separate from the normal output [default: warn]
 .br
 
 .br
@@ -165,10 +174,13 @@ trace
 .RE
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
-Log more: \-v for info, \-vv for debug, \-vvv for trace
+Show user diagnostics on stderr; repeat for developer detail (\-vv debug, \-vvv trace)
+.TP
+\fB\-\-debug\fR
+Show developer diagnostics and trace events on stderr (same as \-vvv)
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
+Hide optional diagnostics and progress; keep results, warnings, and errors
 .TP
 \fB\-\-dep\-trace\fR
 Also log trace output from bundled libraries (for bug reports)