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.