ait patchset — Complete Reference

ait patchset
ait patchset publish
ait patchset list
ait patchset show
ait patchset select
ait patchset ci-status
ait patchset rerun-ci

Publish the current local Line head as a remote Change revision, inspect or select exact published Patchsets, and read or manually rerun their remote CI. Patchsets have remote authority only; --remote selects a configured remote and there is no local Patchset mode.

Usage: ait patchset <COMMAND>

Commands:
  publish    Publish the current Line head as a new remote Patchset.
  list       List the published Patchsets owned by one remote Change without modifying it.
  show       Show one exact published remote Patchset without modifying it.
  select     Select one exact Patchset on its owning remote Change.
  ci-status  Read CI state for one exact remote Patchset.
  rerun-ci   Queue a manual CI rerun for one exact remote Patchset.
  help       Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help (see a summary with '-h')

Publish the current local Line head as the next Patchset for CHANGE_ID after validating the bound worktree and synchronizing its revision Snapshot to the selected remote. --summary is required; --author-mode overrides the configured provenance mode for this publication only.

Usage: ait patchset publish [OPTIONS] --summary <SUMMARY> <CHANGE_ID>

Arguments:
  <CHANGE_ID>
          Exact remote Change ID that will own the new Patchset.

Options:
      --summary <SUMMARY>
          Required human-readable summary of this published revision.

      --author-mode <MODE>
          Override provenance mode for this publication; otherwise use configured default_author_mode.
          
          [possible values: human_only, human_with_ai_assist, ai_with_human_review, ai_only_experimental]

      --remote <REMOTE>
          Configured remote name; defaults to the repository's default remote.

      --json
          Emit the complete publication result as stable JSON.

  -h, --help
          Print help (see a summary with '-h')

List the published Patchsets owned by one remote Change without modifying it.

Usage: ait patchset list [OPTIONS] <CHANGE_ID>

Arguments:
  <CHANGE_ID>  Exact remote Change ID whose published Patchsets will be listed.

Options:
      --remote <REMOTE>  Configured remote name; defaults to the repository's default remote.
      --json             Emit the complete Patchset list as stable JSON.
  -h, --help             Print help

Show one exact published remote Patchset without modifying it.

Usage: ait patchset show [OPTIONS] <PATCHSET_ID>

Arguments:
  <PATCHSET_ID>  Complete published Patchset ID; bare numeric ordinals are rejected.

Options:
      --remote <REMOTE>  Configured remote name; defaults to the repository's default remote.
      --json             Emit the complete Patchset record as stable JSON.
  -h, --help             Print help

Read the exact Patchset first, derive its owning Change from remote authority, then make that Patchset the Change's selected revision. The owning Change cannot be supplied or overridden by the caller.

Usage: ait patchset select [OPTIONS] <PATCHSET_ID>

Arguments:
  <PATCHSET_ID>
          Complete published Patchset ID; its owning Change is derived remotely.

Options:
      --remote <REMOTE>
          Configured remote name; defaults to the repository's default remote.

      --json
          Emit the complete selection result as stable JSON.

  -h, --help
          Print help (see a summary with '-h')

Read current CI readiness and a fixed bounded history of the 10 most recent CI jobs for one exact published Patchset without modifying remote authority.

Usage: ait patchset ci-status [OPTIONS] <PATCHSET_ID>

Arguments:
  <PATCHSET_ID>
          Complete published Patchset ID; bare numeric ordinals are rejected.

Options:
      --remote <REMOTE>
          Configured remote name; defaults to the repository's default remote.

      --json
          Emit the complete CI status and fixed recent-job window as stable JSON.

  -h, --help
          Print help (see a summary with '-h')

Queue CI for one exact published Patchset using the fixed trigger manual_rerun. Runner selection and execution profiles remain server policy and cannot be overridden here.

Usage: ait patchset rerun-ci [OPTIONS] <PATCHSET_ID>

Arguments:
  <PATCHSET_ID>
          Complete published Patchset ID to enqueue for a manual rerun.

Options:
      --remote <REMOTE>
          Configured remote name; defaults to the repository's default remote.

      --json
          Emit the complete queued-run result as stable JSON.

  -h, --help
          Print help (see a summary with '-h')