Milestone 3

e2e/README.md

@@ -0,0 +1,66 @@
+# Metamorph e2e
+
+End-to-end tests powered by [Playwright](https://playwright.dev/). Each milestone in `tasks/todo.md` should add at least one spec file (`tests/m<N>-*.spec.ts`).
+
+## One-time setup
+
+```bash
+cd e2e
+npm install
+npm run install-browsers      # downloads chromium (uses sudo for system deps)
+```
+
+## Running against a live stack
+
+```bash
+# 1. Bring the stack up from the repo root:
+cd .. && make up
+
+# 2. Run the tests:
+cd e2e && npm test
+
+# 3. Open the HTML report:
+npm run report                 # opens playwright-report/index.html in your browser
+```
+
+Or from the repo root:
+
+```bash
+make e2e        # runs against the already-up stack
+make e2e-report # opens the HTML report
+make e2e-up     # one-shot: make up + wait healthy + run tests
+```
+
+## Auto-spawn mode
+
+Set `PW_AUTOSTART=1` to let Playwright spawn `make up` itself before the run:
+
+```bash
+PW_AUTOSTART=1 npm test
+```
+
+## Configuration
+
+| Env var      | Default                  | Purpose                                       |
+|--------------|--------------------------|-----------------------------------------------|
+| `BASE_URL`   | `http://localhost:8080`  | The front nginx URL (which proxies `/api/*`)  |
+| `PW_AUTOSTART` | `0`                    | If `1`, spawn `make up` before the tests      |
+| `CI`         | unset                    | When set, retries=2 and parallel workers=2    |
+
+## Reports
+
+- **HTML**  : `e2e/playwright-report/index.html`
+- **JUnit** : `e2e/playwright-report/junit.xml` (CI ingestion)
+- **Trace** : kept on first retry, opened with `npx playwright show-trace …`
+
+## Layout
+
+```
+e2e/
+├── tests/
+│   └── m0-smoke.spec.ts        # bootstrap milestone (current)
+│   └── m<N>-*.spec.ts          # one spec per milestone, added as features land
+├── playwright.config.ts
+├── tsconfig.json
+└── package.json
+```