Hot Updater QA Ship

Hot Updater QA Ship

Deploy the current iOS OTA bundle to the configured production channel with rollout 0, then attach exactly one target cohort to the newly created Bundle.

Required Input

Ask the user for only the target cohort when it is not already provided. Do not ask for platform, channel, rollout, or app version.

Target cohort rules:

• Trim surrounding whitespace.
• Reject empty values.
• Accept only one cohort value. If the user provides multiple values, ask for a single cohort.
• Pass the cohort to Hot Updater exactly as the validated trimmed string.

Workflow

1. Work from the mobile app directory:

cd apps/mobile

2. Read the current native app versions:

pnpm hot-updater app-version --json

3. Extract the current ios app version. Treat numeric JSON values as strings when passing them to the CLI. If --json is not supported, run pnpm hot-updater app-version and parse the iOS version from the human-readable output.

4. Deploy the current iOS app version with rollout 0:

pnpm hot-updater deploy -p ios -t <ios-app-version> -r 0

5. Wait for the deploy command to finish. Success requires build complete, storage upload complete, database update complete, and Deployment Successful (<bundle-id>).

6. Extract <bundle-id> from the ID row in the deployment summary.

7. Attach the target cohort to that exact Bundle without prompting:

pnpm hot-updater bundle update <bundle-id> --target-cohorts "<target-cohort>" -y

Use --json as well when you want machine-readable confirmation from the update command:

pnpm hot-updater bundle update <bundle-id> --target-cohorts "<target-cohort>" -y --json

8. Verify the Bundle state:

pnpm hot-updater bundle show <bundle-id> --json

Confirm the resulting Bundle has id equal to the deployed Bundle ID, platform equal to ios, target_app_version equal to the current iOS app version, rollout_cohort_count equal to 0, and target_cohorts equal to an array containing exactly the requested target cohort.

Failure Handling

• If the app version command fails, report the error and do not deploy.
• If deploy fails, stop immediately. Do not run bundle update.
• If the deployment summary does not contain a Bundle ID, run pnpm hot-updater bundle list -p ios --target-app-version <ios-app-version> --limit 5 --json and identify the newly created Bundle before updating it.
• If the Bundle ID is unavailable, stop rather than guessing which Bundle was created.
• If bundle update fails, report the Bundle ID and update error.
• If verification fails, report the mismatch and Bundle ID.

Notes

• This skill always targets iOS.
• This skill always uses rollout 0.
• This skill uses the Hot Updater default channel, currently production, unless the repo configuration or CLI default changes.
• Do not hardcode an app version. Always read the current iOS version at deploy time.