{
  "description": "Promote freight to a stage. Exactly one freight selector and one target are expected; the form does not enforce that. Other commands, login and --wait are left out.",
  "name": "kargo",
  "subcommands": [
    {
      "name": "promote",
      "description": "Promote freight (by name, alias or from a warehouse) to a stage or to the stages downstream of it, or abort a promotion.",
      "options": [
        {
          "names": [
            "--project"
          ],
          "description": "Defaults to the project set with kargo config set-project.",
          "args": {
            "name": "project",
            "description": "Defaults to the project set with kargo config set-project.",
            "isOptional": false
          }
        },
        {
          "names": [
            "--freight"
          ],
          "description": "Freight name",
          "args": {
            "name": "freight",
            "isOptional": false
          }
        },
        {
          "names": [
            "--freight-alias"
          ],
          "description": "Freight alias",
          "args": {
            "name": "freight_alias",
            "isOptional": false
          }
        },
        {
          "names": [
            "--warehouse"
          ],
          "description": "Warehouse",
          "args": {
            "name": "warehouse",
            "isOptional": false
          }
        },
        {
          "names": [
            "--stage"
          ],
          "description": "Target stage",
          "args": {
            "name": "stage",
            "isOptional": false
          }
        },
        {
          "names": [
            "--downstream-from"
          ],
          "description": "Promote to stages downstream of",
          "args": {
            "name": "downstream_from",
            "isOptional": false
          }
        },
        {
          "names": [
            "--name"
          ],
          "description": "Promotion name (abort only)",
          "args": {
            "name": "name",
            "isOptional": false
          }
        },
        {
          "names": [
            "--abort"
          ],
          "description": "Abort the promotion",
          "isDangerous": true
        }
      ]
    }
  ]
}