verifylisted

# Verifying agent-term changes in the real app Build first (`npm run build`), then launch the shipped app via Playwright's Electron driver. Pattern lives in `test/e2e/freeze-focus.mjs`; a fuller md-viewer drive (click → edit → commit → send, screenshot per stage) was session-scratch — copy the recipe below. ## Launch ```js import { _electron as electron } from '<abs-path>/node_modules/playwright-core/index.mjs'; const app = await electron.launch({ executablePath: '<abs-path>/node_modules/electron/dist/Electron.app/Contents/MacOS/Electron', args: ['--no-sandbox', '<abs-path-to-repo>'], }); const page = await app.firstWindow(); await page.waitForSelector('.xterm-helper-textarea', { timeout: 30_000 }); ``` Import playwright-core by absolute path — scripts outside the repo can't resolve it by name. Resize via `app.evaluate(({BrowserWindow}) => ... setSize(1750, 980))` only AFTER the terminal selector appears (earlier, the window is still navigating and evaluate throws). ## Gotchas that cost time - **Session picker opens on launch.** Press Escape once ("esc skip") before typing, or keys land in the picker, not the shell. - **Open an md doc via the terminal harvest**: `echo <bare-path>.md` then `webContents.send('open-recent-viewer-url')`. Bare path, NOT a file:// URL — `file://` classifies as a web entry and opens the web viewer (`viewer-history.js` `extractViewerCandidateMatches`). Long paths must not line-wrap (hence the wide window) or the harvest misses the