head-1-diff-shows-only-the-last-commit

name	head-1-diff-shows-only-the-last-commit
description	"무엇이 바뀌었나"를 `git diff HEAD~1 HEAD` 로 만들어 LLM 판사·리뷰봇·알림·딜리버러블에 넣으면, 에이전트가 커밋을 두 번 이상 한 순간 **첫 커밋들이 통째로 사라진다.** 파일 목록은 맞는데 내용이 0바이트라 "파일이 없다/검증할 수 없다"는 오판이 나온다. 트리거 - `git diff HEAD~1`, `HEAD^..HEAD`, 판사/리뷰어에게 보낼 컨텍스트 조립, "코드를 볼 수 없습니다" 반복 거절, 커밋 여러 개 만드는 에이전트 루프.

HEAD~1..HEAD 는 "이 작업의 변경"이 아니라 "마지막 커밋"이다

Problem

에이전트/파이프라인이 만든 변경을 사람이나 LLM 에게 보여줄 때 흔히 이렇게 쓴다:

result = await box.exec(f"git -C {mount} diff HEAD~1 HEAD -- {path}")

• 증상: 판사·리뷰어가 "실제 파일 내용이 캡처되지 않았습니다", "코드 수준에서 검증할 수 없습니다" 라며 반복 거절한다. 그런데 파일은 분명히 있고, 같은 레코드의 다른 검사(scope 등)는 파일 8개를 정상적으로 세고 있다.
• 근본 원인: 에이전트 루프는 턴마다 커밋한다. HEAD~1..HEAD 는 그중 마지막 하나만 보여준다. 첫 커밋에서 만든 파일은 diff 가 0 바이트다.

실측 (prod 워크스페이스, 커밋 3개짜리 런):

파일	HEAD~1..HEAD	실제 변경(base..HEAD)
stream_consumers.py (새 모듈 전체)	0 B	5,752 B
test_..._decomp.py (요구사항 본체)	0 B	2,390 B
run.py (마지막 커밋에서 손댐)	714 B	714 B

작업의 본체 두 개가 존재하지 않는 것처럼 보인다. 곁가지 하나만 보인다.

• 흔한 오해 1: "blob 폴백이 있으니 괜찮다." → 폴백은 diff 가 하나도 안 나올 때만 돈다. 한 경로라도 diff 가 나오면 나머지는 조용히 빠진 채 반환된다.
• 흔한 오해 2: "거절이 반복되는 건 모델이 까다로워서다." → 아니다. 판정 문제가 아니라 관측 문제다. 판사를 바꾸거나 프롬프트를 달래도 안 고쳐진다.

Solution

1. 작업 시작 시점의 base 를 한 번 잡아 저장하라. 에이전트가 커밋하면 HEAD 가 움직여서 나중에는 복구 불가다.

   # 루프 최상단에서 단 한 번
   res = await box.exec("git rev-parse HEAD")
   baseline = res.stdout.strip() or None   # 지어내지 말고 None
   

2. diff 는 그 base 대비로. git diff <baseline> HEAD -- <path>. base 를 못 잡았으면 diff 를 건너뛰고 blob 폴백으로 — 틀린 창을 쓰느니 없는 게 낫다.
3. 부분 성공을 성공으로 반환하지 마라. 요청한 N 경로 중 M(<N) 만 내용이 나왔으면 그 사실을 컨텍스트에 명시하라. 조용히 빠지면 소비자는 "그 파일은 안 바뀌었다"로 읽는다.
4. 못 봤을 때는 판정하지 말고 cannot_determine 으로. 단, 이건 증상 봉합이다. 왜 못 봤는지를 따로 고쳐라 — 정직한 무판정이 관측 결함을 없애주지는 않는다.

진단법 — 코드만 읽지 말고 그 코드가 남긴 데이터로 반증하라

(no file content captured) 를 grep 해서 "written_paths 가 빌 때만 나온다"고 결론냈다가, 같은 검증 레코드의 scope.candidates = 8 에 반증당했다. 경로는 있었고 판사에게 가는 경로만 비어 있었다.

• 같은 레코드 안의 다른 소비자가 같은 입력을 어떻게 봤는지 비교하라. 한쪽은 보고 한쪽은 못 봤다면, 입력이 아니라 그 소비자의 조립 경로가 범인이다.
• 그리고 읽는 코드가 현재 버전인지 확인하라. 사건 당시 배포된 커밋과 지금 main 이 다르면 코드 판독은 사건을 설명하지 못한다.

Key Insights

• "파일 목록은 맞는데 내용이 비었다"는 거의 항상 diff 창(revision range) 문제다. 파일 추적(written_paths) 은 멀쩡한데 렌더링만 굶는다.
• 에이전트 루프는 사람처럼 한 번 커밋하지 않는다. 사람 기준으로 짠 리비전 범위는 에이전트 앞에서 무너진다. 커밋 개수를 가정하지 마라.
• 인프라가 에이전트를 눈멀게 하면 에이전트는 우회하지 않고 같은 실패를 무한 반복한다. 한 런이 46번 거절당한 원인이 이것이었다.