Sync: Complete project state with all MEGA SPRINT V1-V3 features and Codex stubs

ralph/gui/README.md

@@ -0,0 +1,47 @@
+# Ralph GUI
+
+This is a minimal localhost dashboard for Ralph.
+
+It does not execute runs by itself.
+
+It only reads:
+
+- `ralph/state/current_run.json`
+- `ralph/state/last_background_run.json`
+- `ralph/state/events.jsonl`
+- `ralph/state/provider_smoke.json`
+- recent folders under `ralph/runs/`
+
+## Start
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\ralph\scripts\Start-RalphDashboard.ps1
+```
+
+Default URL:
+
+```text
+http://127.0.0.1:8765
+```
+
+## What it shows
+
+- current run id, stage and status
+- implementer state
+- reviewer state
+- Codex master state
+- fix-pass state
+- recent event timeline
+- latest run folders and summary excerpts
+- last background runner metadata
+
+## Note
+
+The dashboard is intentionally simple.
+
+It is meant to answer:
+
+- who is working right now
+- what stage the swarm is in
+- whether Codex review already happened
+- whether a run completed, failed or stopped