Resumo
O Specsfy 0.31.0 transforma a Overview da TUI em painel de estatísticas das specs. A tela reúne o progresso geral, os medidores de specs completas e de gates aprovados e o gráfico por estado. A lista de specs traz os três gates, a barra própria e o estado de cada uma, com as abertas primeiro. As barras acompanham a largura do terminal, e em tela com menos de 38 linhas o backlog e o guia saem da Overview para o primeiro próximo passo aparecer em Progress.
A segunda frente é de documentação visual. O projeto ganha um showcase da TUI em docs/user/assets/showcase/, com prints de todas as telas nos temas night e day, gerados a partir do projeto de exemplo. O comando bun run showcase atualiza só as telas que mudaram, e o bun run showcase:check entra agora no validate, o que reprova quando uma tela muda sem o print correspondente. As imagens usadas pelo guia do CLI, pelo site e pelos READMEs saem agora desse mesmo showcase.
Novidades
- Specsfy 0.31.0 — Overview como painel de estatísticas: a tela reúne o progresso geral, os medidores de specs completas e de gates aprovados e o gráfico por estado. A lista de specs traz os três gates e o estado de cada uma, com as abertas primeiro.
- Specsfy 0.31.0 — Showcase da TUI:
docs/user/assets/showcase/recebe prints de todas as telas nos temasnighteday, gerados a partir do projetoexample/.
Melhorias
- Specsfy 0.31.0 — Barra adaptada à largura: as barras da Overview acompanham a largura do terminal, e abaixo de 38 linhas o backlog e o guia saem da tela para o próximo passo ficar visível em
Progress. - Specsfy 0.31.0 — Verificação do showcase no
validate: obun run showcase:checkentra novalidatee reprova quando uma tela muda sem atualizar os prints. - Specsfy 0.31.0 — Imagens do CLI vindas do showcase: as imagens de
docs/user/assets/cli/saem do showcase e mostram a TUI atual, no lugar dos prints da 0.8.0, e o percurso visual emdocs/user/cli.mdacompanha as telas de hoje.
Correções
A publicação não descreve correção. A entrada do release é a Overview nova e o showcase que alimenta a documentação visual.
Ponto de Atenção
A mudança alcança a leitura em terminal baixo. Abaixo de 38 linhas, o backlog e o guia deixam a Overview, e a informação vira o primeiro próximo passo em Progress. O validate fica mais rígido, porque uma alteração de tela sem print novo reprova a verificação. Um projeto que edita a documentação visual à mão precisa rodar o showcase antes de validar.
Teste sugerido: abra a Overview num terminal largo e confira os medidores, o gráfico e a lista de specs. Reduza a altura para menos de 38 linhas e verifique a saída do backlog e do guia. Altere uma tela e rode bun run showcase:check para ver a reprovação, depois rode bun run showcase e repita a verificação. Confira os prints nos temas night e day.
Notas da versão
O release oficial do Specsfy 0.31.0 foi publicado em 20/11/2026 como versão estável. As notas vêm do anúncio da publicação, com blocos de adição e de alteração.