hot-reload attempt (unreviewed, not working)

scripts/launch_pcsx_debug.ps1

@@ -1,41 +1,77 @@
 # scripts/launch_pcsx_debug.ps1
 #
 # One-shot launcher for debug sessions: starts pcsx-redux with the .ps-exe
-# loaded, the gdb stub enabled, AND the pcsx_debug_helper Lua plugin loaded
-# so external CLI tools (gdb's `shell` command, etc.)
-# can read GTE state via http://localhost:8080/api/v1/lua/gte
-# (the gdb stub doesn't expose COP2 at all).
-#
-# usage:
-#   .\scripts\launch_pcsx_debug.ps1
-#   .\scripts\launch_pcsx_debug.ps1 -ExePath build\hello_gte.ps-exe
-#   .\scripts\launch_pcsx_debug.ps1 -HelperZip scripts\pcsx_debug_helper.zip
+# loaded, the gdb stub enabled, the web server enabled, AND the
+# pcsx_debug_helper Lua plugin loaded so external CLI tools can drive
+# reloads via http://localhost:8080/api/v1/lua/reload.
 #
 # After launch:
 #   - gdb: target remote localhost:3333
-#   - web: curl http://localhost:8080/api/v1/lua/gte
+#   - web: POST http://localhost:8080/api/v1/lua/reload?mode=prime&...
+#
+# usage:
+#   .\scripts\launch_pcsx_debug.ps1
+#   .\scripts\launch_pcsx_debug.ps1 -ExePath build\hello_camera.ps-exe
+#   .\scripts\launch_pcsx_debug.ps1 -Cpu dynarec
+#   .\scripts\launch_pcsx_debug.ps1 -ElfPath build\hello_camera.elf
 #
 # Companion: scripts/debug_psyq.ps1 (bare launch — no .ps-exe, no helper).
 
 [CmdletBinding()]
 param(
     [string]$PcsxPath = (Join-Path $PSScriptRoot '..\toolchain\pcsx-redux\vsprojects\x64\Release\pcsx-redux.exe'),
-    [string]$ExePath  = (Join-Path $PSScriptRoot '..\build\hello_gte.ps-exe'),
+    [string]$ExePath  = (Join-Path $PSScriptRoot '..\build\hello_camera.ps-exe'),
+    [string]$ElfPath  = '',
     [string]$HelperZip = (Join-Path $PSScriptRoot 'pcsx_debug_helper.zip'),
     [int]   $GdbPort  = 3333,
-    [int]   $WebPort  = 8080
+    [int]   $WebPort  = 8080,
+    [ValidateSet('interpreter', 'dynarec')][string]$Cpu = 'interpreter'
 )
 
 $ErrorActionPreference = 'Stop'
 
+# ── Derive -ElfPath when absent ──
+# Convention: the .elf sits beside the .ps-exe with the same stem.
+if ([string]::IsNullOrEmpty($ElfPath)) {
+    $exeFull  = [System.IO.Path]::GetFullPath($ExePath)
+    $stem     = [System.IO.Path]::GetFileNameWithoutExtension($exeFull)
+    $exeDir   = [System.IO.Path]::GetDirectoryName($exeFull)
+    $ElfPath  = Join-Path $exeDir "$stem.elf"
+}
+
 # ── Pre-checks ──
-foreach ($p in @($PcsxPath, $ExePath, $HelperZip)) {
-    if (-not (Test-Path $p)) {
+foreach ($p in @($PcsxPath, $ExePath, $ElfPath, $HelperZip)) {
+    if (-not (Test-Path -LiteralPath $p)) {
         Write-Error "Missing: $p"
         exit 1
     }
 }
 
+# ── Reject a stale helper zip (Task 8) ──
+# The helper zip must be newer than every .lua source that contributes
+# to it. A stale zip means the running plugin does not match the on-disk
+# source, which makes the reload contract meaningless.
+$helperDir  = Join-Path $PSScriptRoot 'pcsx_debug_helper'
+$elf32Src   = Join-Path $PSScriptRoot 'elf32.lua'
+$sourceLuas = @(
+    (Join-Path $helperDir 'autoexec.lua'),
+    (Join-Path $helperDir 'reload.lua'),
+    $elf32Src
+) | Where-Object { Test-Path -LiteralPath $_ }
+
+$zipTime = (Get-Item -LiteralPath $HelperZip).LastWriteTime
+$stale = $false
+foreach ($src in $sourceLuas) {
+    $srcTime = (Get-Item -LiteralPath $src).LastWriteTime
+    if ($srcTime -gt $zipTime) {
+        Write-Error "helper zip is older than source: $src (zip=$($zipTime.ToString('o')) src=$($srcTime.ToString('o')); rerun build_psyq.ps1 to regenerate."
+        $stale = $true
+    }
+}
+if ($stale) {
+    exit 1
+}
+
 # Kill any existing pcsx-redux so the archive file isn't locked.
 Get-Process pcsx-redux -ErrorAction SilentlyContinue | Stop-Process -Force
 Start-Sleep -Seconds 2
@@ -44,17 +80,23 @@ Start-Sleep -Seconds 2
 $absExe  = [System.IO.Path]::GetFullPath($ExePath)
 $absZip  = [System.IO.Path]::GetFullPath($HelperZip)
 
+$cpuFlag = if ($Cpu -eq 'dynarec') { '-dynarec' } else { '-interpreter' }
+
 $args = @(
     '-gdb', '-run'
     '-loadexe', "`"$absExe`""
     '-archive', "`"$absZip`""
+    '-webserver'
+    $cpuFlag
 )
 
 Write-Host "Launching pcsx-redux..." -ForegroundColor Cyan
 Write-Host "  ps-exe    : $absExe"
+Write-Host "  elf       : $ElfPath"
 Write-Host "  helper zip: $absZip"
 Write-Host "  gdb       : localhost:$GdbPort"
-Write-Host "  web       : localhost:$WebPort/api/v1/lua/gte"
+Write-Host "  web       : localhost:$WebPort/api/v1/lua/reload"
+Write-Host "  cpu       : $Cpu ($cpuFlag)"
 Write-Host ""
 
 Start-Process -FilePath $PcsxPath -ArgumentList $args | Out-Null
@@ -89,6 +131,44 @@ try {
     Write-Host "Check the pcsx-redux Lua Console for debug cli messages." -ForegroundColor Yellow
 }
 
+# ── Prime the reload handler (Task 8) ──
+# The reload handler keeps an internal ACTIVE manifest of the running
+# ELF; reload requests fail with reload_not_primed until prime succeeds.
+# We retry until the response carries ok=true or the launch deadline
+# expires — the helper may not have finished registering handlers in the
+# first web-poll cycle after the gte handler comes up.
+$absElf = [System.IO.Path]::GetFullPath($ElfPath)
+$encodedPath = [uri]::EscapeDataString($absElf)
+$primeUri = "http://localhost:${WebPort}/api/v1/lua/reload?mode=prime&target=hello_camera&path=${encodedPath}"
+
+Write-Host "Priming reload handler: $primeUri" -ForegroundColor Cyan
+$primeDeadline = (Get-Date).AddSeconds(15)
+$primeOk = $false
+while ((Get-Date) -lt $primeDeadline) {
+    try {
+        $resp = Invoke-WebRequest -Method Post -Uri $primeUri -UseBasicParsing -TimeoutSec 5
+        $body = if ($resp.Content -is [byte[]]) {
+            [System.Text.Encoding]::UTF8.GetString([byte[]]$resp.Content)
+        } else {
+            [string]$resp.Content
+        }
+        $obj = $body | ConvertFrom-Json
+        if ($obj.ok) {
+            Write-Host "Prime OK: $(($obj | ConvertTo-Json -Compress))" -ForegroundColor Green
+            $primeOk = $true
+            break
+        } else {
+            Write-Host "Prime not yet ready: error=$($obj.error)" -ForegroundColor Yellow
+        }
+    } catch {
+        Write-Host "Prime request failed: $($_.Exception.Message)" -ForegroundColor Yellow
+    }
+    Start-Sleep -Milliseconds 500
+}
+if (-not $primeOk) {
+    Write-Warning "Prime did not return ok=true before the launch deadline. Reload requests will fail until the user primes manually."
+}
+
 Write-Host ""
 Write-Host "pcsx-redux running. PIDs:" -ForegroundColor Cyan
-Get-Process pcsx-redux | Select-Object Id, ProcessName | Format-Table
+Get-Process pcsx-redux | Select-Object Id, ProcessName | Format-Table