코드-환경변수 간 Drift 제거를 통한 온보딩 최적화 및 런타임 오류 방지

Context

.env.example 파일이 실제 코드 내 환경변수 참조와 일치하지 않는 Documentation Drift 현상 발생. 이로 인해 신규 개발자의 온보딩 지연 및 런타임 시 undefined 상태로 인한 서비스 크래시 위험 상존.

Technical Solution

• 코드 내 모든 환경변수 참조 패턴(process.env, import.meta.env, os.getenv 등)을 정적 분석으로 추출
• .env.example 파일의 선언된 Key 집합과 코드 참조 집합 간의 Set-subtract 연산 수행
• Missing Keys(코드엔 있으나 예제엔 없음)와 Unused Keys(예제엔 있으나 코드엔 없음)를 구분하여 탐지
• 단순 Regex 기반의 Grep 방식이 가진 Destructuring 및 주석 처리 인식 한계를 해결한 AST 수준의 파싱 적용
• Client-side 처리 방식을 통해 소스 코드와 Secret 정보의 외부 유출을 원천 차단한 보안 설계