v0.26.0 배포: verify-or-revert 기반 코드 편집 화면 추가

원문에는 댓글이나 커뮤니티 반응이 포함되어 있지 않아 실제 토론의 방향성은 게시물 본문과 질문에만 의존한다.

• 에이전트 실행 결과를 정확하게 기록하려면 실행 전후의 파일 스냅샷을 캡처하고 이들 스냅샷을 difflib로 비교해 per-file unified diff를 생성하는 방식이 유효하다. 이 방식은 git 저장소 유무에 의존하지 않으므로 로컬 폴더 전체에서 재현 가능한 변경 기록을 얻을 수 있으며 감사 및 디버깅에 바로 활용할 수 있다. 또한 되돌려진 실행에 대해서는 워크스페이스를 롤백하되 diff를 보존하고 UI에서 'attempted'로 명시하면 변경 시도와 실제 적용을 분리해 투명성을 유지할 수 있다.
• 명령 실행 환경은 PTY를 제공하지 않고 각 명령을 독립 서브프로세스로 실행해 cwd와 env가 지속되지 않도록 설계해야 샌드박스 보안과 재현성을 유지할 수 있다. 이 접근은 인터랙티브 세션을 흉내 내는 것을 방지해 에이전트가 사용자 환경을 오도하는 위험을 낮춘다. 샌드박스 설정은 명령별로 엄격히 적용하고 로그에 실행 결과와 diff를 병기해 문제 발생 시 원인을 추적하도록 구성하는 것이 바람직하다.

difflib

— 파이썬 표준 라이브러리의 한 모듈로서, 두 텍스트 버전의 차이를 라인 단위 unified diff 형태로 계산해 출력하는 기능을 제공한다. 이 글 맥락에서는 에이전트 실행 전후의 파일 스냅샷을 비교해 '이 실행에서 실제로 변경된 것'을 정확히 기록하는 데 사용되었다. git 저장소가 아니어도 폴더 전반에 대해 동일한 방식으로 동작하기 때문에 구현 범용성이 핵심이었다.

Unified diff

— 두 파일 버전의 변화를 맥락 라인과 함께 한 눈에 보여주는 텍스트 기반의 패치 포맷으로, 변경 구간(hunk)과 문맥을 포함해 인간이 읽기 용이한 형태로 표현한다. 이 글에서는 실행 단위 스냅샷을 비교해 해당 실행에 한정된 정확한 diff를 만들기 위해 사용되었다. git diff와 달리 저장소 여부에 의존하지 않고 파일 전후 스냅샷으로 생성할 수 있다는 점이 중요했다.

PTY

— 프로세스에 인터랙티브한 터미널 특성을 제공하는 가상 장치로서, 서브프로세스가 실제 사용자 입력/출력을 터미널처럼 처리하도록 만든다. 게시물에서는 PTY를 만들지 않고 각 명령을 독립적인 서브프로세스로 실행해 cwd와 env가 지속되지 않도록 한 점을 보안 및 재현성 관점에서 설명했다. PTY 미사용은 인터랙티브 세션을 가장하는 행위를 방지하고 샌드박스 제약을 준수하기 위한 기술적 선택이었다.

verify-or-revert

— 에이전트가 폴더를 수정한 뒤 별도의 검증 단계에서 변경을 승인하지 않으면 작업 공간을 원상복구하는 워크플로로서, 승인 실패 시 변경 시도는 디스크에 남기지 않고 내부 기록으로만 보존한다. 본문에서는 이 워크플로가 존재하기 때문에 '되돌려진 실행'에 대한 diff를 어떻게 표현할지(숨길지, 시도된 것으로 표시할지)가 핵심 UX 문제로 제시되었다. 기록 방식은 감사·투명성 요구와 사용자 신뢰에 직접적인 영향을 미쳤다.