@validate.qa/runner 1.0.50 → 1.0.51

package/dist/cli.js

@@ -344007,7 +344007,18 @@ var require_import_diff = __commonJS({
       "cypress",
       "acceptance",
       "playwright",
-      "selenium"
+      "selenium",
+      "appium",
+      "maestro",
+      "detox",
+      "espresso",
+      "xcuitest",
+      "xctest",
+      "uitest",
+      "androidtest",
+      "instrumentation",
+      "mobile",
+      "e2e-mobile"
     ]);
     var NON_TEST_SEGMENTS = /* @__PURE__ */ new Set([
       "support",
@@ -344093,6 +344104,14 @@ var require_import_diff = __commonJS({
         return false;
       if (/\.(spec|test|cy|e2e)\.[cm]?[jt]sx?$/i.test(base2))
         return true;
+      if (/\.maestro\.ya?ml$/i.test(base2))
+        return true;
+      if (p.includes("/maestro/") && /\.ya?ml$/i.test(base2))
+        return true;
+      if (/\.e2e\.[cm]?[jt]sx?$/i.test(base2))
+        return true;
+      if (/^test_.*mobile.*\.py$/i.test(base2) || /_mobile_test\.py$/i.test(base2))
+        return true;
       if (/\.feature$/i.test(base2))
         return true;
       if (/\.robot$/i.test(base2)) {
@@ -344134,6 +344153,18 @@ var require_import_diff = __commonJS({
           return p.endsWith(".feature");
         case "robot":
           return p.endsWith(".robot");
+        case "appium":
+          return p.includes("appium/") || /appium|wdio/i.test(p);
+        case "webdriverio":
+          return p.includes("wdio") || /\.e2e\.[cm]?[jt]sx?$/.test(p);
+        case "detox":
+          return p.includes("e2e/") || /\.e2e\.[cm]?[jt]sx?$/.test(p);
+        case "maestro":
+          return p.includes("maestro/") || /\.maestro\.ya?ml$/.test(p);
+        case "espresso":
+          return p.includes("androidtest/") || /espresso/i.test(p);
+        case "xcuitest":
+          return p.includes("uitest/") || /xcuitest/i.test(p);
         default:
           return false;
       }
@@ -344601,6 +344632,255 @@ Aim for COMPLETE coverage of the repo's tests.`;
   }
 });
 
+// ../runner-core/dist/services/framework-import-mobile-prompts.js
+var require_framework_import_mobile_prompts = __commonJS({
+  "../runner-core/dist/services/framework-import-mobile-prompts.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.MOBILE_IMPORT_SCHEMA_VERSION = void 0;
+    exports2.buildMobileImportContractMd = buildMobileImportContractMd;
+    exports2.buildMobileImportSystemRules = buildMobileImportSystemRules;
+    exports2.buildMobileImportKickoff = buildMobileImportKickoff;
+    exports2.validateImportedMobileTest = validateImportedMobileTest;
+    var shared_1 = (init_dist(), __toCommonJS(dist_exports));
+    var import_diff_js_1 = require_import_diff();
+    exports2.MOBILE_IMPORT_SCHEMA_VERSION = 1;
+    var MOBILE_STEP_ACTIONS2 = new Set(shared_1.MOBILE_STEP_TYPES);
+    var MAX_IMPORTED_MOBILE_STEPS = 300;
+    function buildMobileImportContractMd(input) {
+      const mdSafe = (v, max = 200) => String(v ?? "").replace(/[`\r\n#>*|[\]]/g, " ").trim().slice(0, max);
+      const pathSafe = (v) => String(v ?? "").replace(/[`\r\n]/g, " ");
+      const creds = input.credentialKeys && input.credentialKeys.length > 0 ? input.credentialKeys.map((k) => mdSafe(k, 100)).filter(Boolean).join(", ") : "(none configured)";
+      const vars = input.testVariableKeys && input.testVariableKeys.length > 0 ? input.testVariableKeys.map((k) => mdSafe(k, 100)).filter(Boolean).join(", ") : "(none)";
+      const existing = input.existingFeatureNames && input.existingFeatureNames.length > 0 ? input.existingFeatureNames.map((n) => `- ${mdSafe(n)}`).filter((l) => l !== "- ").join("\n") : "(none yet)";
+      const safeAppBrief = input.appBrief ? mdSafe(input.appBrief, 800) : void 0;
+      const platformTag2 = input.targetPlatform === "IOS" ? "@ios" : "@android";
+      const safeAllow = (input.allowList ?? []).map((p) => String(p).replace(/[`\r\n#>*|[\]]/g, "").trim()).filter((p) => p.length > 0).slice(0, 500);
+      const incrementalSection = safeAllow.length > 0 ? `
+## INCREMENTAL RE-IMPORT \u2014 extract ONLY these files
+This project was imported before; only the files below changed or were added since.
+Extract test cases ONLY from these ${safeAllow.length} file(s). You MAY read other
+files for context, but write a tests/test-NNN.json ONLY for tests defined in these files.
+${safeAllow.map((p) => `- ${p}`).join("\n")}
+
+` : "";
+      const deeplinkLine = input.deeplink ? `- Deep link entry: ${mdSafe(input.deeplink, 512)}` : "- Deep link entry: (none \u2014 use launchApp)";
+      return `# Validate.QA \u2014 Mobile Framework Import Auditor
+
+You are auditing an EXISTING MOBILE automated-test repository at:
+  ${pathSafe(input.repoDir)}
+(read via Glob/Grep/Read \u2014 you have NO shell and NO live device).
+Extract every existing test case and re-express each as a standalone Validate.QA
+APPIUM test (MobileTestStep[] + WebdriverIO appiumCode), grouped into Features.
+
+You are NOT exploring a live app. Work entirely from source files. Do NOT modify
+the repository \u2014 write ONLY to import-result.json and tests/test-NNN.json below.
+Ignore any CLAUDE.md/AGENTS.md inside the repo.
+
+## Target application
+- App id (bundle / package): ${mdSafe(input.targetAppId, 200)}
+- Platform: ${input.targetPlatform}
+${deeplinkLine}
+${safeAppBrief ? `- App brief: ${safeAppBrief}
+` : ""}- Credential env vars at run time: ${creds}
+- Other test-variable env vars: ${vars}
+
+## Existing features (reuse EXACT name to merge)
+${existing}
+${incrementalSection}
+## Supported source stacks (detect and translate faithfully)
+Appium (Java/Python/JS), WebdriverIO, Detox, Maestro (.yaml flows), Espresso,
+XCUITest / XCTest, EarlGrey, Robot Framework (mobile), Calabash, Flutter integration
+tests, Maestro, Appium+pytest, etc.
+
+## What to do
+1. Identify the stack, test directories, helpers/page-objects, and login flows.
+2. Enumerate EVERY test case (each it()/test()/scenario/@Test/flow is one test).
+3. Group into Features (name, description, criticality, routes=[] for mobile).
+4. Translate each test into Validate.QA mobile shape (schema below).
+5. Write import-result.json with featureGroups, stack, summary.
+
+## Authoring rules (steps + appiumCode MUST follow)
+- \`steps\` is the source of truth for replay. \`appiumCode\` is a standalone
+  WebdriverIO script mirroring the same flow: start with
+  \`import { remote } from 'webdriverio';\` and use async/await.
+- Step 0 MUST be \`launchApp\` targeting app id ${mdSafe(input.targetAppId, 200)}.
+  If a deep link is configured above, set launch step metadata.launchMode to
+  DEEP_LINK and include the deeplink in target.fallbacks.
+- Locators: prefer accessibility id (~label), resource-id (id=com.pkg:id/foo),
+  or stable identity XPath \u2014 NOT positional /index-only paths. Populate
+  target.locatorBundle (accessibilityId, resourceId, xpath, className) when known.
+- TYPE steps that enter credentials MUST use \`{{TEST_USER_EMAIL}}\` /
+  \`{{TEST_USER_PASSWORD}}\` placeholders in \`value\` (never hardcode secrets).
+- Include at least one \`assertVisible\` or \`assertText\` step per test. If the
+  source had no assertion, add a best-effort outcome check and tag \`@needs-review\`.
+- Tag every test \`@imported\` plus ${platformTag2}. Add \`@smoke\`/\`@critical\` when
+  the source implies it. Login-flow tests: \`@auth\`. Tests needing prior login: inline
+  login steps at the start + \`@needs-auth\`.
+- \`sourceFile\` REQUIRED: repo-relative path of the original test file.
+
+## Imported-test schema \u2014 tests/test-NNN.json
+\`\`\`json
+{
+  "schemaVersion": 1,
+  "name": "logs in with valid credentials",
+  "description": "Verifies login with valid credentials.",
+  "suiteName": "Authentication",
+  "testType": "UI",
+  "sourceFile": "e2e/login_test.py",
+  "tags": ["@imported", "${platformTag2}", "@smoke"],
+  "appiumCode": "import { remote } from 'webdriverio';\\n\\nasync function main() {\\n  const driver = await remote({ capabilities: { platformName: '${input.targetPlatform === "IOS" ? "iOS" : "Android"}', 'appium:automationName': '${input.targetPlatform === "IOS" ? "XCUITest" : "UiAutomator2"}', '${input.targetPlatform === "IOS" ? "appium:bundleId" : "appium:appPackage"}': '${mdSafe(input.targetAppId, 120)}' } });\\n  try { /* steps */ } finally { await driver.deleteSession(); }\\n}\\n\\nvoid main();\\n",
+  "steps": [
+    {
+      "order": 0,
+      "action": "launchApp",
+      "description": "Launch ${mdSafe(input.targetAppId, 120)}",
+      "target": { "primary": "${mdSafe(input.targetAppId, 120)}", "fallbacks": [], "screenName": "Launch" },
+      "metadata": { "launchMode": "LAUNCH_APP", "platform": "${input.targetPlatform}" }
+    },
+    {
+      "order": 1,
+      "action": "tap",
+      "description": "Tap Sign In",
+      "target": {
+        "primary": "~Sign In",
+        "fallbacks": [],
+        "screenName": "LoginScreen",
+        "locatorBundle": { "xpath": "//android.widget.Button[@content-desc=\\"Sign In\\"]", "className": "android.widget.Button", "contentDesc": "Sign In" }
+      }
+    }
+  ]
+}
+\`\`\`
+
+## Result schema \u2014 import-result.json
+Same as web import: schemaVersion, stack, summary, featureGroups[].
+
+Write valid JSON only (no markdown fences inside files). Be exhaustive.`;
+    }
+    function buildMobileImportSystemRules() {
+      return [
+        "## Mobile Framework Import \u2014 invariant rules",
+        "",
+        "Extract existing MOBILE tests into Validate.QA APPIUM shape. NO live device.",
+        "Write ONLY import-result.json and tests/test-NNN.json in your working directory.",
+        "Never modify the audited repository.",
+        "",
+        "Each test MUST include: appiumCode (standalone WebdriverIO), steps (ordered",
+        "MobileTestStep[] with launchApp first), tags including @imported and @ios or",
+        "@android, suiteName matching a featureGroup, and sourceFile (repo-relative).",
+        "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.",
+        "Write strictly valid JSON."
+      ].join("\n");
+    }
+    function buildMobileImportKickoff() {
+      return [
+        "Begin Mobile Framework Import.",
+        "Read CLAUDE.md, audit the mobile test repository, extract every test into",
+        "tests/test-NNN.json (Appium steps + WebdriverIO code) and write import-result.json.",
+        "Be exhaustive."
+      ].join(" ");
+    }
+    function isNonEmptyString(v) {
+      return typeof v === "string" && v.trim().length > 0;
+    }
+    function isPlainObject2(value) {
+      return !!value && typeof value === "object" && !Array.isArray(value);
+    }
+    function isValidStep(value) {
+      if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+      const s = value;
+      if (typeof s.order !== "number" || !Number.isFinite(s.order))
+        return false;
+      if (!isNonEmptyString(s.action) || !MOBILE_STEP_ACTIONS2.has(s.action))
+        return false;
+      if (!isNonEmptyString(s.description))
+        return false;
+      if (s.value !== void 0 && typeof s.value !== "string")
+        return false;
+      if (s.assertion !== void 0 && typeof s.assertion !== "string")
+        return false;
+      if (s.metadata !== void 0 && !isPlainObject2(s.metadata))
+        return false;
+      if (s.platforms !== void 0 && (!Array.isArray(s.platforms) || s.platforms.some((p) => p !== "IOS" && p !== "ANDROID")))
+        return false;
+      if (s.target !== void 0) {
+        if (!isPlainObject2(s.target) || !isNonEmptyString(s.target.primary))
+          return false;
+        if (s.target.fallbacks !== void 0 && (!Array.isArray(s.target.fallbacks) || s.target.fallbacks.some((v) => typeof v !== "string")))
+          return false;
+        if (s.target.screenName !== void 0 && typeof s.target.screenName !== "string")
+          return false;
+        if (s.target.locatorBundle !== void 0) {
+          if (!isPlainObject2(s.target.locatorBundle))
+            return false;
+          if (Object.values(s.target.locatorBundle).some((v) => v !== void 0 && typeof v !== "string"))
+            return false;
+        }
+      }
+      return true;
+    }
+    function validateImportedMobileTest(value, defaultSuite, platformTag2) {
+      if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return { ok: false, reason: "not an object" };
+      }
+      const o = value;
+      if (!isNonEmptyString(o.name))
+        return { ok: false, reason: "name: missing" };
+      if (!isNonEmptyString(o.appiumCode))
+        return { ok: false, reason: "appiumCode: missing" };
+      const code = o.appiumCode;
+      if (!/webdriverio|remote\s*\(|driver\s*\./i.test(code)) {
+        return { ok: false, reason: "appiumCode: not a WebdriverIO/Appium script" };
+      }
+      if (!Array.isArray(o.steps) || o.steps.length === 0) {
+        return { ok: false, reason: "steps: missing or empty" };
+      }
+      if (o.steps.length > MAX_IMPORTED_MOBILE_STEPS) {
+        return { ok: false, reason: `steps: exceeds ${MAX_IMPORTED_MOBILE_STEPS} step limit` };
+      }
+      if (!o.steps.every(isValidStep)) {
+        return { ok: false, reason: "steps: invalid step shape" };
+      }
+      const steps = o.steps.map((step, order) => ({
+        ...step,
+        order,
+        description: step.description.trim().slice(0, 500)
+      }));
+      if (steps[0]?.action !== "launchApp") {
+        return { ok: false, reason: "steps: first step must be launchApp" };
+      }
+      const rawTags = Array.isArray(o.tags) ? o.tags.filter(isNonEmptyString) : [];
+      const testType = typeof o.testType === "string" && o.testType.trim().toUpperCase() === "API" ? "API" : "UI";
+      const tagSet = /* @__PURE__ */ new Set([...rawTags, "@imported", "@mobile", ...testType === "API" ? ["@api"] : []]);
+      if (platformTag2)
+        tagSet.add(platformTag2);
+      const hasAssertion = steps.some((s) => s.action === "assertVisible" || s.action === "assertText");
+      if (!hasAssertion)
+        tagSet.add("@needs-review");
+      const suiteName = isNonEmptyString(o.suiteName) ? o.suiteName.trim() : defaultSuite && defaultSuite.trim().length > 0 ? defaultSuite.trim() : "Imported Tests";
+      const sourceFile = (0, import_diff_js_1.sanitizeRepoRelPath)(typeof o.sourceFile === "string" ? o.sourceFile : "") ?? void 0;
+      return {
+        ok: true,
+        value: {
+          schemaVersion: 1,
+          name: o.name.trim().slice(0, 200),
+          description: isNonEmptyString(o.description) ? o.description.trim().slice(0, 1e3) : "",
+          suiteName: suiteName.slice(0, 200),
+          testType,
+          tags: Array.from(tagSet),
+          appiumCode: code,
+          steps,
+          ...sourceFile ? { sourceFile } : {}
+        }
+      };
+    }
+  }
+});
+
 // ../runner-core/dist/types/discovery.js
 var require_discovery = __commonJS({
   "../runner-core/dist/types/discovery.js"(exports2) {
@@ -344626,9 +344906,11 @@ var require_framework_import_runner = __commonJS({
     var promises_1 = require("fs/promises");
     var node_os_1 = require("os");
     var node_path_1 = require("path");
+    var shared_1 = (init_dist(), __toCommonJS(dist_exports));
     var claude_cli_js_1 = require_claude_cli();
     var repo_acquire_js_1 = require_repo_acquire();
     var framework_import_prompts_js_1 = require_framework_import_prompts();
+    var framework_import_mobile_prompts_js_1 = require_framework_import_mobile_prompts();
     var import_diff_js_1 = require_import_diff();
     var agentic_cli_constants_js_1 = require_agentic_cli_constants();
     var discovery_js_1 = require_discovery();
@@ -344645,9 +344927,18 @@ var require_framework_import_runner = __commonJS({
       const imp = ctx.frameworkImport;
       if (!imp)
         throw new Error("runFrameworkImportOnRunner: ctx.frameworkImport is required");
+      const isMobileImport = ctx.medium === "IOS_NATIVE" || ctx.medium === "ANDROID_NATIVE" || imp.platform === "mobile";
+      const targetObj = ctx.target && typeof ctx.target === "object" && !Array.isArray(ctx.target) ? ctx.target : null;
+      const targetPlatform = targetObj?.platform === "IOS" || ctx.medium === "IOS_NATIVE" ? "IOS" : "ANDROID";
+      const targetAppId = typeof targetObj?.appId === "string" ? targetObj.appId.trim() : "";
+      if (isMobileImport && !targetAppId) {
+        throw new Error("Mobile framework import requires target.appId (bundle/package id)");
+      }
+      const platformTag2 = targetPlatform === "IOS" ? "@ios" : "@android";
+      const deeplink = typeof targetObj?.deeplink === "string" ? targetObj.deeplink.trim() : void 0;
       const provider = "anthropic";
       const model = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
-      log2("=== Framework Import Runner (Claude CLI, no browser) ===");
+      log2(`=== Framework Import Runner (Claude CLI, no browser${isMobileImport ? ", mobile\u2192Appium" : ", web\u2192Playwright"}) ===`);
       log2(`Source: ${imp.source}${imp.source === "github" ? ` (${imp.repoOwner}/${imp.repoName}@${imp.branch ?? "default"})` : ""}`);
       const runDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "framework-import-"));
       const testsDir = (0, node_path_1.join)(runDir, "tests");
@@ -344707,7 +344998,7 @@ var require_framework_import_runner = __commonJS({
         const credentialKeys = ["TEST_USER_EMAIL", "TEST_USER_PASSWORD"].filter((k) => (ctx.variableContext.availableVariableKeys ?? []).includes(k));
         const allKeys = ctx.variableContext.availableVariableKeys ?? [];
         const testVariableKeys = allKeys.filter((k) => !credentialKeys.includes(k));
-        await (0, promises_1.writeFile)(contractPath, (0, framework_import_prompts_js_1.buildImportContractMd)({
+        const contractInput = {
           repoDir,
           baseUrl: ctx.baseUrl,
           appBrief: ctx.appBrief,
@@ -344717,7 +345008,14 @@ var require_framework_import_runner = __commonJS({
           resultPath,
           testsDir,
           allowList: effectiveIncremental ? allowList : void 0
-        }), "utf8");
+        };
+        const contractMd = isMobileImport ? (0, framework_import_mobile_prompts_js_1.buildMobileImportContractMd)({
+          ...contractInput,
+          targetAppId,
+          targetPlatform,
+          deeplink
+        }) : (0, framework_import_prompts_js_1.buildImportContractMd)(contractInput);
+        await (0, promises_1.writeFile)(contractPath, contractMd, "utf8");
         const mcpConfigPath = (0, node_path_1.join)(runDir, "mcp-config.json");
         await (0, promises_1.writeFile)(mcpConfigPath, JSON.stringify({ mcpServers: {} }), "utf8");
         log2("Wrote CLAUDE.md auditor contract + tests/ dir + locked-down mcp-config.json");
@@ -344729,8 +345027,8 @@ var require_framework_import_runner = __commonJS({
           log2(`Spawning claude (${provider}/${model}) \u2014 auditing repo${effectiveIncremental ? ` (${allowList?.length} changed/added file(s))` : ""}\u2026`);
           try {
             const result = await (0, claude_cli_js_1.runClaude)({
-              prompt: (0, framework_import_prompts_js_1.buildImportKickoff)(),
-              appendSystemPrompt: (0, framework_import_prompts_js_1.buildImportSystemRules)(),
+              prompt: isMobileImport ? (0, framework_import_mobile_prompts_js_1.buildMobileImportKickoff)() : (0, framework_import_prompts_js_1.buildImportKickoff)(),
+              appendSystemPrompt: isMobileImport ? (0, framework_import_mobile_prompts_js_1.buildMobileImportSystemRules)() : (0, framework_import_prompts_js_1.buildImportSystemRules)(),
               model,
               provider,
               timeoutMs: options.timeoutMs ?? IMPORT_TIMEOUT_MS,
@@ -344791,12 +345089,22 @@ var require_framework_import_runner = __commonJS({
             log2(`[harvest] ${file}: unreadable/invalid JSON \u2014 skipped (${err instanceof Error ? err.message : String(err)})`);
             continue;
           }
-          const v = (0, framework_import_prompts_js_1.validateImportedTest)(parsed, defaultSuite);
+          const v = isMobileImport ? (0, framework_import_mobile_prompts_js_1.validateImportedMobileTest)(parsed, defaultSuite, platformTag2) : (0, framework_import_prompts_js_1.validateImportedTest)(parsed, defaultSuite);
           if (!v.ok) {
             dropped++;
             log2(`[harvest] ${file}: ${v.reason} \u2014 skipped`);
             continue;
           }
+          let compiledAppiumCode;
+          if (isMobileImport && "steps" in v.value) {
+            try {
+              compiledAppiumCode = (0, shared_1.buildAppiumCode)(v.value.name, ctx.target ?? null, v.value.steps);
+            } catch (err) {
+              dropped++;
+              log2(`[harvest] ${file}: could not compile Appium export \u2014 skipped (${err instanceof Error ? err.message : String(err)})`);
+              continue;
+            }
+          }
           const normSuite = v.value.suiteName.toLowerCase().trim();
           const existingGroup = featureGroups.find((g) => g.name.toLowerCase().trim() === normSuite);
           const canonicalSuite = existingGroup ? existingGroup.name : v.value.suiteName;
@@ -344809,7 +345117,20 @@ var require_framework_import_runner = __commonJS({
           const safeSource = v.value.sourceFile ? (0, import_diff_js_1.sanitizeRepoRelPath)(v.value.sourceFile, repoDir) : null;
           if (safeSource)
             extractedFiles.add(safeSource);
-          const test = {
+          const test = isMobileImport && "appiumCode" in v.value ? {
+            name: v.value.name,
+            description: v.value.description,
+            playwrightCode: "",
+            framework: "APPIUM",
+            appiumCode: compiledAppiumCode,
+            steps: v.value.steps,
+            tags: v.value.tags,
+            suiteName: canonicalSuite,
+            testType: v.value.testType,
+            verified: false,
+            ...safeSource ? { sourceFile: safeSource } : {},
+            ...effectiveIncremental ? { importOverwrite: true } : {}
+          } : {
             name: v.value.name,
             description: v.value.description,
             playwrightCode: v.value.playwrightCode,
@@ -344818,9 +345139,6 @@ var require_framework_import_runner = __commonJS({
             testType: v.value.testType,
             verified: false,
             ...safeSource ? { sourceFile: safeSource } : {},
-            // In an incremental run every streamed test came from a changed/added file, so
-            // the server should UPDATE its existing imported row in place (and re-verify)
-            // instead of preserving stale ACTIVE code. Harmless for added files (no row yet).
             ...effectiveIncremental ? { importOverwrite: true } : {}
           };
           capturedTests.push(test);
@@ -347005,8 +347323,8 @@ var require_dist2 = __commonJS({
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.acquireRepoForImport = exports2.runFrameworkImportOnRunner = exports2.getAgenticEngine = exports2.resolveRefFromSnapshot = exports2.replayAuthRecipeIntoBrowser = exports2.runRegisterCaptureRun = exports2.runLoginCaptureRun = exports2.filterLoginCaptureCredentials = exports2.buildLoginCaptureCredentials = exports2.isReservedRunnerEnvVar = exports2.RESERVED_RUNNER_ENV_VARS = exports2.AUTH_MARKER_VERSION = exports2.buildHealAuthStamp = exports2.extractAuthRegion = exports2.upsertAuthBlock = exports2.buildAuthRecipe = exports2.commandToReplayStep = exports2.buildReplayPlan = exports2.absoluteRoute = exports2.renderReplaySettleArrow = exports2.renderReplayClickArrow = exports2.renderAuthFn = exports2.filterFeatureGroupsToPathScope = exports2.isAuthFlowRoute = exports2.deriveSurveyPathScope = exports2.canonicalizeRoute = exports2.executeGrokPerBatchHeal = exports2.executeGrokPerTestHeal = exports2.headerVal = exports2.classifyAuthType = exports2.isTextExcerptable = exports2.isStaticAssetByExt = exports2.isApiCall = exports2.buildApiCallSummary = exports2.computeMobileHealOutcome = exports2.detectMobileStepSecretLeak = exports2.redactMobileSecretsFromText = exports2.MOBILE_LIVE_HEAL_SYSTEM_PROMPT = exports2.MOBILE_SCRIPT_HEAL_SYSTEM_PROMPT = exports2.executeMobileLiveHeal = exports2.executeMobileTestWithHealing = exports2.executeMobileScriptDrivenHeal = exports2.prepareMobileScenarioAppState = exports2.runMobileGeneratePhase = exports2.runMobileAIPlanner = exports2.buildMobileSiteMap = exports2.formatMobileEvidenceForPlanner = exports2.MOBILE_SCENARIO_SYSTEM_PROMPT = exports2.MOBILE_SURVEY_SYSTEM_PROMPT = exports2.runMobileExplorePhase = void 0;
-    exports2.isSafeCanonicalRedirect = exports2.resolveBaseUrlPreflight = exports2.checkBaseUrlRedirect = exports2.stripJsonFences = exports2.scrubCredentials = exports2.withAIRetry = exports2.snapshotMatchingChildren = exports2.findNewChromiumChildPid = exports2.killProcessTree = exports2.gracefulCloseWithTreeKill = exports2.liveBrowserRegistry = exports2.REPO_SWITCH_REMOVED_FRACTION = exports2.MAX_MANIFEST_FILES = exports2.toDiffSummary = exports2.isLikelyTestFile = exports2.sanitizeRepoRelPath = exports2.sha256Hex = exports2.hashFiles = exports2.enumerateTestFiles = exports2.buildNextManifest = exports2.detectRepoSwitch = exports2.classifyImportDiff = exports2.parseImportManifest = exports2.REPO_ANALYSIS_SCHEMA_VERSION = exports2.validateSourceEndpoints = exports2.validateAuthoredTest = exports2.validateRepoMapFile = exports2.validateRepoMemoryFile = exports2.buildTestingStandardsSection = exports2.buildRepoAuthorSystemRules = exports2.buildRepoAuthorKickoff = exports2.buildRepoAuthorContractMd = exports2.buildRepoMapSystemRules = exports2.buildRepoMapKickoff = exports2.buildRepoMapContractMd = exports2.buildRepoMemorySystemRules = exports2.buildRepoMemoryKickoff = exports2.buildRepoMemoryContractMd = exports2.runRepoAnalysisOnRunner = exports2.IMPORT_SCHEMA_VERSION = exports2.validateImportResultFile = exports2.validateImportedTest = exports2.buildImportSystemRules = exports2.buildImportKickoff = exports2.buildImportContractMd = exports2.MAX_ARCHIVE_BYTES = exports2.isUnsafeEntryName = exports2.extractZipSafely = exports2.downloadArchiveCapped = exports2.detectArchiveKind = void 0;
-    exports2.UNSUPPORTED_RENDERER_PREFIX = exports2.UnsupportedRendererError = exports2.buildCanvasModeAuthoringAddendum = exports2.buildUnsupportedRendererMessage = exports2.modelSupportsVision = exports2.decideCanvasStrategy = exports2.decideAppRenderType = exports2.detectCanvasApp = exports2.detectRateLimitBlock = void 0;
+    exports2.withAIRetry = exports2.snapshotMatchingChildren = exports2.findNewChromiumChildPid = exports2.killProcessTree = exports2.gracefulCloseWithTreeKill = exports2.liveBrowserRegistry = exports2.REPO_SWITCH_REMOVED_FRACTION = exports2.MAX_MANIFEST_FILES = exports2.toDiffSummary = exports2.isLikelyTestFile = exports2.sanitizeRepoRelPath = exports2.sha256Hex = exports2.hashFiles = exports2.enumerateTestFiles = exports2.buildNextManifest = exports2.detectRepoSwitch = exports2.classifyImportDiff = exports2.parseImportManifest = exports2.REPO_ANALYSIS_SCHEMA_VERSION = exports2.validateSourceEndpoints = exports2.validateAuthoredTest = exports2.validateRepoMapFile = exports2.validateRepoMemoryFile = exports2.buildTestingStandardsSection = exports2.buildRepoAuthorSystemRules = exports2.buildRepoAuthorKickoff = exports2.buildRepoAuthorContractMd = exports2.buildRepoMapSystemRules = exports2.buildRepoMapKickoff = exports2.buildRepoMapContractMd = exports2.buildRepoMemorySystemRules = exports2.buildRepoMemoryKickoff = exports2.buildRepoMemoryContractMd = exports2.runRepoAnalysisOnRunner = exports2.MOBILE_IMPORT_SCHEMA_VERSION = exports2.validateImportedMobileTest = exports2.buildMobileImportSystemRules = exports2.buildMobileImportKickoff = exports2.buildMobileImportContractMd = exports2.IMPORT_SCHEMA_VERSION = exports2.validateImportResultFile = exports2.validateImportedTest = exports2.buildImportSystemRules = exports2.buildImportKickoff = exports2.buildImportContractMd = exports2.MAX_ARCHIVE_BYTES = exports2.isUnsafeEntryName = exports2.extractZipSafely = exports2.downloadArchiveCapped = exports2.detectArchiveKind = void 0;
+    exports2.UNSUPPORTED_RENDERER_PREFIX = exports2.UnsupportedRendererError = exports2.buildCanvasModeAuthoringAddendum = exports2.buildUnsupportedRendererMessage = exports2.modelSupportsVision = exports2.decideCanvasStrategy = exports2.decideAppRenderType = exports2.detectCanvasApp = exports2.detectRateLimitBlock = exports2.isSafeCanonicalRedirect = exports2.resolveBaseUrlPreflight = exports2.checkBaseUrlRedirect = exports2.stripJsonFences = exports2.scrubCredentials = void 0;
     __exportStar(require_ai_provider(), exports2);
     __exportStar(require_mobile_types(), exports2);
     __exportStar(require_mobile_source_parser(), exports2);
@@ -347230,6 +347548,22 @@ var require_dist2 = __commonJS({
     Object.defineProperty(exports2, "IMPORT_SCHEMA_VERSION", { enumerable: true, get: function() {
       return framework_import_prompts_js_1.IMPORT_SCHEMA_VERSION;
     } });
+    var framework_import_mobile_prompts_js_1 = require_framework_import_mobile_prompts();
+    Object.defineProperty(exports2, "buildMobileImportContractMd", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.buildMobileImportContractMd;
+    } });
+    Object.defineProperty(exports2, "buildMobileImportKickoff", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.buildMobileImportKickoff;
+    } });
+    Object.defineProperty(exports2, "buildMobileImportSystemRules", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.buildMobileImportSystemRules;
+    } });
+    Object.defineProperty(exports2, "validateImportedMobileTest", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.validateImportedMobileTest;
+    } });
+    Object.defineProperty(exports2, "MOBILE_IMPORT_SCHEMA_VERSION", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.MOBILE_IMPORT_SCHEMA_VERSION;
+    } });
     var repo_analysis_runner_js_1 = require_repo_analysis_runner();
     Object.defineProperty(exports2, "runRepoAnalysisOnRunner", { enumerable: true, get: function() {
       return repo_analysis_runner_js_1.runRepoAnalysisOnRunner;
@@ -347397,7 +347731,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.50",
+      version: "1.0.51",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -352113,6 +352447,7 @@ function validateRunnerMobileTarget(value) {
 // src/mobile-device-queue.ts
 function isNativeMobileDiscoveryContext(ctx) {
   if (!ctx) return false;
+  if (ctx.mode === "import") return false;
   if (ctx.medium === "IOS_NATIVE" || ctx.medium === "ANDROID_NATIVE") return true;
   const appId = ctx.target?.appId;
   if (typeof appId === "string" && appId.length > 0) return true;

package/dist/cli.mjs

@@ -344012,7 +344012,18 @@ var require_import_diff = __commonJS({
       "cypress",
       "acceptance",
       "playwright",
-      "selenium"
+      "selenium",
+      "appium",
+      "maestro",
+      "detox",
+      "espresso",
+      "xcuitest",
+      "xctest",
+      "uitest",
+      "androidtest",
+      "instrumentation",
+      "mobile",
+      "e2e-mobile"
     ]);
     var NON_TEST_SEGMENTS = /* @__PURE__ */ new Set([
       "support",
@@ -344098,6 +344109,14 @@ var require_import_diff = __commonJS({
         return false;
       if (/\.(spec|test|cy|e2e)\.[cm]?[jt]sx?$/i.test(base2))
         return true;
+      if (/\.maestro\.ya?ml$/i.test(base2))
+        return true;
+      if (p.includes("/maestro/") && /\.ya?ml$/i.test(base2))
+        return true;
+      if (/\.e2e\.[cm]?[jt]sx?$/i.test(base2))
+        return true;
+      if (/^test_.*mobile.*\.py$/i.test(base2) || /_mobile_test\.py$/i.test(base2))
+        return true;
       if (/\.feature$/i.test(base2))
         return true;
       if (/\.robot$/i.test(base2)) {
@@ -344139,6 +344158,18 @@ var require_import_diff = __commonJS({
           return p.endsWith(".feature");
         case "robot":
           return p.endsWith(".robot");
+        case "appium":
+          return p.includes("appium/") || /appium|wdio/i.test(p);
+        case "webdriverio":
+          return p.includes("wdio") || /\.e2e\.[cm]?[jt]sx?$/.test(p);
+        case "detox":
+          return p.includes("e2e/") || /\.e2e\.[cm]?[jt]sx?$/.test(p);
+        case "maestro":
+          return p.includes("maestro/") || /\.maestro\.ya?ml$/.test(p);
+        case "espresso":
+          return p.includes("androidtest/") || /espresso/i.test(p);
+        case "xcuitest":
+          return p.includes("uitest/") || /xcuitest/i.test(p);
         default:
           return false;
       }
@@ -344606,6 +344637,255 @@ Aim for COMPLETE coverage of the repo's tests.`;
   }
 });
 
+// ../runner-core/dist/services/framework-import-mobile-prompts.js
+var require_framework_import_mobile_prompts = __commonJS({
+  "../runner-core/dist/services/framework-import-mobile-prompts.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.MOBILE_IMPORT_SCHEMA_VERSION = void 0;
+    exports.buildMobileImportContractMd = buildMobileImportContractMd;
+    exports.buildMobileImportSystemRules = buildMobileImportSystemRules;
+    exports.buildMobileImportKickoff = buildMobileImportKickoff;
+    exports.validateImportedMobileTest = validateImportedMobileTest;
+    var shared_1 = (init_dist(), __toCommonJS(dist_exports));
+    var import_diff_js_1 = require_import_diff();
+    exports.MOBILE_IMPORT_SCHEMA_VERSION = 1;
+    var MOBILE_STEP_ACTIONS2 = new Set(shared_1.MOBILE_STEP_TYPES);
+    var MAX_IMPORTED_MOBILE_STEPS = 300;
+    function buildMobileImportContractMd(input) {
+      const mdSafe = (v, max = 200) => String(v ?? "").replace(/[`\r\n#>*|[\]]/g, " ").trim().slice(0, max);
+      const pathSafe = (v) => String(v ?? "").replace(/[`\r\n]/g, " ");
+      const creds = input.credentialKeys && input.credentialKeys.length > 0 ? input.credentialKeys.map((k) => mdSafe(k, 100)).filter(Boolean).join(", ") : "(none configured)";
+      const vars = input.testVariableKeys && input.testVariableKeys.length > 0 ? input.testVariableKeys.map((k) => mdSafe(k, 100)).filter(Boolean).join(", ") : "(none)";
+      const existing = input.existingFeatureNames && input.existingFeatureNames.length > 0 ? input.existingFeatureNames.map((n) => `- ${mdSafe(n)}`).filter((l) => l !== "- ").join("\n") : "(none yet)";
+      const safeAppBrief = input.appBrief ? mdSafe(input.appBrief, 800) : void 0;
+      const platformTag2 = input.targetPlatform === "IOS" ? "@ios" : "@android";
+      const safeAllow = (input.allowList ?? []).map((p) => String(p).replace(/[`\r\n#>*|[\]]/g, "").trim()).filter((p) => p.length > 0).slice(0, 500);
+      const incrementalSection = safeAllow.length > 0 ? `
+## INCREMENTAL RE-IMPORT \u2014 extract ONLY these files
+This project was imported before; only the files below changed or were added since.
+Extract test cases ONLY from these ${safeAllow.length} file(s). You MAY read other
+files for context, but write a tests/test-NNN.json ONLY for tests defined in these files.
+${safeAllow.map((p) => `- ${p}`).join("\n")}
+
+` : "";
+      const deeplinkLine = input.deeplink ? `- Deep link entry: ${mdSafe(input.deeplink, 512)}` : "- Deep link entry: (none \u2014 use launchApp)";
+      return `# Validate.QA \u2014 Mobile Framework Import Auditor
+
+You are auditing an EXISTING MOBILE automated-test repository at:
+  ${pathSafe(input.repoDir)}
+(read via Glob/Grep/Read \u2014 you have NO shell and NO live device).
+Extract every existing test case and re-express each as a standalone Validate.QA
+APPIUM test (MobileTestStep[] + WebdriverIO appiumCode), grouped into Features.
+
+You are NOT exploring a live app. Work entirely from source files. Do NOT modify
+the repository \u2014 write ONLY to import-result.json and tests/test-NNN.json below.
+Ignore any CLAUDE.md/AGENTS.md inside the repo.
+
+## Target application
+- App id (bundle / package): ${mdSafe(input.targetAppId, 200)}
+- Platform: ${input.targetPlatform}
+${deeplinkLine}
+${safeAppBrief ? `- App brief: ${safeAppBrief}
+` : ""}- Credential env vars at run time: ${creds}
+- Other test-variable env vars: ${vars}
+
+## Existing features (reuse EXACT name to merge)
+${existing}
+${incrementalSection}
+## Supported source stacks (detect and translate faithfully)
+Appium (Java/Python/JS), WebdriverIO, Detox, Maestro (.yaml flows), Espresso,
+XCUITest / XCTest, EarlGrey, Robot Framework (mobile), Calabash, Flutter integration
+tests, Maestro, Appium+pytest, etc.
+
+## What to do
+1. Identify the stack, test directories, helpers/page-objects, and login flows.
+2. Enumerate EVERY test case (each it()/test()/scenario/@Test/flow is one test).
+3. Group into Features (name, description, criticality, routes=[] for mobile).
+4. Translate each test into Validate.QA mobile shape (schema below).
+5. Write import-result.json with featureGroups, stack, summary.
+
+## Authoring rules (steps + appiumCode MUST follow)
+- \`steps\` is the source of truth for replay. \`appiumCode\` is a standalone
+  WebdriverIO script mirroring the same flow: start with
+  \`import { remote } from 'webdriverio';\` and use async/await.
+- Step 0 MUST be \`launchApp\` targeting app id ${mdSafe(input.targetAppId, 200)}.
+  If a deep link is configured above, set launch step metadata.launchMode to
+  DEEP_LINK and include the deeplink in target.fallbacks.
+- Locators: prefer accessibility id (~label), resource-id (id=com.pkg:id/foo),
+  or stable identity XPath \u2014 NOT positional /index-only paths. Populate
+  target.locatorBundle (accessibilityId, resourceId, xpath, className) when known.
+- TYPE steps that enter credentials MUST use \`{{TEST_USER_EMAIL}}\` /
+  \`{{TEST_USER_PASSWORD}}\` placeholders in \`value\` (never hardcode secrets).
+- Include at least one \`assertVisible\` or \`assertText\` step per test. If the
+  source had no assertion, add a best-effort outcome check and tag \`@needs-review\`.
+- Tag every test \`@imported\` plus ${platformTag2}. Add \`@smoke\`/\`@critical\` when
+  the source implies it. Login-flow tests: \`@auth\`. Tests needing prior login: inline
+  login steps at the start + \`@needs-auth\`.
+- \`sourceFile\` REQUIRED: repo-relative path of the original test file.
+
+## Imported-test schema \u2014 tests/test-NNN.json
+\`\`\`json
+{
+  "schemaVersion": 1,
+  "name": "logs in with valid credentials",
+  "description": "Verifies login with valid credentials.",
+  "suiteName": "Authentication",
+  "testType": "UI",
+  "sourceFile": "e2e/login_test.py",
+  "tags": ["@imported", "${platformTag2}", "@smoke"],
+  "appiumCode": "import { remote } from 'webdriverio';\\n\\nasync function main() {\\n  const driver = await remote({ capabilities: { platformName: '${input.targetPlatform === "IOS" ? "iOS" : "Android"}', 'appium:automationName': '${input.targetPlatform === "IOS" ? "XCUITest" : "UiAutomator2"}', '${input.targetPlatform === "IOS" ? "appium:bundleId" : "appium:appPackage"}': '${mdSafe(input.targetAppId, 120)}' } });\\n  try { /* steps */ } finally { await driver.deleteSession(); }\\n}\\n\\nvoid main();\\n",
+  "steps": [
+    {
+      "order": 0,
+      "action": "launchApp",
+      "description": "Launch ${mdSafe(input.targetAppId, 120)}",
+      "target": { "primary": "${mdSafe(input.targetAppId, 120)}", "fallbacks": [], "screenName": "Launch" },
+      "metadata": { "launchMode": "LAUNCH_APP", "platform": "${input.targetPlatform}" }
+    },
+    {
+      "order": 1,
+      "action": "tap",
+      "description": "Tap Sign In",
+      "target": {
+        "primary": "~Sign In",
+        "fallbacks": [],
+        "screenName": "LoginScreen",
+        "locatorBundle": { "xpath": "//android.widget.Button[@content-desc=\\"Sign In\\"]", "className": "android.widget.Button", "contentDesc": "Sign In" }
+      }
+    }
+  ]
+}
+\`\`\`
+
+## Result schema \u2014 import-result.json
+Same as web import: schemaVersion, stack, summary, featureGroups[].
+
+Write valid JSON only (no markdown fences inside files). Be exhaustive.`;
+    }
+    function buildMobileImportSystemRules() {
+      return [
+        "## Mobile Framework Import \u2014 invariant rules",
+        "",
+        "Extract existing MOBILE tests into Validate.QA APPIUM shape. NO live device.",
+        "Write ONLY import-result.json and tests/test-NNN.json in your working directory.",
+        "Never modify the audited repository.",
+        "",
+        "Each test MUST include: appiumCode (standalone WebdriverIO), steps (ordered",
+        "MobileTestStep[] with launchApp first), tags including @imported and @ios or",
+        "@android, suiteName matching a featureGroup, and sourceFile (repo-relative).",
+        "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.",
+        "Write strictly valid JSON."
+      ].join("\n");
+    }
+    function buildMobileImportKickoff() {
+      return [
+        "Begin Mobile Framework Import.",
+        "Read CLAUDE.md, audit the mobile test repository, extract every test into",
+        "tests/test-NNN.json (Appium steps + WebdriverIO code) and write import-result.json.",
+        "Be exhaustive."
+      ].join(" ");
+    }
+    function isNonEmptyString(v) {
+      return typeof v === "string" && v.trim().length > 0;
+    }
+    function isPlainObject2(value) {
+      return !!value && typeof value === "object" && !Array.isArray(value);
+    }
+    function isValidStep(value) {
+      if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+      const s = value;
+      if (typeof s.order !== "number" || !Number.isFinite(s.order))
+        return false;
+      if (!isNonEmptyString(s.action) || !MOBILE_STEP_ACTIONS2.has(s.action))
+        return false;
+      if (!isNonEmptyString(s.description))
+        return false;
+      if (s.value !== void 0 && typeof s.value !== "string")
+        return false;
+      if (s.assertion !== void 0 && typeof s.assertion !== "string")
+        return false;
+      if (s.metadata !== void 0 && !isPlainObject2(s.metadata))
+        return false;
+      if (s.platforms !== void 0 && (!Array.isArray(s.platforms) || s.platforms.some((p) => p !== "IOS" && p !== "ANDROID")))
+        return false;
+      if (s.target !== void 0) {
+        if (!isPlainObject2(s.target) || !isNonEmptyString(s.target.primary))
+          return false;
+        if (s.target.fallbacks !== void 0 && (!Array.isArray(s.target.fallbacks) || s.target.fallbacks.some((v) => typeof v !== "string")))
+          return false;
+        if (s.target.screenName !== void 0 && typeof s.target.screenName !== "string")
+          return false;
+        if (s.target.locatorBundle !== void 0) {
+          if (!isPlainObject2(s.target.locatorBundle))
+            return false;
+          if (Object.values(s.target.locatorBundle).some((v) => v !== void 0 && typeof v !== "string"))
+            return false;
+        }
+      }
+      return true;
+    }
+    function validateImportedMobileTest(value, defaultSuite, platformTag2) {
+      if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return { ok: false, reason: "not an object" };
+      }
+      const o = value;
+      if (!isNonEmptyString(o.name))
+        return { ok: false, reason: "name: missing" };
+      if (!isNonEmptyString(o.appiumCode))
+        return { ok: false, reason: "appiumCode: missing" };
+      const code = o.appiumCode;
+      if (!/webdriverio|remote\s*\(|driver\s*\./i.test(code)) {
+        return { ok: false, reason: "appiumCode: not a WebdriverIO/Appium script" };
+      }
+      if (!Array.isArray(o.steps) || o.steps.length === 0) {
+        return { ok: false, reason: "steps: missing or empty" };
+      }
+      if (o.steps.length > MAX_IMPORTED_MOBILE_STEPS) {
+        return { ok: false, reason: `steps: exceeds ${MAX_IMPORTED_MOBILE_STEPS} step limit` };
+      }
+      if (!o.steps.every(isValidStep)) {
+        return { ok: false, reason: "steps: invalid step shape" };
+      }
+      const steps = o.steps.map((step, order) => ({
+        ...step,
+        order,
+        description: step.description.trim().slice(0, 500)
+      }));
+      if (steps[0]?.action !== "launchApp") {
+        return { ok: false, reason: "steps: first step must be launchApp" };
+      }
+      const rawTags = Array.isArray(o.tags) ? o.tags.filter(isNonEmptyString) : [];
+      const testType = typeof o.testType === "string" && o.testType.trim().toUpperCase() === "API" ? "API" : "UI";
+      const tagSet = /* @__PURE__ */ new Set([...rawTags, "@imported", "@mobile", ...testType === "API" ? ["@api"] : []]);
+      if (platformTag2)
+        tagSet.add(platformTag2);
+      const hasAssertion = steps.some((s) => s.action === "assertVisible" || s.action === "assertText");
+      if (!hasAssertion)
+        tagSet.add("@needs-review");
+      const suiteName = isNonEmptyString(o.suiteName) ? o.suiteName.trim() : defaultSuite && defaultSuite.trim().length > 0 ? defaultSuite.trim() : "Imported Tests";
+      const sourceFile = (0, import_diff_js_1.sanitizeRepoRelPath)(typeof o.sourceFile === "string" ? o.sourceFile : "") ?? void 0;
+      return {
+        ok: true,
+        value: {
+          schemaVersion: 1,
+          name: o.name.trim().slice(0, 200),
+          description: isNonEmptyString(o.description) ? o.description.trim().slice(0, 1e3) : "",
+          suiteName: suiteName.slice(0, 200),
+          testType,
+          tags: Array.from(tagSet),
+          appiumCode: code,
+          steps,
+          ...sourceFile ? { sourceFile } : {}
+        }
+      };
+    }
+  }
+});
+
 // ../runner-core/dist/types/discovery.js
 var require_discovery = __commonJS({
   "../runner-core/dist/types/discovery.js"(exports) {
@@ -344631,9 +344911,11 @@ var require_framework_import_runner = __commonJS({
     var promises_1 = __require("fs/promises");
     var node_os_1 = __require("os");
     var node_path_1 = __require("path");
+    var shared_1 = (init_dist(), __toCommonJS(dist_exports));
     var claude_cli_js_1 = require_claude_cli();
     var repo_acquire_js_1 = require_repo_acquire();
     var framework_import_prompts_js_1 = require_framework_import_prompts();
+    var framework_import_mobile_prompts_js_1 = require_framework_import_mobile_prompts();
     var import_diff_js_1 = require_import_diff();
     var agentic_cli_constants_js_1 = require_agentic_cli_constants();
     var discovery_js_1 = require_discovery();
@@ -344650,9 +344932,18 @@ var require_framework_import_runner = __commonJS({
       const imp = ctx.frameworkImport;
       if (!imp)
         throw new Error("runFrameworkImportOnRunner: ctx.frameworkImport is required");
+      const isMobileImport = ctx.medium === "IOS_NATIVE" || ctx.medium === "ANDROID_NATIVE" || imp.platform === "mobile";
+      const targetObj = ctx.target && typeof ctx.target === "object" && !Array.isArray(ctx.target) ? ctx.target : null;
+      const targetPlatform = targetObj?.platform === "IOS" || ctx.medium === "IOS_NATIVE" ? "IOS" : "ANDROID";
+      const targetAppId = typeof targetObj?.appId === "string" ? targetObj.appId.trim() : "";
+      if (isMobileImport && !targetAppId) {
+        throw new Error("Mobile framework import requires target.appId (bundle/package id)");
+      }
+      const platformTag2 = targetPlatform === "IOS" ? "@ios" : "@android";
+      const deeplink = typeof targetObj?.deeplink === "string" ? targetObj.deeplink.trim() : void 0;
       const provider = "anthropic";
       const model = agentic_cli_constants_js_1.CLAUDE_CODE_DEFAULT_MODEL;
-      log2("=== Framework Import Runner (Claude CLI, no browser) ===");
+      log2(`=== Framework Import Runner (Claude CLI, no browser${isMobileImport ? ", mobile\u2192Appium" : ", web\u2192Playwright"}) ===`);
       log2(`Source: ${imp.source}${imp.source === "github" ? ` (${imp.repoOwner}/${imp.repoName}@${imp.branch ?? "default"})` : ""}`);
       const runDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "framework-import-"));
       const testsDir = (0, node_path_1.join)(runDir, "tests");
@@ -344712,7 +345003,7 @@ var require_framework_import_runner = __commonJS({
         const credentialKeys = ["TEST_USER_EMAIL", "TEST_USER_PASSWORD"].filter((k) => (ctx.variableContext.availableVariableKeys ?? []).includes(k));
         const allKeys = ctx.variableContext.availableVariableKeys ?? [];
         const testVariableKeys = allKeys.filter((k) => !credentialKeys.includes(k));
-        await (0, promises_1.writeFile)(contractPath, (0, framework_import_prompts_js_1.buildImportContractMd)({
+        const contractInput = {
           repoDir,
           baseUrl: ctx.baseUrl,
           appBrief: ctx.appBrief,
@@ -344722,7 +345013,14 @@ var require_framework_import_runner = __commonJS({
           resultPath,
           testsDir,
           allowList: effectiveIncremental ? allowList : void 0
-        }), "utf8");
+        };
+        const contractMd = isMobileImport ? (0, framework_import_mobile_prompts_js_1.buildMobileImportContractMd)({
+          ...contractInput,
+          targetAppId,
+          targetPlatform,
+          deeplink
+        }) : (0, framework_import_prompts_js_1.buildImportContractMd)(contractInput);
+        await (0, promises_1.writeFile)(contractPath, contractMd, "utf8");
         const mcpConfigPath = (0, node_path_1.join)(runDir, "mcp-config.json");
         await (0, promises_1.writeFile)(mcpConfigPath, JSON.stringify({ mcpServers: {} }), "utf8");
         log2("Wrote CLAUDE.md auditor contract + tests/ dir + locked-down mcp-config.json");
@@ -344734,8 +345032,8 @@ var require_framework_import_runner = __commonJS({
           log2(`Spawning claude (${provider}/${model}) \u2014 auditing repo${effectiveIncremental ? ` (${allowList?.length} changed/added file(s))` : ""}\u2026`);
           try {
             const result = await (0, claude_cli_js_1.runClaude)({
-              prompt: (0, framework_import_prompts_js_1.buildImportKickoff)(),
-              appendSystemPrompt: (0, framework_import_prompts_js_1.buildImportSystemRules)(),
+              prompt: isMobileImport ? (0, framework_import_mobile_prompts_js_1.buildMobileImportKickoff)() : (0, framework_import_prompts_js_1.buildImportKickoff)(),
+              appendSystemPrompt: isMobileImport ? (0, framework_import_mobile_prompts_js_1.buildMobileImportSystemRules)() : (0, framework_import_prompts_js_1.buildImportSystemRules)(),
               model,
               provider,
               timeoutMs: options.timeoutMs ?? IMPORT_TIMEOUT_MS,
@@ -344796,12 +345094,22 @@ var require_framework_import_runner = __commonJS({
             log2(`[harvest] ${file}: unreadable/invalid JSON \u2014 skipped (${err instanceof Error ? err.message : String(err)})`);
             continue;
           }
-          const v = (0, framework_import_prompts_js_1.validateImportedTest)(parsed, defaultSuite);
+          const v = isMobileImport ? (0, framework_import_mobile_prompts_js_1.validateImportedMobileTest)(parsed, defaultSuite, platformTag2) : (0, framework_import_prompts_js_1.validateImportedTest)(parsed, defaultSuite);
           if (!v.ok) {
             dropped++;
             log2(`[harvest] ${file}: ${v.reason} \u2014 skipped`);
             continue;
           }
+          let compiledAppiumCode;
+          if (isMobileImport && "steps" in v.value) {
+            try {
+              compiledAppiumCode = (0, shared_1.buildAppiumCode)(v.value.name, ctx.target ?? null, v.value.steps);
+            } catch (err) {
+              dropped++;
+              log2(`[harvest] ${file}: could not compile Appium export \u2014 skipped (${err instanceof Error ? err.message : String(err)})`);
+              continue;
+            }
+          }
           const normSuite = v.value.suiteName.toLowerCase().trim();
           const existingGroup = featureGroups.find((g) => g.name.toLowerCase().trim() === normSuite);
           const canonicalSuite = existingGroup ? existingGroup.name : v.value.suiteName;
@@ -344814,7 +345122,20 @@ var require_framework_import_runner = __commonJS({
           const safeSource = v.value.sourceFile ? (0, import_diff_js_1.sanitizeRepoRelPath)(v.value.sourceFile, repoDir) : null;
           if (safeSource)
             extractedFiles.add(safeSource);
-          const test = {
+          const test = isMobileImport && "appiumCode" in v.value ? {
+            name: v.value.name,
+            description: v.value.description,
+            playwrightCode: "",
+            framework: "APPIUM",
+            appiumCode: compiledAppiumCode,
+            steps: v.value.steps,
+            tags: v.value.tags,
+            suiteName: canonicalSuite,
+            testType: v.value.testType,
+            verified: false,
+            ...safeSource ? { sourceFile: safeSource } : {},
+            ...effectiveIncremental ? { importOverwrite: true } : {}
+          } : {
             name: v.value.name,
             description: v.value.description,
             playwrightCode: v.value.playwrightCode,
@@ -344823,9 +345144,6 @@ var require_framework_import_runner = __commonJS({
             testType: v.value.testType,
             verified: false,
             ...safeSource ? { sourceFile: safeSource } : {},
-            // In an incremental run every streamed test came from a changed/added file, so
-            // the server should UPDATE its existing imported row in place (and re-verify)
-            // instead of preserving stale ACTIVE code. Harmless for added files (no row yet).
             ...effectiveIncremental ? { importOverwrite: true } : {}
           };
           capturedTests.push(test);
@@ -347010,8 +347328,8 @@ var require_dist2 = __commonJS({
     };
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.acquireRepoForImport = exports.runFrameworkImportOnRunner = exports.getAgenticEngine = exports.resolveRefFromSnapshot = exports.replayAuthRecipeIntoBrowser = exports.runRegisterCaptureRun = exports.runLoginCaptureRun = exports.filterLoginCaptureCredentials = exports.buildLoginCaptureCredentials = exports.isReservedRunnerEnvVar = exports.RESERVED_RUNNER_ENV_VARS = exports.AUTH_MARKER_VERSION = exports.buildHealAuthStamp = exports.extractAuthRegion = exports.upsertAuthBlock = exports.buildAuthRecipe = exports.commandToReplayStep = exports.buildReplayPlan = exports.absoluteRoute = exports.renderReplaySettleArrow = exports.renderReplayClickArrow = exports.renderAuthFn = exports.filterFeatureGroupsToPathScope = exports.isAuthFlowRoute = exports.deriveSurveyPathScope = exports.canonicalizeRoute = exports.executeGrokPerBatchHeal = exports.executeGrokPerTestHeal = exports.headerVal = exports.classifyAuthType = exports.isTextExcerptable = exports.isStaticAssetByExt = exports.isApiCall = exports.buildApiCallSummary = exports.computeMobileHealOutcome = exports.detectMobileStepSecretLeak = exports.redactMobileSecretsFromText = exports.MOBILE_LIVE_HEAL_SYSTEM_PROMPT = exports.MOBILE_SCRIPT_HEAL_SYSTEM_PROMPT = exports.executeMobileLiveHeal = exports.executeMobileTestWithHealing = exports.executeMobileScriptDrivenHeal = exports.prepareMobileScenarioAppState = exports.runMobileGeneratePhase = exports.runMobileAIPlanner = exports.buildMobileSiteMap = exports.formatMobileEvidenceForPlanner = exports.MOBILE_SCENARIO_SYSTEM_PROMPT = exports.MOBILE_SURVEY_SYSTEM_PROMPT = exports.runMobileExplorePhase = void 0;
-    exports.isSafeCanonicalRedirect = exports.resolveBaseUrlPreflight = exports.checkBaseUrlRedirect = exports.stripJsonFences = exports.scrubCredentials = exports.withAIRetry = exports.snapshotMatchingChildren = exports.findNewChromiumChildPid = exports.killProcessTree = exports.gracefulCloseWithTreeKill = exports.liveBrowserRegistry = exports.REPO_SWITCH_REMOVED_FRACTION = exports.MAX_MANIFEST_FILES = exports.toDiffSummary = exports.isLikelyTestFile = exports.sanitizeRepoRelPath = exports.sha256Hex = exports.hashFiles = exports.enumerateTestFiles = exports.buildNextManifest = exports.detectRepoSwitch = exports.classifyImportDiff = exports.parseImportManifest = exports.REPO_ANALYSIS_SCHEMA_VERSION = exports.validateSourceEndpoints = exports.validateAuthoredTest = exports.validateRepoMapFile = exports.validateRepoMemoryFile = exports.buildTestingStandardsSection = exports.buildRepoAuthorSystemRules = exports.buildRepoAuthorKickoff = exports.buildRepoAuthorContractMd = exports.buildRepoMapSystemRules = exports.buildRepoMapKickoff = exports.buildRepoMapContractMd = exports.buildRepoMemorySystemRules = exports.buildRepoMemoryKickoff = exports.buildRepoMemoryContractMd = exports.runRepoAnalysisOnRunner = exports.IMPORT_SCHEMA_VERSION = exports.validateImportResultFile = exports.validateImportedTest = exports.buildImportSystemRules = exports.buildImportKickoff = exports.buildImportContractMd = exports.MAX_ARCHIVE_BYTES = exports.isUnsafeEntryName = exports.extractZipSafely = exports.downloadArchiveCapped = exports.detectArchiveKind = void 0;
-    exports.UNSUPPORTED_RENDERER_PREFIX = exports.UnsupportedRendererError = exports.buildCanvasModeAuthoringAddendum = exports.buildUnsupportedRendererMessage = exports.modelSupportsVision = exports.decideCanvasStrategy = exports.decideAppRenderType = exports.detectCanvasApp = exports.detectRateLimitBlock = void 0;
+    exports.withAIRetry = exports.snapshotMatchingChildren = exports.findNewChromiumChildPid = exports.killProcessTree = exports.gracefulCloseWithTreeKill = exports.liveBrowserRegistry = exports.REPO_SWITCH_REMOVED_FRACTION = exports.MAX_MANIFEST_FILES = exports.toDiffSummary = exports.isLikelyTestFile = exports.sanitizeRepoRelPath = exports.sha256Hex = exports.hashFiles = exports.enumerateTestFiles = exports.buildNextManifest = exports.detectRepoSwitch = exports.classifyImportDiff = exports.parseImportManifest = exports.REPO_ANALYSIS_SCHEMA_VERSION = exports.validateSourceEndpoints = exports.validateAuthoredTest = exports.validateRepoMapFile = exports.validateRepoMemoryFile = exports.buildTestingStandardsSection = exports.buildRepoAuthorSystemRules = exports.buildRepoAuthorKickoff = exports.buildRepoAuthorContractMd = exports.buildRepoMapSystemRules = exports.buildRepoMapKickoff = exports.buildRepoMapContractMd = exports.buildRepoMemorySystemRules = exports.buildRepoMemoryKickoff = exports.buildRepoMemoryContractMd = exports.runRepoAnalysisOnRunner = exports.MOBILE_IMPORT_SCHEMA_VERSION = exports.validateImportedMobileTest = exports.buildMobileImportSystemRules = exports.buildMobileImportKickoff = exports.buildMobileImportContractMd = exports.IMPORT_SCHEMA_VERSION = exports.validateImportResultFile = exports.validateImportedTest = exports.buildImportSystemRules = exports.buildImportKickoff = exports.buildImportContractMd = exports.MAX_ARCHIVE_BYTES = exports.isUnsafeEntryName = exports.extractZipSafely = exports.downloadArchiveCapped = exports.detectArchiveKind = void 0;
+    exports.UNSUPPORTED_RENDERER_PREFIX = exports.UnsupportedRendererError = exports.buildCanvasModeAuthoringAddendum = exports.buildUnsupportedRendererMessage = exports.modelSupportsVision = exports.decideCanvasStrategy = exports.decideAppRenderType = exports.detectCanvasApp = exports.detectRateLimitBlock = exports.isSafeCanonicalRedirect = exports.resolveBaseUrlPreflight = exports.checkBaseUrlRedirect = exports.stripJsonFences = exports.scrubCredentials = void 0;
     __exportStar(require_ai_provider(), exports);
     __exportStar(require_mobile_types(), exports);
     __exportStar(require_mobile_source_parser(), exports);
@@ -347235,6 +347553,22 @@ var require_dist2 = __commonJS({
     Object.defineProperty(exports, "IMPORT_SCHEMA_VERSION", { enumerable: true, get: function() {
       return framework_import_prompts_js_1.IMPORT_SCHEMA_VERSION;
     } });
+    var framework_import_mobile_prompts_js_1 = require_framework_import_mobile_prompts();
+    Object.defineProperty(exports, "buildMobileImportContractMd", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.buildMobileImportContractMd;
+    } });
+    Object.defineProperty(exports, "buildMobileImportKickoff", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.buildMobileImportKickoff;
+    } });
+    Object.defineProperty(exports, "buildMobileImportSystemRules", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.buildMobileImportSystemRules;
+    } });
+    Object.defineProperty(exports, "validateImportedMobileTest", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.validateImportedMobileTest;
+    } });
+    Object.defineProperty(exports, "MOBILE_IMPORT_SCHEMA_VERSION", { enumerable: true, get: function() {
+      return framework_import_mobile_prompts_js_1.MOBILE_IMPORT_SCHEMA_VERSION;
+    } });
     var repo_analysis_runner_js_1 = require_repo_analysis_runner();
     Object.defineProperty(exports, "runRepoAnalysisOnRunner", { enumerable: true, get: function() {
       return repo_analysis_runner_js_1.runRepoAnalysisOnRunner;
@@ -347402,7 +347736,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.50",
+      version: "1.0.51",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -352121,6 +352455,7 @@ function validateRunnerMobileTarget(value) {
 // src/mobile-device-queue.ts
 function isNativeMobileDiscoveryContext(ctx) {
   if (!ctx) return false;
+  if (ctx.mode === "import") return false;
   if (ctx.medium === "IOS_NATIVE" || ctx.medium === "ANDROID_NATIVE") return true;
   const appId = ctx.target?.appId;
   if (typeof appId === "string" && appId.length > 0) return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@validate.qa/runner",
-  "version": "1.0.50",
+  "version": "1.0.51",
   "description": "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
   "bin": {
     "validate-runner": "dist/cli.js"