Run BrowserStack Maestro from E2E matrix rows

[kieran-osgood-shopify]

Stack Context

This is Phase 5 of the BrowserStack Maestro E2E stack for Checkout Kit, stacked on the RN iOS artifact workflow.

Parent issue: https://github.com/shop/issues-checkout-kit/issues/1099
Epic: https://github.com/shop/issues-checkout-kit/issues/1084

What?

Adds real BrowserStack Maestro execution from expanded E2E matrix rows:

• packages the Maestro suite zip with a single parent folder
• resolves BrowserStack devices dynamically from selectors like ios:phone:latest
• supports exact device overrides for repro/debug
• uploads app artifacts and Maestro suite zip to BrowserStack
• starts platform-specific BrowserStack Maestro builds
• polls build status and fetches session details
• writes raw and normalized JSON result artifacts
• wires the Bitrise run workflow to call the BrowserStack runner
• documents BrowserStack secrets and non-sensitive Maestro env values

Why?

This is the first PR that connects the pipeline to BrowserStack App Automate. It keeps execution matrix-driven so future app targets, OS tracks, and suites can fan out without changing the pipeline topology.

Validation

shadowenv exec -- ruby e2e/test/maestro_suite_package_test.rb
shadowenv exec -- ruby e2e/test/browserstack_device_resolver_test.rb
shadowenv exec -- ruby e2e/test/bitrise_pipeline_test.rb
shadowenv exec -- ruby e2e/test/e2e_matrix_test.rb
shadowenv exec -- ruby e2e/scripts/e2e_matrix validate
shadowenv exec -- bitrise validate -c e2e/bitrise.yml
shadowenv exec -- ruby -e 'require "yaml"; YAML.safe_load_file("e2e/bitrise.yml"); puts "e2e bitrise yaml parsed"'
shadowenv exec -- ruby -c e2e/scripts/browserstack_maestro
shadowenv exec -- bash -n e2e/scripts/package_maestro_suite

[kieran-osgood-shopify]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Soft-launch E2E PR checks #364
• Report E2E results to GitHub #363
• Run BrowserStack Maestro from E2E matrix rows #362 👈 (View in Graphite)
• Build React Native iOS E2E IPA artifact #361
• Build React Native Android E2E APK artifact #360
• Add Bitrise E2E pipeline skeleton #357
• Add E2E matrix launch smoke foundation #356
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.