ugly-app 0.1.874 → 0.1.875

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.874";
+export declare const CLI_VERSION = "0.1.875";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.874";
+export const CLI_VERSION = "0.1.875";
 //# sourceMappingURL=version.js.map

package/dist/client/components/DeviceSimulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeviceSimulator.d.ts","sourceRoot":"","sources":["../../../src/client/components/DeviceSimulator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAwDhF,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,SAAS,CA0KlB"}
+{"version":3,"file":"DeviceSimulator.d.ts","sourceRoot":"","sources":["../../../src/client/components/DeviceSimulator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AA6ChF,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,SAAS,CA0KlB"}

package/dist/client/components/DeviceSimulator.js

@@ -1,17 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from 'react';
-const SIMULATOR_PROFILES = {
-    ios: {
-        safeArea: { top: 59, right: 0, bottom: 34, left: 0 },
-        keyboardHeight: 320,
-        viewport: { width: 390, height: 844 },
-    },
-    android: {
-        safeArea: { top: 25, right: 0, bottom: 48, left: 0 },
-        keyboardHeight: 300,
-        viewport: { width: 360, height: 780 },
-    },
-};
+import { SIMULATOR_PROFILES, } from '../deviceProfiles.js';
 function isKeyboardInput(el) {
     if (!el)
         return false;

package/dist/client/components/DeviceSimulator.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeviceSimulator.js","sourceRoot":"","sources":["../../../src/client/components/DeviceSimulator.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DeviceSimulator.js","sourceRoot":"","sources":["../../../src/client/components/DeviceSimulator.tsx"],"names":[],"mappings":"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"}

package/dist/client/deviceProfiles.d.ts

@@ -0,0 +1,47 @@
+export interface DeviceProfile {
+    safeArea: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    keyboardHeight: number;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    /** CSS device-pixel-ratio to emulate (physical density). */
+    deviceScaleFactor: number;
+}
+export declare const SIMULATOR_PROFILES: {
+    readonly ios: {
+        readonly safeArea: {
+            readonly top: 59;
+            readonly right: 0;
+            readonly bottom: 34;
+            readonly left: 0;
+        };
+        readonly keyboardHeight: 320;
+        readonly viewport: {
+            readonly width: 390;
+            readonly height: 844;
+        };
+        readonly deviceScaleFactor: 3;
+    };
+    readonly android: {
+        readonly safeArea: {
+            readonly top: 25;
+            readonly right: 0;
+            readonly bottom: 48;
+            readonly left: 0;
+        };
+        readonly keyboardHeight: 300;
+        readonly viewport: {
+            readonly width: 360;
+            readonly height: 780;
+        };
+        readonly deviceScaleFactor: 3;
+    };
+};
+export type SimulatorPlatform = keyof typeof SIMULATOR_PROFILES;
+//# sourceMappingURL=deviceProfiles.d.ts.map

package/dist/client/deviceProfiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceProfiles.d.ts","sourceRoot":"","sources":["../../src/client/deviceProfiles.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAamB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/client/deviceProfiles.js

@@ -0,0 +1,22 @@
+// Shared device-emulation profiles for the mobile simulator + the Playwright test
+// harness. One source of truth so the in-app `DeviceSimulator` component and the
+// `ugly-app/playwright` `createMobileBotPage` helper agree on the exact safe-area
+// insets, keyboard height, and viewport size for each platform.
+//
+// The keyboard height and the bottom device inset are combined with `max()`, never
+// added — see KeyboardProvider.
+export const SIMULATOR_PROFILES = {
+    ios: {
+        safeArea: { top: 59, right: 0, bottom: 34, left: 0 },
+        keyboardHeight: 320,
+        viewport: { width: 390, height: 844 },
+        deviceScaleFactor: 3,
+    },
+    android: {
+        safeArea: { top: 25, right: 0, bottom: 48, left: 0 },
+        keyboardHeight: 300,
+        viewport: { width: 360, height: 780 },
+        deviceScaleFactor: 3,
+    },
+};
+//# sourceMappingURL=deviceProfiles.js.map

package/dist/client/deviceProfiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceProfiles.js","sourceRoot":"","sources":["../../src/client/deviceProfiles.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,iFAAiF;AACjF,kFAAkF;AAClF,gEAAgE;AAChE,EAAE;AACF,mFAAmF;AACnF,gCAAgC;AAUhC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE;QACH,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;QACpD,cAAc,EAAE,GAAG;QACnB,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACrC,iBAAiB,EAAE,CAAC;KACrB;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;QACpD,cAAc,EAAE,GAAG;QACnB,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACrC,iBAAiB,EAAE,CAAC;KACrB;CAC+C,CAAC"}

package/dist/client/inspect/keyboard.js

@@ -12,12 +12,36 @@ export function installKeyboard(state) {
     };
 }
 function currentKeyboardState() {
-    if (typeof window === 'undefined' || !window.visualViewport) {
+    if (typeof window === 'undefined') {
         return { height: 0, isOpen: false };
     }
-    const diff = window.innerHeight - window.visualViewport.height;
-    const height = diff > 100 ? Math.round(diff) : 0;
-    return { height, isOpen: height > 0 };
+    // Primary source: real visualViewport occlusion (browser / PWA / WKWebView).
+    if (window.visualViewport) {
+        const diff = window.innerHeight - window.visualViewport.height;
+        if (diff > 100) {
+            const height = Math.round(diff);
+            return { height, isOpen: true };
+        }
+    }
+    // Fallback: an explicit keyboard height (native shell, ugly-studio preview, or the
+    // Playwright mobile helper) — the simulated keyboard cannot shrink visualViewport,
+    // so read `window.__keyboardHeight` / the `--keyboard-inset-height` CSS var instead.
+    const explicit = explicitKeyboardHeight();
+    return { height: explicit, isOpen: explicit > 0 };
+}
+function explicitKeyboardHeight() {
+    const fromWindow = window
+        .__keyboardHeight;
+    if (typeof fromWindow === 'number' && fromWindow > 0) {
+        return Math.round(fromWindow);
+    }
+    if (typeof document === 'undefined')
+        return 0;
+    const raw = window
+        .getComputedStyle(document.documentElement)
+        .getPropertyValue('--keyboard-inset-height');
+    const parsed = parseInt(raw || '0', 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
 }
 function scanCoveredInputs(kb, state) {
     if (!kb.isOpen)

package/dist/client/inspect/keyboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../../src/client/inspect/keyboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../../src/client/inspect/keyboard.ts"],"names":[],"mappings":"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"}

package/dist/playwright/index.d.ts

@@ -42,4 +42,6 @@ export { installRealNative, makePathResolver } from './real-native.js';
 export type { RealNativeOptions } from './real-native.js';
 export { loadDevAuth, authenticateReal } from './dev-auth.js';
 export type { DevAuth } from './dev-auth.js';
+export { createMobileBotPage, installMobileFrame, raiseKeyboard, dismissKeyboard, } from './mobile.js';
+export type { MobileBotOptions, SimulatorPlatform } from './mobile.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/playwright/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAIpC;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf;AAOD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7D;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC7B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GACpC,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAIpC;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAIf;AAOD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7D;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC7B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GACpC,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/playwright/index.js

@@ -67,6 +67,10 @@ export async function setDevice(page, device) {
 }
 export async function simulateKeyboard(page, heightPx) {
     await page.evaluate((h) => {
+        // Set the explicit signal the layout AND the scanCoveredInputs inspector read
+        // (the simulated keyboard can't shrink visualViewport), then dispatch the event.
+        window.__keyboardHeight = h;
+        document.documentElement.style.setProperty('--keyboard-inset-height', `${h}px`);
         window.dispatchEvent(new CustomEvent('keyboard-height', { detail: { height: h } }));
     }, heightPx);
 }
@@ -115,4 +119,5 @@ export async function expectClean(page, opts) {
 export { installUglyNativeMock } from './native-mock.js';
 export { installRealNative, makePathResolver } from './real-native.js';
 export { loadDevAuth, authenticateReal } from './dev-auth.js';
+export { createMobileBotPage, installMobileFrame, raiseKeyboard, dismissKeyboard, } from './mobile.js';
 //# sourceMappingURL=index.js.map

package/dist/playwright/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"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"}

package/dist/playwright/mobile.d.ts

@@ -0,0 +1,45 @@
+import type { Browser, BrowserContext, Page } from '@playwright/test';
+import { type SimulatorPlatform } from '../client/deviceProfiles.js';
+export type { SimulatorPlatform } from '../client/deviceProfiles.js';
+export interface MobileBotOptions {
+    /** Cookie domain the auth token is scoped to. Default 'localhost' (local dev). */
+    domain?: string;
+}
+/**
+ * Apply mobile device emulation (viewport, touch, safe-area injection) to a
+ * pre-existing context — useful when you already created the context yourself.
+ */
+export declare function installMobileFrame(context: BrowserContext, platform: SimulatorPlatform): Promise<void>;
+/**
+ * Create a page emulating a phone (iOS/Android) with a realistic top/bottom
+ * safe-area and on-screen keyboard, pre-authenticated with the given token.
+ *
+ * The layout responds via the globally-mounted `KeyboardProvider`, and the
+ * `scanSafeArea` / `scanCoveredInputs` inspectors (behind `expectClean`) see the
+ * simulated insets/keyboard. Navigate with `?debugSafeArea=true` to also render the
+ * visible top/bottom/keyboard bands for a screenshot vision pass. Works against any
+ * ugly-app child app, local or prod, with no per-app wiring.
+ *
+ * @example
+ * const page = await createMobileBotPage(browser, token, 'ios')
+ * await page.goto(`${BASE_URL}/?debugSafeArea=true`)
+ * await waitForApp(page)
+ * await page.locator('textarea').first().focus()
+ * await raiseKeyboard(page, 'ios')
+ * await expectClean(page, { allowSafeAreaViolations: false, allowKeyboardCoverage: false })
+ */
+export declare function createMobileBotPage(browser: Browser, token: string, platform: SimulatorPlatform, opts?: MobileBotOptions): Promise<Page>;
+/**
+ * Raise the simulated on-screen keyboard. Sets `--keyboard-inset-height` +
+ * `window.__keyboardHeight` AND dispatches the `keyboard-height` CustomEvent, so
+ * both the layout (`KeyboardProvider`) and the `scanCoveredInputs` inspector agree.
+ * We drive this explicitly rather than relying on `visualViewport` shrinking, which
+ * is not possible from Playwright.
+ *
+ * @param platformOrHeight a platform ('ios'/'android') to use its profile height,
+ *   or an explicit pixel height.
+ */
+export declare function raiseKeyboard(page: Page, platformOrHeight?: SimulatorPlatform | number): Promise<void>;
+/** Dismiss the simulated keyboard (height 0). */
+export declare function dismissKeyboard(page: Page): Promise<void>;
+//# sourceMappingURL=mobile.d.ts.map

package/dist/playwright/mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.d.ts","sourceRoot":"","sources":["../../src/playwright/mobile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwCD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,gBAAgB,GAAE,iBAAiB,GAAG,MAAc,GACnD,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,iDAAiD;AACjD,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D"}

package/dist/playwright/mobile.js

@@ -0,0 +1,114 @@
+import { SIMULATOR_PROFILES, } from '../client/deviceProfiles.js';
+const COOKIE_NAME = 'auth_token';
+/**
+ * Build the init script that injects a realistic device safe-area into the page
+ * BEFORE app JS runs, mirroring `uglyStudioPreviewBridge` / the native shell:
+ *   - `window.__safeAreaInsets` — KeyboardProvider seeds its "native override" from
+ *     this on mount (authoritative path), so `useSafeAreaInsets()` pads correctly.
+ *   - `--safe-area-inset-*` CSS vars on `:root` — so raw `.safe-area` consumers AND
+ *     the `scanSafeArea` inspector (which reads these) see the insets.
+ *   - `--keyboard-inset-height: 0px` — initial keyboard-closed state.
+ * A `keyboard-height` of 0 is dispatched last so any already-mounted listener resets.
+ */
+function safeAreaInitScript(platform) {
+    const { safeArea } = SIMULATOR_PROFILES[platform];
+    const insets = JSON.stringify(safeArea);
+    return `(() => {
+    const insets = ${insets};
+    try { window.__safeAreaInsets = insets; } catch {}
+    const apply = () => {
+      const root = document.documentElement;
+      if (!root) return;
+      root.style.setProperty('--safe-area-inset-top', insets.top + 'px');
+      root.style.setProperty('--safe-area-inset-right', insets.right + 'px');
+      root.style.setProperty('--safe-area-inset-bottom', insets.bottom + 'px');
+      root.style.setProperty('--safe-area-inset-left', insets.left + 'px');
+      root.style.setProperty('--keyboard-inset-height', '0px');
+    };
+    apply();
+    if (document.readyState === 'loading') {
+      document.addEventListener('DOMContentLoaded', apply, { once: true });
+    }
+    window.addEventListener('load', () => {
+      apply();
+      window.dispatchEvent(new CustomEvent('safe-area-insets', { detail: insets }));
+      window.dispatchEvent(new CustomEvent('keyboard-height', { detail: { height: 0 } }));
+      window.dispatchEvent(new CustomEvent('loaded', { detail: '' }));
+    }, { once: true });
+  })();`;
+}
+/**
+ * Apply mobile device emulation (viewport, touch, safe-area injection) to a
+ * pre-existing context — useful when you already created the context yourself.
+ */
+export async function installMobileFrame(context, platform) {
+    await context.addInitScript(safeAreaInitScript(platform));
+}
+/**
+ * Create a page emulating a phone (iOS/Android) with a realistic top/bottom
+ * safe-area and on-screen keyboard, pre-authenticated with the given token.
+ *
+ * The layout responds via the globally-mounted `KeyboardProvider`, and the
+ * `scanSafeArea` / `scanCoveredInputs` inspectors (behind `expectClean`) see the
+ * simulated insets/keyboard. Navigate with `?debugSafeArea=true` to also render the
+ * visible top/bottom/keyboard bands for a screenshot vision pass. Works against any
+ * ugly-app child app, local or prod, with no per-app wiring.
+ *
+ * @example
+ * const page = await createMobileBotPage(browser, token, 'ios')
+ * await page.goto(`${BASE_URL}/?debugSafeArea=true`)
+ * await waitForApp(page)
+ * await page.locator('textarea').first().focus()
+ * await raiseKeyboard(page, 'ios')
+ * await expectClean(page, { allowSafeAreaViolations: false, allowKeyboardCoverage: false })
+ */
+export async function createMobileBotPage(browser, token, platform, opts) {
+    const profile = SIMULATOR_PROFILES[platform];
+    const context = await browser.newContext({
+        viewport: { ...profile.viewport },
+        deviceScaleFactor: profile.deviceScaleFactor,
+        isMobile: true,
+        hasTouch: true,
+    });
+    await context.addCookies([
+        {
+            name: COOKIE_NAME,
+            value: token,
+            domain: opts?.domain ?? 'localhost',
+            path: '/',
+            httpOnly: true,
+            secure: false,
+            sameSite: 'Lax',
+        },
+    ]);
+    await installMobileFrame(context, platform);
+    return await context.newPage();
+}
+/**
+ * Raise the simulated on-screen keyboard. Sets `--keyboard-inset-height` +
+ * `window.__keyboardHeight` AND dispatches the `keyboard-height` CustomEvent, so
+ * both the layout (`KeyboardProvider`) and the `scanCoveredInputs` inspector agree.
+ * We drive this explicitly rather than relying on `visualViewport` shrinking, which
+ * is not possible from Playwright.
+ *
+ * @param platformOrHeight a platform ('ios'/'android') to use its profile height,
+ *   or an explicit pixel height.
+ */
+export async function raiseKeyboard(page, platformOrHeight = 'ios') {
+    const height = typeof platformOrHeight === 'number'
+        ? platformOrHeight
+        : SIMULATOR_PROFILES[platformOrHeight].keyboardHeight;
+    await setKeyboardHeight(page, height);
+}
+/** Dismiss the simulated keyboard (height 0). */
+export async function dismissKeyboard(page) {
+    await setKeyboardHeight(page, 0);
+}
+async function setKeyboardHeight(page, height) {
+    await page.evaluate((h) => {
+        window.__keyboardHeight = h;
+        document.documentElement.style.setProperty('--keyboard-inset-height', `${h}px`);
+        window.dispatchEvent(new CustomEvent('keyboard-height', { detail: { height: h } }));
+    }, height);
+}
+//# sourceMappingURL=mobile.js.map

package/dist/playwright/mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.js","sourceRoot":"","sources":["../../src/playwright/mobile.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,GAEnB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,WAAW,GAAG,YAAY,CAAC;AAOjC;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,QAA2B;IACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO;qBACY,MAAM;;;;;;;;;;;;;;;;;;;;;QAqBnB,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAuB,EACvB,QAA2B;IAE3B,MAAM,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAgB,EAChB,KAAa,EACb,QAA2B,EAC3B,IAAuB;IAEvB,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QACvC,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE;QACjC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,UAAU,CAAC;QACvB;YACE,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,WAAW;YACnC,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC,CAAC;IACH,MAAM,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAU,EACV,mBAA+C,KAAK;IAEpD,MAAM,MAAM,GACV,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,cAAc,CAAC;IAC1D,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,MAAM,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,MAAc;IACzD,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAS,EAAE,EAAE;QAC/B,MAAmD,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1E,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,CACxC,yBAAyB,EACzB,GAAG,CAAC,IAAI,CACT,CAAC;QACF,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAC9D,CAAC;IACJ,CAAC,EAAE,MAAM,CAAC,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-app",
-  "version": "0.1.874",
+  "version": "0.1.875",
   "type": "module",
   "comment:files": "Allowlist what ships to npm. dist = runtime; src = sourcemap targets (dist/*.js.map reference ../../src/); templates = CLI scaffold. Everything else at repo root (.pgdata local Postgres, coverage, assets/icons sources, test/, test-results/) is excluded by omission. The !negations strip the scaffold's installed deps + cruft (templates/node_modules is 200MB+ and must never ship). package.json/README/LICENSE ship automatically.",
   "files": [

package/src/cli/version.ts

@@ -1,2 +1,2 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.874";
+export const CLI_VERSION = "0.1.875";

package/src/client/components/DeviceSimulator.tsx

@@ -1,19 +1,8 @@
 import { type CSSProperties, type ReactNode, useEffect, useState } from 'react';
-
-const SIMULATOR_PROFILES = {
-  ios: {
-    safeArea: { top: 59, right: 0, bottom: 34, left: 0 },
-    keyboardHeight: 320,
-    viewport: { width: 390, height: 844 },
-  },
-  android: {
-    safeArea: { top: 25, right: 0, bottom: 48, left: 0 },
-    keyboardHeight: 300,
-    viewport: { width: 360, height: 780 },
-  },
-} as const;
-
-type SimulatorPlatform = keyof typeof SIMULATOR_PROFILES;
+import {
+  SIMULATOR_PROFILES,
+  type SimulatorPlatform,
+} from '../deviceProfiles.js';
 
 function isKeyboardInput(el: Element | null): boolean {
   if (!el) return false;

package/src/client/deviceProfiles.ts

@@ -0,0 +1,32 @@
+// Shared device-emulation profiles for the mobile simulator + the Playwright test
+// harness. One source of truth so the in-app `DeviceSimulator` component and the
+// `ugly-app/playwright` `createMobileBotPage` helper agree on the exact safe-area
+// insets, keyboard height, and viewport size for each platform.
+//
+// The keyboard height and the bottom device inset are combined with `max()`, never
+// added — see KeyboardProvider.
+
+export interface DeviceProfile {
+  safeArea: { top: number; right: number; bottom: number; left: number };
+  keyboardHeight: number;
+  viewport: { width: number; height: number };
+  /** CSS device-pixel-ratio to emulate (physical density). */
+  deviceScaleFactor: number;
+}
+
+export const SIMULATOR_PROFILES = {
+  ios: {
+    safeArea: { top: 59, right: 0, bottom: 34, left: 0 },
+    keyboardHeight: 320,
+    viewport: { width: 390, height: 844 },
+    deviceScaleFactor: 3,
+  },
+  android: {
+    safeArea: { top: 25, right: 0, bottom: 48, left: 0 },
+    keyboardHeight: 300,
+    viewport: { width: 360, height: 780 },
+    deviceScaleFactor: 3,
+  },
+} as const satisfies Record<string, DeviceProfile>;
+
+export type SimulatorPlatform = keyof typeof SIMULATOR_PROFILES;

package/src/client/inspect/keyboard.ts

@@ -20,12 +20,36 @@ export function installKeyboard(state: InspectState): void {
 }
 
 function currentKeyboardState(): KeyboardState {
-  if (typeof window === 'undefined' || !window.visualViewport) {
+  if (typeof window === 'undefined') {
     return { height: 0, isOpen: false };
   }
-  const diff = window.innerHeight - window.visualViewport.height;
-  const height = diff > 100 ? Math.round(diff) : 0;
-  return { height, isOpen: height > 0 };
+  // Primary source: real visualViewport occlusion (browser / PWA / WKWebView).
+  if (window.visualViewport) {
+    const diff = window.innerHeight - window.visualViewport.height;
+    if (diff > 100) {
+      const height = Math.round(diff);
+      return { height, isOpen: true };
+    }
+  }
+  // Fallback: an explicit keyboard height (native shell, ugly-studio preview, or the
+  // Playwright mobile helper) — the simulated keyboard cannot shrink visualViewport,
+  // so read `window.__keyboardHeight` / the `--keyboard-inset-height` CSS var instead.
+  const explicit = explicitKeyboardHeight();
+  return { height: explicit, isOpen: explicit > 0 };
+}
+
+function explicitKeyboardHeight(): number {
+  const fromWindow = (window as unknown as { __keyboardHeight?: number })
+    .__keyboardHeight;
+  if (typeof fromWindow === 'number' && fromWindow > 0) {
+    return Math.round(fromWindow);
+  }
+  if (typeof document === 'undefined') return 0;
+  const raw = window
+    .getComputedStyle(document.documentElement)
+    .getPropertyValue('--keyboard-inset-height');
+  const parsed = parseInt(raw || '0', 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
 }
 
 function scanCoveredInputs(

package/src/playwright/index.ts

@@ -124,6 +124,13 @@ export async function simulateKeyboard(
   heightPx: number,
 ): Promise<void> {
   await page.evaluate((h: number) => {
+    // Set the explicit signal the layout AND the scanCoveredInputs inspector read
+    // (the simulated keyboard can't shrink visualViewport), then dispatch the event.
+    (window as unknown as { __keyboardHeight?: number }).__keyboardHeight = h;
+    document.documentElement.style.setProperty(
+      '--keyboard-inset-height',
+      `${h}px`,
+    );
     window.dispatchEvent(
       new CustomEvent('keyboard-height', { detail: { height: h } }),
     );
@@ -209,3 +216,10 @@ export { installRealNative, makePathResolver } from './real-native.js';
 export type { RealNativeOptions } from './real-native.js';
 export { loadDevAuth, authenticateReal } from './dev-auth.js';
 export type { DevAuth } from './dev-auth.js';
+export {
+  createMobileBotPage,
+  installMobileFrame,
+  raiseKeyboard,
+  dismissKeyboard,
+} from './mobile.js';
+export type { MobileBotOptions, SimulatorPlatform } from './mobile.js';

package/src/playwright/mobile.ts

@@ -0,0 +1,148 @@
+import type { Browser, BrowserContext, Page } from '@playwright/test';
+import {
+  SIMULATOR_PROFILES,
+  type SimulatorPlatform,
+} from '../client/deviceProfiles.js';
+
+export type { SimulatorPlatform } from '../client/deviceProfiles.js';
+
+const COOKIE_NAME = 'auth_token';
+
+export interface MobileBotOptions {
+  /** Cookie domain the auth token is scoped to. Default 'localhost' (local dev). */
+  domain?: string;
+}
+
+/**
+ * Build the init script that injects a realistic device safe-area into the page
+ * BEFORE app JS runs, mirroring `uglyStudioPreviewBridge` / the native shell:
+ *   - `window.__safeAreaInsets` — KeyboardProvider seeds its "native override" from
+ *     this on mount (authoritative path), so `useSafeAreaInsets()` pads correctly.
+ *   - `--safe-area-inset-*` CSS vars on `:root` — so raw `.safe-area` consumers AND
+ *     the `scanSafeArea` inspector (which reads these) see the insets.
+ *   - `--keyboard-inset-height: 0px` — initial keyboard-closed state.
+ * A `keyboard-height` of 0 is dispatched last so any already-mounted listener resets.
+ */
+function safeAreaInitScript(platform: SimulatorPlatform): string {
+  const { safeArea } = SIMULATOR_PROFILES[platform];
+  const insets = JSON.stringify(safeArea);
+  return `(() => {
+    const insets = ${insets};
+    try { window.__safeAreaInsets = insets; } catch {}
+    const apply = () => {
+      const root = document.documentElement;
+      if (!root) return;
+      root.style.setProperty('--safe-area-inset-top', insets.top + 'px');
+      root.style.setProperty('--safe-area-inset-right', insets.right + 'px');
+      root.style.setProperty('--safe-area-inset-bottom', insets.bottom + 'px');
+      root.style.setProperty('--safe-area-inset-left', insets.left + 'px');
+      root.style.setProperty('--keyboard-inset-height', '0px');
+    };
+    apply();
+    if (document.readyState === 'loading') {
+      document.addEventListener('DOMContentLoaded', apply, { once: true });
+    }
+    window.addEventListener('load', () => {
+      apply();
+      window.dispatchEvent(new CustomEvent('safe-area-insets', { detail: insets }));
+      window.dispatchEvent(new CustomEvent('keyboard-height', { detail: { height: 0 } }));
+      window.dispatchEvent(new CustomEvent('loaded', { detail: '' }));
+    }, { once: true });
+  })();`;
+}
+
+/**
+ * Apply mobile device emulation (viewport, touch, safe-area injection) to a
+ * pre-existing context — useful when you already created the context yourself.
+ */
+export async function installMobileFrame(
+  context: BrowserContext,
+  platform: SimulatorPlatform,
+): Promise<void> {
+  await context.addInitScript(safeAreaInitScript(platform));
+}
+
+/**
+ * Create a page emulating a phone (iOS/Android) with a realistic top/bottom
+ * safe-area and on-screen keyboard, pre-authenticated with the given token.
+ *
+ * The layout responds via the globally-mounted `KeyboardProvider`, and the
+ * `scanSafeArea` / `scanCoveredInputs` inspectors (behind `expectClean`) see the
+ * simulated insets/keyboard. Navigate with `?debugSafeArea=true` to also render the
+ * visible top/bottom/keyboard bands for a screenshot vision pass. Works against any
+ * ugly-app child app, local or prod, with no per-app wiring.
+ *
+ * @example
+ * const page = await createMobileBotPage(browser, token, 'ios')
+ * await page.goto(`${BASE_URL}/?debugSafeArea=true`)
+ * await waitForApp(page)
+ * await page.locator('textarea').first().focus()
+ * await raiseKeyboard(page, 'ios')
+ * await expectClean(page, { allowSafeAreaViolations: false, allowKeyboardCoverage: false })
+ */
+export async function createMobileBotPage(
+  browser: Browser,
+  token: string,
+  platform: SimulatorPlatform,
+  opts?: MobileBotOptions,
+): Promise<Page> {
+  const profile = SIMULATOR_PROFILES[platform];
+  const context = await browser.newContext({
+    viewport: { ...profile.viewport },
+    deviceScaleFactor: profile.deviceScaleFactor,
+    isMobile: true,
+    hasTouch: true,
+  });
+  await context.addCookies([
+    {
+      name: COOKIE_NAME,
+      value: token,
+      domain: opts?.domain ?? 'localhost',
+      path: '/',
+      httpOnly: true,
+      secure: false,
+      sameSite: 'Lax',
+    },
+  ]);
+  await installMobileFrame(context, platform);
+  return await context.newPage();
+}
+
+/**
+ * Raise the simulated on-screen keyboard. Sets `--keyboard-inset-height` +
+ * `window.__keyboardHeight` AND dispatches the `keyboard-height` CustomEvent, so
+ * both the layout (`KeyboardProvider`) and the `scanCoveredInputs` inspector agree.
+ * We drive this explicitly rather than relying on `visualViewport` shrinking, which
+ * is not possible from Playwright.
+ *
+ * @param platformOrHeight a platform ('ios'/'android') to use its profile height,
+ *   or an explicit pixel height.
+ */
+export async function raiseKeyboard(
+  page: Page,
+  platformOrHeight: SimulatorPlatform | number = 'ios',
+): Promise<void> {
+  const height =
+    typeof platformOrHeight === 'number'
+      ? platformOrHeight
+      : SIMULATOR_PROFILES[platformOrHeight].keyboardHeight;
+  await setKeyboardHeight(page, height);
+}
+
+/** Dismiss the simulated keyboard (height 0). */
+export async function dismissKeyboard(page: Page): Promise<void> {
+  await setKeyboardHeight(page, 0);
+}
+
+async function setKeyboardHeight(page: Page, height: number): Promise<void> {
+  await page.evaluate((h: number) => {
+    (window as unknown as { __keyboardHeight?: number }).__keyboardHeight = h;
+    document.documentElement.style.setProperty(
+      '--keyboard-inset-height',
+      `${h}px`,
+    );
+    window.dispatchEvent(
+      new CustomEvent('keyboard-height', { detail: { height: h } }),
+    );
+  }, height);
+}

package/templates/.claude/skills/eval-swarm/SKILL.md

@@ -35,6 +35,14 @@ the real feature, on real data, and *see* the result with its own eyes produces
 imagination — dead weight that pollutes the signal. Every guardrail below exists to keep
 each finding anchored to something the persona actually did and saw.
 
+**Corollary — grade the OUTCOME, never the UI's self-report.** A green check, a "done"
+status, and a completed turn are claims by the thing under test; they are not evidence.
+Assert ground truth outside the app: read the file on disk, query the row, diff the repo.
+An app that politely tells you it did nothing still renders as success — that exact hole
+let five ugly-code rounds score a coding agent that could not search (see Step 0.6). When
+a persona's goal implies a durable change, the verdict must be checked against that
+change, not against the transcript describing it.
+
 ---
 
 ## Billing
@@ -87,6 +95,21 @@ fake findings, which is worse than no findings.
    with any cost-control env var prepended (see Billing), NOT `--watch` (the swarm reads a
    stable build). Then poll `$(npx ugly-app url)` until it answers.
 
+6. **Does the app's machinery actually WORK, or just not crash?** A broken environment
+   usually announces itself; a **silently degraded** one does not, and that is the
+   dangerous case — the run completes, every check is green, and the rating is fiction.
+   Before dispatching, prove each capability the personas will exercise is *live*, not
+   merely present: run the smallest real operation and look at its output.
+   - **Real precedent:** ugly-code evals ran five rounds and earned ★★★★★ while the coding
+     agent's `glob`/`grep` were **dead** — `rg` was missing from the task child's PATH, the
+     failed spawn rendered as a green "no matches" card, and the agent concluded each
+     project was empty. Nothing errored. The harness now refuses to start when a required
+     binary is unresolvable (`assertAgentToolchain`) — **prefer a preflight that makes the
+     harness refuse over one that warns.**
+   - Generalize it: if the app shells out to a binary, resolve it; if it depends on an
+     index/model/migration, query it for a known-present row. "It returned successfully"
+     is not evidence — "it returned the thing I planted" is.
+
 Store `BASE_URL="$(npx ugly-app url)"` for the run. Everything the swarm reads and writes
 lives on **this local server** — the framework read CLIs (`ugly-app feedback`, `errors`,
 `logs`) query **prod**, not local, so don't use them to inspect the run.
@@ -130,9 +153,33 @@ Do not use a stock roster. Open the app and design personas around what it actua
    - **consume-persona** — it needs *existing* data to work on (a reader needs a
      manuscript; a coach-user needs a draft). Requires seed — see Step 2.
 
+4. **Always include a first-run newcomer.** One persona must arrive COLD — has never used
+   the app — and judge the ONBOARDING itself: landing → creating / opening the first project
+   → writing the **first prompt** → seeing the first result. This cold-start is the
+   make-or-break moment for adoption (a powerful tool that's confusing to *start* loses users
+   at the door) and it's the single thing builders are most blind to. Have them narrate every
+   hesitation out loud — "what do I click?", "what do I type here?", "wait, did that even
+   work?" — and screenshot each dead-end.
+
+Vary **UX tolerance** as a real axis, not just goals: an impatient newcomer who bails at the
+first confusion surfaces different problems than a patient power user who pushes through
+friction. The gap between their verdicts IS your ease-of-use signal — design at least two
+personas whose *patience* differs, not just their task.
+
+5. **Pick each persona's `device`: `desktop` | `ios` | `android`.** These apps ship to
+   phones, where a whole class of bugs lives that a desktop viewport never shows — content
+   bleeding under the notch/status bar, a docked composer or CTA hidden under the
+   home-indicator, an input covered by the on-screen keyboard. A desktop-only swarm is
+   **blind** to all of it. So give **at least two personas a mobile device** — the cold-start
+   newcomer especially (first-run pain is worst on a phone), plus one persona whose goal leans
+   on a text input / composer (the keyboard-overlap case). Mobile costs the same AI spend as
+   desktop; it only changes the viewport and screenshots. A mobile persona runs the **Mobile
+   safe-area + keyboard pass** in its contract (Step 3).
+
 Write each persona as a short brief you will hand to its subagent: who they are, their
 goal for this session, the exact features they should exercise, and what would make them
-say "this tool works" vs. "this is broken."
+say "this tool works" vs. "this is broken" — AND what would make them say "this felt
+effortless" vs. "I nearly gave up."
 
 *(Optional repeatability: an app may ship `bots/eval-swarm.json` — `{ personas, seed,
 model }`. If present, use it instead of inventing. See Config.)*
@@ -171,12 +218,22 @@ calls). Never batch-author findings for several personas in one pass — that is
 shortcut that produces imagination instead of usage. Give each subagent this contract:
 
 > You are **<Persona Name>**: <one-line brief>. Your goal this session: <goal>.
-> Base URL: `<BASE_URL>`. Your account token: `<token>`.
+> Base URL: `<BASE_URL>`. Your account token: `<token>`. Your device: `<desktop|ios|android>`.
 >
 > **Authenticate**, then actually use the product to pursue your goal:
-> 1. In headless Chromium (`pnpm exec playwright` / the Playwright MCP if available), set
->    cookie `auth_token=<token>` for `<BASE_URL>`, then `goto` the app and wait for the
->    hydration selector `<WAIT_SEL>` (see Screenshot recipe), never `networkidle`.
+> 1. In headless Chromium (`pnpm exec playwright` / the Playwright MCP if available):
+>    - **`desktop`** → set cookie `auth_token=<token>` for `<BASE_URL>`, then `goto` the app.
+>    - **`ios` / `android`** → drive a real phone frame. In a `.mjs` script inside the app dir
+>      (`import { createMobileBotPage, raiseKeyboard, dismissKeyboard, waitForApp, expectClean }
+>      from 'ugly-app/playwright'`), do
+>      `const page = await createMobileBotPage(browser, '<token>', '<ios|android>')` — it sets a
+>      phone viewport (390×844 iOS / 360×780 Android), touch emulation, and injects the top +
+>      bottom device safe-area so the layout pads for real. `goto` **`<BASE_URL>/?debugSafeArea=true`**
+>      so the red top / blue bottom / green keyboard bands render for your vision pass.
+>    - Either way, wait for the hydration selector `<WAIT_SEL>` (see Screenshot recipe), never
+>      `networkidle`. (If `ugly-app/playwright` lacks `createMobileBotPage`, the app is on an old
+>      `ugly-app` — tell the orchestrator to bump it; do NOT fall back to a desktop viewport and
+>      call it a mobile run.)
 > 2. Drive the real features toward your goal. **Trigger the real AI** — generate, coach,
 >    extract, chat, whatever this app does — and **wait for real responses**. This spends
 >    real (owner-billed) tokens; that is expected. Budget ~10–20 AI interactions.
@@ -185,22 +242,63 @@ shortcut that produces imagination instead of usage. Give each subagent this con
 >    without a logged look at the thing you are critiquing is invalid — discard it.
 > 4. Judge as your persona: did the feature do what you came for? Was the AI output good,
 >    wrong, empty, slow, truncated, off-tone? Was anything broken, confusing, or missing?
+> 5. **Judge the EXPERIENCE, not just the output.** Beyond "did it work": at each step, was it
+>    obvious what to do next? Where did you hesitate, backtrack, misread a control, hunt for a
+>    button, or feel lost? What did the app assume you already knew? What (if anything)
+>    delighted you? Ease-of-use is a first-class finding — a feature that *works* but is
+>    confusing to reach is still a real problem worth ranking (`type: 'design'`). Narrate this
+>    in the user's own voice. **If you are the newcomer, walk the FULL cold start** — first
+>    screen → create/open a project → write the first prompt → first result — and log every
+>    friction point with a screenshot; that onboarding narrative is your most valuable output.
+> 6. **Mobile safe-area + keyboard pass (only if your `device` is `ios`/`android`).** A phone
+>    clips content the desktop layout never does. At each key screen you visit, judge three
+>    states — screenshot and LOOK at each against the debug bands:
+>    - **Top (notch / status bar):** is the header, back button, or top nav clear of the red
+>      top band, or does it hide under it?
+>    - **Bottom (home-indicator):** is a docked composer, send button, tab bar, or primary CTA
+>      clear of the blue bottom band, or clipped by it?
+>    - **Keyboard open:** focus the main text input, then `await raiseKeyboard(page, '<ios|android>')`.
+>      Is the focused input — and its Send/submit button — still visible above the green keyboard
+>      band, or hidden behind it? (`await dismissKeyboard(page)` when done.)
+>    Then get the **hard signal**: `await expectClean(page, { allowSafeAreaViolations: false,
+>    allowKeyboardCoverage: false })`. It throws listing any interactive element crossing a
+>    safe-area edge (`safeAreaViolations`) or covered by the keyboard (`keyboard.coveredInputs`) —
+>    quote those selectors as evidence. File each as `--type design`; a clipped/covered control on
+>    a **core** flow is high-severity (it caps the rating — see rubric), not a nit.
 >
 > **File each real finding** with
 > `npx ugly-app feedback:submit --type <bug|design|feature> --message "<what you did →
 > what you saw → why it's wrong>" --token <token> --url <page>`. Every message must name
-> the concrete thing you did and saw.
+> the concrete thing you did and saw. UX-friction findings are `--type design`.
 >
-> **Return to me** a JSON array of your findings (`{type, severity, feature, message,
-> evidence}`) plus a one-line verdict: does this tool work for you? Return the findings as
-> your final message — they are data for aggregation, not a human report.
+> **Return to me** a JSON object as your final message (data for aggregation, not a human
+> report):
+> `{ findings: [{type, severity, feature, message, evidence}], ease: <1–5, how effortless was
+> it to get what you came for>, firstRun: "<one-paragraph narrative of the onboarding + first-
+> prompt experience, every hesitation named>", friction: ["<a moment you felt lost/confused/
+> slowed>", …], delight: ["<anything that felt genuinely good>", …], verdict: "<does this tool
+> work for you — AND did it feel good to use?>" }`. Findings must include design/UX friction
+> (`type:'design'`), not only functional bugs. If your device is mobile, add
+> `mobile: { device, safeAreaViolations: [...], keyboardCoveredInputs: [...], verdict: "<did the
+> phone layout hold up?>" }` from your Mobile pass.
 
 **Guardrails to state in every dispatch:**
+- **A mobile persona that never checked safe-area or the keyboard did not do its job.** A phone
+  run whose findings are all desktop-shaped (no notch / home-indicator / keyboard-overlap check)
+  wasted the slot — run the Mobile pass and report `expectClean`'s result, even if it's clean.
 - Real AI only. If you find yourself imagining a response instead of waiting for one, stop
   and actually run the feature.
 - Vision before verdict. No finding about a screen you did not look at.
 - Ground every message in "I did X, I saw Y." Vague wishes ("would be nice if…") that
   could have been written without opening the app are noise — cut them.
+- **Green is a claim, not a result.** When your goal implies a durable change (a file
+  edited, a row written, a doc saved), verify it OUTSIDE the app — read the file, query
+  the row — before crediting it. If the app reports success and the change isn't there,
+  that is a **blocker**, and it's the single most valuable finding you can file.
+- **"There's nothing here" is a red flag, not a finding.** If the app claims the data you
+  planted doesn't exist, suspect your environment before believing it (Step 0.6): a
+  silently dead dependency looks exactly like an empty app. Report it as a possible
+  harness failure so the orchestrator can check — don't grade the app on it.
 
 Timeout ~20 min per persona. A persona that fails or times out does not block the others;
 record which succeeded.
@@ -222,10 +320,16 @@ rows. Don't hand off by telling a fixer to "go read the feedback" — it can't.)
    output, then UX friction, then wishes.
 4. Present one ranked list: for each item — feature, severity, how many personas hit it,
    the sharpest one-line evidence, and the persona verdicts (did the tool work?).
-5. **Rate the product 1–5 stars** (see rubric) with a one-line justification. Lead the
+5. **Synthesize the EXPERIENCE, separately from the bug list.** Report the average `ease`
+   score and its spread (a wide gap between the impatient and the patient persona is itself a
+   finding — it means the app only works if you already know it). Give a short **first-run
+   digest**: the friction points every newcomer hit walking new-project → first-prompt →
+   first-result, plus anything that delighted. Onboarding friction rarely files as a "bug" but
+   is the #1 reason a new user leaves — surface it as prominently as the top functional finding.
+6. **Rate the product 1–5 stars** (see rubric) with a one-line justification. Lead the
    presentation with the rating — it is the headline the user wants; the ranked list is the
    evidence behind it.
-6. Hand off the ranked list **as content** for fixing — either fix the items directly in
+7. Hand off the ranked list **as content** for fixing — either fix the items directly in
    this session, or paste the list into a `/fix-feedback`-style pass (using its ambition
    policy), since the fixer cannot pull these local rows itself.
 
@@ -262,8 +366,10 @@ moved. That's how a product climbs from ★★★ to ★★★★★.
 ### Rating rubric (1–5 stars)
 
 Rate the product as a whole, computed from the **worst core-feature outcome**, **how many
-personas completed their primary goal**, and the **persona verdicts**. A broken feature
-caps the score — polish can't buy back a blocker.
+personas completed their primary goal**, the **persona verdicts**, and the **ease-of-use /
+first-run experience** (the `ease` scores + onboarding friction). A broken feature caps the
+score — polish can't buy back a blocker; and a feature that works but that a newcomer can't
+figure out how to *reach* is a real defect, not a nit.
 
 | Stars | Meaning | Gate |
 |-------|---------|------|
@@ -273,10 +379,31 @@ caps the score — polish can't buy back a blocker.
 | ★★★★☆ **4 — Solid** | All core jobs work; findings are UX polish, edge cases, or wishes. | All personas completed their goal; no blocker/high on a core path. |
 | ★★★★★ **5 — Excellent** | Every persona completed their goal; outputs accurate and trustworthy; only cosmetic nits. | Every verdict "works"; no finding above `low`. |
 
+**Validity gate — publish no rating you can't vouch for the environment of.** Stars are a
+claim about the product; they're only true if the product was the thing being measured.
+Before you report a number, confirm Step 0.6 passed and that at least one persona's durable
+change was verified outside the app. If a capability was silently dead, the round measured
+your harness — say so and re-run; do NOT publish the score with a caveat. A wrong ★★★★★ is
+more damaging than no rating, because it ends the investigation.
+
 Caps are hard: one blocker on a primary feature means **≤2 stars no matter how good the
 rest is**; a broken secondary feature caps at **3**. Half-stars are fine (e.g. ★★★½).
 State the single finding that set the ceiling.
 
+**Ease-of-use caps too.** If the first-run newcomer couldn't figure out how to start —
+create/open a project, or write and send their first prompt — without trial-and-error, cap at
+**3** however well the features work (a tool you can't figure out isn't "solid"). **5 requires
+the cold start to feel effortless**, not merely for the features to be correct: average
+`ease ≥ 4.5`, no newcomer left confused at a step, and no "I nearly gave up" verdict.
+
+**Mobile safe-area / keyboard caps too.** If a mobile persona found an interactive control on a
+**core** flow clipped under the notch/home-indicator or hidden behind the keyboard (a confirmed
+`safeAreaViolations` / `keyboard.coveredInputs` entry, or a screenshot showing it), cap at **3**
+however well the desktop layout works — a real phone user literally cannot tap what they can't
+reach. Name the offending control as the ceiling finding. **5 requires a clean mobile pass**: no
+core-flow safe-area or keyboard-coverage violation on any device a persona ran. (Cosmetic edge
+clipping of a non-interactive decoration is a `low` nit, not a cap.)
+
 ---
 
 ## Screenshot recipe — always wait for hydration
@@ -309,6 +436,15 @@ writes a `.mjs` script instead. Two gotchas that will `ERR_MODULE_NOT_FOUND` you
   resolves bare imports from the script's own folder upward, so a script in a scratchpad
   can't find the app's `node_modules`. Delete it when done.
 
+**Mobile personas — phone frame + safe-area.** Don't screenshot a mobile persona in a desktop
+viewport. Use `createMobileBotPage(browser, token, 'ios'|'android')` from `ugly-app/playwright`
+(phone viewport + touch + injected top/bottom safe-area), and load with `?debugSafeArea=true` so
+the red top / blue bottom / green keyboard bands are visible in the PNG for your vision pass.
+`raiseKeyboard(page, platform)` / `dismissKeyboard(page)` toggle the keyboard; `expectClean(page,
+{ allowSafeAreaViolations: false, allowKeyboardCoverage: false })` is the hard gate that lists
+clipped/covered interactive elements. (Requires a recent `ugly-app`; see TESTING.md → "Mobile
+safe-area + keyboard".)
+
 ---
 
 ## Config (optional, per-app)
@@ -318,7 +454,8 @@ An app can ship `bots/eval-swarm.json` for repeatable runs:
 ```json
 {
   "personas": [
-    { "slug": "plotter", "name": "The Plotter", "brief": "...", "goal": "...", "needs": "consume" }
+    { "slug": "plotter", "name": "The Plotter", "brief": "...", "goal": "...", "needs": "consume", "device": "desktop" },
+    { "slug": "newcomer", "name": "The Newcomer", "brief": "...", "goal": "...", "needs": "create", "device": "ios" }
   ],
   "seed": "bots/seed-story.mjs",
   "model": "deepseek_v4_flash"
@@ -329,6 +466,8 @@ An app can ship `bots/eval-swarm.json` for repeatable runs:
   data is absent after it; the skill does not auto-run seeders unless the app documents it).
 - `model` — a cheap-model override env the app honors for eval runs (e.g. ugly-ink's
   `INK_FORCE_MODEL`). Cost control only; default is the app's real production model.
+- `device` — per-persona `desktop` | `ios` | `android` (default `desktop`). Mobile personas
+  run the Mobile safe-area + keyboard pass (Step 3). Give at least two personas a phone.
 
 If no config exists, invent personas per Step 1 — that is the normal path.
 
@@ -392,6 +531,8 @@ native/mobile work, or cross-app infra), say so — that's a real-cost item, not
 | "I can skip the screenshot, I know what it says" | No finding about a screen you didn't look at. Vision before verdict. |
 | "`login` failed, let me retry it headless" | It deadlocks on browser auth. Stop and tell the user. |
 | "Stubs would be cheaper" | Stubbed AI produces fake critiques. This skill is real-AI by design; use `verify:e2e` for hermetic checks. |
+| "I'll test this mobile-first app on desktop only" | A desktop viewport is blind to notch / home-indicator / keyboard clipping. Give ≥2 personas a phone `device` and run the Mobile pass. |
+| "The mobile screenshot looks fine, skip `expectClean`" | Eyeballing misses sub-pixel overlaps. `expectClean` names the exact clipped/covered element — run it for the hard signal. |
 
 ## Completion