swipium 1.0.0 → 1.1.0

package/dist/tools/clearOverlay.js

@@ -8,6 +8,14 @@ import { parseSnapshot, boundsContain } from '../snapshot/parse.js';
 import { detectTreeOverlays, classifyForeground, obstructionAt } from '../snapshot/overlays.js';
 const STRATEGIES = ['auto', 'hide_keyboard', 'press_back', 'tap_outside', 'minimize_logbox', 'dismiss_logbox', 'allow_permission', 'deny_permission', 'dismiss_toast_if_possible'];
 const center = (b) => ({ x: Math.round((b[0] + b[2]) / 2), y: Math.round((b[1] + b[3]) / 2) });
+async function safe(fn, fallback) {
+    try {
+        return await fn();
+    }
+    catch {
+        return fallback;
+    }
+}
 async function tapByText(d, nodes, re) {
     const n = nodes.find((x) => re.test(x.text) || re.test(x.desc));
     if (!n)
@@ -16,6 +24,18 @@ async function tapByText(d, nodes, re) {
     await d.pressXY(c.x, c.y, 100);
     return true;
 }
+async function handleNativeAlert(d, action) {
+    const fn = action === 'accept' ? d.acceptAlert : d.dismissAlert;
+    if (!fn)
+        return false;
+    try {
+        await fn.call(d);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 export function registerClearOverlay(server, sessions) {
     server.registerTool('qa_clear_overlay', {
         title: 'Clear an overlay',
@@ -53,25 +73,42 @@ export function registerClearOverlay(server, sessions) {
         const before = (await obstructionFor()).obstructed;
         const cleared = [];
         // gather context
-        const ime = await d.imeShown();
-        const fg = await d.foregroundOwner().catch(() => 'unknown');
-        let xml = '';
-        try {
-            xml = await d.dumpXml();
-        }
-        catch { /* animated/idle-fail — proceed with what we know */ }
+        const ime = await safe(() => d.imeShown(), false);
+        const fg = await safe(() => d.foregroundOwner(), 'unknown');
+        const xml = await safe(() => d.dumpXml(), '');
         const parsedBefore = xml ? parseSnapshot(xml) : undefined;
         const nodes = parsedBefore?.allNodes ?? [];
         const treeOverlays = detectTreeOverlays(nodes, parsedBefore?.screen);
         const overlaysBefore = treeOverlays.map((o) => o.type);
         const fgOverlay = classifyForeground(session.appId, fg);
-        const doHideKeyboard = async () => { if (await d.imeShown()) {
-            await d.pressKey('back');
-            cleared.push({ type: 'keyboard', action: 'hidden' });
-        } };
-        const doTapOutside = async () => { const sz = await d.screenSize(); const x = Math.round((sz?.width ?? 1080) * 0.5); const y = Math.round((sz?.height ?? 2000) * 0.08); await d.pressXY(x, y, 80); cleared.push({ type: 'unknown', action: 'tap_outside' }); };
+        const doHideKeyboard = async () => {
+            if (await safe(() => d.imeShown(), false)) {
+                await d.pressKey('back');
+                cleared.push({ type: 'keyboard', action: 'hidden' });
+            }
+            else {
+                cleared.push({ type: 'keyboard', action: 'not_visible_or_unsupported' });
+            }
+        };
+        const doTapOutside = async () => { const sz = await safe(() => d.screenSize(), null); const x = Math.round((sz?.width ?? 1080) * 0.5); const y = Math.round((sz?.height ?? 2000) * 0.08); await d.pressXY(x, y, 80); cleared.push({ type: 'unknown', action: 'tap_outside' }); };
         const doMinimizeLogbox = async () => { const ok = await tapByText(d, nodes, /minimize/i); cleared.push({ type: 'rn_logbox', action: ok ? 'minimized' : 'minimize_not_found' }); };
         const doDismissLogbox = async () => { const ok = await tapByText(d, nodes, /dismiss/i); cleared.push({ type: 'rn_logbox', action: ok ? 'dismissed' : 'dismiss_not_found' }); };
+        const doAllowPermission = async () => {
+            if (await handleNativeAlert(d, 'accept')) {
+                cleared.push({ type: 'permission_dialog', action: 'allowed_native_alert' });
+                return;
+            }
+            const ok = await tapByText(d, nodes, /allow|while using/i);
+            cleared.push({ type: 'permission_dialog', action: ok ? 'allowed' : 'allow_not_found' });
+        };
+        const doDenyPermission = async () => {
+            if (await handleNativeAlert(d, 'dismiss')) {
+                cleared.push({ type: 'permission_dialog', action: 'denied_native_alert' });
+                return;
+            }
+            const ok = await tapByText(d, nodes, /deny|don.?t allow/i);
+            cleared.push({ type: 'permission_dialog', action: ok ? 'denied' : 'deny_not_found' });
+        };
         try {
             switch (strategy) {
                 case 'hide_keyboard':
@@ -90,16 +127,12 @@ export function registerClearOverlay(server, sessions) {
                 case 'dismiss_logbox':
                     await doDismissLogbox();
                     break;
-                case 'allow_permission': {
-                    const ok = await tapByText(d, nodes, /allow|while using/i);
-                    cleared.push({ type: 'permission_dialog', action: ok ? 'allowed' : 'allow_not_found' });
+                case 'allow_permission':
+                    await doAllowPermission();
                     break;
-                }
-                case 'deny_permission': {
-                    const ok = await tapByText(d, nodes, /deny|don.?t allow/i);
-                    cleared.push({ type: 'permission_dialog', action: ok ? 'denied' : 'deny_not_found' });
+                case 'deny_permission':
+                    await doDenyPermission();
                     break;
-                }
                 case 'dismiss_toast_if_possible':
                     cleared.push({ type: 'toast', action: 'cannot_target (toasts are separate windows; wait it out)' });
                     break;
@@ -125,7 +158,9 @@ export function registerClearOverlay(server, sessions) {
         const after = (await obstructionFor()).obstructed;
         let parsedAfter;
         try {
-            parsedAfter = parseSnapshot(await d.dumpXml());
+            const afterXml = await safe(() => d.dumpXml(), '');
+            if (afterXml)
+                parsedAfter = parseSnapshot(afterXml);
         }
         catch { /* keep undefined */ }
         const afterOverlays = parsedAfter ? detectTreeOverlays(parsedAfter.allNodes, parsedAfter.screen) : [];

package/dist/tools/clearOverlay.js.map

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

package/dist/tools/device.js

@@ -0,0 +1,151 @@
+// qa_device_info + qa_orientation (PHASE3-PLAN §4.2) — device-parity introspection and rotation,
+// without raw adb. Read-only info needs no consent; orientation is a logged, non-destructive
+// environment change.
+import { z } from 'zod';
+import { qaOk, qaError } from '../lib/result.js';
+import { requireConsent, consumeConsent } from '../consent/consent.js';
+import { getDriver } from '../session/attach.js';
+import { getDeviceProps, getOrientation, setOrientation, listPackages, setGeo } from '../lib/device.js';
+function rotationLabel(rotation, auto) {
+    return auto ? 'auto' : rotation === 1 || rotation === 3 ? 'landscape' : 'portrait';
+}
+export function registerDevice(server, sessions) {
+    server.registerTool('qa_device_info', {
+        title: 'Device info',
+        description: 'Read-only device introspection (no consent needed): model/manufacturer/Android SDK+release, supported ABIs, locale, timezone, screen size/density, current orientation, and installed third-party app count. Pass listPackages:true (optionally packageFilter) to include package names.',
+        inputSchema: {
+            sessionId: z.string(),
+            listPackages: z.boolean().optional().describe('Include installed third-party package names.'),
+            packageFilter: z.string().optional().describe('Substring filter for the package list.'),
+        },
+    }, async ({ sessionId, listPackages: withPkgs, packageFilter }) => {
+        const session = sessions.get(sessionId);
+        const { driver } = session ? await getDriver(session) : { driver: undefined };
+        const serial = driver?.currentDevice();
+        if (!session || !driver || !serial) {
+            return qaError({ what: 'No device attached to this session', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target first.'] });
+        }
+        const [props, screen, density, orientation, pkgs] = await Promise.all([
+            getDeviceProps(serial),
+            driver.screenSize().catch(() => null),
+            driver.screenDensity().catch(() => null),
+            getOrientation(serial),
+            listPackages(serial, { thirdPartyOnly: true, filter: packageFilter }),
+        ]);
+        const orient = orientation ? rotationLabel(orientation.rotation, orientation.auto) : 'unknown';
+        const payload = {
+            device: serial,
+            props,
+            screen: screen ? { ...screen, density } : null,
+            orientation: orient,
+            rotation: orientation?.rotation ?? null,
+            autoRotate: orientation?.auto ?? null,
+            installedThirdPartyCount: pkgs.length,
+            ...(withPkgs ? { packages: pkgs } : {}),
+        };
+        const summary = `${props.manufacturer ?? '?'} ${props.model ?? '?'} · Android ${props.release ?? '?'} (SDK ${props.sdk ?? '?'}) · ${props.abis[0] ?? '?'}\n` +
+            `screen ${screen ? `${screen.width}x${screen.height}@${density ?? '?'}dpi` : '?'} · orientation ${orient} · locale ${props.locale ?? '?'} · tz ${props.timezone ?? '?'}\n` +
+            `${pkgs.length} third-party apps installed${withPkgs ? ':\n  ' + pkgs.join('\n  ') : ' (listPackages:true to list)'}`;
+        return qaOk(payload, summary);
+    });
+    server.registerTool('qa_orientation', {
+        title: 'Set orientation',
+        description: 'Set screen orientation: portrait | landscape | auto (re-enables auto-rotate). Non-destructive; logged as an environment change and surfaced in qa_report. Useful for testing rotation handling.',
+        inputSchema: {
+            sessionId: z.string(),
+            orientation: z.enum(['portrait', 'landscape', 'auto']),
+        },
+    }, async ({ sessionId, orientation }) => {
+        const session = sessions.get(sessionId);
+        const { driver } = session ? await getDriver(session) : { driver: undefined };
+        const serial = driver?.currentDevice();
+        if (!session || !driver || !serial) {
+            return qaError({ what: 'No device attached to this session', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target first.'] });
+        }
+        try {
+            await setOrientation(serial, orientation);
+        }
+        catch (e) {
+            return qaError({ what: `Could not set orientation: ${String(e)}`, changedState: false, retrySafe: true, nextSteps: ['Confirm the device is online.'] });
+        }
+        sessions.addEnvChange(session, `orientation → ${orientation}`);
+        const now = await getOrientation(serial);
+        sessions.recordMutation(session, {
+            tool: 'qa_orientation',
+            action: 'orientation_set',
+            risk: 'low',
+            target: { device: serial, orientation, rotation: now?.rotation ?? null, autoRotate: now?.auto ?? null },
+            consent: { required: false, approved: true },
+            status: 'executed',
+        });
+        return qaOk({ orientation, rotation: now?.rotation ?? null, autoRotate: now?.auto ?? null }, `orientation set to ${orientation}${now ? ` (rotation=${now.rotation}, auto=${now.auto})` : ''}`);
+    });
+    server.registerTool('qa_geolocation', {
+        title: 'Set location',
+        description: 'Spoof the device GPS location (emulator only). Consent-gated and logged as an environment change. Useful for testing location-dependent apps (maps, nearby, geofencing). Pass lat + lng (decimal degrees).',
+        inputSchema: {
+            sessionId: z.string(),
+            lat: z.number().describe('Latitude in decimal degrees.'),
+            lng: z.number().describe('Longitude in decimal degrees.'),
+            consentId: z.string().optional(),
+            approve: z.boolean().optional(),
+        },
+    }, async ({ sessionId, lat, lng, consentId, approve }) => {
+        const session = sessions.get(sessionId);
+        const { driver } = session ? await getDriver(session) : { driver: undefined };
+        const serial = driver?.currentDevice();
+        if (!session || !driver || !serial) {
+            return qaError({ what: 'No device attached to this session', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target first.'] });
+        }
+        if (driver.kind !== 'direct') {
+            return qaError({ what: 'Geolocation spoofing is only supported on the Android emulator backend', changedState: false, retrySafe: false, failureCode: 'BACKEND_UNSUPPORTED', nextSteps: ['On iOS, set a simulated location from the simulator UI; on real devices use a mock-location app.'] });
+        }
+        const gate = consumeConsent(consentId, approve, { action: 'geo_set', affects: { lat, lng } });
+        if (!gate.approved) {
+            sessions.recordMutation(session, {
+                tool: 'qa_geolocation',
+                action: 'geo_set',
+                risk: 'medium',
+                target: { device: serial, lat, lng },
+                consent: { required: true, approved: false },
+                status: 'requested',
+            });
+            return requireConsent({ action: 'geo_set', risk: 'medium', exactCommand: `adb -s ${serial} emu geo fix ${lng} ${lat}`, affects: { lat, lng }, explain: `Spoof the device location to (${lat}, ${lng})? Affects any location-aware app.` });
+        }
+        sessions.recordMutation(session, {
+            tool: 'qa_geolocation',
+            action: 'geo_set',
+            risk: 'medium',
+            target: { device: serial, lat, lng },
+            consent: { required: true, consentId, approved: true },
+            status: 'approved',
+        });
+        try {
+            await setGeo(serial, lat, lng);
+        }
+        catch (e) {
+            const emulatorHint = !serial.startsWith('emulator-') ? ' (this looks like a real device — `adb emu` only works on emulators)' : '';
+            sessions.recordMutation(session, {
+                tool: 'qa_geolocation',
+                action: 'geo_set',
+                risk: 'medium',
+                target: { device: serial, lat, lng },
+                consent: { required: true, consentId, approved: true },
+                status: 'blocked',
+                detail: String(e),
+            });
+            return qaError({ what: `Could not set location: ${String(e)}${emulatorHint}`, changedState: false, retrySafe: true, nextSteps: ['Use an emulator for location spoofing.'] });
+        }
+        sessions.addEnvChange(session, `geolocation → (${lat}, ${lng})`);
+        sessions.recordMutation(session, {
+            tool: 'qa_geolocation',
+            action: 'geo_set',
+            risk: 'medium',
+            target: { device: serial, lat, lng },
+            consent: { required: true, consentId, approved: true },
+            status: 'executed',
+        });
+        return qaOk({ lat, lng, set: true }, `location set to (${lat}, ${lng})`);
+    });
+}
+//# sourceMappingURL=device.js.map

package/dist/tools/device.js.map

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

package/dist/tools/doctor.js

@@ -1,19 +1,65 @@
 // qa_doctor — proactive environment self-diagnosis (DESIGN §3, §7). Run first.
 import { z } from 'zod';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
 import { qaOk } from '../lib/result.js';
 import { getSchemaHash } from '../lib/schemaHash.js';
 import { which, firstLine, adbDevices, listAvds, deviceFreeDataBytes, fmtBytes } from '../lib/android.js';
+import { simctlAvailable, listSimulators } from '../lib/simctl.js';
+import { checkWda, discoverWdaProjects, xcodeAvailable } from '../lib/wda.js';
+import { loadWdaConfig } from '../lib/wdaConfig.js';
 import { SWIPIUM_VERSION, TOOL_NAMES, TOOL_COUNT, STALE_CLIENT_HINT } from '../version.js';
 const CLIENT_HINTS = {
     claude: 'Register with: claude mcp add swipium --scope project -- node <abs>/dist/index.js',
     gemini: 'Add to settings.json mcpServers; set an absolute "command" and a "cwd". stdio cwd is otherwise undefined.',
     codex: 'Codex has an open tool-injection regression (#19425) on builds after ~0.120.0. Set cwd explicitly, use an absolute node path, and verify tools actually appear after `init codex`.',
 };
+function checkLine(c) {
+    const status = c.ok ? '[ok]' : c.optional ? '[warn]' : '[fail]';
+    return `${status} ${c.name}: ${c.detail}${c.fix && !c.ok ? ` -> ${c.fix}` : ''}`;
+}
+function wdaBuildProductStatus(derivedDataPath) {
+    if (!existsSync(derivedDataPath))
+        return { built: false, checkedPath: derivedDataPath };
+    const stack = [{ path: derivedDataPath, depth: 0 }];
+    while (stack.length) {
+        const cur = stack.pop();
+        if (cur.depth > 6)
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(cur.path);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            const p = join(cur.path, name);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (!st.isDirectory())
+                continue;
+            if (/WebDriverAgentRunner.*\.app$/i.test(name))
+                return { built: true, productPath: p, checkedPath: derivedDataPath };
+            stack.push({ path: p, depth: cur.depth + 1 });
+        }
+    }
+    return { built: false, checkedPath: derivedDataPath };
+}
 export function registerDoctor(server) {
     server.registerTool('qa_doctor', {
         title: 'QA environment doctor',
-        description: 'Probe the local environment for Android mobile-app QA prerequisites (adb, emulator, online devices, AVDs, Java, Node) and report a structured diagnosis with actionable fixes. Run this BEFORE other tools. Pass `client` to tailor registration hints.',
+        description: 'Probe the local environment for simulator QA prerequisites. Use platform:"android" for Android Emulator, platform:"ios" for iOS Simulator + WDA status, or platform:"both". Pass client to tailor MCP registration hints.',
         inputSchema: {
+            platform: z
+                .enum(['android', 'ios', 'both'])
+                .optional()
+                .describe('Which simulator environment to evaluate. Defaults to android for backward compatibility.'),
             client: z
                 .enum(['claude', 'gemini', 'codex'])
                 .optional()
@@ -25,8 +71,13 @@ export function registerDoctor(server) {
             expectedVersion: z.string().optional().describe('Swipium version your docs expect; mismatch ⇒ stale client.'),
             expectedSchemaHash: z.string().optional().describe('Tool-surface hash your docs expect; mismatch ⇒ the client is on a build with a different surface (same tool count can still be stale).'),
         },
-    }, async ({ client, expectedToolCount, expectedVersion, expectedSchemaHash }) => {
+    }, async ({ platform = 'android', client, expectedToolCount, expectedVersion, expectedSchemaHash }) => {
+        const requested = platform;
+        const wantsAndroid = requested === 'android' || requested === 'both';
+        const wantsIos = requested === 'ios' || requested === 'both';
         const checks = [];
+        const androidChecks = [];
+        const iosChecks = [];
         const schemaHash = getSchemaHash();
         // Stale-client detection (P1.8 + 3.3 A): the agent (via docs) tells us what it expects; we are
         // the source of truth. Version is for humans; the schema hash catches "same count, different
@@ -46,69 +97,140 @@ export function registerDoctor(server) {
             });
         }
         checks.push({ name: 'node', ok: true, detail: process.version });
-        const hasAdb = await which('adb');
-        checks.push({
-            name: 'adb',
-            ok: hasAdb,
-            detail: hasAdb ? ((await firstLine('adb', ['version'])) ?? 'present') : 'not on PATH',
-            fix: hasAdb ? undefined : 'Install Android platform-tools and add to PATH (ANDROID_HOME/platform-tools).',
-        });
-        const devices = hasAdb ? await adbDevices() : [];
-        // Per-device free /data — surfaces the "APK too big for partition" class proactively.
-        const deviceDetails = await Promise.all(devices.map(async (d) => {
-            const free = await deviceFreeDataBytes(d);
-            const low = free != null && free < 600 * 1024 * 1024; // <600MB is risky for RN APKs
-            return `${d} (/data free: ${fmtBytes(free)}${low ? ' ⚠ low' : ''})`;
-        }));
-        const anyLowSpace = deviceDetails.some((d) => d.includes('⚠ low'));
-        checks.push({
-            name: 'device-online',
-            ok: devices.length > 0,
-            detail: devices.length ? deviceDetails.join(', ') : 'no device/emulator online',
-            fix: devices.length
-                ? anyLowSpace
-                    ? 'Low /data space — reboot the emulator with `-wipe-data -partition-size 8192` before installing large RN APKs.'
-                    : undefined
-                : 'Boot an emulator (qa_prepare_target will offer to), then re-run.',
-        });
-        const hasEmulator = await which('emulator');
-        const avds = hasEmulator ? await listAvds() : [];
-        checks.push({
-            name: 'emulator+avd',
-            ok: hasEmulator && avds.length > 0,
-            optional: devices.length > 0, // not needed if a device is already online
-            detail: hasEmulator ? (avds.length ? `AVDs: ${avds.join(', ')}` : 'emulator present, no AVDs') : 'emulator not on PATH',
-            fix: hasEmulator && avds.length === 0
-                ? 'Create an AVD: sdkmanager "system-images;android-35;google_apis;arm64-v8a" && avdmanager create avd -n qa -k "system-images;android-35;google_apis;arm64-v8a"'
-                : hasEmulator
-                    ? undefined
-                    : 'Install the Android Emulator package via sdkmanager.',
-        });
-        const java = await firstLine('java', ['-version']);
-        checks.push({
-            name: 'java',
-            ok: java !== null,
-            optional: true, // only needed for build-from-source / a native backend (later phases)
-            detail: java ?? 'not found (only needed for build-from-source / a native backend)',
-        });
-        const requiredOk = checks.filter((c) => !c.optional).every((c) => c.ok);
+        let devices = [];
+        let avds = [];
+        let androidReady = true;
+        if (wantsAndroid) {
+            const hasAdb = await which('adb');
+            androidChecks.push({
+                name: 'adb',
+                ok: hasAdb,
+                detail: hasAdb ? ((await firstLine('adb', ['version'])) ?? 'present') : 'not on PATH',
+                fix: hasAdb ? undefined : 'Install Android platform-tools and add to PATH (ANDROID_HOME/platform-tools).',
+            });
+            devices = hasAdb ? await adbDevices() : [];
+            const deviceDetails = await Promise.all(devices.map(async (d) => {
+                const free = await deviceFreeDataBytes(d);
+                const low = free != null && free < 600 * 1024 * 1024;
+                return `${d} (/data free: ${fmtBytes(free)}${low ? ' low' : ''})`;
+            }));
+            const anyLowSpace = deviceDetails.some((d) => d.includes(' low'));
+            androidChecks.push({
+                name: 'device-online',
+                ok: devices.length > 0,
+                optional: true,
+                detail: devices.length ? deviceDetails.join(', ') : 'no device/emulator online',
+                fix: devices.length
+                    ? anyLowSpace
+                        ? 'Low /data space: reboot the emulator with `-wipe-data -partition-size 8192` before installing large RN APKs.'
+                        : undefined
+                    : 'Boot an emulator, or let qa_prepare_target boot an available AVD.',
+            });
+            const hasEmulator = await which('emulator');
+            avds = hasEmulator ? await listAvds() : [];
+            androidChecks.push({
+                name: 'emulator+avd',
+                ok: hasEmulator && avds.length > 0,
+                optional: devices.length > 0,
+                detail: hasEmulator ? (avds.length ? `AVDs: ${avds.join(', ')}` : 'emulator present, no AVDs') : 'emulator not on PATH',
+                fix: hasEmulator && avds.length === 0
+                    ? 'Create an AVD with Android Studio or avdmanager.'
+                    : hasEmulator
+                        ? undefined
+                        : 'Install the Android Emulator package via Android Studio or sdkmanager.',
+            });
+            androidChecks.push({
+                name: 'android-target',
+                ok: devices.length > 0 || (hasEmulator && avds.length > 0),
+                detail: devices.length > 0 ? 'online device/emulator available' : hasEmulator && avds.length > 0 ? 'bootable AVD available' : 'no online target or bootable AVD',
+                fix: devices.length > 0 || (hasEmulator && avds.length > 0) ? undefined : 'Create or boot an Android Emulator, then rerun qa_doctor.',
+            });
+            const java = await firstLine('java', ['-version']);
+            androidChecks.push({
+                name: 'java',
+                ok: java !== null,
+                optional: true,
+                detail: java ?? 'not found (only needed for build-from-source / native Android builds)',
+            });
+            checks.push(...androidChecks);
+            androidReady = androidChecks.filter((c) => !c.optional).every((c) => c.ok);
+        }
+        let simulators = [];
+        let iosReady = true;
+        let wdaSummary;
+        if (wantsIos) {
+            const xcode = await xcodeAvailable();
+            iosChecks.push({
+                name: 'xcodebuild',
+                ok: xcode.available,
+                detail: xcode.available ? (xcode.version ?? 'present') : (xcode.error ?? 'not available'),
+                fix: xcode.available ? undefined : 'Install Xcode and select it with `xcode-select`.',
+            });
+            const simctlOk = await simctlAvailable();
+            iosChecks.push({
+                name: 'simctl',
+                ok: simctlOk,
+                detail: simctlOk ? 'available' : 'xcrun simctl unavailable',
+                fix: simctlOk ? undefined : 'Install Xcode command line tools and an iOS simulator runtime.',
+            });
+            simulators = simctlOk ? await listSimulators() : [];
+            const booted = simulators.filter((s) => s.state === 'Booted');
+            iosChecks.push({
+                name: 'ios-simulator',
+                ok: simulators.length > 0,
+                detail: simulators.length ? `${booted.length} booted, ${simulators.length} available` : 'no iOS simulators available',
+                fix: simulators.length ? undefined : 'Install an iOS Simulator runtime in Xcode and create a simulator.',
+            });
+            const root = process.cwd();
+            const wdaConfig = loadWdaConfig(root);
+            const wda = await checkWda(wdaConfig.url, 1200);
+            const discovery = discoverWdaProjects(root);
+            const wdaProduct = wdaBuildProductStatus(wdaConfig.derivedDataPath);
+            iosChecks.push({
+                name: 'wda-server',
+                ok: wda.reachable && wda.ready,
+                optional: true,
+                detail: wda.reachable ? `${wda.ready ? 'ready' : 'reachable but not ready'} at ${wdaConfig.url}` : `not reachable at ${wdaConfig.url}`,
+                fix: wda.reachable && wda.ready ? undefined : 'For structured iOS flows, run qa_wda doctor/build/start or attach an external WDA URL.',
+            });
+            iosChecks.push({
+                name: 'wda-project-cache',
+                ok: discovery.candidates.length > 0 || wdaProduct.built,
+                optional: true,
+                detail: wdaProduct.built
+                    ? `built product: ${wdaProduct.productPath}`
+                    : discovery.candidates.length
+                        ? `project candidates: ${discovery.candidates.slice(0, 3).join(', ')}`
+                        : `no WDA project found; checked cache ${wdaProduct.checkedPath}`,
+                fix: discovery.candidates.length > 0 || wdaProduct.built ? undefined : 'Install appium-webdriveragent or configure ios.wda.derivedDataPath / wdaProjectPath.',
+            });
+            checks.push(...iosChecks);
+            iosReady = iosChecks.filter((c) => !c.optional).every((c) => c.ok);
+            wdaSummary = { config: { url: wdaConfig.url, mode: wdaConfig.mode, derivedDataPath: wdaConfig.derivedDataPath }, status: wda, projectDiscovery: discovery, buildProduct: wdaProduct };
+        }
+        const requiredOk = requested === 'android' ? androidReady :
+            requested === 'ios' ? iosReady :
+                androidReady && iosReady;
         const clientHint = client ? CLIENT_HINTS[client] : undefined;
-        const table = checks
-            .map((c) => `${c.ok ? '✅' : c.optional ? '⚠️ ' : '❌'} ${c.name}: ${c.detail}${c.fix && !c.ok ? `  → ${c.fix}` : ''}`)
-            .join('\n');
+        const table = checks.map(checkLine).join('\n');
         const summary = `Swipium v${SWIPIUM_VERSION} · ${TOOL_COUNT} tools · schema ${schemaHash}\n${STALE_CLIENT_HINT}\n\n` +
-            `${requiredOk ? 'Environment ready for Android QA.' : 'Environment NOT ready — see ❌ rows.'}\n${table}`;
+            `${requiredOk ? `Environment ready for ${requested} simulator QA.` : `Environment NOT ready for ${requested} simulator QA. See [fail] rows.`}\n${table}`;
         return qaOk({
             swipiumVersion: SWIPIUM_VERSION,
             schemaHash,
             toolSurface: { count: TOOL_COUNT, tools: TOOL_NAMES },
+            platform: requested,
             ready: requiredOk,
+            platformReady: { android: wantsAndroid ? androidReady : null, ios: wantsIos ? iosReady : null },
             clientFreshness: expectedToolCount != null || expectedVersion != null || expectedSchemaHash != null
                 ? { stale: versionMismatch || toolCountMismatch || schemaHashMismatch, runningVersion: SWIPIUM_VERSION, runningToolCount: TOOL_COUNT, runningSchemaHash: schemaHash, expectedVersion: expectedVersion ?? null, expectedToolCount: expectedToolCount ?? null, expectedSchemaHash: expectedSchemaHash ?? null }
                 : undefined,
             checks,
+            checksByPlatform: { android: androidChecks, ios: iosChecks },
             devicesOnline: devices,
             avds,
+            simulators: wantsIos ? simulators : undefined,
+            wda: wdaSummary,
             ...(clientHint ? { clientHint } : {}),
         }, summary);
     });