Maestro Test
maestro_testRun Maestro flows on a booted simulator to verify your app end to end, generating a JSON report required for TestFlight shipping and feature gates.
Instructions
Run the app's Maestro flows (.maestro/) on the booted simulator with the live Viewer, and write .appfactory/verify/maestro.json.
Use when: verifying the app end to end; testflight_ship and the features gate require every smoke flow green. The app must already be installed (build_for_sim + simctl install). Opens the Viewer at http://localhost:7777; there is no headless mode. Returns: {ok, flows: [{name, passed}], report path}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"app_dir": "<app_dir>"
},
"name": "maestro_test"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Comma-separated Maestro tag filter, e.g. 'smoke'; omit to run every flow. | |
| device | No | Simulator UDID to run on; omit for the booted simulator. | |
| app_dir | Yes | Absolute path to the app project directory (contains app.spec.json), e.g. /Users/me/Apps/MyApp. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||