zeno-mobile-runner 0.1.2

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "zeno-mobile-runner",
+  "version": "0.1.2",
+  "description": "Agent-native mobile app test runner for React Native, Expo, Flutter, and native Android/iOS.",
+  "main": "npm/index.mjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnmikel/zeno-mobile-runner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/johnmikel/zeno-mobile-runner/issues"
+  },
+  "homepage": "https://github.com/johnmikel/zeno-mobile-runner#readme",
+  "bin": {
+    "zmr": "npm/zmr.mjs",
+    "zmr-init": "npm/init-app.mjs",
+    "zmr-wizard": "npm/wizard.mjs",
+    "zmr-benchmark": "scripts/benchmark.sh",
+    "zmr-benchmark-command": "scripts/benchmark-command.sh",
+    "zmr-compare-benchmarks": "scripts/compare-benchmarks.py",
+    "zmr-device-matrix": "scripts/device-matrix.sh",
+    "zmr-pilot-gate": "scripts/pilot-gate.sh",
+    "zmr-assert-ios-physical-ready": "scripts/assert-ios-physical-ready.sh",
+    "zmr-release-readiness": "scripts/release-readiness.sh",
+    "zmr-install-android-shim": "scripts/install-android-shim.sh",
+    "zmr-install-ios-shim": "scripts/install-ios-shim.sh",
+    "zmr-create-android-demo-app": "scripts/create-android-demo-app.sh",
+    "zmr-create-ios-demo-app": "scripts/create-ios-demo-app.sh",
+    "zmr-demo-android": "scripts/demo-android-real.sh",
+    "zmr-demo-ios": "scripts/demo-ios-real.sh"
+  },
+  "files": [
+    "npm/",
+    "clients/README.md",
+    "go.work",
+    "clients/typescript/",
+    "clients/python/README.md",
+    "clients/python/pyproject.toml",
+    "clients/python/zmr_client.py",
+    "clients/python/examples/",
+    "clients/go/",
+    "!clients/go/**/*_test.go",
+    "clients/rust/Cargo.toml",
+    "clients/rust/Cargo.lock",
+    "clients/rust/README.md",
+    "clients/rust/src/",
+    "clients/rust/examples/",
+    "clients/swift/Package.swift",
+    "clients/swift/README.md",
+    "clients/swift/Sources/",
+    "clients/kotlin/build.gradle.kts",
+    "clients/kotlin/settings.gradle.kts",
+    "clients/kotlin/README.md",
+    "clients/kotlin/src/",
+    "!clients/kotlin/src/test/",
+    "prebuilds/",
+    "src/",
+    "!src/*_tests.zig",
+    "!src/test_harness.zig",
+    "examples/",
+    "schemas/",
+    "skills/",
+    "shims/",
+    "viewer/",
+    "docs/",
+    "scripts/",
+    "!scripts/build-npm-package.sh",
+    "!scripts/build-release.sh",
+    "!scripts/ci-gate.sh",
+    "!scripts/coverage.sh",
+    "!scripts/generate-homebrew-formula.mjs",
+    "!scripts/generate-release-manifest.mjs",
+    "!scripts/generate-release-metadata.mjs",
+    "!scripts/notarize-macos-release.sh",
+    "!scripts/release-candidate.sh",
+    "!scripts/release-gate.sh",
+    "!scripts/release-smoke.sh",
+    "!scripts/sign-macos-release.sh",
+    "!scripts/verify-release-artifacts.sh",
+    "!scripts/__pycache__/",
+    "!scripts/**/*.pyc",
+    "!scripts/_cod[e]x_write_test.txt",
+    "!scripts/python_redirect_test.txt",
+    "build.zig",
+    "build.zig.zon",
+    "README.md",
+    "FEATURES.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CONTRIBUTING.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "postinstall": "node npm/postinstall.mjs",
+    "build:zmr": "node npm/build-zmr.mjs",
+    "pack:npm": "bash scripts/build-npm-package.sh",
+    "zmr:demo": "node npm/zmr.mjs validate examples/demo-fake.json",
+    "test": "node --test tests/viewer-parser.test.mjs tests/npm-scaffold-helpers.test.mjs tests/npm-cli.test.mjs tests/npm-package.test.mjs tests/typescript-client.test.mjs && python3 -W error -m unittest tests/python_client_test.py && bash tests/go-client-test.sh && bash tests/rust-client-test.sh"
+  },
+  "keywords": [
+    "mobile-testing",
+    "mobile-automation",
+    "android",
+    "ios",
+    "react-native",
+    "flutter",
+    "expo",
+    "adb",
+    "simctl",
+    "ai-agents",
+    "ai-testing",
+    "test-runner"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/schemas/README.md

@@ -0,0 +1,26 @@
+# ZMR Schemas
+
+This directory contains draft 2020-12 JSON Schemas for public ZMR file and protocol payloads.
+
+- `scenario.schema.json`: scenario files consumed by `zmr run` and `zmr validate`
+- `snapshot.schema.json`: `ObservationSnapshot` JSON emitted by live RPC and persisted trace snapshots, including viewport and optional display density metrics
+- `semantic-snapshot.schema.json`: agent-optimized semantic tree emitted by `observe.semanticSnapshot` and `zmr mcp` `semantic_snapshot`
+- `action-result.schema.json`: typed action result shape reserved for richer protocol responses
+- `trace-event.schema.json`: one JSONL event row from `events.jsonl`
+- `trace-manifest.schema.json`: `trace.json` summary for one traced run
+- `json-rpc.schema.json`: JSON-RPC requests and responses used by `zmr serve`
+- `zmr-config.schema.json`: app-local `.zmr/config.json` defaults used by the CLI and npm wizard, including Android emulator lifecycle defaults
+- `doctor-output.schema.json`: machine-readable `zmr doctor --json` setup diagnostics, including remediation hints for actionable checks
+- `init-output.schema.json`: machine-readable `zmr init --json` bootstrap output for scenario and app-local `.zmr/` initialization
+- `import-output.schema.json`: machine-readable `zmr import --json` output for one-time scenario migration helpers
+- `devices-output.schema.json`: machine-readable `zmr devices --json` output for Android, iOS simulator, and physical iOS discovery
+- `validate-output.schema.json`: machine-readable `zmr validate --json` scenario preflight output
+- `version-output.schema.json`: machine-readable `zmr version --json` output for runner and protocol compatibility discovery
+- `capabilities-output.schema.json`: machine-readable `runner.capabilities` JSON-RPC result for protocol, platform support, transport, and method discovery
+- `explain-output.schema.json`: machine-readable `zmr explain --json` failure triage output for agents and CI
+- `run-output.schema.json`: machine-readable `zmr run --json` terminal run summary output
+- `release-manifest.schema.json`: machine-readable `RELEASE_MANIFEST.json` emitted with release archives
+- `release-readiness-output.schema.json`: machine-readable `zmr-release-readiness --json` release evidence gate output
+- `schemas-output.schema.json`: machine-readable `zmr schemas --json` index of public schema names, paths, ids, and descriptions
+
+The Zig test suite verifies these files parse as JSON. Full schema validation is intentionally left to client tooling for now.

package/schemas/action-result.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/action-result.schema.json",
+  "title": "ZMR ActionResult",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["status", "elapsedMs", "action"],
+  "properties": {
+    "status": {
+      "enum": ["ok", "not_found", "timeout", "device_error", "protocol_error"]
+    },
+    "elapsedMs": { "type": "integer", "minimum": 0 },
+    "action": { "type": "string" },
+    "target": { "type": ["string", "null"] },
+    "beforeSnapshotId": { "type": ["string", "null"] },
+    "afterSnapshotId": { "type": ["string", "null"] },
+    "error": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": { "type": "string" },
+        "message": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/capabilities-output.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/capabilities-output.schema.json",
+  "title": "ZMR Capabilities Output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "name",
+    "version",
+    "protocolVersion",
+    "protocol",
+    "platforms",
+    "platformSupport",
+    "iosPreview",
+    "transports",
+    "methods"
+  ],
+  "properties": {
+    "name": { "const": "zmr" },
+    "version": { "type": "string", "minLength": 1 },
+    "protocolVersion": { "type": "string", "minLength": 1 },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "version",
+        "minimumCompatibleVersion",
+        "stability",
+        "breakingChangePolicy"
+      ],
+      "properties": {
+        "version": { "type": "string", "minLength": 1 },
+        "minimumCompatibleVersion": { "type": "string", "minLength": 1 },
+        "stability": { "type": "string", "minLength": 1 },
+        "breakingChangePolicy": { "type": "string", "minLength": 1 }
+      }
+    },
+    "platforms": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "enum": ["android", "ios"] },
+      "uniqueItems": true
+    },
+    "platformSupport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["android", "ios"],
+      "properties": {
+        "android": { "$ref": "#/$defs/platformSupport" },
+        "ios": {
+          "allOf": [{ "$ref": "#/$defs/platformSupport" }],
+          "required": ["status", "deviceTypes", "automation", "physicalDevices"],
+          "properties": {
+            "physicalDevices": { "const": true }
+          }
+        }
+      }
+    },
+    "iosPreview": { "const": false },
+    "transports": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "enum": ["stdio", "tcp"] },
+      "uniqueItems": true
+    },
+    "methods": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    }
+  },
+  "$defs": {
+    "platformSupport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "deviceTypes", "automation"],
+      "properties": {
+        "status": { "enum": ["supported", "preview", "unsupported"] },
+        "deviceTypes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "enum": ["emulator", "physical", "simulator"]
+          },
+          "uniqueItems": true
+        },
+        "automation": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        },
+        "physicalDevices": { "type": "boolean" }
+      }
+    }
+  }
+}

package/schemas/devices-output.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/devices-output.schema.json",
+  "title": "ZMR Devices Output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["platform", "count", "devices"],
+  "properties": {
+    "platform": { "enum": ["android", "ios"] },
+    "count": { "type": "integer", "minimum": 0 },
+    "devices": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["serial", "state", "ready"],
+        "properties": {
+          "serial": { "type": "string", "minLength": 1 },
+          "state": { "type": "string", "minLength": 1 },
+          "ready": { "type": "boolean" }
+        }
+      }
+    }
+  }
+}

package/schemas/doctor-output.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/doctor-output.schema.json",
+  "title": "ZMR Doctor Output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["ok", "checks"],
+  "properties": {
+    "ok": { "type": "boolean" },
+    "checks": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/check" }
+    }
+  },
+  "$defs": {
+    "check": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "status", "detail"],
+      "properties": {
+        "name": {
+          "enum": [
+            "zig",
+            "config",
+            "adb",
+            "android-devices",
+            "android-shim",
+            "android-smoke-scenario",
+            "xcrun",
+            "ios-simulators",
+            "ios-physical-devices",
+            "ios-shim",
+            "ios-smoke-scenario"
+          ]
+        },
+        "status": { "enum": ["ok", "warning", "missing"] },
+        "errorCode": { "type": "string", "minLength": 1 },
+        "detail": { "type": "string" },
+        "count": { "type": "integer", "minimum": 0 },
+        "readyCount": { "type": "integer", "minimum": 0 },
+        "scriptCount": { "type": "integer", "minimum": 0 },
+        "scriptNames": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "fieldPath": { "type": "string", "minLength": 1 },
+        "hint": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/schemas/explain-output.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/explain-output.schema.json",
+  "title": "ZMR Explain Output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["ok", "scenario", "status"],
+  "properties": {
+    "ok": { "const": true },
+    "traceDir": { "type": "string", "minLength": 1 },
+    "scenario": { "type": "string" },
+    "status": { "type": "string", "minLength": 1 },
+    "appId": { "type": "string", "minLength": 1 },
+    "durationMs": { "type": "integer", "minimum": 0 },
+    "eventCount": { "type": "integer", "minimum": 0 },
+    "snapshotCount": { "type": "integer", "minimum": 0 },
+    "failedStepIndex": { "type": "integer", "minimum": 0 },
+    "error": { "type": "string", "minLength": 1 },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "snapshotId": { "type": "string", "minLength": 1 },
+        "artifactStatus": { "type": "string", "minLength": 1 },
+        "semanticStatus": { "type": "string", "minLength": 1 },
+        "error": { "type": "string", "minLength": 1 },
+        "screenshotArtifact": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 },
+        "activePackage": { "type": "string", "minLength": 1 },
+        "activeActivity": { "type": "string", "minLength": 1 },
+        "visibleTexts": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "nearestTextMatches": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "lastEvent": { "type": "string", "minLength": 1 },
+    "nextCommands": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/import-output.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/import-output.schema.json",
+  "title": "ZMR Import Output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["ok", "format", "source", "out", "name", "appId", "stepCount", "next", "nextCommands"],
+  "properties": {
+    "ok": { "const": true },
+    "format": { "enum": ["flow-yaml"] },
+    "source": { "type": "string", "minLength": 1 },
+    "out": { "type": "string", "minLength": 1 },
+    "name": { "type": "string", "minLength": 1 },
+    "appId": { "type": ["string", "null"] },
+    "stepCount": { "type": "integer", "minimum": 0 },
+    "next": { "type": "string", "minLength": 1 },
+    "nextCommands": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/init-output.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/init-output.schema.json",
+  "title": "ZMR Init Output",
+  "oneOf": [
+    { "$ref": "#/$defs/appInit" },
+    { "$ref": "#/$defs/scenarioInit" }
+  ],
+  "$defs": {
+    "appInit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "mode", "dir", "appId", "created", "configPath", "deviceMatrixPath", "agentInstructionsPath", "next", "nextCommands", "smokeCommands"],
+      "properties": {
+        "ok": { "const": true },
+        "mode": { "const": "app" },
+        "dir": { "type": "string", "minLength": 1 },
+        "appId": { "type": "string", "minLength": 1 },
+        "created": {
+          "type": "array",
+          "minItems": 4,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "configPath": { "type": "string", "minLength": 1 },
+        "androidScenarioPath": { "type": "string", "minLength": 1 },
+        "iosScenarioPath": { "type": "string", "minLength": 1 },
+        "androidDevClientScenarioPath": { "type": "string", "minLength": 1 },
+        "iosDevClientScenarioPath": { "type": "string", "minLength": 1 },
+        "deviceMatrixPath": { "type": "string", "minLength": 1 },
+        "agentInstructionsPath": { "type": "string", "minLength": 1 },
+        "next": { "type": "string", "minLength": 1 },
+        "nextCommands": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "smokeCommands": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "scriptCount": { "type": "integer", "minimum": 0 },
+        "scriptNames": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "scenarioInit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "mode", "appId", "created", "next", "nextCommands"],
+      "properties": {
+        "ok": { "const": true },
+        "mode": { "const": "scenario" },
+        "appId": { "type": "string", "minLength": 1 },
+        "created": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "next": { "type": "string", "minLength": 1 },
+        "nextCommands": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/json-rpc.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/json-rpc.schema.json",
+  "title": "ZMR JSON-RPC Message",
+  "oneOf": [
+    { "$ref": "#/$defs/request" },
+    { "$ref": "#/$defs/successResponse" },
+    { "$ref": "#/$defs/errorResponse" }
+  ],
+  "$defs": {
+    "id": {
+      "type": ["string", "integer", "null"]
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["jsonrpc", "id", "method"],
+      "properties": {
+        "jsonrpc": { "const": "2.0" },
+        "id": { "$ref": "#/$defs/id" },
+        "method": { "type": "string" },
+        "params": {}
+      }
+    },
+    "successResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["jsonrpc", "id", "result"],
+      "properties": {
+        "jsonrpc": { "const": "2.0" },
+        "id": { "$ref": "#/$defs/id" },
+        "result": {}
+      }
+    },
+    "errorResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["jsonrpc", "id", "error"],
+      "properties": {
+        "jsonrpc": { "const": "2.0" },
+        "id": { "$ref": "#/$defs/id" },
+        "error": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["code", "message"],
+          "properties": {
+            "code": { "type": "integer" },
+            "message": { "type": "string" },
+            "publicCode": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/release-manifest.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zmr.dev/schemas/release-manifest.schema.json",
+  "title": "ZMR Release Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "name", "version", "generatedAt", "releaseBaseUrl", "artifacts", "totals"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "name": { "type": "string", "minLength": 1 },
+    "version": { "type": "string", "minLength": 1 },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "releaseBaseUrl": { "type": ["string", "null"] },
+    "artifacts": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "type", "sizeBytes", "sha256"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "type": { "enum": ["archive", "npm-package", "sbom", "notices", "homebrew-formula", "notarization-receipt", "metadata"] },
+          "sizeBytes": { "type": "integer", "minimum": 0 },
+          "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+          "target": { "type": "string", "minLength": 1 },
+          "platform": { "type": "string", "minLength": 1 },
+          "arch": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "totals": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["artifacts", "archives", "sizeBytes"],
+      "properties": {
+        "artifacts": { "type": "integer", "minimum": 1 },
+        "archives": { "type": "integer", "minimum": 1 },
+        "sizeBytes": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}