dir2md v1.0.4 — Açık kaynak kod tabanlarını LLM-Friendly Markdown’a dönüştüren CLI için büyük güncelleme

🔥 dir2md v1.0.4 — Açık kaynak kod tabanlarını LLM-Friendly Markdown’a dönüştüren CLI için büyük güncelleme

dir2md, yerel veya uzak depoları tarayarak dizin yapısını ve dosya içeriklerini LLM girdisine optimize edilmiş bir Markdown blueprint’ine dönüştüren açık kaynaklı bir CLI aracıdır.

Kod incelemesi, yapay zeka dokümantasyonu, prompt engineering gibi alanlarda faydalı şekilde kullanılabilir.

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

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

---

Önemli iyileştirmeler (v1.0.3 → v1.0.4)

⚙️ CLI yapılandırması ve seçenek işleme iyileştirmeleri (General Availability)

• CLI varsayılan yapılandırması, resmî GA düzeyinde kararlı hale getirildi.

• Başlıca seçeneklerin (-preset, -mask, -exclude vb.) davranışı açık biçimde düzenlenerek

  sürümler arasında davranış farkı olmadan tutarlı çıktı garanti edildi.

• Gereksiz uyarı mesajları ve yinelenen bilgilendirmeler kaldırıldı.

🧠 Yerel çalıştırma ve test ortamı otomasyonu

• Repository-level import helper eklendi.

  → pytest veya yerel çalıştırma sırasında src/ dizini otomatik algılanıyor,

  artık pip install -e . (editable install) gerekmiyor.

• Test ortamı kurulumu sadeleştirildi, yerel geliştirme verimliliği artırıldı.

🔍 Glob eşleştirmenin geri getirilmesi (gitwildmatch semantics)

• */ deseninin kök dizindeki dosyalarla da eşleşmesi sorunu düzeltildi.

  → Git’in gitwildmatch davranışı doğru şekilde geri getirilerek

  özyinelemeli glob aramasının daha sezgisel çalışması sağlandı.

• Büyük depolar taranırken beklenmeyen dosya atlanmaları veya aşırı taramanın önüne geçildi.

🛡️ Güvenlik maskelemesi ve yapılandırma güçlendirmeleri

• Varsayılan maskeleme kapsamı genişletildi:

  • GitHub PAT (ghp_, gho_, ghs_ vb.)
  • API Key, JWT, Database URL, OAuth Secret gibi hassas bilgiler otomatik olarak gizleniyor.

• .env dosyalarını otomatik yükleme özelliği eklendi:

  CLI çalıştırılırken yakındaki .env dosyaları aranıp uygulanıyor.

• Kullanıcı tanımlı maskeleme desenleri desteği:

  • CLI seçenekleri: -mask-pattern, -mask-pattern-file
  • Proje yapılandırması: pyproject.toml içindeki [tool.dir2md.masking]

⚡️ Performans ve preset optimizasyonu (Pro Mode)

• Pro preset çalıştırılırken performans odaklı rehberler uygulandı:
  • Gereksiz dosyaların hariç tutulması (Targeted excludes)
  • Token bütçelerinin (Tight budgets) otomatik hesaplanması
  • Manifest oluşturmayı atlama seçeneği eklenerek büyük projelerin işlenme hızı artırıldı.
• Dahili önbellekleme ve IO verimliliği iyileştirildi → ortalama çalıştırma hızı yaklaşık %15~25 arttı.

🧾 Uyumluluk ve kararlılık

• Windows ortamında file:///C:/path URI işleme hatası düzeltildi.
• CP949 gibi UTF-8 dışı locale ortamlarında da ASCII-safe çıktı garanti edildi.
• Symlink desteklenmeyen ortamlarda bazı testler otomatik olarak atlanıyor.
• Kalan testlerin tamamı başarıyla geçti.

---

🧭 Tek satırlık özet

dir2md v1.0.4 = daha güçlü güvenlik + daha iyi performans + daha sade yapılandırma

LLM-friendly bir kod özetleme pipeline’ı kurmak istiyorsanız hemen güncelleyin!