TUI Interativa

O sentry tail tem dois modos (definidos em cli.rs, despachados em cmd.rs):

• sentry tail (ou sentry tail --tui) → TUI interativa fullscreen com ratatui + crossterm. Modo default quando o stdout é um TTY.
• sentry tail --stream → modo não-interativo, uma linha por evento. Ativado automaticamente quando o stdout não é TTY (detecção via std::io::IsTerminal).

Os dois modos leem eventos do Postgres — exigem config com storage.postgres.url.

Layout fullscreen — 3 zonas

A TUI consulta os últimos 500 eventos a cada 200 ms. O layout tem 3 zonas (maquete ilustrativa):

┌───────────────────────── Sentry — live ─────────────────────────┐
│ ▁▂▃▅▇▆▄▂▃▅            req/s 412   Info 9.8k  Low 142  Med 31    │
│ [PAUSED] +12 novos  filtro:"/admin"  levels:High,Critical  db: ok│
├──────────────────────────── Eventos ────────────────────────────┤
│ 14:02:11 critical  78  203.0.113.7  [nginx]  POST   /api/login  │
│         403  SQLi (+60) ' OR 1=1--                              │
│ 14:02:09 high      35  198.51.100.4 [nginx]  GET    /.env   404 │
│         Sensitive (+25)                                         │
├────────────────────── Agregados — janela ───────────────────────┤
│ Top IPs          │ Top paths              │ ASN/Geo              │
│ 203.0.113.7 18 CRIT │ /admin        22    │ AS64512   41%        │
│ 198.51.100.4 11 HIGH│ /.env          9    │ Tor        3%        │
└─────────────────────────────────────────────────────────────────┘
 [f]iltrar · [Enter] detalhe · [b] bloquear · [u] unblock · [c]
 challenge · [i] info IP · [r] rotas · [Space] pausa · [q] sair

• Header — sparkline de req/s, contadores por nível (Info/Low/Med/High/Crit) e uma linha de estado: [PAUSED] com backlog, filtro textual ativo, filtro de levels e saúde da conexão (db: ok / db: ERRO).
• Eventos — stream colorido por nível (hora, level, score, IP, source, método, path, status e resumo de sinais), com cursor de seleção.
• Rodapé — agregados da janela visível: Top IPs (com pior nível), Top paths e ASN/Geo (com % de Tor). Responsivo: 3 colunas com largura ≥ 100, 2 colunas ≥ 60, 1 coluna abaixo disso.

Atalhos

Ações b/c respeitam o guard never-ban de [real_ip]: IP trusted recebe "ação ignorada" em vez de ser banido.

Detalhe do evento

No popup aberto com Enter: hora, cliente ip:porta → porta local, geo (ASN/país), request (método/path → status), risco (level/score/verdict/ source), a lista de sinais com peso e detail, o JSON do protocolo (truncado em 60 linhas) e o raw do log. Scroll com j/k ou PageUp/PageDown; qualquer outra tecla fecha.

Modo stream

sentry tail --stream imprime uma linha por evento (texto simples ou colorido quando o stdout é TTY), com os últimos 20 eventos no arranque e poll de 1 s depois. Com --json, emite JSONL com key-set estável: timestamp, source, ip, server_port, asn, country, level, score, verdict, method, path, status, signals. Ideal para pipe (| jq, | grep) e coleta estruturada. Implementação em tui/stream.rs.

Themes

--theme seleciona o tema (parse em tui/theme.rs):

• dark (default) — texto claro para terminais escuros.
• light — texto escuro para terminais claros.
• mono — sem cor: negrito/dim apenas (acessibilidade, terminais sem cor).

Implementação

Módulo tui/: