Resumo
O Herdrfy 0.2.0 troca nomes de scripts, opções, chaves do JSON e marcadores do bloco de instruções. onde.mjs vira where.mjs, diagnostico.mjs vira doctor.mjs e instrucoes.mjs vira instructions.mjs, com --surface, --project, --file e --remove nas opções e as chaves do JSON no mesmo idioma.
A publicação também separa as referências por superfície. references/herdr-core.md reúne os comandos do hc. references/desktop.md trata só da janela, com os rótulos, os painéis, as abas e os espaços.
Novidades
- Herdrfy 0.2.0 — Scripts e opções em inglês: os três scripts usam agora nomes e mensagens em inglês, e as chaves do JSON seguem o mesmo idioma, como
surface,foundeterminal.space. - Herdrfy 0.2.0 — Marcadores novos do bloco: o bloco de instruções usa
<!-- herdrfy:start -->e<!-- herdrfy:end -->, e um bloco antigo comherdrfy:inicioeherdrfy:fimé reconhecido, aparece comooutdatedno--checke é regravado sem duplicar. - Herdrfy 0.2.0 — Posicionamento no Desktop: o localizador informa
terminal.placementcomotab,unlabeledounone, e tambémterminal.identity, copiado dohc get. - Herdrfy 0.2.0 — Referência do herdr-core: o arquivo novo cobre terminais, lançamento, esperas e mensagens entre agentes, além de
exec,file, servidor e limpeza. - Herdrfy 0.2.0 — Opções
--helpnos scripts: os três scripts aceitam--helpe saem com código 2 para comando com argumento desconhecido.
Melhorias
- Herdrfy 0.2.0 — Terminal sem aba: a skill registra que o que o agente abre fica como auxiliar sem rótulos, com aviso à pessoa, sem copiar rótulos de outro terminal nem montar identificador a partir do texto de
where. - Herdrfy 0.2.0 — Confirmação de tarefa num lugar só: a leitura dos sinais depois do lançamento do agente fica na seção “Confirmar que a tarefa começou” de
references/orquestracao.md, com o TUI no mesmo nível de detalhe do Desktop. - Herdrfy 0.2.0 — Guia com problemas comuns: o guia ganha um capítulo de problemas comuns e comandos com o caminho da instalação.
- Herdrfy 0.2.0 — README: o texto ganha o aviso das permissões liberadas antes da instalação, os comandos de atualização e remoção, a instalação dos templates e os selos de CI, versão e licença.
- Herdrfy 0.2.0 — Publicação no
CONTRIBUTING.md: o fluxo de publicação sai do guia de uso e fica junto das instruções de contribuição.
Correções
- Herdrfy 0.2.0 — Terminal do core sem rótulos de aba: o terminal com o rótulo
wheree semherdr.spaceeherdr.tabnão é mais descrito como fora da janela, caso aparecido num terminal comidentity: herdr-mobile. - Herdrfy 0.2.0 —
--help: a opção não executa mais a consulta normal no localizador e no diagnóstico, e o argumento desconhecido não é mais ignorado. - Herdrfy 0.2.0 — Pergunta de superfície: o bloco de instruções manda rodar o localizador primeiro e perguntar só quando a detecção falha ou contraria a solicitação.
- Herdrfy 0.2.0 — Busca de executável: a procura no
PATHdeixa de depender do comandowhich.
Breaking changes
- Herdrfy 0.2.0 — Nomes de scripts e opções: uma automação que chama
onde.mjs,diagnostico.mjsouinstrucoes.mjs, ou que passa opções antigas, precisa migrar para os nomes novos. - Herdrfy 0.2.0 — Chaves do JSON: o consumidor da saída em JSON precisa ler as chaves novas, como
surface,foundeterminal.space, no lugar das anteriores. A lista completa incluineighbors,pending,files,stateeconflicts. - Herdrfy 0.2.0 — Bloco de instruções: depois de atualizar a skill, o bloco precisa ser regravado em cada projeto com
node ~/.agents/skills/herdrfy/scripts/instructions.mjs, e com--globalquando os arquivos globais foram gravados.
Ponto de Atenção
A migração do bloco é manual e por projeto. Um projeto que atualiza a skill e não roda o instructions.mjs mantém o bloco com os nomes antigos, e o --check mostra o estado outdated.
O scripts/validar.mjs vira scripts/validate.mjs e reprova Markdown que ainda cite um nome anterior à 0.2.0, então a documentação própria do projeto precisa acompanhar.
Teste sugerido: rode o instructions.mjs num projeto com bloco antigo e confira a regravação com os marcadores novos, sem duplicar. Execute where.mjs --help e um argumento desconhecido para ver o código 2, e rode doctor.mjs para conferir as chaves novas no JSON. Abra o references/herdr-core.md e execute um comando hc de leitura.
Notas da versão
O release oficial do Herdrfy 0.2.0 foi publicado em 11/11/2026 como versão estável. A suíte de testes passa de 9 para 18 casos, com localizador exercitado por hc e herdr falsos no PATH.