Scaffold Maestro E2E flows + CI workflow for iOS SDKPlayground

[phwizard]

Summary

iOS analog of `ethora-sample-android` PR #2. Mirrors the same 19 Maestro YAML flows with the same numbering and intent — resolving UI nodes by accessibility identifier (set on the SDK side via `ethora-sdk-swift` PR #6) so a single Maestro flow exercises the same scenario on both platforms.

What runs here

#	Flow	Covers
01	login-email	Happy-path email/password login → connected
02	login-jwt	Bring-your-own-auth client-flow JWT
03	list-rooms	Room list renders with unread counts
04	send-text	XMPP send round-trip
05	receive-text	MAM delivery from a second user
06	attach-file	Upload + image bubble
07	reconnect-airplane	Disconnect → reconnect → history survives
08	push-deep-link	APNs payload → correct room
09	logout-relogin	State isolation across sessions
10	switch-app	Multi-tenant app switcher
11	login-wrong-password	Negative path surfaces error
13	message-edit	Long-press → Edit → bubble updates
14	message-delete	Long-press → Delete → tombstone or removal
15	message-reaction	Long-press → React → emoji + count
16	create-room	"+" → name → room visible + writable
17	search-rooms	`.searchable` filter narrows + restores
18	multi-message-rapid	5 rapid sends, ordering preserved
19	room-info	Room info modal → participants + leave
20	offline-pending-resend	Send while disconnected → message lands

(Flow 12 reserved for typing-indicator.)

CI workflow

`.github/workflows/maestro.yml` runs on `macos-latest` with the iOS Simulator:

1. Selects Xcode, installs `xcodegen` + Maestro.
2. `generate_xcodeproj.sh` + `xcodebuild` for SDKPlayground.
3. Boots iPhone 15 simulator, installs the `.app`.
4. Seeds `test-image.png` into Photos via `simctl addmedia`.
5. Writes ETHORA_* defaults via `simctl spawn defaults write`.
6. Runs flows 01-07 + 09-20.
7. Fires synthetic push via `simctl push` then runs flow 08.
8. Uploads Maestro recordings as artifacts on failure (14d retention).

iOS matrix on release tags: `[17.5, 18.0]`. Single `18.0` on PRs.

iOS-specific differences from Android equivalents

• `appId: com.ethora.SDKPlayground` (Android: `com.ethora`)
• Tab labels title-case `"Setup"` / `"Chat"` / `"Logs"` (Android segmented control: uppercase)
• System search bar via SwiftUI's `.searchable` — swipe-down on the list to reveal
• Push delivery via `xcrun simctl push` (Android: `adb am start --es notification_jid`)
• Test image seeded via `simctl addmedia` (Android: `adb push` + media-scan broadcast)

These are documented in `.maestro/README.md` so future contributors know where to look when something is iOS-only.

Required repo secrets

```
ETHORA_API_BASE_URL https://api.chat-qa.ethora.com/v1
ETHORA_APP_ID
ETHORA_APP_TOKEN
MAESTRO_TEST_EMAIL alice@ethora.com
MAESTRO_TEST_PASSWORD TestPass123
MAESTRO_TEST_USER_JWT client-flow JWT for 02-login-jwt
MAESTRO_TEST_ROOM_JID a known MUC room JID alice belongs to
MAESTRO_TEST_BOB_JWT bob's user-session JWT (sendAsBob.js)
MAESTRO_TEST_APPB_* second-app credentials for 10-switch-app
```

All values target chat-qa, never prod.

Test plan

• Configure repo secrets above.
• CI runs on the `tf/maestro-tests` branch (will fail on flows where iOS UI strings drift from current YAML — that's expected, not a regression; tighten anchors as we discover them).
• `maestro test .maestro/flows/01-login-email.yaml` passes locally on a booted simulator with PlaygroundSession seeded by `@ethora/setup`.