Epic 7: E2E Automation (Playwright, delegated to PW agent team)

[augustineuzokwe]

Goal

Deliver a complete Playwright TypeScript E2E suite covering every UI phase of the new React frontend, runnable in CI at $0 cost via the Epic 8 fake-LLM provider.

Delivery is delegated to the user's existing PW agent team at ~/.claude/test-agents/:

• Entry point: pw-team (single orchestrator — Analyze → Scaffold → Write → Review)
• Workers: pw-framework-builder, pw-dom-analyzer, pw-test-writer, pw-reviewer
• Conventions: established 4-layer architecture (Specs → Steps → Page objects → Utilities)
• Shared state: .pw-agents/project-state.md (PW team owns this file)

RTIA does not prescribe the framework structure, test layout, or fixture pattern — those are the PW team's domain.

User Stories

• US-27: Deliver Playwright E2E suite via pw-team #305 — US-27: Deliver Playwright E2E suite via pw-team
• US-28: Wire Playwright E2E into GitHub Actions #306 — US-28: Wire Playwright E2E into GitHub Actions

Depends On

• Epic 8 (Epic 8: Fake-LLM Provider (RTIA_LLM_PROVIDER=fake) #293, fake-LLM provider) must ship first so CI specs have a deterministic backend.
• Epic 6 must reach at least US-16 (US-16: React app scaffolding #294) + US-17 (US-17: Intake panel (paste + PDF/MD upload) #295) so the PW team analyzes the real DOM, not Gradio.

Out of Scope

• Test architecture, page-object layout, fixture format — owned by the PW agent team.
• Smoke testing against a real LLM (Ollama / Gemini) — covered ad-hoc by maintainer, not by this Epic.
• Visual regression (screenshot diffing) — can be added later if needed.

Definition of Done

• All Epic 7 User Stories merged.
• Every ThreadStatus value (IDLE, PAUSED_PO, PAUSED_REVIEW, DONE, DONE_SPLIT, ERROR) has at least one spec exercising it.
• All specs run with RTIA_LLM_PROVIDER=fake (zero API spend in CI).
• pw-reviewer review pass reports no Critical or Major findings.
• .pw-agents/project-state.md committed to the repo.
• .github/workflows/e2e.yml runs the suite on every PR and uploads playwright-report/ as an artifact.