Show GN: dir2md v1.0.4 — 오픈소스 코드베이스를 LLM-Friendly Markdown으로 변환하는 CLI, 대규모 업데이트

🔥 dir2md v1.0.4 — 오픈소스 코드베이스를 LLM-Friendly Markdown으로 변환하는 CLI, 대규모 업데이트

dir2md는 로컬 또는 리모트 저장소를 스캔해, 디렉터리 구조 + 파일 콘텐츠를 LLM 입력에 최적화된 Markdown 블루프린트로 만들어주는 오픈소스 CLI 툴입니다.

코드 리뷰, AI 문서화, 프롬프트 엔지니어링 등에서 유용하게 활용할 수 있습니다.

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

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

---

주요 개선 사항 (v1.0.3 → v1.0.4)

⚙️ CLI 구성 및 옵션 처리 개선 (General Availability)

• CLI 기본 설정이 정식 GA 수준으로 안정화됨.

• 주요 옵션(-preset, -mask, -exclude 등)의 동작이 명확하게 정리되어

  버전별 동작 차이 없이 일관된 출력 보장.

• 불필요한 경고 메시지 및 중복 안내 제거.

🧠 로컬 실행 및 테스트 환경 자동화

• Repository-level import helper 추가.

  → pytest나 로컬 실행 시 src/ 디렉터리 자동 인식,

  더 이상 pip install -e . (editable install) 필요 없음.

• 테스트 환경 설정 단순화, 로컬 개발 효율성 향상.

🔍 Glob 매칭 복원 (gitwildmatch semantics)

• */ 패턴이 루트 파일까지 매칭되는 문제 수정.

  → Git의 gitwildmatch 동작을 정확히 복원하여

  재귀적 glob 검색이 직관적으로 동작하도록 개선.

• 대규모 리포지토리 스캔 시 예기치 않은 파일 누락 또는 과잉 탐색 방지.

🛡️ 보안 마스킹 및 설정 강화

• 기본 마스킹 범위 확대:

  • GitHub PAT (ghp_, gho_, ghs_ 등)
  • API Key, JWT, Database URL, OAuth Secret 등 민감 정보 자동 감춤.

• .env 파일 자동 로드 기능 추가:

  CLI 실행 시 근접한 .env 파일을 탐색 및 적용.

• 사용자 정의 마스킹 패턴 지원:

  • CLI 옵션: -mask-pattern, -mask-pattern-file
  • 프로젝트 설정: pyproject.toml의 [tool.dir2md.masking]

⚡️ 성능 및 프리셋 최적화 (Pro Mode)

• Pro preset 실행 시 성능 중심 가이드 반영:
  • 불필요한 파일 제외(Targeted excludes)
  • 토큰 예산(Tight budgets) 자동 계산
  • Manifest 생성 스킵 옵션 추가로 대규모 프로젝트 처리 속도 개선.
• 내부 캐싱 및 IO 효율 개선 → 평균 실행 속도 약 15~25% 향상.

🧾 호환성 및 안정성

• Windows 환경에서 file:///C:/path">file:///C:/path URI 처리 버그 수정.
• CP949 등 비 UTF-8 로케일 환경에서도 ASCII-safe 출력 보장.
• Symlink 미지원 환경에서 일부 테스트 자동 스킵.
• 나머지 테스트 전부 통과

---

🧭 한 줄 요약

dir2md v1.0.4 = 보안 강화 + 성능 향상 + 설정 단순화

LLM-friendly 코드 요약 파이프라인을 만들고 싶다면 지금 바로 업데이트!