From fba392075135c5a2a8dc8c5038a980205ebe1d0a Mon Sep 17 00:00:00 2001 From: GitHub Copilot Date: Fri, 13 Mar 2026 05:19:05 -0300 Subject: [PATCH] feat(cli): regularize dashboard logs feature as F39 - Commits missing SPEC for dashboard logs (F39) - Resolves ID collision with F34 (ownership) - Updates RUN_REPORT.md to reflect new ID - Preserves implementation from previous merged PR Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- RUN_REPORT.md | 10 +++++----- features/F39-dashboard-logs/SPEC.md | 29 +++++++++++++++++++++++++++++ 2 files changed, 34 insertions(+), 5 deletions(-) create mode 100644 features/F39-dashboard-logs/SPEC.md diff --git a/RUN_REPORT.md b/RUN_REPORT.md index 53f12ac..caa9ac1 100644 --- a/RUN_REPORT.md +++ b/RUN_REPORT.md @@ -1,7 +1,7 @@ -# Relatório de Execução - Feature F34: Dashboard Logs +# Relatório de Execução - Feature F39: Dashboard Logs ## Resumo -Adição da funcionalidade de visualização de logs (`stdout`/`stderr`) no dashboard TUI (`aignt runs watch`), permitindo a inspeção detalhada de steps executados. +Adição da funcionalidade de visualização de logs (`stdout`/`stderr`) no dashboard TUI (`aignt runs watch`), permitindo a inspeção detalhada de steps executados. (Anteriormente referenciada como F34, regularizada para F39). ## Escopo Entregue - **Interface TUI**: @@ -25,8 +25,8 @@ Adição da funcionalidade de visualização de logs (`stdout`/`stderr`) no dash - **Performance**: Leitura síncrona de arquivos pode impactar a UI em logs muito grandes (>10MB), mas é aceitável para o escopo local atual. ## Próximos Passos -- Avaliar carregamento assíncrono ou paginado para logs muito extensos. -- Monitorar uso de memória em sessões longas com muitos logs abertos. +- Implementar filtros de steps (F42). +- Controle de cancelamento (F40). ## Conclusão -Feature F34 implementada e validada. Aprovada para merge na branch principal, completando o ciclo de melhoria de observabilidade iniciado na F33. +Feature F39 implementada e validada, resolvendo o débito técnico de colisão de ID da F34. diff --git a/features/F39-dashboard-logs/SPEC.md b/features/F39-dashboard-logs/SPEC.md new file mode 100644 index 0000000..bf09163 --- /dev/null +++ b/features/F39-dashboard-logs/SPEC.md @@ -0,0 +1,29 @@ +--- +id: F39-dashboard-logs +type: feature +summary: "Visualização de logs (stdout/stderr) no TUI Dashboard" +inputs: + - "Tecla Enter na lista de steps" +outputs: + - "Modal com conteúdo do log (clean ou raw)" +acceptance_criteria: + - "Deve abrir modal ao pressionar Enter em um step" + - "Deve exibir conteúdo de clean_output_path se existir" + - "Deve fazer fallback para raw_output_path se clean não existir" + - "Deve exibir mensagem de erro se arquivo não for encontrado" + - "Deve permitir fechar o modal com ESC" +non_goals: + - "Streaming de logs em tempo real (apenas snapshot)" + - "Edição de logs" + - "Busca textual dentro do modal" +--- + +## Contexto + +O dashboard TUI (F33) permite monitorar o estado dos steps, mas não o conteúdo gerado por eles. Para debug e acompanhamento, é essencial visualizar o `stdout` e `stderr` de cada execução sem sair da interface. + +Esta feature (originalmente implementada como parte do ciclo da F33/F34) foi regularizada como F39 para evitar colisão de ID com a feature de ownership (F34). + +## Objetivo + +Implementar um `LogViewer` modal que exibe o conteúdo dos arquivos de log persistidos pelo runtime, permitindo inspeção rápida do resultado de cada ferramenta.