doc-detective 4.36.0 → 4.37.1

package/dist/core/annotations/geometry.d.ts

@@ -1,6 +1,6 @@
 import type { ResolvedAnnotation } from "./model.js";
 import type { PlacedAnnotation, Rect } from "./svg.js";
-export { computeScale, toCanvasRect, positionTargetRect, appCriteriaError, allTargetError, appWindowOrigin, resolveAnnotationRects, APP_UNSUPPORTED_CRITERIA, APP_SUPPORTED_CRITERIA, };
+export { computeScale, toCanvasRect, positionTargetRect, appCriteriaError, allTargetError, appWindowOrigin, criteriaFromTarget, resolveAnnotationRects, APP_UNSUPPORTED_CRITERIA, APP_SUPPORTED_CRITERIA, };
 type Point = {
     x: number;
     y: number;
@@ -40,6 +40,7 @@ declare function appWindowOrigin(platform: string | undefined, windowRect: {
 } | null | undefined): Point;
 declare function appCriteriaError(target: any): string | null;
 declare function allTargetError(target: any, all: boolean, isAppCapture?: boolean): string | null;
+declare function criteriaFromTarget(target: any): any;
 /**
  * Resolve every annotation's target into a rect in the final image.
  *

package/dist/core/annotations/geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/core/annotations/geometry.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACvB,CAAC;AAEF,KAAK,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAWtC,QAAA,MAAM,wBAAwB,UAI7B,CAAC;AACF,QAAA,MAAM,sBAAsB,UAK3B,CAAC;AAMF,iBAAS,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CASvE;AAKD,iBAAS,YAAY,CACnB,OAAO,EAAE,IAAI,EACb,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,KAAsB,GACjC,IAAI,CAON;AAOD,iBAAS,kBAAkB,CACzB,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,KAAK,EAAE,MAAM,GACZ,IAAI,CAiBN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,eAAe,CACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACtD,KAAK,CAKP;AAGD,iBAAS,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAYpD;AAaD,iBAAS,cAAc,CACrB,MAAM,EAAE,GAAG,EACX,GAAG,EAAE,OAAO,EACZ,YAAY,UAAQ,GACnB,MAAM,GAAG,IAAI,CASf;AAqDD;;;;;;;GAOG;AACH,iBAAe,sBAAsB,CAAC,EACpC,MAAM,EACN,WAAW,EACX,MAAM,EACN,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,MAAM,EACN,KAAK,EACL,UAAU,GACX,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;IAId,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0G5D"}
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/core/annotations/geometry.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACvB,CAAC;AAEF,KAAK,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAWtC,QAAA,MAAM,wBAAwB,UAI7B,CAAC;AACF,QAAA,MAAM,sBAAsB,UAK3B,CAAC;AAMF,iBAAS,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CASvE;AAKD,iBAAS,YAAY,CACnB,OAAO,EAAE,IAAI,EACb,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,KAAsB,GACjC,IAAI,CAON;AAOD,iBAAS,kBAAkB,CACzB,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,KAAK,EAAE,MAAM,GACZ,IAAI,CAiBN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,eAAe,CACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACtD,KAAK,CAKP;AAGD,iBAAS,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAYpD;AAaD,iBAAS,cAAc,CACrB,MAAM,EAAE,GAAG,EACX,GAAG,EAAE,OAAO,EACZ,YAAY,UAAQ,GACnB,MAAM,GAAG,IAAI,CASf;AAaD,iBAAS,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAY5C;AAsCD;;;;;;;GAOG;AACH,iBAAe,sBAAsB,CAAC,EACpC,MAAM,EACN,WAAW,EACX,MAAM,EACN,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,MAAM,EACN,KAAK,EACL,UAAU,GACX,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;IAId,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0G5D"}

package/dist/core/annotations/geometry.js

@@ -32,7 +32,7 @@
 import { findElement } from "../tests/findElement.js";
 import { findElementByCriteria } from "../tests/findStrategies.js";
 import { anchorPoint } from "./svg.js";
-export { computeScale, toCanvasRect, positionTargetRect, appCriteriaError, allTargetError, appWindowOrigin, resolveAnnotationRects, APP_UNSUPPORTED_CRITERIA, APP_SUPPORTED_CRITERIA, };
+export { computeScale, toCanvasRect, positionTargetRect, appCriteriaError, allTargetError, appWindowOrigin, criteriaFromTarget, resolveAnnotationRects, APP_UNSUPPORTED_CRITERIA, APP_SUPPORTED_CRITERIA, };
 // Criteria with no native-locator equivalent. appSurface.ts maps the semantic
 // fields onto UIA / AX / UiAutomator2 / XCUITest locators, but a CSS selector,
 // a DOM class list, and arbitrary DOM attributes have nothing to map to.
@@ -159,6 +159,15 @@ function allTargetError(target, all, isAppCapture = false) {
 }
 // Turn an annotation target into the criteria object findElement expects.
 // A string target passes straight through as find's selector-or-text shorthand.
+//
+// `timeout` rides along with the finding fields rather than being handled
+// separately, because every consumer below already knows what to do with it:
+// findElement reads `step.find.timeout` on both its browser and app paths, and
+// findElementByCriteria takes it as a parameter. Leaving it out of this list
+// was the only reason annotation targets were pinned to the hardcoded 5000 ms
+// while `find` could ask for longer. Deliberately NOT defaulted here — the
+// number belongs to find, and a copy of it here would be a second thing to
+// keep in sync.
 function criteriaFromTarget(target) {
     if (typeof target === "string")
         return target;
@@ -170,6 +179,7 @@ function criteriaFromTarget(target) {
         elementClass: target?.elementClass,
         elementAttribute: target?.elementAttribute,
         elementAria: target?.elementAria,
+        timeout: target?.timeout,
     };
 }
 // Read a browser element's viewport-relative rect. Mirrors the crop path's

package/dist/core/annotations/geometry.js.map

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

package/dist/core/tests.d.ts

@@ -3,7 +3,7 @@ import { appSurfacePreflight, type AppSessionState } from "./tests/appSurface.js
 import { type ActiveSurfaceTracker } from "./tests/activeSurface.js";
 import { type WarmPlanDeps, type WarmOutcome } from "./warmPhase.js";
 import { acquireDevice, type DeviceRegistry } from "./tests/androidEmulator.js";
-export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, withChromedriverPort, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, jobDisplayResources, buildWarmPlanDeps, warmBrowserInstall, prefetchMobileChromedriver, appiumIsReady, };
+export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, withChromedriverPort, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, resolveRetryPolicy, runContextWithRetries, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, jobDisplayResources, buildWarmPlanDeps, warmBrowserInstall, prefetchMobileChromedriver, appiumIsReady, };
 declare function killTree(pid?: number, timeoutMs?: number): Promise<void>;
 /**
  * Stable identity for a "context combination" — the platform + browser pairing
@@ -92,6 +92,10 @@ declare function resolveBrowserFallbackPolicy({ context, config, }: {
     context: any;
     config: any;
 }): string;
+declare function resolveRetryPolicy({ context, config, }: {
+    context: any;
+    config: any;
+}): number;
 /**
  * Whether to attempt a driver repair before falling back away from a browser
  * whose session just failed to start. We only repair the *requested* engine
@@ -249,6 +253,7 @@ declare function buildAutoRecordStep({ config, spec, test, context, }: {
     test: any;
     context: any;
 }): any | null;
+declare function runContextWithRetries(args: any, runContextFn?: (a: any) => Promise<any>, delayMs?: (attempt: number) => number): Promise<any>;
 declare function runStep({ config, context, step, driver, metaValues, options, processRegistry, appSession, surfaceTracker, }: {
     config?: any;
     context?: 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

@@ -15,7 +15,7 @@ import { requiredBrowserAssets, ensureBrowserInstalled, } from "../runtime/brows
 // Single source of truth for browser/driver-requiring step keys.
 import { BROWSER_STEP_KEYS as driverActions, startSurfaceDescriptors, stepOpensBrowserSurface, stepTargetsProcessSurface, stepIsSurfacelessInteraction, testHasNonBrowserSurfaceSignal, } from "../runtime/browserStepKeys.js";
 import os from "node:os";
-import { log, logLevelEnabled, replaceEnvs, selectSpecsForRun, findFreePort, runConcurrent, runResourceAware, createResourceRegistry, rollUpResults, createAppiumPool, getRunOutputDir, runArchivesArtifacts, sanitizeFilesystemName, evaluateContextRequirements, isRetryableSessionError, realizeViewport, isViewportFloored, } from "./utils.js";
+import { log, logLevelEnabled, replaceEnvs, selectSpecsForRun, findFreePort, runConcurrent, runResourceAware, createResourceRegistry, rollUpResults, createAppiumPool, getRunOutputDir, runArchivesArtifacts, sanitizeFilesystemName, evaluateContextRequirements, isRetryableSessionError, classifyContextRetry, realizeViewport, isViewportFloored, } from "./utils.js";
 import axios from "axios";
 import { instantiateCursor } from "./tests/moveTo.js";
 import { goTo } from "./tests/goTo.js";
@@ -65,7 +65,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, withChromedriverPort, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, jobDisplayResources, buildWarmPlanDeps, warmBrowserInstall, prefetchMobileChromedriver, appiumIsReady, };
+export { runSpecs, runViaApi, getRunner, ensureChromeAvailable, ensureContextBrowserInstalled, combinationKey, warmUpDecision, selectWarmUpTargets, getDriverCapabilities, withChromedriverPort, getDefaultBrowser, buildFallbackCandidates, driverSkipDiagnostic, resolveBrowserFallbackPolicy, resolveRetryPolicy, runContextWithRetries, shouldRepairBeforeFallback, isSupportedContext, contextRequirementsSkipMessage, resolveAutoScreenshot, resolveAutoRecord, buildAutoRecordStep, specIsRouted, killTree, jobDisplayResources, buildWarmPlanDeps, warmBrowserInstall, prefetchMobileChromedriver, appiumIsReady, };
 // exports.driverStart = driverStart;
 // Browser names getDriverCapabilities knows how to build caps for. `safari` is
 // rewritten to `webkit` during context resolution, so both appear here.
@@ -859,6 +859,14 @@ function buildFallbackCandidates({ requestedName, explicit, policy, availableApp
 function resolveBrowserFallbackPolicy({ context, config, }) {
     return context?.browserFallback || config?.browserFallback || "auto";
 }
+// Resolve the mid-run session-death context-retry budget (the `retries` policy):
+// how many times to re-run a whole context on a fresh session when its session
+// dies mid-run. Context overrides config; default 1. Uses `??` (NOT `||`) so an
+// explicit `retries: 0` (disable) is preserved instead of falling through to the
+// default the way a falsy `||` would. Pure and exported for unit testing.
+function resolveRetryPolicy({ context, config, }) {
+    return context?.retries ?? config?.retries ?? 1;
+}
 /**
  * Whether to attempt a driver repair before falling back away from a browser
  * whose session just failed to start. We only repair the *requested* engine
@@ -967,6 +975,8 @@ async function runViaApi({ resolvedTests, apiKey, config = {} }) {
                     contexts: { pass: 0, fail: 0, warning: 0, skipped: 0 },
                     steps: { pass: 0, fail: 0, warning: 0, skipped: 0 },
                 },
+                // Nothing ran, but the shape stays parity with runSpecs' short-circuit.
+                durationMs: 0,
                 specs: [],
             };
         }
@@ -1084,6 +1094,14 @@ async function runViaApi({ resolvedTests, apiKey, config = {} }) {
  */
 async function runSpecs({ resolvedTests }) {
     const config = resolvedTests.config;
+    // Run-level wall clock, scoped to the EXECUTION phase — detection,
+    // resolution, and JIT dependency installs happen in runTests before this
+    // point and are deliberately excluded (see ADR 01083). Started before the
+    // filter short-circuit so a zero-spec run reports a real (tiny) duration
+    // rather than omitting the field. Unlike the spec/test sums, this IS elapsed
+    // time — so under concurrency it can be LESS than the sum of the per-spec
+    // durations.
+    const runStart = Date.now();
     // Narrow the spec set to what specFilter / testFilter allow before running.
     // Filtered-out specs / tests do not appear in the report (true filter, not
     // skip). Pass-through when neither filter is set.
@@ -1104,6 +1122,7 @@ async function runSpecs({ resolvedTests }) {
                 contexts: { pass: 0, fail: 0, warning: 0, skipped: 0 },
                 steps: { pass: 0, fail: 0, warning: 0, skipped: 0 },
             },
+            durationMs: Date.now() - runStart,
             specs: [],
         };
     }
@@ -1632,7 +1651,7 @@ async function runSpecs({ resolvedTests }) {
         // ordering to a single pool over input-ordered jobs.
         const runJob = async (job) => {
             try {
-                job.contexts[job.slot] = await runContext({
+                job.contexts[job.slot] = await runContextWithRetries({
                     config,
                     spec: job.spec,
                     test: job.test,
@@ -1738,7 +1757,9 @@ async function runSpecs({ resolvedTests }) {
         // Phase 3: roll results up the tree and count the summary in one
         // deterministic pass after all contexts have finished.
         for (const specReport of report.specs) {
+            let specDurationMs = 0;
             for (const testReport of specReport.tests) {
+                let testDurationMs = 0;
                 for (const contextReport of testReport.contexts) {
                     // Every slot is assigned by the pool callback (even on crash), so
                     // this guard should never fire — it documents the invariant and
@@ -1747,13 +1768,30 @@ async function runSpecs({ resolvedTests }) {
                         continue;
                     for (const stepReport of contextReport.steps) {
                         report.summary.steps[stepReport.result.toLowerCase()]++;
+                        // Default here rather than at each construction site: this pass is
+                        // the only place that sees EVERY node from both execution paths
+                        // (flat pool and routed sequencer), real and synthetic alike. A
+                        // node that never ran — a guard-skipped context, a routing marker
+                        // — has no clock, and a future synthetic site can't forget the
+                        // field. Nodes that ran keep their measured value (ADR 01083).
+                        stepReport.durationMs ??= 0;
                     }
                     report.summary.contexts[contextReport.result.toLowerCase()]++;
+                    contextReport.durationMs ??= 0;
+                    testDurationMs += contextReport.durationMs;
                 }
                 testReport.result = rollUpResults(testReport.contexts.filter(Boolean));
+                // Test and spec durations are SUMS of their children, not wall-clock
+                // spans: contexts from every test and spec share one concurrent pool,
+                // so a span would count idle time while unrelated specs ran. The sum
+                // is total work — what slow-test triage and JUnit's `<testsuite time>`
+                // both want. See ADR 01083.
+                testReport.durationMs = testDurationMs;
+                specDurationMs += testDurationMs;
                 report.summary.tests[testReport.result.toLowerCase()]++;
             }
             specReport.result = rollUpResults(specReport.tests);
+            specReport.durationMs = specDurationMs;
             report.summary.specs[specReport.result.toLowerCase()]++;
         }
     }
@@ -1830,6 +1868,9 @@ async function runSpecs({ resolvedTests }) {
             };
         }
     }
+    // Stamped last, after teardown and any Heretto upload, so the number matches
+    // the elapsed time a user actually observes.
+    report.durationMs = Date.now() - runStart;
     return report;
 }
 /**
@@ -2017,7 +2058,7 @@ async function runRoutedSpec({ spec, specReport, specGuardSkip, config, runnerDe
         // limit===1 keep the byte-identical runConcurrent path.
         const runRoutedJob = async (job) => {
             try {
-                job.contexts[job.slot] = await runContext({
+                job.contexts[job.slot] = await runContextWithRetries({
                     config,
                     spec: job.spec,
                     test: job.test,
@@ -3300,6 +3341,10 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
     // WARNING when an explicitly pinned engine was substituted.
     let fellBackNote = "";
     let fellBackPinned = false;
+    // Set by the post-loop liveness probe: true when the context failed AND its
+    // session was found dead mid-run. The caller (runContextWithRetries) reads
+    // this off the returned report to decide whether to retry on a fresh session.
+    let sessionDiedMidRun = false;
     if (driverRequired && !appiumPool) {
         throw new Error("Browser driver requested but no Appium server pool was created; " +
             "the pool sizing (browserJobCount) and this context's isBrowserRequired " +
@@ -3864,6 +3909,7 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
             // it. Surface-less browser steps in that (pathological) state fail on the
             // dead session — acceptable; the run closed its own browser mid-test.
             const runStepOnce = async () => {
+                const stepStart = Date.now();
                 const r = await runStep({
                     config: config,
                     context: context,
@@ -3884,7 +3930,12 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
                 r.resultDescription = r.description;
                 delete r.status;
                 delete r.description;
-                return { ...step, ...r };
+                // Stamp AFTER the spread: `step` may carry an authored `duration`
+                // input (a click's press duration, an annotation's display duration),
+                // and `r` is the runStep result — neither may clobber the timing.
+                // On retry the loop below discards this report wholesale, so the
+                // surviving value is the FINAL attempt's, per ADR 01083.
+                return { ...step, ...r, durationMs: Date.now() - stepStart };
             };
             // Run the step, then resolve routing. A `retry` decision re-runs the step
             // (up to `limit` retries — so `limit + 1` total runs — waiting `delay`
@@ -4055,6 +4106,59 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
                 contextReport,
             });
         }
+        // Mid-run session-death detection for the `retries` context-retry policy.
+        // A dead session's step FAIL is indistinguishable from a real assertion FAIL
+        // at the result level (handlers catch driver errors and return FAIL), so if
+        // any step failed we probe the session directly here — while it is still
+        // registered, before the finally tears it down. A dead session means the
+        // FAIL is spurious and the whole context can be retried on a fresh session; a
+        // live session means the FAIL is real and stands. Recording sweeps already
+        // ran above, so the probe never races an in-flight capture.
+        if (contextReport.steps.some((s) => s.result === "FAIL")) {
+            // Collect EVERY session the context holds — a multi-surface browser
+            // context plus an app session — not just the first, so a dead app/native
+            // session behind a live browser (or vice versa) is still caught. Which of
+            // these each check applies to differs, and classifyContextRetry owns that
+            // distinction. Primary session first (Map values() is insertion-ordered).
+            const probeDrivers = sessionDrivers(browserSessions, driver);
+            if (appSession?.recordingHost)
+                probeDrivers.push(appSession.recordingHost);
+            // Which sessions each probe applies to, and how they rank, lives in
+            // classifyContextRetry so it can be unit tested without a real context.
+            // A dead session is the silent case: it needs no explanation beyond the
+            // retry warning the wrapper already logs. The alive-but-unusable cases do,
+            // because "the session responded and we retried anyway" is otherwise
+            // surprising in a log.
+            const retryReason = await classifyContextRetry(probeDrivers);
+            if (retryReason) {
+                sessionDiedMidRun = true;
+                if (retryReason === "page-broken") {
+                    clog("debug", "Context session is alive but on a browser error page; treating it as a broken context for retry.");
+                }
+                else if (retryReason === "unnavigated") {
+                    clog("debug", "Context session is alive but still on its initial blank document (never navigated); treating it as a broken context for retry.");
+                }
+            }
+            if (!sessionDiedMidRun &&
+                probeDrivers.length > 0 &&
+                logLevelEnabled(config, "debug") &&
+                typeof probeDrivers[0].getUrl === "function") {
+                // Diagnostic for whatever live-session modes remain uncovered: log the
+                // page URL of a live-session FAIL that was NOT retried. This is how the
+                // long-running `windows-chrome` flake was characterized — every
+                // occurrence, across both the recording and nav-capture bundles, logged
+                // `url=data:,`, which ADR 01084 now retries. What's left for it to catch
+                // is the same-URL-blank mode (page blanks without changing URL), which
+                // stays unretried because it can't be told apart from a genuine
+                // element-not-found on a correctly-loaded page.
+                try {
+                    clog("debug", `Context FAILed on a live, non-error-page session (url=${await probeDrivers[0].getUrl()}); not retried.`);
+                }
+                catch {
+                    /* best-effort diagnostic */
+                }
+            }
+        }
     }
     finally {
         // Safety net: if the context threw before the normal sweep above, recordings
@@ -4140,8 +4244,108 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
             ? `${fellBackNote} ${contextReport.resultDescription}`
             : fellBackNote;
     }
+    // Internal hint for runContextWithRetries — a FAIL whose session died mid-run
+    // is retryable. Non-enumerable so it never leaks into the serialized report,
+    // and only set on the retryable case so the wrapper's check is a plain read.
+    if (contextReport.result === "FAIL" && sessionDiedMidRun) {
+        Object.defineProperty(contextReport, "_sessionDied", {
+            value: true,
+            enumerable: false,
+            configurable: true,
+        });
+    }
     return contextReport;
 }
+// Context fields runContext mutates non-idempotently: `openApi` appends the
+// config's definitions, and `browser` narrows to a fallback engine/headless
+// mode. A retry re-invokes runContext, so these are snapshotted and restored
+// before each attempt (`__display`/`__displaySize` too, so a retry re-resolves
+// them rather than reusing a stale display) — everything else runContext derives
+// fresh (contextReport is rebuilt each call; step IDs assign idempotently).
+const RUN_CONTEXT_MUTATED_KEYS = ["openApi", "browser", "__display", "__displaySize"];
+// SHALLOW clone — one level. Sufficient for the current RUN_CONTEXT_MUTATED_KEYS
+// (`openApi` entries are appended, never mutated in place; `browser`/`__display*`
+// are flat). If a future mutated field nests a value that runContext mutates *in
+// place*, the snapshot and the live context would share that nested reference and
+// restore wouldn't protect it — deepen this (or that key's snapshot) then.
+function cloneMutable(value) {
+    if (Array.isArray(value))
+        return [...value];
+    if (value && typeof value === "object")
+        return { ...value };
+    return value;
+}
+// Runs a context and retries the WHOLE context on a fresh session when its
+// session dies mid-run — an early step passes, then a later step fails on a
+// now-dead session (WebDriver ECONNREFUSED / invalid session id, or an element
+// that can't be found because the DOM is dead). Bounded by the resolved
+// `retries` policy (config/context, default 1). Detection is runContext's active
+// liveness probe, surfaced as the non-enumerable `_sessionDied` flag on a FAIL
+// report, so a live-session assertion FAIL is NEVER retried — a real bug still
+// fails all attempts. Retrying re-invokes runContext, which re-runs setup,
+// re-provisions every session, and restarts recordings cleanly; the job keeps
+// its concurrency slot and any exclusive resource (display / native-app-driver /
+// android-emulator), so only the Appium pool port churns. `runContextFn` is
+// injectable for unit testing. Exported for that test.
+async function runContextWithRetries(args, runContextFn = runContext, 
+// Backoff before each retry. Injectable so unit tests pass `() => 0` instead
+// of paying the real 500ms-per-attempt sleep.
+delayMs = (attempt) => 500 * (attempt + 1)) {
+    const { context, config } = args;
+    // Time each attempt here rather than inside runContext: runContext has a
+    // dozen exits (eleven early `requires`/preflight SKIPPED returns plus the
+    // normal one), and this wrapper is its only caller, so one clock here stamps
+    // every one of them. A retried context keeps the FINAL attempt's elapsed
+    // time — the attempt the reported `result` describes (ADR 01083).
+    const timedRunContext = async (a) => {
+        const start = Date.now();
+        const report = await runContextFn(a);
+        if (report && typeof report === "object") {
+            report.durationMs = Date.now() - start;
+        }
+        return report;
+    };
+    const retries = resolveRetryPolicy({ context, config });
+    if (!(retries > 0))
+        return timedRunContext(args);
+    // Snapshot the non-idempotent context fields so each retry starts from the
+    // originally-requested state instead of the prior attempt's narrowed one.
+    const had = {};
+    const snapshot = {};
+    for (const key of RUN_CONTEXT_MUTATED_KEYS) {
+        had[key] = key in context;
+        if (had[key])
+            snapshot[key] = cloneMutable(context[key]);
+    }
+    const restore = () => {
+        for (const key of RUN_CONTEXT_MUTATED_KEYS) {
+            if (!had[key])
+                delete context[key];
+            else
+                context[key] = cloneMutable(snapshot[key]);
+        }
+    };
+    let report;
+    let attempt = 0;
+    for (;; attempt++) {
+        report = await timedRunContext(args);
+        const retryable = report?.result === "FAIL" && report?._sessionDied === true;
+        if (!retryable || attempt >= retries)
+            break;
+        log(config, "warning", `Context '${context?.contextId}' session died mid-run; retrying on a fresh session (attempt ${attempt + 2} of ${retries + 1}).`);
+        restore();
+        // Linear backoff (mirrors driverStart's session-creation retry) so a
+        // transient runner blip has a moment to clear before the fresh session.
+        await new Promise((resolve) => setTimeout(resolve, delayMs(attempt)));
+    }
+    // Surface how many retries were spent, so a report consumer can tell a clean
+    // PASS from one recovered after a mid-run session death (the warning log alone
+    // isn't machine-readable). Stamped only when a retry actually happened.
+    if (attempt > 0 && report && typeof report === "object") {
+        report.retries = attempt;
+    }
+    return report;
+}
 // Every live session driver in the context, falling back to the lone default
 // driver when no registry exists (driver-start throw, or a driverless
 // context). Recording sweeps iterate this — recordings live per session.
@@ -4177,6 +4381,10 @@ async function stopAllRecordings({ config, context, driver, contextReport, }) {
             description: "Stopping recording",
             stepId: randomUUID(),
         };
+        // These sweep steps really execute, so they carry a measured duration
+        // rather than the Phase-3 zero default. Timed in both the success and the
+        // failure path, so a stop that hangs before throwing still shows its cost.
+        const stopStart = Date.now();
         try {
             const stepResult = await runStep({
                 config,
@@ -4191,7 +4399,11 @@ async function stopAllRecordings({ config, context, driver, contextReport, }) {
             delete stepResult.description;
             // Don't leak the internal routing marker into the report.
             delete stopRecordStep.__stopAny;
-            contextReport.steps.push({ ...stopRecordStep, ...stepResult });
+            contextReport.steps.push({
+                ...stopRecordStep,
+                ...stepResult,
+                durationMs: Date.now() - stopStart,
+            });
         }
         catch (error) {
             // A throw from runStep would otherwise strand the remaining handles.
@@ -4202,6 +4414,7 @@ async function stopAllRecordings({ config, context, driver, contextReport, }) {
                 ...stopRecordStep,
                 result: "FAIL",
                 resultDescription: `Couldn't stop recording. ${error?.message ?? error}`,
+                durationMs: Date.now() - stopStart,
             });
         }
     }