v0.27.0 — 코드 스크린 완성 및 편집 단위 diff와 git 범위 수락/폐기 기능 추가

게시물은 기능 구현의 구체적 기술적 선택과 안전성 조치 때문에 호응을 얻는 분위기였다. 많은 사용자가 before/after 캡처 방식의 정확성을 긍정했고 옵트인 설계와 git 범위 제한이 실사용에서 유용하다는 반응이 나왔다. 일부는 대안적 접근법으로 툴 레벨의 구조화된 diff 출력이나 스냅샷 기반 비교를 제안하며 성능·동시성 측면에서의 장단점을 지적했다.

• 실시간 편집 diff를 구현하려면 각 write 툴 호출 직전과 직후의 파일 내용을 디스크에서 읽어 unified diff를 생성하는 방식이 정확성을 보장한다는 점을 우선 고려하되, 소비자가 없을 때 추가 읽기를 피하도록 옵트인으로 처리해야 한다.
• git을 이용해 실행 결과를 부분적으로 되돌릴 때는 먼저 git ls-files로 추적된 파일 목록을 필터링하고 그 경로들만 git checkout으로 복원한 뒤 새로 생성된 파일을 git clean으로 제거하는 순서를 지켜 partial checkout 실패를 방지해야 한다.
• 병렬 처리나 고부하 환경에서는 툴이 구조화된 diff를 직접 내보내는 방식 또는 스냅샷 비교를 도입해 I/O 병목과 동시성 문제를 완화하는 방안을 검토할 필요가 있다.

Unified Diff

— 파일의 변경 전후를 텍스트 라인 단위로 비교해 표준 포맷으로 출력하는 방식이다. 본문에서는 difflib의 unified diff를 사용해 에이전트의 개별 편집 전후 차이를 줄 단위로 생성하는 데 활용된다. 변경의 가시화와 부분 롤백 또는 리뷰 워크플로에 직접 연결된다는 점에서 중요하다.

On-edit Event

— 에이전트 실행 루프에서 각 파일 쓰기 호출 직후에 발생하는 이벤트로, 해당 호출의 전후 상태를 캡처하고 후속 처리(예: diff 출력)를 트리거한다. 본문에서는 on_edit/edit 이벤트를 통해 CLI와 동일한 편집 스트림을 전달하도록 구성했다. 실시간 스트리밍과 옵트인 동작 제어에서 핵심 역할을 한다.

git ls-files

— 현재 레포지토리에서 Git이 추적하는 파일 목록을 출력하는 Git 명령어이다. 글에서는 revert(체크아웃) 시 추적된 파일만 필터링하기 위해 이 명령을 먼저 실행하여 불필요한 체크아웃 실패를 방지했다. 추적 범위를 기준으로 안전한 부분 롤백을 구현하는 수단으로 사용됐다.

Single-threaded Run Loop

— 에이전트가 순차적으로 툴 호출을 처리하는 실행 방식으로, 각 툴 호출의 전후 상태가 동시에 일어나지 않음을 보장한다. 본문에서는 이 특성이 있어 파일의 before/after 캡처가 정확한 시점의 상태를 반영한다고 명시됐다. 동시성 없이 정확한 변경 추적이 필요한 편집 스트리밍에 적합하다.