Add snapshot tests, Maestro flows and CI for the companion apps

.github/workflows/ci.yml

@@ -54,10 +54,110 @@ jobs:
             CODE_SIGNING_ALLOWED=NO \
             -resultBundlePath TestResults.xcresult
 
+      - name: Check domain coverage
+        run: ./scripts/check-domain-coverage.sh TestResults.xcresult 80
+
       - name: Upload test results
         if: always()
         uses: actions/upload-artifact@v4
         with:
           name: test-results
           path: TestResults.xcresult
           retention-days: 7
+
+  companions:
+    name: Companion apps
+    runs-on: macos-15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install xcodegen
+        run: brew install xcodegen
+
+      - name: Generate Xcode project
+        run: xcodegen
+
+      - name: Build iPhone app
+        run: |
+          xcodebuild build \
+            -project Nightcap.xcodeproj \
+            -scheme NightcapPhone \
+            -destination 'platform=iOS Simulator,name=iPhone 16' \
+            -skipMacroValidation \
+            CODE_SIGNING_ALLOWED=NO
+
+      - name: Build watch app
+        run: |
+          xcodebuild build \
+            -project Nightcap.xcodeproj \
+            -scheme NightcapWatch \
+            -destination 'generic/platform=watchOS Simulator' \
+            -skipMacroValidation \
+            CODE_SIGNING_ALLOWED=NO
+
+      - name: Snapshot tests
+        run: |
+          xcodebuild test \
+            -project Nightcap.xcodeproj \
+            -scheme NightcapPhone \
+            -destination 'platform=iOS Simulator,name=iPhone 16' \
+            -skipMacroValidation \
+            CODE_SIGNING_ALLOWED=NO \
+            -resultBundlePath PhoneTestResults.xcresult
+
+      - name: Upload phone test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: phone-test-results
+          path: PhoneTestResults.xcresult
+          retention-days: 7
+
+  e2e:
+    name: Maestro e2e
+    runs-on: macos-15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install tools
+        run: |
+          brew install xcodegen
+          curl -Ls https://get.maestro.mobile.dev | bash
+          echo "$HOME/.maestro/bin" >> $GITHUB_PATH
+
+      - name: Generate Xcode project
+        run: xcodegen
+
+      - name: Boot simulator
+        run: |
+          UDID=$(xcrun simctl create maestro-iphone \
+            com.apple.CoreSimulator.SimDeviceType.iPhone-16)
+          xcrun simctl boot "$UDID"
+          echo "SIM_UDID=$UDID" >> $GITHUB_ENV
+
+      - name: Build and install app
+        run: |
+          xcodebuild build \
+            -project Nightcap.xcodeproj \
+            -scheme NightcapPhone \
+            -destination "platform=iOS Simulator,id=$SIM_UDID" \
+            -derivedDataPath DerivedData \
+            -skipMacroValidation \
+            CODE_SIGNING_ALLOWED=NO
+          xcrun simctl install "$SIM_UDID" \
+            DerivedData/Build/Products/Debug-iphonesimulator/Nightcap.app
+
+      - name: Run Maestro flows
+        run: maestro test .maestro/
+
+      - name: Upload Maestro artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: maestro-results
+          path: ~/.maestro/tests
+          retention-days: 7

.gitignore

@@ -22,3 +22,9 @@ dist/
 *.ipa
 *.dSYM.zip
 *.dSYM
+
+## local-only spec override
+project.local.yml
+
+## SwiftPM local build artifacts
+Packages/*/.build/

.maestro/README.md

@@ -0,0 +1,12 @@
+# Maestro flows
+
+End-to-end flows for the iPhone companion app.
+
+```bash
+# Build and install first (Xcode, scheme NightcapPhone, an iOS simulator),
+# then:
+maestro test .maestro/
+```
+
+Flows run against the stubbed `MacStateTransportClient`, so they exercise the
+real UI and reducer without needing a Mac on the other end.

.maestro/companion-status.yaml

@@ -0,0 +1,27 @@
+# Verifies the companion's core promise end to end: it shows what the Mac is
+# doing, and pausing an app from the phone releases the Mac.
+appId: com.abdocodes.nightcap.phone
+---
+- launchApp:
+    clearState: true
+
+# The Mac is being kept awake by Ghostty
+- assertVisible: "Nightcap"
+- assertVisible: "Keeping Mac Awake. 1 app active"
+- assertVisible: "Watched Apps"
+- assertVisible: "Ghostty"
+- assertVisible: "Xcode"
+
+# A paused app is labelled as such rather than silently shown as off
+- assertVisible: "zoom.us"
+- assertVisible: "Paused"
+
+# Pausing Ghostty from the phone lets the Mac sleep
+- tapOn:
+    id: "Watch Ghostty"
+- assertVisible: "Idle. Sleep allowed"
+
+# Resuming brings it back
+- tapOn:
+    id: "Watch Ghostty"
+- assertVisible: "Ghostty"

.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "xcode": {
+      "command": "xcrun",
+      "args": ["mcpbridge"]
+    }
+  }
+}

Apps/Phone/NightcapPhoneApp.swift

@@ -0,0 +1,17 @@
+import ComposableArchitecture
+import NightcapCompanionUI
+import NightcapDomain
+import SwiftUI
+
+@main
+struct NightcapPhoneApp: App {
+    @State private var store = Store(initialState: CompanionFeature.State()) {
+        CompanionFeature()
+    }
+
+    var body: some Scene {
+        WindowGroup {
+            CompanionView(store: store)
+        }
+    }
+}

Apps/Watch/NightcapWatchApp.swift

@@ -0,0 +1,17 @@
+import ComposableArchitecture
+import NightcapCompanionUI
+import NightcapDomain
+import SwiftUI
+
+@main
+struct NightcapWatchApp: App {
+    @State private var store = Store(initialState: CompanionFeature.State()) {
+        CompanionFeature()
+    }
+
+    var body: some Scene {
+        WindowGroup {
+            CompanionView(store: store)
+        }
+    }
+}

Nightcap/NightcapApp.swift

@@ -1,4 +1,7 @@
 import ComposableArchitecture
+import NightcapClients
+import NightcapDomain
+import NightcapUI
 import SwiftUI
 
 @main