Add two client connection QA gate

2026-05-19 13:49:06 -07:00
parent 388ae36392
commit 57dd034bba
4 changed files with 118 additions and 1 deletions
@@ -0,0 +1,42 @@
+@echo off
+setlocal EnableExtensions
+
+set "PROJECT_DIR=%~dp0.."
+set "PACKAGE_DIR=%PROJECT_DIR%\Builds\WindowsDevelopment"
+set "DEMO_EXE=%PACKAGE_DIR%\AgrarianGame.exe"
+set "SERVER_ENDPOINT=play.agrariangame.com:7777"
+
+if not "%~1"=="" (
+  if /I not "%~1"=="--check-tools" (
+    set "SERVER_ENDPOINT=%~1"
+  )
+)
+
+if not exist "%DEMO_EXE%" (
+  echo ERROR: Packaged demo executable not found: "%DEMO_EXE%"
+  exit /b 2
+)
+
+if /I "%~1"=="--check-tools" (
+  echo READY: packaged client exists for two-client connection smoke test.
+  exit /b 0
+)
+
+echo Agrarian two-client connection smoke test
+echo -----------------------------------------
+echo Package: "%PACKAGE_DIR%"
+echo Server: %SERVER_ENDPOINT%
+echo.
+echo Starting client A...
+start "Agrarian Client A" "%DEMO_EXE%" %SERVER_ENDPOINT% -log -windowed -ResX=1280 -ResY=720
+timeout /t 8 /nobreak >nul
+
+echo Starting client B...
+start "Agrarian Client B" "%DEMO_EXE%" %SERVER_ENDPOINT% -log -windowed -ResX=1280 -ResY=720
+
+echo.
+echo Confirm both clients reach Ground Zero, see matching time/weather, and
+echo remain connected long enough to start the smoke test in:
+echo Docs\Ops\MultiplayerLatencyTestPlan.md
+echo.
+exit /b 0
@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""Verify the MVP two-client connection QA gate is documented and scripted."""
+
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+ROADMAP = ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md"
+QA_DOC = ROOT / "Docs" / "QA" / "MvpQaGates.md"
+LATENCY_DOC = ROOT / "Docs" / "Ops" / "MultiplayerLatencyTestPlan.md"
+SMOKE_BAT = ROOT / "Scripts" / "RunTwoClientConnectionSmoke-Windows.bat"
+
+REQUIRED = {
+    QA_DOC: [
+        "## Two-Client Connection",
+        "Scripts/RunTwoClientConnectionSmoke-Windows.bat --check-tools",
+        "play.agrariangame.com:7777",
+        "Both clients reach the same Ground Zero session",
+        "Docs/Ops/MultiplayerLatencyTestPlan.md",
+    ],
+    LATENCY_DOC: [
+        "Connect two packaged Windows clients.",
+        "Confirm both clients see the same world time and weather.",
+        "Core interactions eventually reconcile",
+    ],
+    SMOKE_BAT: [
+        "Agrarian Client A",
+        "Agrarian Client B",
+        "play.agrariangame.com:7777",
+        "--check-tools",
+        "AgrarianGame.exe",
+        "MultiplayerLatencyTestPlan.md",
+    ],
+    ROADMAP: [
+        "[x] Can connect two clients.",
+    ],
+}
+
+
+def main() -> None:
+    missing: list[str] = []
+    for path, snippets in REQUIRED.items():
+        text = path.read_text(encoding="utf-8")
+        for snippet in snippets:
+            if snippet not in text:
+                missing.append(f"{path.relative_to(ROOT)} missing {snippet!r}")
+    if missing:
+        raise SystemExit("FAILED: " + "; ".join(missing))
+    print("OK: two-client connection QA gate is documented and scripted.")
+
+
+if __name__ == "__main__":
+    main()