Asset extraction

The ISO walk writes *.XA as Form-1 files, which truncates every Form-2 audio sector (2324 → 2048 bytes) and collapses a file's multiplexed channels into one shuffled stream. The CD-XA step instead reads raw 2352-byte sectors and writes one WAV per (file_no, ch_no), at the rate and stereo mode each sector's subheader declares. The NA corpus is 34 files / 316 channels, all 4-bit 37.8 kHz; the decoder is bit-exact.

prot-extract extract extracted/PROT.DAT extracted/PROT/ --cdname extracted/CDNAME.TXT
prot-extract list   extracted/PROT.DAT --cdname extracted/CDNAME.TXT
prot-extract locate extracted/PROT.DAT 0x17855 --in-entry 866 --cdname extracted/CDNAME.TXT
prot-extract retail-names extracted/CDNAME.TXT

• extract also writes manifest.json and an unpacked tim/<entry>/ dir per TIM-pack entry.
• list prints each size next to decl_span, the superseded over-reading expression, flagging ovr where it overshoots; locate re-keys coordinates measured under it.
• retail-names shows what the retail loader reads out of CDNAME.TXT. Its #define numbers are raw TOC indices, shifted +2 from the extraction filenames.
• --clamp-footprint is a deprecated no-op.

asset tim-catalog scans the whole PROT.DAT image, strict-validates each TIM and maps it to its owning entry + offset (or the unindexed system-UI gap); it recovers the same set an independent reference decoder reports, and --rollup prints the count + digest a disc-gated test pins. asset tim-deep-catalog decompresses every entry and catalogs the TIMs inside each section, keyed (entry, section, offset); a hit is admitted only when it strict-parses and decodes to RGBA.

asset categorize     <DIR> [--out categorize.json]    # per-class breakdown
asset extract        <file> --out <out_dir>           # streaming chunks -> files
asset stream         <file>                           # walk DATA_FIELD chunks, no extraction
asset describe       <file>                           # container TOC
asset effect-bundle  <file>
asset tmd-scan       <DIR>                            # byte-search for TMD magic
asset tim-scan       <DIR>                            # byte-search for TIM magic (lenient)
asset tim-catalog    <PROT.DAT> [--out f.tsv|f.json]  # strict flat catalog
asset tim-deep-catalog <PROT.DAT> [--out f.tsv|f.json] # TIMs inside LZS sections

xa demux-disc-all <disc.bin> --out extracted/XA_WAV   # every .XA -> per-channel WAV
xa demux-disc <disc.bin> --lba L --size S --out <dir>  # one .XA by LBA/size
xa info    <file.xa> [--channels stereo] [--sample-rate 37800]
xa convert <file.xa> [-o out.wav]                       # single Form-1 dump (guesses rate)