Workflow
    simulatorsurface-capturestagingtestflighthuman-reviewMaintain iOS

    Maintain validation and surface-capture loop

    How Maintain turns native iOS and backend work into reviewable evidence: regenerate the Xcode project, run simulator surface capture, verify docs/backend/iOS gates, check staging when credentials are available, and keep TestFlight/App Store blockers explicit before release decisions.

    Part of project

    Workflow

    Maintain validation and surface-capture loop

    8 steps
    1. Select the source revision and environment that will define the release or review candidate
      decision
    2. Regenerate Maintain.xcodeproj from XcodeGen so simulator evidence matches the current source tree
      action
    3. Run the AppSurfaceCaptureUITests harness to export sign-in, onboarding, Home, Log, Trends, Activity, Profile, and export-state screenshots
      action
    4. Run docs, backend type/check/test, and route-contract smoke gates appropriate to the change scope
      subprocess
    5. Run iOS build, unit, snapshot, UI, surface-capture, and runtime-smoke lanes before marking app work ready
      subprocess
    6. When staging credentials are available, run staging drift and deployed staging auth/API smoke before device or TestFlight sign-off
      action
    7. Human operator reviews health-adjacent wording, screenshots, blocker state, and whether the evidence represents local or origin state
      decision
    8. Keep TestFlight/App Store release blocked until App Store Connect access and production API/Worker reachability are verified
      state

    Related links