← Commit history

install skill: field notes from the ROG install (splash hwnd, Edge toggle rect, last-window trap, escalating wake)

John Lauer ·5ff5b1f1d8 ·2mo ago ·parent cdbd7eb
1 file changed +21
skills/installing-the-extension/SKILL.md+21
@@ -226,3 +226,24 @@ The end-to-end recipe works; the **folder-picker path-fill** is the part we are (a deterministic helper instead of "remembers the last dir"). Until the Web Store listings clear review, this dev-mode flow is the real install path, so getting it clean is a priority - report any picker flakiness so we can harden the helper.++## Field notes (ConfRoomROG install, 2026-08-23 - the second real run)+- **`nbrowser_open_os_window`'s returned hwnd can be a SPLASH window Chrome replaces.** The verb+  returned hwnd A; by the time the page loaded, the real window was hwnd B and A was gone (navigate on+  A times out, screenshots of A show a black shell). Before driving, re-find the real window via+  `desktop_list_windows` (match `Chrome_WidgetWin_1` + the page title) instead of trusting the+  returned hwnd blindly.+- **Edge's Developer-mode UIA rect covers ONLY the label text, not the toggle.** `desktop_find_control+  {contains:"Developer mode"}` returned a rect ending ~230 physical px LEFT of the actual knob - a+  click at rect.centerX hits dead space and silently does nothing. Compute the knob's position from a+  screenshot instead: knob-x-in-image * (windowRect.width / imageWidth) + windowRect.left. Verify the+  flip by screenshot, never by the click's ok:true.+- **Edge's Select Folder DID respond to `desktop_ui_click {contains:"Select Folder"}` this run** (the+  2026-07-03 failure was not reproduced). Keep the SendInput fallback, but try UIA first and judge by+  the #32770 count as always.+- **Do not close your driver window if it is the profile's LAST window** - the browser exits, the+  service worker dies, and the profile goes back to sleep (this cascaded a 30-test battery failure).+  Close it only after other windows exist, or accept the sleep and wake later.+- **`wake_profile` now self-heals this (bridge >= 0.4.12):** a windowless wake that does not connect+  escalates to ONE minimized background window (Chromium never starts a load-unpacked extension's SW+  without a real window - measured on ROG Chrome and laptop Edge). Leave that window open while driving.