doc-detective 4.22.0 → 4.23.0

package/dist/core/tests/mobilePlatform.js

@@ -1,37 +1,15 @@
 // 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 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 };
+// identity. Native app contexts (A3/A4) and mobile-web browser contexts (A5)
+// both run on capable hosts; the browser-side decisions (support matrix,
+// device-fixed config rejection, mixed-context deferral) live in
+// mobileBrowser.ts.
+export { isMobileTargetPlatform };
 // Classify a context platform as a mobile target, or null for desktop / junk.
 function isMobileTargetPlatform(platform) {
     if (platform === "android" || platform === "ios")
         return platform;
     return null;
 }
-// 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: "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.
-    return {
-        level: "warning",
-        reason: `Skipping context on 'android': mobile browser testing on Android lands in phase A5 of the native app roadmap (${roadmap}). Native Android app tests (no browser steps) run today.`,
-    };
-}
 //# sourceMappingURL=mobilePlatform.js.map

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,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"}
+{"version":3,"file":"mobilePlatform.js","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,iEAAiE;AACjE,oBAAoB;AAEpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAIlC,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"}

package/dist/core/tests.d.ts

@@ -1,6 +1,6 @@
 import { type BrowserAssetName } from "../runtime/browsers.js";
 import { type AppSessionState } from "./tests/appSurface.js";
-export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, };
+export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, jobDisplayResources, };
 declare function killTree(pid?: number, timeoutMs?: number): Promise<void>;
 /**
  * Stable identity for a "context combination" — the platform + browser pairing
@@ -25,6 +25,12 @@ declare function getDriverCapabilities({ runnerDetails, name, options }: {
     name: any;
     options: any;
 }): any;
+declare function jobDisplayResources(job: any, ctx: {
+    platform: string;
+    xvfbAvailable: boolean;
+    allowOverlappingCaptures?: boolean;
+    runHasDisplayRecording: boolean;
+}): string[];
 declare function isSupportedContext({ context, apps, platform }: {
     context: any;
     apps: any[];

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

@@ -34,7 +34,9 @@ import { clickElement } from "./tests/click.js";
 import { runCode } from "./tests/runCode.js";
 import { closeSurface } from "./tests/closeSurface.js";
 import { createAppSessionState, appSurfacePreflight, isAppDriverRequired, stepTargetsAppSurface, startAppSurface, teardownAppSession, } from "./tests/appSurface.js";
-import { isMobileTargetPlatform, mobileContextSkipReason, } from "./tests/mobilePlatform.js";
+import { isMobileTargetPlatform } from "./tests/mobilePlatform.js";
+import { mobileBrowserGate, buildMobileBrowserCapabilities, } from "./tests/mobileBrowser.js";
+import { getCacheDir } from "../runtime/cacheDir.js";
 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";
@@ -55,7 +57,7 @@ import http from "node:http";
 import https from "node:https";
 import { fileURLToPath } from "node:url";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, };
+export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, jobDisplayResources, };
 // exports.appiumStart = appiumStart;
 // exports.appiumIsReady = appiumIsReady;
 // exports.driverStart = driverStart;
@@ -295,11 +297,18 @@ function jobDisplayResources(job, ctx) {
     // emulator is GBs of RAM, so bound their concurrency to one at a time. This
     // is exclusivity-as-bound on a single resource name (a counted semaphore is
     // future work); it composes with any recording "display" resource above.
-    // Only android contexts that will actually attempt the emulator take it — an
-    // android+browser context deterministically SKIPs (phase A5) before any
-    // emulator/toolchain work, so it must not needlessly serialize other jobs.
+    // Only android contexts that will actually attempt the emulator take it.
+    // Native app contexts always do; a mobile-web context (phase A5) does when
+    // its browser gate proceeds — a context the gate deterministically SKIPs or
+    // FAILs (unsupported browser, mixed app+web, device-fixed config) never
+    // boots anything, so it must not needlessly serialize other jobs.
     const attemptsEmulator = job.context?.platform === "android" &&
-        !isBrowserRequired({ test: job.context });
+        mobileBrowserGate({
+            platform: "android",
+            browser: job.context?.browser,
+            hasBrowserStep: isBrowserRequired({ test: job.context }),
+            hasAppStep: isAppDriverRequired({ test: job.context }),
+        }).action === "proceed";
     const extra = attemptsEmulator ? ["android-emulator"] : [];
     if (base.length || extra.length)
         return [...new Set([...base, ...extra])];
@@ -399,19 +408,29 @@ function requiredAndroidOsVersions(context) {
 }
 // Android context preflight (native app phase A3b): host-capability probe →
 // lazy toolchain install (when the run needs it) → per-device resolvability →
-// UiAutomator2 driver install. Every gap is a gating SKIP (never FAIL). The
+// UiAutomator2 driver install. Every environment gap is a gating SKIP (never
+// FAIL); the one FAIL is authored device-fixed browser config (phase A5 gate),
+// which is a contradiction to surface loudly, not a missing capability. The
 // toolchain (SDK + system image) is NOT installed by default, but IS lazily
 // installed — with a loud warning surfaced to the terminal AND the output
 // report — when a run that reaches a capable host actually needs it. On ok,
 // returns the Appium entry/home, SDK root, injected device-effect bundle, and
 // any warnings to attach to the context report.
 async function androidContextPreflight({ config, context, clog, }) {
-    const hasBrowserStep = isBrowserRequired({ test: context });
-    if (hasBrowserStep) {
-        const { level, reason } = mobileContextSkipReason({
-            platform: "android",
-        });
-        return { ok: false, level, reason };
+    // Mobile-web gate (phase A5) — before ANY toolchain work, so unsupported
+    // browsers, mixed app+web contexts, and device-fixed browser config land
+    // deterministically on every host without touching the SDK.
+    const gate = mobileBrowserGate({
+        platform: "android",
+        browser: context.browser,
+        hasBrowserStep: isBrowserRequired({ test: context }),
+        hasAppStep: isAppDriverRequired({ test: context }),
+    });
+    if (gate.action === "skip") {
+        return { ok: false, level: gate.level, reason: gate.reason };
+    }
+    if (gate.action === "fail") {
+        return { ok: false, level: "warning", reason: gate.reason, fail: true };
     }
     /* c8 ignore start */
     // The rest is effectful (SDK detect/install, emulator probes) so it's
@@ -558,6 +577,7 @@ async function androidContextPreflight({ config, context, clog, }) {
             sdkRoot: sdk.sdkRoot,
             deviceDeps,
             warnings,
+            mobileWebBrowserName: gate.browserName,
         };
     }
     catch (error) {
@@ -569,19 +589,26 @@ 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.
+// iOS context preflight (native app phase A4 + mobile web phase A5): the
+// mobile-browser gate decides first (support matrix / device-fixed config /
+// mixed-context deferral — all pure, all pre-toolchain); then host
+// capability/toolchain probes via appSurfacePreflight, then validation that
+// the context's default simulator can be resolved (booted/created) via
+// simctl. On success return the appium entry/home, the injected simctl effect
+// bundle for the run's acquireSimulator closure, and the device browser (if
+// any) to open a session for.
 async function iosContextPreflight({ config, context, }) {
-    const hasBrowserStep = isBrowserRequired({ test: context });
-    if (hasBrowserStep) {
-        const { level, reason } = mobileContextSkipReason({
-            platform: "ios",
-        });
-        return { ok: false, level, reason };
+    const gate = mobileBrowserGate({
+        platform: "ios",
+        browser: context.browser,
+        hasBrowserStep: isBrowserRequired({ test: context }),
+        hasAppStep: isAppDriverRequired({ test: context }),
+    });
+    if (gate.action === "skip") {
+        return { ok: false, level: gate.level, reason: gate.reason };
+    }
+    if (gate.action === "fail") {
+        return { ok: false, level: "warning", reason: gate.reason, fail: true };
     }
     const pre = await appSurfacePreflight({ config, platform: "ios" });
     if (!pre.ok)
@@ -622,6 +649,7 @@ async function iosContextPreflight({ config, context, }) {
         appiumEntry: pre.appiumEntry,
         appiumHome: pre.appiumHome,
         simulatorDeps,
+        mobileWebBrowserName: gate.browserName,
     };
     /* c8 ignore stop */
 }
@@ -1911,6 +1939,14 @@ function selectWarmUpTargets(jobs, runnerDetails) {
         // would defeat the warm-up/install de-racing the pre-pass exists for.
         if (!context.platform)
             context.platform = platform;
+        // Mobile contexts (android/ios targets) never warm up a desktop engine:
+        // their browser runs ON the device through the per-context app Appium
+        // server (phase A5), so a desktop warm-up would launch the wrong browser
+        // on the wrong machine — and must not write a desktop default browser
+        // onto the context (runContext's mobile branch resolves the device
+        // browser itself).
+        if (isMobileTargetPlatform(context.platform))
+            continue;
         // Size and target the warm-up by isBrowserRequired (not isDriverRequired):
         // app-only contexts run on their own per-context Appium server, so they
         // must not pull a browser into the pre-pass or get a default browser
@@ -2391,8 +2427,13 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
     // If "browser" isn't defined but is required by the test, set it to the
     // first available browser in the sequence of Firefox, Chrome, Safari.
     // App-targeted steps don't count: they run on the app session, so an
-    // app-only test never boots a browser it won't use.
-    if (!context.browser && isBrowserRequired({ test: context })) {
+    // app-only test never boots a browser it won't use. Mobile contexts don't
+    // count either: their browser is the device's (chrome/safari), resolved by
+    // the mobile branch below — a desktop default here would be wrong on both
+    // the engine and the machine.
+    if (!context.browser &&
+        isBrowserRequired({ test: context }) &&
+        !isMobileTargetPlatform(context.platform)) {
         context.browser = getDefaultBrowser({ runnerDetails });
     }
     // Set context report
@@ -2419,6 +2460,11 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
     // context that passes its preflight (phase A3b). Declared here so the mobile
     // branch can set it and fall through to the shared step-execution path.
     let appSession;
+    // Mobile web (phase A5): set when the mobile preflight resolved a device
+    // browser for this context. The try block below then opens the browser
+    // session on the device (through the app session's Appium server) instead
+    // of the desktop engine path.
+    let mobileWebBrowserName;
     const mobileTarget = isMobileTargetPlatform(context.platform);
     if (mobileTarget) {
         const requirementsSkip = contextRequirementsSkipMessage({ context });
@@ -2428,59 +2474,71 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
             contextReport.resultDescription = requirementsSkip;
             return contextReport;
         }
+        // Both preflights run the mobile-browser gate first (support matrix,
+        // device-fixed config, mixed app+web) — `fail: true` marks an authored
+        // contradiction (FAIL loudly); everything else lands SKIPPED. Applied via
+        // this shared closure so the two typed branches below stay narrowed to
+        // their platform's ok-shape (no cross-platform union casts).
+        const gateOutcome = (pre) => {
+            clog(pre.fail ? "error" : pre.level, pre.reason);
+            contextReport.result = pre.fail ? "FAIL" : "SKIPPED";
+            contextReport.resultDescription = pre.reason;
+            return contextReport;
+        };
+        let gateBrowserName;
         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.
+            // Android (phase A3b): SDK detection is lazy (probed only here, only
+            // for android contexts), so a run that never targets android pays
+            // nothing. 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;
-            }
+            if (!pre.ok)
+                return gateOutcome(pre);
             /* 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;
+            gateBrowserName = pre.mobileWebBrowserName;
             /* c8 ignore stop */
         }
         else {
+            // iOS (phase A4): on ok, prime the app session with the simulator layer.
             const pre = await iosContextPreflight({ config, context });
-            if (!pre.ok) {
-                clog(pre.level, pre.reason);
-                contextReport.result = "SKIPPED";
-                contextReport.resultDescription = pre.reason;
-                return contextReport;
-            }
+            if (!pre.ok)
+                return gateOutcome(pre);
             /* 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.
+            // The ok path only runs on a capable macOS host (CI fixture legs).
             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" };
+            gateBrowserName = pre.mobileWebBrowserName;
             /* c8 ignore stop */
         }
+        /* c8 ignore start */
+        appSession.defaultDevice = context.device;
+        // resolved device (name) joins the context report the way resolved
+        // browser versions do; the concrete udid is known once a device boots.
+        contextReport.device = context.device ?? { platform: mobileTarget };
+        if (gateBrowserName) {
+            // Mobile web: pin the context's browser to the device browser the gate
+            // resolved (the authored one, or the platform default) so the report
+            // and the session capabilities agree.
+            mobileWebBrowserName = gateBrowserName;
+            context.browser = { ...(context.browser ?? {}), name: mobileWebBrowserName };
+            contextReport.browser = context.browser;
+        }
+        /* 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
@@ -2609,8 +2667,10 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
         })
         : [];
     // A driver context with no startable engine is skipped with a diagnostic that
-    // names the requested engine and the partial-download cause.
-    if (driverRequired && candidateEngines.length === 0) {
+    // names the requested engine and the partial-download cause. Mobile-web
+    // contexts don't participate: their browser lives on the device, not in the
+    // host's engine list (their session path is the mobile block below).
+    if (driverRequired && !mobileWebBrowserName && candidateEngines.length === 0) {
         const errorMessage = freshInstallRedetected
             ? freshInstallOutcome === "installed"
                 ? `Skipping context '${requestedBrowserName}' on '${context.platform}': the missing browser dependency was installed but still could not be detected.`
@@ -2659,7 +2719,120 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
             "predicate disagreed; this is a bug.");
     }
     try {
-        if (driverRequired) {
+        /* c8 ignore start */
+        // Mobile web (phase A5): only reachable on a capable host (the mobile
+        // preflight gates everything else), so it's exercised by the
+        // mobile-web fixture legs, not the unit suite.
+        if (driverRequired && mobileWebBrowserName) {
+            // The browser session lives ON the managed device, through the app
+            // session's Appium server (homed where the mobile driver lives) — not
+            // the desktop engine pool. Acquire/boot the context's default device,
+            // then open one webdriver session with browserName set so Appium starts
+            // it in a web context; goTo/find/click/screenshot then behave exactly
+            // as on desktop.
+            const env = {
+                APPIUM_HOME: appSession.appiumHome,
+            };
+            if (appSession.androidSdkRoot) {
+                env.ANDROID_HOME = appSession.androidSdkRoot;
+                env.ANDROID_SDK_ROOT = appSession.androidSdkRoot;
+            }
+            // Chromedriver autodownload is an Appium insecure feature; opt in
+            // scoped to the uiautomator2 driver on this run-owned server so it can
+            // fetch the chromedriver matching the device's Chrome.
+            const extraArgs = mobileTarget === "android"
+                ? ["--allow-insecure", "uiautomator2:chromedriver_autodownload"]
+                : [];
+            // Server start + device boot are environment work: any failure there
+            // (port pressure, an emulator that can't finish booting on this host,
+            // simctl trouble) is a gating SKIP with the reason named — never a
+            // FAIL — matching the mobile rule that every environment gap SKIPs.
+            let acquired;
+            try {
+                const server = await startAppiumServer(appSession.appiumEntry, config, undefined, env, extraArgs);
+                appSession.server = { port: server.port, process: server.process };
+                const desc = normalizeDeviceDescriptor({
+                    contextDevice: context.device,
+                    platform: mobileTarget,
+                });
+                acquired =
+                    mobileTarget === "android"
+                        ? await acquireDevice({
+                            desc,
+                            registry: appSession.androidDeviceRegistry,
+                            sdkRoot: appSession.androidSdkRoot,
+                            deps: appSession.androidDeviceDeps,
+                        })
+                        : await acquireSimulator({
+                            desc,
+                            registry: appSession.iosSimulatorRegistry,
+                            deps: appSession.iosSimulatorDeps,
+                        });
+            }
+            catch (error) {
+                const errorMessage = `Skipping context on '${mobileTarget}': couldn't prepare the device for the ${mobileWebBrowserName} session (${error?.message ?? error}). Check the emulator/simulator toolchain (\`doc-detective install ${mobileTarget}\`).`;
+                clog("warning", errorMessage);
+                contextReport.result = "SKIPPED";
+                contextReport.resultDescription = errorMessage;
+                return contextReport;
+            }
+            if ("skip" in acquired) {
+                clog("warning", acquired.skip);
+                contextReport.result = "SKIPPED";
+                contextReport.resultDescription = acquired.skip;
+                return contextReport;
+            }
+            // The resolved device joins the context report the way resolved
+            // browser versions do.
+            contextReport.device = {
+                ...(typeof contextReport.device === "object"
+                    ? contextReport.device
+                    : {}),
+                platform: mobileTarget,
+                name: acquired.entry.name,
+            };
+            const capabilities = buildMobileBrowserCapabilities({
+                platform: mobileTarget,
+                udid: acquired.entry.udid,
+                // The resolved cache root (not the raw config field, which is
+                // usually unset) — the chromedriver autodownload dir lives here.
+                cacheDir: getCacheDir({ cacheDir: config?.cacheDir }),
+            });
+            try {
+                driver = await driverStart(capabilities, appSession.server.port, 2, {
+                    cacheDir: config?.cacheDir,
+                });
+            }
+            catch (error) {
+                // A capable host that can't open the device browser is an
+                // environment gap (the absent-browser precedent): SKIP with the
+                // likely cause named, never FAIL.
+                const hint = mobileTarget === "android"
+                    ? " Chrome may not be present on this emulator image — managed Android mobile-web needs a `google_apis` system image (see `doc-detective install android`)."
+                    : " Check that the simulator runtime includes Safari and that WebDriverAgent can build (see `doc-detective install ios`).";
+                const errorMessage = `Skipping context on '${mobileTarget}': couldn't start the ${mobileWebBrowserName} session on device '${acquired.entry.name}' (${error?.message ?? error}).${hint}`;
+                clog("warning", errorMessage);
+                contextReport.result = "SKIPPED";
+                contextReport.resultDescription = errorMessage;
+                return contextReport;
+            }
+            // Register the device browser as the context's one browser surface so
+            // surface-targeted steps resolve it by engine name, same as desktop.
+            // No additional sessions: one device, one browser.
+            browserSessions = createSessionRegistry({
+                open: async () => {
+                    throw new Error("Additional browser sessions aren't supported on a managed device; the device browser is the context's only browser surface.");
+                },
+                isNameTaken: (name) => !!processRegistry?.has(name),
+            });
+            registerSession(browserSessions, {
+                name: String(mobileWebBrowserName).toLowerCase(),
+                engine: String(mobileWebBrowserName).toLowerCase(),
+                driver,
+            });
+            /* c8 ignore stop */
+        }
+        else if (driverRequired) {
             // Check out a server for this context's lifetime — released in the
             // finally so the next queued context can reuse it.
             appiumPort = await appiumPool.acquire();
@@ -3633,7 +3806,10 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
 // Start one Appium server on a free port and resolve once it answers /status.
 // Each concurrent runner gets its own server (own port) so parallel contexts
 // never create sessions on the same Appium instance.
-async function startAppiumServer(appiumEntry, config, display, extraEnv) {
+async function startAppiumServer(appiumEntry, config, display, extraEnv, 
+// Extra CLI args for the server, e.g. the scoped `--allow-insecure`
+// chromedriver-autodownload opt-in for android mobile-web sessions.
+extraArgs) {
     const port = await findFreePort();
     log(config, "debug", `Starting Appium on port ${port}`);
     // When a virtual display is supplied (Linux Xvfb recording), launch the
@@ -3648,7 +3824,7 @@ async function startAppiumServer(appiumEntry, config, display, extraEnv) {
             ...(extraEnv ?? {}),
         }
         : process.env;
-    const proc = spawn(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(port)], {
+    const proc = spawn(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(port), ...(extraArgs ?? [])], {
         windowsHide: true,
         cwd: path.join(__dirname, "../.."),
         env,