jev-review
무엇인가
jev-review는 Git diff 리뷰와 전체 코드베이스 스캔을 한 흐름으로 묶는 코드 리뷰 워크플로다. 리뷰 전체를 LLM에 맡기는 대신 오케스트레이션을 코드에 두고, 모델에는 범위가 정해진 판단만 요청한다. TypeScript로 작성됐고 TypeSafe Jev 위에서 동작한다.
어떻게 동작하나
진입점은 변경 리뷰와 전체 코드베이스 리뷰로 나뉜다. 테스트 공백을 판단할 때는 변경됐거나 관련된 테스트를 컨텍스트로 함께 넣는다. 정확성, 보안, 신뢰성, 호환성, 테스트 커버리지 항목을 검사한다. 영향도를 점수로 매기기 전에 구체적인 diff hunk나 소스 영역을 먼저 고른다. 구조화된 힌트와 반례, 명시적 결정 경계로 모델 호출을 좁힌다. 임계값과 워크플로 정책은 코드에서 적용한다. 결과는 로컬 대시보드에 접이식 섹션으로 표시되고, 대시보드는 127.0.0.1에 바인딩되며 환경 파일은 서빙하지 않는다.
무엇과 다른가
단일 프롬프트로 diff 전체를 리뷰하는 방식과 달리 판단 단위를 코드가 정한다. 점수 임계값과 통과·차단 정책이 모델 출력이 아니라 코드에 있으므로 리뷰 기준이 호출마다 흔들리지 않는다. 결과를 외부 서비스로 보내지 않고 127.0.0.1의 로컬 대시보드에서만 보여준다.
어떻게 쓰나
Node.js 24 이상과 Git, TypeSafe API 키가 필요하다. 실행한 뒤 http://127.0.0.1:4317 에서 대시보드를 연다. 소스는 src/ 아래에 계층으로 나뉘고 임포트는 하위 계층으로만 향한다. scripts/check-dependencies.ts가 상향 임포트, cli와 dashboard 사이의 임포트, 순환 임포트를 검사해 npm run check를 실패시킨다.
전제와 한계
컴파일러 진단, 정적 분석기, 저장소 인덱싱, 생성된 설명은 아직 통합되지 않았다. 출력되는 발견 사항은 결함의 증명이 아니라 리뷰 프롬프트다. 빠른 타입 기반 판단을 리뷰 워크플로로 조합하는 실험이며 MIT 라이선스다.