Resumo
O Specsfy 0.29.4 corrige a leitura do skills-lock.json na versão 2, gravada pelo gerenciador skills a partir da 1.9. O specsfy update, o specsfy doctor e a TUI aceitam agora o lock novo, então um projeto recém-instalado não é mais recusado com “unsupported lock version”, e versão desconhecida continua recusada. A contribuição é de Lucas Fuad no pull request #56.
A segunda frente é de proteção do banco. O $specsfy-setup compara agora o destino normalizado, com DB_URL decomposta em partes e os parâmetros de query aplicados por último, como o Laravel faz. Alias de driver, host local e porta padrão são agora equivalentes, e um .env.testing que aponta para o banco de desenvolvimento escrito de outra forma é recusado.
Novidades
A publicação não acrescenta recurso. As entradas do release são correções de compatibilidade, de proteção do banco e de leitura de research.
Melhorias
- Specsfy 0.29.4 — Lock na versão 2: o
specsfy update, ospecsfy doctore a TUI leem oskills-lock.jsongravado pelo gerenciadorskills1.9, e o lock na versão 2 foi reproduzido com o gerenciador 1.9.0. - Specsfy 0.29.4 — Comparação normalizada do banco: o
$specsfy-setupdecompõeDB_URLem partes, aplica os parâmetros de query por último e trata alias de driver, host local e porta padrão como equivalentes.
Correções
- Specsfy 0.29.4 — Projeto novo recusado no update: um projeto recém-instalado não é mais recusado com “unsupported lock version”, e versão desconhecida do lock continua sendo recusada.
- Specsfy 0.29.4 —
.env.testingcom o banco de desenvolvimento: o arquivo que aponta para o banco de desenvolvimento escrito de outra forma é agora recusado, e URL sem banco nos dois arquivos vale como o mesmo banco padrão. - Specsfy 0.29.4 — Leitura do research: o
load_research.mjslê a seção inteira, em vez de só o primeiro artefato e o primeiro claim, o que impede um claimcriticalrefutado na segunda linha de passar. Só vale como artefato o caminho que abre um item da lista. - Specsfy 0.29.4 — Texto do usuário inserido literalmente: os scripts de entrada do projeto deixam de interpretar
$&,$`e$'como padrão de substituição, o que preserva o texto exatamente como foi digitado. - Specsfy 0.29.4 — Spec aberta por link simbólico: o
analyze_change.mjsaceita spec aberta por link simbólico do repositório, como/tmpe/varno macOS. - Specsfy 0.29.4 — Rastreabilidade com worktree do Claude Code: o
check_traceability.mjsignora.claude/, onde o Claude Code cria worktree com cópia dos testes.
Ponto de Atenção
A mudança de comparação do banco alcança o $specsfy-setup e pode recusar um .env.testing que antes passava, o que é o comportamento pretendido e exige revisão do arquivo em projeto que compartilha banco entre ambiente. A leitura do research considera agora a seção inteira, então um projeto com claim refutado depois da primeira linha recebe agora a recusa. O lock na versão 2 depende do gerenciador skills 1.9, e um host com versão anterior continua gerando lock recusado.
Teste sugerido: num projeto instalado pelo gerenciador skills 1.9, rode specsfy update e specsfy doctor para confirmar a leitura do lock. Grave um .env.testing com o mesmo banco de desenvolvimento escrito por alias de driver e porta padrão e confira a recusa. Rode o load_research.mjs num research com claim refutado na segunda linha. Execute um script de inbox com texto que contenha $& e verifique a inserção literal.
Notas da versão
O release oficial do Specsfy 0.29.4 foi publicado em 20/11/2026 às 10h03 UTC como versão estável. As notas vêm do anúncio da publicação, com blocos de correção e de validação, e citam as contribuições de Lucas Fuad nos pull requests #54, #55 e #56.