Snapshot of the app's release state: latest App Store versions with their review states, and recent builds with processing states. Use this to answer 'where is the release right now?'

Attach an uploaded build (now VALID) to an app version so it can be submitted for review. The version must be in an editable state (PREPARE_FOR_SUBMISSION, METADATA_REJECTED, or DEVELOPER_REJECTED).

Bump the local app version before a build. Increments the build number (CURRENT_PROJECT_VERSION) and optionally sets a new marketing version. Updates every .xcodeproj/project.pbxproj in the project dir, plus project.yml if the project uses xcodegen, so all sources stay in sync.

Create a new app version in App Store Connect for a release. Defaults to the platform configured (IOS, MAC_OS, TV_OS, VISION_OS). The version must not already exist.

Verify the release toolchain end-to-end: ASC API credentials, mac-app directory, fastlane/xcodebuild (for asc_upload_build), altool (for asc_upload_ipa), and (if creds are present) that the app record exists in App Store Connect. Run this first in any release session.

Poll the status of an async job (build upload, archive, etc.). Returns the job status (running|succeeded|failed), exit code, and the last N lines of its log. Use this to track asc_upload_build or asc_upload_ipa.

List recent uploaded builds and their processing states (PROCESSING → VALID before they can be submitted). Use after an upload to watch for the build becoming VALID.

List all active and recent jobs (uploads, builds, etc.) with their statuses. Use to find the ID of a long-running task started by asc_upload_build or asc_upload_ipa.

List app versions with their App Store state (PREPARE_FOR_SUBMISSION, IN_REVIEW, PENDING_RELEASE, RELEASED, REJECTED, etc.). Use to find which version to attach a build to or submit.

Set app metadata (description, keywords, what's new, promotional text) for an app version and a specific locale (e.g. 'en-US'). The version must be in an editable state.

Submit an app version for App Store review. It must have a build attached and all metadata filled in (description, keywords, support URL, etc.). Creates or reuses a review submission and submits.

Archive, sign, and upload the app to App Store Connect via fastlane. This is async — it shells out to a fastlane lane (e.g. fastlane ios beta) and starts a long-running job. Check asc_job_status to poll for completion.

Upload a pre-built, pre-signed .ipa file (e.g. from EAS Build, a CI artifact, or manual Xcode archive) to App Store Connect via xcrun altool. This is async — starts a job that polls until upload completes. Does not archive or sign — pass it a ready-to-upload binary.