소프트웨어 코드 승인 전 위험도를 알려주는 'farol' 도구

farol은 소프트웨어 개발 과정에서 코드를 최종적으로 승인하는 사람을 돕기 위해 만들어진 무료 오픈소스 도구입니다. 개발자가 코드를 수정해서 메인 코드에 합치기 전에 검토를 요청하는 것을 '풀 리퀘스트'라고 하는데, farol은 인공지능(AI)이 코드를 검토한 뒤, 이 변경 사항을 합치는 것이 얼마나 위험한지, 그리고 그 위험이 코드의 어느 부분에 집중되어 있는지를 알려줍니다. 여기서 말하는 위험이란 단순히 문법 오류를 넘어, 작은 코드 수정 하나가 시스템의 다른 여러 부분에 예상치 못한 문제를 일으킬 가능성을 의미합니다. farol은 코드를 실제로 돌려보지 않고, 코드를 분석하는 방식인 정적 분석을 사용하기 때문에 같은 변경 요청에 대해서는 항상 일관된 결과를 보여줍니다.

최근에는 AI가 코드를 만들고 AI가 코드를 검토하는 시대가 되었지만, 코드를 최종적으로 합칠지 말지는 여전히 사람이 결정해야 합니다. 문제는 승인자가 너무 많은 변경 요청을 검토하다가 대충 훑어보게 되고, 이 때문에 공유된 기능의 아주 작은 변경이 수십 개의 화면이나 기능을 망가뜨릴 수 있다는 점입니다. farol은 AI 검토를 완전히 대신하는 것이 아니라 그 뒤에 추가되는 보조적인 역할을 합니다. 위험도가 낮은 변경 사항은 빠르게 통과시키고, 위험도가 높은 변경 사항에 대해서는 위험한 파일부터 집중적으로 자세히 보도록 유도하여 승인자가 검토하는 효율성을 높여줍니다.

farol(포르투갈어로 '등대'라는 뜻)은 검토자가 코드를 자세히 보기 전에 변경 사항의 위험도를 미리 분류해 줍니다. 이 도구는 변경된 코드가 실행되는 모든 기존 페이지, API 기능, 작업 등을 찾아내고, 각 요소까지 이어지는 호출 경로를 상세하게 보여줍니다. farol은 도달 범위, 코드 변경 부분의 테스트 적용 범위, 보안 취약점 발견 여부, 계약 위반 가능성, 의존성 프로그램 변경 등을 종합적으로 분석하여 '빠른 통과', '신속한 검토', '신중한 검토'라는 판정을 내리고 0점부터 100점 사이의 위험 점수를 부여합니다. 이 점수는 위험한 항목 중 적어도 하나가 시스템을 망가뜨릴 확률을 의미하며, 60점 이상이거나 계약 위반, 심각한 보안 취약점, 테스트되지 않은 핵심 파일 변경 등이 있으면 '신중한 검토'로 분류됩니다. 검토자는 가장 위험도가 높은 파일부터 순서대로 읽고 검토를 완료하며, 점수가 내려가는 것을 보며 남은 위험도를 파악할 수 있습니다. 또한, 기능 플래그 뒤에 숨겨진 미완성 기능은 검토 목록에서 제외하여, 점수가 실제 사용자가 접할 부분만 반영하도록 합니다. API 변경 시 요청이나 응답의 형태가 바뀌면 '파괴적', '위험', '안전'으로 구분하고, 어떤 서비스가 해당 기능을 사용하는지 보여줍니다. farol은 검토자가 수동으로 테스트해야 할 계획을 새 기능부터 위험도가 높은 파일 순서로 정리해주는 작업 목록 형태로 제공합니다. farol은 무료이며 MIT 라이선스로 제공되고, 사용자의 컴퓨터나 자동 검사 환경에서 실행되며 코드를 실행하거나 외부로 전송하지 않습니다. farol은 이해하지 못한 코드를 안전하다고 임의로 넘기지 않고 '알 수 없음'으로 표시하여 신중한 검토를 요청하는 '닫힌 실패' 원칙을 따릅니다. 과거 분석 결과, '빠른 통과'로 분류된 커밋 중 56개는 전혀 문제가 없었고, 점수 성능 지표는 0.72에서 0.83 사이였습니다. 다만, 코드가 실행되는 도중에 결정되는 값이나 코드가 시작되는 지점을 알 수 없으면 위험도를 '알 수 없음'으로 표시하며, 호출 대상을 정확히 알 수 없을 때는 실제보다 더 넓게 위험도를 판단하는 경향이 있습니다.

일반 사용자 입장에서는 이 도구를 사용하는 소프트웨어의 전반적인 안정성과 품질이 높아질 가능성이 있습니다. 개발팀의 입장에서는 수십 개의 파일이 수정된 큰 변경 사항을 검토할 때, farol이 위험한 핵심 파일 몇 개를 먼저 지적해주기 때문에 검토자가 그 파일들에 집중하여 깊이 있게 읽고 나머지 파일은 빠르게 훑어보며 검토 시간을 효율적으로 사용할 수 있습니다. 다만, 이 도구를 사용하려면 개발 환경에 도입하고 설정하는 과정이 필요합니다. 또한, farol은 코드를 실제로 실행하는 것이 아니라 정적으로 분석하는 보조 도구이므로, 실제 시스템에서 발생할 수 있는 모든 상황을 100퍼센트 예측할 수는 없고 위험도를 '추정'한다는 점을 인지해야 합니다.