@rom-weaver/cli 0.15.1 → 0.16.1

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

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-extract \- Unpack an archive or single\-payload compressed format
 .SH SYNOPSIS
-\fBrom\-weaver extract\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\-\-split\-bin\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-nested\-extract\fR] [\fB\-\-color\fR] [\fB\-\-force\fR] [\fB\-\-checksum\fR] [\fB\-\-no\-color\fR] [\fB\-\-checksum\-rom\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-probe\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR> <\fB\-o\fR|\fB\-\-output\fR>
+\fBrom\-weaver extract\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-jsonl\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-split\-bin\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-nested\-extract\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-debug\fR] [\fB\-\-force\fR] [\fB\-\-checksum\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-checksum\-rom\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-probe\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-no\-color\fR] [\fB\-\-stdin\-name\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fIFILE\fR]
 .SH DESCRIPTION
 Unpack an archive or single\-payload compressed format into a directory.
 .PP
@@ -16,7 +16,7 @@ whole extraction stops before writing. Pass \-\-force to overwrite instead.
 .SH OPTIONS
 .TP
 \fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR
-Archive or single\-payload compressed format to unpack
+Input path; \- reads stdin using a temporary file
 .TP
 \fB\-s\fR, \fB\-\-select\fR \fI<SELECT>\fR
 Extract only these files, by exact name, prefix, or glob (repeatable). For example: \-\-select \*(Aqgame.disc0?.bin\*(Aq
@@ -35,7 +35,7 @@ patch
 .RE
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fI<DIR>\fR
-Directory to write the extracted files into
+Output path; \- writes one binary result to stdout (compress requires \-\-format)
 .TP
 \fB\-\-split\-bin\fR
 Write a CD\-format CHD as a CUE plus one BIN per track (*.trackNN.bin), rather than one merged BIN
@@ -105,21 +105,33 @@ Also report the format and platform of what was extracted, and fail if a lone pa
 \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
@@ -140,10 +152,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-formats.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-formats \- List the formats, codecs, and checksum algorithms this build supports
 .SH SYNOPSIS
-\fBrom\-weaver formats\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 formats\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
 List what this build supports, read straight from its registries: container
 formats (and whether each can be created, extracted, or both), patch formats,
@@ -17,17 +17,23 @@ Pass \-\-json for the machine\-readable form.
 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
@@ -48,10 +54,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-identify-database-import-redump.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-import\-redump \- Build identify packs from local Redump DAT ZIP files
 .SH SYNOPSIS
-\fBrom\-weaver identify database import\-redump\fR [\fB\-\-database\-dir\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] <\fIZIP\fR>
+\fBrom\-weaver identify database import\-redump\fR [\fB\-\-database\-dir\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] <\fIZIP\fR>
 .SH DESCRIPTION
 Build identify packs from local Redump DAT ZIP files
 .SH OPTIONS
@@ -19,17 +19,23 @@ Print help
 Local Redump DAT ZIP file to import
 .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
@@ -50,10 +56,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-identify-database-install-all.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-install\-all \- Install the full identify database for this rom\-weaver version
 .SH SYNOPSIS
-\fBrom\-weaver identify database install\-all\fR [\fB\-\-database\-dir\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 identify database install\-all\fR [\fB\-\-database\-dir\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
 Install the full identify database for this rom\-weaver version
 .SH OPTIONS
@@ -16,17 +16,23 @@ Identify database directory. Defaults to the per\-user data directory
 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
@@ -47,10 +53,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-identify-database-install-group.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-install\-group \- Download and install one optional identify pack group
 .SH SYNOPSIS
-\fBrom\-weaver identify database install\-group\fR [\fB\-\-from\fR] [\fB\-\-json\fR] [\fB\-\-database\-dir\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] <\fIGROUP\fR>
+\fBrom\-weaver identify database install\-group\fR [\fB\-\-from\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-database\-dir\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] <\fIGROUP\fR>
 .SH DESCRIPTION
 Download and install one optional identify pack group
 .SH OPTIONS
@@ -22,17 +22,23 @@ Print help
 Optional identify pack group to install
 .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
@@ -53,10 +59,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-identify-database-install.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-install \- Download and install one Redump system pack (or \-\-all)
 .SH SYNOPSIS
-\fBrom\-weaver identify database install\fR [\fB\-\-all\fR] [\fB\-\-json\fR] [\fB\-\-from\fR] [\fB\-\-progress\fR] [\fB\-\-database\-dir\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] [\fISYSTEM\fR]
+\fBrom\-weaver identify database install\fR [\fB\-\-all\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-from\fR] [\fB\-\-json\fR] [\fB\-\-database\-dir\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] [\fISYSTEM\fR]
 .SH DESCRIPTION
 Download and install one Redump system pack (or \-\-all)
 .SH OPTIONS
@@ -25,17 +25,23 @@ Print help
 Canonical platform name or alias
 .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-identify-database-list.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-list \- List every catalog platform, its source, and whether its pack is installed
 .SH SYNOPSIS
-\fBrom\-weaver identify database list\fR [\fB\-\-database\-dir\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 identify database list\fR [\fB\-\-database\-dir\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
 List every catalog platform, its source, and whether its pack is installed
 .SH OPTIONS
@@ -16,17 +16,23 @@ Identify database directory. Defaults to the per\-user data directory
 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
@@ -47,10 +53,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-identify-database-path.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-path \- Print the identify database directory
 .SH SYNOPSIS
-\fBrom\-weaver identify database path\fR [\fB\-\-database\-dir\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 identify database path\fR [\fB\-\-database\-dir\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 identify database directory
 .SH OPTIONS
@@ -16,17 +16,23 @@ Identify database directory. Defaults to the per\-user data directory
 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
@@ -47,10 +53,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-identify-database-remove.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-remove \- Remove one system\*(Aqs installed pack
 .SH SYNOPSIS
-\fBrom\-weaver identify database remove\fR [\fB\-\-database\-dir\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] <\fISYSTEM\fR>
+\fBrom\-weaver identify database remove\fR [\fB\-\-database\-dir\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] <\fISYSTEM\fR>
 .SH DESCRIPTION
 Remove one system\*(Aqs installed pack
 .SH OPTIONS
@@ -19,17 +19,23 @@ Print help
 Canonical platform name or alias
 .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
@@ -50,10 +56,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-identify-database-status.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-status \- List the installed pack files: slug, format, size, and sha256
 .SH SYNOPSIS
-\fBrom\-weaver identify database status\fR [\fB\-\-database\-dir\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 identify database status\fR [\fB\-\-database\-dir\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
 List the installed pack files: slug, format, size, and sha256
 .SH OPTIONS
@@ -16,17 +16,23 @@ Identify database directory. Defaults to the per\-user data directory
 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
@@ -47,10 +53,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-identify-database-update.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database\-update \- Download and update installed Redump system packs
 .SH SYNOPSIS
-\fBrom\-weaver identify database update\fR [\fB\-\-from\fR] [\fB\-\-json\fR] [\fB\-\-database\-dir\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] [\fISYSTEM\fR]
+\fBrom\-weaver identify database update\fR [\fB\-\-from\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-database\-dir\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] [\fISYSTEM\fR]
 .SH DESCRIPTION
 Download and update installed Redump system packs
 .SH OPTIONS
@@ -22,17 +22,23 @@ Print help
 Canonical platform name or alias; omit to update every installed pack
 .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
@@ -53,10 +59,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-identify-database.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-identify\-database \- Manage the installed identify database packs
 .SH SYNOPSIS
-\fBrom\-weaver identify database\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 identify database\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
 Manage the installed identify database packs
 .SH OPTIONS
@@ -13,17 +13,23 @@ Manage the installed identify database packs
 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)