fusionaly-qalisted

# QA Testing ## What did you change? Start here. | Change | Test level | Command | |--------|-----------|---------| | Bug fix, refactor, small feature | **Unit** | `make test` | | Feature, UI, big change | **Unit + E2E** | `make test` then `make test-e2e` | | Visual / UI verification | **Agent-browser** | `make dev` + agent-browser | | Install script, matcha, infra | **VM install** | multipass VM | | Release | **All of the above** | See release checklist | --- ## Level 1: Unit Tests (~3 seconds) ```bash make test ``` Run after every change. No excuses. --- ## Level 2: E2E Tests (~5 minutes) ```bash # CRITICAL: Kill any running dev server first — E2E uses its own database lsof -ti :3000 | xargs kill -9 2>/dev/null make test-e2e ``` Playwright tests that run onboarding, create websites, check dashboards, ingest events. Run after features or big changes. --- ## Level 3: Visual QA with agent-browser For verifying UI rendering, checking that data displays correctly, or testing flows that E2E doesn't cover. ### Setup (one-time) ```bash npm i -g agent-browser agent-browser install ``` ### Start dev server ```bash make dev # MUST use make dev (Go + Vite together) ``` ### Dev credentials - Email: `admin@example.com` - Password: `password` - Created by `make db-seed` ### Login ```bash agent-browser open "http://localhost:3000/login" agent-browser snapshot -i agent-browser fill @e1 "admin@example.com" agent-browser fill @e3 "password" agent-browser click @e4 ``` ###