# runner unpause

Reativa uma app que foi marcada como paused automaticamente pelo runner depois de max_consecutive_fetch_errors falhas seguidas no fetch (default 10).

# Sintaxe

runner unpause <app>
runner unpause <app> --json

# Quando usar

Apps viram paused quando o runner falha em fazer git ls-remote (ou similar) varias vezes consecutivas. Os casos tipicos:

• Repositorio movido ou deletado do GitHub
• Token de auth expirado ou revogado
• Network/DNS instavel apontando pro Git host
• Branch de deploy renomeada e o runner ainda apontando pra antiga

Enquanto a app esta paused, o cron skipa ela silenciosamente — o log do fetch para de poluir com o mesmo erro a cada 5 minutos.

# Argumentos

# O que o comando faz

1. Carrega o state file do app
2. Reseta consecutive_fetch_errors para 0
3. Limpa last_error
4. Muda status de paused para active
5. Salva o state

Apos rodar, o proximo tick do cron volta a tentar fetch normalmente.

# Exemplos

# Reativacao basica

runner unpause meu-app
# App meu-app unpaused (had 10 consecutive errors).

# Output JSON

runner unpause meu-app --json

{
  "app": "meu-app",
  "was_paused": true,
  "cleared_errors": 10
}

# App nao estava pausada

Se o app nao esta com status paused, o comando ainda zera o consecutive_fetch_errors (defensivo):

runner unpause app-healthy
# App app-healthy was not paused (consecutive_fetch_errors cleared anyway).

# Comparacao com `runner reset`

Use unpause quando o unico problema eh o pause. Use reset quando precisa redeployar do zero.

# Veja tambem

• `runner reset` — limpa estado completo da app
• `max_consecutive_fetch_errors` — threshold de auto-pause no config.yml
• `runner fetch` — comando que dispara o counter de erros consecutivos