codeloop-mcp-server 0.1.88 → 0.1.91

package/dist/runners/ios_sim_input.js

@@ -0,0 +1,453 @@
+/**
+ * iOS Simulator input backend — REAL tap/type/swipe/key for the Simulator.
+ *
+ * Why this exists: `xcrun simctl io` only supports `enumerate / poll /
+ * recordVideo / screenshot`. The old `simctl io booted tap/type/swipe/
+ * sendkey` helpers in window_manager.ts invoked subcommands that have
+ * NEVER existed in any Xcode release, so every coordinate-driven iOS
+ * interaction failed unconditionally (E2E 11, WedCheese run).
+ *
+ * Strategy (in preference order):
+ *  1. `idb` (Facebook's iOS debug bridge) when on PATH — drives HID
+ *     events directly into the simulator (`idb ui tap/swipe/text`),
+ *     no window focus needed, coordinates are device POINTS.
+ *  2. CGEvent via the Simulator window (always available on macOS):
+ *     bring Simulator frontmost → resolve the DEVICE CONTENT rect →
+ *     a fresh device screenshot gives a self-calibrating map from
+ *     screenshot pixels → host screen points → post real events.
+ *     The content rect comes from the Accessibility tree (the device
+ *     screen is an AXGroup sized exactly device-points — robust to
+ *     bezels, zoom levels, and toolbar chrome); when AX is unavailable
+ *     we fall back to window-bounds width-ratio calibration (default
+ *     window mode only).
+ *
+ * Coordinate convention: callers pass coordinates in DEVICE PIXELS as
+ * seen on a `simctl io screenshot` PNG (that's what the agent's vision
+ * works from). Both backends translate internally.
+ */
+import { join } from "path";
+import { tmpdir, platform } from "os";
+import { unlinkSync, existsSync } from "fs";
+import { runCommand, checkToolAvailable } from "./base.js";
+import { readPngDims } from "./png_dims.js";
+import { getWindowBounds, bringAppToFront, clickAtPosition, dragDrop, longPressAtPosition, typeText, sendKeyByName, sendHotkey, } from "./window_manager.js";
+const SIMULATOR_APP = "Simulator";
+/** Calibration is re-used briefly so a tap+type sequence doesn't re-screenshot. */
+const MAPPING_TTL_MS = 5_000;
+/** Window chrome (title bar) sanity range, in screen points. */
+const MAX_CHROME_PT = 120;
+const SCREENSHOT_TIMEOUT_MS = 20_000;
+const IDB_TIMEOUT_MS = 30_000;
+// ── idb backend detection ───────────────────────────────────────────
+let idbAvailableCache = null;
+export async function isIdbAvailable() {
+    if (idbAvailableCache !== null)
+        return idbAvailableCache;
+    idbAvailableCache = await checkToolAvailable("idb");
+    return idbAvailableCache;
+}
+/** Test hook — reset memoized idb detection + calibration. */
+export function resetIosInputCaches() {
+    idbAvailableCache = null;
+    mappingCache.clear();
+}
+const idbDimsCache = new Map();
+/**
+ * idb expects coordinates in device POINTS; our callers supply device
+ * PIXELS (screenshot space). `idb describe` exposes both so we can
+ * scale. Cached per udid — device geometry never changes while booted.
+ */
+async function idbScreenDims(udid) {
+    const cached = idbDimsCache.get(udid);
+    if (cached)
+        return cached;
+    const args = ["describe", "--json"];
+    if (udid && udid !== "booted")
+        args.push("--udid", udid);
+    const result = await runCommand("idb", args, process.cwd(), undefined, undefined, IDB_TIMEOUT_MS);
+    if (result.exit_code !== 0)
+        return null;
+    try {
+        const parsed = JSON.parse(result.stdout);
+        const sd = parsed.screen_dimensions;
+        if (!sd?.width || !sd.height || !sd.width_points || !sd.height_points)
+            return null;
+        const dims = {
+            widthPixels: sd.width,
+            heightPixels: sd.height,
+            widthPoints: sd.width_points,
+            heightPoints: sd.height_points,
+        };
+        idbDimsCache.set(udid, dims);
+        return dims;
+    }
+    catch {
+        return null;
+    }
+}
+function idbUdidArgs(udid) {
+    return udid && udid !== "booted" ? ["--udid", udid] : [];
+}
+/** Convert device-pixel coords → device points for idb. */
+async function toIdbPoints(udid, x, y) {
+    const dims = await idbScreenDims(udid);
+    if (!dims)
+        return null;
+    const factor = dims.widthPixels > 0 ? dims.widthPoints / dims.widthPixels : 1;
+    return { x: Math.round(x * factor), y: Math.round(y * factor) };
+}
+// ── CGEvent backend: content-rect calibration ───────────────────────
+const mappingCache = new Map();
+/**
+ * The device screen inside the Simulator window is an AXGroup whose AX
+ * frame is exactly the content rect in global screen points — robust to
+ * device bezels, zoom level, and toolbar chrome (all of which break the
+ * naive "content spans the window width" assumption; live debugging
+ * showed Xcode 26's Simulator adds bezel margins by default).
+ *
+ * Returns every device-content group across Simulator windows so the
+ * caller can match the window title to the pinned device's name.
+ */
+async function getSimulatorContentRects() {
+    const script = [
+        'set out to ""',
+        'tell application "System Events" to tell process "Simulator"',
+        '  repeat with w in windows',
+        '    try',
+        '      repeat with el in UI elements of w',
+        '        if role of el is "AXGroup" then',
+        '          set p to position of el',
+        '          set s to size of el',
+        '          set out to out & (name of w) & "|" & (item 1 of p) & "|" & (item 2 of p) & "|" & (item 1 of s) & "|" & (item 2 of s) & linefeed',
+        '        end if',
+        '      end repeat',
+        '    end try',
+        '  end repeat',
+        'end tell',
+        'return out',
+    ].join("\n");
+    const r = await runCommand("osascript", ["-e", script], process.cwd(), undefined, undefined, 15_000);
+    if (r.exit_code !== 0)
+        return [];
+    const rects = [];
+    for (const line of r.stdout.split("\n")) {
+        const parts = line.trim().split("|");
+        if (parts.length !== 5)
+            continue;
+        const [windowName, xs, ys, ws, hs] = parts;
+        const x = Number(xs), y = Number(ys), width = Number(ws), height = Number(hs);
+        if ([x, y, width, height].some((n) => !Number.isFinite(n)) || width < 50 || height < 50)
+            continue;
+        rects.push({ x, y, width, height, windowName });
+    }
+    return rects;
+}
+/** Booted-device name for a udid (so multi-sim setups pick the right window). */
+async function simDeviceName(udid) {
+    if (!udid || udid === "booted")
+        return null;
+    const r = await runCommand("xcrun", ["simctl", "list", "devices", "booted"], process.cwd(), undefined, undefined, 15_000);
+    if (r.exit_code !== 0)
+        return null;
+    const m = r.stdout.split("\n").find((l) => l.includes(udid));
+    if (!m)
+        return null;
+    const name = m.trim().split(`(${udid}`)[0]?.trim();
+    return name && name.length > 0 ? name : null;
+}
+/**
+ * Self-calibrating screenshot-pixel → host-screen-point mapping.
+ *
+ * 1. Bring Simulator frontmost (CGEvents land on whatever is under
+ *    the cursor — we need our window there, and key events need focus).
+ * 2. Resolve the device CONTENT rect via the AX tree (preferred), or
+ *    fall back to `getWindowBounds("Simulator")` width-ratio math
+ *    (default window mode, no bezels, title bar only).
+ * 3. `simctl io <udid> screenshot` + IHDR read → device pixel dims →
+ *    scale = contentWidth / pngWidth.
+ *
+ * Returns null when no Simulator window can be resolved or the
+ * geometry is implausible — callers surface a directive instead of
+ * clicking blind.
+ */
+export async function resolveSimMapping(udid = "booted", opts) {
+    // os.platform() (not process.platform) so unit tests can mock the host —
+    // CI runs this suite on Linux where the real value would null every mapping.
+    if (platform() !== "darwin")
+        return null;
+    const cacheKey = udid || "booted";
+    if (!opts?.forceRefresh) {
+        const cached = mappingCache.get(cacheKey);
+        if (cached && Date.now() - cached.capturedAt < MAPPING_TTL_MS)
+            return cached;
+    }
+    try {
+        await bringAppToFront(SIMULATOR_APP);
+    }
+    catch { /* best-effort */ }
+    // Give the window server a beat to finish the front-switch animation.
+    await new Promise((r) => setTimeout(r, 300));
+    const shotPath = join(tmpdir(), `codeloop_sim_cal_${Date.now()}.png`);
+    try {
+        const shot = await runCommand("xcrun", ["simctl", "io", cacheKey, "screenshot", shotPath], process.cwd(), undefined, undefined, SCREENSHOT_TIMEOUT_MS);
+        if (shot.exit_code !== 0 || !existsSync(shotPath))
+            return null;
+        const dims = readPngDims(shotPath);
+        if (!dims)
+            return null;
+        const aspect = dims.height / dims.width;
+        // Preferred: exact content rect from the AX tree.
+        const rects = await getSimulatorContentRects();
+        if (rects.length > 0) {
+            const wantedName = await simDeviceName(cacheKey);
+            const matching = wantedName ? rects.filter((r) => r.windowName.includes(wantedName)) : rects;
+            // Among candidates prefer the one whose aspect matches this device's
+            // screenshot (belt + suspenders when several sims are visible).
+            const pool = matching.length > 0 ? matching : rects;
+            const best = pool
+                .map((r) => ({ r, aspectErr: Math.abs(r.height / r.width - aspect) / aspect }))
+                .sort((a, b) => a.aspectErr - b.aspectErr)[0];
+            if (best && best.aspectErr < 0.05) {
+                const mapping = {
+                    bounds: { x: best.r.x, y: best.r.y, width: best.r.width, height: best.r.height },
+                    pngWidth: dims.width,
+                    pngHeight: dims.height,
+                    scale: best.r.width / dims.width,
+                    chromeTop: 0,
+                    method: "ax",
+                    udid: cacheKey,
+                    capturedAt: Date.now(),
+                };
+                mappingCache.set(cacheKey, mapping);
+                return mapping;
+            }
+        }
+        // Fallback: window bounds + width-ratio (default window mode only —
+        // content spans the full width with a title bar on top).
+        const bounds = await getWindowBounds(SIMULATOR_APP);
+        if (!bounds || bounds.width <= 0 || bounds.height <= 0)
+            return null;
+        const scale = bounds.width / dims.width;
+        const chromeTop = bounds.height - dims.height * scale;
+        if (!Number.isFinite(scale) || scale <= 0 || chromeTop < -2 || chromeTop > MAX_CHROME_PT) {
+            return null;
+        }
+        const mapping = {
+            bounds,
+            pngWidth: dims.width,
+            pngHeight: dims.height,
+            scale,
+            chromeTop: Math.max(0, chromeTop),
+            method: "window-ratio",
+            udid: cacheKey,
+            capturedAt: Date.now(),
+        };
+        mappingCache.set(cacheKey, mapping);
+        return mapping;
+    }
+    finally {
+        try {
+            unlinkSync(shotPath);
+        }
+        catch { /* ignore */ }
+    }
+}
+/** Map a device-pixel coordinate to a host-screen point. Exported for tests. */
+export function mapToScreenPoint(mapping, x, y) {
+    return {
+        x: mapping.bounds.x + x * mapping.scale,
+        y: mapping.bounds.y + mapping.chromeTop + y * mapping.scale,
+    };
+}
+const MAPPING_FAIL_DETAIL = "could not calibrate the Simulator window (is the Simulator app open and visible, with Accessibility + Screen Recording permissions granted to the agent's terminal?). " +
+    "Try: open -a Simulator, ensure the device window is on screen, then retry. " +
+    "Installing idb (`brew install idb-companion && pipx install fb-idb`) enables window-independent input.";
+// ── Public input actions ─────────────────────────────────────────────
+export async function iosSimTap(x, y, udid = "booted") {
+    if (await isIdbAvailable()) {
+        const pt = await toIdbPoints(udid, x, y);
+        if (pt) {
+            const r = await runCommand("idb", ["ui", "tap", ...idbUdidArgs(udid), String(pt.x), String(pt.y)], process.cwd(), undefined, undefined, IDB_TIMEOUT_MS);
+            if (r.exit_code === 0) {
+                return { success: true, backend: "idb", detail: `idb tap (${pt.x},${pt.y}) pt` };
+            }
+            // fall through to CGEvent on idb failure
+        }
+    }
+    const mapping = await resolveSimMapping(udid);
+    if (!mapping)
+        return { success: false, backend: "none", detail: MAPPING_FAIL_DETAIL };
+    const pt = mapToScreenPoint(mapping, x, y);
+    const ok = await clickAtPosition(pt.x, pt.y);
+    return {
+        success: ok,
+        backend: "cgevent",
+        detail: ok
+            ? `cgevent tap px(${Math.round(x)},${Math.round(y)}) → screen(${Math.round(pt.x)},${Math.round(pt.y)})`
+            : "CGEvent click failed (Accessibility permission?)",
+    };
+}
+export async function iosSimLongPress(x, y, durationMs = 1000, udid = "booted") {
+    // idb has no long-press primitive; CGEvent press-and-hold works on the window.
+    const mapping = await resolveSimMapping(udid);
+    if (!mapping)
+        return { success: false, backend: "none", detail: MAPPING_FAIL_DETAIL };
+    const pt = mapToScreenPoint(mapping, x, y);
+    const ok = await longPressAtPosition(pt.x, pt.y, durationMs);
+    return {
+        success: ok,
+        backend: "cgevent",
+        detail: ok ? `cgevent long-press ${durationMs}ms at screen(${Math.round(pt.x)},${Math.round(pt.y)})` : "CGEvent long-press failed",
+    };
+}
+export async function iosSimSwipe(x1, y1, x2, y2, durationMs = 300, udid = "booted") {
+    if (await isIdbAvailable()) {
+        const a = await toIdbPoints(udid, x1, y1);
+        const b = await toIdbPoints(udid, x2, y2);
+        if (a && b) {
+            const r = await runCommand("idb", [
+                "ui", "swipe", ...idbUdidArgs(udid),
+                "--duration", String(Math.max(0.05, durationMs / 1000)),
+                String(a.x), String(a.y), String(b.x), String(b.y),
+            ], process.cwd(), undefined, undefined, IDB_TIMEOUT_MS);
+            if (r.exit_code === 0) {
+                return { success: true, backend: "idb", detail: `idb swipe (${a.x},${a.y})→(${b.x},${b.y}) pt` };
+            }
+        }
+    }
+    const mapping = await resolveSimMapping(udid);
+    if (!mapping)
+        return { success: false, backend: "none", detail: MAPPING_FAIL_DETAIL };
+    const a = mapToScreenPoint(mapping, x1, y1);
+    const b = mapToScreenPoint(mapping, x2, y2);
+    // CGEvent drag on the simulator content == touch swipe on the device.
+    const ok = await dragDrop(a.x, a.y, b.x, b.y, durationMs);
+    return {
+        success: ok,
+        backend: "cgevent",
+        detail: ok
+            ? `cgevent swipe screen(${Math.round(a.x)},${Math.round(a.y)})→(${Math.round(b.x)},${Math.round(b.y)})`
+            : "CGEvent drag failed (Accessibility permission?)",
+    };
+}
+export async function iosSimType(text, udid = "booted") {
+    if (text.length === 0)
+        return { success: true, backend: "none", detail: "empty text" };
+    if (await isIdbAvailable()) {
+        const r = await runCommand("idb", ["ui", "text", ...idbUdidArgs(udid), text], process.cwd(), undefined, undefined, IDB_TIMEOUT_MS);
+        if (r.exit_code === 0) {
+            return { success: true, backend: "idb", detail: `idb text (${text.length} chars)` };
+        }
+    }
+    // osascript keystroke goes to the frontmost app; Simulator forwards
+    // host keyboard input to the device when "Send Keyboard Input to
+    // Device" is enabled (the default).
+    try {
+        await bringAppToFront(SIMULATOR_APP);
+    }
+    catch { /* best-effort */ }
+    await new Promise((r) => setTimeout(r, 200));
+    const ok = await typeText(text);
+    return {
+        success: ok,
+        backend: "cgevent",
+        detail: ok ? `osascript keystroke (${text.length} chars)` : "osascript keystroke failed (Accessibility permission?)",
+    };
+}
+/**
+ * Send a named special key (return/tab/escape/arrows/…) to the simulator.
+ * Uses the same key-name normalisation as the desktop path.
+ */
+export async function iosSimKey(keyName, udid = "booted") {
+    if (await isIdbAvailable()) {
+        // idb key takes an Apple HID keycode; map the common ones.
+        const HID = {
+            return: 40, enter: 40, tab: 43, space: 44, escape: 41, esc: 41,
+            backspace: 42, delete: 42, "forward-delete": 76,
+            up: 82, "up-arrow": 82, down: 81, "down-arrow": 81,
+            left: 80, "left-arrow": 80, right: 79, "right-arrow": 79,
+            home: 74, end: 77,
+        };
+        const code = HID[keyName.toLowerCase()];
+        if (code != null) {
+            const r = await runCommand("idb", ["ui", "key", ...idbUdidArgs(udid), String(code)], process.cwd(), undefined, undefined, IDB_TIMEOUT_MS);
+            if (r.exit_code === 0)
+                return { success: true, backend: "idb", detail: `idb key ${keyName}` };
+        }
+    }
+    try {
+        await bringAppToFront(SIMULATOR_APP);
+    }
+    catch { /* best-effort */ }
+    await new Promise((r) => setTimeout(r, 200));
+    const ok = await sendKeyByName(keyName);
+    return {
+        success: ok,
+        backend: "cgevent",
+        detail: ok ? `cgevent key ${keyName}` : `key "${keyName}" failed or unknown`,
+    };
+}
+/**
+ * Rotate the simulator via the Device menu shortcuts (Cmd+Left / Cmd+Right).
+ * There is no simctl rotation command, so this drives the Simulator app —
+ * P1.2 (0.1.91); previously rotate_device silently no-opped on iOS.
+ *
+ * `orientation` is a TARGET hint: we can't read the current orientation,
+ * so "landscape" rotates right once and "portrait" rotates left once —
+ * callers should verify with a screenshot (mapping cache is invalidated).
+ */
+export async function iosSimRotate(orientation, udid = "booted") {
+    try {
+        await bringAppToFront(SIMULATOR_APP);
+    }
+    catch { /* best-effort */ }
+    await new Promise((r) => setTimeout(r, 300));
+    const combo = orientation === "landscape" ? "cmd+right" : "cmd+left";
+    const ok = await sendHotkey(combo);
+    // Window geometry changed — force recalibration on the next tap.
+    mappingCache.delete(udid || "booted");
+    return {
+        success: ok,
+        backend: "cgevent",
+        detail: ok
+            ? `${combo} sent to Simulator (target ${orientation}); rotation has no state read-back — verify with a screenshot`
+            : `${combo} failed — is the Simulator window frontmost and Accessibility permission granted?`,
+    };
+}
+/**
+ * Read the accessibility/UI tree off the simulator — only possible via
+ * idb (`describe-all`). Returns null when idb is missing so callers can
+ * keep the honest "use vision on a screenshot" directive.
+ */
+export async function iosSimGetText(udid = "booted") {
+    if (!(await isIdbAvailable()))
+        return null;
+    const r = await runCommand("idb", ["ui", "describe-all", ...idbUdidArgs(udid)], process.cwd(), undefined, undefined, IDB_TIMEOUT_MS);
+    if (r.exit_code !== 0 || !r.stdout.trim())
+        return null;
+    // describe-all emits one JSON object per element; surface the visible
+    // labels/values as plain text for the agent.
+    const texts = [];
+    try {
+        const parsed = JSON.parse(r.stdout);
+        for (const el of parsed) {
+            const t = (el.AXLabel || el.AXValue || "").trim();
+            if (t && t !== "(null)")
+                texts.push(t);
+        }
+    }
+    catch {
+        // Some idb versions emit NDJSON.
+        for (const line of r.stdout.split("\n")) {
+            try {
+                const el = JSON.parse(line);
+                const t = (el.AXLabel || el.AXValue || "").trim();
+                if (t && t !== "(null)")
+                    texts.push(t);
+            }
+            catch { /* skip non-JSON lines */ }
+        }
+    }
+    return texts.length > 0 ? texts.join("\n") : null;
+}
+//# sourceMappingURL=ios_sim_input.js.map

package/dist/runners/ios_sim_input.js.map

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

package/dist/runners/maestro.d.ts

@@ -8,8 +8,33 @@ export interface MaestroResult {
     logPath: string;
 }
 export declare function isMaestroInstalled(): Promise<boolean>;
+/**
+ * Per-OS Maestro install directive. The old curl-only line dead-ended
+ * Windows hosts (no bash); Windows gets the PowerShell installer.
+ */
+export declare function maestroInstallDirective(): string;
+/** Per-OS Java install directive (Maestro is a JVM CLI; no JVM = no Maestro). */
+export declare function javaInstallDirective(): string;
+export interface MaestroPreflight {
+    ok: boolean;
+    /** Actionable per-OS directive when not ok. */
+    directive?: string;
+}
+/**
+ * Preflight the Maestro toolchain BEFORE driving: the `maestro` launcher is a
+ * shell script around a JVM CLI, so a missing/broken Java produces a cryptic
+ * mid-flow failure unless caught here. `java -version` exits 0 and prints the
+ * version to stderr on every JDK.
+ */
+export declare function maestroPreflight(): Promise<MaestroPreflight>;
+/**
+ * Env for Maestro runs: the FIRST run on an iOS simulator installs +
+ * boots the XCTest driver, which routinely exceeds Maestro's default
+ * 15s driver-startup timeout — raise it so first runs don't flake.
+ */
+export declare function maestroRunEnv(): Record<string, string>;
 export declare function findMaestroFlows(cwd: string): string[];
-export declare function runMaestroTests(cwd: string, logDir: string): Promise<MaestroResult>;
+export declare function runMaestroTests(cwd: string, logDir: string, device?: string): Promise<MaestroResult>;
 /**
  * 0.1.51 H9 — Adapt `runMaestroTests` to the `RunnerResult` shape used
  * by every other verify runner so it can be pushed into the `results`
@@ -21,5 +46,5 @@ export declare function runMaestroTests(cwd: string, logDir: string): Promise<Ma
  * `passed` flows count toward `passed`, `failed` flows toward `failed`,
  * and `skipped` is always 0 (Maestro doesn't surface a skipped count).
  */
-export declare function runMaestroFlows(cwd: string, logPath: string): Promise<RunnerResult>;
+export declare function runMaestroFlows(cwd: string, logPath: string, device?: string): Promise<RunnerResult>;
 //# sourceMappingURL=maestro.d.ts.map

package/dist/runners/maestro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maestro.d.ts","sourceRoot":"","sources":["../../src/runners/maestro.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAK9C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG3D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQtD;AAuGD,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmCzF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAgCvB"}
+{"version":3,"file":"maestro.d.ts","sourceRoot":"","sources":["../../src/runners/maestro.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAM9C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG3D;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAWhD;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CASlE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQtD;AAuGD,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqC1G;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CA8BvB"}

package/dist/runners/maestro.js

@@ -2,11 +2,58 @@ import { runCommand, makeSkippedResult } from "./base.js";
 import { MAESTRO_TIMEOUT_MS } from "./test_watchdog.js";
 import { existsSync, mkdirSync, readdirSync } from "fs";
 import { join } from "path";
+import { platform } from "os";
 const MAESTRO_FLOW_REL_DIRS = ["tests/maestro", ".maestro", "maestro"];
 export async function isMaestroInstalled() {
     const result = await runCommand("maestro", ["--version"], process.cwd());
     return result.exit_code === 0;
 }
+// ── P0.4 (0.1.90): Maestro as a DEPENDABLE primary engine ───────────
+/**
+ * Per-OS Maestro install directive. The old curl-only line dead-ended
+ * Windows hosts (no bash); Windows gets the PowerShell installer.
+ */
+export function maestroInstallDirective() {
+    if (platform() === "win32") {
+        return ("Install Maestro (PowerShell): `iwr -UseBasicParsing https://get.maestro.mobile.dev/install.ps1 | iex` " +
+            "(or download from https://maestro.mobile.dev). Maestro is a JVM CLI — it also needs Java 17+ on PATH.");
+    }
+    return ("Install Maestro: `curl -Ls https://get.maestro.mobile.dev | bash`. " +
+        "Maestro is a JVM CLI — it also needs Java 17+ on PATH.");
+}
+/** Per-OS Java install directive (Maestro is a JVM CLI; no JVM = no Maestro). */
+export function javaInstallDirective() {
+    const os = platform();
+    if (os === "darwin")
+        return "Install Java 17+ for Maestro: `brew install --cask temurin` (then re-open the terminal).";
+    if (os === "win32")
+        return "Install Java 17+ for Maestro: `winget install EclipseAdoptium.Temurin.21.JDK` (then re-open the terminal).";
+    return "Install Java 17+ for Maestro: `sudo apt install openjdk-21-jre` (or your distro's OpenJDK 17+ package).";
+}
+/**
+ * Preflight the Maestro toolchain BEFORE driving: the `maestro` launcher is a
+ * shell script around a JVM CLI, so a missing/broken Java produces a cryptic
+ * mid-flow failure unless caught here. `java -version` exits 0 and prints the
+ * version to stderr on every JDK.
+ */
+export async function maestroPreflight() {
+    if (!(await isMaestroInstalled())) {
+        return { ok: false, directive: maestroInstallDirective() };
+    }
+    const java = await runCommand("java", ["-version"], process.cwd(), undefined, undefined, 20_000);
+    if (java.exit_code !== 0) {
+        return { ok: false, directive: `Maestro is installed but Java is not runnable (\`java -version\` failed). ${javaInstallDirective()}` };
+    }
+    return { ok: true };
+}
+/**
+ * Env for Maestro runs: the FIRST run on an iOS simulator installs +
+ * boots the XCTest driver, which routinely exceeds Maestro's default
+ * 15s driver-startup timeout — raise it so first runs don't flake.
+ */
+export function maestroRunEnv() {
+    return { MAESTRO_DRIVER_STARTUP_TIMEOUT: "120000" };
+}
 export function findMaestroFlows(cwd) {
     const flows = [];
     for (const rel of MAESTRO_FLOW_REL_DIRS) {
@@ -104,7 +151,7 @@ function collectScreenshotPaths(root) {
     walk(root);
     return paths.sort();
 }
-export async function runMaestroTests(cwd, logDir) {
+export async function runMaestroTests(cwd, logDir, device) {
     if (!(await isMaestroInstalled())) {
         return emptyMaestroResult();
     }
@@ -116,10 +163,12 @@ export async function runMaestroTests(cwd, logDir) {
     const testOutputDir = join(logDir, "maestro-output");
     mkdirSync(logDir, { recursive: true });
     mkdirSync(testOutputDir, { recursive: true });
-    const args = ["test", "--test-output-dir", testOutputDir, ...flows];
+    // `--udid` (root-level flag, alias --device) pins the run when several
+    // devices are connected — without it Maestro picks its own.
+    const args = [...(device ? ["--udid", device] : []), "test", "--test-output-dir", testOutputDir, ...flows];
     // Cap Maestro: flows drive a real device/emulator and can stall indefinitely
     // waiting for one to boot or for an element that never appears.
-    const result = await runCommand("maestro", args, cwd, logPath, undefined, MAESTRO_TIMEOUT_MS);
+    const result = await runCommand("maestro", args, cwd, logPath, maestroRunEnv(), MAESTRO_TIMEOUT_MS);
     const combined = result.stdout + result.stderr;
     const parsed = parseMaestroSummary(combined, flows.length, result.exit_code);
     const screenshotPaths = collectScreenshotPaths(testOutputDir);
@@ -144,17 +193,18 @@ export async function runMaestroTests(cwd, logDir) {
  * `passed` flows count toward `passed`, `failed` flows toward `failed`,
  * and `skipped` is always 0 (Maestro doesn't surface a skipped count).
  */
-export async function runMaestroFlows(cwd, logPath) {
+export async function runMaestroFlows(cwd, logPath, device) {
     const flows = findMaestroFlows(cwd);
     if (flows.length === 0) {
         return makeSkippedResult("maestro_flows", "No Maestro flows found (looked under .maestro/, tests/maestro/, maestro/)");
     }
-    if (!(await isMaestroInstalled())) {
-        return makeSkippedResult("maestro_flows", "maestro CLI not found on PATH. Install via `curl -Ls 'https://get.maestro.mobile.dev' | bash` (POSIX/macOS) and retry.");
+    const preflight = await maestroPreflight();
+    if (!preflight.ok) {
+        return makeSkippedResult("maestro_flows", preflight.directive ?? "Maestro toolchain unavailable.");
     }
     const start = Date.now();
     const logDir = join(logPath, "..");
-    const result = await runMaestroTests(cwd, logDir);
+    const result = await runMaestroTests(cwd, logDir, device);
     const duration_ms = Date.now() - start;
     return {
         runner_name: "maestro_flows",