@rom-weaver/cli 0.12.3 → 0.13.0

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

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-patch \- Apply, create, or check ROM patches
 .SH SYNOPSIS
-\fBrom\-weaver patch\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\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
+\fBrom\-weaver patch\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>
 .SH DESCRIPTION
 Apply, create, or check ROM patches
 .SH OPTIONS
@@ -57,6 +57,9 @@ 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\-patch\-apply(1)

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

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-probe \- Identify a file: its format, its platform, and any header it carries
 .SH SYNOPSIS
-\fBrom\-weaver probe\fR <\fB\-i\fR|\fB\-\-input\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\-\-no\-ignore\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\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver probe\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\-\-no\-ignore\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>
 .SH DESCRIPTION
 Identify a file. Reports what format it is, which console it is for, whether it
 carries a copier header, and what is inside it if it is an archive.
@@ -91,3 +91,6 @@ 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-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\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] <\fB\-\-patch\fR> [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] <\fB\-o\fR|\fB\-\-output\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\-h\fR|\fB\-\-help\fR]
+\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>
 .SH DESCRIPTION
 Undo a PPF3 patch, turning a patched ROM back into the original.
 .PP
@@ -69,3 +69,6 @@ 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-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\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
+\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>
 .SH DESCRIPTION
 One\-off recovery tools
 .SH OPTIONS
@@ -57,6 +57,9 @@ 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\-tools\-ppf\-undo(1)

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

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-trim \- Cut the padding off a ROM, or put it back
 .SH SYNOPSIS
-\fBrom\-weaver trim\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-progress\fR] [\fB\-e\fR|\fB\-\-extension\fR] [\fB\-\-no\-progress\fR] [\fB\-\-in\-place\fR] [\fB\-\-log\-level\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-revert\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-recursive\fR] [\fB\-\-color\fR] [\fB\-\-no\-filter\fR] [\fB\-\-no\-color\fR] [\fB\-\-no\-extract\fR] [\fB\-\-revert\-marker\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver trim\fR [\fB\-\-json\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-progress\fR] [\fB\-e\fR|\fB\-\-extension\fR] [\fB\-\-no\-progress\fR] [\fB\-\-in\-place\fR] [\fB\-\-log\-level\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-revert\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-recursive\fR] [\fB\-\-color\fR] [\fB\-\-filter\fR] [\fB\-\-no\-color\fR] [\fB\-\-no\-filter\fR] [\fB\-\-no\-extract\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-revert\-marker\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-force\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
 .SH DESCRIPTION
 Cut the unused padding off the end of a ROM, making the file smaller without
 changing what a console or emulator reads from it.
@@ -49,6 +49,19 @@ XISO and RVZ scrub cannot be reverted.
 \fB\-\-no\-recursive\fR
 When an input is a folder, look only at its top level
 .TP
+\fB\-\-filter\fR \fI<FILTER>\fR [default: rom]
+Consider only files that look like a rom or a patch, judged by extension (repeatable, comma\-separable)
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+rom
+.IP \(bu 2
+patch
+.RE
+.TP
 \fB\-\-no\-filter\fR
 Consider every file inside an archive, not just the ones that look like ROMs
 .TP
@@ -61,6 +74,9 @@ Add a small footer recording what was cut, so \-\-revert can restore the origina
 \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\-\-force\fR
+Overwrite the output if it already exists (without this, the command stops instead)
+.TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help (see a summary with \*(Aq\-h\*(Aq)
 .SH "GLOBAL OPTIONS"
@@ -109,3 +125,6 @@ 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-weave.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-weave \- Apply one or more patches to a ROM, in order (same as `patch apply`)
 .SH SYNOPSIS
-\fBrom\-weaver weave\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-no\-progress\fR] [\fB\-\-target\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\-\-patch\fR] [\fB\-\-color\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-bundle\fR] [\fB\-\-no\-color\fR] [\fB\-\-with\fR] [\fB\-\-without\fR] [\fB\-\-no\-compress\fR] [\fB\-\-compress\-format\fR] [\fB\-\-compress\-codec\fR] [\fB\-\-compress\-level\fR] [\fB\-\-assume\-in\fR] [\fB\-\-expect\-in\fR] [\fB\-\-patch\-header\fR] [\fB\-\-patch\-basis\fR] [\fB\-\-output\-header\fR] [\fB\-\-repair\-checksum\fR] [\fB\-\-n64\-byte\-order\fR] [\fB\-\-ignore\-checksum\-validation\fR] [\fB\-\-expect\-out\fR] [\fB\-\-code\fR] [\fB\-\-code\-system\fR] [\fB\-\-code\-kind\fR] [\fB\-\-emit\-bundle\fR] [\fB\-\-tui\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver weave\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-no\-progress\fR] [\fB\-\-target\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\-\-patch\fR] [\fB\-\-color\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-bundle\fR] [\fB\-\-no\-color\fR] [\fB\-\-with\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-without\fR] [\fB\-\-no\-compress\fR] [\fB\-\-compress\-format\fR] [\fB\-\-compress\-codec\fR] [\fB\-\-compress\-level\fR] [\fB\-\-assume\-in\fR] [\fB\-\-expect\-in\fR] [\fB\-\-patch\-header\fR] [\fB\-\-patch\-basis\fR] [\fB\-\-output\-header\fR] [\fB\-\-repair\-checksum\fR] [\fB\-\-n64\-byte\-order\fR] [\fB\-\-ignore\-checksum\-validation\fR] [\fB\-\-expect\-out\fR] [\fB\-\-code\fR] [\fB\-\-code\-system\fR] [\fB\-\-code\-kind\fR] [\fB\-\-emit\-bundle\fR] [\fB\-\-tui\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-force\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
 .SH DESCRIPTION
 Apply one or more patches to a ROM, in order.
 .PP
@@ -17,8 +17,12 @@ compressed format (the ROM inside is found for you), or a
 rom\-weaver\-bundle.json that already names the ROM, the patches, and the
 output.
 .PP
-The result is compressed by default, into whatever container the \-\-output
-extension names. Pass \-\-no\-compress for a plain ROM file.
+When \-\-output names the selected ROM leaf\*(Aqs extension, rom\-weaver writes a
+plain ROM. A registered container extension such as .zip compresses the result.
+Pass \-\-no\-compress (or \-\-raw) to force a plain ROM, or use \-\-compress\-format,
+\-\-compress\-codec, and \-\-compress\-level (also accepted as \-\-format, \-\-codec,
+and \-\-level) to force compression. Without \-\-output, an ordinary file apply
+writes a collision\-safe sibling named <stem>\-patched.<ext>.
 .PP
 Patch formats: IPS, IPS32, SOLID, BPS, UPS, VCDIFF, xdelta, GDIFF,
 HDiffPatch/HPatchZ, APS (N64), APSGBA, RUP, PPF, PAT/FFP, EBP, BDF/BSDIFF40,
@@ -31,33 +35,18 @@ DCP needs a Dreamcast .cue or .gdi input. It rebuilds the whole disc, so it
 cannot be combined with other patches or with the header and checksum options.
 .SH OPTIONS
 .TP
-\fB\-i\fR, \fB\-\-input\fR \fI<PATH>\fR
-ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle
-.TP
-\fB\-s\fR, \fB\-\-select\fR \fI<SELECT>\fR
-Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)
+\fB\-\-force\fR
+Overwrite the output if it already exists (without this, the command stops instead)
 .TP
-\fB\-\-target\fR \fI<TARGET>\fR
-For a .cue or .gdi input, which track gets the patch. Matched like \-\-select and must hit exactly one track
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Print the plan (inputs, patches, output, format, codec, level, threads) and stop without writing
 .TP
-\fB\-\-filter\fR \fI<FILTER>\fR
-Consider only files that look like a rom or a patch, judged by extension (repeatable, comma\-separable)
-.br
-
-.br
-\fIPossible values:\fR
-.RS 14
-.IP \(bu 2
-rom
-.IP \(bu 2
-patch
-.RE
-.TP
-\fB\-\-no\-extract\fR
-Do not look inside archives; treat the input and every patch as raw files
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH BASIC
 .TP
-\fB\-\-no\-ignore\fR
-Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store
+\fB\-i\fR, \fB\-\-input\fR \fI<PATH>\fR
+ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle
 .TP
 \fB\-\-patch\fR \fI<PATCHES>\fR
 Patch to apply. Repeat once per patch; they run in the order given, each on the
@@ -69,20 +58,6 @@ the ROM inside the input archive.
 \fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
 Where to write the patched ROM. Optional when a bundle already names the output
 .TP
-\fB\-\-bundle\fR \fI<BUNDLE>\fR
-Follow a rom\-weaver\-bundle.json recipe, which lists the patches, their order,
-and the expected checksums. Takes a file path or an http(s) URL.
-
-You can usually skip this flag. A bundle is picked up automatically when
-\-\-input is a rom\-weaver\-bundle.json (optionally .gz, .bz2, .xz, or .zst), or an
-archive with one at its root, and you passed no \-\-patch of your own.
-.TP
-\fB\-\-with\fR \fI<GLOB>\fR
-Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)
-.TP
-\fB\-\-without\fR \fI<GLOB>\fR
-Turn off a bundle patch, matched by name or file name (repeatable)
-.TP
 \fB\-\-no\-compress\fR
 Write a plain ROM instead of compressing the result
 .TP
@@ -93,6 +68,22 @@ Normally you do not need this: the format comes from the \-\-output extension.
 Pass it when the output name has no usable extension. If it disagrees with the
 extension, this flag wins and a warning is printed. Use \-\-no\-compress to write
 a plain ROM instead.
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+zip
+.IP \(bu 2
+7z
+.IP \(bu 2
+chd
+.IP \(bu 2
+rvz
+.IP \(bu 2
+z3ds
+.RE
 .TP
 \fB\-\-compress\-codec\fR \fI<COMPRESS_CODEC>\fR
 Compression method for the patched ROM, written as codec or codec:level.
@@ -103,6 +94,38 @@ this is only for overriding that choice. CHD takes a list, tried in order:
   \-\-compress\-codec cdzs:19,cdzl,cdfl
 
 Without :level, a codec follows the \-\-compress\-level profile.
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+store
+.IP \(bu 2
+deflate
+.IP \(bu 2
+zstd
+.IP \(bu 2
+lzma
+.IP \(bu 2
+lzma2
+.IP \(bu 2
+zlib
+.IP \(bu 2
+huff
+.IP \(bu 2
+flac
+.IP \(bu 2
+cdzs
+.IP \(bu 2
+cdlz
+.IP \(bu 2
+cdzl
+.IP \(bu 2
+cdfl
+.IP \(bu 2
+avhuff
+.RE
 .TP
 \fB\-\-compress\-level\fR \fI<COMPRESS_LEVEL>\fR
 How hard to compress: min, very\-low, low, medium, high, very\-high, or max [default: max]
@@ -126,6 +149,47 @@ very\-high
 .IP \(bu 2
 max
 .RE
+.SH ARCHIVE/BUNDLE
+.TP
+\fB\-s\fR, \fB\-\-select\fR \fI<SELECT>\fR
+Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)
+.TP
+\fB\-\-target\fR \fI<TARGET>\fR
+For a .cue or .gdi input, which track gets the patch. Matched like \-\-select and must hit exactly one track
+.TP
+\fB\-\-filter\fR \fI<FILTER>\fR
+Consider only files that look like a rom or a patch, judged by extension (repeatable, comma\-separable)
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+rom
+.IP \(bu 2
+patch
+.RE
+.TP
+\fB\-\-no\-extract\fR
+Do not look inside archives; treat the input and every patch as raw files
+.TP
+\fB\-\-no\-ignore\fR
+Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store
+.TP
+\fB\-\-bundle\fR \fI<BUNDLE>\fR
+Follow a rom\-weaver\-bundle.json recipe, which lists the patches, their order,
+and the expected checksums. Takes a file path or an http(s) URL.
+
+You can usually skip this flag. A bundle is picked up automatically when
+\-\-input is a rom\-weaver\-bundle.json (optionally .gz, .bz2, .xz, or .zst), or an
+archive with one at its root, and you passed no \-\-patch of your own.
+.TP
+\fB\-\-with\fR \fI<GLOB>\fR
+Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)
+.TP
+\fB\-\-without\fR \fI<GLOB>\fR
+Turn off a bundle patch, matched by name or file name (repeatable)
+.SH COMPATIBILITY
 .TP
 \fB\-\-assume\-in\fR \fI<ALGO=HEX>\fR
 Take this checksum on trust instead of reading the ROM to compute it, as in
@@ -150,9 +214,12 @@ Some ROMs carry a small header added by old copier hardware, and a patch may
 have been made either with it or without it. Getting this wrong makes the patch
 fail or produce a broken ROM.
 
-  auto    Work it out per patch (the default). The header is stripped or put
-          back only when the patch\*(Aqs own source checksum proves which form it
-          expects. With no such proof, the bytes are left alone.
+  auto    Work it out per patch (the default). A patch carrying its own source
+          checksum (BPS, UPS, RUP) settles it outright. A patch without one
+          (IPS) is judged on where its records land, and if that is still
+          unclear by applying it both ways and keeping the result the console
+          still recognises as its own ROM. Any remaining doubt leaves the
+          bytes alone.
   keep    Apply to the bytes as they are.
   strip   Remove the header first.
 
@@ -189,8 +256,11 @@ checksums describe.
   previous  The output of the patch before it.
 
 Reach for this when several patches in a chain were each written against the
-unmodified ROM rather than against each other. Binds to the most recent
-\-\-patch.
+unmodified ROM rather than against each other.
+
+This flag must follow the \-\-patch it describes; it binds to the most recent
+\-\-patch and carries forward until the next occurrence. An occurrence before any
+\-\-patch applies to every patch.
 .br
 
 .br
@@ -241,7 +311,9 @@ N64 dumps circulate in three interleavings (.z64 big\-endian, .v64 byte\-swapped
 \&.n64 little\-endian) and a patch only matches one of them.
 
   auto           Match whichever order the patch\*(Aqs source CRC32 names. The
-                 default, and almost always right.
+                 default, and almost always right. For the first patch, one
+                 that carries no checksum (IPS) falls back to the shape of its
+                 changes; an order settled that way is named in the report.
   keep           Leave the ROM as it is.
   big\-endian     Rewrite to .z64 order.
   little\-endian  Rewrite to .n64 order.
@@ -268,6 +340,7 @@ byte\-swapped
 .TP
 \fB\-\-ignore\-checksum\-validation\fR
 Apply the patch even when its own checksums do not match. Can produce a broken ROM
+.SH DIAGNOSTICS/AUTHORING
 .TP
 \fB\-\-expect\-out\fR \fI<ALGO=HEX>\fR
 Fail unless the patched ROM has this checksum, as in sha1=abc... (repeatable, comma\-separable)
@@ -286,12 +359,10 @@ Also write a rom\-weaver\-bundle.json recording this run, so someone else can re
 .TP
 \fB\-\-tui\fR
 Ask for each patch\*(Aqs name, version, and author, then apply and write a bundle. Needs a terminal
+.SH PERFORMANCE
 .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\-h\fR, \fB\-\-help\fR
-Print help (see a summary with \*(Aq\-h\*(Aq)
 .SH "GLOBAL OPTIONS"
 .TP
 \fB\-\-json\fR
@@ -338,20 +409,9 @@ 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 EXTRA
-Examples:
-  # One patch, plain ROM out
-  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
-    \-\-output hacked.sfc \-\-no\-compress
-
-  # Two patches in order, straight out of and back into a zip
-  rom\-weaver patch apply \-\-input game.zip \\
-    \-\-patch translation.bps \-\-patch fixes.ips \-\-output hacked.zip
-
-  # Replay someone else\*(Aqs published recipe
-  rom\-weaver patch apply \-\-bundle rom\-weaver\-bundle.json \-\-input game.sfc
-
-  # Check the result against a checksum the patch author published
-  rom\-weaver patch apply \-\-input game.sfc \-\-patch hack.bps \\
-    \-\-output hacked.sfc \-\-no\-compress \\
-    \-\-expect\-out sha1=0123456789abcdef0123456789abcdef01234567
+Example:
+  rom\-weaver patch apply \-i game.sfc \-\-patch hack.bps \-o hacked.sfc

package/docs/man/rom-weaver.1

@@ -1,10 +1,10 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH rom-weaver 1  "rom-weaver 0.12.3"
+.TH rom-weaver 1  "rom-weaver 0.13.0"
 .SH NAME
 rom\-weaver \- Inspect, extract, checksum, compress, trim, and patch ROMs and disc images
 .SH SYNOPSIS
-\fBrom\-weaver\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\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fIsubcommands\fR>
+\fBrom\-weaver\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\-V\fR|\fB\-\-version\fR] <\fIsubcommands\fR>
 .SH DESCRIPTION
 Inspect, extract, checksum, compress, trim, and patch ROMs and disc images.
 .PP
@@ -66,6 +66,9 @@ 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\-probe(1)
@@ -77,9 +80,6 @@ Unpack an archive or single\-payload compressed format
 rom\-weaver\-checksum(1)
 Compute checksums for a file, or for a ROM inside an archive
 .TP
-rom\-weaver\-ingest(1)
-Sort a file into ROMs and patches, unpacking and hashing along the way
-.TP
 rom\-weaver\-compress(1)
 Pack files into an archive, disc image, or ROM\-specific compressed format
 .TP
@@ -100,6 +100,9 @@ Apply one or more patches to a ROM, in order (same as `patch apply`)
 .TP
 rom\-weaver\-completions(1)
 Print a tab\-completion script for your shell
+.TP
+rom\-weaver\-formats(1)
+List the formats, codecs, and checksum algorithms this build supports
 .SH EXTRA
 Examples:
   # What is this file?
@@ -121,4 +124,4 @@ Examples:
 
 Full guide: https://rom\-weaver.com/docs/cli
 .SH VERSION
-v0.12.3
+v0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rom-weaver/cli",
-  "version": "0.12.3",
+  "version": "0.13.0",
   "author": "Brandon Casey",
   "license": "AGPL-3.0-or-later",
   "description": "Local-first toolkit for ROMs and disc images: inspect, extract, compress, and apply, create, or bundle patches. Offline via a browser service-worker PWA or CLI.",
@@ -64,15 +64,15 @@
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@rom-weaver/darwin-arm64": "0.12.3",
-    "@rom-weaver/darwin-x64": "0.12.3",
-    "@rom-weaver/linux-arm64-musl": "0.12.3",
-    "@rom-weaver/linux-ia32-musl": "0.12.3",
-    "@rom-weaver/linux-x64-gnu": "0.12.3",
-    "@rom-weaver/linux-x64-musl": "0.12.3",
-    "@rom-weaver/win32-arm64-msvc": "0.12.3",
-    "@rom-weaver/win32-ia32-msvc": "0.12.3",
-    "@rom-weaver/win32-x64-msvc": "0.12.3"
+    "@rom-weaver/darwin-arm64": "0.13.0",
+    "@rom-weaver/darwin-x64": "0.13.0",
+    "@rom-weaver/linux-arm64-musl": "0.13.0",
+    "@rom-weaver/linux-ia32-musl": "0.13.0",
+    "@rom-weaver/linux-x64-gnu": "0.13.0",
+    "@rom-weaver/linux-x64-musl": "0.13.0",
+    "@rom-weaver/win32-arm64-msvc": "0.13.0",
+    "@rom-weaver/win32-ia32-msvc": "0.13.0",
+    "@rom-weaver/win32-x64-msvc": "0.13.0"
   },
   "scripts": {
     "docs:lint": "markdownlint-cli2",
@@ -97,6 +97,6 @@
     "doctoc": "2.5.0",
     "lefthook": "2.1.10",
     "markdownlint-cli2": "0.23.2",
-    "oxlint": "1.76.0"
+    "oxlint": "1.77.0"
   }
 }

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

@@ -1,98 +0,0 @@
-.ie \n(.g .ds Aq \(aq
-.el .ds Aq '
-.TH rom-weaver-ingest 1  "rom-weaver-ingest "
-.SH NAME
-rom\-weaver\-ingest \- Sort a file into ROMs and patches, unpacking and hashing along the way
-.SH SYNOPSIS
-\fBrom\-weaver ingest\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-log\-level\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\-\-split\-bin\fR] [\fB\-\-checksum\fR] [\fB\-\-no\-color\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
-.SH DESCRIPTION
-Sort a file into ROMs and patches, unpacking archives and hashing the ROMs as
-it goes.
-.PP
-This is what the webapp runs when you drop a file on it, and it is the command
-to reach for when you do not know what you have. For a description without the
-unpacking, use `probe`.
-.SH OPTIONS
-.TP
-\fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR
-File to sort into ROMs and patches
-.TP
-\fB\-o\fR, \fB\-\-output\fR \fI<DIR>\fR
-Directory to write anything unpacked along the way into
-.TP
-\fB\-s\fR, \fB\-\-select\fR \fI<SELECT>\fR
-Pick which ROM to use when the archive holds more than one, by exact name, prefix, or glob (repeatable)
-.TP
-\fB\-\-no\-ignore\fR
-Also consider files normally skipped inside archives: readmes, images, checksum sidecars, and OS clutter such as .DS_Store
-.TP
-\fB\-\-no\-nested\-extract\fR
-Stop after one layer; leave any archive found inside the input packed
-.TP
-\fB\-\-split\-bin\fR [\fI<SPLIT_BIN>\fR]
-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
-.br
-
-.br
-\fIPossible values:\fR
-.RS 14
-.IP \(bu 2
-true
-.IP \(bu 2
-false
-.RE
-.TP
-\fB\-\-checksum\fR \fI<ALGO>\fR
-Which checksums to compute for each ROM found (repeatable, comma\-separable) [default: crc32,md5,sha1]
-.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\-h\fR, \fB\-\-help\fR
-Print help (see a summary with \*(Aq\-h\*(Aq)
-.SH "GLOBAL OPTIONS"
-.TP
-\fB\-\-json\fR
-Print one JSON object per line instead of human\-readable output
-.TP
-\fB\-\-progress\fR
-Show progress even when output is piped to a file or another program
-.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]
-.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
-Log more: \-v for info, \-vv for debug, \-vvv for trace
-.TP
-\fB\-q\fR, \fB\-\-quiet\fR
-Log errors only
-.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