riojoy/deploy/build-pod.ps1

<#
.SYNOPSIS
    Build a POD-BUNDLED RIOJoy for one podized game (PLAN.md §Phase 10): a
    drop-in folder the game's install carries inside its own directory —
    app + portable config (the game's profile) + start script. RIOJoy starts
    with the game (--exit-with) and exits by itself when the game exits, so
    no resident RIOJoy runs on the pod and the console operator never touches
    it. Carries NO drivers/vendor payload: the pod is provisioned once by the
    universal package (build-package.ps1 → install-rio.ps1).

.PARAMETER ProfileJson
    Path to the game's single-profile JSON document (must carry "Name";
    same format as profiles\descent-d1x.json).
.PARAMETER GameExe
    Game executable name for --exit-with. Default: the profile's first
    MatchExecutables entry.
.PARAMETER Flavor
    net48 (Windows 10/11 pods, default) or net40 (XP pods, x86).
.PARAMETER OutDir
    Where to write the zip (default: dist, relative to the repo root).
.PARAMETER Configuration
    Build configuration (default: Release).
#>
param(
    [Parameter(Mandatory = $true)]
    [string]$ProfileJson,
    [string]$GameExe,
    [ValidateSet('net48', 'net40')]
    [string]$Flavor = 'net48',
    [string]$OutDir = 'dist',
    [string]$Configuration = 'Release'
)

$ErrorActionPreference = 'Stop'
$repo    = Split-Path $PSScriptRoot -Parent        # deploy\ -> repo root
$staging = Join-Path ([IO.Path]::GetTempPath()) "riojoy-pod-$([Guid]::NewGuid().ToString('N'))"

Write-Host '== RIOJoy pod bundle ==' -ForegroundColor Cyan

# --- profile document -----------------------------------------------------
if (-not (Test-Path $ProfileJson)) { throw "Profile document not found: $ProfileJson" }
$profileText = Get-Content $ProfileJson -Raw
$profileDoc  = $profileText | ConvertFrom-Json
if (-not $profileDoc.Name) { throw "Profile file '$ProfileJson' has no Name." }
if (-not $GameExe) {
    $GameExe = @($profileDoc.MatchExecutables) | Select-Object -First 1
    if (-not $GameExe) { throw "Profile has no MatchExecutables; pass -GameExe <name>." }
}

# --- version stamp --------------------------------------------------------
$sha = (& git -C $repo rev-parse --short HEAD 2>$null)
if (-not $sha) { $sha = 'nogit' }
$version = "{0}-{1}" -f (Get-Date -Format 'yyyyMMdd'), $sha
$safeName = $profileDoc.Name
foreach ($c in [IO.Path]::GetInvalidFileNameChars()) { $safeName = $safeName.Replace($c, '_') }
$safeName = $safeName -replace ' ', '-'

try {
    $appOut = Join-Path $staging 'riojoy'
    New-Item -ItemType Directory -Force -Path $appOut | Out-Null

    # 1. Publish the tray app (framework-dependent, like the universal package).
    Write-Host "Publishing RioJoy.Tray ($Configuration, $Flavor)..."
    & dotnet publish (Join-Path $repo 'src\RioJoy.Tray\RioJoy.Tray.csproj') `
        -c $Configuration -f $Flavor -p:DebugType=none `
        -o $appOut | Out-Null
    if ($LASTEXITCODE -ne 0) { throw "dotnet publish ($Flavor) failed." }

    if ($Flavor -eq 'net48') {
        # Same SkiaSharp pruning as build-package.ps1: keep the win-x64 native
        # at the app root, drop arch subdirs and non-Windows natives.
        foreach ($d in 'x64', 'x86', 'arm64') {
            $nd = Join-Path $appOut $d
            if (Test-Path $nd) { Remove-Item $nd -Recurse -Force }
        }
        Get-ChildItem $appOut -Filter '*.dylib' -ErrorAction SilentlyContinue | Remove-Item -Force
        Get-ChildItem $appOut -Filter '*.so' -ErrorAction SilentlyContinue | Remove-Item -Force
    }

    # 2. Portable config beside the exe (ConfigLocator picks it over %APPDATA%):
    #    an AppConfig wrapping just this game's profile, verbatim.
    $configJson = "{`n  `"Profiles`": [`n$profileText`n  ]`n}"
    Set-Content -Path (Join-Path $appOut 'config.json') -Value $configJson -Encoding utf8
    Set-Content -Path (Join-Path $appOut 'VERSION.txt') -Value "RIOJoy pod bundle $version ($Flavor) - $($profileDoc.Name)" -Encoding utf8

    # 3. Start script: the game's launch script calls this before the game.
    $startBat = @(
        '@echo off'
        "rem RIOJoy pod companion for $($profileDoc.Name)."
        'rem Call from the game''s launch script BEFORE starting the game;'
        'rem RIOJoy exits by itself when the game exits (--exit-with).'
        "start `"`" `"%~dp0riojoy\RioJoy.Tray.exe`" --exit-with $GameExe"
    ) -join "`r`n"
    Set-Content -Path (Join-Path $staging 'start-riojoy.bat') -Value $startBat -Encoding Ascii

    # 4. Integrator note.
    $readme = @(
        "RIOJoy pod bundle - $($profileDoc.Name) ($version, $Flavor)"
        ''
        'Drop the riojoy\ folder and start-riojoy.bat into the game''s install'
        'directory on the pod, and call start-riojoy.bat from the game''s launch'
        'script before starting the game. RIOJoy activates when the game window'
        'comes foreground and exits by itself when the game exits - no resident'
        'RIOJoy, nothing for the console operator to manage.'
        ''
        'The pod must be provisioned once with the universal RIOJoy package'
        '(drivers: ViGEmBus / RioGamepad - see install-rio.ps1); pod bundles'
        'deliberately carry no drivers.'
        ''
        'The game''s profile lives in riojoy\config.json (portable mode - the'
        'per-user %APPDATA% config is ignored while it exists). Edit it there,'
        'or run riojoy\RioJoy.Tray.exe with no arguments for the profile editor.'
    ) -join "`r`n"
    Set-Content -Path (Join-Path $staging 'README-POD.txt') -Value $readme -Encoding Ascii

    # 5. Zip with forward-slash entry names (same rationale as build-package.ps1).
    $outDirFull = if ([IO.Path]::IsPathRooted($OutDir)) { $OutDir } else { Join-Path $repo $OutDir }
    New-Item -ItemType Directory -Force -Path $outDirFull | Out-Null
    $zip = Join-Path $outDirFull "RIOJoy-pod-$safeName-$version.zip"
    if (Test-Path $zip) { Remove-Item $zip -Force }
    Write-Host "Zipping -> $zip"
    Add-Type -AssemblyName System.IO.Compression
    Add-Type -AssemblyName System.IO.Compression.FileSystem
    $base = (Resolve-Path $staging).Path.TrimEnd('\') + '\'
    $fs = [System.IO.File]::Open($zip, [System.IO.FileMode]::CreateNew)
    try {
        $archive = New-Object System.IO.Compression.ZipArchive($fs, [System.IO.Compression.ZipArchiveMode]::Create)
        try {
            foreach ($file in Get-ChildItem -Path $staging -Recurse -File) {
                $entryName = $file.FullName.Substring($base.Length) -replace '\\', '/'
                [System.IO.Compression.ZipFileExtensions]::CreateEntryFromFile(
                    $archive, $file.FullName, $entryName,
                    [System.IO.Compression.CompressionLevel]::Optimal) | Out-Null
            }
        } finally { $archive.Dispose() }
    } finally { $fs.Dispose() }

    $size = '{0:N1} MB' -f ((Get-Item $zip).Length / 1MB)
    Write-Host ''
    Write-Host "Pod bundle built: $zip ($size)" -ForegroundColor Green
    Write-Host "Integrate: extract into the game's folder, call start-riojoy.bat from its launch script (game exe: $GameExe)."
}
finally {
    if (Test-Path $staging) { Remove-Item $staging -Recurse -Force }
}