ShipItKit

Central registry for built-in and plugin-provided actions.

Actor-isolated client for the App Store Connect REST API.

Generates and caches Google OAuth2 access tokens for service account authentication.

Generates ES256-signed JWTs for App Store Connect API authentication.

Manages a collection of statically linked ShipItPlugin types and registers their action descriptors into an ActionRegistry.

Tracks App Store Connect API rate limits and enforces backoff.

Exchanges a GitHub Actions OIDC token for a short-lived Google Cloud access token via Workload Identity Federation — no service-account key ever exists on disk or in CI secrets.

A discrete, composable unit of work in the release pipeline.

A response type with no body content (e.g. 204 No Content).

Classifies whether a test failure log represents a transient infrastructure problem (retryable) versus a real test/build failure (not retryable).

Define custom actions that extend ShipItSwifty.

Discovers parseable test artifacts from a project directory.

Builds runner-specific rerun selectors from a parsed run.

Parses one runner-specific input into a normalized ParsedTestRun.

Ready-to-run diagnosis for a specific workflow goal.

Builds a structured AISessionPayload from a project inspection.

The full structured payload returned by shipit ai-session.

An iOS or macOS app registered in App Store Connect.

A TestFlight beta testing group.

A TestFlight beta tester.

A processed build associated with an app in App Store Connect.

Generic list response wrapper for App Store Connect API list endpoints.

Generic single-resource response wrapper for App Store Connect API responses.

Shared context passed to every action during execution.

Type-erased registration metadata used by CLI commands, Shipfile workflows, and plugins to resolve actions by name at runtime.

Standardized result wrapper emitted by the CLI and workflow runner.

The context passed to each ActionValidationRule during Shipfile validation.

A single semantic validation rule attached to an ActionDescriptor.

A typed wrapper for xcrun agvtool commands.

A typed wrapper for xcrun altool commands.

A field where multiple valid options exist and the agent cannot auto-select.

Configuration for the external Google Android CLI.

Android-specific configuration for the android: Shipfile block.

Classifies Android Gradle/emulator infrastructure failures.

Parses one or more Android JUnit XML files into a normalized ParsedTestRun.

Core app identity and Xcode project settings.

App Store Connect API key configuration.

Shared App Store release operations built on top of AppStoreConnectClient.

Archives the app for distribution.

Archive configuration.

Handles the multi-step asset upload protocol for App Store Connect.

A typed wrapper for /bin/bash script execution.

Compiles the app.

Xcode build settings.

CLI-level options that can override Shipfile and environment settings.

Git-backed encrypted certificate and provisioning profile storage.

Information about a code signing certificate.

Manages code signing certificates — syncing from encrypted storage and creating new certificates via the App Store Connect API.

Code signing configuration.

Merges configuration from CLI flags, Shipfile.yml, environment variables, and built-in defaults.

Reads and summarizes native coverage artifacts produced by a prior test run.

A user-defined reusable sequence of action steps.

A declared parameter on a CustomActionConfig.

Downloads or uploads dSYM files for crash symbolication.

Reads ShipItSwifty configuration from environment variables.

Exports an IPA from an .xcarchive using xcodebuild -exportArchive.

IPA export configuration.

Uploads a signed IPA, APK, or AAB to Firebase App Distribution and releases it to testers.

JWT-authenticated HTTP client for the Firebase App Distribution API (v1).

A parsed and validated Firebase app ID.

A release record returned by the App Distribution API.

Release notes attached to an App Distribution release.

The payload returned once the upload long-running operation completes.

A typed wrapper for flutter CLI commands used by ShipItKit.

Classifies Flutter test infrastructure failures.

Parses flutter test --machine newline-delimited JSON output.

Overlays device frames on raw screenshots.

A typed wrapper for the frameit command.

Generates an Xcode project from a project spec file (e.g. XcodeGen’s project.yml).

Performs Git operations via SwiftyShell.

A typed wrapper for ad hoc git CLI commands used by ShipItKit.

An uploaded APK.

An uploaded Android App Bundle.

JWT-authenticated HTTP client for the Google Play Developer API (v3).

A Google Play edit session. All publishing changes are made within an edit and then committed atomically.

A release within a track, tying version codes to a status and release notes.

A release note for a specific language.

A Google Play distribution track (e.g. internal, alpha, beta, production).

Orchestrates the Google Play edit → upload → track → commit workflow.

Service account credentials loaded from a Google Cloud service account JSON key file.

A concise, human-readable summary parsed from a Gradle build’s stdout.

Classifies iOS xcodebuild archive infrastructure failures.

iOS-specific Shipfile overrides for the ios: block.

Classifies iOS/macOS xcodebuild infrastructure failures.

Parses iOS test results from an .xcresult bundle using xcresulttool.

Coordinates the IPA upload to App Store Connect / TestFlight.

A configuration value with full provenance — what was found, how, and why.

Manages infrastructure-level retry logic for test invocations across all platforms.

Encodes ActionResultEnvelope values to JSON strings for CLI output.

Runs a named script from package.json using the detected package manager.

Parses Jest --json --outputFile results into a normalized ParsedTestRun.

Classifies Kotlin Multiplatform iOS test infrastructure failures run via Gradle.

Wraps macOS security CLI commands for keychain management.

Runs static analysis and lint checks on the codebase.

Manages App Store metadata — pull from or push to App Store Connect.

App Store metadata configuration.

The single next deterministic step the agent should take.

Default empty-body response used for 204 No Content ASC endpoints.

Notification configuration.

Sends build notifications to Slack, Teams, Discord, and custom webhooks.

Posts build results to Slack, Teams, Discord, or any custom webhook.

Pagination links included in list API responses.

One parsed test case from a tool artifact.

A normalized test run parsed from an existing tool artifact.

Logical grouping for one parsed test suite.

Recoverable warning emitted while parsing an artifact.

Uploads a release artifact to Google Play and assigns it to a distribution track.

A typed wrapper for macOS property list validation, conversion, extraction, and mutation.

Validates App Store metadata against App Store guidelines before submission.

Manages provisioning profiles — creating via ASC API and installing locally.

Project generation configuration for spec-driven projects (e.g. XcodeGen, Tuist).

Creates App IDs on the Apple Developer Portal and registers devices.

Information about a provisioning profile.

A typed wrapper for npx react-native CLI commands used by ShipItKit.

Classifies React Native (Jest/Mocha) infrastructure failures.

Flat struct containing all resolved configuration values after merging CLI flags, environment variables, Shipfile.yml, and built-in defaults.

Defines retry behavior with exponential backoff for transient failures.

Screenshot capture configuration.

Describes a required secret: what it is, how to obtain it, and how to supply it.

A typed wrapper for macOS security CLI commands.

The top-level structure of a Shipfile.yml configuration file.

Manages certificates and provisioning profiles via encrypted vault storage.

A typed wrapper for xcrun simctl commands.

A typed simctl subcommand and its arguments.

A typed target accepted by simctl list.

A Slack message attachment for rich formatting.

Slack notification settings.

A Slack incoming webhook message payload.

Captures localized screenshots on simulators by running UI tests.

Artifact discovered by a TestArtifactLocator.

One execution attempt within a multi-attempt test run.

Device configuration for test runs requiring a device.

Uploads a build to TestFlight and manages beta distribution.

TestFlight distribution configuration.

Input metadata passed to artifact locators before parsing.

Reads and normalizes test-result artifacts produced by a prior test run.

Aggregate report spanning one or more rerun attempts.

Aggregate counts for a parsed test run or rerun attempt.

Uploads an IPA and metadata to App Store Connect.

Commit data sent to App Store Connect to finalize a multi-part upload.

An HTTP header included in an upload operation.

A single upload operation describing how to PUT one part of the asset.

Reservation returned by the App Store Connect API when reserving an asset upload slot.

Validates a .xcarchive, exported .ipa, or app bundle for App Store upload readiness.

Validates an Android App Bundle (.aab) or APK for Google Play upload readiness.

Bumps CFBundleVersion and/or CFBundleShortVersionString in the Xcode project.

Reads and writes CFBundleVersion and CFBundleShortVersionString using plutil and xcrun agvtool.

Build number and version bump strategy configuration.

A typed wrapper for the which command.

A named sequence of actions forming a release workflow.

A named workflow definition — an ordered list of steps. Configuration for a named workflow, including optional workflow-level overrides and an ordered sequence of steps.

The result of executing a named workflow.

A single step within a workflow, referencing a registered action by name.

A single step within a workflow definition from the Shipfile.

A typed wrapper for xcrun xccov commands.

A concise, human-readable summary parsed from an xcodebuild invocation’s stdout.

A fluent wrapper for the xcrun command.

A typed xcrun option and its raw arguments.

Formats an elapsed time (in seconds) for human-readable logs.

The type of Android build artifact to produce.

Strategy for auto-incrementing build numbers.

The build system that produces the native artifact for a given target platform.

Maps built-in action names to their semantic validation rules.

Factory and runtime for user-defined composite actions declared in Shipfile.yml under custom_actions:.

Output format for the coverage report.

Sort order for coverage results.

The mobile platform encoded in a Firebase app ID.

Outcome of an upload, distinguishing a new release from a re-upload of identical bytes.

Deployment status for a track release.

Where the Gradle task is qualified from.

Confidence level for an inferred value.

How a configuration value was determined.

A lossless JSON/YAML-compatible value type used for dynamically-typed action options.

The JavaScript/Node.js package manager to use for running scripts.

Errors thrown by JWTGenerator before reaching the JWT-signing layer.

Severity level for a parsing diagnostic.

The target platform for build and distribution workflows.

A format accepted by plutil -convert.

The destination for a converted property list.

An empty property list collection accepted by plutil -insert.

A format accepted by plutil -extract.

A typed value accepted by plutil -insert and plutil -replace.

A property list type that plutil can verify while extracting a value.

Top-level error type for all ShipItSwifty failures.

Canonical artifact kind used by parser selection.

Normalized status for one parsed test case.

How devices are provisioned for instrumented or e2e tests.

Runs unit and UI tests.

Runner-specific test selector used for targeted reruns.

A result builder for constructing workflow step sequences with Swift DSL syntax.