eventor

Eventor — CLI headless para configurar eventos

O binário eventor fala com a Management API do Eventor (/api/v1). A API key resolve um hub; você nunca enxerga outro. stdout = dados, stderr = humano. Em pipe/sem-TTY o stdout é JSON puro.

Quando usar CLI vs MCP

• CLI (este) — padrão pra scripting, bulk, loops e economia de token. Um comando, uma saída JSON, exit code semântico. Ideal pra agente em loop.
• MCP — só pra query pontual em linguagem natural num cliente que fala MCP. Carrega N tool-definitions por chamada (caro em token). Pra configurar evento, prefira o CLI.

Setup (uma vez)

eventor auth login --api-key sk_live_...   # valida em /me e grava ~/.config/eventor/config.json (0600)
# ou, sem login: export EVENTOR_API_KEY=sk_live_...   (e EVENTOR_BASE_URL se não for produção)

A key precisa do escopo manage. Sem credencial → exit 4 com hint de onde gerar.

A regra de ouro: configure o evento com UM comando

Não monte o evento campo a campo. Escreva um spec.json e rode event setup:

eventor event setup --from spec.json --dry-run   # mostra o plano (would_create/would_update/unchanged), não escreve nada
eventor event setup --from spec.json             # executa idempotente; re-rodar é seguro

spec.json:

{
  "event": { "name": "Maratona da Cidade 2026", "code": "MAR2026", "date": "2026-09-13",
             "city": "São Paulo", "state": "SP", "service_fee_cents": 990 },
  "organizer": { "name": "Run Brasil Eventos", "document": "12345678000190" },
  "races": [ { "name": "10K", "distance": 10,
               "modalities": ["Geral", "Morador"], "default_modality": "Geral",
               "categories": [ { "name": "Geral M", "sex": "M", "award_count": 3 },
                               { "name": "Fem 30-39", "sex": "F", "modalities": ["Geral"] } ] },
             { "name": "KIDS", "distance": 0.4, "sem_classificacao": true,
               "categories": [ { "name": "5-7 anos" } ] } ],
  "registration_settings": { "is_free": false },
  "vacancy_pools": [ { "name": "Geral", "max_quantity": 500 } ],
  "batches": [ { "name": "1º Lote", "max_installments": 6,
                 "race_prices": { "10K": { "price": 12900, "pool": "Geral" } } } ],
  "registration_fields": [ { "label": "Tamanho da camiseta", "type": "select",
                             "options": [ { "value": "P", "label": "P" }, { "value": "M", "label": "M" } ] } ],
  "modality_questions": [ { "modality": "Morador", "label": "Sou morador (anexe o comprovante)", "type": "file" } ],
  "publish": false
}