agent-scenario-loop 0.1.0

package/examples/mobile-app/README.md

@@ -0,0 +1,302 @@
+# Example Mobile App
+
+This is the neutral Expo dogfood app for Agent Scenario Loop. It exists to prove the package contract with app-owned truth events before public release work.
+
+The app surface is intentionally small:
+
+- startup emits launch-to-ready milestones
+- card open-close emits repeated interaction milestones
+- scroll-settle emits list movement and settled-state milestones
+
+Release checks use the committed Android and iOS profile-event logs in `event-logs/` so package validation stays deterministic. Android adb capture and iOS simctl capture can also launch the package, collect runtime evidence, and feed the same scenario artifacts through the profile runners.
+
+The app is intentionally private and minimal. It uses a direct Expo entrypoint, a safe-area provider, and one screen so iOS and Android drivers can launch the same app surface without creating product-specific fixtures.
+
+The iOS app uses `plugins/with-ios-build-compat.js` during Expo prebuild. That plugin generates the scene lifecycle shape required by newer iOS simulator runtimes and keeps generated Pods on the app deployment target. The app also declares `@expo/metro-runtime` directly because strict pnpm installs do not let Expo resolve transitive Metro runtime imports across package boundaries.
+
+## Consumer Scaffold
+
+The example app also carries the same project-local files a consuming app gets from `asl-init`:
+
+- `src/devtools/profile-session.ts`: local app helper entrypoint used by the screen
+- `runner-manifests/primary-runner.json`: portable iOS and Android runner capability manifest
+- `runner-manifests/evidence-provider.json`: optional accessibility, profiler, memory, and network provider manifest
+- `scenarios/mobile/app-startup.json`: portable startup scenario used for project validation
+- `scenarios/mobile/open-close-cycle.json`: portable repeated interaction scenario profiled on both iOS and Android
+- `scenarios/mobile/scroll-settle.json`: portable feed scroll scenario profiled on both iOS and Android
+- `asl/package-scripts.json`: public CLI snippets that a consuming app can merge into `package.json`
+
+Validate the example app exactly like a consumer project:
+
+```bash
+pnpm asl:validate
+```
+
+The app-local `asl:*` scripts build the package from the repo root, then call the compiled public CLIs from the example app directory.
+
+Start the example app on Android with:
+
+```bash
+pnpm install
+pnpm android
+```
+
+From the package root, the same launch command is available as:
+
+```bash
+pnpm example:app:android
+```
+
+Keep Metro running after this command opens the app.
+
+Prepare the generated iOS project with:
+
+```bash
+pnpm ios:prebuild
+```
+
+From the package root, the same prebuild command is available as:
+
+```bash
+pnpm example:app:ios:prebuild
+```
+
+The generated `ios/` directory stays ignored. Commit the Expo config, package metadata, scenarios, patches, and config plugins that reproduce it, not the generated native output.
+
+Run the generated iOS app from the package root with:
+
+```bash
+pnpm example:app:ios
+```
+
+Set `ASL_EXAMPLE_XCODE_DEVELOPER_DIR` before this command when the local default Xcode is not the Xcode you want the example app to use.
+
+For an isolated Metro server that does not collide with another React Native app on `8081`, start Metro from the package root with:
+
+```bash
+pnpm example:app:start:isolated
+```
+
+The isolated command binds Metro to `localhost:8097` and clears Metro cache state for the example app. If the iOS simulator falls back to another Metro server, write the React Native packager override before launching the app:
+
+```bash
+pnpm example:app:ios:metro-port
+```
+
+The command targets the booted simulator and the example app bundle id by default. Override them with environment variables when needed:
+
+```bash
+ASL_EXAMPLE_IOS_DEVICE=<simulator-udid> ASL_EXAMPLE_METRO_PORT=8097 pnpm example:app:ios:metro-port
+```
+
+For Expo dev-client builds, set `ASL_EXAMPLE_ANDROID_DEV_CLIENT_URL` or `ASL_EXAMPLE_IOS_DEV_CLIENT_URL` to the example app's dev-client URL for the same Metro port. Android live runners open that URL before profile-session deep links; iOS live runners open it after launching the native shell and before collecting stored profile-session evidence.
+
+If a selected Xcode beta cannot run the current Expo/RN toolchain cleanly, point `ASL_EXAMPLE_XCODE_DEVELOPER_DIR` at a stable Xcode developer directory before running the iOS Metro-port, live proof, or raw local iOS build commands.
+
+## Files
+
+- `index.ts`: direct Expo entrypoint and safe-area provider
+- `src/example-screen.tsx`: scenario surface wired to the local profile-session helper
+- `package.json`, `app.json`, `tsconfig.json`: private Expo app configuration
+- `metro.config.js`: allows the app to import the package helper from the repo/package root
+- `asl.config.json`: runner config for example app artifact output
+- `asl/package-scripts.json`: consumer-facing package-script snippets, including portable agent-device and Argent interaction proof commands
+- `runner-manifests/*.json`: project-local runner and provider capability manifests
+- `scripts/asl-capture-accessibility-provider.mjs`: deterministic accessibility provider command used by provider-profile scripts
+- `scripts/asl-capture-profiler-provider.mjs`: deterministic profiler, memory, and network provider command used by provider-profile scripts
+- `scenarios/mobile/app-startup.json`: portable consumer-validation scenario
+- `scenarios/mobile/open-close-cycle.json`: portable open-close scenario backed by committed iOS and Android fixture logs
+- `scenarios/mobile/scroll-settle.json`: portable scroll-settle scenario backed by committed iOS and Android fixture logs
+- `scenarios/android/*.json`: Android profile scenario manifests
+- `scenarios/ios/*.json`: iOS profile scenario manifests
+- `event-logs/*.log`: deterministic profile-event evidence fixtures
+
+## Fixture Proof
+
+Run one example scenario through the package runner:
+
+```bash
+pnpm example:profile:startup
+```
+
+From inside `examples/mobile-app`, the consumer-shaped scripts are:
+
+```bash
+pnpm asl:validate
+pnpm asl:check:ios
+pnpm asl:check:android
+pnpm asl:profile:ios
+pnpm asl:profile:android
+pnpm asl:profile:ios:provider
+pnpm asl:profile:android:provider
+pnpm asl:agent-device:check
+pnpm asl:agent-device:ios
+pnpm asl:agent-device:android
+pnpm asl:argent:check
+pnpm asl:argent:ios
+pnpm asl:argent:android
+ASL_ARGENT_BIN=/path/to/argent pnpm asl:argent:android
+```
+
+The `*:provider` scripts execute `runner-manifests/evidence-provider.json`, which runs the deterministic provider scripts and inventories generated accessibility, profiler, memory, and network evidence in `manifest.artifacts.evidenceAttachments`.
+
+For repeated local runs, put machine-specific runner values in an ignored `.asl.local.env` file at the example app or repo root instead of repeating inline environment variables. ASL CLIs load the nearest `.asl.local.env` without overriding already-exported values:
+
+```bash
+ASL_HOST_DOCTOR_REQUIRE=android,ios,agent-device,argent
+ASL_AGENT_DEVICE_REQUIRED_PLATFORMS=ios,android
+ASL_ANDROID_AGENT_DEVICE_SESSION=android-example
+ASL_IOS_AGENT_DEVICE_SESSION=default
+ASL_EXAMPLE_IOS_DEV_CLIENT_URL=asl-example://expo-development-client/?url=http%3A%2F%2Flocalhost%3A8097
+ASL_ARGENT_BIN=pnpm
+ASL_ARGENT_BASE_ARGS="dlx @swmansion/argent run"
+ASL_ARGENT_IOS_SIMCTL_SCREENSHOT_FALLBACK=1
+```
+
+The `asl:agent-device:*` and `asl:argent:*` scripts are portable interaction proof lanes. They require the corresponding external tool and a running device or simulator, but they write the same ASL health, verdict, raw, capture, and summary artifacts. `asl:agent-device:check` verifies the configured agent-device command surface, device discovery, and active sessions before a scenario starts, writing availability artifacts under `artifacts/asl/agent-device-check`; set `ASL_AGENT_DEVICE_REQUIRED_PLATFORMS=ios,android` when both OS targets must be booted. Active sessions are preserved in `raw/agent-device-availability.json` and summarized in `agent-summary.md`, so a sidecar run can reuse the right Android or iOS session instead of borrowing a default session bound to the wrong target. `asl:argent:check` verifies the configured Argent command and ASL-required tool surface before any device scenario starts, writing availability artifacts under `artifacts/asl/argent-check`. For Argent, prefer a real `argent` executable on PATH, or set `ASL_ARGENT_BIN=/path/to/argent` when the package manager installed it somewhere else. `ASL_ARGENT_BIN=npx` with `ASL_ARGENT_BASE_ARGS="--yes @swmansion/argent run"` is supported as a wrapper shape, but run `pnpm asl:argent:check` before relying on it. Argent uses `--udid` for both iOS simulators and Android emulators, and ASL resolves the iOS `booted` shorthand to the concrete simulator UDID before invoking Argent.
+
+Live proof and inspection scripts are also available from the app directory:
+
+```bash
+pnpm asl:android:live
+pnpm asl:live-proof:android
+pnpm asl:ios:live
+pnpm asl:live-proof:ios
+pnpm asl:live-proof:both
+```
+
+The live scripts pass `--compare-latest --fail-on-regression`, so they write comparison context by default and exit nonzero only when a comparable trusted baseline regresses. The live-proof inspection scripts also pass `--fail-on-regression` for already-written aggregate proof files. `asl:live-proof:both` requires both Android and iOS proof artifacts, writes `artifacts/asl/live-proof-set/live-proof-set.json` plus `agent-summary.md`, and fails if either platform is missing, either proof status failed, or either proof regressed. Set `ASL_REQUIRE_LIVE_PROOF_ARTIFACTS=1` for a final local gate that also requires referenced summaries, comparison outputs, and captures to exist on disk. This keeps the dogfood example aligned with the package scaffold and makes regression evidence a real gate by default.
+
+For suffixed live runs, point the inspection script at the generated proof file:
+
+```bash
+ASL_EXAMPLE_ANDROID_LIVE_PROOF=artifacts/asl/android-live/_live-proof/android-live-proof-dogfood/live-proof.json pnpm asl:live-proof:android
+ASL_EXAMPLE_ANDROID_LIVE_PROOF=artifacts/asl/android-live/_live-proof/android-live-proof-dogfood/live-proof.json \
+ASL_EXAMPLE_IOS_LIVE_PROOF=artifacts/asl/ios-live/_live-proof/ios-live-proof-dogfood/live-proof.json \
+  pnpm asl:live-proof:both
+```
+
+The runner writes `health.json`, `verdict.json`, `agent-summary.md`, `metrics.json`, `causal-run.json`, and raw evidence under the printed run directory.
+
+Additional fixture-backed profiles:
+
+```bash
+pnpm example:profile:open-close
+pnpm example:profile:scroll
+pnpm example:profile:android:startup
+pnpm example:profile:android:open-close
+pnpm example:profile:android:scroll
+```
+
+## Android Capture
+
+With an emulator or device online and the example app installed, the Android runner can own the capture window before writing profile artifacts. The full proof command starts with adb/package preflight, runs every canonical Android example scenario, and prints the `agent-summary.md` path for each run:
+
+```bash
+pnpm example:android:live
+```
+
+The aggregate command writes `_live-proof/android-live-proof/live-proof.json` and `_live-proof/android-live-proof/agent-summary.md` under the Android artifact root as the batch entrypoint.
+
+When `agent-device` or Argent is available, attach the same startup interaction assertion as a sidecar proof:
+
+```bash
+ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION=<name> pnpm example:android:live:agent-device
+pnpm example:android:live:argent
+ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION=<name> pnpm example:android:live:runners
+```
+
+The sidecar scripts use stable run suffixes so they do not overwrite the direct Android proof. They write `_live-proof/android-live-proof-agent-device`, `_live-proof/android-live-proof-argent`, or `_live-proof/android-live-proof-runners`; point `ASL_EXAMPLE_ANDROID_LIVE_PROOF` at one of those files when you want `pnpm asl:live-proof:android` or `pnpm asl:live-proof:both` to inspect a sidecar proof instead of the direct proof.
+
+Named agent-device sessions default to `reuse`, where the session owns target selection. If your direct Android serial is correct but the default agent-device session is bound elsewhere, set `ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE=bind` with `ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION=<name>` so the sidecar session still receives the configured serial.
+
+For Argent without a global binary, set `ASL_ARGENT_BIN=/path/to/argent` to the installed executable. The `npx --yes @swmansion/argent run` wrapper shape is supported through `ASL_ARGENT_BIN=npx` and `ASL_ARGENT_BASE_ARGS="--yes @swmansion/argent run"`, but verify it with `pnpm asl:argent:check` before relying on it.
+
+The adb profile scenarios run before sidecar proofs. This keeps app-owned profile events, logs, screenshots, metrics, and verdicts independent from any UI automation session opened by agent-device or Argent.
+
+The live Android commands assume the isolated Metro server is on port `8097`. They configure adb reverse and the app's React Native debug host as `localhost:8097` before launch, so the example app does not accidentally load another app's Metro bundle from the default `8081` port. To apply only that Android Metro routing setup, run:
+
+```bash
+pnpm example:app:android:metro-port
+```
+
+Override the target package or debug host when needed:
+
+```bash
+ASL_EXAMPLE_ANDROID_APP_ID=<package-name> ASL_EXAMPLE_ANDROID_DEBUG_HOST=<host:port> pnpm example:app:android:metro-port
+```
+
+The root example live scripts pass `--compare-latest --fail-on-regression` by default. Missing same-lane baselines are recorded as skipped comparison evidence; real regressions exit nonzero after artifacts are written. Pass a run suffix when you want preserved live artifact directories for before/after comparison:
+
+```bash
+pnpm example:android:live -- --run-suffix before-change
+pnpm example:android:live -- --run-suffix after-change
+```
+
+The individual live commands remain useful while debugging one scenario:
+
+```bash
+pnpm example:profile:android:live:startup
+pnpm example:profile:android:live:open-close
+pnpm example:profile:android:live:scroll
+```
+
+The command targets live in the scenario `adapterOptions.androidAdb.commands` block, while the app handles them through `registerProfileCommandTargetHandler`. If adb, the package, or the device is unavailable, the adb capture folder gets a failed `health.json` and the profile run stops before making timing claims.
+
+The example Android live proof uses a short `--launch-wait-ms` delay before sending profile-session deep links so React Native has time to attach its deep-link listener after cold launch. Expo dev-client builds can also pass `--android-dev-client-url` or set `ASL_EXAMPLE_ANDROID_DEV_CLIENT_URL` so the runner opens the Metro session before profile-session links. Add `--android-dev-client-ready-pattern 'Running "main"'` or `ASL_EXAMPLE_ANDROID_DEV_CLIENT_READY_PATTERN='Running "main"'` when the dev client needs bounded logcat proof that the JS bundle is ready. Keep those waits separate from `--command-wait-ms`, which waits after app-handled profile commands, and `--wait-ms`, which controls the final logcat capture window.
+
+Use `--android-profile-session-storage` only when the app has mounted the ASL AsyncStorage profile-session bridge and Android URL events are not reliable enough for startup control. Storage-backed Android sessions use the selected device clock for `startedAt`, so app-emitted milestone offsets remain meaningful even when the host and emulator clocks differ.
+
+If direct `adb devices` works but the Node-based runner reports no online device and raw `adb-devices.txt` mentions the adb daemon or `Operation not permitted`, rerun with adb daemon permissions before treating the failure as an app, package, or emulator issue.
+
+`scenarios/android/app-startup-video.json` is an opt-in variant that adds an optional `record` capture step. Use it when you want adb to preserve `captures.video` for a startup run without making video part of the default live proof.
+
+## iOS Capture
+
+With the example app installed on a booted iOS simulator and Metro connected, the iOS runner can own a simctl capture window before writing profile artifacts. The live commands use storage-backed profile-session and command seeding, so they do not depend on iOS unified logs carrying JavaScript console output:
+
+```bash
+pnpm example:ios:live
+```
+
+The aggregate command runs simctl preflight, startup, open-close, and scroll-settle. It also writes `_live-proof/ios-live-proof/live-proof.json` and `_live-proof/ios-live-proof/agent-summary.md` under the iOS artifact root as the batch entrypoint.
+
+When `agent-device` or Argent is available, attach the same startup interaction assertion as a sidecar proof:
+
+```bash
+ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION=<name> pnpm example:ios:live:agent-device
+pnpm example:ios:live:argent
+ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION=<name> pnpm example:ios:live:runners
+```
+
+The sidecar scripts use stable run suffixes so they do not overwrite the direct iOS proof. They write `_live-proof/ios-live-proof-agent-device`, `_live-proof/ios-live-proof-argent`, or `_live-proof/ios-live-proof-runners`; point `ASL_EXAMPLE_IOS_LIVE_PROOF` at one of those files when you want `pnpm asl:live-proof:ios` or `pnpm asl:live-proof:both` to inspect a sidecar proof instead of the direct proof.
+
+Named agent-device sessions default to `reuse`, where the session owns target selection. If your direct simulator UDID is correct but the default agent-device session is bound elsewhere, set `ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE=bind` with `ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION=<name>` so the sidecar session still receives the configured UDID.
+
+For Argent without a global binary, set `ASL_ARGENT_BIN=/path/to/argent` to the installed executable. The `npx --yes @swmansion/argent run` wrapper shape is supported through `ASL_ARGENT_BIN=npx` and `ASL_ARGENT_BASE_ARGS="--yes @swmansion/argent run"`, but verify it with `pnpm asl:argent:check` before relying on it.
+
+The simctl profile scenarios run before sidecar proofs. This keeps stored app truth events, screenshots, metrics, and verdicts independent from any UI automation session opened by agent-device or Argent. When Argent can launch and inspect the iOS app but its screenshot backend is unavailable, the iOS live proof keeps the Argent warning and attaches a simctl screenshot fallback under the same interaction proof captures.
+
+```bash
+pnpm example:profile:ios:live:startup
+pnpm example:profile:ios:live:open-close
+pnpm example:profile:ios:live:scroll
+```
+
+The root example live scripts pass `--compare-latest --fail-on-regression` by default. Pass a run suffix when you want preserved iOS live artifact directories:
+
+```bash
+pnpm example:ios:live -- --run-suffix after-change
+```
+
+If global `xcode-select` points at a beta Xcode whose simulator services are not ready, set `ASL_EXAMPLE_XCODE_DEVELOPER_DIR` before the Node runner starts:
+
+```bash
+ASL_EXAMPLE_XCODE_DEVELOPER_DIR=<xcode-app>/Contents/Developer pnpm example:ios:live -- --device <booted-simulator-udid>
+```
+
+If direct `xcrun simctl list devices` works but the Node-based runner reports `ios_simctl_unavailable`, the runner may be inside an agent sandbox without CoreSimulator access. Rerun with simulator/CoreSimulator permissions before treating the failure as an app or Xcode setup regression.
+
+Each command writes simctl capture evidence under `artifacts/example-mobile-app/ios/_ios-simctl-captures/<run-id>`, collects stored app truth events into `raw/ios-profile-events.log`, then writes scenario artifacts under the matching scenario run directory.
+
+The command targets live in the scenario `adapterOptions.iosSimctl.commands` block, while the app handles them through `registerProfileCommandTargetHandler`. If simctl, the installed app, or the simulator is unavailable, the simctl capture folder gets a failed `health.json` and the profile run stops before making timing claims.

package/examples/mobile-app/app.json

@@ -0,0 +1,22 @@
+{
+  "expo": {
+    "name": "ASL Example Mobile",
+    "slug": "asl-example-mobile",
+    "version": "0.1.0",
+    "orientation": "portrait",
+    "scheme": "asl-example",
+    "platforms": [
+      "ios",
+      "android"
+    ],
+    "ios": {
+      "bundleIdentifier": "dev.agent-scenario-loop.example"
+    },
+    "android": {
+      "package": "dev.agentscenarioloop.example"
+    },
+    "plugins": [
+      "./plugins/with-ios-build-compat"
+    ]
+  }
+}

package/examples/mobile-app/asl/package-scripts.json

@@ -0,0 +1,32 @@
+{
+  "asl:check:ios": "asl-check-plan --scenario scenarios/mobile/app-startup.json --runner runner-manifests/primary-runner.json --provider runner-manifests/evidence-provider.json --platform ios --out artifacts/asl/plan/app-startup-ios",
+  "asl:check:android": "asl-check-plan --scenario scenarios/mobile/app-startup.json --runner runner-manifests/primary-runner.json --provider runner-manifests/evidence-provider.json --platform android --out artifacts/asl/plan/app-startup-android",
+  "asl:validate": "asl-validate-project --root . --platform all --out artifacts/asl/project-validation",
+  "asl:host:doctor": "asl-host-doctor --out artifacts/asl/host-doctor",
+  "asl:profile:ios": "asl-profile-ios --config asl.config.json --scenario scenarios/ios/app-startup.json --events event-logs/app-startup.log --comparison-lane app-startup-ios-fixture --out artifacts/asl/ios --run-id app-startup-ios-fixture",
+  "asl:profile:android": "asl-profile-android --config asl.config.json --scenario scenarios/android/app-startup.json --events event-logs/android-app-startup.log --comparison-lane app-startup-android-fixture --out artifacts/asl/android --run-id app-startup-android-fixture",
+  "asl:profile:ios:provider": "asl-profile-ios --config asl.config.json --scenario scenarios/ios/app-startup.json --events event-logs/app-startup.log --provider runner-manifests/evidence-provider.json --comparison-lane app-startup-ios-provider --out artifacts/asl/ios --run-id app-startup-ios-provider",
+  "asl:profile:android:provider": "asl-profile-android --config asl.config.json --scenario scenarios/android/app-startup.json --events event-logs/android-app-startup.log --provider runner-manifests/evidence-provider.json --comparison-lane app-startup-android-provider --out artifacts/asl/android --run-id app-startup-android-provider",
+  "asl:agent-device:check": "asl-agent-device --check --out artifacts/asl/agent-device-check",
+  "asl:agent-device:ios": "asl-agent-device --platform ios ${ASL_IOS_AGENT_DEVICE_SESSION:+--session $ASL_IOS_AGENT_DEVICE_SESSION} ${ASL_IOS_AGENT_DEVICE_SESSION_MODE:+--session-mode $ASL_IOS_AGENT_DEVICE_SESSION_MODE} ${ASL_IOS_UDID:+--udid $ASL_IOS_UDID} ${ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS} --scenario scenarios/mobile/app-startup.json --app ${ASL_IOS_APP_ID:-dev.agent-scenario-loop.example} --open --wait-ms 1000 --out artifacts/asl/agent-device-ios --run-id app-startup-ios-agent-device",
+  "asl:agent-device:android": "asl-agent-device --platform android ${ASL_ANDROID_AGENT_DEVICE_SESSION:+--session $ASL_ANDROID_AGENT_DEVICE_SESSION} ${ASL_ANDROID_AGENT_DEVICE_SESSION_MODE:+--session-mode $ASL_ANDROID_AGENT_DEVICE_SESSION_MODE} ${ASL_ANDROID_SERIAL:+--serial $ASL_ANDROID_SERIAL} ${ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS} --scenario scenarios/mobile/app-startup.json --app ${ASL_ANDROID_APP_ID:-dev.agentscenarioloop.example} --open --wait-ms 1000 --out artifacts/asl/agent-device-android --run-id app-startup-android-agent-device",
+  "asl:argent:check": "asl-argent --check --out artifacts/asl/argent-check",
+  "asl:argent:ios": "asl-argent --platform ios ${ASL_ARGENT_BIN:+--argent $ASL_ARGENT_BIN} ${ASL_ARGENT_BASE_ARGS:+--base-args \"$ASL_ARGENT_BASE_ARGS\"} ${ASL_ARGENT_DEVICE_FLAG:+--device-flag $ASL_ARGENT_DEVICE_FLAG} ${ASL_ARGENT_APP_FLAG:+--app-flag $ASL_ARGENT_APP_FLAG} ${ASL_ARGENT_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_ARGENT_COMMAND_TIMEOUT_MS} ${ASL_ARGENT_IOS_SIMCTL_SCREENSHOT_FALLBACK:+--ios-simctl-screenshot-fallback} ${ASL_XCRUN_PATH:+--xcrun $ASL_XCRUN_PATH} --scenario scenarios/mobile/app-startup.json --app ${ASL_IOS_APP_ID:-dev.agent-scenario-loop.example} --device ${ASL_IOS_UDID:-booted} --out artifacts/asl/argent-ios --run-id app-startup-ios-argent",
+  "asl:argent:android": "asl-argent --platform android ${ASL_ARGENT_BIN:+--argent $ASL_ARGENT_BIN} ${ASL_ARGENT_BASE_ARGS:+--base-args \"$ASL_ARGENT_BASE_ARGS\"} ${ASL_ARGENT_DEVICE_FLAG:+--device-flag $ASL_ARGENT_DEVICE_FLAG} ${ASL_ARGENT_APP_FLAG:+--app-flag $ASL_ARGENT_APP_FLAG} ${ASL_ARGENT_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_ARGENT_COMMAND_TIMEOUT_MS} --scenario scenarios/mobile/app-startup.json --app ${ASL_ANDROID_APP_ID:-dev.agentscenarioloop.example} --device ${ASL_ANDROID_SERIAL:-emulator-5554} --out artifacts/asl/argent-android --run-id app-startup-android-argent",
+  "asl:android:live": "asl-live-android --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/android-live ${ASL_ANDROID_SERIAL:+--serial $ASL_ANDROID_SERIAL} ${ASL_ANDROID_APP_ID:+--package $ASL_ANDROID_APP_ID} ${ASL_ANDROID_REACT_NATIVE_DEBUG_HOST:+--react-native-debug-host $ASL_ANDROID_REACT_NATIVE_DEBUG_HOST} --compare-latest --fail-on-regression",
+  "asl:android:live:agent-device": "asl-live-android --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/android-live ${ASL_ANDROID_SERIAL:+--serial $ASL_ANDROID_SERIAL} ${ASL_ANDROID_APP_ID:+--package $ASL_ANDROID_APP_ID} ${ASL_ANDROID_REACT_NATIVE_DEBUG_HOST:+--react-native-debug-host $ASL_ANDROID_REACT_NATIVE_DEBUG_HOST} ${ASL_ANDROID_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_ANDROID_AGENT_DEVICE_SESSION} ${ASL_ANDROID_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_ANDROID_AGENT_DEVICE_SESSION_MODE} --run-suffix agent-device --agent-device-proof --compare-latest --fail-on-regression",
+  "asl:android:live:argent": "asl-live-android --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/android-live ${ASL_ANDROID_SERIAL:+--serial $ASL_ANDROID_SERIAL} ${ASL_ANDROID_APP_ID:+--package $ASL_ANDROID_APP_ID} ${ASL_ANDROID_REACT_NATIVE_DEBUG_HOST:+--react-native-debug-host $ASL_ANDROID_REACT_NATIVE_DEBUG_HOST} --run-suffix argent --argent-proof --compare-latest --fail-on-regression",
+  "asl:android:live:runners": "asl-live-android --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/android-live ${ASL_ANDROID_SERIAL:+--serial $ASL_ANDROID_SERIAL} ${ASL_ANDROID_APP_ID:+--package $ASL_ANDROID_APP_ID} ${ASL_ANDROID_REACT_NATIVE_DEBUG_HOST:+--react-native-debug-host $ASL_ANDROID_REACT_NATIVE_DEBUG_HOST} ${ASL_ANDROID_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_ANDROID_AGENT_DEVICE_SESSION} ${ASL_ANDROID_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_ANDROID_AGENT_DEVICE_SESSION_MODE} --run-suffix runners --agent-device-proof --argent-proof --compare-latest --fail-on-regression",
+  "asl:ios:live": "asl-live-ios --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/ios-live ${ASL_IOS_UDID:+--device $ASL_IOS_UDID} ${ASL_IOS_APP_ID:+--bundle $ASL_IOS_APP_ID} --compare-latest --fail-on-regression",
+  "asl:ios:live:agent-device": "asl-live-ios --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/ios-live ${ASL_IOS_UDID:+--device $ASL_IOS_UDID} ${ASL_IOS_APP_ID:+--bundle $ASL_IOS_APP_ID} ${ASL_IOS_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_IOS_AGENT_DEVICE_SESSION} ${ASL_IOS_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_IOS_AGENT_DEVICE_SESSION_MODE} --run-suffix agent-device --agent-device-proof --compare-latest --fail-on-regression",
+  "asl:ios:live:argent": "asl-live-ios --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/ios-live ${ASL_IOS_UDID:+--device $ASL_IOS_UDID} ${ASL_IOS_APP_ID:+--bundle $ASL_IOS_APP_ID} --run-suffix argent --argent-proof --compare-latest --fail-on-regression",
+  "asl:ios:live:runners": "asl-live-ios --config asl.config.json --scenario scenarios/mobile/app-startup.json --out artifacts/asl/ios-live ${ASL_IOS_UDID:+--device $ASL_IOS_UDID} ${ASL_IOS_APP_ID:+--bundle $ASL_IOS_APP_ID} ${ASL_IOS_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_IOS_AGENT_DEVICE_SESSION} ${ASL_IOS_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_IOS_AGENT_DEVICE_SESSION_MODE} --run-suffix runners --agent-device-proof --argent-proof --compare-latest --fail-on-regression",
+  "asl:profile:ios:live": "asl-profile-ios --config asl.config.json --scenario scenarios/mobile/app-startup.json --simctl-capture --profile-session --profile-session-storage --launch --comparison-lane app-startup-ios-live --out artifacts/asl/ios --run-id app-startup-ios-live",
+  "asl:profile:android:live": "asl-profile-android --config asl.config.json --scenario scenarios/mobile/app-startup.json --adb-capture --profile-session --clear-logcat --launch --comparison-lane app-startup-android-live --out artifacts/asl/android --run-id app-startup-android-live",
+  "asl:compare:ios": "asl-compare-latest --root artifacts/asl/ios --scenario app-startup --current ${ASL_COMPARE_IOS_CURRENT:?set_ASL_COMPARE_IOS_CURRENT} --out artifacts/asl/ios/comparisons/app-startup --fail-on-regression",
+  "asl:compare:android": "asl-compare-latest --root artifacts/asl/android --scenario app-startup --current ${ASL_COMPARE_ANDROID_CURRENT:?set_ASL_COMPARE_ANDROID_CURRENT} --out artifacts/asl/android/comparisons/app-startup --fail-on-regression",
+  "asl:live-proof:android": "asl-live-proof --file ${ASL_ANDROID_LIVE_PROOF:-artifacts/asl/android-live/_live-proof/android-live-proof/live-proof.json} --fail-on-regression",
+  "asl:live-proof:ios": "asl-live-proof --file ${ASL_IOS_LIVE_PROOF:-artifacts/asl/ios-live/_live-proof/ios-live-proof/live-proof.json} --fail-on-regression",
+  "asl:live-proof:both": "asl-live-proof --file ${ASL_ANDROID_LIVE_PROOF:-artifacts/asl/android-live/_live-proof/android-live-proof/live-proof.json} --file ${ASL_IOS_LIVE_PROOF:-artifacts/asl/ios-live/_live-proof/ios-live-proof/live-proof.json} --require-platforms android,ios --out artifacts/asl/live-proof-set --fail-on-regression ${ASL_REQUIRE_LIVE_PROOF_ARTIFACTS:+--require-artifacts}",
+  "asl:live-proof": "asl-live-proof --file ${ASL_LIVE_PROOF:?set_ASL_LIVE_PROOF} --fail-on-regression"
+}

package/examples/mobile-app/asl.config.json

@@ -0,0 +1,37 @@
+{
+  "projectName": "asl-example-mobile-app",
+  "app": {
+    "displayName": "ASL Example",
+    "scheme": "asl-example",
+    "profileSessionScheme": "asl-example",
+    "iosBundleId": "dev.agent-scenario-loop.example",
+    "iosConflictingBundleIds": [],
+    "androidPackage": "dev.agentscenarioloop.example",
+    "ios": {
+      "xcodeScheme": "ASL Example",
+      "launchConfiguration": "Debug",
+      "profileConfiguration": "Release"
+    }
+  },
+  "paths": {
+    "artifactRoot": "artifacts/example-mobile-app",
+    "androidArtifactsRoot": "artifacts/example-mobile-app/android",
+    "iosArtifactsRoot": "artifacts/example-mobile-app/ios",
+    "scenarioRoot": "scenarios/mobile"
+  },
+  "drivers": {
+    "default": "fixture-log-ingest",
+    "supported": ["fixture-log-ingest", "adb", "ios-simctl", "agent-device", "argent", "xcodebuildmcp"]
+  },
+  "versionControl": {
+    "commit": [
+      "examples/mobile-app/**",
+      "examples/scenarios/**",
+      "schemas/**"
+    ],
+    "ignore": [
+      "artifacts/example-mobile-app/**",
+      "local simulator recordings, screenshots, and profiler exports"
+    ]
+  }
+}

package/examples/mobile-app/event-logs/android-app-startup.log

@@ -0,0 +1,4 @@
+2026-01-01T00:10:00.000Z example-android [profile-event] {"event":"app_launch_requested","scenario":"app-startup","runId":"android-example-startup","iteration":1,"atMs":0}
+2026-01-01T00:10:01.020Z example-android [profile-event] {"event":"home_ready","scenario":"app-startup","runId":"android-example-startup","iteration":1,"atMs":1020}
+2026-01-01T00:10:01.230Z example-android [profile-event] {"event":"startup_idle_observed","scenario":"app-startup","runId":"android-example-startup","iteration":1,"atMs":1230}
+2026-01-01T00:10:01.330Z example-android [profile-event] {"event":"startup_complete","scenario":"app-startup","runId":"android-example-startup","iteration":1,"atMs":1330}

package/examples/mobile-app/event-logs/android-open-close-cycle.log

@@ -0,0 +1,12 @@
+2026-01-01T00:11:00.000Z example-android [profile-event] {"event":"card_open_requested","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":1,"atMs":0}
+2026-01-01T00:11:00.420Z example-android [profile-event] {"event":"card_opened","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":1,"atMs":420}
+2026-01-01T00:11:00.780Z example-android [profile-event] {"event":"card_close_requested","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":1,"atMs":780}
+2026-01-01T00:11:01.120Z example-android [profile-event] {"event":"card_dismissed","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":1,"atMs":1120}
+2026-01-01T00:11:02.000Z example-android [profile-event] {"event":"card_open_requested","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":2,"atMs":2000}
+2026-01-01T00:11:02.450Z example-android [profile-event] {"event":"card_opened","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":2,"atMs":2450}
+2026-01-01T00:11:02.810Z example-android [profile-event] {"event":"card_close_requested","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":2,"atMs":2810}
+2026-01-01T00:11:03.170Z example-android [profile-event] {"event":"card_dismissed","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":2,"atMs":3170}
+2026-01-01T00:11:04.000Z example-android [profile-event] {"event":"card_open_requested","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":3,"atMs":4000}
+2026-01-01T00:11:04.480Z example-android [profile-event] {"event":"card_opened","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":3,"atMs":4480}
+2026-01-01T00:11:04.850Z example-android [profile-event] {"event":"card_close_requested","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":3,"atMs":4850}
+2026-01-01T00:11:05.230Z example-android [profile-event] {"event":"card_dismissed","scenario":"open-close-cycle","runId":"android-example-open-close","iteration":3,"atMs":5230}

package/examples/mobile-app/event-logs/android-scroll-settle.log

@@ -0,0 +1,12 @@
+2026-01-01T00:12:00.000Z example-android [profile-event] {"event":"feed_scroll_started","scenario":"scroll-settle","runId":"android-example-scroll","iteration":1,"atMs":0}
+2026-01-01T00:12:00.340Z example-android [profile-event] {"event":"feed_first_content_visible","scenario":"scroll-settle","runId":"android-example-scroll","iteration":1,"atMs":340}
+2026-01-01T00:12:00.690Z example-android [profile-event] {"event":"feed_scroll_settle_requested","scenario":"scroll-settle","runId":"android-example-scroll","iteration":1,"atMs":690}
+2026-01-01T00:12:00.920Z example-android [profile-event] {"event":"feed_scroll_settled","scenario":"scroll-settle","runId":"android-example-scroll","iteration":1,"atMs":920}
+2026-01-01T00:12:02.000Z example-android [profile-event] {"event":"feed_scroll_started","scenario":"scroll-settle","runId":"android-example-scroll","iteration":2,"atMs":2000}
+2026-01-01T00:12:02.360Z example-android [profile-event] {"event":"feed_first_content_visible","scenario":"scroll-settle","runId":"android-example-scroll","iteration":2,"atMs":2360}
+2026-01-01T00:12:02.720Z example-android [profile-event] {"event":"feed_scroll_settle_requested","scenario":"scroll-settle","runId":"android-example-scroll","iteration":2,"atMs":2720}
+2026-01-01T00:12:02.970Z example-android [profile-event] {"event":"feed_scroll_settled","scenario":"scroll-settle","runId":"android-example-scroll","iteration":2,"atMs":2970}
+2026-01-01T00:12:04.000Z example-android [profile-event] {"event":"feed_scroll_started","scenario":"scroll-settle","runId":"android-example-scroll","iteration":3,"atMs":4000}
+2026-01-01T00:12:04.390Z example-android [profile-event] {"event":"feed_first_content_visible","scenario":"scroll-settle","runId":"android-example-scroll","iteration":3,"atMs":4390}
+2026-01-01T00:12:04.760Z example-android [profile-event] {"event":"feed_scroll_settle_requested","scenario":"scroll-settle","runId":"android-example-scroll","iteration":3,"atMs":4760}
+2026-01-01T00:12:05.010Z example-android [profile-event] {"event":"feed_scroll_settled","scenario":"scroll-settle","runId":"android-example-scroll","iteration":3,"atMs":5010}

package/examples/mobile-app/event-logs/app-startup.log

@@ -0,0 +1,4 @@
+2026-01-01T00:00:00.000Z example [profile-event] {"event":"app_launch_requested","scenario":"app-startup","runId":"example-startup","iteration":1,"atMs":0}
+2026-01-01T00:00:00.940Z example [profile-event] {"event":"home_ready","scenario":"app-startup","runId":"example-startup","iteration":1,"atMs":940}
+2026-01-01T00:00:01.130Z example [profile-event] {"event":"startup_idle_observed","scenario":"app-startup","runId":"example-startup","iteration":1,"atMs":1130}
+2026-01-01T00:00:01.220Z example [profile-event] {"event":"startup_complete","scenario":"app-startup","runId":"example-startup","iteration":1,"atMs":1220}

package/examples/mobile-app/event-logs/open-close-cycle.log

@@ -0,0 +1,12 @@
+2026-01-01T00:01:00.000Z example [profile-event] {"event":"card_open_requested","scenario":"open-close-cycle","runId":"example-open-close","iteration":1,"atMs":0}
+2026-01-01T00:01:00.380Z example [profile-event] {"event":"card_opened","scenario":"open-close-cycle","runId":"example-open-close","iteration":1,"atMs":380}
+2026-01-01T00:01:00.720Z example [profile-event] {"event":"card_close_requested","scenario":"open-close-cycle","runId":"example-open-close","iteration":1,"atMs":720}
+2026-01-01T00:01:01.040Z example [profile-event] {"event":"card_dismissed","scenario":"open-close-cycle","runId":"example-open-close","iteration":1,"atMs":1040}
+2026-01-01T00:01:02.000Z example [profile-event] {"event":"card_open_requested","scenario":"open-close-cycle","runId":"example-open-close","iteration":2,"atMs":2000}
+2026-01-01T00:01:02.410Z example [profile-event] {"event":"card_opened","scenario":"open-close-cycle","runId":"example-open-close","iteration":2,"atMs":2410}
+2026-01-01T00:01:02.760Z example [profile-event] {"event":"card_close_requested","scenario":"open-close-cycle","runId":"example-open-close","iteration":2,"atMs":2760}
+2026-01-01T00:01:03.120Z example [profile-event] {"event":"card_dismissed","scenario":"open-close-cycle","runId":"example-open-close","iteration":2,"atMs":3120}
+2026-01-01T00:01:04.000Z example [profile-event] {"event":"card_open_requested","scenario":"open-close-cycle","runId":"example-open-close","iteration":3,"atMs":4000}
+2026-01-01T00:01:04.440Z example [profile-event] {"event":"card_opened","scenario":"open-close-cycle","runId":"example-open-close","iteration":3,"atMs":4440}
+2026-01-01T00:01:04.800Z example [profile-event] {"event":"card_close_requested","scenario":"open-close-cycle","runId":"example-open-close","iteration":3,"atMs":4800}
+2026-01-01T00:01:05.180Z example [profile-event] {"event":"card_dismissed","scenario":"open-close-cycle","runId":"example-open-close","iteration":3,"atMs":5180}

package/examples/mobile-app/event-logs/scroll-settle.log

@@ -0,0 +1,12 @@
+2026-01-01T00:02:00.000Z example [profile-event] {"event":"feed_scroll_started","scenario":"scroll-settle","runId":"example-scroll","iteration":1,"atMs":0}
+2026-01-01T00:02:00.300Z example [profile-event] {"event":"feed_first_content_visible","scenario":"scroll-settle","runId":"example-scroll","iteration":1,"atMs":300}
+2026-01-01T00:02:00.620Z example [profile-event] {"event":"feed_scroll_settle_requested","scenario":"scroll-settle","runId":"example-scroll","iteration":1,"atMs":620}
+2026-01-01T00:02:00.830Z example [profile-event] {"event":"feed_scroll_settled","scenario":"scroll-settle","runId":"example-scroll","iteration":1,"atMs":830}
+2026-01-01T00:02:02.000Z example [profile-event] {"event":"feed_scroll_started","scenario":"scroll-settle","runId":"example-scroll","iteration":2,"atMs":2000}
+2026-01-01T00:02:02.320Z example [profile-event] {"event":"feed_first_content_visible","scenario":"scroll-settle","runId":"example-scroll","iteration":2,"atMs":2320}
+2026-01-01T00:02:02.660Z example [profile-event] {"event":"feed_scroll_settle_requested","scenario":"scroll-settle","runId":"example-scroll","iteration":2,"atMs":2660}
+2026-01-01T00:02:02.890Z example [profile-event] {"event":"feed_scroll_settled","scenario":"scroll-settle","runId":"example-scroll","iteration":2,"atMs":2890}
+2026-01-01T00:02:04.000Z example [profile-event] {"event":"feed_scroll_started","scenario":"scroll-settle","runId":"example-scroll","iteration":3,"atMs":4000}
+2026-01-01T00:02:04.350Z example [profile-event] {"event":"feed_first_content_visible","scenario":"scroll-settle","runId":"example-scroll","iteration":3,"atMs":4350}
+2026-01-01T00:02:04.690Z example [profile-event] {"event":"feed_scroll_settle_requested","scenario":"scroll-settle","runId":"example-scroll","iteration":3,"atMs":4690}
+2026-01-01T00:02:04.930Z example [profile-event] {"event":"feed_scroll_settled","scenario":"scroll-settle","runId":"example-scroll","iteration":3,"atMs":4930}

package/examples/mobile-app/index.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { registerRootComponent } from 'expo';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+
+import { ExampleScreen } from './src/example-screen';
+
+/**
+ * Wraps the example scenario surface in native safe-area context.
+ *
+ * @returns {React.ReactElement}
+ */
+function ExampleApp(): React.ReactElement {
+  return React.createElement(
+    SafeAreaProvider,
+    null,
+    React.createElement(ExampleScreen),
+  );
+}
+
+registerRootComponent(ExampleApp);

package/examples/mobile-app/metro.config.js

@@ -0,0 +1,20 @@
+const path = require('node:path');
+const { getDefaultConfig } = require('expo/metro-config');
+
+const projectRoot = __dirname;
+const packageRoot = path.resolve(projectRoot, '..', '..');
+const config = getDefaultConfig(projectRoot);
+
+config.watchFolders = Array.from(new Set([...(config.watchFolders ?? []), packageRoot]));
+config.resolver.nodeModulesPaths = [
+  path.resolve(projectRoot, 'node_modules'),
+  path.resolve(packageRoot, 'node_modules'),
+];
+config.resolver.extraNodeModules = {
+  ...(config.resolver.extraNodeModules ?? {}),
+  react: path.resolve(projectRoot, 'node_modules/react'),
+  'react/jsx-dev-runtime': path.resolve(projectRoot, 'node_modules/react/jsx-dev-runtime.js'),
+  'react/jsx-runtime': path.resolve(projectRoot, 'node_modules/react/jsx-runtime.js'),
+};
+
+module.exports = config;

package/examples/mobile-app/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "agent-scenario-loop-example-mobile-app",
+  "version": "0.0.0",
+  "private": true,
+  "main": "index.ts",
+  "scripts": {
+    "asl:check:android": "pnpm --dir ../.. build && node ../../dist/runner/check-plan.js --scenario scenarios/mobile/app-startup.json --runner runner-manifests/primary-runner.json --provider runner-manifests/evidence-provider.json --platform android --out artifacts/asl/plan/app-startup-android",
+    "asl:check:ios": "pnpm --dir ../.. build && node ../../dist/runner/check-plan.js --scenario scenarios/mobile/app-startup.json --runner runner-manifests/primary-runner.json --provider runner-manifests/evidence-provider.json --platform ios --out artifacts/asl/plan/app-startup-ios",
+    "asl:host:doctor": "pnpm --dir ../.. build && node ../../dist/runner/host-doctor.js --out artifacts/asl/host-doctor",
+    "asl:android:live": "pnpm --dir ../.. build && node ../../dist/runner/example-android-live.js --config asl.config.json --out artifacts/asl/android-live --compare-latest --fail-on-regression",
+    "asl:android:live:agent-device": "pnpm --dir ../.. build && node ../../dist/runner/example-android-live.js --config asl.config.json --out artifacts/asl/android-live ${ASL_ANDROID_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_ANDROID_AGENT_DEVICE_SESSION} ${ASL_ANDROID_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_ANDROID_AGENT_DEVICE_SESSION_MODE} --run-suffix agent-device --agent-device-proof --compare-latest --fail-on-regression",
+    "asl:android:live:argent": "pnpm --dir ../.. build && node ../../dist/runner/example-android-live.js --config asl.config.json --out artifacts/asl/android-live --run-suffix argent --argent-proof --compare-latest --fail-on-regression",
+    "asl:android:live:runners": "pnpm --dir ../.. build && node ../../dist/runner/example-android-live.js --config asl.config.json --out artifacts/asl/android-live ${ASL_ANDROID_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_ANDROID_AGENT_DEVICE_SESSION} ${ASL_ANDROID_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_ANDROID_AGENT_DEVICE_SESSION_MODE} --run-suffix runners --agent-device-proof --argent-proof --compare-latest --fail-on-regression",
+    "asl:ios:live": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm --dir ../.. build && node ../../dist/runner/example-ios-live.js --config asl.config.json --out artifacts/asl/ios-live --compare-latest --fail-on-regression",
+    "asl:ios:live:agent-device": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm --dir ../.. build && node ../../dist/runner/example-ios-live.js --config asl.config.json --out artifacts/asl/ios-live ${ASL_IOS_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_IOS_AGENT_DEVICE_SESSION} ${ASL_IOS_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_IOS_AGENT_DEVICE_SESSION_MODE} --run-suffix agent-device --agent-device-proof --compare-latest --fail-on-regression",
+    "asl:ios:live:argent": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm --dir ../.. build && node ../../dist/runner/example-ios-live.js --config asl.config.json --out artifacts/asl/ios-live --run-suffix argent --argent-proof --compare-latest --fail-on-regression",
+    "asl:ios:live:runners": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm --dir ../.. build && node ../../dist/runner/example-ios-live.js --config asl.config.json --out artifacts/asl/ios-live ${ASL_IOS_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_IOS_AGENT_DEVICE_SESSION} ${ASL_IOS_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_IOS_AGENT_DEVICE_SESSION_MODE} --run-suffix runners --agent-device-proof --argent-proof --compare-latest --fail-on-regression",
+    "asl:live-proof:android": "pnpm --dir ../.. build && node ../../dist/runner/live-proof.js --file ${ASL_EXAMPLE_ANDROID_LIVE_PROOF:-artifacts/asl/android-live/_live-proof/android-live-proof/live-proof.json} --fail-on-regression",
+    "asl:live-proof:ios": "pnpm --dir ../.. build && node ../../dist/runner/live-proof.js --file ${ASL_EXAMPLE_IOS_LIVE_PROOF:-artifacts/asl/ios-live/_live-proof/ios-live-proof/live-proof.json} --fail-on-regression",
+    "asl:live-proof:both": "pnpm --dir ../.. build && node ../../dist/runner/live-proof.js --file ${ASL_EXAMPLE_ANDROID_LIVE_PROOF:-artifacts/asl/android-live/_live-proof/android-live-proof/live-proof.json} --file ${ASL_EXAMPLE_IOS_LIVE_PROOF:-artifacts/asl/ios-live/_live-proof/ios-live-proof/live-proof.json} --require-platforms android,ios --out artifacts/asl/live-proof-set --fail-on-regression ${ASL_REQUIRE_LIVE_PROOF_ARTIFACTS:+--require-artifacts}",
+    "asl:agent-device:check": "pnpm --dir ../.. build && node ../../dist/runner/agent-device.js --check --out artifacts/asl/agent-device-check",
+    "asl:agent-device:android": "pnpm --dir ../.. build && node ../../dist/runner/agent-device.js --platform android ${ASL_ANDROID_AGENT_DEVICE_SESSION:+--session $ASL_ANDROID_AGENT_DEVICE_SESSION} ${ASL_ANDROID_AGENT_DEVICE_SESSION_MODE:+--session-mode $ASL_ANDROID_AGENT_DEVICE_SESSION_MODE} ${ASL_ANDROID_SERIAL:+--serial $ASL_ANDROID_SERIAL} ${ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS} --scenario scenarios/mobile/app-startup.json --app ${ASL_ANDROID_APP_ID:-dev.agentscenarioloop.example} --open --wait-ms 1000 --out artifacts/asl/agent-device-android --run-id app-startup-android-agent-device",
+    "asl:agent-device:ios": "pnpm --dir ../.. build && node ../../dist/runner/agent-device.js --platform ios ${ASL_IOS_AGENT_DEVICE_SESSION:+--session $ASL_IOS_AGENT_DEVICE_SESSION} ${ASL_IOS_AGENT_DEVICE_SESSION_MODE:+--session-mode $ASL_IOS_AGENT_DEVICE_SESSION_MODE} ${ASL_IOS_UDID:+--udid $ASL_IOS_UDID} ${ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS} --scenario scenarios/mobile/app-startup.json --app ${ASL_IOS_APP_ID:-dev.agent-scenario-loop.example} --open --wait-ms 1000 --out artifacts/asl/agent-device-ios --run-id app-startup-ios-agent-device",
+    "asl:argent:check": "pnpm --dir ../.. build && node ../../dist/runner/argent.js --check --out artifacts/asl/argent-check",
+    "asl:argent:android": "pnpm --dir ../.. build && node ../../dist/runner/argent.js --platform android ${ASL_ARGENT_BIN:+--argent $ASL_ARGENT_BIN} ${ASL_ARGENT_BASE_ARGS:+--base-args \"$ASL_ARGENT_BASE_ARGS\"} ${ASL_ARGENT_DEVICE_FLAG:+--device-flag $ASL_ARGENT_DEVICE_FLAG} ${ASL_ARGENT_APP_FLAG:+--app-flag $ASL_ARGENT_APP_FLAG} ${ASL_ARGENT_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_ARGENT_COMMAND_TIMEOUT_MS} --scenario scenarios/mobile/app-startup.json --app ${ASL_ANDROID_APP_ID:-dev.agentscenarioloop.example} --device ${ASL_ANDROID_SERIAL:-emulator-5554} --out artifacts/asl/argent-android --run-id app-startup-android-argent",
+    "asl:argent:ios": "pnpm --dir ../.. build && node ../../dist/runner/argent.js --platform ios ${ASL_ARGENT_BIN:+--argent $ASL_ARGENT_BIN} ${ASL_ARGENT_BASE_ARGS:+--base-args \"$ASL_ARGENT_BASE_ARGS\"} ${ASL_ARGENT_DEVICE_FLAG:+--device-flag $ASL_ARGENT_DEVICE_FLAG} ${ASL_ARGENT_APP_FLAG:+--app-flag $ASL_ARGENT_APP_FLAG} ${ASL_ARGENT_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_ARGENT_COMMAND_TIMEOUT_MS} ${ASL_ARGENT_IOS_SIMCTL_SCREENSHOT_FALLBACK:+--ios-simctl-screenshot-fallback} ${ASL_XCRUN_PATH:+--xcrun $ASL_XCRUN_PATH} --scenario scenarios/mobile/app-startup.json --app ${ASL_IOS_APP_ID:-dev.agent-scenario-loop.example} --device ${ASL_IOS_UDID:-booted} --out artifacts/asl/argent-ios --run-id app-startup-ios-argent",
+    "asl:compare:android": "pnpm --dir ../.. build && node ../../dist/runner/compare-latest.js --root artifacts/asl/android --scenario app-startup --current ${ASL_COMPARE_ANDROID_CURRENT:?set_ASL_COMPARE_ANDROID_CURRENT} --out artifacts/asl/android/comparisons/app-startup --fail-on-regression",
+    "asl:compare:ios": "pnpm --dir ../.. build && node ../../dist/runner/compare-latest.js --root artifacts/asl/ios --scenario app-startup --current ${ASL_COMPARE_IOS_CURRENT:?set_ASL_COMPARE_IOS_CURRENT} --out artifacts/asl/ios/comparisons/app-startup --fail-on-regression",
+    "asl:live-proof": "pnpm --dir ../.. build && node ../../dist/runner/live-proof.js --file ${ASL_LIVE_PROOF:?set_ASL_LIVE_PROOF} --fail-on-regression",
+    "asl:profile:android": "pnpm --dir ../.. build && node ../../dist/runner/profile-android.js --config asl.config.json --scenario scenarios/android/app-startup.json --events event-logs/android-app-startup.log --comparison-lane app-startup-android-fixture --out artifacts/asl/android --run-id app-startup-android-fixture",
+    "asl:profile:android:live": "pnpm --dir ../.. build && node ../../dist/runner/profile-android.js --config asl.config.json --scenario scenarios/mobile/app-startup.json --adb-capture --profile-session --clear-logcat --launch --comparison-lane app-startup-android-live --out artifacts/asl/android --run-id app-startup-android-live",
+    "asl:profile:android:provider": "pnpm --dir ../.. build && node ../../dist/runner/profile-android.js --config asl.config.json --scenario scenarios/android/app-startup.json --events event-logs/android-app-startup.log --provider runner-manifests/evidence-provider.json --comparison-lane app-startup-android-provider --out artifacts/asl/android --run-id app-startup-android-provider",
+    "asl:profile:ios": "pnpm --dir ../.. build && node ../../dist/runner/profile-ios.js --config asl.config.json --scenario scenarios/ios/app-startup.json --events event-logs/app-startup.log --comparison-lane app-startup-ios-fixture --out artifacts/asl/ios --run-id app-startup-ios-fixture",
+    "asl:profile:ios:live": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm --dir ../.. build && node ../../dist/runner/profile-ios.js --config asl.config.json --scenario scenarios/mobile/app-startup.json --simctl-capture --profile-session --profile-session-storage --launch --comparison-lane app-startup-ios-live --out artifacts/asl/ios --run-id app-startup-ios-live",
+    "asl:profile:ios:provider": "pnpm --dir ../.. build && node ../../dist/runner/profile-ios.js --config asl.config.json --scenario scenarios/ios/app-startup.json --events event-logs/app-startup.log --provider runner-manifests/evidence-provider.json --comparison-lane app-startup-ios-provider --out artifacts/asl/ios --run-id app-startup-ios-provider",
+    "asl:validate": "pnpm --dir ../.. build && node ../../dist/runner/validate-project.js --root . --platform all --out artifacts/asl/project-validation",
+    "android": "expo run:android",
+    "ios": "expo run:ios",
+    "ios:prebuild": "expo prebuild --platform ios",
+    "start": "expo start",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit"
+  },
+  "dependencies": {
+    "@expo/metro-runtime": "56.0.15",
+    "@react-native-async-storage/async-storage": "2.2.0",
+    "expo": "^56.0.11",
+    "expo-linking": "~56.0.14",
+    "react": "19.2.3",
+    "react-native": "0.85.3",
+    "react-native-gesture-handler": "~2.31.2",
+    "react-native-safe-area-context": "~5.7.0"
+  },
+  "devDependencies": {
+    "@types/react": "~19.2.14",
+    "typescript": "~6.0.3"
+  },
+  "pnpm": {
+    "patchedDependencies": {
+      "expo-modules-jsi@56.0.10": "patches/expo-modules-jsi@56.0.10.patch"
+    }
+  }
+}