FreightWing — extract → obfuscate → full game in apps

name: FreightWing Alliance MVP overview: Experimental XWA extract→transform, then an obfuscate/bake step that lands an opaque Novolis content pack inside apps/raylib/FreightWing as a self-contained full game. SpaceCombat + XFighter lift power the runtime; Steam/experimental are build-time only after bake. todos:

• id: xwa-extract-pipeline

content: Scaffold Novolis.Experimental.Xwa Formats/Extract/Transform/Cli; OPT/WAVE/flightmodels/missions → intermediate pack; gitignore; XWA_INSTALL_DIR status: completed

• id: xwa-obfuscate-bake

content: Add obfuscate/bake CLI that writes opaque Content pack into apps/raylib/FreightWing (hashed IDs, .novpack, no XWA filenames/paths) status: completed

• id: lib-space-combat

content: Add Novolis.Simulation.SpaceCombat (arcade flight, bolts, targeting, mission phases) + unit tests status: completed

• id: view-ship-camera

content: Extend Novolis.Simulation.View with cockpit/chase-aft craft camera pose helpers status: completed

• id: loot-presentation

content: Shared dogfooding presentation from XFighter; FreightWing loads only baked app Content (primitive fallback if missing) status: completed

• id: refactor-xfighter

content: Refactor XFighter to consume SpaceCombat; keep arena loop + Raylib HUD/audio status: completed

• id: scaffold-freightwing

content: Scaffold FreightWing as full game shell (MenuFlows campaign + flight + Content loader); register in dogfooding slnx/props status: completed

• id: mission-dual-role

content: Mission 1 freighter→transfer→fighter vertical on baked Content status: completed

• id: missions-2-3

content: Bake missions 2–3 + unlock progression; game complete without experimental at runtime status: completed

• id: publish-verify

content: Publish Simulation package via CI (not content blobs); bump PackageReferences; nuget-only / gpr health checks status: completed isProject: false

Decisions (locked)

• Source: Steam D:\Steam\steamapps\common\Star Wars X-Wing Alliance.
• Pipeline end state: a full game under `apps/raylib/FreightWing` that runs from its own baked Content/ — not a thin pointer at experimental at runtime.
• Stages: experimental extract → transform, then obfuscate/bake into the app.
• MVP = B + C: dual-role freighter→fighter + campaign shell (map/brief/flight/debrief, 3 missions).
• Tone: Alliance homage (family freighter, X-wing launch, Imperial hostiles, CMD HUD).
• XFighter: SpaceCombat consumer / arena smoke.
• IP: tools + parsers committed; raw extract + baked content blobs gitignored (local dogfood only). Never publish content as NuGet. Same spirit as `phase1-assets.md`.

Pipeline

flowchart LR
  Steam[XWA_Steam_install] --> Extract[Xwa.Extract]
  Extract --> Raw[experimental_assets_gitignored]
  Raw --> Transform[Xwa.Transform]
  Transform --> Intermediate[experimental_pack_gitignored]
  Intermediate --> Obfuscate[Xwa.Obfuscate_Bake]
  Obfuscate --> AppContent[FreightWing_Content_gitignored]
  AppContent --> FreightWing[FreightWing_full_game]
  SpaceCombat[Novolis.Simulation.SpaceCombat] --> FreightWing
  MenuFlows[Novolis.Game.MenuFlows] --> FreightWing

Obfuscation bake (concrete)

obfuscate / bake-app writes into FreightWing, not a shared experimental folder the game reads live:

• Opaque IDs: content keyed as stable hashes/UUIDs (c_a1f3…, s_9c2e…), not SPECDESC / TIEIN.OPT / Wave001.wav names
• Single Novolis pack: e.g. Content/freightwing.novpack (+ small manifest) — meshes, textures, SFX, craft profiles, missions — not a mirror of the Steam tree
• Axis/unit normalize already done in Transform; bake only remaps IDs and packs
• Strip provenance: no Steam paths, no original filenames, no “extracted from XWA” strings in runtime manifests
• App fiction table (code, committed): maps opaque IDs → in-game display names (Azzameen-flavored / Alliance homage copy) so renaming fiction does not require re-extract
• `.gitignore`: apps/raylib/FreightWing/Content/** (except maybe Content/README.md explaining bake)
• Rebuild: experimental Cli remains the only way to regenerate Content from Steam

Intermediate tools — `Novolis.Experimental.Xwa`

Under `d:\novolis\novolis-experimental`:

Format refs: JeremyAnsel.Xwa.Opt, foonix/XWOpt axis notes; port layouts in-repo where needed.

MVP curated extract (then bake): freighter + X-wing + 2–3 TIE OPTs; combat WAVE subset; flight profiles; 3 mission IRs for dual-role campaign.

Fallback: if Content/ missing, FreightWing still boots with primitives/procedural SFX (CI without Steam) and shows a clear “run bake-app” hint.

Platform libraries

• `Novolis.Simulation.SpaceCombat`: arcade flight, bolts, targeting, objectives, Freighter→Transfer→Fighter phases; load craft/mission from baked pack schema (opaque IDs).
• `Novolis.Simulation.View`: cockpit / chase-aft cameras.

FreightWing = full game in apps

Path: d:\novolis\novolis-dogfooding\apps\raylib\FreightWing

Committed game code (not content blobs):

• MenuFlows campaign: map → briefing → flight → debrief → unlock
• Flight session host, HUD/CMD (from XFighter lift), input, audio playback against Content pack
• Fiction/name tables, mission unlock save
• --smoke mode without Content

After bake, playing the game is only:

dotnet run --project d:\novolis\novolis-dogfooding\apps\raylib\FreightWing -p:NovolisUseProjectReferences=true

Explicit non-goals (MVP)

• Runtime dependency on Steam or novolis-experimental after bake
• Checking Content blobs into git or publishing them on GitHub Packages
• Full XWA EXE mission VM / patches / BINK / multiplayer
• Path-traced combat, Avalonia.3D combat host, HOTAS package, Physics.Motion 6DOF

Delivery sequence

1. Xwa Formats + Extract + Transform + Cli (extract / transform).
2. `bake-app` obfuscate → FreightWing Content/ + Content README.
3. SpaceCombat + View cameras + unit tests.
4. Scaffold FreightWing full-game shell + Content loader + XFighter presentation lift.
5. Refactor XFighter onto SpaceCombat.
6. Mission 1 on baked Content; then missions 2–3 + progression.
7. Publish Simulation package only; dogfooding PackageReference bump; policy scripts.

Build Content then play

$env:XWA_INSTALL_DIR = "D:\Steam\steamapps\common\Star Wars X-Wing Alliance"
dotnet run --project d:\novolis\novolis-experimental\src\Novolis.Experimental.Xwa.Cli -- extract --install $env:XWA_INSTALL_DIR
dotnet run --project d:\novolis\novolis-experimental\src\Novolis.Experimental.Xwa.Cli -- transform
dotnet run --project d:\novolis\novolis-experimental\src\Novolis.Experimental.Xwa.Cli -- bake-app --out d:\novolis\novolis-dogfooding\apps\raylib\FreightWing\Content
dotnet run --project d:\novolis\novolis-dogfooding\apps\raylib\FreightWing -p:NovolisUseProjectReferences=true