ait release — Complete Reference
Create and inspect release dossiers, build and package native artifacts, publish them, and promote admitted releases.
Audience: Release engineers
Operating boundary#
Purpose: Create and inspect release dossiers, build and package native artifacts, publish them, and promote admitted releases.
Effect class: Release-authority and publication surface; build, publish, and promote operations can have external effects.
Coverage: 12 public help surfaces under ait release.
The blocks below preserve the RC.6 binary output in full, including every emitted argument, option, default, possible value, conflict, and requirement.
Complete command tree#
ait release
ait release candidate
ait release candidate create
ait release check
ait release build
ait release native-source
ait release native-bundle
ait release package
ait release formula
ait release show
ait release publish
ait release promoteExact emitted help#
ait release#
Reference description: Create and inspect release dossiers, build and package native artifacts, publish them, and promote admitted releases.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release <COMMAND>
Commands:
candidate
check
build
native-source
native-bundle
package
formula
show
publish
promote
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print helpait release candidate#
Reference description: Group the operations that create release-candidate authority records.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release candidate <COMMAND>
Commands:
create
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print helpait release candidate create#
Reference description: Create a release candidate for an exact version, Line, profile, and release channel.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release candidate create [OPTIONS] --version <VERSION>
Options:
--version <VERSION>
--line <LINE_NAME> [default: main]
--profile <PROFILE>
--channel <CHANNEL> [possible values: rc, stable]
--json
-h, --help Print helpait release check#
Reference description: Validate a release dossier, its component receipts and artifact bytes, and the stated test evidence.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release check [OPTIONS] <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--receipts <DIR>
Verify family component receipts and artifact bytes below DIR
--tests-command <TESTS_COMMAND>
--skip-tests-reason <SKIP_TESTS_REASON>
--json
-h, --help
Print helpait release build#
Reference description: Freeze admitted family artifacts for a release from component receipts or an exact native target matrix.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release build [OPTIONS] <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--receipts <DIR> Freeze family artifacts admitted from component receipts below DIR
--native-matrix-dir <DIR> Read target artifacts from DIR/<rust-target-triple>/release using ait-native-source.json descriptors.
--native-command-dir <DIR> Read current-host release command artifacts from this explicit directory.
--json
-h, --help Print helpait release native-source#
Reference description: Record the exact source, runner, image, Rust toolchain, and compiler inputs for one native release target.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release native-source [OPTIONS] --target <TARGET> --source-dir <DIR> --runner <RUNNER> --runner-image <RUNNER_IMAGE> --rust-toolchain <RUST_TOOLCHAIN> --rustc-path <PATH> <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--target <TARGET>
--source-dir <DIR>
--runner <RUNNER>
--runner-image <RUNNER_IMAGE>
--rust-toolchain <RUST_TOOLCHAIN>
--rustc-path <PATH>
--json
-h, --help Print helpait release native-bundle#
Reference description: Build native release bundles only from target directories carrying the required source descriptors.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release native-bundle [OPTIONS] --native-matrix-dir <DIR> <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--native-matrix-dir <DIR> Build native bundles only from DIR/<rust-target-triple>/release using ait-native-source.json descriptors.
--json
-h, --help Print helpait release package#
Reference description: Create channel-specific package output for an admitted release.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release package [OPTIONS] --channel <CHANNEL> <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--channel <CHANNEL> Assemble one declared channel from an immutable frozen family build [possible values: homebrew, apt, winget, pypi, npm]
--json
-h, --help Print helpait release formula#
Reference description: Generate a named package formula from an admitted release.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release formula [OPTIONS] --name <NAME> <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--name <NAME>
--python-formula <PYTHON_FORMULA>
Homebrew Python dependency formula written into the generated formula. [default: python@3]
--json
-h, --help
Print helpait release show#
Reference description: Show the release dossier and its recorded admission state.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release show [OPTIONS] <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--remote <REMOTE>
--json
-h, --help Print helpait release publish#
Reference description: Publish the selected admitted release artifacts through the configured publication boundary.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release publish [OPTIONS] <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--remote <REMOTE>
--json
-h, --help Print helpait release promote#
Reference description: Promote an admitted release to the selected release channel.
The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.
Usage: ait release promote [OPTIONS] --channel <CHANNEL> <RELEASE_ID>
Arguments:
<RELEASE_ID>
Options:
--channel <CHANNEL> [possible values: rc, stable]
--json
-h, --help Print help