thinkpool-pair 0.7.445 → 0.7.448

package/README.md

@@ -227,6 +227,31 @@ their own sandbox cannot bind a port or launch a browser:
 Preview roots are read-only, cannot escape the lane worktree, and accept only
 the preview server’s loopback origin for page requests.
 
+The browser starts on demand and is reused while work is active. After the
+last active or queued job finishes, 60 seconds of inactivity closes it; the
+next job starts it again. Each job uses a fresh browser context, disposed on
+success or failure. Desktop (1440×900) and mobile (390×844) run sequentially.
+Mobile enables touch, mobile viewport behavior, and a mobile Chromium identity
+at device scale 1. It does not claim to emulate Safari or a physical iPhone.
+
+Managed preview jobs across all rooms share one host slot with the repository
+browser checks and the Design render/freeze helpers, including the browser
+tests in `test:unit`. The unit runner also uses one worker. The slot uses an exclusive loopback listener on port 47683;
+it serves no application protocol and disappears if its owning process exits.
+Waiting jobs time out after two minutes without stealing an active slot.
+Personal Chrome tabs and independently launched browser scripts are outside
+this managed limit.
+
+From the repository, run `npm run test:browser` for sequential Chromium and
+WebKit viewport, touch/click, and session-isolation checks. Use
+`npm run test:browser -- --engine=chromium` on older Macs without supported
+WebKit. `TP_BROWSER_PATH` also selects an installed Chrome for the app tests
+and Design helpers when bundled Chromium cannot run on the host. CI installs
+both pinned Playwright engines and runs the existing landing focus and Lynx
+request-lifecycle app tests under WebKit (`TP_TEST_BROWSER_ENGINE=webkit`).
+Safari-sensitive releases still require a real-device check of login, keyboard/focus, scrolling, and the
+changed interaction; record the device/OS and result separately.
+
 ## Optional bridge environment variables
 
 | Variable | Purpose |