agent-scenario-loop 0.1.0

package/package.json

@@ -0,0 +1,240 @@
+{
+  "name": "agent-scenario-loop",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Scenario orchestration and evidence collection for agent-driven software development. Bring your own runner. Keep your scenarios. Keep your evidence.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gmemmy/agent-scenario-loop.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gmemmy/agent-scenario-loop/issues"
+  },
+  "homepage": "https://github.com/gmemmy/agent-scenario-loop#readme",
+  "keywords": [
+    "agent",
+    "automation",
+    "evidence",
+    "mobile",
+    "profiling",
+    "react-native",
+    "scenario"
+  ],
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "packageManager": "pnpm@10.28.0",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "asl-agent-device": "dist/runner/agent-device.js",
+    "asl-android-adb": "dist/runner/android-adb.js",
+    "asl-argent": "dist/runner/argent.js",
+    "agent-scenario-loop": "dist/runner/check-plan.js",
+    "asl-compare": "dist/runner/compare.js",
+    "asl-compare-latest": "dist/runner/compare-latest.js",
+    "asl-check-plan": "dist/runner/check-plan.js",
+    "asl-demo-loop": "dist/runner/demo-loop.js",
+    "asl-example-android-live": "dist/runner/example-android-live.js",
+    "asl-example-ios-live": "dist/runner/example-ios-live.js",
+    "asl-host-doctor": "dist/runner/host-doctor.js",
+    "asl-init": "dist/runner/init-project.js",
+    "asl-ios-simctl": "dist/runner/ios-simctl.js",
+    "asl-live-android": "dist/runner/live-android.js",
+    "asl-live-ios": "dist/runner/live-ios.js",
+    "asl-live-proof": "dist/runner/live-proof.js",
+    "asl-profile-android": "dist/runner/profile-android.js",
+    "asl-profile-ios": "dist/runner/profile-ios.js",
+    "asl-validate-project": "dist/runner/validate-project.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    },
+    "./runner/android-adb": {
+      "types": "./dist/runner/android-adb.d.ts",
+      "require": "./dist/runner/android-adb.js"
+    },
+    "./runner/android-adb-driver": {
+      "types": "./dist/runner/android-adb-driver.d.ts",
+      "require": "./dist/runner/android-adb-driver.js"
+    },
+    "./runner/agent-device-driver": {
+      "types": "./dist/runner/agent-device-driver.d.ts",
+      "require": "./dist/runner/agent-device-driver.js"
+    },
+    "./runner/argent-driver": {
+      "types": "./dist/runner/argent-driver.d.ts",
+      "require": "./dist/runner/argent-driver.js"
+    },
+    "./runner/agent-device": {
+      "types": "./dist/runner/agent-device.d.ts",
+      "require": "./dist/runner/agent-device.js"
+    },
+    "./runner/argent": {
+      "types": "./dist/runner/argent.d.ts",
+      "require": "./dist/runner/argent.js"
+    },
+    "./runner/check-plan": {
+      "types": "./dist/runner/check-plan.d.ts",
+      "require": "./dist/runner/check-plan.js"
+    },
+    "./runner/compare": {
+      "types": "./dist/runner/compare.d.ts",
+      "require": "./dist/runner/compare.js"
+    },
+    "./runner/compare-latest": {
+      "types": "./dist/runner/compare-latest.d.ts",
+      "require": "./dist/runner/compare-latest.js"
+    },
+    "./runner/demo-loop": {
+      "types": "./dist/runner/demo-loop.d.ts",
+      "require": "./dist/runner/demo-loop.js"
+    },
+    "./runner/example-android-live": {
+      "types": "./dist/runner/example-android-live.d.ts",
+      "require": "./dist/runner/example-android-live.js"
+    },
+    "./runner/example-ios-live": {
+      "types": "./dist/runner/example-ios-live.d.ts",
+      "require": "./dist/runner/example-ios-live.js"
+    },
+    "./runner/host-doctor": {
+      "types": "./dist/runner/host-doctor.d.ts",
+      "require": "./dist/runner/host-doctor.js"
+    },
+    "./runner/init-project": {
+      "types": "./dist/runner/init-project.d.ts",
+      "require": "./dist/runner/init-project.js"
+    },
+    "./runner/ios-simctl": {
+      "types": "./dist/runner/ios-simctl.d.ts",
+      "require": "./dist/runner/ios-simctl.js"
+    },
+    "./runner/ios-simctl-driver": {
+      "types": "./dist/runner/ios-simctl-driver.d.ts",
+      "require": "./dist/runner/ios-simctl-driver.js"
+    },
+    "./runner/live-android": {
+      "types": "./dist/runner/live-android.d.ts",
+      "require": "./dist/runner/live-android.js"
+    },
+    "./runner/live-ios": {
+      "types": "./dist/runner/live-ios.d.ts",
+      "require": "./dist/runner/live-ios.js"
+    },
+    "./runner/live-proof": {
+      "types": "./dist/runner/live-proof.d.ts",
+      "require": "./dist/runner/live-proof.js"
+    },
+    "./runner/profile-ios": {
+      "types": "./dist/runner/profile-ios.d.ts",
+      "require": "./dist/runner/profile-ios.js"
+    },
+    "./runner/profile-android": {
+      "types": "./dist/runner/profile-android.d.ts",
+      "require": "./dist/runner/profile-android.js"
+    },
+    "./runner/validate-project": {
+      "types": "./dist/runner/validate-project.d.ts",
+      "require": "./dist/runner/validate-project.js"
+    },
+    "./schemas/*": "./schemas/*",
+    "./examples/*": "./examples/*",
+    "./templates/*": "./templates/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "app/profile-session.ts",
+    "core/config-template.json",
+    "dist",
+    "!dist/scripts",
+    "docs",
+    "examples",
+    "!examples/mobile-app/.expo",
+    "!examples/mobile-app/.expo/**",
+    "!examples/mobile-app/android",
+    "!examples/mobile-app/android/**",
+    "!examples/mobile-app/artifacts",
+    "!examples/mobile-app/artifacts/**",
+    "!examples/mobile-app/ios",
+    "!examples/mobile-app/ios/**",
+    "!examples/mobile-app/node_modules",
+    "!examples/mobile-app/node_modules/**",
+    "schemas",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepack": "npm run clean && npm run build",
+    "consumer:rehearse": "pnpm build && node dist/scripts/consumer-rehearsal.js",
+    "package:smoke": "pnpm build && node dist/scripts/package-smoke.js",
+    "prepublishOnly": "pnpm release:check",
+    "release:check": "pnpm test && pnpm release:readiness && pnpm package:smoke && pnpm consumer:rehearse",
+    "release:readiness": "pnpm build && node dist/scripts/release-readiness.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm clean && pnpm typecheck && pnpm exec tsc -p tsconfig.json && node --test dist/core/__tests__/*.test.js dist/runner/__tests__/*.test.js",
+    "android:logcat": "pnpm build && node dist/runner/android-adb.js --capture-logcat",
+    "android:preflight": "pnpm build && node dist/runner/android-adb.js",
+    "compare": "pnpm build && node dist/runner/compare.js",
+    "compare:latest": "pnpm build && node dist/runner/compare-latest.js",
+    "check-plan": "pnpm build && node dist/runner/check-plan.js",
+    "demo:loop": "pnpm build && node dist/runner/demo-loop.js",
+    "host:doctor": "pnpm build && node dist/runner/host-doctor.js --out artifacts/host-doctor",
+    "agent-device:check": "pnpm build && node dist/runner/agent-device.js --check --out artifacts/agent-device-check",
+    "argent:check": "pnpm build && node dist/runner/argent.js --check --out artifacts/argent-check",
+    "example:profile:open-close": "pnpm build && node dist/runner/profile-ios.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/open-close-cycle.json --events examples/mobile-app/event-logs/open-close-cycle.log --out artifacts/example-mobile-app/ios --run-id example-open-close",
+    "example:profile:scroll": "pnpm build && node dist/runner/profile-ios.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/scroll-settle.json --events examples/mobile-app/event-logs/scroll-settle.log --out artifacts/example-mobile-app/ios --run-id example-scroll",
+    "example:profile:startup": "pnpm build && node dist/runner/profile-ios.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/app-startup.json --events examples/mobile-app/event-logs/app-startup.log --out artifacts/example-mobile-app/ios --run-id example-startup",
+    "example:profile:ios:live:open-close": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/profile-ios.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/open-close-cycle.json --simctl-capture --profile-session --profile-session-storage --launch --out artifacts/example-mobile-app/ios --run-id ios-live-open-close",
+    "example:profile:ios:live:scroll": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/profile-ios.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/scroll-settle.json --simctl-capture --profile-session --profile-session-storage --launch --out artifacts/example-mobile-app/ios --run-id ios-live-scroll",
+    "example:profile:ios:live:startup": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/profile-ios.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/app-startup.json --simctl-capture --profile-session --profile-session-storage --launch --out artifacts/example-mobile-app/ios --run-id ios-live-startup",
+    "example:profile:android:open-close": "pnpm build && node dist/runner/profile-android.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/open-close-cycle.json --events examples/mobile-app/event-logs/android-open-close-cycle.log --out artifacts/example-mobile-app/android --run-id android-example-open-close",
+    "example:profile:android:scroll": "pnpm build && node dist/runner/profile-android.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/scroll-settle.json --events examples/mobile-app/event-logs/android-scroll-settle.log --out artifacts/example-mobile-app/android --run-id android-example-scroll",
+    "example:profile:android:startup": "pnpm build && node dist/runner/profile-android.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/app-startup.json --events examples/mobile-app/event-logs/android-app-startup.log --out artifacts/example-mobile-app/android --run-id android-example-startup",
+    "example:profile:android:live:open-close": "pnpm build && node dist/runner/profile-android.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/open-close-cycle.json --adb-capture --profile-session --react-native-debug-host localhost:8097 --clear-logcat --launch --launch-wait-ms 1500 --out artifacts/example-mobile-app/android --run-id android-live-open-close",
+    "example:profile:android:live:scroll": "pnpm build && node dist/runner/profile-android.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/scroll-settle.json --adb-capture --profile-session --react-native-debug-host localhost:8097 --clear-logcat --launch --launch-wait-ms 1500 --out artifacts/example-mobile-app/android --run-id android-live-scroll",
+    "example:profile:android:live:startup": "pnpm build && node dist/runner/profile-android.js --config examples/mobile-app/asl.config.json --scenario examples/mobile-app/scenarios/mobile/app-startup.json --adb-capture --profile-session --react-native-debug-host localhost:8097 --clear-logcat --launch --launch-wait-ms 1500 --out artifacts/example-mobile-app/android --run-id android-live-startup",
+    "example:android:preflight": "pnpm build && node dist/runner/android-adb.js --package dev.agentscenarioloop.example --out artifacts/example-mobile-app/android-live-preflight --run-id android-live-preflight",
+    "example:agent-device:check": "ASL_AGENT_DEVICE_REQUIRED_PLATFORMS=${ASL_AGENT_DEVICE_REQUIRED_PLATFORMS:-ios,android} pnpm agent-device:check",
+    "example:agent-device:ios:startup": "pnpm build && node dist/runner/agent-device.js --platform ios ${ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION:+--session $ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION} ${ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE:+--session-mode $ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE} ${ASL_EXAMPLE_IOS_UDID:+--udid $ASL_EXAMPLE_IOS_UDID} ${ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS} --scenario examples/mobile-app/scenarios/mobile/app-startup.json --app ${ASL_EXAMPLE_IOS_APP_ID:-dev.agent-scenario-loop.example} --open --wait-ms ${ASL_EXAMPLE_AGENT_DEVICE_WAIT_MS:-1000} --out artifacts/example-mobile-app/agent-device-ios-startup --run-id agent-device-ios-startup",
+    "example:agent-device:android:startup": "pnpm build && node dist/runner/agent-device.js --platform android ${ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION:+--session $ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION} ${ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE:+--session-mode $ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE} ${ASL_EXAMPLE_ANDROID_SERIAL:+--serial $ASL_EXAMPLE_ANDROID_SERIAL} ${ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS:+--command-timeout-ms $ASL_AGENT_DEVICE_COMMAND_TIMEOUT_MS} --scenario examples/mobile-app/scenarios/mobile/app-startup.json --app ${ASL_EXAMPLE_ANDROID_APP_ID:-dev.agentscenarioloop.example} --open --wait-ms ${ASL_EXAMPLE_AGENT_DEVICE_WAIT_MS:-1000} --out artifacts/example-mobile-app/agent-device-android-startup --run-id agent-device-android-startup",
+    "example:argent:ios:startup": "pnpm 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 examples/mobile-app/scenarios/mobile/app-startup.json --app ${ASL_EXAMPLE_IOS_APP_ID:-dev.agent-scenario-loop.example} --device ${ASL_EXAMPLE_IOS_UDID:-booted} --out artifacts/example-mobile-app/argent-ios-startup --run-id argent-ios-startup",
+    "example:argent:android:startup": "pnpm 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 examples/mobile-app/scenarios/mobile/app-startup.json --app ${ASL_EXAMPLE_ANDROID_APP_ID:-dev.agentscenarioloop.example} --device ${ASL_EXAMPLE_ANDROID_SERIAL:-emulator-5554} --out artifacts/example-mobile-app/argent-android-startup --run-id argent-android-startup",
+    "example:android:live": "pnpm build && node dist/runner/example-android-live.js --compare-latest --fail-on-regression",
+    "example:android:live:agent-device": "pnpm build && node dist/runner/example-android-live.js ${ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION} ${ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE} --run-suffix agent-device --agent-device-proof --compare-latest --fail-on-regression",
+    "example:android:live:argent": "pnpm build && node dist/runner/example-android-live.js --run-suffix argent --argent-proof --compare-latest --fail-on-regression",
+    "example:android:live:runners": "pnpm build && node dist/runner/example-android-live.js ${ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION} ${ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_EXAMPLE_ANDROID_AGENT_DEVICE_SESSION_MODE} --run-suffix runners --agent-device-proof --argent-proof --compare-latest --fail-on-regression",
+    "example:ios:live": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/example-ios-live.js --compare-latest --fail-on-regression",
+    "example:ios:live:agent-device": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/example-ios-live.js ${ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION} ${ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE} --run-suffix agent-device --agent-device-proof --compare-latest --fail-on-regression",
+    "example:ios:live:argent": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/example-ios-live.js --run-suffix argent --argent-proof --compare-latest --fail-on-regression",
+    "example:ios:live:runners": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm build && node dist/runner/example-ios-live.js ${ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION:+--agent-device-session $ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION} ${ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE:+--agent-device-session-mode $ASL_EXAMPLE_IOS_AGENT_DEVICE_SESSION_MODE} --run-suffix runners --agent-device-proof --argent-proof --compare-latest --fail-on-regression",
+    "example:mobile:live-proof": "pnpm build && node dist/runner/live-proof.js --file ${ASL_EXAMPLE_ANDROID_LIVE_PROOF:-artifacts/example-mobile-app/android/_live-proof/android-live-proof/live-proof.json} --file ${ASL_EXAMPLE_IOS_LIVE_PROOF:-artifacts/example-mobile-app/ios/_live-proof/ios-live-proof/live-proof.json} --require-platforms android,ios --out artifacts/example-mobile-app/live-proof-set --fail-on-regression ${ASL_REQUIRE_LIVE_PROOF_ARTIFACTS:+--require-artifacts}",
+    "example:app:android": "pnpm --dir examples/mobile-app android",
+    "example:app:ios": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; pnpm --dir examples/mobile-app ios",
+    "example:app:ios:prebuild": "pnpm --dir examples/mobile-app ios:prebuild",
+    "example:app:android:metro-port": "pnpm build && node dist/runner/android-adb.js --package ${ASL_EXAMPLE_ANDROID_APP_ID:-dev.agentscenarioloop.example} --react-native-debug-host ${ASL_EXAMPLE_ANDROID_DEBUG_HOST:-localhost:8097} --out artifacts/example-mobile-app/android-metro-port --run-id android-metro-port",
+    "example:app:ios:metro-port": "if [ -n \"${ASL_EXAMPLE_XCODE_DEVELOPER_DIR:-}\" ]; then export DEVELOPER_DIR=\"$ASL_EXAMPLE_XCODE_DEVELOPER_DIR\"; fi; xcrun simctl spawn ${ASL_EXAMPLE_IOS_DEVICE:-booted} defaults write ${ASL_EXAMPLE_IOS_APP_ID:-dev.agent-scenario-loop.example} RCT_jsLocation ${ASL_EXAMPLE_METRO_HOST:-localhost}:${ASL_EXAMPLE_METRO_PORT:-8097}",
+    "example:app:start": "pnpm --dir examples/mobile-app start",
+    "example:app:start:isolated": "pnpm --dir examples/mobile-app exec expo start --port 8097 --host localhost --clear",
+    "live-proof": "pnpm build && node dist/runner/live-proof.js",
+    "profile:android": "pnpm build && node dist/runner/profile-android.js",
+    "profile:ios": "pnpm build && node dist/runner/profile-ios.js",
+    "profile:ios:startup": "pnpm build && node dist/runner/profile-ios.js --config core/config-template.json --scenario examples/scenarios/ios/app-startup.json",
+    "profile:ios:open-close": "pnpm build && node dist/runner/profile-ios.js --config core/config-template.json --scenario examples/scenarios/ios/open-close-cycle.json",
+    "validate-project": "pnpm build && node dist/runner/validate-project.js"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "typescript": "^6.0.3"
+  }
+}

package/schemas/budget-verdict.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-scenario-loop.dev/schemas/budget-verdict.schema.json",
+  "title": "Agent Scenario Loop Budget Verdict",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "flowId",
+    "runId",
+    "status",
+    "checks"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^1\\.0\\.0$"
+    },
+    "flowId": {
+      "type": "string"
+    },
+    "runId": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["passed", "failed", "partial"]
+    },
+    "checks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "metric", "unit", "expected", "actual", "pass"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "metric": {
+            "type": "string"
+          },
+          "unit": {
+            "type": "string",
+            "enum": ["ms", "count", "bytes", "percent", "boolean"]
+          },
+          "expected": {
+            "type": ["number", "integer", "boolean"]
+          },
+          "actual": {
+            "type": ["number", "integer", "boolean", "null"]
+          },
+          "pass": {
+            "type": "boolean"
+          },
+          "sourceEvent": {
+            "type": "string"
+          },
+          "notes": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "visualOutcome": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["passed", "failed", "manual-review-needed"]
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "status"],
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string",
+                "enum": ["passed", "failed", "manual-review-needed"]
+              },
+              "artifact": {
+                "type": "string"
+              },
+              "notes": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "regression": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "baselineRunId": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["better", "worse", "unchanged", "unknown"]
+        },
+        "summary": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/schemas/causal-run.schema.json

@@ -0,0 +1,279 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-scenario-loop.dev/schemas/causal-run.schema.json",
+  "title": "Agent Scenario Loop Causal Run",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "flowId",
+    "runId",
+    "platform",
+    "buildFlavor",
+    "scenario",
+    "trigger",
+    "budgets",
+    "timeline",
+    "artifacts"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^1\\.0\\.0$"
+    },
+    "flowId": {
+      "type": "string",
+      "description": "Stable product-flow identifier such as startup, settings-open-close, or composer-open-close."
+    },
+    "runId": {
+      "type": "string",
+      "description": "Stable run identifier shared across profile artifacts, app-side signals, and UI Oracle evidence."
+    },
+    "platform": {
+      "type": "string",
+      "enum": ["ios", "android"]
+    },
+    "buildFlavor": {
+      "type": "string",
+      "enum": ["dev-debug", "dev-release", "prod-release", "unknown"]
+    },
+    "scenario": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "driver"],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "driver": {
+          "type": "string"
+        },
+        "iterations": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "route": {
+          "type": "string"
+        }
+      }
+    },
+    "trigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "label"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["cold-launch", "resume", "tap", "gesture", "deeplink", "background-foreground", "unknown"]
+        },
+        "label": {
+          "type": "string"
+        },
+        "targetId": {
+          "type": "string"
+        },
+        "targetType": {
+          "type": "string"
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "route": {
+          "type": "string"
+        },
+        "authState": {
+          "type": "string"
+        },
+        "networkState": {
+          "type": "string"
+        },
+        "featureFlags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": ["boolean", "string", "number"]
+          }
+        }
+      }
+    },
+    "budgets": {
+      "type": "object",
+      "description": "Named budget thresholds the run should be evaluated against.",
+      "minProperties": 1,
+      "additionalProperties": {
+        "$ref": "#/$defs/budgetThreshold"
+      }
+    },
+    "timeline": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/timelineEvent"
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["summary", "signals"],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "description": "Path to the human-readable summary for this run."
+        },
+        "metrics": {
+          "type": "string"
+        },
+        "manifest": {
+          "type": "string"
+        },
+        "video": {
+          "type": "string"
+        },
+        "screenshot": {
+          "type": ["string", "null"]
+        },
+        "nativeTrace": {
+          "type": "string"
+        },
+        "uiOracleRun": {
+          "type": "string"
+        },
+        "signals": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "js": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "memory": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "network": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "evidenceAttachments": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["channel", "kind", "path", "sha256", "sizeBytes", "sourceFileName"],
+            "properties": {
+              "channel": {
+                "type": "string",
+                "enum": ["capture", "provider", "signal"]
+              },
+              "kind": {
+                "type": "string",
+                "enum": ["accessibility", "js", "logs", "memory", "network", "profiler", "screenshot", "uiTree", "video"]
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "sha256": {
+                "type": "string",
+                "pattern": "^[a-f0-9]{64}$"
+              },
+              "sizeBytes": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "sourceFileName": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        }
+      }
+    },
+    "verdicts": {
+      "type": "array",
+      "items": {
+        "$ref": "budget-verdict.schema.json"
+      }
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "$defs": {
+    "budgetThreshold": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["metric", "unit", "limit"],
+      "properties": {
+        "metric": {
+          "type": "string"
+        },
+        "unit": {
+          "type": "string",
+          "enum": ["ms", "count", "bytes", "percent", "boolean"]
+        },
+        "limit": {
+          "type": ["number", "integer", "boolean"]
+        }
+      }
+    },
+    "timelineEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["phase", "name", "atMs"],
+      "properties": {
+        "phase": {
+          "type": "string",
+          "enum": [
+            "intent",
+            "navigation",
+            "domain",
+            "query",
+            "network",
+            "render",
+            "native",
+            "visual",
+            "completion"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "atMs": {
+          "type": "number"
+        },
+        "durationMs": {
+          "type": "number"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["started", "completed", "failed", "skipped", "observed"]
+        },
+        "owner": {
+          "type": "string",
+          "description": "Owning domain or subsystem such as startup, auth, viewer, navigation, or query."
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": {
+            "type": ["string", "number", "boolean", "null"]
+          }
+        }
+      }
+    }
+  }
+}