dir2md v1.0.4 — CLI que converte codebases open source em Markdown amigável para LLM, grande atualização

🔥 dir2md v1.0.4 — CLI que converte codebases open source em Markdown amigável para LLM, grande atualização

dir2md é uma ferramenta CLI open source que escaneia repositórios locais ou remotos e transforma a estrutura de diretórios + o conteúdo dos arquivos em um blueprint Markdown otimizado para entrada em LLMs.

Pode ser usada de forma útil em revisão de código, documentação com IA, prompt engineering e muito mais.

🔗 GitHub: https://github.com/Flamehaven/dir2md

🔗 Release v1.0.4: https://github.com/Flamehaven/dir2md/releases/tag/v1.0.4

---

Principais melhorias (v1.0.3 → v1.0.4)

⚙️ Melhorias na configuração da CLI e no processamento de opções (General Availability)

• A configuração padrão da CLI foi estabilizada em nível de GA oficial.

• O comportamento das principais opções (-preset, -mask, -exclude etc.) foi organizado de forma clara,

  garantindo saída consistente sem diferenças de comportamento entre versões.

• Remoção de mensagens de aviso desnecessárias e orientações duplicadas.

🧠 Automação da execução local e do ambiente de testes

• Adicionado repository-level import helper.

  → Durante pytest ou execuções locais, o diretório src/ é reconhecido automaticamente,

  então pip install -e . (editable install) não é mais necessário.

• Simplificação da configuração do ambiente de testes e melhora na eficiência do desenvolvimento local.

🔍 Restauração do matching de glob (gitwildmatch semantics)

• Corrigido o problema em que o padrão */ fazia match até com arquivos na raiz.

  → O comportamento gitwildmatch do Git foi restaurado com precisão,

  melhorando o funcionamento intuitivo da busca glob recursiva.

• Evita omissão inesperada de arquivos ou varredura excessiva ao escanear repositórios grandes.

🛡️ Reforço de masking de segurança e configurações

• Escopo de masking padrão ampliado:

  • GitHub PAT (ghp_, gho_, ghs_ etc.)
  • API Key, JWT, Database URL, OAuth Secret e outras informações sensíveis passam a ser ocultadas automaticamente.

• Adicionada a função de carregamento automático de arquivos .env:

  Durante a execução da CLI, arquivos .env próximos são localizados e aplicados.

• Suporte a padrões de masking personalizados:

  • Opções da CLI: -mask-pattern, -mask-pattern-file
  • Configuração do projeto: [tool.dir2md.masking] em pyproject.toml

⚡️ Otimização de desempenho e presets (Pro Mode)

• Ao executar o preset Pro, foram aplicadas diretrizes focadas em desempenho:
  • Exclusões desnecessárias removidas (Targeted excludes)
  • Cálculo automático de orçamento de tokens (Tight budgets)
  • Adicionada opção para pular a geração de Manifest, melhorando a velocidade de processamento em projetos grandes.
• Melhorias no cache interno e na eficiência de IO → velocidade média de execução cerca de 15~25% maior.

🧾 Compatibilidade e estabilidade

• Corrigido bug no processamento de URI file:///C:/path em ambiente Windows.
• Saída ASCII-safe garantida mesmo em ambientes de locale não UTF-8, como CP949.
• Alguns testes são pulados automaticamente em ambientes sem suporte a symlink.
• Todos os demais testes passaram.

---

🧭 Resumo em uma linha

dir2md v1.0.4 = mais segurança + melhor desempenho + configuração simplificada

Se você quer montar um pipeline de resumo de código amigável para LLM, atualize agora mesmo!