Resumo
O Specsfy 0.29.5 é uma manutenção de compatibilidade e de leitura de arquivo, com quatro correções que apareceram na operação real. No Windows, um npx.cmd ou qualquer .cmd e .bat informado em SPECSFY_NPX_COMMAND ou SPECSFY_SKILLS_CLI roda agora pelo cmd.exe, com caminho e argumentos escapados. O specsfy install e o specsfy update deixam de falhar com EINVAL, recusa que o Node aplica desde a CVE-2024-27980, e param de quebrar em caminho com espaço, como C:\Program Files.
A segunda frente está na migração e na leitura de tabela. O specsfy specs migrate reescreve o índice de research do layout anterior para a pasta de estado, o que resolve a recusa do load_research.mjs sobre um artefato que o próprio comando tinha movido. Os scripts de aceite e de registro de campo dividem agora a tabela só nos pipes sem escape, então um comando como npm test \| tee log não desloca mais a linha do item de aceite. No Windows, o inspect_project.mjs lê cada arquivo pelo caminho real e volta a classificar teste, aplicação e rota em subpasta.
Novidades
A publicação não acrescenta recurso. As entradas do release são correções de execução no Windows, de migração de índice e de leitura de tabela.
Melhorias
- Specsfy 0.29.5 — Leitura por caminho real no Windows: o
inspect_project.mjsnormaliza o separador e lê cada arquivo pelo caminho real, o que devolve a classificação de testes, aplicação e rotas em subpasta.
Correções
- Specsfy 0.29.5 —
.cmde.batno Windows: umnpx.cmdinformado emSPECSFY_NPX_COMMANDou emSPECSFY_SKILLS_CLIroda pelocmd.execom caminho e argumentos escapados, o que encerra oEINVALdo Node e a falha em caminho com espaço. - Specsfy 0.29.5 — Índice de research na migração: o
specsfy specs migratereescreve o índice do layoutspecs/specs/<id>/especs/<id>/para a pasta de estado, o que impede a recusa de um artefato que o próprio comando moveu. - Specsfy 0.29.5 — Tabela com pipe escapado: o
verify_acceptance.mjse oregistrar_dados_conversados.mjsdividem a tabela só nos pipes sem escape, o que mantém a comprovação do item de aceite no lugar quando o comando traz\|. - Specsfy 0.29.5 — Coluna de formato em
DATABASE.md: uma linha antiga que traz\|no.specsfy/DATABASE.mdrecebe a coluna de formato sugerido, em vez de perder o alinhamento.
Ponto de Atenção
As correções de Windows só valem para o comando informado nas duas variáveis. Um caminho escrito sem escape em outro lugar continua sujeito à recusa do Node. A migração de índice altera arquivo dentro de specs/, então um projeto que guardava anotação naquele índice precisa conferir o conteúdo depois do comando. A divisão de tabela por pipe escapado vale para os três scripts citados, e um script próprio que lê a mesma tabela segue a condição anterior.
Teste sugerido: no Windows, defina SPECSFY_NPX_COMMAND com npx.cmd em caminho com espaço e rode specsfy install e specsfy update. Num projeto com o layout antigo de research, rode specsfy specs migrate e depois o load_research.mjs. Grave um item de aceite com comando que contém \| e rode o verify_acceptance.mjs. Num projeto com teste em subpasta, rode o inspect_project.mjs no Windows e confira a classificação.
Notas da versão
O release oficial do Specsfy 0.29.5 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, e citam quatro issues do repositório.