Resumo
O Specsfy 0.31.1 é uma publicação de documentação e alinha o texto ao binário atual. Os READMEs do projeto, os guias e a referência deixam claro que specsfy sem argumento, na pasta do projeto, já abre a TUI, e que specsfy tui existe para os casos de --project e --tab. As teclas de saída citadas agora são as reais, q, Esc e Ctrl+C, no lugar de Ctrl+Q.
A segunda frente é a documentação de desenvolvimento. docs/develop/ passa a descrever o CLI atual, construído em Bun com OpenTUI e MCP, no lugar do CLI antigo em Node com Commander e neo-blessed. As ferramentas da raiz aparecem como Node.js e node:test, sem as referências a Python, Behave e uv. A referência de uso também registra que o executável não precisa de Node.js nem de npx e que --specialist e --spec recebem lista separada por vírgula. O texto descreve ainda o formato de tasks delivery e o código de saída 10 de context monitor --check, além do credentials rotate-key, do get --reveal e do doctor --project.
Novidades
A publicação não acrescenta recurso. As entradas do release são correções de documentação de uso e de desenvolvimento.
Melhorias
- Specsfy 0.31.1 — Abertura da TUI documentada: os READMEs, os guias e a referência registram que
specsfysem argumento abre a TUI na pasta do projeto, e quespecsfy tuiserve para--projecte--tab. - Specsfy 0.31.1 — Referência alinhada ao binário: a documentação registra que o executável não exige Node.js nem
npx, e que só o wrapper npm e o lançador deget.specsfy.devusam Node 18 ou superior. O texto descreve lista por vírgula em--specialiste--spec, além do formato detasks deliverye do código de saída 10 decontext monitor --check. Entram tambémcredentials rotate-key,get --reveal,doctor --projecte os códigos de saída detest. - Specsfy 0.31.1 — Documentação de desenvolvimento em Bun:
docs/develop/cobre a arquitetura e a pilha em Bun, OpenTUI e MCP. O texto trata dos pacotes, dos testes e da contribuição, além da atualização do binário e da privacidade. - Specsfy 0.31.1 — Ferramentas da raiz sem Python: as ferramentas da raiz aparecem como Node.js e
node:test, e saem as referências a Python, Behave euv. - Specsfy 0.31.1 — Componentes de gráfico na referência da TUI:
cli/docs/tui.mddocumenta os componentes de gráfico e as cores reais da lista com seleção.
Correções
- Specsfy 0.31.1 — Teclas de saída da TUI: a documentação agora cita
q,EsceCtrl+C, no lugar deCtrl+Q. - Specsfy 0.31.1 — Comandos e opções desatualizados: a referência deixa de citar
gate tasks --delivery, corrige o painel de abas, as teclas e o tema da TUI e retira o botão de aplicar, que dá lugar à confirmação comy.
Ponto de Atenção
A publicação não muda comportamento do binário. A automação escrita a partir do texto antigo pode usar tecla ou opção que não existe mais, como Ctrl+Q para sair ou gate tasks --delivery. A documentação de desenvolvimento também deixa de valer para um projeto que ainda segue a pilha antiga em Node, Commander e neo-blessed.
Teste sugerido: na pasta de um projeto, rode specsfy sem argumento e confira a abertura da TUI, depois saia com q, com Esc e com Ctrl+C. Rode specsfy --project <caminho> tui --tab gates e confira a aba, execute context monitor --check para ver o código 10 e consulte specsfy doctor --project e specsfy credentials rotate-key na referência.
Notas da versão
O release oficial do Specsfy 0.31.1 foi publicado em 20/11/2026 como versão estável. As notas vêm do anúncio da publicação, com bloco de correção.