@rom-weaver/cli 0.15.0 → 0.16.0

package/docs/man/rom-weaver-save-get.1

@@ -0,0 +1,83 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-save-get 1  "rom-weaver-save-get "
+.SH NAME
+rom\-weaver\-save\-get \- Read one field from a supported game save
+.SH SYNOPSIS
+\fBrom\-weaver save get\fR [\fB\-\-game\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-rom\-sha1\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] <\fISAVE\fR> <\fIFIELD\fR>
+.SH DESCRIPTION
+Read one field from a supported game save
+.SH OPTIONS
+.TP
+\fB\-\-game\fR \fI<GAME_ID>\fR
+Force a game id instead of detecting one
+.TP
+\fB\-\-rom\-sha1\fR \fI<SHA1>\fR
+SHA\-1 of the matching ROM, used to pick a game
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+<\fISAVE\fR>
+Save file to read
+.TP
+<\fIFIELD\fR>
+Field id to read, such as trainer.money
+.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-save-identify.1

@@ -0,0 +1,80 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-save-identify 1  "rom-weaver-save-identify "
+.SH NAME
+rom\-weaver\-save\-identify \- Identify a supported game save without changing it
+.SH SYNOPSIS
+\fBrom\-weaver save identify\fR [\fB\-\-game\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-rom\-sha1\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] <\fISAVE\fR>
+.SH DESCRIPTION
+Identify a supported game save without changing it
+.SH OPTIONS
+.TP
+\fB\-\-game\fR \fI<GAME_ID>\fR
+Force a game id instead of detecting one
+.TP
+\fB\-\-rom\-sha1\fR \fI<SHA1>\fR
+SHA\-1 of the matching ROM, used to pick a game
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+<\fISAVE\fR>
+Save file to read
+.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-save-inspect.1

@@ -0,0 +1,80 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-save-inspect 1  "rom-weaver-save-inspect "
+.SH NAME
+rom\-weaver\-save\-inspect \- Show the sections and fields in a supported game save
+.SH SYNOPSIS
+\fBrom\-weaver save inspect\fR [\fB\-\-game\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-rom\-sha1\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] <\fISAVE\fR>
+.SH DESCRIPTION
+Show the sections and fields in a supported game save
+.SH OPTIONS
+.TP
+\fB\-\-game\fR \fI<GAME_ID>\fR
+Force a game id instead of detecting one
+.TP
+\fB\-\-rom\-sha1\fR \fI<SHA1>\fR
+SHA\-1 of the matching ROM, used to pick a game
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+<\fISAVE\fR>
+Save file to read
+.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-save-set.1

@@ -0,0 +1,89 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-save-set 1  "rom-weaver-save-set "
+.SH NAME
+rom\-weaver\-save\-set \- Write validated field changes to a new game save
+.SH SYNOPSIS
+\fBrom\-weaver save set\fR [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-game\fR] [\fB\-\-json\fR] [\fB\-\-jsonl\fR] [\fB\-\-rom\-sha1\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-progress\fR] [\fB\-\-force\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] <\fISAVE\fR> <\fIFIELD=VALUE\fR>
+.SH DESCRIPTION
+Write validated field changes to a new game save
+.SH OPTIONS
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<PATH>\fR
+Output path; \- writes one completed binary file to stdout
+.TP
+\fB\-\-game\fR \fI<GAME_ID>\fR
+Force a game id instead of detecting one
+.TP
+\fB\-\-rom\-sha1\fR \fI<SHA1>\fR
+SHA\-1 of the matching ROM, used to pick a game
+.TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Validate and preview every change without writing a file
+.TP
+\fB\-\-force\fR
+Overwrite an explicit output path if it already exists
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+<\fISAVE\fR>
+Save file to read
+.TP
+<\fIFIELD=VALUE\fR>
+Field assignments to apply, such as trainer.money=999999
+.SH "GLOBAL OPTIONS"
+.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-save.1

@@ -0,0 +1,87 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-save 1  "rom-weaver-save "
+.SH NAME
+rom\-weaver\-save \- Inspect and edit supported persistent game saves
+.SH SYNOPSIS
+\fBrom\-weaver save\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
+Inspect and edit supported persistent game saves
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+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 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
+.SH SUBCOMMANDS
+.TP
+rom\-weaver\-save\-identify(1)
+Identify a supported game save without changing it
+.TP
+rom\-weaver\-save\-inspect(1)
+Show the sections and fields in a supported game save
+.TP
+rom\-weaver\-save\-get(1)
+Read one field from a supported game save
+.TP
+rom\-weaver\-save\-set(1)
+Write validated field changes to a new game save
+.TP
+rom\-weaver\-save\-export\-schema(1)
+Print the generic field schema for a supported game save

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

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-setup \- Install the offline identify database
 .SH SYNOPSIS
-\fBrom\-weaver setup\fR [\fB\-\-database\-dir\fR] [\fB\-\-json\fR] [\fB\-\-force\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 setup\fR [\fB\-\-database\-dir\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-from\fR] [\fB\-\-json\fR] [\fB\-\-force\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
 Install the identify database this build\*(Aqs `identify` command searches.
 .PP
@@ -20,6 +20,9 @@ data directory; `identify database install\-group` adds the optional packs.
 \fB\-\-database\-dir\fR \fI<DIR>\fR
 Install into this directory instead of the per\-user data directory
 .TP
+\fB\-\-from\fR \fI<ARCHIVE>\fR
+Local rom\-weaver\-identify\-data.tar.br; omit to download the archive for this version
+.TP
 \fB\-\-force\fR
 Download the database again even when it is already installed
 .TP
@@ -27,17 +30,23 @@ Download the database again even when it is already installed
 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
@@ -58,10 +67,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-tools-ppf-undo.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-tools\-ppf\-undo \- Undo a PPF3 patch, using the undo data stored inside it
 .SH SYNOPSIS
-\fBrom\-weaver tools ppf\-undo\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] <\fB\-i\fR|\fB\-\-input\fR> <\fB\-\-patch\fR> <\fB\-o\fR|\fB\-\-output\fR>
+\fBrom\-weaver tools ppf\-undo\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] <\fB\-i\fR|\fB\-\-input\fR> <\fB\-\-patch\fR> <\fB\-o\fR|\fB\-\-output\fR>
 .SH DESCRIPTION
 Undo a PPF3 patch, turning a patched ROM back into the original.
 .PP
@@ -19,23 +19,29 @@ The already\-patched ROM to undo
 The PPF3 patch that was applied. It must carry undo data
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fI<PATH>\fR
-Where to write the restored ROM
+Output path; \- writes one completed binary file to stdout
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 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
@@ -56,10 +62,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-tools.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-tools \- One\-off recovery tools
 .SH SYNOPSIS
-\fBrom\-weaver tools\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 tools\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
 One\-off recovery tools
 .SH OPTIONS
@@ -13,17 +13,23 @@ One\-off recovery tools
 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)