docs/reports/FRIIDUMP_XBOX_REDUMP_EVIDENCE_HANDOFF_0.5.3.8.md

   1 # FriiDump 0.5.3.8 — Xbox Reference-Path Redump Evidence Handoff
   2
   3 ## Scope
   4
   5 This update closes the Redump-verification boundary that remained after
   6 FriiDump 0.5.3.7. On Windows, the copied GDR-8050L reference dumper already
   7 calculated finalized full-file CRC32, MD5, SHA-1, and SHA-256 values and wrote
   8 XGD1 sidecars, but those values did not return to FriiDump's shared DAT
   9 verifier.
  10
  11 The update changes evidence handoff, result propagation, and reporting. It does
  12 not add or modify any optical-drive firmware-update, flash, erase, `3B06`,
  13 `3B07`, or `FLASHUP` operation.
  14
  15 ## Result contract
  16
  17 `xbox_ref_dump_result` now carries:
  18
  19 - whether the reference path was attempted;
  20 - the actual dump/write result;
  21 - dump mode (`1` full-disc ISO or `2` XISO);
  22 - actual finalized output path;
  23 - output sector count;
  24 - actual output byte count;
  25 - CRC32;
  26 - MD5;
  27 - SHA-1;
  28 - SHA-256;
  29 - whether all finalized hashes are complete.
  30
  31 This explicit contract supports both an `-i <file>` override and bare `-i`,
  32 where the copied reference path derives `Title[MediaID].iso` after reading XBE
  33 and DMI metadata.
  34
  35 ## No duplicate 7.29 GiB hash pass
  36
  37 The copied reference path already reopens the finalized file and calculates
  38 CRC32, MD5, SHA-1, and SHA-256. FriiDump 0.5.3.8 reuses those values directly.
  39 It does not reread the complete Xbox image solely to feed the DAT verifier.
  40
  41 The schema-2 report records:
  42
  43 ```text
  44 hash_source = GDR-8050L reference finalized full-file hashes
  45 ```
  46
  47 ## Corrected success propagation
  48
  49 Before this update, the bridge called `DumpXboxGameDisc()` and then assigned
  50 success unconditionally. `DumpXboxGameDisc()` now returns its real dump/write
  51 result. The bridge and normal FriiDump validation summary therefore cannot
  52 claim success merely because the copied function returned to its caller.
  53
  54 ## Unified logging lifetime
  55
  56 When FriiDump supplies the existing drive handle, the copied bridge no longer
  57 closes the active target log before returning. The shared Redump evidence block,
  58 atomic-report completion line, final STOP UNIT result, validation summary, and
  59 log-completion line can remain in one target log.
  60
  61 The standalone bridge entry point still closes the log it owns.
  62
  63 ## XISO boundary
  64
  65 Xbox `-X` remains intentionally outside Redump DAT verification. XISO is a
  66 partition representation and does not have the byte layout of a full Redump
  67 Original Xbox disc image.
  68
  69 ## XGD1 representation honesty
  70
  71 PFES-TR-004 requires synthetic ranges to remain explicit and states that a
  72 correct output size or layer break does not establish Redump hash identity.
  73 The shared report now includes `representation_note` for Xbox results:
  74
  75 ```text
  76 XGD1 acquisition success and exact Redump hash identity are separate claims;
  77 documented synthetic reconstruction ranges may prevent an exact match.
  78 ```
  79
  80 Therefore, a successful physical read followed by `NO EXACT MATCH` is a valid
  81 and expected evidence outcome for the current reconstructed layout. It is not
  82 promoted to archive identity.
  83
  84 ## GameCube regression evidence
  85
  86 Before this integration, FriiDump 0.5.3.7 was live-validated against two
  87 distinct GameCube DAT entries:
  88
  89 - Sonic Mega Collection (USA)
  90 - Super Smash Bros. Melee (USA) (En,Ja) (Rev 2)
  91
  92 The Melee run completed with seed retrieval in 3 seconds, full dump and STOP
  93 UNIT success, and exact size/CRC32/MD5/SHA-1 agreement.
  94
  95 ## Local validation
  96
  97 - Linux CMake build: PASS
  98 - v64 ZIP overlay onto the v63 baseline, internal SHA-256 verification, and rebuild: PASS
  99 - Help/version output: PASS (`FriiDump 0.5.3.8`)
 100 - Result-contract source checks: PASS
 101 - Existing GameCube Melee DAT exact-match regression: PASS
 102 - Xbox Red Faction II (USA) DAT exact-match parser fixture: PASS
 103 - Xbox no-hash-correlation fixture: PASS
 104 - Prior live Red Faction II reconstructed hashes against current Xbox DAT: expected `NO EXACT MATCH`, PASS
 105 - Existing Reed-Solomon warnings: unchanged and outside scope
 106
 107 A prior live Red Faction II reconstructed ISO had the correct 7,825,162,240-byte
 108 size but hashes `0babc98e` / `207043740237dc31ae0768027b0fbaa5` /
 109 `cd67731da785e9eba8a64cf73ae429c812fb6a62`. Against the current Xbox DAT this
 110 produces `NO EXACT MATCH`, no hash-correlated candidate, and 2,626 same-size
 111 entries. This is the expected PFES-honest outcome for the current synthetic
 112 layout.
 113
 114 The Windows GDR-8050L/cross-flashed GDR-8163B full-disc run remains the required
 115 live validation for the new result handoff and common report path.