doc-detective 4.21.0 → 4.22.0

package/dist/core/tests/mobilePlatform.js

@@ -1,11 +1,11 @@
 // Native app surfaces phase A3: the `android`/`ios` target platforms. Unlike
 // desktop platforms (where host == target), a mobile platform names the
 // TARGET a context runs against and is gated by host *capability*, not host
-// identity. As of A3b, android native app contexts can PASS (via
-// androidContextPreflight, which capability-gates and lazily installs the
-// toolchain); the cases this module composes SKIP reasons for are the ones
-// still gated by a later phase — iOS (A4) and android+browser (A5). The reason
-// composer is pure so it's unit-testable without probing an SDK.
+// identity. As of A4, native app contexts can pass on both mobile targets
+// when the host is capable. The remaining mobile-target skip reason this
+// module composes is mobile browser testing (A5), which is still gated on both
+// android and ios. The reason composer is pure so it's unit-testable without
+// probing an SDK.
 export { isMobileTargetPlatform, mobileContextSkipReason };
 // Classify a context platform as a mobile target, or null for desktop / junk.
 function isMobileTargetPlatform(platform) {
@@ -13,18 +13,19 @@ function isMobileTargetPlatform(platform) {
         return platform;
     return null;
 }
-// Compose the SKIP reason (and log level) for the mobile-context cases still
-// gated by a not-yet-implemented phase:
-//   - ios                         -> app surfaces land in A4
-//   - android with a browser step -> mobile browsers land in A5
-// (Android native app runs are handled by androidContextPreflight, which
-// capability-gates and lazily installs the toolchain rather than skipping.)
-function mobileContextSkipReason({ platform, hasBrowserStep, }) {
+// Compose the SKIP reason (and log level) for the one mobile-context case still
+// gated by a later phase: a mobile-web (browser) step on either target — mobile
+// browsers land in A5. Native app contexts (no browser step) are NOT routed
+// here; they pass through their platform's context preflight (androidContext-
+// Preflight / iosContextPreflight), which capability-gates and runs them. This
+// composer is only ever called for a mobile-browser context, so it branches on
+// the target platform alone.
+function mobileContextSkipReason({ platform, }) {
     const roadmap = "docs/design/native-app-surfaces.md";
     if (platform === "ios") {
         return {
-            level: "info",
-            reason: `Skipping context on 'ios': iOS app surfaces land in phase A4 of the native app roadmap (${roadmap}). Gate iOS tests with runOn platforms so this skip is intentional.`,
+            level: "warning",
+            reason: `Skipping context on 'ios': mobile browser testing on iOS lands in phase A5 of the native app roadmap (${roadmap}). Native iOS app tests run on capable macOS hosts.`,
         };
     }
     // android + a browser step: mobile-web testing on Android is phase A5.

package/dist/core/tests/mobilePlatform.js.map

@@ -1 +1 @@
-{"version":3,"file":"mobilePlatform.js","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,iEAAiE;AACjE,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,iEAAiE;AAEjE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AAI3D,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,QAAiB;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,wCAAwC;AACxC,6DAA6D;AAC7D,gEAAgE;AAChE,yEAAyE;AACzE,4EAA4E;AAC5E,SAAS,uBAAuB,CAAC,EAC/B,QAAQ,EACR,cAAc,GAIf;IACC,MAAM,OAAO,GAAG,oCAAoC,CAAC;IACrD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,2FAA2F,OAAO,qEAAqE;SAChL,CAAC;IACJ,CAAC;IACD,uEAAuE;IACvE,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,iHAAiH,OAAO,2DAA2D;KAC5L,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mobilePlatform.js","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,+EAA+E;AAC/E,6EAA6E;AAC7E,kBAAkB;AAElB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AAI3D,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,QAAiB;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,6BAA6B;AAC7B,SAAS,uBAAuB,CAAC,EAC/B,QAAQ,GAGT;IACC,MAAM,OAAO,GAAG,oCAAoC,CAAC;IACrD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,yGAAyG,OAAO,qDAAqD;SAC9K,CAAC;IACJ,CAAC;IACD,uEAAuE;IACvE,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,iHAAiH,OAAO,2DAA2D;KAC5L,CAAC;AACJ,CAAC"}

package/dist/core/tests.d.ts.map

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

package/dist/core/tests.js

@@ -38,6 +38,7 @@ import { isMobileTargetPlatform, mobileContextSkipReason, } from "./tests/mobile
 import { detectAndroidSdk } from "../runtime/androidSdk.js";
 import { hostAbi, listInstalledSystemImages, installAndroid, } from "../runtime/androidInstaller.js";
 import { buildAcquireDeviceDeps, checkEmulatorAcceleration, hostHasKvm, planDeviceAcquisition, planAndroidToolchain, normalizeDeviceDescriptor, acquireDevice, createDeviceRegistry, teardownDeviceRegistry, } from "./tests/androidEmulator.js";
+import { buildAcquireSimulatorDeps, planSimulatorAcquisition, acquireSimulator, createSimulatorRegistry, teardownSimulatorRegistry, } from "./tests/iosSimulator.js";
 import { runBrowserScript } from "./tests/runBrowserScript.js";
 import { dragAndDropElement } from "./tests/dragAndDrop.js";
 import { createSessionRegistry, registerSession, activeDriver, sweepSessions, } from "./tests/browserSessions.js";
@@ -409,7 +410,6 @@ async function androidContextPreflight({ config, context, clog, }) {
     if (hasBrowserStep) {
         const { level, reason } = mobileContextSkipReason({
             platform: "android",
-            hasBrowserStep,
         });
         return { ok: false, level, reason };
     }
@@ -569,6 +569,62 @@ async function androidContextPreflight({ config, context, clog, }) {
     }
     /* c8 ignore stop */
 }
+// iOS context preflight (native app phase A4): mobile-browser contexts are
+// still gated to A5; native app contexts probe host capability/toolchain via
+// appSurfacePreflight, then validate that the context's default simulator can
+// be resolved (booted/created) via simctl. On success return the appium
+// entry/home plus the injected simctl effect bundle for the run's
+// acquireSimulator closure.
+async function iosContextPreflight({ config, context, }) {
+    const hasBrowserStep = isBrowserRequired({ test: context });
+    if (hasBrowserStep) {
+        const { level, reason } = mobileContextSkipReason({
+            platform: "ios",
+        });
+        return { ok: false, level, reason };
+    }
+    const pre = await appSurfacePreflight({ config, platform: "ios" });
+    if (!pre.ok)
+        return { ok: false, level: "info", reason: pre.reason };
+    /* c8 ignore start */
+    // The ok path only runs on a capable macOS host (appSurfacePreflight's
+    // probeIosToolchain passed), so the simctl probes below are macOS-only and
+    // never execute in the cross-platform unit suite.
+    const simulatorDeps = buildAcquireSimulatorDeps((m) => log(config, "debug", m));
+    try {
+        const desc = normalizeDeviceDescriptor({
+            contextDevice: context.device,
+            platform: "ios",
+        });
+        const [devices, runtimes, deviceTypes] = await Promise.all([
+            simulatorDeps.listDevices(),
+            simulatorDeps.listRuntimes(),
+            simulatorDeps.listDeviceTypes(),
+        ]);
+        const plan = planSimulatorAcquisition(desc, {
+            devices,
+            runtimes,
+            deviceTypes,
+        });
+        if (plan.action === "skip") {
+            return { ok: false, level: "info", reason: plan.reason };
+        }
+    }
+    catch (error) {
+        return {
+            ok: false,
+            level: "info",
+            reason: `Skipping context on 'ios': couldn't probe the iOS simulator environment (${error?.message ?? error}). Check Xcode / simctl, or run \`doc-detective install ios --yes\`.`,
+        };
+    }
+    return {
+        ok: true,
+        appiumEntry: pre.appiumEntry,
+        appiumHome: pre.appiumHome,
+        simulatorDeps,
+    };
+    /* c8 ignore stop */
+}
 function getDefaultBrowser({ runnerDetails }) {
     let browser = {};
     const browserNames = ["firefox", "chrome", "safari"];
@@ -1245,6 +1301,11 @@ async function runSpecs({ resolvedTests }) {
     // wanting the same device converge on one boot. Swept in the `finally` below —
     // only devices Doc Detective booted are killed (launch-ownership).
     const deviceRegistry = createDeviceRegistry();
+    // Run-level simulator registry (native app phase A4): booted/created iOS
+    // simulators keyed by resolved name, the simctl analogue of deviceRegistry.
+    // Swept in the `finally` below — only simulators Doc Detective booted are
+    // shut down (launch-ownership).
+    const simulatorRegistry = createSimulatorRegistry();
     // Kill every still-registered background process (and its child tree) and
     // remove any deferred temp scripts. Awaits the kills so the process tree is
     // actually gone before the run returns. Idempotent: closeSurface already
@@ -1344,6 +1405,7 @@ async function runSpecs({ resolvedTests }) {
                     warmUpResults,
                     processRegistry,
                     deviceRegistry,
+                    simulatorRegistry,
                     logPrefix: limit > 1 ? `[${job.test.testId}/${job.context.contextId}]` : "",
                 });
             }
@@ -1430,6 +1492,7 @@ async function runSpecs({ resolvedTests }) {
                     warmUpResults,
                     processRegistry,
                     deviceRegistry,
+                    simulatorRegistry,
                     platform,
                     markAutoRecord,
                     limit,
@@ -1495,6 +1558,16 @@ async function runSpecs({ resolvedTests }) {
                 await killTree(entry.process?.pid);
             });
         }
+        // Sweep the iOS simulator registry (native app phase A4): shut down only the
+        // simulators Doc Detective booted (bootedByUs), leaving pre-existing booted
+        // ones running. `simctl shutdown` via the injected effect bundle.
+        if (simulatorRegistry.size > 0) {
+            const simDeps = buildAcquireSimulatorDeps();
+            await teardownSimulatorRegistry(simulatorRegistry, async (entry) => {
+                log(config, "debug", `Shutting down simulator "${entry.name}" (${entry.udid}).`);
+                await simDeps.shutdown(entry);
+            });
+        }
         /* c8 ignore stop */
         process.off("SIGINT", onSignal);
         process.off("SIGTERM", onSignal);
@@ -1560,7 +1633,7 @@ async function runSpecs({ resolvedTests }) {
  * NEVER touches the summary — Phase-3 in runSpecs remains the sole tally site;
  * here we only push reports.
  */
-async function runRoutedSpec({ spec, specReport, specGuardSkip, config, runnerDetails, appiumPool, portToDisplay, metaValues, installAttempts, warmUpResults, processRegistry, deviceRegistry, platform, markAutoRecord, limit, resourceRegistry, exclusivityCtx, }) {
+async function runRoutedSpec({ spec, specReport, specGuardSkip, config, runnerDetails, appiumPool, portToDisplay, metaValues, installAttempts, warmUpResults, processRegistry, deviceRegistry, simulatorRegistry, platform, markAutoRecord, limit, resourceRegistry, exclusivityCtx, }) {
     // Set once a `stop:spec` (or deferred `stop:run`) decision halts the spec; the
     // remaining tests are recorded SKIPPED with the stop reason and not executed.
     let stopRest = false;
@@ -1723,6 +1796,7 @@ async function runRoutedSpec({ spec, specReport, specGuardSkip, config, runnerDe
                     warmUpResults,
                     processRegistry,
                     deviceRegistry,
+                    simulatorRegistry,
                     logPrefix: limit > 1 ? `[${job.test.testId}/${job.context.contextId}]` : "",
                 });
             }
@@ -2288,7 +2362,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
  * report or summary counters — the caller owns aggregation, which keeps this
  * function safe to run concurrently with sibling contexts.
  */
-async function runContext({ config, spec, test, context, runnerDetails, appiumPool, portToDisplay, metaValues, installAttempts, warmUpResults, processRegistry, deviceRegistry, logPrefix = "", }) {
+async function runContext({ config, spec, test, context, runnerDetails, appiumPool, portToDisplay, metaValues, installAttempts, warmUpResults, processRegistry, deviceRegistry, simulatorRegistry, logPrefix = "", }) {
     const platform = runnerDetails.environment.platform;
     // `let`, not `const`: an on-demand browser install below re-detects available
     // apps and reassigns this snapshot.
@@ -2354,45 +2428,59 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
             contextReport.resultDescription = requirementsSkip;
             return contextReport;
         }
-        if (mobileTarget === "ios") {
-            // iOS has no PASS path yet — point at phase A4.
-            const { level, reason } = mobileContextSkipReason({ platform: "ios" });
-            clog(level, reason);
-            contextReport.result = "SKIPPED";
-            contextReport.resultDescription = reason;
-            return contextReport;
+        if (mobileTarget === "android") {
+            // Android (phase A3b): full preflight. SDK detection is lazy (probed
+            // only here, only for android contexts), so a run that never targets
+            // android pays nothing. On skip, land SKIPPED with the actionable reason;
+            // on ok, prime the app session with the device layer and FALL THROUGH to
+            // run the steps.
+            const pre = await androidContextPreflight({ config, context, clog });
+            if (!pre.ok) {
+                clog(pre.level, pre.reason);
+                contextReport.result = "SKIPPED";
+                contextReport.resultDescription = pre.reason;
+                return contextReport;
+            }
+            /* c8 ignore start */
+            // The ok path only runs on a host with a real SDK + emulator (CI legs).
+            appSession = createAppSessionState();
+            appSession.appiumEntry = pre.appiumEntry;
+            appSession.appiumHome = pre.appiumHome;
+            appSession.defaultDevice = context.device;
+            appSession.androidSdkRoot = pre.sdkRoot;
+            appSession.androidDeviceRegistry = deviceRegistry;
+            appSession.androidDeviceDeps = pre.deviceDeps;
+            // resolved device (name) joins the context report the way resolved
+            // browser versions do; the concrete udid is known once a surface boots
+            // it.
+            contextReport.device = context.device ?? { platform: "android" };
+            // Surface any preflight warnings (e.g. a lazy toolchain install) in the
+            // output report — not just the terminal — so a run that quietly
+            // downloaded the multi-GB SDK is auditable after the fact.
+            if (pre.warnings.length)
+                contextReport.warnings = pre.warnings;
+            /* c8 ignore stop */
         }
-        // Android (phase A3b): full preflight. SDK detection is lazy (probed only
-        // here, only for android contexts), so a run that never targets android
-        // pays nothing. On skip, land SKIPPED with the actionable reason; on ok,
-        // prime the app session with the device layer and FALL THROUGH to run the
-        // steps — none of the desktop engine/platform skips below apply to it (the
-        // `!platformMatches` skip is guarded on `!appSession`).
-        const pre = await androidContextPreflight({ config, context, clog });
-        if (!pre.ok) {
-            clog(pre.level, pre.reason);
-            contextReport.result = "SKIPPED";
-            contextReport.resultDescription = pre.reason;
-            return contextReport;
+        else {
+            const pre = await iosContextPreflight({ config, context });
+            if (!pre.ok) {
+                clog(pre.level, pre.reason);
+                contextReport.result = "SKIPPED";
+                contextReport.resultDescription = pre.reason;
+                return contextReport;
+            }
+            /* c8 ignore start */
+            // The ok path only runs on a capable macOS host (CI fixture legs): prime
+            // the app session with the simulator layer and FALL THROUGH to run steps.
+            appSession = createAppSessionState();
+            appSession.appiumEntry = pre.appiumEntry;
+            appSession.appiumHome = pre.appiumHome;
+            appSession.defaultDevice = context.device;
+            appSession.iosSimulatorRegistry = simulatorRegistry;
+            appSession.iosSimulatorDeps = pre.simulatorDeps;
+            contextReport.device = context.device ?? { platform: "ios" };
+            /* c8 ignore stop */
         }
-        /* c8 ignore start */
-        // The ok path only runs on a host with a real SDK + emulator (CI legs).
-        appSession = createAppSessionState();
-        appSession.appiumEntry = pre.appiumEntry;
-        appSession.appiumHome = pre.appiumHome;
-        appSession.defaultDevice = context.device;
-        appSession.androidSdkRoot = pre.sdkRoot;
-        appSession.androidDeviceRegistry = deviceRegistry;
-        appSession.androidDeviceDeps = pre.deviceDeps;
-        // resolved device (name) joins the context report the way resolved browser
-        // versions do; the concrete udid is known once a surface boots it.
-        contextReport.device = context.device ?? { platform: "android" };
-        // Surface any preflight warnings (e.g. a lazy toolchain install) in the
-        // output report — not just the terminal — so a run that quietly downloaded
-        // the multi-GB SDK is auditable after the fact.
-        if (pre.warnings.length)
-            contextReport.warnings = pre.warnings;
-        /* c8 ignore stop */
     }
     // `requires` capability gate: any unmet requirement skips the context with a
     // message naming what's missing. Evaluated only on the platform the context
@@ -3442,9 +3530,12 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
                         return { port: server.port, process: server.process };
                     },
                     startDriver: (capabilities, port) => driverStart(capabilities, port, 2, { cacheDir: config?.cacheDir }),
-                    // Android device acquisition (boot/create-and-boot, or reuse),
-                    // bound to the run-level registry stashed on the app session. Only
-                    // set for android app sessions (which only exist on a capable host).
+                    // Mobile device acquisition (boot/create-and-boot, or reuse), bound
+                    // to the run-level registry stashed on the app session. Android uses
+                    // the emulator layer; iOS uses the simctl simulator layer. Both
+                    // return the same { entry:{name,udid} } | { skip } shape, so
+                    // startAppSurface's mobile branch stays uniform. Only set for a
+                    // mobile app session (which only exists on a capable host).
                     /* c8 ignore start */
                     acquireDevice: appSession?.androidDeviceDeps
                         ? (desc) => acquireDevice({
@@ -3453,7 +3544,13 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
                             sdkRoot: appSession.androidSdkRoot,
                             deps: appSession.androidDeviceDeps,
                         })
-                        : undefined,
+                        : appSession?.iosSimulatorDeps
+                            ? (desc) => acquireSimulator({
+                                desc,
+                                registry: appSession.iosSimulatorRegistry,
+                                deps: appSession.iosSimulatorDeps,
+                            })
+                            : undefined,
                     /* c8 ignore stop */
                 },
             });
@@ -3611,6 +3708,16 @@ async function driverStart(capabilities, port, maxAttempts = 4, ctx = {}) {
     // creation failure and propagates immediately.
     const TRANSIENT = /ECONNREFUSED|ECONNRESET|socket hang up|could not proxy command|crashed during startup|cannot connect to|DevToolsActivePort|session not created/i;
     const wdio = await loadHeavyDep("webdriverio", { ctx });
+    // The wdio client aborts the POST /session request after connectionRetryTimeout.
+    // A cold native session can take far longer to create than the 2-minute
+    // default: the first XCUITest session builds WebDriverAgent via xcodebuild
+    // (several minutes on a fresh macOS runner), and Mac2 builds WebDriverAgentMac
+    // similarly. Derive the client timeout from whatever slow-startup ceiling the
+    // capabilities declared (wdaLaunchTimeout / wdaConnectionTimeout /
+    // serverStartupTimeout) so the client waits as long as the driver was told to,
+    // never below the 2-minute floor. Browser/Windows/Android sessions carry none
+    // of these caps and keep the 2-minute default unchanged.
+    const startupCeiling = Math.max(120000, Number(capabilities?.["appium:wdaLaunchTimeout"]) || 0, Number(capabilities?.["appium:wdaConnectionTimeout"]) || 0, Number(capabilities?.["appium:serverStartupTimeout"]) || 0);
     let lastError;
     for (let attempt = 1; attempt <= maxAttempts; attempt++) {
         try {
@@ -3621,7 +3728,7 @@ async function driverStart(capabilities, port, maxAttempts = 4, ctx = {}) {
                 path: "/",
                 logLevel: "error",
                 capabilities,
-                connectionRetryTimeout: 120000, // 2 minutes
+                connectionRetryTimeout: startupCeiling,
                 waitforTimeout: 120000, // 2 minutes
             });
             // Per-context mutable state. `recordings` lives here (not on config)