zeno-mobile-runner 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -4,6 +4,58 @@ All notable changes to Zeno Mobile Runner are tracked here.
 
 ## Unreleased
 
+## 0.2.2 (2026-06-15)
+
+### Fixed
+
+- Migrated the runner to Zig 0.16 process IO and initialized the process IO
+  runtime before spawning child commands. This fixes `OutOfMemory` failures
+  when commands such as `zmr devices --platform ios --json` or XCTest shim
+  launches tried to call `xcrun` through an uninitialized IO context.
+- The iOS XCTest shim now resumes an Expo dev-client project from the
+  "Development servers" home screen after an `openLink` command. This covers
+  the common case where iOS returns to the Expo launcher instead of immediately
+  dispatching a pending app deep link, by selecting the app project row rather
+  than requiring each app scenario to add launcher-specific workarounds.
+- The generated React Native/Expo demo app no longer sets `accessibilityLabel`
+  to its own `testID` values. On iOS the label overrides the visible text in
+  the accessibility tree, which made every text selector in the generated iOS
+  workflow scenario unmatchable against the generated app itself (and modeled
+  an accessibility antipattern — screen readers announced "demo_title" instead
+  of the title). Found while recording real demo footage; the fixture's text
+  waits now pass on iOS.
+
+### Added
+
+- Added `scripts/record-demo-video.sh` (maintainer-only, npm-excluded): a
+  reproducible pipeline that records the launch-demo footage from the
+  generated Expo demo app — a passing workflow run, a copy-change break with
+  the `zmr explain` diagnosis, and the repaired green run — plus the
+  storyboard in `docs/demo-video-storyboard.md`.
+
+## 0.2.1 (2026-06-10)
+
+### Fixed
+
+- iOS simulator `openLink` now asks the XCTest shim to accept the SpringBoard
+  "Open in <App>?" confirmation for custom URL schemes too, not just
+  http/https universal links. Custom schemes are the common Expo dev-client
+  deep-link case (`exp+scheme://expo-development-client/...`), and the
+  unaccepted dialog previously blocked navigation entirely. The shim's
+  `acceptSystemAlert` also gained a single alert-existence probe so the
+  best-effort accept stays fast when no dialog appears.
+- The generated Expo dev-client scenarios no longer pass when only the Expo
+  dev launcher rendered. The old `waitAny` markers also matched launcher
+  chrome ("Home", "Continue", "Sign in"), so runs exited green even though
+  the app's JS bundle never loaded. The scenarios now wait for the launcher's
+  persistent marker to be gone (`waitNotVisible` on "evelopment servers",
+  covering both case-sensitive spellings) — passing immediately when the deep
+  link navigates, and failing when the launcher is stuck — then assert no
+  bundle-error screen ("Unable to load" / "There was a problem loading") is
+  visible before `assertHealthy` and `snapshot`. Verified both directions
+  against a real Expo SDK 56 app: passes in ~24s with Metro serving, fails
+  with a wait timeout when the bundler is down.
+
 ## 0.2.0 (2026-06-10)
 
 ### Added

package/FEATURES.md

@@ -142,7 +142,7 @@ state, and writes deterministic traces. It does not embed an LLM.
 
 ## Current Limitations
 
-- Current release status is `0.2.0`, a public developer preview rather than
+- Current release status is `0.2.2`, a public developer preview rather than
   a production-stable `1.0.0`.
 - Physical iOS log capture is still simulator-first. Physical iOS screenshots
   are available when the XCTest/XCUIAutomation shim is configured.

package/README.md

@@ -86,6 +86,14 @@ Hook it up to your coding agent (Claude Code shown; any MCP client works):
 claude mcp add zmr -- npx zmr mcp --config .zmr/config.json --trace-dir traces/zmr-agent
 ```
 
+Claude Code users can instead install the plugin, which bundles the MCP server
+and a mobile-testing skill:
+
+```text
+/plugin marketplace add johnmikel/zeno-mobile-runner
+/plugin install zmr@zmr-marketplace
+```
+
 Or in an `.mcp.json` / MCP client config:
 
 ```json
@@ -189,7 +197,7 @@ comparisons against your current E2E tool, and multi-device matrices, see
 | Cloud device farms | Not included | ZMR focuses on local and self-managed device targets in this preview |
 
 Slow CI hardware can extend the iOS shim cold-build timeout with
-`ZMR_IOS_SHIM_TIMEOUT_MS`. Current release: `0.2.0` developer preview.
+`ZMR_IOS_SHIM_TIMEOUT_MS`. Current release: `0.2.2` developer preview.
 Protocol version: `2026-04-28`.
 
 ## Optional protocol clients

package/build.zig.zon

@@ -1,7 +1,7 @@
 .{
     .name = .zeno_mobile_runner,
-    .version = "0.1.7",
-    .minimum_zig_version = "0.15.2",
+    .version = "0.2.2",
+    .minimum_zig_version = "0.16.0",
     .paths = .{""},
     .fingerprint = 0xcc2c8187874868fc,
 }

package/clients/kotlin/README.md

@@ -27,7 +27,7 @@ gradle -p clients/kotlin runFakeSession \
 ```
 
 ```kotlin
-implementation(files("path/to/zeno-mobile-runner/clients/kotlin/build/libs/zmr-client-0.2.0.jar"))
+implementation(files("path/to/zeno-mobile-runner/clients/kotlin/build/libs/zmr-client-0.2.2.jar"))
 ```
 
 ```kotlin

package/clients/kotlin/build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = "dev.zmr"
-version = "0.2.0"
+version = "0.2.2"
 
 kotlin {
     jvmToolchain(17)

package/clients/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "zmr-client"
-version = "0.2.0.dev1"
+version = "0.2.2.dev1"
 description = "Python JSON-RPC client for Zeno Mobile Runner."
 requires-python = ">=3.9"
 license = { text = "MIT" }

package/clients/rust/Cargo.lock

@@ -100,7 +100,7 @@ checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"
 
 [[package]]
 name = "zmr-client"
-version = "0.2.0"
+version = "0.2.2"
 dependencies = [
  "serde",
  "serde_json",

package/clients/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "zmr-client"
-version = "0.2.0"
+version = "0.2.2"
 edition = "2021"
 license = "MIT"
 description = "Rust JSON-RPC client for Zeno Mobile Runner."

package/clients/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zmr/client",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "main": "index.mjs",
   "types": "index.d.ts",

package/docs/protocol-fixtures/core-session.responses.jsonl

@@ -1,4 +1,4 @@
-{"jsonrpc":"2.0","id":1,"result":{"name":"zmr","version":"0.2.0","protocolVersion":"2026-04-28","protocol":{"version":"2026-04-28","minimumCompatibleVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"},"platforms":["android","ios"],"platformSupport":{"android":{"status":"supported","deviceTypes":["emulator","physical"],"automation":["adb","uiautomator","android-shim"]},"ios":{"status":"supported","deviceTypes":["simulator","physical"],"automation":["simctl","devicectl","xctest-shim"],"physicalDevices":true}},"iosPreview":false,"transports":["stdio","tcp"],"methods":["runner.capabilities","device.list","session.create","session.close","app.install","app.launch","app.stop","app.openLink","app.clearState","observe.snapshot","observe.semanticSnapshot","ui.tap","ui.type","ui.eraseText","ui.hideKeyboard","ui.swipe","ui.pressBack","ui.scrollUntilVisible","wait.until","wait.any","wait.gone","assert.visible","assert.notVisible","assert.healthy","scenario.validate","trace.events","trace.explore","trace.discover","trace.explain","trace.export"]}}
+{"jsonrpc":"2.0","id":1,"result":{"name":"zmr","version":"0.2.2","protocolVersion":"2026-04-28","protocol":{"version":"2026-04-28","minimumCompatibleVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"},"platforms":["android","ios"],"platformSupport":{"android":{"status":"supported","deviceTypes":["emulator","physical"],"automation":["adb","uiautomator","android-shim"]},"ios":{"status":"supported","deviceTypes":["simulator","physical"],"automation":["simctl","devicectl","xctest-shim"],"physicalDevices":true}},"iosPreview":false,"transports":["stdio","tcp"],"methods":["runner.capabilities","device.list","session.create","session.close","app.install","app.launch","app.stop","app.openLink","app.clearState","observe.snapshot","observe.semanticSnapshot","ui.tap","ui.type","ui.eraseText","ui.hideKeyboard","ui.swipe","ui.pressBack","ui.scrollUntilVisible","wait.until","wait.any","wait.gone","assert.visible","assert.notVisible","assert.healthy","scenario.validate","trace.events","trace.explore","trace.discover","trace.explain","trace.export"]}}
 {"jsonrpc":"2.0","id":2,"result":[{"serial":"fake-device-1","state":"device","ready":true}]}
 {"jsonrpc":"2.0","id":3,"result":{"sessionId":"default"}}
 {"jsonrpc":"2.0","id":4,"result":true}

package/docs/protocol.md

@@ -2,7 +2,7 @@
 
 ZMR exposes newline-delimited JSON-RPC 2.0 over stdio or localhost TCP in v1. Each request is one JSON object followed by `\n`. Each response is one JSON object followed by `\n`.
 
-Current runner version: `0.2.0`.
+Current runner version: `0.2.2`.
 
 Current protocol version: `2026-04-28`.
 
@@ -47,7 +47,7 @@ and protocol versions. The response is covered by
 `schemas/inspect-output.schema.json`:
 
 ```json
-{"ok":true,"status":"ready","schemaVersion":1,"runnerVersion":"0.2.0","protocolVersion":"2026-04-28","dir":".","configPath":".zmr/config.json","configExists":true,"agentInstructionsPath":".zmr/AGENTS.md","agentInstructionsExists":true,"platforms":[{"name":"android","enabled":true,"defaultDevice":"emulator-5554","smokeScenario":".zmr/android-smoke.json","smokeScenarioExists":true,"traceDir":"traces/zmr-android"},{"name":"ios","enabled":true,"defaultDevice":"booted","smokeScenario":".zmr/ios-smoke.json","smokeScenarioExists":true,"traceDir":"traces/zmr-ios"}],"recommendedCommands":["zmr doctor --strict --json --config .zmr/config.json","zmr schemas --json","zmr validate --json .zmr/android-smoke.json","zmr validate --json .zmr/ios-smoke.json","zmr serve --transport stdio --config .zmr/config.json --trace-dir traces/zmr-agent","zmr mcp --config .zmr/config.json --trace-dir traces/zmr-agent"],"claimsPolicy":["verify runs with trace evidence before making readiness claims","do not claim Flutter widget-tree inspection"],"limitations":["inspect is read-only and does not launch devices","autonomous crawling is not shipped; generate or edit scenarios for human review"]}
+{"ok":true,"status":"ready","schemaVersion":1,"runnerVersion":"0.2.2","protocolVersion":"2026-04-28","dir":".","configPath":".zmr/config.json","configExists":true,"agentInstructionsPath":".zmr/AGENTS.md","agentInstructionsExists":true,"platforms":[{"name":"android","enabled":true,"defaultDevice":"emulator-5554","smokeScenario":".zmr/android-smoke.json","smokeScenarioExists":true,"traceDir":"traces/zmr-android"},{"name":"ios","enabled":true,"defaultDevice":"booted","smokeScenario":".zmr/ios-smoke.json","smokeScenarioExists":true,"traceDir":"traces/zmr-ios"}],"recommendedCommands":["zmr doctor --strict --json --config .zmr/config.json","zmr schemas --json","zmr validate --json .zmr/android-smoke.json","zmr validate --json .zmr/ios-smoke.json","zmr serve --transport stdio --config .zmr/config.json --trace-dir traces/zmr-agent","zmr mcp --config .zmr/config.json --trace-dir traces/zmr-agent"],"claimsPolicy":["verify runs with trace evidence before making readiness claims","do not claim Flutter widget-tree inspection"],"limitations":["inspect is read-only and does not launch devices","autonomous crawling is not shipped; generate or edit scenarios for human review"]}
 ```
 
 `zmr discover --from-trace <trace-dir> --out <scenario.json> --validate --json`
@@ -60,7 +60,7 @@ invent credentials, or commit files. The response is covered by
 `schemas/discover-output.schema.json`:
 
 ```json
-{"ok":true,"mode":"discover","schemaVersion":1,"runnerVersion":"0.2.0","protocolVersion":"2026-04-28","out":".zmr/discovered/replay-smoke.json","traceDir":"traces/zmr-agent","sourceSnapshot":"traces/zmr-agent/artifacts/snapshot-2.json","name":"draft from login smoke","appId":"com.example.mobiletest","selectorCount":2,"stepCount":6,"replay":{"enabled":true,"eventCount":4,"stepCount":3,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/replay-smoke.json","name":"draft from login smoke","appId":"com.example.mobiletest","stepCount":6},"nextCommands":["zmr validate --json .zmr/discovered/replay-smoke.json","zmr run .zmr/discovered/replay-smoke.json --json --trace-dir traces/zmr-agent"]}
+{"ok":true,"mode":"discover","schemaVersion":1,"runnerVersion":"0.2.2","protocolVersion":"2026-04-28","out":".zmr/discovered/replay-smoke.json","traceDir":"traces/zmr-agent","sourceSnapshot":"traces/zmr-agent/artifacts/snapshot-2.json","name":"draft from login smoke","appId":"com.example.mobiletest","selectorCount":2,"stepCount":6,"replay":{"enabled":true,"eventCount":4,"stepCount":3,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/replay-smoke.json","name":"draft from login smoke","appId":"com.example.mobiletest","stepCount":6},"nextCommands":["zmr validate --json .zmr/discovered/replay-smoke.json","zmr run .zmr/discovered/replay-smoke.json --json --trace-dir traces/zmr-agent"]}
 ```
 
 `zmr explore --from-trace <trace-dir> --out <scenario.json> --goal <goal>
@@ -71,7 +71,7 @@ launch devices, crawl the app, invent missing actions, discover credentials, or
 commit files. The response is covered by `schemas/explore-output.schema.json`:
 
 ```json
-{"ok":true,"mode":"explore","schemaVersion":1,"runnerVersion":"0.2.0","protocolVersion":"2026-04-28","goal":"find a stable login smoke","autonomous":false,"reviewRequired":true,"guardrails":["writes from existing trace evidence only","does not crawl the app","does not discover credentials or secrets","requires human review before commit"],"out":".zmr/discovered/login-smoke.json","traceDir":"traces/zmr-agent","sourceSnapshot":"traces/zmr-agent/artifacts/snapshot-2.json","name":"draft from login smoke","appId":"com.example.mobiletest","selectorCount":2,"stepCount":6,"replay":{"enabled":true,"eventCount":4,"stepCount":3,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/login-smoke.json","name":"draft from login smoke","appId":"com.example.mobiletest","stepCount":6},"nextCommands":["zmr validate --json .zmr/discovered/login-smoke.json","zmr run .zmr/discovered/login-smoke.json --json --trace-dir traces/zmr-agent"]}
+{"ok":true,"mode":"explore","schemaVersion":1,"runnerVersion":"0.2.2","protocolVersion":"2026-04-28","goal":"find a stable login smoke","autonomous":false,"reviewRequired":true,"guardrails":["writes from existing trace evidence only","does not crawl the app","does not discover credentials or secrets","requires human review before commit"],"out":".zmr/discovered/login-smoke.json","traceDir":"traces/zmr-agent","sourceSnapshot":"traces/zmr-agent/artifacts/snapshot-2.json","name":"draft from login smoke","appId":"com.example.mobiletest","selectorCount":2,"stepCount":6,"replay":{"enabled":true,"eventCount":4,"stepCount":3,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/login-smoke.json","name":"draft from login smoke","appId":"com.example.mobiletest","stepCount":6},"nextCommands":["zmr validate --json .zmr/discovered/login-smoke.json","zmr run .zmr/discovered/login-smoke.json --json --trace-dir traces/zmr-agent"]}
 ```
 
 `zmr draft --from-trace <trace-dir> --out <scenario.json> --json` is the lower
@@ -84,7 +84,7 @@ into fields, or commit files. The response is covered by
 `schemas/draft-output.schema.json`:
 
 ```json
-{"ok":true,"mode":"draft","schemaVersion":1,"runnerVersion":"0.2.0","protocolVersion":"2026-04-28","out":".zmr/discovered/surface-smoke.json","traceDir":"traces/zmr-agent","sourceSnapshot":"traces/zmr-agent/artifacts/snapshot-2.json","name":"draft from login smoke","appId":"com.example.mobiletest","selectorCount":2,"stepCount":4,"replay":{"enabled":false,"eventCount":0,"stepCount":0,"skippedEventCount":0},"warnings":["draft requires human review before commit"],"nextCommands":["zmr validate --json .zmr/discovered/surface-smoke.json","zmr run .zmr/discovered/surface-smoke.json --json --trace-dir traces/zmr-agent"]}
+{"ok":true,"mode":"draft","schemaVersion":1,"runnerVersion":"0.2.2","protocolVersion":"2026-04-28","out":".zmr/discovered/surface-smoke.json","traceDir":"traces/zmr-agent","sourceSnapshot":"traces/zmr-agent/artifacts/snapshot-2.json","name":"draft from login smoke","appId":"com.example.mobiletest","selectorCount":2,"stepCount":4,"replay":{"enabled":false,"eventCount":0,"stepCount":0,"skippedEventCount":0},"warnings":["draft requires human review before commit"],"nextCommands":["zmr validate --json .zmr/discovered/surface-smoke.json","zmr run .zmr/discovered/surface-smoke.json --json --trace-dir traces/zmr-agent"]}
 ```
 
 `zmr draft --include-actions` additionally parses `events.jsonl` and prepends
@@ -214,7 +214,7 @@ installers, setup scripts, and generated clients. The response is covered by
 `schemas/version-output.schema.json`:
 
 ```json
-{"name":"zmr","version":"0.2.0","protocolVersion":"2026-04-28","minimumCompatibleProtocolVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"}
+{"name":"zmr","version":"0.2.2","protocolVersion":"2026-04-28","minimumCompatibleProtocolVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"}
 ```
 
 ## Capabilities Output Contract
@@ -226,7 +226,7 @@ and method inventory for JSON-RPC clients. The result object is covered by
 iOS simulator, or physical iOS workflows are available.
 
 ```json
-{"name":"zmr","version":"0.2.0","protocolVersion":"2026-04-28","protocol":{"version":"2026-04-28","minimumCompatibleVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"},"platforms":["android","ios"],"platformSupport":{"android":{"status":"supported","deviceTypes":["emulator","physical"],"automation":["adb","uiautomator","android-shim"]},"ios":{"status":"supported","deviceTypes":["simulator","physical"],"automation":["simctl","devicectl","xctest-shim"],"physicalDevices":true}},"iosPreview":false,"transports":["stdio","tcp"],"methods":["runner.capabilities","device.list","session.create","session.close","app.install","app.launch","app.stop","app.openLink","app.clearState","observe.snapshot","observe.semanticSnapshot","ui.tap","ui.type","ui.eraseText","ui.hideKeyboard","ui.swipe","ui.pressBack","ui.scrollUntilVisible","wait.until","wait.any","wait.gone","assert.visible","assert.notVisible","assert.healthy","scenario.validate","trace.events","trace.explore","trace.discover","trace.explain","trace.export"]}
+{"name":"zmr","version":"0.2.2","protocolVersion":"2026-04-28","protocol":{"version":"2026-04-28","minimumCompatibleVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"},"platforms":["android","ios"],"platformSupport":{"android":{"status":"supported","deviceTypes":["emulator","physical"],"automation":["adb","uiautomator","android-shim"]},"ios":{"status":"supported","deviceTypes":["simulator","physical"],"automation":["simctl","devicectl","xctest-shim"],"physicalDevices":true}},"iosPreview":false,"transports":["stdio","tcp"],"methods":["runner.capabilities","device.list","session.create","session.close","app.install","app.launch","app.stop","app.openLink","app.clearState","observe.snapshot","observe.semanticSnapshot","ui.tap","ui.type","ui.eraseText","ui.hideKeyboard","ui.swipe","ui.pressBack","ui.scrollUntilVisible","wait.until","wait.any","wait.gone","assert.visible","assert.notVisible","assert.healthy","scenario.validate","trace.events","trace.explore","trace.discover","trace.explain","trace.export"]}
 ```
 
 ## Doctor Output Contract
@@ -432,7 +432,7 @@ Request:
 Response:
 
 ```json
-{"jsonrpc":"2.0","id":1,"result":{"name":"zmr","version":"0.2.0","protocolVersion":"2026-04-28","protocol":{"version":"2026-04-28","minimumCompatibleVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"},"platforms":["android","ios"],"platformSupport":{"android":{"status":"supported","deviceTypes":["emulator","physical"],"automation":["adb","uiautomator","android-shim"]},"ios":{"status":"supported","deviceTypes":["simulator","physical"],"automation":["simctl","devicectl","xctest-shim"],"physicalDevices":true}},"iosPreview":false,"transports":["stdio","tcp"],"methods":["runner.capabilities","device.list","session.create","session.close","app.install","app.launch","app.stop","app.openLink","app.clearState","observe.snapshot","observe.semanticSnapshot","ui.tap","ui.type","ui.eraseText","ui.hideKeyboard","ui.swipe","ui.pressBack","ui.scrollUntilVisible","wait.until","wait.any","wait.gone","assert.visible","assert.notVisible","assert.healthy","scenario.validate","trace.events","trace.explore","trace.discover","trace.explain","trace.export"]}}
+{"jsonrpc":"2.0","id":1,"result":{"name":"zmr","version":"0.2.2","protocolVersion":"2026-04-28","protocol":{"version":"2026-04-28","minimumCompatibleVersion":"2026-04-28","stability":"dev-preview","breakingChangePolicy":"version-and-changelog"},"platforms":["android","ios"],"platformSupport":{"android":{"status":"supported","deviceTypes":["emulator","physical"],"automation":["adb","uiautomator","android-shim"]},"ios":{"status":"supported","deviceTypes":["simulator","physical"],"automation":["simctl","devicectl","xctest-shim"],"physicalDevices":true}},"iosPreview":false,"transports":["stdio","tcp"],"methods":["runner.capabilities","device.list","session.create","session.close","app.install","app.launch","app.stop","app.openLink","app.clearState","observe.snapshot","observe.semanticSnapshot","ui.tap","ui.type","ui.eraseText","ui.hideKeyboard","ui.swipe","ui.pressBack","ui.scrollUntilVisible","wait.until","wait.any","wait.gone","assert.visible","assert.notVisible","assert.healthy","scenario.validate","trace.events","trace.explore","trace.discover","trace.explain","trace.export"]}}
 ```
 
 ### `trace.events`
@@ -514,7 +514,7 @@ Request:
 Response:
 
 ```json
-{"jsonrpc":"2.0","id":25,"result":{"ok":true,"mode":"discover","schemaVersion":1,"runnerVersion":"0.2.0","protocolVersion":"2026-04-28","out":".zmr/discovered/agent-smoke.json","traceDir":"traces/agent-session","sourceSnapshot":"traces/agent-session/artifacts/snapshot-1.json","name":"agent smoke","appId":"com.example.mobiletest","selectorCount":1,"stepCount":4,"replay":{"enabled":true,"eventCount":2,"stepCount":1,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/agent-smoke.json","name":"agent smoke","appId":"com.example.mobiletest","stepCount":4},"nextCommands":["zmr validate --json .zmr/discovered/agent-smoke.json","zmr run .zmr/discovered/agent-smoke.json --json --trace-dir traces/agent-session"]}}
+{"jsonrpc":"2.0","id":25,"result":{"ok":true,"mode":"discover","schemaVersion":1,"runnerVersion":"0.2.2","protocolVersion":"2026-04-28","out":".zmr/discovered/agent-smoke.json","traceDir":"traces/agent-session","sourceSnapshot":"traces/agent-session/artifacts/snapshot-1.json","name":"agent smoke","appId":"com.example.mobiletest","selectorCount":1,"stepCount":4,"replay":{"enabled":true,"eventCount":2,"stepCount":1,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/agent-smoke.json","name":"agent smoke","appId":"com.example.mobiletest","stepCount":4},"nextCommands":["zmr validate --json .zmr/discovered/agent-smoke.json","zmr run .zmr/discovered/agent-smoke.json --json --trace-dir traces/agent-session"]}}
 ```
 
 Without `--trace-dir`, it returns `ok: false` with `traceDir: null`. Generated
@@ -537,7 +537,7 @@ Request:
 Response:
 
 ```json
-{"jsonrpc":"2.0","id":27,"result":{"ok":true,"mode":"explore","schemaVersion":1,"runnerVersion":"0.2.0","protocolVersion":"2026-04-28","out":".zmr/discovered/agent-goal.json","traceDir":"traces/agent-session","sourceSnapshot":"traces/agent-session/artifacts/snapshot-1.json","name":"agent goal smoke","appId":"com.example.mobiletest","selectorCount":1,"stepCount":4,"replay":{"enabled":true,"eventCount":2,"stepCount":1,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/agent-goal.json","name":"agent goal smoke","appId":"com.example.mobiletest","stepCount":4},"nextCommands":["zmr validate --json .zmr/discovered/agent-goal.json","zmr run .zmr/discovered/agent-goal.json --json --trace-dir traces/agent-session"],"goal":"find a stable login smoke","autonomous":false,"reviewRequired":true,"guardrails":["writes from existing trace evidence only","does not crawl the app","does not discover credentials or secrets","requires human review before commit"]}}
+{"jsonrpc":"2.0","id":27,"result":{"ok":true,"mode":"explore","schemaVersion":1,"runnerVersion":"0.2.2","protocolVersion":"2026-04-28","out":".zmr/discovered/agent-goal.json","traceDir":"traces/agent-session","sourceSnapshot":"traces/agent-session/artifacts/snapshot-1.json","name":"agent goal smoke","appId":"com.example.mobiletest","selectorCount":1,"stepCount":4,"replay":{"enabled":true,"eventCount":2,"stepCount":1,"skippedEventCount":1},"warnings":["draft requires human review before commit"],"validated":true,"validation":{"ok":true,"path":".zmr/discovered/agent-goal.json","name":"agent goal smoke","appId":"com.example.mobiletest","stepCount":4},"nextCommands":["zmr validate --json .zmr/discovered/agent-goal.json","zmr run .zmr/discovered/agent-goal.json --json --trace-dir traces/agent-session"],"goal":"find a stable login smoke","autonomous":false,"reviewRequired":true,"guardrails":["writes from existing trace evidence only","does not crawl the app","does not discover credentials or secrets","requires human review before commit"]}}
 ```
 
 Without `--trace-dir`, it returns `ok: false` with `traceDir: null`.

package/examples/ios-dev-client-open-link.json

@@ -2,25 +2,36 @@
   "name": "iOS Expo dev-client open-link smoke",
   "appId": "com.example.mobiletest",
   "steps": [
-    { "action": "stop" },
+    {
+      "action": "stop"
+    },
     {
       "action": "openLink",
       "url": "exp+mobiletest://expo-development-client/?url=http%3A%2F%2F127.0.0.1%3A8081"
     },
     {
-      "action": "waitAny",
-      "selectors": [
-        { "textContains": "Downloading" },
-        { "textContains": "Connected to:" },
-        { "textContains": "Reload" },
-        { "textContains": "Continue" },
-        { "textContains": "Sign in" },
-        { "textContains": "Home" },
-        { "textContains": "Unable to load" }
-      ],
+      "action": "waitNotVisible",
+      "selector": {
+        "textContains": "evelopment servers"
+      },
       "timeoutMs": 120000
     },
-    { "action": "assertHealthy" },
-    { "action": "snapshot" }
+    {
+      "action": "assertNoneVisible",
+      "selectors": [
+        {
+          "textContains": "Unable to load"
+        },
+        {
+          "textContains": "There was a problem loading"
+        }
+      ]
+    },
+    {
+      "action": "assertHealthy"
+    },
+    {
+      "action": "snapshot"
+    }
   ]
 }

package/examples/ios-dev-client-route-snapshot.json

@@ -2,23 +2,48 @@
   "name": "iOS Expo dev-client route snapshot",
   "appId": "com.example.mobiletest",
   "steps": [
-    { "action": "stop" },
+    {
+      "action": "stop"
+    },
     {
       "action": "openLink",
       "url": "exampleapp:///settings?mode=manage&source=zmr"
     },
+    {
+      "action": "waitNotVisible",
+      "selector": {
+        "textContains": "evelopment servers"
+      },
+      "timeoutMs": 60000
+    },
     {
       "action": "waitAny",
       "selectors": [
-        { "textContains": "Settings" },
-        { "textContains": "Manage" },
-        { "textContains": "Home" },
-        { "textContains": "Sign in" },
-        { "textContains": "Unable to load" }
+        {
+          "textContains": "Settings"
+        },
+        {
+          "textContains": "Manage"
+        }
       ],
       "timeoutMs": 60000
     },
-    { "action": "assertHealthy" },
-    { "action": "snapshot" }
+    {
+      "action": "assertNoneVisible",
+      "selectors": [
+        {
+          "textContains": "Unable to load"
+        },
+        {
+          "textContains": "There was a problem loading"
+        }
+      ]
+    },
+    {
+      "action": "assertHealthy"
+    },
+    {
+      "action": "snapshot"
+    }
   ]
 }

package/npm/scenarios.mjs

@@ -64,6 +64,14 @@ export function scenarioFiles(appId, { android = true, ios = true, expoDevClient
 }
 
 export function devClientScenario(name, appId, scheme, metroUrl) {
+  // The Expo dev-launcher chrome shares tokens with common app copy ("Home",
+  // "Continue", "Sign in"), and bundle-loading overlays ("Downloading") can
+  // flash faster than a snapshot poll, so neither can prove the app's JS
+  // bundle loaded. Instead wait for the launcher's persistent marker to be
+  // GONE: "evelopment servers" matches both "Development servers" and "No
+  // development servers found" (matching is case-sensitive), passes
+  // immediately when the deep link navigates without showing the launcher,
+  // and times out — failing the run — when the launcher is stuck on screen.
   return {
     name,
     appId,
@@ -74,17 +82,16 @@ export function devClientScenario(name, appId, scheme, metroUrl) {
         url: `exp+${scheme}://expo-development-client/?url=${encodeURIComponent(metroUrl)}`,
       },
       {
-        action: "waitAny",
+        action: "waitNotVisible",
+        selector: { textContains: "evelopment servers" },
+        timeoutMs: 120000,
+      },
+      {
+        action: "assertNoneVisible",
         selectors: [
-          { textContains: "Downloading" },
-          { textContains: "Connected to:" },
-          { textContains: "Reload" },
-          { textContains: "Continue" },
-          { textContains: "Sign in" },
-          { textContains: "Home" },
           { textContains: "Unable to load" },
+          { textContains: "There was a problem loading" },
         ],
-        timeoutMs: 120000,
       },
       { action: "assertHealthy" },
       { action: "snapshot" },

package/npm/wizard.mjs

@@ -23,7 +23,7 @@ if (!options.json) {
   console.log("================");
 }
 
-if (!options.yes && !options.json) {
+if (!options.yes && !options.json && input.isTTY) {
   await promptForMissingOptions(options);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zeno-mobile-runner",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Agent-native mobile app test runner for React Native, Expo, Flutter, and native Android/iOS.",
   "main": "npm/index.mjs",
   "repository": {
@@ -66,11 +66,13 @@
     "viewer/",
     "docs/",
     "!docs/assets/",
+    "!docs/demo-video-storyboard.md",
     "scripts/",
     "!scripts/build-npm-package.sh",
     "!scripts/build-release.sh",
     "!scripts/capture-screenshots.sh",
     "!scripts/capture-viewer-shots.mjs",
+    "!scripts/record-demo-video.sh",
     "!scripts/ci-gate.sh",
     "!scripts/coverage.sh",
     "!scripts/generate-homebrew-formula.mjs",

package/scripts/create-react-native-expo-demo-app.sh

@@ -229,7 +229,7 @@ export default function App() {
       <View style={styles.shell}>
         {screen === "welcome" ? (
           <View style={styles.centered}>
-            <Text style={styles.title} testID="demo_title" accessibilityLabel="demo_title">
+            <Text style={styles.title} testID="demo_title">
               Zeno Expo Demo
             </Text>
             <Text style={styles.copy}>A generated React Native and Expo workflow surface.</Text>
@@ -246,7 +246,7 @@ export default function App() {
 
         {screen === "profile" ? (
           <View style={styles.form}>
-            <Text style={styles.heading} testID="profile_title" accessibilityLabel="profile_title">
+            <Text style={styles.heading} testID="profile_title">
               Profile
             </Text>
             <TextInput
@@ -257,7 +257,7 @@ export default function App() {
               autoCorrect={false}
               style={styles.input}
               testID="profile_name_input"
-              accessibilityLabel="profile_name_input"
+             
             />
             <TextInput
               value={profileEmail}
@@ -268,7 +268,7 @@ export default function App() {
               keyboardType="email-address"
               style={styles.input}
               testID="profile_email_input"
-              accessibilityLabel="profile_email_input"
+             
             />
             <PrimaryButton
               label="Save profile"
@@ -283,20 +283,19 @@ export default function App() {
 
         {screen === "catalog" ? (
           <View style={styles.flex}>
-            <Text style={styles.heading} testID="catalog_title" accessibilityLabel="catalog_title">
+            <Text style={styles.heading} testID="catalog_title">
               Catalog
             </Text>
             <ScrollView
               style={styles.list}
               contentContainerStyle={styles.listContent}
               testID="catalog_list"
-              accessibilityLabel="catalog_list"
+             
             >
               {catalogItems.map((item) => (
                 <Pressable
                   key={item.id}
                   testID={\`catalog_item_\${item.id}\`}
-                  accessibilityLabel={\`catalog_item_\${item.id}\`}
                   accessibilityRole="button"
                   style={styles.row}
                   onPress={() => {
@@ -315,10 +314,10 @@ export default function App() {
 
         {screen === "detail" ? (
           <View style={styles.form}>
-            <Text style={styles.heading} testID="detail_title" accessibilityLabel="detail_title">
+            <Text style={styles.heading} testID="detail_title">
               {selectedItem.title}
             </Text>
-            <Text style={styles.copy} testID="detail_subtitle" accessibilityLabel="detail_subtitle">
+            <Text style={styles.copy} testID="detail_subtitle">
               {selectedItem.subtitle}
             </Text>
             <PrimaryButton
@@ -334,10 +333,10 @@ export default function App() {
 
         {screen === "review" ? (
           <View style={styles.form}>
-            <Text style={styles.heading} testID="review_title" accessibilityLabel="review_title">
+            <Text style={styles.heading} testID="review_title">
               Review
             </Text>
-            <Text style={styles.copy} testID="review_summary" accessibilityLabel="review_summary">
+            <Text style={styles.copy} testID="review_summary">
               {profileName || "Riley"} saved {selectedItem.title}
             </Text>
             <PrimaryButton
@@ -348,7 +347,7 @@ export default function App() {
           </View>
         ) : null}
 
-        <Text style={styles.status} testID="workflow_status" accessibilityLabel="workflow_status">
+        <Text style={styles.status} testID="workflow_status">
           {status}
         </Text>
       </View>
@@ -368,7 +367,6 @@ function PrimaryButton({
   return (
     <Pressable
       accessibilityRole="button"
-      accessibilityLabel={testID}
       testID={testID}
       onPress={onPress}
       style={({ pressed }) => [styles.button, pressed && styles.buttonPressed]}