Observabilidade — Fase 1 (CLI/MCP): logs com contexto e filtro por release #22

Contexto

Parte de CLI/MCP da Fase 1 da observabilidade (logs com contexto). Design e tese em cleat-web/docs/observability-study.html; issue do painel: cleat-cloud/cleat-deploy#132.

Objetivo: expor, no terminal e para agentes, os logs contextualizados por aplicação e deploy que o painel passa a servir.

CLI

• cleat apps logs APP — manter --tail/--since/--grep/--follow e adicionar filtro por release.
• cleat servers logs ID — manter --unit/--tail/--since/--grep/--follow.
• --json estável nas duas (consumo por scripts/CI).

MCP

• Tool apps_logs — aceitar os mesmos filtros (incluindo release).
• Tool server_logs — manter unit/tail/since/grep.
• Retorno em JSON consistente com a API do painel.

Dependência

Endpoints de log no /api/v1 do painel (Fase 1). Consome via Cleat.Client.

Critérios de aceite

• Filtrar logs por app e release pelo CLI e pelo MCP com resultado equivalente ao painel.
• Saída --json parseável sem pós-processamento.
• Testes cobrindo os novos argumentos (CLI e MCP).

Nota

Nomes e flags são propostas; ajustar ao padrão real do CLI/MCP na implementação.