Merge pull request #80 from eviltester/57-refactor-to-services

57 refactor to services

Author: eviltester

AGENTS.md

@@ -21,3 +21,17 @@ If verification fails:
 
 - `verify:local` is the canonical local gate for this repo.
 - CI uses `verify:ci` and branch protection should require CI to pass before merge.
+
+## Browser Test Interaction Rules
+
+When changing UI code, UI test abstractions, or browser tests:
+
+- run `npm run test:browser`
+- run `npm test` (or targeted UI Jest suites) for `packages/core-ui/src/tests` and `apps/web/src/tests/jest`
+
+For browser tests and page-object abstractions:
+
+- treat the app as a black box
+- use user-like interactions only (`click`, `fill`/`type`, keyboard navigation, blur/focus changes)
+- assert outcomes by polling rendered UI state
+- do not use synthetic event dispatch or direct DOM hooks to force app sync in browser abstractions (e.g. `dispatchEvent(...)`, `evaluate(...)` used to trigger internal listeners)