docs/CAMPAIGN_FRIIDUMP_HOMEPAGE_AND_RELEASES.md

   1 # FriiDump homepage, Linux parity, and release automation campaign
   2
   3 ## Governing order
   4
   5 1. Candidate11 Linux Xbox/XGD user-path parity.
   6 2. Release automation v1 with exact-tag builders and immutable artifacts.
   7 3. Compatibility site v1.3.0 promoted into the FriiDump project homepage.
   8 4. MinGW cross-build investigation after the MSVC and native-Linux pipeline is
   9    established and verified.
  10
  11 ## Candidate11
  12
  13 The validated Windows/MSVC build remains the Windows authority. Linux reuses
  14 FriiDump's portable MMC transport and receives equivalent Xbox metadata,
  15 output, cancellation, hashing, and native-report behavior. Development-only
  16 XGD1 probes are a separate substage.
  17
  18 ## Release automation v1
  19
  20 A validated annotated tag creates a small build request. Compilation does not
  21 run inside the Git hook.
  22
  23 - Linux worker: exact tag, GCC/CMake, x86_64 artifact.
  24 - Windows worker: exact tag, Visual Studio 2019 Build Tools, x86 artifact.
  25 - Both workers run tests and publish signed-by-hash build manifests to staging.
  26 - A publisher verifies all required artifacts and atomically publishes an
  27   immutable release directory plus `latest.json`.
  28 - Failed or incomplete builds remain in staging and never change `latest`.
  29
  30 ## Site v1.3.0
  31
  32 The public site becomes the FriiDump homepage with:
  33
  34 - Windows and Linux download cards;
  35 - source archive, tag, commit, tree, and SHA-256 identity;
  36 - compatibility table and evidence views;
  37 - report submission;
  38 - documentation and release history;
  39 - machine-readable `latest.json` and immutable release manifests.
  40
  41 The Git repository may remain LAN-only. Public source ZIPs and exact provenance
  42 are sufficient; public Gitweb is optional.
  43
  44 ## MinGW follow-up
  45
  46 MinGW is the preferred eventual Windows automation path after initial setup and
  47 verification. It must be introduced as a separate toolchain identity, compared
  48 against the validated MSVC behavior, and promoted only after real-drive and
  49 native-report parity is demonstrated.