@validate.qa/runner 1.0.31 → 1.0.32

package/dist/cli.js

@@ -5001,6 +5001,29 @@ var require_mobile_observation = __commonJS({
   }
 });
 
+// ../runner-core/dist/services/mobile/mobile-keyboard.js
+var require_mobile_keyboard = __commonJS({
+  "../runner-core/dist/services/mobile/mobile-keyboard.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.shouldRetryTapAfterKeyboardDismiss = shouldRetryTapAfterKeyboardDismiss;
+    exports2.dismissKeyboardForRetry = dismissKeyboardForRetry;
+    var EDITABLE_FOCUSED_ROLE_RE = /(EditText|TextField|SecureTextField|SearchField|TextView)$/i;
+    var OUTSIDE_VIEWPORT_ERROR_RE = /(outside|out of).*?(bounds|viewport|visible|screen|window)|coordinate.*?(invalid|outside)/i;
+    function shouldRetryTapAfterKeyboardDismiss(error2, elements) {
+      if (!error2 || !OUTSIDE_VIEWPORT_ERROR_RE.test(error2))
+        return false;
+      return elements.some((el) => el.focused === true && EDITABLE_FOCUSED_ROLE_RE.test(el.role));
+    }
+    async function dismissKeyboardForRetry(driver) {
+      if (typeof driver.dismissKeyboard === "function") {
+        return driver.dismissKeyboard();
+      }
+      return driver.back();
+    }
+  }
+});
+
 // ../runner-core/dist/utils/scrub-credentials.js
 var require_scrub_credentials = __commonJS({
   "../runner-core/dist/utils/scrub-credentials.js"(exports2) {
@@ -61982,6 +62005,7 @@ var require_mobile_explorer = __commonJS({
     var mobile_source_parser_js_1 = require_mobile_source_parser();
     var mobile_observation_js_1 = require_mobile_observation();
     var mobile_boundary_js_1 = require_mobile_boundary();
+    var mobile_keyboard_js_1 = require_mobile_keyboard();
     var credential_tools_js_1 = require_credential_tools();
     var verification_inbox_js_1 = require_verification_inbox();
     var inbox_tools_js_1 = require_inbox_tools();
@@ -61991,6 +62015,7 @@ var require_mobile_explorer = __commonJS({
     var MAX_RECENT_EXCHANGES = 24;
     var OBSERVATION_MAX_ELEMENTS = 50;
     var NO_SNAPSHOT_NUDGE_THRESHOLD = 4;
+    var EXTERNAL_APP_RECOVERY_ATTEMPTS = 2;
     var MOBILE_SNAPSHOT_TOOL = {
       type: "function",
       function: {
@@ -62556,9 +62581,46 @@ ${existingScreens.slice(0, 100).map((s) => `- ${s.screenId}${s.name ? ` "${s.nam
               externalOwner: boundary.owner
             };
           }
-          log2(`   Relaunch still outside target app (${recoveredBoundary.owner}); no screen recorded.`);
+          let lastExternalOwner = recoveredBoundary.owner;
+          for (let attempt = 1; attempt <= EXTERNAL_APP_RECOVERY_ATTEMPTS; attempt += 1) {
+            try {
+              await driver.launchApp();
+              const retrySnap = await driver.snapshot();
+              const retryRecovered = buildResolved(retrySnap.xml, retrySnap.windowSize, retrySnap.screenSignal);
+              if (!retryRecovered)
+                continue;
+              const retryBoundary = (0, mobile_boundary_js_1.classifyMobileScreenBoundary)(retryRecovered.signal, targetAppId, platform3);
+              latest = retryRecovered;
+              lastSnapshotIteration = iterationForObservation;
+              if (retryBoundary.kind === "target" || retryBoundary.kind === "unknown") {
+                const screenId = ingestSnapshot(retryRecovered, iterationForObservation);
+                captureScreenshot(retrySnap.screenshot, screenId);
+                log2(`   Recovered target app after ${attempt} additional activation attempt(s).`);
+                return {
+                  observation: retryRecovered.observation,
+                  screenId,
+                  externalBlocked: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              if (retryBoundary.kind === "transient_external") {
+                log2(`   Recovery surfaced system overlay ${retryBoundary.owner}; not adding it to target-app survey evidence.`);
+                return {
+                  observation: `${retryRecovered.observation}${(0, mobile_boundary_js_1.mobileBoundaryNote)(retryBoundary)}`,
+                  screenId: null,
+                  externalBlocked: true,
+                  transientExternal: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              lastExternalOwner = retryBoundary.owner;
+            } catch (err) {
+              log2(`   Target app recovery attempt ${attempt} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+          }
+          log2(`   Relaunch still outside target app (${lastExternalOwner}); no screen recorded.`);
           return {
-            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${recoveredBoundary.owner}, so no screen was recorded)`,
+            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${lastExternalOwner}, so no screen was recorded)`,
             screenId: null,
             externalBlocked: true,
             externalOwner: boundary.owner
@@ -62936,7 +62998,19 @@ Exploration complete: ${summary}`);
           const fromScreenId = state2.getCurrentScreenId();
           const boundaryBeforeAction = currentBoundary();
           const startedOutsideTarget = boundaryBeforeAction.kind !== "target" && boundaryBeforeAction.kind !== "unknown";
-          const actionResult = await driver.tap(resolved.bounds);
+          let actionResult = await driver.tap(resolved.bounds);
+          if (!actionResult.ok && (0, mobile_keyboard_js_1.shouldRetryTapAfterKeyboardDismiss)(actionResult.error, latest()?.screen.elements ?? [])) {
+            log2("   Tap target was outside the visible viewport while an input was focused; dismissing keyboard and retrying once.");
+            const dismissResult = await (0, mobile_keyboard_js_1.dismissKeyboardForRetry)(driver);
+            const retryResult = await driver.tap(resolved.bounds);
+            actionResult = retryResult.ok ? retryResult : {
+              ...retryResult,
+              error: retryResult.error ? `${retryResult.error} (retry after keyboard dismiss also failed)` : "Tap retry after keyboard dismiss failed",
+              source: retryResult.source ?? dismissResult.source,
+              screenshot: retryResult.screenshot ?? dismissResult.screenshot,
+              screenSignal: retryResult.screenSignal ?? dismissResult.screenSignal
+            };
+          }
           const absorbed = await absorbActionResult(actionResult, "mobile_tap");
           const { observation, screenId } = absorbed;
           if (!startedOutsideTarget && !absorbed.externalBlocked && !absorbed.transientExternal) {
@@ -65936,6 +66010,25 @@ var require_mobile_discovery_prompts = __commonJS({
     function targetAppScreens(graph, appId) {
       return [...graph.screens.values()].filter((state2) => isTargetAppScreenId(state2.screenId, appId));
     }
+    function isGenericNonFeatureScreen(state2) {
+      const type = state2.screenType?.trim().toLowerCase();
+      if (type === "error" || type === "permission")
+        return true;
+      if (type && type !== "unknown")
+        return false;
+      const actionableCount = state2.elements.filter((el) => el.actionable).length;
+      if (actionableCount > 0)
+        return false;
+      const evidenceText = [
+        state2.screenName,
+        state2.screenType,
+        ...state2.observations ?? []
+      ].filter((value) => typeof value === "string" && value.trim().length > 0).join(" ");
+      return /\b(empty|loading|blank|spinner|intermediate|placeholder|no actionable)\b/i.test(evidenceText);
+    }
+    function plannableTargetAppScreens(graph, appId) {
+      return targetAppScreens(graph, appId).filter((state2) => !isGenericNonFeatureScreen(state2));
+    }
     exports2.MOBILE_SURVEY_SYSTEM_PROMPT = `You are a feature analyst for a native mobile application (iOS or Android). You receive evidence from an AI explorer that mapped the app's screens by tapping, typing, and swiping through the live UI. Your job is to organize screens into meaningful feature groups.
 
 ## Output Discipline
@@ -65955,8 +66048,8 @@ Return ONLY one valid JSON object matching the schema below. Do NOT include <thi
 5. CRUD screens for the same entity belong together
 6. Do NOT merge screens into one feature just because they serve a similar broader goal. Treat areas as separate features when the evidence shows separate primary navigation destinations (e.g. separate tab-bar items or drawer links), separate screen families for distinct entities, or different CRUD entities/forms. Keep screens together when they share one navigational area and operate on the same entity (e.g. a list screen, its filter/sort sheet, and its detail screen all belong together).
 7. Feature descriptions MUST reference actual element labels / accessibility-ids from the evidence
-8. Do NOT create standalone features for generic error / empty screens (network-error, permission-denied). If a feature screen is broken or crashes, keep it in its intended feature and note the failure in the description.
-9. COVER EVERY SCREEN: every explored screen except generic error / permission screens MUST appear in exactly one feature group's routes. Do not leave screens ungrouped \u2014 a screen the explorer reached is part of SOME feature. Attach an ambiguous screen to its most closely related feature and note the ambiguity in that feature's description. Sign-in / sign-up / forgot-password screens form an "Authentication" group even when they were only reached via links from other screens.
+8. Do NOT create standalone features for generic error / empty / loading / intermediate screens (network-error, permission-denied, blank WebView, spinner-only loading). If a feature screen is broken or crashes, keep it in its intended feature and note the failure in the description. If a screen has no actionable controls and only says it is empty/loading/intermediate, omit it from featureGroups.routes unless it is the only evidence for a real product feature.
+9. COVER EVERY PRODUCT SCREEN: every explored product screen except generic error / permission / empty / loading / intermediate screens MUST appear in exactly one feature group's routes. Do not leave usable screens ungrouped \u2014 a screen the explorer reached is part of SOME feature. Attach an ambiguous usable screen to its most closely related feature and note the ambiguity in that feature's description. Sign-in / sign-up / forgot-password screens form an "Authentication" group even when they were only reached via links from other screens.
 10. LOGGED-OUT vs LOGGED-IN SEPARATION: screens shown BEFORE the user is signed in (splash, landing/welcome, theme or language pickers, walkthroughs, sign-up, sign-in, forgot-password, demo/preview screens) must NEVER share a feature group with the signed-in app. Put sign-in / sign-up / forgot-password in "Authentication" (rule 4) and the remaining pre-login screens in an "Onboarding" group. Features named after signed-in areas (feeds, dashboards, tabs, settings) must contain ONLY screens reached after authentication. A pre-login flow is a linear sequence, not a navigation destination \u2014 do not let it swallow the app's main features.
 
 ## Output JSON Schema
@@ -66223,7 +66316,7 @@ ${targetBits.length > 0 ? targetBits.join(" ") : "native mobile app"}`);
         sections.push(`## Feature: ${context.featureName}
 SCOPE: this is a feature-focused deep run. Plan scenarios ONLY for the "${context.featureName}" feature \u2014 its screens, forms, and flows. Screens belonging to other features are navigation context / prerequisites only; do NOT plan scenarios whose primary goal exercises another feature.`);
       }
-      const orderedScreens = targetAppScreens(graph, context.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(graph, context.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       const includedScreenIds = new Set(orderedScreens.map((state2) => state2.screenId));
       sections.push(`## Screens Discovered (${orderedScreens.length})`);
       for (const state2 of orderedScreens) {
@@ -66332,7 +66425,7 @@ ${constraints.join("\n")}`);
       const now = /* @__PURE__ */ new Date();
       const idByScreen = /* @__PURE__ */ new Map();
       let pageSeq = 0;
-      const orderedScreens = targetAppScreens(graph, meta.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(graph, meta.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       for (const state2 of orderedScreens) {
         idByScreen.set(state2.screenId, `mpage-${pageSeq++}`);
       }
@@ -66393,7 +66486,7 @@ ${constraints.join("\n")}`);
     }
     function buildMobileFeatureGroupsFromGraph(graph, appId) {
       const groups = /* @__PURE__ */ new Map();
-      const orderedScreens = targetAppScreens(graph, appId).filter((state2) => state2.screenType?.toLowerCase() !== "error").sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(graph, appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       const includedScreenIds = new Set(orderedScreens.map((state2) => state2.screenId));
       for (const state2 of orderedScreens) {
         const screenTypeLower = state2.screenType?.toLowerCase();
@@ -66440,7 +66533,7 @@ ${constraints.join("\n")}`);
         return [];
       if (input.featureName?.trim())
         return [];
-      const orderedScreens = targetAppScreens(input.graph, input.appId).filter((state2) => state2.screenType?.toLowerCase() !== "error").filter((state2) => state2.visited || state2.firstSeenIteration === 0).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(input.graph, input.appId).filter((state2) => state2.visited || state2.firstSeenIteration === 0).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       if (orderedScreens.length === 0)
         return [];
       const entryScreenId = orderedScreens[0].screenId;
@@ -66642,9 +66735,11 @@ var require_mobile_generator = __commonJS({
     var mobile_source_parser_js_2 = require_mobile_source_parser();
     var mobile_observation_js_1 = require_mobile_observation();
     var mobile_boundary_js_1 = require_mobile_boundary();
+    var mobile_keyboard_js_1 = require_mobile_keyboard();
     var MAX_SCENARIO_ITERATIONS = 30;
     var MAX_CONSECUTIVE_INFRA_FAILURES = 3;
     var MAX_RECENT_EXCHANGES = 24;
+    var EXTERNAL_APP_RECOVERY_ATTEMPTS = 2;
     var OBSERVATION_MAX_ELEMENTS = 50;
     function finalizeAction(input) {
       return { ...input, url: "", selector: input.selector ?? "" };
@@ -67060,10 +67155,47 @@ Start by calling mobile_snapshot, then execute the steps above \u2014 the minimu
               externalOwner: boundary.owner
             };
           }
-          log2(`  relaunch still outside target app (${recoveredBoundary.owner}); no target-app step recorded.`);
+          let lastExternalOwner = recoveredBoundary.owner;
+          let lastRecovered = recovered;
+          for (let attempt = 1; attempt <= EXTERNAL_APP_RECOVERY_ATTEMPTS; attempt += 1) {
+            try {
+              await driver.launchApp();
+              const retrySnap = await driver.snapshot();
+              const retryRecovered = buildResolved(retrySnap.xml, retrySnap.screenSignal, retrySnap.windowSize);
+              if (!retryRecovered)
+                continue;
+              lastRecovered = retryRecovered;
+              const retryBoundary = (0, mobile_boundary_js_1.classifyMobileScreenBoundary)(retryRecovered.signal, targetAppId, platform3);
+              setLatest(retryRecovered);
+              if ((0, mobile_boundary_js_1.isTargetLikeMobileBoundary)(retryBoundary)) {
+                emitScreenshot(retrySnap.screenshot);
+                log2(`  recovered target app after ${attempt} additional activation attempt(s).`);
+                return {
+                  resolved: retryRecovered,
+                  observation: retryRecovered.observation,
+                  externalBlocked: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              if (retryBoundary.kind === "transient_external") {
+                log2(`  recovery surfaced system overlay ${retryBoundary.owner}; not recording it as a target-app step.`);
+                return {
+                  resolved: retryRecovered,
+                  observation: `${retryRecovered.observation}${(0, mobile_boundary_js_1.mobileBoundaryNote)(retryBoundary)}`,
+                  externalBlocked: true,
+                  transientExternal: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              lastExternalOwner = retryBoundary.owner;
+            } catch (err) {
+              log2(`  target app recovery attempt ${attempt} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+          }
+          log2(`  relaunch still outside target app (${lastExternalOwner}); no target-app step recorded.`);
           return {
-            resolved: recovered,
-            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${recoveredBoundary.owner}, so no target-app step was recorded)`,
+            resolved: lastRecovered,
+            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${lastExternalOwner}, so no target-app step was recorded)`,
             externalBlocked: true,
             externalOwner: boundary.owner
           };
@@ -67277,7 +67409,19 @@ ${statePacket}` },
             return unknownRef(toolArgs.ref);
           const beforeScreenName = screenName();
           const before = latest();
-          const result = await driver.tap(element.bounds);
+          let result = await driver.tap(element.bounds);
+          if (!result.ok && (0, mobile_keyboard_js_1.shouldRetryTapAfterKeyboardDismiss)(result.error, before?.screen.elements ?? [])) {
+            log2("  tap target was outside the visible viewport while an input was focused; dismissing keyboard and retrying once.");
+            const dismissResult = await (0, mobile_keyboard_js_1.dismissKeyboardForRetry)(driver);
+            const retryResult = await driver.tap(element.bounds);
+            result = retryResult.ok ? retryResult : {
+              ...retryResult,
+              error: retryResult.error ? `${retryResult.error} (retry after keyboard dismiss also failed)` : "Tap retry after keyboard dismiss failed",
+              source: retryResult.source ?? dismissResult.source,
+              screenshot: retryResult.screenshot ?? dismissResult.screenshot,
+              screenSignal: retryResult.screenSignal ?? dismissResult.screenSignal
+            };
+          }
           const absorbed = await absorbObservation(result.source, result.screenSignal, latest()?.screen.windowSize ?? null, result.screenshot, "mobile_tap");
           if (shouldRecordAction(result, absorbed) && changedScreen(before, absorbed)) {
             recordAction({
@@ -315412,8 +315556,8 @@ var require_mobile_discovery_agent = __commonJS({
           };
         }
         log2("\n\u2500\u2500 Phase 1: EXPLORE \u2500\u2500");
-        const exploreAppDataCleared = await prepareMobileAppStateForDiscovery(driver, target, "explore", log2);
-        log2(exploreAppDataCleared ? "App data cleared \u2014 exploring from a deterministic cold (logged-out) state." : target?.resetPolicy === "PRESERVE_APP_DATA" ? "App data reset skipped by policy \u2014 exploring with preserved app data." : "App data reset unavailable (platform/device policy) \u2014 exploring the app in its current state.");
+        const exploreAppDataCleared = await prepareMobileAppStateForDiscovery(driver, target, "explore", mode, log2);
+        log2(exploreAppDataCleared ? "App data cleared \u2014 exploring from a deterministic cold (logged-out) state." : target?.resetPolicy === "PRESERVE_APP_DATA" ? "App data reset skipped by policy \u2014 exploring with preserved app data." : mode === "survey" && (target?.resetPolicy ?? "AUTO") === "AUTO" ? "App data reset skipped for mobile survey AUTO \u2014 exploring with preserved app data. Use resetPolicy=CLEAR_APP_DATA for a cold logged-out survey." : "App data reset unavailable (platform/device policy) \u2014 exploring the app in its current state.");
         const state2 = new mobile_exploration_state_js_1.MobileExplorationState();
         const maxIterations = getMobileExploreBudget(mode, ctx.incremental);
         const existingScreens = isSurvey && ctx.incremental ? compactExistingScreens(ctx.existingSiteMap) : void 0;
@@ -315655,10 +315799,11 @@ Fatal error: ${msg}`);
         };
       }
     }
-    async function prepareMobileAppStateForDiscovery(driver, target, phase, log2) {
+    async function prepareMobileAppStateForDiscovery(driver, target, phase, mode, log2) {
       void phase;
       const resetPolicy = target?.resetPolicy ?? "AUTO";
-      if (resetPolicy === "PRESERVE_APP_DATA") {
+      const shouldPreserveAppData = resetPolicy === "PRESERVE_APP_DATA" || mode === "survey" && resetPolicy === "AUTO";
+      if (shouldPreserveAppData) {
         try {
           await driver.relaunch();
         } catch (err) {
@@ -330179,7 +330324,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.31",
+      version: "1.0.32",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -330843,6 +330988,37 @@ async function swipe(sessionPath, direction, distance, windowSize) {
 async function pressBack(sessionPath) {
   await appiumRequest(`${sessionPath}/back`, { method: "POST", body: "{}" });
 }
+function isKeyboardAlreadyHiddenError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  return /keyboard.*(not|already).*(shown|visible|present|open)|no.*keyboard/i.test(message);
+}
+async function dismissKeyboard(sessionPath, platform3) {
+  if (platform3 === "ANDROID") {
+    await pressBack(sessionPath);
+    return;
+  }
+  try {
+    await appiumRequest(`${sessionPath}/appium/device/hide_keyboard`, {
+      method: "POST",
+      body: "{}"
+    });
+    return;
+  } catch (err) {
+    if (isAppiumDriverDeadError(err)) throw err;
+    if (isKeyboardAlreadyHiddenError(err)) return;
+  }
+  try {
+    await appiumRequest(`${sessionPath}/execute/sync`, {
+      method: "POST",
+      body: JSON.stringify({ script: "mobile: hideKeyboard", args: [{}] })
+    });
+    return;
+  } catch (err) {
+    if (isAppiumDriverDeadError(err)) throw err;
+    if (isKeyboardAlreadyHiddenError(err)) return;
+  }
+  await pressBack(sessionPath);
+}
 async function pressHome(sessionPath, platform3) {
   if (platform3 === "IOS") {
     await appiumRequest(`${sessionPath}/execute/sync`, {
@@ -334836,6 +335012,10 @@ var MobileBridgeDriver = class {
   async back() {
     return this.runAction(() => pressBack(this.sessionPath));
   }
+  /** Platform-aware software keyboard dismissal. */
+  async dismissKeyboard() {
+    return this.runAction(() => dismissKeyboard(this.sessionPath, this.platform));
+  }
   /** System Home — backgrounds the app only (use `relaunch` for hermetic reset). */
   async home() {
     return this.runAction(() => pressHome(this.sessionPath, this.platform));
@@ -335221,8 +335401,12 @@ function attachMobileDiscoveryNetworkContext(calls, result, appId) {
     pageUrl: call.pageUrl ?? pageUrl
   }));
 }
+var runnerPackage = require_package4();
 var SECRET_VAR_PATTERN = /password|secret|token|api[_]?key|pass\b|credential|bearer|pat\b/i;
 var IS_CLOUD = process.env.RUNNER_CLOUD === "true";
+var RUNNER_NAME = runnerPackage.name ?? "@validate.qa/runner";
+var RUNNER_VERSION = runnerPackage.version ?? "0.0.0";
+var RUNNER_BUILD_ID = process.env.VALIDATE_RUNNER_BUILD_ID ?? process.env.RAILWAY_GIT_COMMIT_SHA ?? process.env.GIT_COMMIT_SHA ?? process.env.SOURCE_VERSION;
 var DEFAULT_MAX_CONCURRENT = IS_CLOUD ? 4 : 40;
 var DEFAULT_TYPE_LIMITS = {
   discovery: IS_CLOUD ? 2 : 15,
@@ -338056,6 +338240,9 @@ async function startRunner(opts) {
         method: "POST",
         headers,
         body: JSON.stringify({
+          runnerName: RUNNER_NAME,
+          runnerVersion: RUNNER_VERSION,
+          runnerBuildId: RUNNER_BUILD_ID,
           runsCompleted,
           activeRuns,
           maxConcurrent: MAX_CONCURRENT,

package/dist/cli.mjs

@@ -5006,6 +5006,29 @@ var require_mobile_observation = __commonJS({
   }
 });
 
+// ../runner-core/dist/services/mobile/mobile-keyboard.js
+var require_mobile_keyboard = __commonJS({
+  "../runner-core/dist/services/mobile/mobile-keyboard.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.shouldRetryTapAfterKeyboardDismiss = shouldRetryTapAfterKeyboardDismiss;
+    exports.dismissKeyboardForRetry = dismissKeyboardForRetry;
+    var EDITABLE_FOCUSED_ROLE_RE = /(EditText|TextField|SecureTextField|SearchField|TextView)$/i;
+    var OUTSIDE_VIEWPORT_ERROR_RE = /(outside|out of).*?(bounds|viewport|visible|screen|window)|coordinate.*?(invalid|outside)/i;
+    function shouldRetryTapAfterKeyboardDismiss(error2, elements) {
+      if (!error2 || !OUTSIDE_VIEWPORT_ERROR_RE.test(error2))
+        return false;
+      return elements.some((el) => el.focused === true && EDITABLE_FOCUSED_ROLE_RE.test(el.role));
+    }
+    async function dismissKeyboardForRetry(driver) {
+      if (typeof driver.dismissKeyboard === "function") {
+        return driver.dismissKeyboard();
+      }
+      return driver.back();
+    }
+  }
+});
+
 // ../runner-core/dist/utils/scrub-credentials.js
 var require_scrub_credentials = __commonJS({
   "../runner-core/dist/utils/scrub-credentials.js"(exports) {
@@ -61987,6 +62010,7 @@ var require_mobile_explorer = __commonJS({
     var mobile_source_parser_js_1 = require_mobile_source_parser();
     var mobile_observation_js_1 = require_mobile_observation();
     var mobile_boundary_js_1 = require_mobile_boundary();
+    var mobile_keyboard_js_1 = require_mobile_keyboard();
     var credential_tools_js_1 = require_credential_tools();
     var verification_inbox_js_1 = require_verification_inbox();
     var inbox_tools_js_1 = require_inbox_tools();
@@ -61996,6 +62020,7 @@ var require_mobile_explorer = __commonJS({
     var MAX_RECENT_EXCHANGES = 24;
     var OBSERVATION_MAX_ELEMENTS = 50;
     var NO_SNAPSHOT_NUDGE_THRESHOLD = 4;
+    var EXTERNAL_APP_RECOVERY_ATTEMPTS = 2;
     var MOBILE_SNAPSHOT_TOOL = {
       type: "function",
       function: {
@@ -62561,9 +62586,46 @@ ${existingScreens.slice(0, 100).map((s) => `- ${s.screenId}${s.name ? ` "${s.nam
               externalOwner: boundary.owner
             };
           }
-          log2(`   Relaunch still outside target app (${recoveredBoundary.owner}); no screen recorded.`);
+          let lastExternalOwner = recoveredBoundary.owner;
+          for (let attempt = 1; attempt <= EXTERNAL_APP_RECOVERY_ATTEMPTS; attempt += 1) {
+            try {
+              await driver.launchApp();
+              const retrySnap = await driver.snapshot();
+              const retryRecovered = buildResolved(retrySnap.xml, retrySnap.windowSize, retrySnap.screenSignal);
+              if (!retryRecovered)
+                continue;
+              const retryBoundary = (0, mobile_boundary_js_1.classifyMobileScreenBoundary)(retryRecovered.signal, targetAppId, platform3);
+              latest = retryRecovered;
+              lastSnapshotIteration = iterationForObservation;
+              if (retryBoundary.kind === "target" || retryBoundary.kind === "unknown") {
+                const screenId = ingestSnapshot(retryRecovered, iterationForObservation);
+                captureScreenshot(retrySnap.screenshot, screenId);
+                log2(`   Recovered target app after ${attempt} additional activation attempt(s).`);
+                return {
+                  observation: retryRecovered.observation,
+                  screenId,
+                  externalBlocked: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              if (retryBoundary.kind === "transient_external") {
+                log2(`   Recovery surfaced system overlay ${retryBoundary.owner}; not adding it to target-app survey evidence.`);
+                return {
+                  observation: `${retryRecovered.observation}${(0, mobile_boundary_js_1.mobileBoundaryNote)(retryBoundary)}`,
+                  screenId: null,
+                  externalBlocked: true,
+                  transientExternal: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              lastExternalOwner = retryBoundary.owner;
+            } catch (err) {
+              log2(`   Target app recovery attempt ${attempt} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+          }
+          log2(`   Relaunch still outside target app (${lastExternalOwner}); no screen recorded.`);
           return {
-            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${recoveredBoundary.owner}, so no screen was recorded)`,
+            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${lastExternalOwner}, so no screen was recorded)`,
             screenId: null,
             externalBlocked: true,
             externalOwner: boundary.owner
@@ -62941,7 +63003,19 @@ Exploration complete: ${summary}`);
           const fromScreenId = state2.getCurrentScreenId();
           const boundaryBeforeAction = currentBoundary();
           const startedOutsideTarget = boundaryBeforeAction.kind !== "target" && boundaryBeforeAction.kind !== "unknown";
-          const actionResult = await driver.tap(resolved.bounds);
+          let actionResult = await driver.tap(resolved.bounds);
+          if (!actionResult.ok && (0, mobile_keyboard_js_1.shouldRetryTapAfterKeyboardDismiss)(actionResult.error, latest()?.screen.elements ?? [])) {
+            log2("   Tap target was outside the visible viewport while an input was focused; dismissing keyboard and retrying once.");
+            const dismissResult = await (0, mobile_keyboard_js_1.dismissKeyboardForRetry)(driver);
+            const retryResult = await driver.tap(resolved.bounds);
+            actionResult = retryResult.ok ? retryResult : {
+              ...retryResult,
+              error: retryResult.error ? `${retryResult.error} (retry after keyboard dismiss also failed)` : "Tap retry after keyboard dismiss failed",
+              source: retryResult.source ?? dismissResult.source,
+              screenshot: retryResult.screenshot ?? dismissResult.screenshot,
+              screenSignal: retryResult.screenSignal ?? dismissResult.screenSignal
+            };
+          }
           const absorbed = await absorbActionResult(actionResult, "mobile_tap");
           const { observation, screenId } = absorbed;
           if (!startedOutsideTarget && !absorbed.externalBlocked && !absorbed.transientExternal) {
@@ -65941,6 +66015,25 @@ var require_mobile_discovery_prompts = __commonJS({
     function targetAppScreens(graph, appId) {
       return [...graph.screens.values()].filter((state2) => isTargetAppScreenId(state2.screenId, appId));
     }
+    function isGenericNonFeatureScreen(state2) {
+      const type = state2.screenType?.trim().toLowerCase();
+      if (type === "error" || type === "permission")
+        return true;
+      if (type && type !== "unknown")
+        return false;
+      const actionableCount = state2.elements.filter((el) => el.actionable).length;
+      if (actionableCount > 0)
+        return false;
+      const evidenceText = [
+        state2.screenName,
+        state2.screenType,
+        ...state2.observations ?? []
+      ].filter((value) => typeof value === "string" && value.trim().length > 0).join(" ");
+      return /\b(empty|loading|blank|spinner|intermediate|placeholder|no actionable)\b/i.test(evidenceText);
+    }
+    function plannableTargetAppScreens(graph, appId) {
+      return targetAppScreens(graph, appId).filter((state2) => !isGenericNonFeatureScreen(state2));
+    }
     exports.MOBILE_SURVEY_SYSTEM_PROMPT = `You are a feature analyst for a native mobile application (iOS or Android). You receive evidence from an AI explorer that mapped the app's screens by tapping, typing, and swiping through the live UI. Your job is to organize screens into meaningful feature groups.
 
 ## Output Discipline
@@ -65960,8 +66053,8 @@ Return ONLY one valid JSON object matching the schema below. Do NOT include <thi
 5. CRUD screens for the same entity belong together
 6. Do NOT merge screens into one feature just because they serve a similar broader goal. Treat areas as separate features when the evidence shows separate primary navigation destinations (e.g. separate tab-bar items or drawer links), separate screen families for distinct entities, or different CRUD entities/forms. Keep screens together when they share one navigational area and operate on the same entity (e.g. a list screen, its filter/sort sheet, and its detail screen all belong together).
 7. Feature descriptions MUST reference actual element labels / accessibility-ids from the evidence
-8. Do NOT create standalone features for generic error / empty screens (network-error, permission-denied). If a feature screen is broken or crashes, keep it in its intended feature and note the failure in the description.
-9. COVER EVERY SCREEN: every explored screen except generic error / permission screens MUST appear in exactly one feature group's routes. Do not leave screens ungrouped \u2014 a screen the explorer reached is part of SOME feature. Attach an ambiguous screen to its most closely related feature and note the ambiguity in that feature's description. Sign-in / sign-up / forgot-password screens form an "Authentication" group even when they were only reached via links from other screens.
+8. Do NOT create standalone features for generic error / empty / loading / intermediate screens (network-error, permission-denied, blank WebView, spinner-only loading). If a feature screen is broken or crashes, keep it in its intended feature and note the failure in the description. If a screen has no actionable controls and only says it is empty/loading/intermediate, omit it from featureGroups.routes unless it is the only evidence for a real product feature.
+9. COVER EVERY PRODUCT SCREEN: every explored product screen except generic error / permission / empty / loading / intermediate screens MUST appear in exactly one feature group's routes. Do not leave usable screens ungrouped \u2014 a screen the explorer reached is part of SOME feature. Attach an ambiguous usable screen to its most closely related feature and note the ambiguity in that feature's description. Sign-in / sign-up / forgot-password screens form an "Authentication" group even when they were only reached via links from other screens.
 10. LOGGED-OUT vs LOGGED-IN SEPARATION: screens shown BEFORE the user is signed in (splash, landing/welcome, theme or language pickers, walkthroughs, sign-up, sign-in, forgot-password, demo/preview screens) must NEVER share a feature group with the signed-in app. Put sign-in / sign-up / forgot-password in "Authentication" (rule 4) and the remaining pre-login screens in an "Onboarding" group. Features named after signed-in areas (feeds, dashboards, tabs, settings) must contain ONLY screens reached after authentication. A pre-login flow is a linear sequence, not a navigation destination \u2014 do not let it swallow the app's main features.
 
 ## Output JSON Schema
@@ -66228,7 +66321,7 @@ ${targetBits.length > 0 ? targetBits.join(" ") : "native mobile app"}`);
         sections.push(`## Feature: ${context.featureName}
 SCOPE: this is a feature-focused deep run. Plan scenarios ONLY for the "${context.featureName}" feature \u2014 its screens, forms, and flows. Screens belonging to other features are navigation context / prerequisites only; do NOT plan scenarios whose primary goal exercises another feature.`);
       }
-      const orderedScreens = targetAppScreens(graph, context.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(graph, context.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       const includedScreenIds = new Set(orderedScreens.map((state2) => state2.screenId));
       sections.push(`## Screens Discovered (${orderedScreens.length})`);
       for (const state2 of orderedScreens) {
@@ -66337,7 +66430,7 @@ ${constraints.join("\n")}`);
       const now = /* @__PURE__ */ new Date();
       const idByScreen = /* @__PURE__ */ new Map();
       let pageSeq = 0;
-      const orderedScreens = targetAppScreens(graph, meta.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(graph, meta.appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       for (const state2 of orderedScreens) {
         idByScreen.set(state2.screenId, `mpage-${pageSeq++}`);
       }
@@ -66398,7 +66491,7 @@ ${constraints.join("\n")}`);
     }
     function buildMobileFeatureGroupsFromGraph(graph, appId) {
       const groups = /* @__PURE__ */ new Map();
-      const orderedScreens = targetAppScreens(graph, appId).filter((state2) => state2.screenType?.toLowerCase() !== "error").sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(graph, appId).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       const includedScreenIds = new Set(orderedScreens.map((state2) => state2.screenId));
       for (const state2 of orderedScreens) {
         const screenTypeLower = state2.screenType?.toLowerCase();
@@ -66445,7 +66538,7 @@ ${constraints.join("\n")}`);
         return [];
       if (input.featureName?.trim())
         return [];
-      const orderedScreens = targetAppScreens(input.graph, input.appId).filter((state2) => state2.screenType?.toLowerCase() !== "error").filter((state2) => state2.visited || state2.firstSeenIteration === 0).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
+      const orderedScreens = plannableTargetAppScreens(input.graph, input.appId).filter((state2) => state2.visited || state2.firstSeenIteration === 0).sort((a, b) => a.firstSeenIteration - b.firstSeenIteration);
       if (orderedScreens.length === 0)
         return [];
       const entryScreenId = orderedScreens[0].screenId;
@@ -66647,9 +66740,11 @@ var require_mobile_generator = __commonJS({
     var mobile_source_parser_js_2 = require_mobile_source_parser();
     var mobile_observation_js_1 = require_mobile_observation();
     var mobile_boundary_js_1 = require_mobile_boundary();
+    var mobile_keyboard_js_1 = require_mobile_keyboard();
     var MAX_SCENARIO_ITERATIONS = 30;
     var MAX_CONSECUTIVE_INFRA_FAILURES = 3;
     var MAX_RECENT_EXCHANGES = 24;
+    var EXTERNAL_APP_RECOVERY_ATTEMPTS = 2;
     var OBSERVATION_MAX_ELEMENTS = 50;
     function finalizeAction(input) {
       return { ...input, url: "", selector: input.selector ?? "" };
@@ -67065,10 +67160,47 @@ Start by calling mobile_snapshot, then execute the steps above \u2014 the minimu
               externalOwner: boundary.owner
             };
           }
-          log2(`  relaunch still outside target app (${recoveredBoundary.owner}); no target-app step recorded.`);
+          let lastExternalOwner = recoveredBoundary.owner;
+          let lastRecovered = recovered;
+          for (let attempt = 1; attempt <= EXTERNAL_APP_RECOVERY_ATTEMPTS; attempt += 1) {
+            try {
+              await driver.launchApp();
+              const retrySnap = await driver.snapshot();
+              const retryRecovered = buildResolved(retrySnap.xml, retrySnap.screenSignal, retrySnap.windowSize);
+              if (!retryRecovered)
+                continue;
+              lastRecovered = retryRecovered;
+              const retryBoundary = (0, mobile_boundary_js_1.classifyMobileScreenBoundary)(retryRecovered.signal, targetAppId, platform3);
+              setLatest(retryRecovered);
+              if ((0, mobile_boundary_js_1.isTargetLikeMobileBoundary)(retryBoundary)) {
+                emitScreenshot(retrySnap.screenshot);
+                log2(`  recovered target app after ${attempt} additional activation attempt(s).`);
+                return {
+                  resolved: retryRecovered,
+                  observation: retryRecovered.observation,
+                  externalBlocked: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              if (retryBoundary.kind === "transient_external") {
+                log2(`  recovery surfaced system overlay ${retryBoundary.owner}; not recording it as a target-app step.`);
+                return {
+                  resolved: retryRecovered,
+                  observation: `${retryRecovered.observation}${(0, mobile_boundary_js_1.mobileBoundaryNote)(retryBoundary)}`,
+                  externalBlocked: true,
+                  transientExternal: true,
+                  externalOwner: boundary.owner
+                };
+              }
+              lastExternalOwner = retryBoundary.owner;
+            } catch (err) {
+              log2(`  target app recovery attempt ${attempt} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+          }
+          log2(`  relaunch still outside target app (${lastExternalOwner}); no target-app step recorded.`);
           return {
-            resolved: recovered,
-            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${recoveredBoundary.owner}, so no target-app step was recorded)`,
+            resolved: lastRecovered,
+            observation: `(left target app ${boundary.targetAppId} for ${boundary.owner}; relaunch still showed ${lastExternalOwner}, so no target-app step was recorded)`,
             externalBlocked: true,
             externalOwner: boundary.owner
           };
@@ -67282,7 +67414,19 @@ ${statePacket}` },
             return unknownRef(toolArgs.ref);
           const beforeScreenName = screenName();
           const before = latest();
-          const result = await driver.tap(element.bounds);
+          let result = await driver.tap(element.bounds);
+          if (!result.ok && (0, mobile_keyboard_js_1.shouldRetryTapAfterKeyboardDismiss)(result.error, before?.screen.elements ?? [])) {
+            log2("  tap target was outside the visible viewport while an input was focused; dismissing keyboard and retrying once.");
+            const dismissResult = await (0, mobile_keyboard_js_1.dismissKeyboardForRetry)(driver);
+            const retryResult = await driver.tap(element.bounds);
+            result = retryResult.ok ? retryResult : {
+              ...retryResult,
+              error: retryResult.error ? `${retryResult.error} (retry after keyboard dismiss also failed)` : "Tap retry after keyboard dismiss failed",
+              source: retryResult.source ?? dismissResult.source,
+              screenshot: retryResult.screenshot ?? dismissResult.screenshot,
+              screenSignal: retryResult.screenSignal ?? dismissResult.screenSignal
+            };
+          }
           const absorbed = await absorbObservation(result.source, result.screenSignal, latest()?.screen.windowSize ?? null, result.screenshot, "mobile_tap");
           if (shouldRecordAction(result, absorbed) && changedScreen(before, absorbed)) {
             recordAction({
@@ -315417,8 +315561,8 @@ var require_mobile_discovery_agent = __commonJS({
           };
         }
         log2("\n\u2500\u2500 Phase 1: EXPLORE \u2500\u2500");
-        const exploreAppDataCleared = await prepareMobileAppStateForDiscovery(driver, target, "explore", log2);
-        log2(exploreAppDataCleared ? "App data cleared \u2014 exploring from a deterministic cold (logged-out) state." : target?.resetPolicy === "PRESERVE_APP_DATA" ? "App data reset skipped by policy \u2014 exploring with preserved app data." : "App data reset unavailable (platform/device policy) \u2014 exploring the app in its current state.");
+        const exploreAppDataCleared = await prepareMobileAppStateForDiscovery(driver, target, "explore", mode, log2);
+        log2(exploreAppDataCleared ? "App data cleared \u2014 exploring from a deterministic cold (logged-out) state." : target?.resetPolicy === "PRESERVE_APP_DATA" ? "App data reset skipped by policy \u2014 exploring with preserved app data." : mode === "survey" && (target?.resetPolicy ?? "AUTO") === "AUTO" ? "App data reset skipped for mobile survey AUTO \u2014 exploring with preserved app data. Use resetPolicy=CLEAR_APP_DATA for a cold logged-out survey." : "App data reset unavailable (platform/device policy) \u2014 exploring the app in its current state.");
         const state2 = new mobile_exploration_state_js_1.MobileExplorationState();
         const maxIterations = getMobileExploreBudget(mode, ctx.incremental);
         const existingScreens = isSurvey && ctx.incremental ? compactExistingScreens(ctx.existingSiteMap) : void 0;
@@ -315660,10 +315804,11 @@ Fatal error: ${msg}`);
         };
       }
     }
-    async function prepareMobileAppStateForDiscovery(driver, target, phase, log2) {
+    async function prepareMobileAppStateForDiscovery(driver, target, phase, mode, log2) {
       void phase;
       const resetPolicy = target?.resetPolicy ?? "AUTO";
-      if (resetPolicy === "PRESERVE_APP_DATA") {
+      const shouldPreserveAppData = resetPolicy === "PRESERVE_APP_DATA" || mode === "survey" && resetPolicy === "AUTO";
+      if (shouldPreserveAppData) {
         try {
           await driver.relaunch();
         } catch (err) {
@@ -330184,7 +330329,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.31",
+      version: "1.0.32",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -330848,6 +330993,37 @@ async function swipe(sessionPath, direction, distance, windowSize) {
 async function pressBack(sessionPath) {
   await appiumRequest(`${sessionPath}/back`, { method: "POST", body: "{}" });
 }
+function isKeyboardAlreadyHiddenError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  return /keyboard.*(not|already).*(shown|visible|present|open)|no.*keyboard/i.test(message);
+}
+async function dismissKeyboard(sessionPath, platform3) {
+  if (platform3 === "ANDROID") {
+    await pressBack(sessionPath);
+    return;
+  }
+  try {
+    await appiumRequest(`${sessionPath}/appium/device/hide_keyboard`, {
+      method: "POST",
+      body: "{}"
+    });
+    return;
+  } catch (err) {
+    if (isAppiumDriverDeadError(err)) throw err;
+    if (isKeyboardAlreadyHiddenError(err)) return;
+  }
+  try {
+    await appiumRequest(`${sessionPath}/execute/sync`, {
+      method: "POST",
+      body: JSON.stringify({ script: "mobile: hideKeyboard", args: [{}] })
+    });
+    return;
+  } catch (err) {
+    if (isAppiumDriverDeadError(err)) throw err;
+    if (isKeyboardAlreadyHiddenError(err)) return;
+  }
+  await pressBack(sessionPath);
+}
 async function pressHome(sessionPath, platform3) {
   if (platform3 === "IOS") {
     await appiumRequest(`${sessionPath}/execute/sync`, {
@@ -334844,6 +335020,10 @@ var MobileBridgeDriver = class {
   async back() {
     return this.runAction(() => pressBack(this.sessionPath));
   }
+  /** Platform-aware software keyboard dismissal. */
+  async dismissKeyboard() {
+    return this.runAction(() => dismissKeyboard(this.sessionPath, this.platform));
+  }
   /** System Home — backgrounds the app only (use `relaunch` for hermetic reset). */
   async home() {
     return this.runAction(() => pressHome(this.sessionPath, this.platform));
@@ -335229,8 +335409,12 @@ function attachMobileDiscoveryNetworkContext(calls, result, appId) {
     pageUrl: call.pageUrl ?? pageUrl
   }));
 }
+var runnerPackage = require_package4();
 var SECRET_VAR_PATTERN = /password|secret|token|api[_]?key|pass\b|credential|bearer|pat\b/i;
 var IS_CLOUD = process.env.RUNNER_CLOUD === "true";
+var RUNNER_NAME = runnerPackage.name ?? "@validate.qa/runner";
+var RUNNER_VERSION = runnerPackage.version ?? "0.0.0";
+var RUNNER_BUILD_ID = process.env.VALIDATE_RUNNER_BUILD_ID ?? process.env.RAILWAY_GIT_COMMIT_SHA ?? process.env.GIT_COMMIT_SHA ?? process.env.SOURCE_VERSION;
 var DEFAULT_MAX_CONCURRENT = IS_CLOUD ? 4 : 40;
 var DEFAULT_TYPE_LIMITS = {
   discovery: IS_CLOUD ? 2 : 15,
@@ -338064,6 +338248,9 @@ async function startRunner(opts) {
         method: "POST",
         headers,
         body: JSON.stringify({
+          runnerName: RUNNER_NAME,
+          runnerVersion: RUNNER_VERSION,
+          runnerBuildId: RUNNER_BUILD_ID,
           runsCompleted,
           activeRuns,
           maxConcurrent: MAX_CONCURRENT,

package/package.json

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