Add GPU startup visual test gate

This commit is contained in:
2026-05-19 10:23:22 -07:00
parent de02b20786
commit 11a13042b6
5 changed files with 191 additions and 2 deletions
@@ -0,0 +1,55 @@
@echo off
setlocal EnableExtensions
set "PROJECT_DIR=%~dp0.."
set "PACKAGE_DIR=%PROJECT_DIR%\Builds\WindowsDevelopment"
set "DEMO_EXE=%PACKAGE_DIR%\AgrarianGame.exe"
set "CAPTURE_ROOT=%PROJECT_DIR%\Saved\VisualQA\GpuStartup"
if /I "%~1"=="--check-tools" goto CHECK_TOOLS
call :CHECK_COMMON || exit /b %ERRORLEVEL%
if not exist "%CAPTURE_ROOT%" mkdir "%CAPTURE_ROOT%" >nul 2>nul
echo.
echo Agrarian packaged-client real-GPU startup visual test
echo -----------------------------------------------------
echo Package: "%PACKAGE_DIR%"
echo Capture root: "%CAPTURE_ROOT%"
echo.
echo Use Sunshine plus Moonlight or an equivalent real GPU desktop capture path.
echo Do not use QEMU guest-agent screenshots for this visual gate.
echo.
echo Required capture labels:
echo 01-startup-credits
echo 02-character-selection
echo 03-server-join
echo 04-loading
echo 05-first-spawn
echo 06-pause-menu
echo 07-save-quit
echo.
echo Create visual-startup-check.txt in the capture folder with package path,
echo launcher used, capture method, tester, pass/fail result, and notes.
echo.
exit /b 0
:CHECK_TOOLS
call :CHECK_COMMON || exit /b %ERRORLEVEL%
echo READY: packaged demo exists and SunshineService is running.
exit /b 0
:CHECK_COMMON
if not exist "%DEMO_EXE%" (
echo ERROR: Packaged demo executable not found: "%DEMO_EXE%"
exit /b 2
)
sc query SunshineService | find /I "RUNNING" >nul 2>nul
if errorlevel 1 (
echo ERROR: SunshineService is not running. Start Sunshine before the GPU visual test.
exit /b 3
)
exit /b 0
@@ -0,0 +1,59 @@
#!/usr/bin/env python3
"""Verify the real-GPU packaged startup visual test gate is documented."""
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
DOC = ROOT / "Docs" / "Ops" / "PackagedClientGpuStartupVisualTest.md"
BAT = ROOT / "Scripts" / "RunWindowsGpuStartupVisualCheck.bat"
ROADMAP = ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md"
def require(condition: bool, message: str) -> None:
if not condition:
raise SystemExit(f"FAILED: {message}")
def main() -> None:
doc = DOC.read_text(encoding="utf-8")
bat = BAT.read_text(encoding="utf-8")
roadmap = ROADMAP.read_text(encoding="utf-8")
for token in (
"Do not use QEMU guest-agent screenshots",
"Sunshine",
"Moonlight",
"Builds\\WindowsDevelopment",
"01-startup-credits",
"02-character-selection",
"03-server-join",
"04-loading",
"05-first-spawn",
"06-pause-menu",
"07-save-quit",
"visual-startup-check.txt",
):
require(token in doc, f"visual startup test doc missing {token!r}")
for token in (
"SunshineService",
"Builds\\WindowsDevelopment",
"AgrarianGame.exe",
"--check-tools",
"Do not use QEMU guest-agent screenshots",
"01-startup-credits",
"07-save-quit",
):
require(token in bat, f"Windows visual startup helper missing {token!r}")
require(
"- [x] Add a visually verified packaged-client startup test using Sunshine/Moonlight or another real GPU desktop capture path" in roadmap,
"0.1.O real-GPU startup visual test roadmap item is not checked off",
)
print("OK: packaged-client real-GPU startup visual test gate is documented and scripted.")
if __name__ == "__main__":
main()