리뷰 요청이 120KB 상한을 넘었는데 린트는 전체 파일만 받았다: 범위 형식으로 풀다 git의 따옴표 경로에 걸린 기록
리뷰 요청 크기 상한과 '테스트 파일 전체를 넣어라'는 린트 규칙이 부딪쳐 변경 구간과 앞뒤 40줄만 보내는 범위 형식을 만들었다. 시험 173개가 통과한 뒤에도 git이 따옴표로 감싼 한글 경로에서는 변경 구간이 조용히 사라졌다.

AI 에이전트가 만든 변경을 다른 벤더 모델에게 검토시키는 요청 파일이 크기 상한을 넘었다. 그런데 요청 파일 린트는 변경된 테스트 파일을 통째로 넣으라고 요구했다. 나는 변경 구간과 그 앞뒤 40줄만 보내는 범위 형식으로 이 충돌을 풀었다. 그 구현은 테스트 173개를 모두 통과했다. 하지만 git이 따옴표로 감싸 출력하는 한글 경로에서는 변경 구간을 하나도 찾지 못했고, 오류도 경고도 내지 않았다. 이 글은 그 충돌과 결함, 그리고 아직 남은 한계를 다룬다. 리뷰 모델의 품질 비교나 요청 파일 형식 전체 설명은 다루지 않는다.
여기서 요청 파일은 내 리뷰 요청 도구가 만드는 텍스트 묶음이다. 이하 패킷이라고 부른다. 패킷에는 변경된 파일 내용, diff, 실행 로그, 기준 문서가 들어간다. 작성자와 검토자를 서로 다른 벤더로 두는 구성 자체는 교차 검증을 처음 세우는 법에 따로 정리했다. 이 글의 모든 수치는 2026년 11월 초에 내 리뷰 요청 도구를 고친 작업의 기록에서 가져왔다. 이 블로그의 파일 수나 테스트 수가 아니다.
120,000바이트 상한과 "파일 전체" 규칙이 부딪친 날
패킷에는 사전 검사 상한이 있다. 요청이 120,000바이트를 넘으면 보내기 전에 막힌다. 이 상한은 검토자에게 드는 비용을 묶어 두려고 둔 값이다. 한편 패킷 린트에는 규칙 L1이 있었다. L1은 변경된 테스트 파일마다 files/<경로> 항목에 파일 전체가 들어 있어야 한다고 요구했다. 검토자가 시험 하나를 판단할 때 같은 파일의 다른 시험을 볼 수 있어야 한다는 취지다.
두 규칙은 큰 테스트 파일을 만나기 전까지 부딪치지 않았다. 기록에 따르면 한 테스트 PR의 요청은 파일 전체 형식으로 만들었을 때 219,233바이트였다. 상한의 거의 두 배다. 작성 에이전트가 변경 구간만 남겨 줄인 패킷은 158,782바이트였는데, 이번에는 L1이 거부했다. 전체 파일 항목이 없다는 이유였다. 줄인 패킷도 상한 아래가 아니었다는 점이 기록에 그대로 남아 있다. 결국 그 실행은 전체 파일 패킷을 보냈고, 상한 초과는 편차로 기록했다.
| 요청 | 크기(바이트) | 상한 120,000 대비 | 처리 |
|---|---|---|---|
| 테스트 PR, 파일 전체 형식 | 219,233 | 초과 | 편차를 기록하고 전송 |
| 같은 PR, 변경 구간만 줄인 패킷 | 158,782 | 초과 | L1이 거부 |
| 같은 실행의 다른 슬라이스 1 | 148,757 | 초과 | 편차로 기록 |
| 같은 실행의 다른 슬라이스 2 | 166,670 | 초과 | 편차로 기록 |
한 실행에서 네 번이나 상한을 넘었다면 우연한 예외로 볼 수 없다. 나는 이 충돌을 이슈로 등록했다. 같은 날 다른 실행에서 해결 슬라이스로 다루기로 했다. 상한을 지키라는 규칙과 파일 전체를 넣으라는 규칙이 같은 입력에서 동시에 지켜질 수 없다면, 둘 중 하나의 조건을 정확히 다시 써야 한다.
상한을 올리거나 리뷰를 쪼개지 않은 이유
설계 노트에는 세 안이 남아 있다. 처음 떠오르는 해법은 상한을 올리는 것이다. 나는 이 안을 버렸다. 219,233바이트는 어느 정도 완만하게 올린 상한으로도 여전히 넘는다. 상한을 옮기면 다음 큰 파일에서 같은 충돌이 다시 난다. 충돌을 없애는 것이 아니라 충돌 지점을 미루는 것이다.
두 번째 안은 리뷰를 파일별이나 평가 항목별로 쪼개는 것이다. 내 점수 게이트는 테스트 단계의 평가 항목 다섯 개를 한 리뷰 JSON에서 모두 요구한다. 항목은 coverage, assertions, edge_cases, isolation, regression이다. 리뷰를 쪼개려면 게이트를 고쳐야 한다. 또 산출물 하나에 리뷰가 여러 개 생겨서, 어느 리뷰가 어느 판단을 책임지는지 흐려진다.
세 번째 안을 골랐다. 빌더에 --range PATH 옵션을 두고 여러 번 쓸 수 있게 했다. 선언한 테스트 파일은 files/PATH 대신 두 종류의 항목으로 보낸다. 하나는 변경 구간마다 앞뒤 40줄 여유를 붙인 context/PATH:S-E 항목이다. 다른 하나는 파일 전체의 테스트 이름 목록인 names/PATH다. 이 안을 고른 이유는 하나다. 점수 게이트가 context/<경로>:S-E 키에 대해서는 원본 줄 번호 인용을 이미 받아 주고 있었다. 그래서 게이트를 바꾸지 않아도 되고 리뷰도 하나로 유지된다.
| 안 | 바꿔야 하는 것 | 남는 위험 | 결정 |
|---|---|---|---|
| A. 테스트 리뷰용 상한 인상 | 상한 값 | 더 큰 파일에서 같은 충돌 재발, 검토 비용 증가 | 버림 |
| B. 파일·평가 항목별 리뷰 분할 | 점수 게이트, 리뷰 수 | 산출물 하나에 리뷰 여러 개, 책임 분산 | 버림 |
C. --range 범위 형식 | 빌더, 린트 L1·L2 | 검토자가 바뀌지 않은 시험 본문을 덜 봄 | 채택 |
세 안의 차이를 두 열로 나누어 그려 보면 범위 형식이 무엇을 지키고 무엇을 내주는지가 드러난다.
설계 노트는 비용도 세어 두었다. 두 스크립트에 약 170줄이 들고 새 의존성은 0개다. 도구가 크기를 보고 범위 형식을 자동으로 고르는 변형도 검토했다. 나는 그 변형을 지금은 하지 않기로 했다. 기존의 큰 패킷이 운영자 모르게 다른 형식으로 바뀌기 때문이다. 범위 형식은 운영자가 --range로 선언했을 때만 쓴다.
범위 형식의 규칙: 40줄 여유, 합치기, 이름 목록
범위는 git diff -U0 base...head -- PATH의 새 쪽 구간에서만 계산한다. -U0은 문맥 줄 없이 변경된 헌크만 내라는 뜻이다. git-diff 문서는 이 옵션을 다음과 같이 설명한다.
Generate diffs with <n> lines of context
문맥을 git에 맡기지 않은 이유는 여유 폭을 도구가 직접 정하고 검사하기 위해서다. 규칙은 다음과 같다.
- 변경 구간 [s, e]가 덮는 범위는 [max(1, s−40), min(N, e+40)]이다. N은 파일의 줄 수다.
- 겹치거나 맞닿은 범위는 하나로 합친다.
- 삭제만 있는 헌크는 그 위치의 한 줄로 본다.
- 헌크 머리에 개수가 없으면 1로 읽는다. 한 줄짜리 헌크는 시작 줄 번호만 나오기 때문이다.
diff 실행부터 린트 검사까지의 여섯 단계는 아래 흐름도에 순서대로 정리했다.
네 번째 규칙은 GNU diffutils의 통합 형식 설명과 같다. 그 문서는 이렇게 적는다.
If a hunk contains just one line, only its start line number appears.
린트 L1이 범위 형식을 받아 주는 조건도 네 가지로 좁혔다.
- 대상이 테스트 클래스 파일이어야 한다.
- 같은 요청을 전체 파일 형식으로 만들면 120,000바이트를 넘어야 한다. 넘지 않으면
L1 range form below the 120000-byte cap으로 거부한다. 범위 형식을 상한 회피 수단으로 쓰지 못하게 하려는 조건이다. - 다시 계산한 모든 변경 구간이 앞뒤 40줄 여유까지 하나의
context항목 안에 들어 있어야 한다. names/PATH항목이 있어야 한다.
로더는 패킷 안에 실린 diff를 믿지 않는다. git에서 변경 구간을 다시 계산한다. 그다음 규칙 L2가 두 가지를 비교한다. 첫째, context 항목이 HEAD 본문의 같은 줄 범위와 똑같은지 본다. 둘째, names/PATH가 정해진 추출 규칙의 결과와 같은지 본다. 셸 시험은 check "…" 꼴의 줄을 뽑는다. 그 밖의 언어는 test/it/describe("…")의 제목을 뽑는다. 추출 규칙 밖의 형식까지 이름을 다 찾는다고 주장하지는 않는다.
시험 설계는 극단적인 파일 하나와 통제군 하나로 잡았다. 큰 파일은 check "big case K" true 줄 5,000개로 만들었고 크기는 133,893바이트다. 전체 형식으로는 상한을 넘는다. 100번째와 3,000번째 줄을 바꾼 헤드를 만들고 기대 범위를 60-140과 2960-3040으로 고정했다. 통제군은 상한 아래의 작은 파일이다. 같은 선언을 하면 거부돼야 한다. 계획 단계에서 정한 RED 단언은 13개였다.
시험 리뷰가 잡은 것: RED가 서로 독립적이지 않았다
시험 PR의 첫 RED는 겉으로는 깔끔했다. 의도한 단언 실패 19개가 기대 실패 목록 19개와 일치했고 CI도 성공했다. 그런데 다른 벤더의 시험 리뷰어가 이 시험을 실패시켰다. 점수는 assertions 4, coverage 4, edge_cases 5, isolation 6, regression 8이었고 차단 사유는 4개였다.
- 두 변경 줄이 멀리 떨어진 시험만 있었다. 그래서 겹치거나 맞닿은 범위를 합치지 않는 구현도 통과한다.
- 5,000개짜리 이름 목록을 개수와 세 위치로만 검사했다. 순서가 바뀌거나 다른 이름으로 바뀌어도 통과한다.
- 로더가 git에서 구간을 다시 계산한다는 설계를 시험이 확인하지 않았다. 패킷 안의 diff를 조작해도 통과할 수 있다.
- 기준선 실행이
--range인자 자체를 모른다는 오류를 먼저 냈다. 그래서 범위 생성, 린트, 본문 동작의 RED가 서로 독립적이지 않았다.
네 번째 지적이 가장 중요했다. 19개 실패가 목록과 맞았어도, 그 실패의 상당수는 같은 원인 하나에서 나왔다. 알 수 없는 인자 오류가 나면 뒤의 단언은 무엇을 검사하든 같이 실패한다. 실패 개수가 맞는다는 사실이 각 단언이 자기 동작을 검사한다는 증거는 아니었다. 검증자의 지적을 원본과 대조하는 절차는 AI 검증자의 지적을 그대로 고치면 안 되는 이유에 따로 썼다. 이번 지적은 대조해 보니 네 개 모두 시험 코드에서 그대로 확인됐다.
정정은 한 번으로 끝냈다. 기준선에 승인된 스텁을 두었다. 기준선은 --range를 받아서 무시하고, 이름 목록 함수는 빈 목록을 돌려준다. 이렇게 하면 RED가 "알 수 없는 인자" 오류가 아니라 각 단언의 실패로 나온다. 기록에는 내 실수도 하나 남아 있다. 첫 커밋 전의 RED 로그 하나가 실수로 지워져 남아 있지 않다. 정정 커밋 전후의 RED 기록은 남아 있다.
173개가 통과했는데 한글 경로 파일이 사라졌다
구현 뒤의 수치는 모두 초록색이었다. pr-packet 시험 173/173이 통과했고 셸 시험 89개도 통과했다. 린트도 통과했고 CI도 green이었다. 그런데 다른 벤더의 로직 리뷰어가 correctness 5, coverage 6으로 실패시키며 차단 사유 1개를 냈다.
요지는 이렇다. git은 경로에 비ASCII 문자나 특수문자가 있으면 +++ 헤더의 경로를 큰따옴표로 감싸 출력한다. 구현은 +++ b/로 시작하는 줄만 경로로 인식했다. 따옴표로 시작하는 헤더는 경로가 None이 되고, 그 뒤의 헌크는 버려졌다. 큰 테스트 파일 이름이 한글이면 --range가 빈 범위를 만든다. 린트도 빈 구간을 검사하니 누락을 통과시킨다. 기존 시험 사례의 경로가 모두 ASCII여서 아무도 잡지 못했다.
이 동작은 2026-11-14에 스크래치 저장소에서 다시 재현했다. git은 2.54.0(Apple Git-157)이다. 200줄짜리 셸 시험 파일 두 개를 만들고 두 파일의 100번째 줄을 바꿨다. 한 파일은 tests/plain.test.sh이고, 다른 파일은 한글과 공백이 든 tests/한글 x.test.sh다. 아래는 git diff -U0 HEAD~1...HEAD의 헤더 줄만 추린 출력이다. <TAB>은 실제 탭 문자를 표시한 것이다.
diff --git a/tests/plain.test.sh b/tests/plain.test.sh
--- a/tests/plain.test.sh
+++ b/tests/plain.test.sh
@@ -100 +100 @@ check "c98" true
diff --git "a/tests/\355\225\234\352\270\200 x.test.sh" "b/tests/\355\225\234\352\270\200 x.test.sh"
--- "a/tests/\355\225\234\352\270\200 x.test.sh"<TAB>
+++ "b/tests/\355\225\234\352\270\200 x.test.sh"<TAB>
@@ -100 +100 @@ check "c98" true
출력에서 세 가지를 볼 수 있다. 한글은 UTF-8 바이트별 8진 이스케이프로 바뀌었다. 경로 전체가 큰따옴표로 감싸졌다. 공백이 있는 경로에는 헤더 끝에 탭 한 개가 붙었다. 앞의 두 가지는 git-config 문서의 core.quotePath 항목이 설명한다. 그 문서는 0x80보다 큰 바이트를 8진 이스케이프로 쓰고, 기본값은 true라고 적는다. 공백에 대해서는 다음 문장이 있다.
A simple space character is not considered "unusual".
즉 공백만 있는 경로는 따옴표로 감싸지지 않는다. 이번 경로가 감싸진 이유는 한글 바이트 때문이다. diff 출력 형식 문서도 패치의 경로 표기가 같은 core.quotePath 규칙을 따른다고 적는다. 끝에 붙는 탭에 대한 설명은 내가 읽은 문서 범위에서는 찾지 못했다. 탭은 재측정 출력에서만 확인한 사실이다.
정정 전과 후의 파서를 같은 diff에 돌린 결과는 다음과 같다. 정정 전 결과는 수정 직전 커밋의 changed_spans를 그대로 실행한 것이다. 이 값들은 2026-11-13에 같은 조건으로 재측정한 기록이다.
정정 전, 기본 설정 diff:
{'tests/plain.test.sh': [(100, 100)]}
정정 후, 기본 설정 diff:
{'tests/plain.test.sh': [(100, 100)], 'tests/한글 x.test.sh': [(100, 100)]}
정정 후, diff.noprefix=true diff:
{}
정정 전에는 한글 경로 파일이 결과에서 통째로 빠진다. 예외도 경고도 없다. 정정은 한 번으로 끝냈다. 작성 에이전트가 header_path라는 순수 함수를 추가했다. 이 함수는 따옴표로 감싼 경로의 C 방식 이스케이프를 푼다. 대상은 \a \b \t \n \v \f \r \" \\와 \ooo 8진 바이트다. 풀어낸 바이트열은 UTF-8로 해석한다. 헤더 끝의 탭은 경로에서 뗀다. 200줄 파일에서 구간 (100, 100)이 덮는 범위는 (60, 140)이 된다. 정정 뒤 pr-packet 시험은 173 passed, 0 failed였다. 정정 전과 개수가 같은 이유는 시험을 바꾸지 않았기 때문이다.
| diff 설정 | 한글 경로 +++ 헤더 모양 | 정정 전 | 정정 후 |
|---|---|---|---|
| 기본값 | +++ "b/tests/\355…"와 끝 탭 | 한글 파일 누락, 경고 없음 | 두 파일 모두 (100, 100) |
core.quotePath=false | +++ b/tests/한글 x.test.sh와 끝 탭 | 측정 안 함 | 측정 안 함 |
diff.noprefix=true | +++ "tests/\355…"와 끝 탭, a/·b/ 없음 | 측정 안 함 | 빈 결과 {}, 경고 없음 |
core.quotePath=false를 쓰면 한글이 따옴표 없이 나온다. 하지만 공백 때문에 붙은 끝 탭은 그대로다. 이 설정은 사용자 환경마다 다르기 때문에 도구가 가정할 수 없다. 이 판단은 추정이다. 기록에는 정정의 빈틈도 남았다. 시험은 시험 작성자의 소유라서 정정에는 전용 새 시험이 없다. 작성 에이전트는 scratch 점검으로 한글과 공백이 든 경로에서 100번째 줄 헌크가 60-140이 되는 것만 확인했다. 기록은 이 상태를 "회귀 시험 없음"으로 적었다.
같은 작업에서 다른 문제도 둘 있었다. 형제 도구의 build 명령이 한 번 JSON 디코드 오류로 실패해서 리뷰 요청을 손으로 만들었다. 원인은 확인하지 못했고 이슈로 추적한다. 빌더가 .rs 경로를 분류하지 못해 논리 패킷을 직접 만든 일도 있었다. 이것도 이슈로 추적한다.
아직 열려 있는 구멍
결론보다 한계를 먼저 적는다. 위 표의 마지막 줄이 지금 남은 가장 큰 구멍이다. 정정 뒤의 파서도 diff.noprefix=true 설정의 diff를 받으면 빈 결과를 낸다. 두 파일 모두 사라지고 예외도 경고도 없다. git-config 문서는 이 설정을 이렇게 설명한다.
If set, git diff does not show any source or destination prefix.
파서는 b/ 접두사를 경로의 표지로 쓰고 있으니, 접두사가 없으면 경로를 얻지 못한다. 문제는 그다음이다. 구간이 비면 덮이지 않은 구간도 없으므로 린트가 조용히 통과한다. 사실로 확인된 한계는 다음과 같다.
- 헤더 경로를 해석하지 못하면 린트가 통과한다. 기록과 2026-11-13 재측정이 일치한다.
- 따옴표 경로 정정에 전용 회귀 시험이 없다.
--range관련 셸 시험 일부(L10/L11 건너뜀)와test.each제목 추출 같은 세부 사항은 열린 이슈로 남았다.- 범위 형식에서 검토자는 바뀌지 않은 시험 본문을 덜 본다. 앞뒤 40줄 여유, 전체 diff, 전체 이름 목록이 이를 보완하지만, 검토는 그 범위 안에서만 이뤄진다. 이것은 설계 노트의 위험 평가다.
- 범위 형식이 리뷰 품질을 높였는지는 측정하지 않았다. 확인한 것은 시험과 린트의 통과, 그리고 패킷 구조뿐이다.
파서가 경로나 구간을 하나도 얻지 못한 결과를 "검사할 것이 없음"으로 읽으면, 검사기는 입력을 잃어버린 순간에 가장 확실하게 통과한다.
diff를 파싱하는 도구에 권하는 점검
여기부터는 권장이다. 아래 내용은 이번 작업에서 실행해 검증한 결과가 아니다.
- 경로를 이미 알고 있다면 파일 하나씩
git diff -U0 base...head -- <경로>를 실행하는 편이 낫다. 그 출력의 헌크를 아는 경로에 바로 붙이면 헤더를 해석할 필요가 없다. 이 방법은 시험 리뷰어가 제안한 해법 중 하나였다. 이번 구현은 대신 헤더 경로를 해석하는 쪽을 택했고, 그 선택이diff.noprefix같은 설정에 깨진다. - 경로 목록은
git diff --name-only -z처럼 NUL로 구분해 받는 편이 낫다. git-config 문서는-z를 쓰면 경로를 그대로 출력한다고 적는다. 이번 도구의changed_paths는 이미 이 방식이다. - 선언한 파일에서 구간을 하나도 얻지 못하면 "통과"가 아니라 "해석 실패"로 끝내는 편이 낫다. 빈 입력은 거부하는 쪽이 안전하다. 이번 도구에는 아직 이 검사가 없다.
- 시험 경로에 한글, 공백, 따옴표가 든 사례를 하나씩 두는 편이 낫다. 이번 결함은 모든 사례가 ASCII였기 때문에 173개 시험을 지나갔다.
비슷한 하네스 도구 기록은 프로그래밍 카테고리에 모아 두었다.
AI 사용 공개
이 글이 다룬 빌더와 린트 변경은 내가 지시한 작성 에이전트가 만들었고, 다른 벤더의 리뷰 모델이 시험과 로직을 검토했다는 것이 기록의 사실이다. 이 글의 초안은 Claude 모델이 작업 기록과 재측정 출력을 바탕으로 썼다. 2026-11-14의 스크래치 저장소 재현도 같은 모델이 실행했고, 사실과 수치는 기록 원문과 재측정 출력에 대조했다. 사람이 따로 검수했다는 주장은 하지 않는다.
자주 묻는 질문
패킷 크기 상한을 그냥 올리면 안 되나요?
기록된 요청 하나가 219,233바이트였다. 완만하게 올린 상한으로는 여전히 넘는다. 상한은 검토 비용을 묶으려고 둔 값이라, 올리면 충돌 지점만 다음 큰 파일로 미뤄진다.
범위 형식을 작은 파일에도 쓸 수 있나요?
쓸 수 없다. 같은 요청을 전체 파일 형식으로 만들었을 때 120,000바이트를 넘지 않으면 린트가 거부한다. 범위 형식이 상한 회피 수단이 되지 않게 하려는 조건이다.
core.quotePath=false로 설정하면 문제가 사라지나요?
한글은 따옴표 없이 나오지만 공백 때문에 붙는 헤더 끝 탭은 그대로 남는다. 이 설정은 사용자 환경마다 달라 도구가 가정할 수 없다. 경로를 이미 알고 파일별로 diff를 돌리는 편이 덜 취약하다는 것이 내 판단이다.
지금 남은 가장 큰 위험은 무엇인가요?
diff.noprefix=true 설정의 diff에서는 정정 뒤의 파서도 빈 결과를 내고, 린트는 경고 없이 통과한다. 따옴표 경로 정정에도 전용 회귀 시험이 아직 없다.
참고한 자료
- git-config 문서:
core.quotePath의 따옴표·8진 이스케이프 규칙, 공백 예외,-z,diff.noPrefix설명 (조회 2026-11-14) - git diff-format 문서: 패치 경로가
core.quotePath규칙으로 인용된다는 설명 (조회 2026-11-14) - git-diff 문서:
-U<n>문맥 줄 옵션 (조회 2026-11-14) - GNU diffutils, Detailed Description of Unified Format: 한 줄 헌크의 줄 번호 표기 (조회 2026-11-14)
아직 댓글이 없습니다.