# `runner version` e `runner versions`

Nomes parecidos, perguntas diferentes — e a confusao entre os dois e comum o bastante para valer a tabela:

# `runner version`

runner version
runner version -o json
runner -V              # forma curta, equivalente

# `runner versions`

Lista as versoes implantadas de um projeto numa instancia — a base para escolher o alvo de um `rollback`.

runner versions <project>
runner versions meu-app -i production

Quantas versoes ficam retidas e decidido pelo keep_versions (ver a seção "Quantas versões são guardadas" em .deploy.yml), e o `cleanup` e quem poda o excedente.

# runner --capabilities (v2.157.0+)

Flag de topo, sem subcomando. Sempre imprime JSON e sai com código 0. É o manifesto que integrações como o CCS leem para saber o que o runner suporta.

runner --capabilities

{
  "success": true,
  "schema_version": "2.0",
  "client": { "name": "runner", "version": "2.157.0" },
  "command": "capabilities",
  "data": {
    "envelope_schema_version": "2.0",
    "commands": ["deploy", "snapshot", "app", "..."],
    "features": ["capabilities", "envelope.v2", "app.display_name.v1"],
    "output_formats": ["human", "json", "yaml"]
  }
}

# Ver tambem

• `runner rollback`
• instances
• `runner self-update` — atualizar o binario
• `runner status`