2026-07-24 21:46:03 +00:00
1 changed files with 15 additions and 0 deletions
@@ -57,6 +57,21 @@ for driving a headless browser on this NixOS box (the Playwright MCP server
 does not work here). Point any browser tooling at `http://localhost:4567` to
 load pages, take screenshots, and compare before/after.
 **Assume the stack is dirty when you arrive, and leave it clean.** Reset it
 (`make dev-reset`) before the first boot of a testing session and tear it down
 after every cycle, including a failed one; a stack carrying the last session's
 data is the usual reason a screenshot shows something that no longer exists in
 the code. Full hygiene rules live in `../sow-nodebb/AGENTS.md`. Two things
 that bite here in particular:
 - **Templates and client JS are compiled**, so a browser reload alone proves
  nothing after editing them. `make dev-build` — and note the build marker
  lives on the container filesystem, so a plain `restart` skips the rebuild.
 - **Playwright login on this forum**: the form is `#username` / `#password`
  with a `#login` submit button, and a successful login lands on
  `/?loggedin=true`, which `page.waitForURL('**/')` never matches. Wait on
  `page.waitForLoadState('networkidle')` instead.
 ## Design Context
 - `PRODUCT.md`: strategic design context — register, users, purpose,