AST 기반 Codemod 도입으로 마이그레이션 시간 2시간에서 3초로 단축

Context

React Router v7 업데이트에 따른 4가지 Breaking Changes로 인해 전수 코드 수정이 불가피한 상황 발생. 단순 Regex 기반 치환은 문자열 리터럴 및 주석 오탐지로 인해 Zero-Fault 보장이 불가능한 한계 노출.

Technical Solution

• @ast-grep/napi 도입을 통한 Rust 기반 고성능 AST 파싱 및 구조적 패턴 매칭 구현
• 단순 텍스트 매칭이 아닌 AST Node Type 식별을 통한 import 문 및 JSX 속성 정밀 타겟팅
• 기존 속성 존재 여부를 판단하여 누락된 요소만 추가하는 Smart-merge 로직 기반의 Idempotency 확보
• Babel 대비 100배 빠른 처리 속도를 위해 Node.js N-API 바인딩 아키텍처 채택
• 실제 리포지토리의 다양한 엣지 케이스 대응을 위해 합성 테스트 픽스처와 실데이터 검증 병행
• 인프라 장애 대응을 위한 독립 실행형 apply-codemod.js CLI 구축으로 실행 경로 최적화