Resumo
O Herdrfy 0.2.1 corrige a detecção de superfície. O localizador decide pela árvore de processos, do ancestral mais próximo para cima, e as variáveis de ambiente só decidem quando a árvore não tem herdr-core nem herdr.
A falha aparecia num terminal do core que herdava HERDR_ENV=1 e HERDR_PANE_ID de um TUI anterior. A leitura pela variável fazia a solicitação de aba abrir no TUI, em vez da janela do Desktop.
Novidades
- Herdrfy 0.2.1 —
detectionna resposta: o localizador informaprocess,enveinheritedEnvnas duas superfícies e fora do Herdr. - Herdrfy 0.2.1 — Aviso de ambiente herdado: a saída em texto abre com
Warning:quando as variáveis da outra superfície estão herdadas, dizendo qual comando chega aonde.
Melhorias
- Herdrfy 0.2.1 — Variáveis de soquete: o
inheritedEnvincluiHERDR_SOCKET_PATHeHC_TERMINAL_SOCKET, e a comparação usa a superfície da árvore de processos, não a informada em--surface. - Herdrfy 0.2.1 — Guia e referências:
references/superficies.mdrecebe a ordem de detecção, o objetodetection, o campomismatche exemplos de JSON, e o guia ganha a seção sobre aba solicitada no Desktop que abriu no TUI.
Correções
- Herdrfy 0.2.1 — Aba no TUI em vez do Desktop: o localizador lê o terminal do core como Desktop, mesmo quando o ambiente herdado vem primeiro.
- Herdrfy 0.2.1 — Painel herdado do TUI: a busca do painel vindo de
HERDR_PANE_IDnão é aceita quando a árvore de processos indica um terminal do core, e a resposta éfound: false.
Ponto de Atenção
O --surface que contraria a árvore de processos mantém a superfície informada, marca mismatch: true e avisa que os comandos daquela superfície não chegam onde o agente roda. Uma automação que passa --surface fixo continua recebendo a superfície informada, com o aviso.
O bloco de instruções muda de texto, então a atualização da skill exige a regravação com o instructions.mjs em cada projeto.
Teste sugerido: abra um TUI dentro de um terminal do core e rode o localizador, conferindo surface e detection. Rode com --surface tui no mesmo terminal e veja mismatch. Monte um /proc falso com HERDRFY_PROC_ROOT e HERDRFY_PID e repita os casos de teste.
Notas da versão
O release oficial do Herdrfy 0.2.1 foi publicado em 13/11/2026 como versão estável. A suíte de testes passa de 18 para 22 casos, com /proc falso em pasta temporária.