@aarwitz/tapp 0.17.0-rc.2 → 0.17.0-rc.4

package/mcp-server/src/android-driver.js

@@ -41,6 +41,16 @@ function runFile(command, args, { encoding = "utf8", timeout = 30_000, maxBuffer
   });
 }
 
+export function parseLatestAndroidCrashExitInfo(output) {
+  const blocks = String(output || "").split(/ApplicationExitInfo #\d+:/).slice(1);
+  for (const block of blocks) {
+    const reason = block.match(/\breason=(4|5)\s+\((?:APP CRASH|NATIVE CRASH)/);
+    const identity = block.match(/\btimestamp=([^\n]+?)\s+pid=(\d+)\b/);
+    if (reason && identity) return `${identity[1].trim()}|${identity[2]}|${reason[1]}`;
+  }
+  return null;
+}
+
 function entityDecode(value) {
   return String(value || "")
     .replaceAll(""", '"').replaceAll("'", "'")
@@ -171,6 +181,13 @@ export class AndroidDriver {
     return r.code === 0 && /\d/.test(String(r.stdout || ""));
   }
 
+  async latestCrashExitInfo() {
+    if (!this.appId) return null;
+    const r = await this.adb(["shell", "dumpsys", "activity", "exit-info", this.appId]);
+    if (r.code !== 0) return null;
+    return parseLatestAndroidCrashExitInfo(r.stdout);
+  }
+
   async clearData() {
     if (!this.appId) throw new Error("appId is required to clear Android app data");
     const r = await this.adb(["shell", "pm", "clear", this.appId]);
@@ -188,7 +205,22 @@ export class AndroidDriver {
     const r = await this.adb(["shell", "am", "start", "-W", "-n", component], { timeout: 30_000 });
     if (r.code !== 0 || !/Status:\s*ok/i.test(String(r.stdout))) throw new Error((r.stderr || r.stdout || `Could not launch ${this.appId}`).trim());
     await sleep(600);
-    return this.snapshot();
+    return this.waitForOwnedSnapshot();
+  }
+
+  async waitForOwnedSnapshot(timeoutMs = 4_000) {
+    const deadline = Date.now() + timeoutMs;
+    let latest;
+    do {
+      latest = await this.snapshot();
+      if (isAndroidAppSnapshot(latest, this.appId)) return latest;
+      if (Date.now() >= deadline) break;
+      // Activity and UIAutomator are intentionally required to agree. During app
+      // launch they may momentarily describe opposite sides of the transition;
+      // retry that mixed snapshot instead of turning it into zero-screen evidence.
+      await sleep(150);
+    } while (Date.now() < deadline);
+    return latest;
   }
 
   async currentActivity() {

package/mcp-server/src/android-explorer.js

@@ -9,6 +9,7 @@ import { semanticUiKey } from "./ui-map.js";
 const ERROR_RE = /\b(something went wrong|internal server error|an error occurred|failed to load|unhandled exception|has stopped)\b/i;
 const DESTRUCTIVE_RE = /\b(delete|remove|purchase|buy now|pay now|reset|erase|unsubscribe|sign out|log out|logout)\b/i;
 const AUTH_SUBMIT_RE = /\b(sign[ -]?in|log[ -]?in|continue|submit)\b/i;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 function stateHash(snap) {
   return snap.elements.map((e) => `${androidElementKey(e)}:${e.text}:${e.x},${e.y}`).join("|");
@@ -72,12 +73,26 @@ export async function exploreAndroid({ appId, apkPath, serial, maxActions = 40,
   const visited = new Map();
   let issues = 0;
   let actions = 0;
+  const crashExitBaseline = typeof d.latestCrashExitInfo === "function" ? await d.latestCrashExitInfo() : null;
   let snap = await d.launch({ clearData });
   let crashReported = false;
 
   const reportProcessExit = async (screen, step) => {
-    const alive = typeof d.isProcessAlive === "function" ? await d.isProcessAlive() : true;
-    if (alive || crashReported) return false;
+    if (typeof d.isProcessAlive !== "function") return false;
+    // Android may reveal the launcher before the crashing process disappears from
+    // pidof. A one-shot liveness sample made identical crashes scheduler-dependent.
+    // Poll only after app ownership is already lost: external intents and ordinary
+    // Back boundaries keep the originating process alive and remain boundaries.
+    let alive = await d.isProcessAlive();
+    let latestCrash = typeof d.latestCrashExitInfo === "function" ? await d.latestCrashExitInfo() : null;
+    const exitDeadline = Date.now() + 2_000;
+    while (alive && (!latestCrash || latestCrash === crashExitBaseline) && Date.now() < exitDeadline) {
+      await sleep(150);
+      alive = await d.isProcessAlive();
+      latestCrash = typeof d.latestCrashExitInfo === "function" ? await d.latestCrashExitInfo() : null;
+    }
+    const recordedCrash = !!latestCrash && latestCrash !== crashExitBaseline;
+    if ((alive && !recordedCrash) || crashReported) return false;
     crashReported = true;
     emit("ISSUE", { type: "crash", severity: "critical", title: "App process exited during exploration", screen: screen || "Launch", step });
     issues += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aarwitz/tapp",
-  "version": "0.17.0-rc.2",
+  "version": "0.17.0-rc.4",
   "mcpName": "io.github.aarwitz/tapp",
   "description": "Release contracts, autonomous QA, and evidence-backed CI gates for iOS, Android, and web.",
   "license": "MIT",

package/scripts/ci-gate.sh

@@ -11,7 +11,7 @@
 #
 # Usage:
 #   scripts/ci-gate.sh [--platform ios] --app <path/to/App.app> [--bundle-id <com.example.app>]
-#   scripts/ci-gate.sh --platform android --apk <path/to/app.apk> --app-id <com.example.app>
+#   scripts/ci-gate.sh --platform android --apk <path/to/app.apk> --app-id <com.example.app> [--serial <adb-serial>]
 #   scripts/ci-gate.sh --platform web [--url <http(s)://owned-app>]
 #                      # omit --url with --project-dir to detect/build/start/stop one owned web target
 #                      # bundle id is detected from the .app when omitted
@@ -31,6 +31,7 @@
 #                      [--json-out <file.json>]   # write the full report (use as the next baseline)
 #                      [--md-out <file.md>]       # write the rendered markdown report (for a PR comment)
 #                      [--device <name>]          # simulator device to boot if none is (default "iPhone 16 Pro")
+#                      [--serial <adb-serial>]    # Android emulator/device (default: first connected device)
 #
 # The app must be a SIMULATOR build (xcodebuild ... -destination 'generic/platform=iOS Simulator').
 set -uo pipefail