dir2md v1.0.4 — CLI convertissant des codebases open source en Markdown compatible LLM, mise à jour majeure

🔥 dir2md v1.0.4 — CLI convertissant des codebases open source en Markdown compatible LLM, mise à jour majeure

dir2md est un outil CLI open source qui scanne un dépôt local ou distant pour créer un blueprint Markdown optimisé pour l’entrée des LLM, avec structure de répertoires + contenu des fichiers.

Il peut être très utile pour la revue de code, la documentation par IA, le prompt engineering, etc.

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

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

---

Principales améliorations (v1.0.3 → v1.0.4)

⚙️ Amélioration de la configuration CLI et de la gestion des options (General Availability)

• La configuration de base de la CLI a été stabilisée à un niveau GA officiel.

• Le fonctionnement des principales options (-preset, -mask, -exclude, etc.) a été clarifié,

  garantissant une sortie cohérente sans différences de comportement selon les versions.

• Suppression des messages d’avertissement inutiles et des indications redondantes.

🧠 Automatisation de l’exécution locale et de l’environnement de test

• Ajout d’un repository-level import helper.

  → Lors de l’exécution locale ou avec pytest, le répertoire src/ est automatiquement reconnu,

  sans qu’il soit désormais nécessaire d’utiliser pip install -e . (editable install).

• Simplification de la configuration de l’environnement de test et amélioration de l’efficacité du développement local.

🔍 Restauration du matching Glob (gitwildmatch semantics)

• Correction d’un problème où le pattern */ matchait aussi les fichiers à la racine.

  → Le comportement gitwildmatch de Git a été restauré avec précision,

  pour rendre la recherche récursive par glob plus intuitive.

• Évite les omissions de fichiers inattendues ou l’exploration excessive lors du scan de grands dépôts.

🛡️ Renforcement du masquage de sécurité et de la configuration

• Extension du périmètre de masquage par défaut :

  • GitHub PAT (ghp_, gho_, ghs_, etc.)
  • API Key, JWT, Database URL, OAuth Secret et autres informations sensibles masqués automatiquement.

• Ajout du chargement automatique des fichiers .env :

  lors de l’exécution de la CLI, les fichiers .env proches sont recherchés et appliqués.

• Prise en charge de patterns de masquage personnalisés :

  • Option CLI : -mask-pattern, -mask-pattern-file
  • Configuration projet : [tool.dir2md.masking] dans pyproject.toml

⚡️ Optimisation des performances et des presets (Pro Mode)

• Le preset Pro applique désormais des recommandations orientées performance :
  • exclusion des fichiers inutiles (targeted excludes)
  • calcul automatique de budgets de tokens serrés (tight budgets)
  • ajout d’une option pour ignorer la génération du manifest afin d’accélérer le traitement des grands projets.
• Amélioration du caching interne et de l’efficacité des E/S → gain moyen d’environ 15 à 25 % sur la vitesse d’exécution.

🧾 Compatibilité et stabilité

• Correction d’un bug de traitement des URI file:///C:/path sous Windows.
• Garantie d’une sortie ASCII-safe même dans des environnements de locale non UTF-8 comme CP949.
• Skip automatique de certains tests dans les environnements ne prenant pas en charge les symlinks.
• Tous les autres tests passent avec succès.

---

🧭 Résumé en une ligne

dir2md v1.0.4 = sécurité renforcée + performances améliorées + configuration simplifiée

Si vous voulez construire un pipeline de synthèse de code compatible LLM, mettez à jour dès maintenant !