<#
.SYNOPSIS
    #422 characterisation loop: N offline High captures, each launched under
    cdb with the debug heap (tools/run-offline-pixel-gate.ps1 -DebuggerScript),
    summarised to artifacts/i422dh/summary.txt.
.EXAMPLE
    pwsh tools/i422/loop-debugheap.ps1 -Runs 24
    # the recipe that reproduced #422 at VM7 (retail preset, 1080p, 45 s warm-up):
    pwsh tools/i422/loop-debugheap.ps1 -Runs 8 -Preset retail -Resolution 1920x1080 -WarmupMs 45000 -OutLeaf i422dh-retail1080
#>
param(
    [int]$Runs = 24,
    [ValidateSet('retail', 'low', 'medium', 'high', 'auto')][string]$Preset = 'high',
    [string]$Resolution = '1280x720',
    [int]$WarmupMs = 12000,
    [string]$OutLeaf = 'i422dh')
$ErrorActionPreference = 'Continue'
$repo = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
$root = Join-Path $repo ('artifacts' + [IO.Path]::DirectorySeparatorChar + $OutLeaf)
New-Item -ItemType Directory -Force $root | Out-Null
$summary = Join-Path $root 'summary.txt'
"run,gateExit,shutdownLine,heapLine" | Set-Content $summary
for ($i = 1; $i -le $Runs; $i++) {
    $out = Join-Path $root ("run-{0:D2}" -f $i)
    $gateOut = Join-Path $root ("gate-{0:D2}.out" -f $i)
    $gateErr = Join-Path $root ("gate-{0:D2}.err" -f $i)
    $gate = Start-Process -FilePath 'pwsh' -ArgumentList @(
        '-NoProfile', '-File', (Join-Path $repo 'tools\run-offline-pixel-gate.ps1'),
        '-Out', $out, '-SkipBuild', '-RenderPackPreset', $Preset, '-Resolution', $Resolution, '-WarmupMs', "$WarmupMs", '-Uncapped',
        '-DebuggerScript', (Join-Path $repo 'tools\cdb\i422-heap-launch.cdb')) `
        -PassThru -WindowStyle Hidden -RedirectStandardOutput $gateOut -RedirectStandardError $gateErr
    $gate.WaitForExit()
    $clientLog = Join-Path $out 'client.log'
    $shutdown = ''
    $m = Select-String -Path $gateErr -Pattern 'exited with code|timed out|No screenshot' -ErrorAction SilentlyContinue | Select-Object -First 1
    if ($m) { $shutdown = $m.Line.Trim() -replace ',', ';' }
    $heap = ''
    if (Test-Path $clientLog) {
        $h = Select-String -Path $clientLog -Pattern 'HEAP\[|Critical error|heap corruption|FAULTING_IP|Access violation|STATUS_HEAP|second chance|!analyze' |
            Where-Object { $_.Line -notmatch '^\d+:\d+> sxe' } | Select-Object -First 1
        if ($h) { $heap = $h.Line.Trim() -replace ',', ';' }
    }
    "$i,$($gate.ExitCode),$shutdown,$heap" | Add-Content $summary
    Write-Host ("run {0}: gate {1} {2} {3}" -f $i, $gate.ExitCode, $shutdown, $heap)
}
Get-Content $summary