@validate.qa/runner 1.0.67 → 1.0.69

package/dist/cli.mjs

@@ -983,7 +983,7 @@ var require_mobile_source_parser = __commonJS({
       const value = nonEmpty3(attrs.value);
       const label = name ?? labelAttr ?? value;
       const accessibilityId = name;
-      const text = value && value !== label ? value : labelAttr && labelAttr !== label ? labelAttr : void 0;
+      const text = labelAttr ?? (isStateValueRole(role) ? void 0 : value);
       const bounds = parseIOSBounds(attrs);
       const enabled = attrBoolDefaultTrue(attrs.enabled);
       const visible = attrBoolDefaultTrue(attrs.visible);
@@ -1130,6 +1130,42 @@ var require_mobile_source_parser = __commonJS({
         }
       }
     }
+    function annotateIdentityUniqueness(elements) {
+      const a11yCounts = /* @__PURE__ */ new Map();
+      const ridCounts = /* @__PURE__ */ new Map();
+      const textCounts = /* @__PURE__ */ new Map();
+      const bump = (map2, value) => {
+        const key = value?.trim();
+        if (!key)
+          return;
+        map2.set(key, (map2.get(key) ?? 0) + 1);
+      };
+      for (const element of elements) {
+        bump(a11yCounts, element.accessibilityId);
+        bump(ridCounts, element.resourceId);
+        const identityValues = new Set([element.text, element.accessibilityId].map((value) => value?.trim()).filter((value) => Boolean(value)));
+        for (const value of identityValues)
+          bump(textCounts, value);
+      }
+      const isUnique = (map2, value) => {
+        const key = value?.trim();
+        if (!key)
+          return void 0;
+        return (map2.get(key) ?? 0) <= 1;
+      };
+      for (const element of elements) {
+        const accessibilityId = isUnique(a11yCounts, element.accessibilityId);
+        const resourceId = isUnique(ridCounts, element.resourceId);
+        const text = isUnique(textCounts, element.text);
+        if (accessibilityId === void 0 && resourceId === void 0 && text === void 0)
+          continue;
+        element.identityUnique = {
+          ...accessibilityId !== void 0 ? { accessibilityId } : {},
+          ...resourceId !== void 0 ? { resourceId } : {},
+          ...text !== void 0 ? { text } : {}
+        };
+      }
+    }
     function flatten(root, platform3) {
       const out = [];
       const stack = [];
@@ -1175,6 +1211,7 @@ var require_mobile_source_parser = __commonJS({
         }
       }
       markRepeatedBottomBarNavigation(out);
+      annotateIdentityUniqueness(out);
       return out;
     }
     function fnv1a(input) {
@@ -1256,6 +1293,13 @@ var require_mobile_source_parser = __commonJS({
     function isEditableElement(el) {
       return EDITABLE_CLASS_RE.test(el.role.trim());
     }
+    var STATE_VALUE_CLASS_RE = /(XCUIElementTypeSwitch|XCUIElementTypeToggle|XCUIElementTypeSlider|XCUIElementTypeStepper|XCUIElementTypePageIndicator|XCUIElementTypeProgressIndicator|XCUIElementTypeSegmentedControl|XCUIElementTypePicker|XCUIElementTypePickerWheel|ToggleButton|SeekBar|ProgressBar|RatingBar|NumberPicker)$/;
+    function isStateValueRole(role) {
+      return STATE_VALUE_CLASS_RE.test(role.trim());
+    }
+    function isStateValueElement(el) {
+      return isStateValueRole(el.role);
+    }
     function xpathAttrLiteral(value) {
       if (!value.includes("'"))
         return `'${value}'`;
@@ -1266,17 +1310,18 @@ var require_mobile_source_parser = __commonJS({
     function semanticXPath(el, platform3) {
       const cls = nonBlank(el.role) ?? "*";
       const a11y = nonBlank(el.accessibilityId);
-      if (a11y) {
-        return platform3 === "ANDROID" ? `//${cls}[@content-desc=${xpathAttrLiteral(a11y)}]` : `//${cls}[@name=${xpathAttrLiteral(a11y)}]`;
-      }
-      const rid = nonBlank(el.resourceId);
-      if (platform3 === "ANDROID" && rid)
-        return `//${cls}[@resource-id=${xpathAttrLiteral(rid)}]`;
-      const text = nonBlank(el.text);
-      if (text && !isEditableElement(el)) {
-        return platform3 === "ANDROID" ? `//${cls}[@text=${xpathAttrLiteral(text)}]` : `//${cls}[@label=${xpathAttrLiteral(text)}]`;
-      }
-      return void 0;
+      const rid = platform3 === "ANDROID" ? nonBlank(el.resourceId) : void 0;
+      const text = isEditableElement(el) || isStateValueElement(el) ? void 0 : nonBlank(el.text);
+      const a11yXpath = a11y ? platform3 === "ANDROID" ? `//${cls}[@content-desc=${xpathAttrLiteral(a11y)}]` : `//${cls}[@name=${xpathAttrLiteral(a11y)}]` : void 0;
+      const ridXpath = rid ? `//${cls}[@resource-id=${xpathAttrLiteral(rid)}]` : void 0;
+      const textXpath = text ? platform3 === "ANDROID" ? `//${cls}[@text=${xpathAttrLiteral(text)}]` : `//${cls}[@label=${xpathAttrLiteral(text)}]` : void 0;
+      const candidates = [
+        { xpath: a11yXpath, unique: el.identityUnique?.accessibilityId },
+        { xpath: ridXpath, unique: el.identityUnique?.resourceId },
+        { xpath: textXpath, unique: el.identityUnique?.text }
+      ];
+      const uniqueFirst = candidates.find((c) => c.xpath && c.unique !== false);
+      return (uniqueFirst ?? candidates.find((c) => c.xpath))?.xpath;
     }
     function nonBlank(value) {
       if (typeof value !== "string")
@@ -1285,30 +1330,40 @@ var require_mobile_source_parser = __commonJS({
       return trimmed.length > 0 ? trimmed : void 0;
     }
     function buildLocatorBundle(el, platform3) {
+      const durableText = el.text && !isEditableElement(el) && !isStateValueElement(el) ? el.text : void 0;
       const bundle = {
         // Attribute-anchored xpath when the element has identity; the absolute
         // indexed path only for identity-less elements (nothing else can find them).
         xpath: semanticXPath(el, platform3) ?? el.xpath,
         className: el.role
       };
-      if (el.accessibilityId)
+      const a11yUnique = el.identityUnique?.accessibilityId !== false;
+      const ridUnique = el.identityUnique?.resourceId !== false;
+      const textUnique = el.identityUnique?.text !== false;
+      const hasUniqueAlternativeToA11y = Boolean(el.resourceId && platform3 === "ANDROID" && ridUnique || durableText && textUnique);
+      const hasUniqueAlternativeToRid = Boolean(el.accessibilityId && a11yUnique || durableText && textUnique);
+      const includeA11y = Boolean(el.accessibilityId && (a11yUnique || !hasUniqueAlternativeToA11y));
+      const includeRid = Boolean(platform3 === "ANDROID" && el.resourceId && (ridUnique || !hasUniqueAlternativeToRid));
+      if (includeA11y && el.accessibilityId)
         bundle.accessibilityId = el.accessibilityId;
-      if (platform3 === "ANDROID" && el.resourceId)
+      if (includeRid && el.resourceId)
         bundle.resourceId = el.resourceId;
-      if (el.text && !isEditableElement(el))
-        bundle.text = el.text;
-      if (platform3 === "ANDROID" && el.accessibilityId)
+      if (durableText)
+        bundle.text = durableText;
+      if (includeA11y && platform3 === "ANDROID" && el.accessibilityId)
         bundle.contentDesc = el.accessibilityId;
       return bundle;
     }
     function preferredLocator(el) {
-      if (el.accessibilityId)
-        return el.accessibilityId;
-      if (el.resourceId)
-        return el.resourceId;
-      if (el.text && !isEditableElement(el))
-        return el.text;
-      return el.xpath;
+      const durableText = el.text && !isEditableElement(el) && !isStateValueElement(el) ? el.text : void 0;
+      const candidates = [
+        { value: el.accessibilityId, unique: el.identityUnique?.accessibilityId },
+        { value: el.resourceId, unique: el.identityUnique?.resourceId },
+        { value: durableText, unique: el.identityUnique?.text }
+      ];
+      const uniqueFirst = candidates.find((c) => c.value && c.unique !== false);
+      const chosen = (uniqueFirst ?? candidates.find((c) => c.value))?.value;
+      return chosen ?? el.xpath;
     }
     function buildScreenSignal(elements, root, platform3) {
       const signal = {
@@ -1971,6 +2026,11 @@ function isEditableMobileClassName(className) {
     return false;
   return /(EditText|AutoCompleteTextView|XCUIElementTypeTextField|XCUIElementTypeSecureTextField|XCUIElementTypeSearchField|XCUIElementTypeTextView)$/.test(className.trim());
 }
+function isStateValueMobileClassName(className) {
+  if (!className)
+    return false;
+  return /(XCUIElementTypeSwitch|XCUIElementTypeToggle|XCUIElementTypeSlider|XCUIElementTypeStepper|XCUIElementTypePageIndicator|XCUIElementTypeProgressIndicator|XCUIElementTypeSegmentedControl|XCUIElementTypePicker|XCUIElementTypePickerWheel|ToggleButton|SeekBar|ProgressBar|RatingBar|NumberPicker)$/.test(className.trim());
+}
 function mobileCredentialPlaceholder(key) {
   return `{{${key}}}`;
 }
@@ -2100,9 +2160,10 @@ function buildStepTarget(metadata, selector) {
     locatorBundle.resourceId,
     // For editable fields the text attribute IS the currently-typed value — a
     // self-invalidating locator that only matches while the recorded text is
-    // still in the field (and it can leak typed input into locators). Static
-    // elements keep their text fallback.
-    isEditableMobileClassName(locatorBundle.className) ? void 0 : locatorBundle.text,
+    // still in the field (and it can leak typed input into locators). State
+    // controls' text is their current state ("1"/"ON") and collides with every
+    // same-state sibling. Static elements keep their text fallback.
+    isEditableMobileClassName(locatorBundle.className) || isStateValueMobileClassName(locatorBundle.className) ? void 0 : locatorBundle.text,
     locatorBundle.contentDesc,
     locatorBundle.xpath,
     selector
@@ -2258,7 +2319,9 @@ function mobileLocatorBundleHasIdentity(bundle) {
     return false;
   if (nonEmpty(bundle.accessibilityId) || nonEmpty(bundle.resourceId))
     return true;
-  if (nonEmpty(bundle.text) || nonEmpty(bundle.contentDesc))
+  if (nonEmpty(bundle.text) && !isStateValueMobileClassName(bundle.className))
+    return true;
+  if (nonEmpty(bundle.contentDesc))
     return true;
   const xpath = nonEmpty(bundle.xpath);
   return !!xpath && isIdentityMobileXpath(xpath);
@@ -2279,23 +2342,27 @@ function selectorCandidatesForStep(step) {
       candidates.push(`~${bundle.accessibilityId}`);
     if (nonEmpty(bundle.resourceId))
       candidates.push(`id=${bundle.resourceId}`);
+    if (nonEmpty(bundle.xpath))
+      candidates.push(bundle.xpath);
     const isGateStep = step.action === "waitForElement" || step.action === "assertVisible" || step.action === "assertText";
-    const textIdentity = isGateStep || !isEditableMobileClassName(bundle.className) ? bundle.text : void 0;
+    const textIdentity = (isGateStep || !isEditableMobileClassName(bundle.className)) && !isStateValueMobileClassName(bundle.className) ? bundle.text : void 0;
     for (const value of [textIdentity, bundle.contentDesc]) {
       const trimmed = nonEmpty(value);
       if (trimmed)
         candidates.push(identityTextXpath(trimmed));
     }
-    if (nonEmpty(bundle.xpath))
-      candidates.push(bundle.xpath);
   }
   const hasExplicitResourceId = !!nonEmpty(bundle?.resourceId);
+  const bundleContributedIdentity = candidates.some((value) => !(value.startsWith("/") || value.startsWith("(//")) || isIdentityMobileXpath(value));
   const pushValueCandidates = (value) => {
     candidates.push(selectorForValue(value));
     const looksLikeIdToken = /^[A-Za-z_][\w.:-]*$/.test(value);
     if (!hasExplicitResourceId && looksLikeIdToken && !/^(~|id=|css=|\/|\()/.test(value) && !value.includes(":id/")) {
       candidates.push(`id=${value}`);
     }
+    if (!bundleContributedIdentity && !/^(~|id=|css=|\/|\()/.test(value)) {
+      candidates.push(identityTextXpath(value));
+    }
   };
   if (nonEmpty(target.primary))
     pushValueCandidates(target.primary);
@@ -2990,7 +3057,8 @@ function isWebViewStep(step) {
 function hasCrossPlatformIdentity(bundle) {
   if (!bundle)
     return false;
-  return Boolean(bundle.text?.trim() || bundle.contentDesc?.trim() || bundle.accessibilityId?.trim());
+  const durableText = isStateValueMobileClassName(bundle.className) ? void 0 : bundle.text;
+  return Boolean(durableText?.trim() || bundle.contentDesc?.trim() || bundle.accessibilityId?.trim());
 }
 function stepIsDivergentForPlatform(step, platform3) {
   return Array.isArray(step.crossPlatformDivergent) && step.crossPlatformDivergent.includes(platform3);
@@ -3072,7 +3140,8 @@ function summarizeMobileReadiness(steps, authoringPlatform) {
 function hasStableNativeIdentity(bundle) {
   if (!bundle)
     return false;
-  return Boolean(bundle.accessibilityId?.trim() || bundle.resourceId?.trim() || bundle.text?.trim() || bundle.contentDesc?.trim() || bundle.xpath?.trim() && XPATH_ATTRIBUTE_EQUALITY_RE.test(bundle.xpath) && !/(?:contains|starts-with)\s*\(/i.test(bundle.xpath));
+  const durableText = isStateValueMobileClassName(bundle.className) ? void 0 : bundle.text;
+  return Boolean(bundle.accessibilityId?.trim() || bundle.resourceId?.trim() || durableText?.trim() || bundle.contentDesc?.trim() || bundle.xpath?.trim() && XPATH_ATTRIBUTE_EQUALITY_RE.test(bundle.xpath) && !/(?:contains|starts-with)\s*\(/i.test(bundle.xpath));
 }
 function isPositionalXpath(xpath) {
   const value = xpath?.trim();
@@ -3152,6 +3221,7 @@ var MOBILE_PLATFORMS, LOCATOR_REQUIRING_ACTIONS, XPATH_ATTRIBUTE_EQUALITY_RE;
 var init_mobile_cross_platform = __esm({
   "../shared/dist/mobile-cross-platform.js"() {
     "use strict";
+    init_mobile_test_generation();
     MOBILE_PLATFORMS = ["IOS", "ANDROID"];
     LOCATOR_REQUIRING_ACTIONS = /* @__PURE__ */ new Set([
       "tap",
@@ -6154,6 +6224,7 @@ __export(dist_exports, {
   isEditableMobileClassName: () => isEditableMobileClassName,
   isEmailFromIdentity: () => isEmailFromIdentity,
   isEnvironmentalError: () => isEnvironmentalError,
+  isIdentityMobileXpath: () => isIdentityMobileXpath,
   isMobilePlatform: () => isMobilePlatform,
   isPricingPlan: () => isPricingPlan,
   isRunnableStep: () => isRunnableStep,
@@ -6161,6 +6232,7 @@ __export(dist_exports, {
   isSameRegistrableDomainHost: () => isSameRegistrableDomainHost,
   isSensitiveQueryKey: () => isSensitiveQueryKey,
   isSharedAuthInjectEnabled: () => isSharedAuthInjectEnabled,
+  isStateValueMobileClassName: () => isStateValueMobileClassName,
   isSttModelForProvider: () => isSttModelForProvider,
   isTestReadyForPlatform: () => isTestReadyForPlatform,
   isTrialExpired: () => isTrialExpired,
@@ -7068,6 +7140,7 @@ var require_mobile_observation = __commonJS({
     exports.buildCollectedElementsForScreen = buildCollectedElementsForScreen;
     exports.extractNativeMobileLandmarks = extractNativeMobileLandmarks;
     exports.safeMobileElementLabel = safeMobileElementLabel;
+    var mobile_source_parser_js_1 = require_mobile_source_parser();
     var DEFAULT_MAX_ELEMENTS = 60;
     var MAX_LABEL_LENGTH = 80;
     var EVIDENCE_LABEL_LIMIT = 40;
@@ -7158,7 +7231,8 @@ var require_mobile_observation = __commonJS({
       const locators = [];
       if (stableId)
         locators.push({ strategy: "getByTestId", value: stableId, confidence: 0.95 });
-      const xpath = element.xpath?.trim();
+      const platform3 = element.role.startsWith("XCUIElementType") ? "IOS" : "ANDROID";
+      const xpath = (0, mobile_source_parser_js_1.buildLocatorBundle)(element, platform3).xpath?.trim();
       if (xpath)
         locators.push({ strategy: "css", value: xpath, confidence: 0.4 });
       const collected = {
@@ -11224,7 +11298,7 @@ var require_thread_stream = __commonJS({
     var { version } = require_package();
     var { EventEmitter: EventEmitter2 } = __require("events");
     var { Worker } = __require("worker_threads");
-    var { join: join7 } = __require("path");
+    var { join: join8 } = __require("path");
     var { pathToFileURL } = __require("url");
     var { wait } = require_wait();
     var {
@@ -11275,7 +11349,7 @@ var require_thread_stream = __commonJS({
     function createWorker(stream, opts) {
       const { filename, workerData } = opts;
       const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
-      const toExecute = bundlerOverrides["thread-stream-worker"] || join7(__dirname, "lib", "worker.js");
+      const toExecute = bundlerOverrides["thread-stream-worker"] || join8(__dirname, "lib", "worker.js");
       const worker = new Worker(toExecute, {
         ...opts.workerOpts,
         name: opts.workerOpts?.name || "thread-stream",
@@ -11743,7 +11817,7 @@ var require_transport = __commonJS({
     var { createRequire } = __require("module");
     var { existsSync: existsSync3 } = __require("fs");
     var getCallers = require_caller();
-    var { join: join7, isAbsolute, sep } = __require("path");
+    var { join: join8, isAbsolute: isAbsolute2, sep } = __require("path");
     var { fileURLToPath } = __require("url");
     var sleep = require_atomic_sleep();
     var onExit = require_on_exit_leak_free();
@@ -11815,7 +11889,7 @@ var require_transport = __commonJS({
           return false;
         }
       }
-      return isAbsolute(path) && !existsSync3(path);
+      return isAbsolute2(path) && !existsSync3(path);
     }
     function stripQuotes(value) {
       const first = value[0];
@@ -11896,7 +11970,7 @@ var require_transport = __commonJS({
         throw new Error("only one of target or targets can be specified");
       }
       if (targets) {
-        target = bundlerOverrides["pino-worker"] || join7(__dirname, "worker.js");
+        target = bundlerOverrides["pino-worker"] || join8(__dirname, "worker.js");
         options.targets = targets.filter((dest) => dest.target).map((dest) => {
           return {
             ...dest,
@@ -11914,7 +11988,7 @@ var require_transport = __commonJS({
           });
         });
       } else if (pipeline) {
-        target = bundlerOverrides["pino-worker"] || join7(__dirname, "worker.js");
+        target = bundlerOverrides["pino-worker"] || join8(__dirname, "worker.js");
         options.pipelines = [pipeline.map((dest) => {
           return {
             ...dest,
@@ -11933,11 +12007,11 @@ var require_transport = __commonJS({
       return buildStream(fixTarget(target), options, worker, sync, name);
       function fixTarget(origin) {
         origin = bundlerOverrides[origin] || origin;
-        if (isAbsolute(origin) || origin.indexOf("file://") === 0) {
+        if (isAbsolute2(origin) || origin.indexOf("file://") === 0) {
           return origin;
         }
         if (origin === "pino/file") {
-          return join7(__dirname, "..", "file.js");
+          return join8(__dirname, "..", "file.js");
         }
         let fixTarget2;
         for (const filePath of callers) {
@@ -12918,7 +12992,7 @@ var require_safe_stable_stringify = __commonJS({
               return circularValue;
             }
             let res = "";
-            let join7 = ",";
+            let join8 = ",";
             const originalIndentation = indentation;
             if (Array.isArray(value)) {
               if (value.length === 0) {
@@ -12932,7 +13006,7 @@ var require_safe_stable_stringify = __commonJS({
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join7 = `,
+                join8 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -12940,13 +13014,13 @@ ${indentation}`;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
                 res += tmp2 !== void 0 ? tmp2 : "null";
-                res += join7;
+                res += join8;
               }
               const tmp = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
               res += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res += `${join7}"... ${getItemCount(removedKeys)} not stringified"`;
+                res += `${join8}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               if (spacer !== "") {
                 res += `
@@ -12967,7 +13041,7 @@ ${originalIndentation}`;
             let separator = "";
             if (spacer !== "") {
               indentation += spacer;
-              join7 = `,
+              join8 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -12981,13 +13055,13 @@ ${indentation}`;
               const tmp = stringifyFnReplacer(key2, value, stack, replacer, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-                separator = join7;
+                separator = join8;
               }
             }
             if (keyLength > maximumBreadth) {
               const removedKeys = keyLength - maximumBreadth;
               res += `${separator}"...":${whitespace}"${getItemCount(removedKeys)} not stringified"`;
-              separator = join7;
+              separator = join8;
             }
             if (spacer !== "" && separator.length > 1) {
               res = `
@@ -13028,7 +13102,7 @@ ${originalIndentation}`;
             }
             const originalIndentation = indentation;
             let res = "";
-            let join7 = ",";
+            let join8 = ",";
             if (Array.isArray(value)) {
               if (value.length === 0) {
                 return "[]";
@@ -13041,7 +13115,7 @@ ${originalIndentation}`;
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join7 = `,
+                join8 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -13049,13 +13123,13 @@ ${indentation}`;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
                 res += tmp2 !== void 0 ? tmp2 : "null";
-                res += join7;
+                res += join8;
               }
               const tmp = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
               res += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res += `${join7}"... ${getItemCount(removedKeys)} not stringified"`;
+                res += `${join8}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               if (spacer !== "") {
                 res += `
@@ -13068,7 +13142,7 @@ ${originalIndentation}`;
             let whitespace = "";
             if (spacer !== "") {
               indentation += spacer;
-              join7 = `,
+              join8 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -13077,7 +13151,7 @@ ${indentation}`;
               const tmp = stringifyArrayReplacer(key2, value[key2], stack, replacer, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-                separator = join7;
+                separator = join8;
               }
             }
             if (spacer !== "" && separator.length > 1) {
@@ -13135,20 +13209,20 @@ ${originalIndentation}`;
               indentation += spacer;
               let res2 = `
 ${indentation}`;
-              const join8 = `,
+              const join9 = `,
 ${indentation}`;
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
               let i = 0;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyIndent(String(i), value[i], stack, spacer, indentation);
                 res2 += tmp2 !== void 0 ? tmp2 : "null";
-                res2 += join8;
+                res2 += join9;
               }
               const tmp = stringifyIndent(String(i), value[i], stack, spacer, indentation);
               res2 += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res2 += `${join8}"... ${getItemCount(removedKeys)} not stringified"`;
+                res2 += `${join9}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               res2 += `
 ${originalIndentation}`;
@@ -13164,16 +13238,16 @@ ${originalIndentation}`;
               return '"[Object]"';
             }
             indentation += spacer;
-            const join7 = `,
+            const join8 = `,
 ${indentation}`;
             let res = "";
             let separator = "";
             let maximumPropertiesToStringify = Math.min(keyLength, maximumBreadth);
             if (isTypedArrayWithEntries(value)) {
-              res += stringifyTypedArray(value, join7, maximumBreadth);
+              res += stringifyTypedArray(value, join8, maximumBreadth);
               keys = keys.slice(value.length);
               maximumPropertiesToStringify -= value.length;
-              separator = join7;
+              separator = join8;
             }
             if (deterministic) {
               keys = sort(keys, comparator);
@@ -13184,13 +13258,13 @@ ${indentation}`;
               const tmp = stringifyIndent(key2, value[key2], stack, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}: ${tmp}`;
-                separator = join7;
+                separator = join8;
               }
             }
             if (keyLength > maximumBreadth) {
               const removedKeys = keyLength - maximumBreadth;
               res += `${separator}"...": "${getItemCount(removedKeys)} not stringified"`;
-              separator = join7;
+              separator = join8;
             }
             if (separator !== "") {
               res = `
@@ -61866,11 +61940,11 @@ var require_core = __commonJS({
     function mapOuter(r, f) {
       return r.matched ? f(r) : r;
     }
-    function ab(pa, pb, join7) {
-      return (data, i) => mapOuter(pa(data, i), (ma) => mapInner(pb(data, ma.position), (vb, j) => join7(ma.value, vb, data, i, j)));
+    function ab(pa, pb, join8) {
+      return (data, i) => mapOuter(pa(data, i), (ma) => mapInner(pb(data, ma.position), (vb, j) => join8(ma.value, vb, data, i, j)));
     }
-    function abc(pa, pb, pc, join7) {
-      return (data, i) => mapOuter(pa(data, i), (ma) => mapOuter(pb(data, ma.position), (mb) => mapInner(pc(data, mb.position), (vc, j) => join7(ma.value, mb.value, vc, data, i, j))));
+    function abc(pa, pb, pc, join8) {
+      return (data, i) => mapOuter(pa(data, i), (ma) => mapOuter(pb(data, ma.position), (mb) => mapInner(pc(data, mb.position), (vc, j) => join8(ma.value, mb.value, vc, data, i, j))));
     }
     function action(f) {
       return (data, i) => {
@@ -78407,6 +78481,10 @@ var require_discover_ai_planner = __commonJS({
       if (context.appBrief) {
         sections.push(`## Application Brief
 ${context.appBrief.slice(0, 500)}`);
+      }
+      if (context.knowledgeContext && context.knowledgeContext.trim().length > 0) {
+        sections.push(`## Known Facts
+${context.knowledgeContext.slice(0, 4e3)}`);
       }
       sections.push(`## Base URL
 ${compressed.baseUrl}`);
@@ -83451,48 +83529,29 @@ ${statePacket}`, redactionCredentials) },
         log2("  app data reset skipped by policy \u2014 scenario records after relaunch with preserved data.");
         return applyScenarioEntryDeepLink(driver, target, { appDataCleared: false, coldResetUnavailable: false, refuseGenerate: false, reason: "preserve_policy" }, log2);
       }
-      if (platform3 !== "IOS") {
-        const appDataCleared = await driver.resetAppState?.().catch((err) => {
-          log2(`  app-data reset failed: ${err instanceof Error ? err.message : String(err)}`);
-          return false;
-        }) ?? false;
-        if (appDataCleared) {
-          return applyScenarioEntryDeepLink(driver, target, { appDataCleared: true, coldResetUnavailable: false, refuseGenerate: false }, log2);
-        }
-        await driver.relaunch();
-        if (resetPolicy === "CLEAR_APP_DATA") {
-          log2("  CLEAR_APP_DATA required but app-data reset was unavailable \u2014 refusing to generate from warm state.");
-          return {
-            appDataCleared: false,
-            coldResetUnavailable: true,
-            refuseGenerate: true,
-            reason: "clear_app_data_unavailable"
-          };
-        }
-        log2("  app-data reset unavailable \u2014 generating with @warm-state (relaunch only; may not match cold-boot replay).");
-        return applyScenarioEntryDeepLink(driver, target, {
-          appDataCleared: false,
-          coldResetUnavailable: true,
-          refuseGenerate: false,
-          reason: platform3 === "ANDROID" ? "android_reset_unavailable" : "reset_unavailable"
-        }, log2);
+      const appDataCleared = await driver.resetAppState?.().catch((err) => {
+        log2(`  app-data reset failed: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+      }) ?? false;
+      if (appDataCleared) {
+        return applyScenarioEntryDeepLink(driver, target, { appDataCleared: true, coldResetUnavailable: false, refuseGenerate: false }, log2);
       }
       await driver.relaunch();
       if (resetPolicy === "CLEAR_APP_DATA") {
-        log2("  CLEAR_APP_DATA required but iOS has no supported clearApp primitive \u2014 refusing to generate from warm state.");
+        log2(platform3 === "IOS" ? "  CLEAR_APP_DATA required but this iOS device cannot be cleared (simulator required) \u2014 refusing to generate from warm state." : "  CLEAR_APP_DATA required but app-data reset was unavailable \u2014 refusing to generate from warm state.");
         return {
           appDataCleared: false,
           coldResetUnavailable: true,
           refuseGenerate: true,
-          reason: "ios_clear_app_data_unavailable"
+          reason: platform3 === "IOS" ? "ios_clear_app_data_unavailable" : "clear_app_data_unavailable"
         };
       }
-      log2("  iOS has no clearApp \u2014 scenario records after relaunch (warm-state risk for auth flows).");
+      log2(platform3 === "IOS" ? "  iOS app-data reset unavailable (physical device or simctl failure) \u2014 generating with @warm-state (relaunch only; may not match cold-boot replay)." : "  app-data reset unavailable \u2014 generating with @warm-state (relaunch only; may not match cold-boot replay).");
       return applyScenarioEntryDeepLink(driver, target, {
         appDataCleared: false,
         coldResetUnavailable: true,
         refuseGenerate: false,
-        reason: "ios_no_clear_app"
+        reason: platform3 === "IOS" ? "ios_no_clear_app" : platform3 === "ANDROID" ? "android_reset_unavailable" : "reset_unavailable"
       }, log2);
     }
     async function runMobileGeneratePhase(args) {
@@ -88953,7 +89012,7 @@ var require_kill_tree = __commonJS({
     var node_child_process_1 = __require("child_process");
     var node_util_1 = __require("util");
     var node_fs_1 = __require("fs");
-    var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    var execFileAsync4 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var PS_TIMEOUT_MS = 2e3;
     var PS_BUFFER = 1024 * 1024;
     async function gracefulCloseWithTreeKill(options) {
@@ -89007,7 +89066,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid=,command="], {
+        const result = await execFileAsync4("ps", ["-A", "-o", "pid=,ppid=,command="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -89045,7 +89104,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid=,command="], {
+        const result = await execFileAsync4("ps", ["-A", "-o", "pid=,ppid=,command="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -89122,7 +89181,7 @@ var require_kill_tree = __commonJS({
       timer.unref?.();
       let stdout;
       try {
-        const result = await execFileAsync3("ps", ["-A", "-o", "pid=,ppid="], {
+        const result = await execFileAsync4("ps", ["-A", "-o", "pid=,ppid="], {
           maxBuffer: PS_BUFFER,
           signal: controller.signal
         });
@@ -92288,6 +92347,15 @@ var require_agentic_discovery_prompts = __commonJS({
         lines.push(input.appBrief.trim());
         lines.push("");
       }
+      if (input.knownFactsBlock && input.knownFactsBlock.trim()) {
+        lines.push("## Known facts about this feature (from project documentation)");
+        lines.push("");
+        lines.push("Advisory hints about routes/data/constraints \u2014 verify against the live");
+        lines.push("app; the browser is the source of truth for locators.");
+        lines.push("");
+        lines.push(input.knownFactsBlock.trim());
+        lines.push("");
+      }
       if (input.credentials && input.credentials.length > 0) {
         lines.push("## Test credentials (throwaway accounts)");
         lines.push("");
@@ -98663,8 +98731,8 @@ Do NOT add steps you did not execute. Do NOT skip steps from the recording.${led
               onRetry: (attempt, reason, delayMs) => logs2.push(`    \u26A0 scenario-gen AI call retry ${attempt} (${reason}) \u2014 waiting ${delayMs}ms`)
             });
           } catch (aiErr) {
-            const errMsg2 = aiErr instanceof Error ? aiErr.message : String(aiErr);
-            logs2.push(`    AI call failed at iteration ${iteration} (after retries): ${errMsg2}`);
+            const errMsg3 = aiErr instanceof Error ? aiErr.message : String(aiErr);
+            logs2.push(`    AI call failed at iteration ${iteration} (after retries): ${errMsg3}`);
             throw (0, ai_retry_js_1.markAIProviderError)(aiErr);
           }
           const iterDuration = Date.now() - iterStart;
@@ -98707,8 +98775,8 @@ Do NOT add steps you did not execute. Do NOT skip steps from the recording.${led
             try {
               toolArgs = JSON.parse(toolCall.function.arguments);
             } catch (parseErr) {
-              const errMsg2 = `Invalid tool arguments: ${parseErr.message}`;
-              toolResults.push({ role: "tool", tool_call_id: toolCall.id, content: errMsg2 });
+              const errMsg3 = `Invalid tool arguments: ${parseErr.message}`;
+              toolResults.push({ role: "tool", tool_call_id: toolCall.id, content: errMsg3 });
               continue;
             }
             if (toolName === "finish_generate") {
@@ -99926,7 +99994,7 @@ var require_util4 = __commonJS({
         }
         path = url.path;
       }
-      var isAbsolute = exports.isAbsolute(path);
+      var isAbsolute2 = exports.isAbsolute(path);
       var parts = path.split(/\/+/);
       for (var part, up = 0, i = parts.length - 1; i >= 0; i--) {
         part = parts[i];
@@ -99946,7 +100014,7 @@ var require_util4 = __commonJS({
       }
       path = parts.join("/");
       if (path === "") {
-        path = isAbsolute ? "/" : ".";
+        path = isAbsolute2 ? "/" : ".";
       }
       if (url) {
         url.path = path;
@@ -99955,7 +100023,7 @@ var require_util4 = __commonJS({
       return path;
     }
     exports.normalize = normalize;
-    function join7(aRoot, aPath) {
+    function join8(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -99987,7 +100055,7 @@ var require_util4 = __commonJS({
       }
       return joined;
     }
-    exports.join = join7;
+    exports.join = join8;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -100160,7 +100228,7 @@ var require_util4 = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join7(urlGenerate(parsed), sourceURL);
+        sourceURL = join8(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -313872,8 +313940,8 @@ Try a different fix approach. This is NOT your final script-driven attempt yet,
             ...(0, ai_provider_js_1.getJsonObjectResponseFormat)(agentModel)
           })), { label: `script-heal-${attempt}` });
         } catch (aiErr) {
-          const errMsg2 = aiErr instanceof Error ? aiErr.message : String(aiErr);
-          logs2.push(`\u26A0 AI call failed: ${errMsg2}`);
+          const errMsg3 = aiErr instanceof Error ? aiErr.message : String(aiErr);
+          logs2.push(`\u26A0 AI call failed: ${errMsg3}`);
           attemptHistory.push({
             phase: "script",
             attempt,
@@ -313881,13 +313949,13 @@ Try a different fix approach. This is NOT your final script-driven attempt yet,
             passed: false,
             changedCode: false,
             summary: "AI call failed before returning a heal result",
-            errorSummary: truncateForPrompt(errMsg2),
+            errorSummary: truncateForPrompt(errMsg3),
             failedStep: summarizeFailedStep(currentStepResults)
           });
           if (feedbackEnabled) {
-            lastTransportFailure = truncateForPrompt(errMsg2, 200) ?? "the AI request failed";
+            lastTransportFailure = truncateForPrompt(errMsg3, 200) ?? "the AI request failed";
           } else {
-            currentError = `AI call failed on attempt ${attempt}: ${errMsg2}`;
+            currentError = `AI call failed on attempt ${attempt}: ${errMsg3}`;
           }
           markRecoverableTurn();
           continue;
@@ -314137,8 +314205,8 @@ ${currentError.slice(0, 2e3)}`
             // item 5b
           });
         } catch (runErr) {
-          const errMsg2 = runErr instanceof Error ? runErr.message : String(runErr);
-          logs2.push(`\u{1F4A5} Native execution threw: ${errMsg2}`);
+          const errMsg3 = runErr instanceof Error ? runErr.message : String(runErr);
+          logs2.push(`\u{1F4A5} Native execution threw: ${errMsg3}`);
           attemptHistory.push({
             phase: "script",
             attempt,
@@ -314146,9 +314214,9 @@ ${currentError.slice(0, 2e3)}`
             passed: false,
             changedCode: true,
             summary: truncateForPrompt(changeDesc) ?? "Applied code fix, but native execution threw before verification completed",
-            errorSummary: truncateForPrompt(errMsg2)
+            errorSummary: truncateForPrompt(errMsg3)
           });
-          currentError = `Native execution threw: ${errMsg2}`;
+          currentError = `Native execution threw: ${errMsg3}`;
           currentStepResults = [];
           continue;
         }
@@ -314904,9 +314972,9 @@ Last error (after heal attempts): ${lastErrorSnippet}` : `Heal aborted: same err
                 previousErrorSignature = errorSig;
               }
             } catch (runErr) {
-              const errMsg2 = runErr instanceof Error ? runErr.message : String(runErr);
-              logs2.push(`\u{1F4A5} Native run threw: ${errMsg2}`);
-              currentError = errMsg2;
+              const errMsg3 = runErr instanceof Error ? runErr.message : String(runErr);
+              logs2.push(`\u{1F4A5} Native run threw: ${errMsg3}`);
+              currentError = errMsg3;
               currentStepResults = [];
             }
           } else {
@@ -315468,8 +315536,8 @@ When you call finish_fix, preserve locators only when they are stable structural
                     }
                   }
                 } catch (toolErr) {
-                  const errMsg2 = toolErr instanceof Error ? toolErr.message : String(toolErr);
-                  let errorContent = `Error: ${errMsg2}`;
+                  const errMsg3 = toolErr instanceof Error ? toolErr.message : String(toolErr);
+                  let errorContent = `Error: ${errMsg3}`;
                   try {
                     const consoleResult = await mcpClient.callTool({ name: "browser_console_messages", arguments: {} });
                     const consoleText = Array.isArray(consoleResult.content) ? consoleResult.content.map((c) => c.type === "text" ? c.text ?? "" : "").join("\n") : String(consoleResult.content ?? "");
@@ -315490,8 +315558,8 @@ ${errorContent}`;
               }
             }
           } catch (mcpErr) {
-            const errMsg2 = mcpErr instanceof Error ? mcpErr.message : String(mcpErr);
-            logs2.push(`\u{1F4A5} MCP exploration failed: ${errMsg2}`);
+            const errMsg3 = mcpErr instanceof Error ? mcpErr.message : String(mcpErr);
+            logs2.push(`\u{1F4A5} MCP exploration failed: ${errMsg3}`);
           }
           if (verdict === "app_bug") {
             phase2AttemptHistory.push({
@@ -316054,9 +316122,9 @@ ${testBlocks}
               }
               emit(`   \u2713 ${toolResultContent.slice(0, 200)}${toolResultContent.length > 200 ? "..." : ""}`);
             } catch (err) {
-              const errMsg2 = err instanceof Error ? err.message : String(err);
-              toolResultContent = `ERROR: ${errMsg2}`;
-              emit(`   \u2717 ${errMsg2}`);
+              const errMsg3 = err instanceof Error ? err.message : String(err);
+              toolResultContent = `ERROR: ${errMsg3}`;
+              emit(`   \u2717 ${errMsg3}`);
             }
             toolResults.push({ role: "tool", tool_call_id: toolCall.id, content: toolResultContent });
           }
@@ -321911,8 +321979,8 @@ var require_capture_page_normalizer = __commonJS({
         const snapItems = Array.isArray(snapResult.content) ? snapResult.content : [];
         snapshotText = extractInlineSnapshotYaml(snapItems.find((c) => c.type === "text")?.text || null);
       } catch (err) {
-        const errMsg2 = err instanceof Error ? err.message : String(err);
-        const isTimeout = /timeout|timed out|TimeoutError/i.test(errMsg2);
+        const errMsg3 = err instanceof Error ? err.message : String(err);
+        const isTimeout = /timeout|timed out|TimeoutError/i.test(errMsg3);
         return {
           snapshotText: null,
           meta: {
@@ -325934,9 +326002,9 @@ ${currentSummary}`;
                     });
                   }
                 } catch (err) {
-                  const errMsg2 = err instanceof Error ? err.message : String(err);
-                  logs2.push(`   Error persisting page: ${errMsg2}`);
-                  toolResults.push({ role: "tool", tool_call_id: toolCall.id, content: `ERROR persisting page: ${errMsg2}` });
+                  const errMsg3 = err instanceof Error ? err.message : String(err);
+                  logs2.push(`   Error persisting page: ${errMsg3}`);
+                  toolResults.push({ role: "tool", tool_call_id: toolCall.id, content: `ERROR persisting page: ${errMsg3}` });
                 }
                 continue;
               }
@@ -326138,12 +326206,12 @@ ${currentSummary}`;
                   })
                 });
               } catch (err) {
-                const errMsg2 = err instanceof Error ? err.message : String(err);
-                logs2.push(`   Error persisting page: ${errMsg2}`);
+                const errMsg3 = err instanceof Error ? err.message : String(err);
+                logs2.push(`   Error persisting page: ${errMsg3}`);
                 toolResults.push({
                   role: "tool",
                   tool_call_id: toolCall.id,
-                  content: `ERROR persisting page: ${errMsg2}`
+                  content: `ERROR persisting page: ${errMsg3}`
                 });
               }
               continue;
@@ -326178,12 +326246,12 @@ ${currentSummary}`;
                   content: JSON.stringify({ acknowledged: true })
                 });
               } catch (err) {
-                const errMsg2 = err instanceof Error ? err.message : String(err);
-                logs2.push(`   Error persisting transition: ${errMsg2}`);
+                const errMsg3 = err instanceof Error ? err.message : String(err);
+                logs2.push(`   Error persisting transition: ${errMsg3}`);
                 toolResults.push({
                   role: "tool",
                   tool_call_id: toolCall.id,
-                  content: `ERROR persisting transition: ${errMsg2}`
+                  content: `ERROR persisting transition: ${errMsg3}`
                 });
               }
               continue;
@@ -326838,15 +326906,15 @@ Exploration complete: ${summary}`);
               toolResultContent = (0, snapshot_context_compactor_js_1.formatMCPToolResult)(toolResultContent, MAX_TOOL_RESULT_CHARS);
               logs2.push(`   OK: ${toolResultContent.slice(0, 200)}${toolResultContent.length > 200 ? "..." : ""}`);
             } catch (err) {
-              const errMsg2 = err instanceof Error ? err.message : String(err);
-              toolResultContent = `ERROR: ${errMsg2}`;
-              logs2.push(`   Error: ${errMsg2}`);
+              const errMsg3 = err instanceof Error ? err.message : String(err);
+              toolResultContent = `ERROR: ${errMsg3}`;
+              logs2.push(`   Error: ${errMsg3}`);
               if (useV2) {
                 (0, exploration_state_js_1.reduceEvent)(state2, {
                   type: "ACTION_FAILED",
                   route: state2.currentRoute,
                   action: `${toolName}(${JSON.stringify(toolArgs).slice(0, 100)})`,
-                  error: errMsg2
+                  error: errMsg3
                 });
               }
             }
@@ -328955,6 +329023,15 @@ var require_agentic_survey_prompts = __commonJS({
         lines.push(input.appBrief.trim());
         lines.push("");
       }
+      if (input.knownFactsBlock && input.knownFactsBlock.trim().length > 0) {
+        lines.push("## Known facts about this app (from project documentation)");
+        lines.push("");
+        lines.push("Use these as hints for what features/routes/constraints exist. They are");
+        lines.push("advisory \u2014 verify against the live app; the browser is the source of truth.");
+        lines.push("");
+        lines.push(input.knownFactsBlock.trim());
+        lines.push("");
+      }
       if (input.credentials && input.credentials.length > 0) {
         lines.push("## Test credentials (throwaway accounts)");
         lines.push("");
@@ -329582,6 +329659,7 @@ var require_grok_survey_runner = __commonJS({
       const briefInput = {
         baseUrl: ctx.baseUrl,
         appBrief: ctx.appBrief,
+        knownFactsBlock: ctx.knowledgeContext,
         credentials: credentials.length > 0 ? credentials : void 0,
         existingFeatureNames: ctx.existingFeatureNames ?? [],
         focusAreas: ctx.focusAreas,
@@ -329682,10 +329760,10 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
           onLog: options.onLog,
           onProvenCommands: recordProvenCommands
         });
-        const errMsg2 = firstError?.message ?? (grokError instanceof Error ? grokError.message : "unknown error");
+        const errMsg3 = firstError?.message ?? (grokError instanceof Error ? grokError.message : "unknown error");
         const fixPrompt = [
           "Your previous attempt did not produce a valid result file.",
-          `Error: ${errMsg2}`,
+          `Error: ${errMsg3}`,
           `Re-read BRIEF.md and write a valid SurveyorOutput JSON to ${resultFilePath}.`,
           "Single JSON object. No prose. Then exit."
         ].join("\n");
@@ -331277,6 +331355,7 @@ var require_grok_discovery_runner = __commonJS({
           featureObservations: ctx.featureContext?.flowIntel,
           notesForTestAuthor: ctx.featureContext?.priorInsight,
           appBrief: ctx.appBrief,
+          knownFactsBlock: ctx.knowledgeContext,
           credentials: credentials.length > 0 ? credentials : void 0,
           testVariableKeys: testVariableKeys.length > 0 ? testVariableKeys : void 0,
           existingTestNames: ctx.existingTestNames ?? [],
@@ -331825,7 +331904,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
           log2(`First-pass discovery-result invalid or missing: ${firstError.message}`);
         }
         if (!parsedResult) {
-          const errMsg2 = firstError?.message ?? (grokError instanceof Error ? grokError.message : "unknown error");
+          const errMsg3 = firstError?.message ?? (grokError instanceof Error ? grokError.message : "unknown error");
           if (planDebounceTimerRef.current) {
             clearTimeout(planDebounceTimerRef.current);
             planDebounceTimerRef.current = void 0;
@@ -331850,7 +331929,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
             ""
           ].join("\n");
           const fixPrompt = [
-            `Your previous attempt did not produce a valid result file. Error: ${errMsg2}`,
+            `Your previous attempt did not produce a valid result file. Error: ${errMsg3}`,
             "Re-read BRIEF.md.",
             phaseContext,
             `Continue from where you left off \u2014 already verified tests are in ${testsDirPath}/`,
@@ -332214,6 +332293,7 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
           featureObservations: ctx.featureContext?.flowIntel,
           notesForTestAuthor: ctx.featureContext?.priorInsight,
           appBrief: ctx.appBrief,
+          knownFactsBlock: ctx.knowledgeContext,
           credentials: credentials.length > 0 ? credentials : void 0,
           testVariableKeys: testVariableKeys.length > 0 ? testVariableKeys : void 0,
           existingTestNames: ctx.existingTestNames ?? [],
@@ -333305,6 +333385,7 @@ ${preview}`);
       const briefInput = {
         baseUrl: ctx.baseUrl,
         appBrief: ctx.appBrief,
+        knownFactsBlock: ctx.knowledgeContext,
         credentials: credentials.length > 0 ? credentials : void 0,
         existingFeatureNames: ctx.existingFeatureNames ?? [],
         focusAreas: ctx.focusAreas,
@@ -333477,10 +333558,10 @@ ${(0, inbox_tools_js_1.buildInboxAgentsGuidance)(inboxReg.email, inboxReg.passwo
           onLog: parserLog,
           onProvenCommands: recordProvenCommands
         });
-        const errMsg2 = firstError?.message ?? (claudeError instanceof Error ? claudeError.message : "unknown error");
+        const errMsg3 = firstError?.message ?? (claudeError instanceof Error ? claudeError.message : "unknown error");
         const fixPrompt = [
           "Your previous attempt did not leave a valid result file.",
-          `Error: ${errMsg2}`,
+          `Error: ${errMsg3}`,
           `Writing a valid SurveyorOutput JSON object to ${resultFilePath} is your ONLY priority now.`,
           "Procedure: navigate to at most 6-8 of the main pages, then IMMEDIATELY use",
           `the Write tool to save the SurveyorOutput JSON to ${resultFilePath}. Do this`,
@@ -334164,6 +334245,7 @@ var require_claude_discovery_runner = __commonJS({
           featureObservations: ctx.featureContext?.flowIntel,
           notesForTestAuthor: ctx.featureContext?.priorInsight,
           appBrief: ctx.appBrief,
+          knownFactsBlock: ctx.knowledgeContext,
           credentials: credentials.length > 0 ? credentials : void 0,
           testVariableKeys: testVariableKeys.length > 0 ? testVariableKeys : void 0,
           existingTestNames: ctx.existingTestNames ?? [],
@@ -336018,7 +336100,8 @@ Explore complete: ${exploreResult.pagesDiscovered} pages, ${exploreResult.elemen
           // scenarioTouchesSignupAuthSurface) still isolate non-auth scenarios. The
           // auth-feature scope IS applied at the DEEP call site where ctx.featureName is known.
           emailVerifyArmed: mode !== "survey" && plannerEmailVerifyArmed(ctx),
-          testBudget
+          testBudget,
+          knowledgeContext: ctx.knowledgeContext
         }, {
           modelOverride: ctx.planModel ?? ctx.generateModel,
           gateModelOverride: ctx.planGateModel,
@@ -336130,6 +336213,7 @@ Health: ${surveyHealth.totalIssues} issue(s) - ${surveyHealth.consoleErrors.leng
           interactionLog: exploreResult.interactionLog,
           modelOverride: ctx.generateModel,
           appBrief: ctx.appBrief,
+          knowledgeContext: ctx.knowledgeContext,
           onAICall,
           onProgress,
           mcpClient: mcpClient ?? void 0,
@@ -336609,7 +336693,8 @@ Plan (reused): ${resumeSavedScenarios.length} scenarios from the paused run.`);
             // configured inbox), so the planner never promises what generation can't do.
             // Scoped to AUTH features: a non-auth feature has no signup surface to test.
             emailVerifyArmed: plannerEmailVerifyArmed(ctx) && featureLooksLikeAuth(ctx.featureName, augmentedFeatureFocusAreas),
-            testBudget: featureTestBudget
+            testBudget: featureTestBudget,
+            knowledgeContext: ctx.knowledgeContext
           }, {
             modelOverride: ctx.planModel ?? ctx.generateModel,
             gateModelOverride: ctx.planGateModel,
@@ -336655,6 +336740,7 @@ Plan: ${planResult.scenarios.length} scenarios (budget: ${featureTestBudget})`);
           interactionLog: exploreResult.interactionLog,
           modelOverride: ctx.generateModel,
           appBrief: ctx.appBrief,
+          knowledgeContext: ctx.knowledgeContext,
           onAICall,
           mcpClient: mcpClient ?? void 0,
           // Pooled browser for parallel scenario generation (Fargate opt-in via
@@ -339853,8 +339939,8 @@ var require_adm_zip = __commonJS({
         return null;
       }
       function fixPath(zipPath) {
-        const { join: join7, normalize, sep } = pth.posix;
-        return join7(pth.isAbsolute(zipPath) ? "/" : ".", normalize(sep + zipPath.split("\\").join(sep) + sep));
+        const { join: join8, normalize, sep } = pth.posix;
+        return join8(pth.isAbsolute(zipPath) ? "/" : ".", normalize(sep + zipPath.split("\\").join(sep) + sep));
       }
       function filenameFilter(filterfn) {
         if (filterfn instanceof RegExp) {
@@ -342689,11 +342775,11 @@ var require_winchars = __commonJS({
 var require_strip_absolute_path = __commonJS({
   "../../node_modules/tar/lib/strip-absolute-path.js"(exports, module) {
     "use strict";
-    var { isAbsolute, parse } = __require("path").win32;
+    var { isAbsolute: isAbsolute2, parse } = __require("path").win32;
     module.exports = (path) => {
       let r = "";
       let parsed = parse(path);
-      while (isAbsolute(path) || parsed.root) {
+      while (isAbsolute2(path) || parsed.root) {
         const root = path.charAt(0) === "/" && path.slice(0, 4) !== "//?/" ? "/" : parsed.root;
         path = path.slice(root.length);
         r += root;
@@ -345205,7 +345291,7 @@ var require_update = __commonJS({
 var require_opts_arg = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/opts-arg.js"(exports, module) {
     "use strict";
-    var { promisify: promisify3 } = __require("util");
+    var { promisify: promisify4 } = __require("util");
     var fs = __require("fs");
     var optsArg = (opts) => {
       if (!opts)
@@ -345219,9 +345305,9 @@ var require_opts_arg = __commonJS({
       else
         throw new TypeError("invalid options argument");
       opts.mkdir = opts.mkdir || opts.fs.mkdir || fs.mkdir;
-      opts.mkdirAsync = promisify3(opts.mkdir);
+      opts.mkdirAsync = promisify4(opts.mkdir);
       opts.stat = opts.stat || opts.fs.stat || fs.stat;
-      opts.statAsync = promisify3(opts.stat);
+      opts.statAsync = promisify4(opts.stat);
       opts.statSync = opts.statSync || opts.fs.statSync || fs.statSync;
       opts.mkdirSync = opts.mkdirSync || opts.fs.mkdirSync || fs.mkdirSync;
       return opts;
@@ -345474,10 +345560,10 @@ var require_chownr = __commonJS({
       }
     } : (path2, uid, gid) => lchownSync(path2, uid, gid);
     var nodeVersion = process.version;
-    var readdir2 = (path2, options, cb) => fs.readdir(path2, options, cb);
+    var readdir3 = (path2, options, cb) => fs.readdir(path2, options, cb);
     var readdirSync = (path2, options) => fs.readdirSync(path2, options);
     if (/^v4\./.test(nodeVersion))
-      readdir2 = (path2, options, cb) => fs.readdir(path2, cb);
+      readdir3 = (path2, options, cb) => fs.readdir(path2, cb);
     var chown = (cpath, uid, gid, cb) => {
       fs[LCHOWN](cpath, uid, gid, handleEISDIR(cpath, uid, gid, (er) => {
         cb(er && er.code !== "ENOENT" ? er : null);
@@ -345504,7 +345590,7 @@ var require_chownr = __commonJS({
       }
     };
     var chownr = (p, uid, gid, cb) => {
-      readdir2(p, { withFileTypes: true }, (er, children) => {
+      readdir3(p, { withFileTypes: true }, (er, children) => {
         if (er) {
           if (er.code === "ENOENT")
             return cb();
@@ -345778,7 +345864,7 @@ var require_path_reservations = __commonJS({
     var assert = __require("assert");
     var normalize = require_normalize_unicode();
     var stripSlashes = require_strip_trailing_slashes();
-    var { join: join7 } = __require("path");
+    var { join: join8 } = __require("path");
     var platform3 = process.env.TESTING_TAR_FAKE_PLATFORM || process.platform;
     var isWindows = platform3 === "win32";
     module.exports = () => {
@@ -345787,7 +345873,7 @@ var require_path_reservations = __commonJS({
       const getDirs = (path) => {
         const dirs = path.split("/").slice(0, -1).reduce((set, path2) => {
           if (set.length) {
-            path2 = join7(set[set.length - 1], path2);
+            path2 = join8(set[set.length - 1], path2);
           }
           set.push(path2 || "/");
           return set;
@@ -345855,7 +345941,7 @@ var require_path_reservations = __commonJS({
       };
       const reserve = (paths, fn) => {
         paths = isWindows ? ["win32 parallelization disabled"] : paths.map((p) => {
-          return stripSlashes(join7(normalize(p))).toLowerCase();
+          return stripSlashes(join8(normalize(p))).toLowerCase();
         });
         const dirs = new Set(
           paths.map((path) => getDirs(path)).reduce((a, b) => a.concat(b))
@@ -347868,6 +347954,12 @@ Write valid JSON only (no markdown fences inside files). Be exhaustive.`;
         "Use {{TEST_USER_EMAIL}}/{{TEST_USER_PASSWORD}} for credentials. Include",
         "assertVisible or assertText unless tagging @needs-review. When an incremental",
         "allow-list is present, extract ONLY from those files.",
+        "",
+        "Every tap/type/clear/waitForElement/assertVisible/assertText target MUST",
+        "carry an IDENTITY locator: ~accessibility-id, id=resource-id, visible text,",
+        "or an attribute-EQUALITY xpath (//android.widget.Button[@text='Submit']).",
+        "Positional/index-only xpaths (/hierarchy/\u2026/View[3]) are rejected \u2014 imported",
+        "steps have no recorded coordinates, so such a step can never replay.",
         "Write strictly valid JSON."
       ].join("\n");
     }
@@ -347885,6 +347977,32 @@ Write valid JSON only (no markdown fences inside files). Be exhaustive.`;
     function isPlainObject2(value) {
       return !!value && typeof value === "object" && !Array.isArray(value);
     }
+    var LOCATOR_REQUIRING_IMPORT_ACTIONS = /* @__PURE__ */ new Set([
+      "tap",
+      "type",
+      "clear",
+      "waitForElement",
+      "assertVisible",
+      "assertText"
+    ]);
+    function selectorValueHasIdentity(value) {
+      const trimmed = value.trim();
+      if (!trimmed)
+        return false;
+      if (trimmed.startsWith("/") || trimmed.startsWith("(//"))
+        return (0, shared_1.isIdentityMobileXpath)(trimmed);
+      return true;
+    }
+    function stepLocatorLacksIdentity(step) {
+      if (!LOCATOR_REQUIRING_IMPORT_ACTIONS.has(step.action))
+        return false;
+      const target = step.target;
+      if (!target)
+        return true;
+      if ((0, shared_1.mobileLocatorBundleHasIdentity)(target.locatorBundle))
+        return false;
+      return ![target.primary, ...target.fallbacks ?? []].some((value) => typeof value === "string" && selectorValueHasIdentity(value));
+    }
     function isValidStep(value) {
       if (!value || typeof value !== "object" || Array.isArray(value))
         return false;
@@ -347936,6 +348054,13 @@ Write valid JSON only (no markdown fences inside files). Be exhaustive.`;
       if (!o.steps.every(isValidStep)) {
         return { ok: false, reason: "steps: invalid step shape" };
       }
+      const identityless = o.steps.find(stepLocatorLacksIdentity);
+      if (identityless) {
+        return {
+          ok: false,
+          reason: `steps: step ${identityless.order} (${identityless.action}) has no identity locator \u2014 a positional/index xpath cannot replay (imported steps have no recorded coordinates). Use ~accessibility-id, id=resource-id, visible text, or an attribute-equality xpath like //android.widget.Button[@text='Submit'].`
+        };
+      }
       const steps = o.steps.map((step, order) => ({
         ...step,
         order,
@@ -350031,7 +350156,7 @@ var require_process_inventory = __commonJS({
     var node_child_process_1 = __require("child_process");
     var node_os_1 = __importDefault(__require("os"));
     var node_util_1 = __require("util");
-    var execFileAsync3 = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    var execFileAsync4 = (0, node_util_1.promisify)(node_child_process_1.execFile);
     var DEFAULT_LIMIT = 60;
     var DEFAULT_TIMEOUT_MS2 = 800;
     var MAX_COMMAND_LENGTH = 320;
@@ -350093,7 +350218,7 @@ var require_process_inventory = __commonJS({
       const timer = setTimeout(() => controller.abort(), timeoutMs);
       timer.unref?.();
       try {
-        const { stdout } = await execFileAsync3(command, args, {
+        const { stdout } = await execFileAsync4(command, args, {
           maxBuffer: 1024 * 1024,
           signal: controller.signal
         });
@@ -351229,7 +351354,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.67",
+      version: "1.0.69",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -351316,7 +351441,7 @@ function getConfigDir() {
 }
 
 // src/runner.ts
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { homedir as homedir3 } from "os";
 import { createHash } from "crypto";
 
@@ -351911,6 +352036,66 @@ function resetServerState(port = APPIUM_PORT, restartCount = 0) {
   };
 }
 
+// src/services/mobile/ios-simulator-reset.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { readdir, rm } from "fs/promises";
+import { join as join3, isAbsolute } from "path";
+var execFileAsync = promisify(execFile);
+var SIMCTL_TIMEOUT_MS = 15e3;
+var SIMULATOR_UDID_RE = /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;
+function isIosSimulatorUdid(udid) {
+  return typeof udid === "string" && SIMULATOR_UDID_RE.test(udid.trim());
+}
+function errMsg(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+async function simctl(args) {
+  const { stdout } = await execFileAsync("xcrun", ["simctl", ...args], {
+    timeout: SIMCTL_TIMEOUT_MS,
+    encoding: "utf-8"
+  });
+  return stdout.trim();
+}
+async function clearIosSimulatorAppData(udid, bundleId, env = process.env) {
+  if (!isIosSimulatorUdid(udid)) {
+    return { ok: false, detail: `'${udid}' is not a simulator UDID \u2014 physical iOS devices cannot be cleared` };
+  }
+  let container;
+  try {
+    container = await simctl(["get_app_container", udid, bundleId, "data"]);
+  } catch (err) {
+    return { ok: false, detail: `simctl get_app_container failed (app not installed?): ${errMsg(err)}` };
+  }
+  if (!isAbsolute(container) || !container.includes("/Containers/Data/Application/")) {
+    return { ok: false, detail: `unexpected app container path: ${container}` };
+  }
+  try {
+    await simctl(["spawn", udid, "defaults", "delete", bundleId]);
+  } catch {
+  }
+  try {
+    const entries = await readdir(container);
+    for (const entry of entries) {
+      await rm(join3(container, entry), { recursive: true, force: true });
+    }
+  } catch (err) {
+    return { ok: false, detail: `app container wipe failed: ${errMsg(err)}` };
+  }
+  const keychainPolicy = (env.VALIDATEQA_MOBILE_IOS_KEYCHAIN_RESET ?? "").trim().toLowerCase();
+  if (keychainPolicy !== "never") {
+    try {
+      await simctl(["keychain", udid, "reset"]);
+    } catch (err) {
+      return {
+        ok: false,
+        detail: `simulator keychain reset failed (${errMsg(err)}) \u2014 app data was wiped but keychain items (e.g. auth tokens) may survive. Set VALIDATEQA_MOBILE_IOS_KEYCHAIN_RESET=never to skip the keychain step.`
+      };
+    }
+  }
+  return { ok: true };
+}
+
 // src/services/mobile/appium-actions.ts
 var APPIUM_REQUEST_TIMEOUT_MS = 1e4;
 var APPIUM_WEBVIEW_CONTEXT_TIMEOUT_MS = 12e4;
@@ -352093,9 +352278,12 @@ async function tapAt(sessionPath, bounds) {
   }
 }
 function shouldResetMobileAppData(platform3, deviceId, env = process.env) {
-  if (platform3 !== "ANDROID") return false;
   const policy = (env.VALIDATEQA_MOBILE_APP_RESET ?? "").trim().toLowerCase();
   if (policy === "never") return false;
+  if (platform3 === "IOS") {
+    return isIosSimulatorUdid(deviceId);
+  }
+  if (platform3 !== "ANDROID") return false;
   if (policy === "always") return true;
   return !!deviceId && deviceId.startsWith("emulator-");
 }
@@ -352976,10 +353164,10 @@ async function pressHome(sessionPath, platform3) {
 
 // src/services/appium-executor.ts
 var import_runner_core8 = __toESM(require_dist2());
-import { execFile as execFile2 } from "child_process";
-import { promisify as promisify2 } from "util";
+import { execFile as execFile3 } from "child_process";
+import { promisify as promisify3 } from "util";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 
 // src/services/device-discovery.ts
 import { execFileSync as execFileSync2 } from "child_process";
@@ -353286,9 +353474,6 @@ function countReadyDevicesByKind(platform3, snapshot = getCachedDeviceSnapshot()
 function selectFreeDevice(platform3, leased, snapshot = getCachedDeviceSnapshot(), requirements = {}) {
   const ready = snapshot.filter((d) => d.platform === platform3 && d.isAvailable && d.state === "BOOTED");
   if (ready.length === 0) return { kind: "busy", reason: `no booted ${platform3} device` };
-  if (requirements.resetPolicy === "CLEAR_APP_DATA" && platform3 !== "ANDROID") {
-    return { kind: "unsatisfiable", reason: "CLEAR_APP_DATA is unsupported on iOS" };
-  }
   let candidates = requirements.resetPolicy === "CLEAR_APP_DATA" ? ready.filter((d) => !d.isPhysical) : [...ready];
   const appId = requirements.appId?.trim();
   if (appId) {
@@ -353337,23 +353522,23 @@ function pickFreeDevice(platform3, leased, snapshot = getCachedDeviceSnapshot(),
 
 // src/services/mobile/mobile-network-capture.ts
 var import_runner_core7 = __toESM(require_dist2());
-import { execFile, execFileSync as execFileSync3 } from "child_process";
+import { execFile as execFile2, execFileSync as execFileSync3 } from "child_process";
 import { randomUUID } from "crypto";
-import { mkdtemp, rm, writeFile, readFile, readdir, mkdir, unlink } from "fs/promises";
+import { mkdtemp, rm as rm2, writeFile, readFile, readdir as readdir2, mkdir, unlink } from "fs/promises";
 import { tmpdir as tmpdir2, networkInterfaces } from "os";
-import { join as join3 } from "path";
-import { promisify } from "util";
+import { join as join4 } from "path";
+import { promisify as promisify2 } from "util";
 import {
   getLocal,
   generateCACertificate
 } from "mockttp";
-var execFileAsync = promisify(execFile);
+var execFileAsync2 = promisify2(execFile2);
 var MAX_CALLS = 1e3;
 var MAX_BODY_CAPTURE_BYTES = 64 * 1024;
 var DEVICE_CMD_TIMEOUT_MS = 15e3;
 var CA_KEY_BITS = 2048;
 var ANDROID_EMULATOR_HOST_LOOPBACK = "10.0.2.2";
-var PENDING_CLEANUP_DIR = join3(tmpdir2(), "validateqa-mobile-capture-pending");
+var PENDING_CLEANUP_DIR = join4(tmpdir2(), "validateqa-mobile-capture-pending");
 var IOS_SIM_HOST_PROXY_ENV = "VALIDATEQA_MOBILE_IOS_SIM_HOST_PROXY";
 var STALE_MARKER_RECONCILE_MS = 6 * 60 * 60 * 1e3;
 function envFlag(name) {
@@ -353535,7 +353720,7 @@ var MitmProxy = class {
     try {
       await server3.stop();
     } catch (err) {
-      this.onLog?.(`[mobile-net] proxy stop error (ignored): ${errMsg(err)}`);
+      this.onLog?.(`[mobile-net] proxy stop error (ignored): ${errMsg2(err)}`);
     }
     this.onLog?.(
       `[mobile-net] proxy closed: ${this.calls.length} calls captured` + (this.dropped > 0 ? ` (${this.dropped} dropped over cap)` : "")
@@ -353560,7 +353745,7 @@ var MitmProxy = class {
         isHttps
       });
     } catch (err) {
-      this.onLog?.(`[mobile-net] request capture error (ignored): ${errMsg(err)}`);
+      this.onLog?.(`[mobile-net] request capture error (ignored): ${errMsg2(err)}`);
     }
   }
   // ── response → finalize the matched request ───────────────────────────────
@@ -353603,7 +353788,7 @@ var MitmProxy = class {
         intercepted: true
       });
     } catch (err) {
-      this.onLog?.(`[mobile-net] response capture error (ignored): ${errMsg(err)}`);
+      this.onLog?.(`[mobile-net] response capture error (ignored): ${errMsg2(err)}`);
     }
   }
   // ── tls-client-error → record WHY interception failed ─────────────────────
@@ -353680,17 +353865,17 @@ async function generateCaCert(dir, onLog) {
       // rely on stop() to remove the cert from the device promptly after the run
       // rather than on a short expiry.
     });
-    const caCertPath = join3(dir, "validateqa-mobile-ca.pem");
+    const caCertPath = join4(dir, "validateqa-mobile-ca.pem");
     await writeFile(caCertPath, cert, "utf-8");
     return { caCertPath, caKeyPem: key, caCertPem: cert };
   } catch (err) {
-    onLog?.(`[mobile-net] CA generation failed; running plaintext-only: ${errMsg(err)}`);
+    onLog?.(`[mobile-net] CA generation failed; running plaintext-only: ${errMsg2(err)}`);
     return null;
   }
 }
 async function androidReadProxy(deviceId) {
   try {
-    const { stdout } = await execFileAsync(
+    const { stdout } = await execFileAsync2(
       "adb",
       ["-s", deviceId, "shell", "settings", "get", "global", "http_proxy"],
       { timeout: DEVICE_CMD_TIMEOUT_MS }
@@ -353703,33 +353888,33 @@ async function androidReadProxy(deviceId) {
 }
 async function androidSetProxy(deviceId, hostPort, onLog) {
   try {
-    await execFileAsync(
+    await execFileAsync2(
       "adb",
       ["-s", deviceId, "shell", "settings", "put", "global", "http_proxy", hostPort],
       { timeout: DEVICE_CMD_TIMEOUT_MS }
     );
     return true;
   } catch (err) {
-    onLog?.(`[mobile-net] adb set http_proxy failed: ${errMsg(err)}`);
+    onLog?.(`[mobile-net] adb set http_proxy failed: ${errMsg2(err)}`);
     return false;
   }
 }
 async function androidClearProxy(deviceId, originalProxy, onLog) {
   const restoreValue = originalProxy && originalProxy.length > 0 ? originalProxy : ":0";
   try {
-    await execFileAsync(
+    await execFileAsync2(
       "adb",
       ["-s", deviceId, "shell", "settings", "put", "global", "http_proxy", restoreValue],
       { timeout: DEVICE_CMD_TIMEOUT_MS }
     );
   } catch (err) {
-    onLog?.(`[mobile-net] adb restore http_proxy failed: ${errMsg(err)}`);
+    onLog?.(`[mobile-net] adb restore http_proxy failed: ${errMsg2(err)}`);
   }
 }
 async function androidInstallCa(deviceId, caCertPath) {
   const devicePath = "/sdcard/validateqa-mobile-ca.pem";
   try {
-    await execFileAsync("adb", ["-s", deviceId, "push", caCertPath, devicePath], {
+    await execFileAsync2("adb", ["-s", deviceId, "push", caCertPath, devicePath], {
       timeout: DEVICE_CMD_TIMEOUT_MS
     });
     return {
@@ -353737,23 +353922,23 @@ async function androidInstallCa(deviceId, caCertPath) {
       note: `CA copied from ${caCertPath} to ${devicePath} but NOT auto-trusted: Android 7+ apps must opt into user CAs (network_security_config), and the system store requires a rooted/writable image. HTTPS bodies decrypt only for apps that trust user CAs; pinned apps never decrypt.`
     };
   } catch (err) {
-    return { installed: false, note: `CA push failed: ${errMsg(err)}` };
+    return { installed: false, note: `CA push failed: ${errMsg2(err)}` };
   }
 }
 async function androidRemoveCa(deviceId, onLog) {
   try {
-    await execFileAsync(
+    await execFileAsync2(
       "adb",
       ["-s", deviceId, "shell", "rm", "-f", "/sdcard/validateqa-mobile-ca.pem"],
       { timeout: DEVICE_CMD_TIMEOUT_MS }
     );
   } catch (err) {
-    onLog?.(`[mobile-net] adb remove CA failed: ${errMsg(err)}`);
+    onLog?.(`[mobile-net] adb remove CA failed: ${errMsg2(err)}`);
   }
 }
 async function iosSimTrustCa(deviceId, caCertPath) {
   try {
-    await execFileAsync("xcrun", ["simctl", "keychain", deviceId, "add-root-cert", caCertPath], {
+    await execFileAsync2("xcrun", ["simctl", "keychain", deviceId, "add-root-cert", caCertPath], {
       timeout: DEVICE_CMD_TIMEOUT_MS
     });
     return {
@@ -353761,18 +353946,18 @@ async function iosSimTrustCa(deviceId, caCertPath) {
       note: "CA added to simulator keychain (add-root-cert). NOTE: the simulator has no per-app HTTP proxy setting controllable via simctl \u2014 it shares the host network, so only traffic that actually routes through the proxy is intercepted; pinned apps still never decrypt."
     };
   } catch (err) {
-    return { trusted: false, note: `simctl add-root-cert failed: ${errMsg(err)}` };
+    return { trusted: false, note: `simctl add-root-cert failed: ${errMsg2(err)}` };
   }
 }
 async function iosSimRemoveCa(deviceId, onLog) {
   if (process.env.VALIDATEQA_MOBILE_SIM_KEYCHAIN_RESET === "1") {
     try {
-      await execFileAsync("xcrun", ["simctl", "keychain", deviceId, "reset"], {
+      await execFileAsync2("xcrun", ["simctl", "keychain", deviceId, "reset"], {
         timeout: DEVICE_CMD_TIMEOUT_MS
       });
       onLog?.(`[mobile-net] simctl keychain reset run for ${deviceId} (opt-in; cleared ALL sim certs).`);
     } catch (err) {
-      onLog?.(`[mobile-net] simctl keychain reset failed: ${errMsg(err)}`);
+      onLog?.(`[mobile-net] simctl keychain reset failed: ${errMsg2(err)}`);
     }
     return;
   }
@@ -353780,7 +353965,7 @@ async function iosSimRemoveCa(deviceId, onLog) {
     `[mobile-net] NOTE: the validate.qa capture CA remains TRUSTED in simulator ${deviceId}. simctl has no scoped remove (only a full keychain reset that wipes ALL certs), so we leave the single CA in place. Use a throwaway simulator, or set VALIDATEQA_MOBILE_SIM_KEYCHAIN_RESET=1 to reset the whole sim keychain on teardown.`
   );
 }
-function errMsg(err) {
+function errMsg2(err) {
   return err instanceof Error ? err.message : String(err);
 }
 function isProcessAlive(pid) {
@@ -353871,7 +354056,7 @@ async function iosSimConfigureHostProxy(host, port, onLog) {
   let service;
   let prior;
   try {
-    const { stdout: order } = await execFileAsync("networksetup", ["-listnetworkserviceorder"], {
+    const { stdout: order } = await execFileAsync2("networksetup", ["-listnetworkserviceorder"], {
       timeout: DEVICE_CMD_TIMEOUT_MS
     });
     const svc = parsePrimaryNetworkService(order);
@@ -353880,26 +354065,26 @@ async function iosSimConfigureHostProxy(host, port, onLog) {
     }
     service = svc;
     const [{ stdout: webOut }, { stdout: secureOut }] = await Promise.all([
-      execFileAsync("networksetup", ["-getwebproxy", service], { timeout: DEVICE_CMD_TIMEOUT_MS }),
-      execFileAsync("networksetup", ["-getsecurewebproxy", service], { timeout: DEVICE_CMD_TIMEOUT_MS })
+      execFileAsync2("networksetup", ["-getwebproxy", service], { timeout: DEVICE_CMD_TIMEOUT_MS }),
+      execFileAsync2("networksetup", ["-getsecurewebproxy", service], { timeout: DEVICE_CMD_TIMEOUT_MS })
     ]);
     prior = { web: parseWebProxyState(webOut), secure: parseWebProxyState(secureOut) };
     for (const args of buildHostProxySetCommands(service, host, port)) {
-      await execFileAsync("networksetup", args, { timeout: DEVICE_CMD_TIMEOUT_MS });
+      await execFileAsync2("networksetup", args, { timeout: DEVICE_CMD_TIMEOUT_MS });
     }
     onLog?.(`[mobile-net] macOS host proxy set on "${service}" \u2192 ${host}:${port} (iOS simulator shares the host network).`);
     return { configured: true, service, prior };
   } catch (err) {
     if (service && prior) {
-      onLog?.(`[mobile-net] host proxy set failed mid-way \u2014 rolling back "${service}" to prior state: ${errMsg(err)}`);
+      onLog?.(`[mobile-net] host proxy set failed mid-way \u2014 rolling back "${service}" to prior state: ${errMsg2(err)}`);
       for (const args of buildHostProxyRestoreCommands(service, prior)) {
         try {
-          await execFileAsync("networksetup", args, { timeout: DEVICE_CMD_TIMEOUT_MS });
+          await execFileAsync2("networksetup", args, { timeout: DEVICE_CMD_TIMEOUT_MS });
         } catch {
         }
       }
     }
-    return { configured: false, reason: `iOS simulator host proxy could not be configured: ${errMsg(err)}` };
+    return { configured: false, reason: `iOS simulator host proxy could not be configured: ${errMsg2(err)}` };
   }
 }
 async function iosSimRestoreHostProxy(service, prior, onLog) {
@@ -353909,9 +354094,9 @@ async function iosSimRestoreHostProxy(service, prior, onLog) {
   };
   for (const args of buildHostProxyRestoreCommands(service, restore)) {
     try {
-      await execFileAsync("networksetup", args, { timeout: DEVICE_CMD_TIMEOUT_MS });
+      await execFileAsync2("networksetup", args, { timeout: DEVICE_CMD_TIMEOUT_MS });
     } catch (err) {
-      onLog?.(`[mobile-net] networksetup restore (${args[0]}) failed: ${errMsg(err)}`);
+      onLog?.(`[mobile-net] networksetup restore (${args[0]}) failed: ${errMsg2(err)}`);
     }
   }
   onLog?.(`[mobile-net] macOS host proxy restored on "${service}".`);
@@ -353919,7 +354104,7 @@ async function iosSimRestoreHostProxy(service, prior, onLog) {
 var activeCleanups = /* @__PURE__ */ new Map();
 var exitHandlersInstalled = false;
 function markerPath(sessionKey) {
-  return join3(PENDING_CLEANUP_DIR, `${sessionKey}.json`);
+  return join4(PENDING_CLEANUP_DIR, `${sessionKey}.json`);
 }
 async function writePendingCleanup(sessionKey, marker) {
   try {
@@ -353963,7 +354148,7 @@ function restoreDeviceSync(marker, onLog) {
 async function reconcilePendingCleanups(onLog) {
   let files;
   try {
-    files = await readdir(PENDING_CLEANUP_DIR);
+    files = await readdir2(PENDING_CLEANUP_DIR);
   } catch {
     return;
   }
@@ -353971,7 +354156,7 @@ async function reconcilePendingCleanups(onLog) {
     if (!file.endsWith(".json")) continue;
     const sessionKey = file.slice(0, -".json".length);
     if (activeCleanups.has(sessionKey)) continue;
-    const full = join3(PENDING_CLEANUP_DIR, file);
+    const full = join4(PENDING_CLEANUP_DIR, file);
     try {
       const raw = await readFile(full, "utf-8");
       const marker = JSON.parse(raw);
@@ -354024,7 +354209,7 @@ async function startMobileNetworkCapture(options) {
   let caKeyPem = null;
   let caCertPem = null;
   try {
-    tmpDir = await mkdtemp(join3(tmpdir2(), "validateqa-mobile-ca-"));
+    tmpDir = await mkdtemp(join4(tmpdir2(), "validateqa-mobile-ca-"));
     const ca = await generateCaCert(tmpDir, onLog);
     if (ca) {
       caCertPath = ca.caCertPath;
@@ -354032,7 +354217,7 @@ async function startMobileNetworkCapture(options) {
       caCertPem = ca.caCertPem;
     }
   } catch (err) {
-    onLog?.(`[mobile-net] CA setup degraded: ${errMsg(err)}`);
+    onLog?.(`[mobile-net] CA setup degraded: ${errMsg2(err)}`);
   }
   if (!caKeyPem || !caCertPem) {
     try {
@@ -354040,9 +354225,9 @@ async function startMobileNetworkCapture(options) {
       caKeyPem = fallback.key;
       caCertPem = fallback.cert;
     } catch (err) {
-      onLog?.(`[mobile-net] fatal CA failure, cannot start proxy: ${errMsg(err)}`);
+      onLog?.(`[mobile-net] fatal CA failure, cannot start proxy: ${errMsg2(err)}`);
       if (tmpDir) {
-        await rm(tmpDir, { recursive: true, force: true }).catch(() => void 0);
+        await rm2(tmpDir, { recursive: true, force: true }).catch(() => void 0);
       }
       throw err instanceof Error ? err : new Error(String(err));
     }
@@ -354097,7 +354282,7 @@ async function startMobileNetworkCapture(options) {
       }
     }
   } catch (err) {
-    wiringReason = `device wiring degraded: ${errMsg(err)}`;
+    wiringReason = `device wiring degraded: ${errMsg2(err)}`;
     onLog?.(`[mobile-net] ${wiringReason}`);
   }
   if (proxySet || caInstalledOnDevice || hostProxySet) {
@@ -354186,9 +354371,9 @@ async function startMobileNetworkCapture(options) {
       await proxy.close();
       if (capturedTmpDir) {
         try {
-          await rm(capturedTmpDir, { recursive: true, force: true });
+          await rm2(capturedTmpDir, { recursive: true, force: true });
         } catch (err) {
-          onLog?.(`[mobile-net] temp CA cleanup failed: ${errMsg(err)}`);
+          onLog?.(`[mobile-net] temp CA cleanup failed: ${errMsg2(err)}`);
         }
       }
       const apiCount = finalCalls.filter((c) => c.isApi).length;
@@ -354225,7 +354410,7 @@ var WD_SESSION_CREATE_TIMEOUT_MS = 12e4;
 var WD_ACTION_TIMEOUT_MS = 3e4;
 var APPIUM_DRIVER_DEAD_RE2 = /instrumentation process is not running|cannot be proxied to UiAutomator2 server|socket hang up|ECONNRESET/i;
 var MAX_SESSION_CREATE_ATTEMPTS = 3;
-var execFileAsync2 = promisify2(execFile2);
+var execFileAsync3 = promisify3(execFile3);
 var MOBILE_TEXT_ATTRIBUTE_NAMES = ["text", "content-desc", "contentDescription", "name", "label", "value"];
 var WebDriverTransportError = class extends Error {
   isTransport = true;
@@ -354354,11 +354539,11 @@ function mobileParallelSessionCapabilities(platform3, portOffset = 0, deviceId =
     return { "appium:systemPort": readPort("APPIUM_SYSTEM_PORT", 8200) };
   }
   const safeDevice = deviceId.replace(/[^A-Za-z0-9._-]+/g, "-") || `device-${offset}`;
-  const derivedDataRoot = env.APPIUM_DERIVED_DATA_PATH?.trim() || join4(tmpdir3(), "validateqa-wda");
+  const derivedDataRoot = env.APPIUM_DERIVED_DATA_PATH?.trim() || join5(tmpdir3(), "validateqa-wda");
   return {
     "appium:wdaLocalPort": readPort("APPIUM_WDA_LOCAL_PORT", 8100),
     "appium:mjpegServerPort": readPort("APPIUM_MJPEG_SERVER_PORT", 9100),
-    "appium:derivedDataPath": join4(derivedDataRoot, safeDevice)
+    "appium:derivedDataPath": join5(derivedDataRoot, safeDevice)
   };
 }
 function isAndroidSystemPortBusyError(error2) {
@@ -354442,7 +354627,7 @@ async function removeStaleAndroidSystemPortForward(target, error2) {
   const args = androidSystemPortForwardRemovalArgs(target, error2);
   if (!args) return false;
   try {
-    await execFileAsync2("adb", args, { timeout: 1e4, windowsHide: true });
+    await execFileAsync3("adb", args, { timeout: 1e4, windowsHide: true });
     return true;
   } catch {
     return false;
@@ -354700,7 +354885,7 @@ function boundsForRun(step, platform3, isCrossPlatform) {
   if (platform3 && hasPlatformLocator(step.target, platform3)) return null;
   return boundsFromStep(step);
 }
-function locatorStrategyForValue(value) {
+function locatorStrategyForValue(value, platform3) {
   const trimmed = value?.trim();
   if (!trimmed) {
     return [];
@@ -354716,7 +354901,8 @@ function locatorStrategyForValue(value) {
   }
   return [
     { using: "accessibility id", value: trimmed },
-    { using: "id", value: trimmed }
+    { using: "id", value: trimmed },
+    ...textIdentityStrategies(trimmed, platform3)
   ];
 }
 function buildLocatorStrategies(target, platform3) {
@@ -354726,19 +354912,19 @@ function buildLocatorStrategies(target, platform3) {
   if (bundle) {
     if (bundle.accessibilityId) strategies.push({ using: "accessibility id", value: bundle.accessibilityId });
     if (bundle.resourceId) strategies.push({ using: "id", value: bundle.resourceId });
+    if (bundle.xpath && isIdentityXpath(bundle.xpath)) strategies.push({ using: "xpath", value: bundle.xpath });
     for (const value of [
-      isEditableMobileClassName(bundle.className) ? void 0 : bundle.text,
+      isEditableMobileClassName(bundle.className) || isStateValueMobileClassName(bundle.className) ? void 0 : bundle.text,
       bundle.contentDesc
     ]) {
       const trimmed = value?.trim();
-      if (trimmed) strategies.push({ using: "xpath", value: identityTextXpath2(trimmed) });
+      if (trimmed) strategies.push(...textIdentityStrategies(trimmed, platform3));
     }
-    if (bundle.xpath) strategies.push({ using: "xpath", value: bundle.xpath });
   }
   if (!(platform3 && hasPlatformLocator(target, platform3))) {
-    strategies.push(...locatorStrategyForValue(target.primary));
+    strategies.push(...locatorStrategyForValue(target.primary, platform3));
     for (const fallback of target.fallbacks ?? []) {
-      strategies.push(...locatorStrategyForValue(fallback));
+      strategies.push(...locatorStrategyForValue(fallback, platform3));
     }
   }
   return strategies.filter((strategy) => strategy.using !== "xpath" || isIdentityXpath(strategy.value)).filter(
@@ -354760,12 +354946,31 @@ function identityTextXpath2(value) {
   const lit = xpathLiteral3(value);
   return `//*[@text=${lit} or @content-desc=${lit} or @label=${lit} or @name=${lit} or @value=${lit}]`;
 }
+function iosPredicateLiteral(value) {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function iosTextIdentityPredicate(value) {
+  const lit = iosPredicateLiteral(value);
+  return `label == ${lit} OR name == ${lit} OR value == ${lit}`;
+}
+function textIdentityStrategies(value, platform3) {
+  const strategies = [];
+  if (platform3 === "IOS") {
+    strategies.push({ using: "-ios predicate string", value: iosTextIdentityPredicate(value) });
+  }
+  strategies.push({ using: "xpath", value: identityTextXpath2(value) });
+  return strategies;
+}
+function isIdentityIosPredicate(value) {
+  return /(?:^|[\s(])(?:name|label|value)\s*==\s*"/.test(value) && !/\b(?:CONTAINS|BEGINSWITH|ENDSWITH|LIKE|MATCHES|IN)\b/i.test(value);
+}
 function isIdentityXpath(value) {
   return /@[A-Za-z_:][-A-Za-z0-9_:.]*\s*=/.test(value) && !/(?:contains|starts-with)\s*\(/i.test(value);
 }
 function isIdentityStrategy(strategy) {
   if (strategy.using === "accessibility id" || strategy.using === "id") return true;
   if (strategy.using === "xpath") return isIdentityXpath(strategy.value);
+  if (strategy.using === "-ios predicate string") return isIdentityIosPredicate(strategy.value);
   return false;
 }
 function buildIdentityLocatorStrategies(target, platform3) {
@@ -354775,15 +354980,18 @@ function buildIdentityLocatorStrategies(target, platform3) {
   if (bundle) {
     if (bundle.accessibilityId) strategies.push({ using: "accessibility id", value: bundle.accessibilityId });
     if (bundle.resourceId) strategies.push({ using: "id", value: bundle.resourceId });
-    for (const value of [bundle.text, bundle.contentDesc]) {
+    if (bundle.xpath && isIdentityXpath(bundle.xpath)) strategies.push({ using: "xpath", value: bundle.xpath });
+    for (const value of [
+      isStateValueMobileClassName(bundle.className) ? void 0 : bundle.text,
+      bundle.contentDesc
+    ]) {
       const trimmed = value?.trim();
-      if (trimmed) strategies.push({ using: "xpath", value: identityTextXpath2(trimmed) });
+      if (trimmed) strategies.push(...textIdentityStrategies(trimmed, platform3));
     }
-    if (bundle.xpath && isIdentityXpath(bundle.xpath)) strategies.push({ using: "xpath", value: bundle.xpath });
   }
   if (!(platform3 && hasPlatformLocator(target, platform3))) {
     for (const value of [target.primary, ...target.fallbacks ?? []]) {
-      for (const strategy of locatorStrategyForValue(value)) {
+      for (const strategy of locatorStrategyForValue(value, platform3)) {
         if (isIdentityStrategy(strategy)) strategies.push(strategy);
       }
     }
@@ -354893,7 +355101,7 @@ async function prepareAndroidInputEnvironment(deviceId) {
   ];
   for (const [namespace, key, value] of settingsToDisable) {
     try {
-      await execFileAsync2("adb", ["-s", deviceId, "shell", "settings", "put", namespace, key, value], {
+      await execFileAsync3("adb", ["-s", deviceId, "shell", "settings", "put", namespace, key, value], {
         timeout: 8e3,
         windowsHide: true
       });
@@ -354905,14 +355113,14 @@ async function sendAndroidTextToFocusedInput(deviceId, value) {
   if (!deviceId) {
     throw new Error("Android keyboard fallback requires a device id");
   }
-  await execFileAsync2("adb", ["-s", deviceId, "shell", "input", "text", encodeAndroidInputText(value)], {
+  await execFileAsync3("adb", ["-s", deviceId, "shell", "input", "text", encodeAndroidInputText(value)], {
     timeout: 1e4,
     windowsHide: true
   });
 }
 async function pressAndroidKeyboardEnter(deviceId) {
   if (!deviceId) throw new Error("Android keyboard Enter fallback requires a device id");
-  await execFileAsync2("adb", ["-s", deviceId, "shell", "input", "keyevent", "66"], {
+  await execFileAsync3("adb", ["-s", deviceId, "shell", "input", "keyevent", "66"], {
     timeout: 1e4,
     windowsHide: true
   });
@@ -355433,7 +355641,14 @@ async function executeMobileTest(options) {
       const resetAllowed = shouldResetMobileAppData(options.target.platform, selectedDevice.id);
       if (resetAllowed) {
         try {
-          await executeMobileScript(sessionId, "mobile: clearApp", [{ appId: options.target.appId }]);
+          if (options.target.platform === "IOS") {
+            await terminateTargetApp(sessionId, "IOS", options.target.appId).catch(() => {
+            });
+            const wiped = await clearIosSimulatorAppData(selectedDevice.id, options.target.appId);
+            if (!wiped.ok) throw new Error(wiped.detail);
+          } else {
+            await executeMobileScript(sessionId, "mobile: clearApp", [{ appId: options.target.appId }]);
+          }
           clearedAppDataBeforeLaunch = true;
           log2(resetPolicy === "CLEAR_APP_DATA" ? "App data cleared before launch (target resetPolicy=CLEAR_APP_DATA)." : "App data cleared before launch (test was recorded from a cold logged-out state).");
         } catch (err) {
@@ -355778,8 +355993,7 @@ async function readElementAttribute(sessionId, elementId, name) {
 function harvestFallbackXpath(platform3, attrs) {
   if (platform3 === "IOS") {
     if (attrs.name) return `//*[@name=${xpathLiteral3(attrs.name)}]`;
-    const text = attrs.label ?? attrs.value;
-    if (text) return identityTextXpath2(text);
+    if (attrs.text) return identityTextXpath2(attrs.text);
     return "//*";
   }
   if (attrs.resourceId) return `//*[@resource-id=${xpathLiteral3(attrs.resourceId)}]`;
@@ -355789,14 +356003,15 @@ function harvestFallbackXpath(platform3, attrs) {
 }
 async function readNativeElementBundle(sessionId, elementId, platform3) {
   const className = await readElementAttribute(sessionId, elementId, platform3 === "IOS" ? "type" : "class") ?? "";
+  const volatileText = isEditableMobileClassName(className) || isStateValueMobileClassName(className);
   if (platform3 === "IOS") {
     const name = await readElementAttribute(sessionId, elementId, "name");
     const label = await readElementAttribute(sessionId, elementId, "label");
     const value = await readElementAttribute(sessionId, elementId, "value");
-    const text2 = label ?? value;
+    const text2 = label ?? (volatileText ? void 0 : value);
     if (!name && !text2) return null;
     const bundle2 = {
-      xpath: harvestFallbackXpath("IOS", { name, label, value }),
+      xpath: harvestFallbackXpath("IOS", { name, text: text2 }),
       className
     };
     if (name) bundle2.accessibilityId = name;
@@ -355805,7 +356020,8 @@ async function readNativeElementBundle(sessionId, elementId, platform3) {
   }
   const resourceId = await readElementAttribute(sessionId, elementId, "resource-id");
   const contentDesc = await readElementAttribute(sessionId, elementId, "content-desc") ?? await readElementAttribute(sessionId, elementId, "contentDescription");
-  const text = await readElementAttribute(sessionId, elementId, "text");
+  const rawText = await readElementAttribute(sessionId, elementId, "text");
+  const text = volatileText ? void 0 : rawText;
   if (!resourceId && !contentDesc && !text) return null;
   const bundle = {
     xpath: harvestFallbackXpath("ANDROID", { text, contentDesc, resourceId }),
@@ -356093,7 +356309,7 @@ import { createServer } from "http";
 import { execFileSync as execFileSync4 } from "child_process";
 import { randomBytes, timingSafeEqual } from "crypto";
 import { homedir as homedir2 } from "os";
-import { join as join5, dirname } from "path";
+import { join as join6, dirname } from "path";
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, mkdirSync as mkdirSync3 } from "fs";
 init_dist();
 var MOBILE_BRIDGE_PORT2 = 9515;
@@ -356200,7 +356416,7 @@ async function getWindowSize3() {
 }
 var BRIDGE_PROCESS_MARKER = "validateqa-mobile-bridge";
 var BRIDGE_PORT = MOBILE_BRIDGE_PORT2;
-var BRIDGE_PID_FILE = join5(homedir2(), ".validate.qa", "mobile-bridge.pid");
+var BRIDGE_PID_FILE = join6(homedir2(), ".validate.qa", "mobile-bridge.pid");
 function readBridgePidFile() {
   try {
     const raw = readFileSync2(BRIDGE_PID_FILE, "utf-8").trim();
@@ -357338,6 +357554,7 @@ var MobileBridgeDriver = class {
   sessionId;
   platform;
   appId;
+  deviceId;
   allowAppReset;
   recoverSession;
   maxSessionRecoveries;
@@ -357358,6 +357575,7 @@ var MobileBridgeDriver = class {
     this.sessionId = config.sessionId;
     this.platform = config.platform;
     this.appId = config.appId;
+    this.deviceId = config.deviceId;
     this.allowAppReset = config.allowAppReset === true;
     this.recoverSession = config.recoverSession;
     this.maxSessionRecoveries = Math.max(0, Math.floor(config.maxSessionRecoveries ?? 1));
@@ -357655,17 +357873,34 @@ var MobileBridgeDriver = class {
     });
   }
   /**
-   * Deterministic state reset: clear app data + relaunch (Android emulators
-   * only, per the runner-computed allowAppReset policy). Returns false when
-   * unsupported/disallowed or when clearApp throws — callers fall back to
-   * relaunch(), preserving today's behavior. On success, waits for cold-boot
-   * content so recording and replay agree on the true entry screen.
+   * Deterministic state reset: clear app data + relaunch, per the
+   * runner-computed allowAppReset policy (Android emulators / iOS simulators
+   * only — a personal physical device is never wiped). Android clears via
+   * `mobile: clearApp`; iOS terminates the app and wipes its simulator data
+   * container + keychain through `simctl` (see ios-simulator-reset.ts).
+   * Returns false when unsupported/disallowed or when the clear fails —
+   * callers fall back to relaunch(), preserving today's behavior. On success,
+   * waits for cold-boot content so recording and replay agree on the true
+   * entry screen.
    */
   async resetAppState() {
-    if (!this.allowAppReset || this.platform !== "ANDROID") return false;
+    if (!this.allowAppReset) return false;
+    if (this.platform === "IOS" && !isIosSimulatorUdid(this.deviceId)) return false;
     return this.withSessionRecovery("app data reset", async () => {
       try {
-        await this.executeScript("mobile: clearApp", [{ appId: this.appId }]);
+        if (this.platform === "IOS") {
+          try {
+            await this.executeScript("mobile: terminateApp", [{ ...this.appLifecycleArgs(), timeout: 5e3 }]);
+          } catch (err) {
+            if (isRecoverableAppiumSessionFailure(err)) throw err;
+          }
+          const wiped = await clearIosSimulatorAppData(this.deviceId ?? "", this.appId);
+          if (!wiped.ok) {
+            throw new Error(`iOS simulator app-data reset failed: ${wiped.detail}`);
+          }
+        } else {
+          await this.executeScript("mobile: clearApp", [{ appId: this.appId }]);
+        }
         await this.executeScript("mobile: activateApp", [this.appLifecycleArgs()]);
         try {
           await waitForColdBootSettle(this.sessionPath);
@@ -358331,7 +358566,7 @@ var log = {
   dim: (msg) => console.log(`${C2.gray}${msg}${C2.reset}`)
 };
 function getRunsDir() {
-  const dir = process.env.RUNS_DIR || join6(homedir3(), ".validate.qa", "runs");
+  const dir = process.env.RUNS_DIR || join7(homedir3(), ".validate.qa", "runs");
   (0, import_runner_core12.ensurePrivateDirectory)(dir);
   return dir;
 }
@@ -360263,9 +360498,11 @@ ${finalVerifyResult.logs ?? ""}`;
               sessionId: session.sessionId,
               platform: platform3,
               appId: session.appId,
-              // Deterministic-state authorization: Android emulators only by
-              // default (VALIDATEQA_MOBILE_APP_RESET overrides) — a personal
-              // physical device must never have its app data wiped.
+              deviceId: session.deviceId,
+              // Deterministic-state authorization: Android emulators / iOS
+              // simulators only (VALIDATEQA_MOBILE_APP_RESET overrides the
+              // Android default) — a personal physical device must never have
+              // its app data wiped.
               allowAppReset: mobileTarget.resetPolicy !== "PRESERVE_APP_DATA" && shouldResetMobileAppData(platform3, session.deviceId),
               maxSessionRecoveries: 1,
               recoverSession: async (cause) => {
@@ -360781,6 +361018,7 @@ ${finalVerifyResult.logs ?? ""}`;
                   sessionId: opened.sessionId,
                   platform: target.platform,
                   appId: opened.appId,
+                  deviceId: opened.deviceId,
                   allowAppReset: target.resetPolicy !== "PRESERVE_APP_DATA" && shouldResetMobileAppData(target.platform, opened.deviceId)
                 });
               };