Claude Agent ACP 0.101: 세션 복원과 작업 관측은 다른 계약이다

편집기에서 대화가 다시 열렸다고 백그라운드 명령까지 올바르게 보인다는 뜻은 아닙니다. 세션 연속성과 실행 관측은 서로 다른 계약입니다. Claude Agent ACP 0.101.0의 변경 목록을 하나의 “복원 개선”으로 묶으면 어느 경로를 시험할지 놓치게 됩니다.

공식 0.101.0 릴리스는 11월 5일자입니다. 11월 9일 확인한 변경 기록에는 0.101.1과 0.102.0도 있습니다. 이 글은 브리핑 대상인 0.101.0의 변경을 분석하며 최신 버전 추천이 아닙니다. 런타임 실행은 하지 않았습니다.

유휴 압축은 무엇을 보존해야 하는가

PR #1522는 프롬프트 캐시가 만료되기 전에 유휴 세션을 압축하는 기능입니다. 대화 문맥 압축과 실행 중인 OS 프로세스 복원은 같은 기능이 아닙니다. 압축 후 요구사항·제약·파일 변경 정보를 충분히 유지하는지는 실제 작업으로 시험해야 합니다.

압축 전 작은 작업의 수용 기준과 미해결 항목을 남기고, 유휴 상태를 거친 뒤 다시 물어보세요. 같은 문장을 반복하는지만 보지 말고, 금지한 변경 범위와 아직 실패하는 검사를 정확히 인식하는지 확인하는 것이 유용합니다. 이는 제안한 회귀 시나리오이며 실행 결과가 아닙니다.

출력이 보이는 것과 명령이 성공한 것은 다르다

PR #1512는 v2 백그라운드 명령 출력을 스트리밍합니다. v1 편집기 연결에서 똑같이 동작한다고 가정할 수 없습니다. 로그 수신, 명령 종료, 종료 코드 표시를 나눠 시험해야 합니다.

편집기 ↔ ACP 어댑터 ↔ 에이전트 실행 환경
          ↑               ↓
       출력 이벤트 ← 백그라운드 명령

역할을 구분한 자체 도식입니다. 출력이 멈추면 프로세스가 끝났는지, 연결이 끊겼는지, 아직 출력이 없는지 구별해야 합니다. 로그 중간 메시지만 보고 성공 처리하면 긴 작업의 실패를 놓칩니다.

#1512의 src/acp-agent.ts diff에서 작업 종료 처리는 finishBackgroundTerminalOutput을 먼저 기다린 뒤 종료 이벤트를 보냅니다. followBackgroundTerminalOutput은 출력 파일 경로가 있는 터미널을 추적합니다. 즉 기존 최종 출력 한 덩어리를 예쁘게 표시하는 변경에 그치지 않고, 출력 파일을 따라가며 마지막 남은 출력을 종료 전에 전달하는 순서가 생깁니다. upstream 테스트에는 늦게 생기는 파일, UTF-8 문자 중간에서 나뉜 읽기, 파일 축소, 종료 후 읽기 중단 사례가 추가돼 있습니다. 테스트 코드를 검토했으며 실행하지 않았습니다.

기본 모드 변경은 설치 편의보다 먼저 검토한다

PR #1533는 새 세션의 기본을 Auto mode로 바꿉니다. #1520은 복원 시 이전 모드를 사용할 수 없으면 설정한 fallback을 따르도록 수정합니다. 모드 이름만으로 모든 도구의 권한을 추정하지 말고 편집기·어댑터·런타임 조합에서 실제 정책을 확인해야 합니다.

단일 파일 실행 파일은 #1524의 배포 변경입니다. 패키징 개선이 편집기 호환성이나 세션 데이터의 완전한 복구를 자동으로 보장하지는 않습니다.

업그레이드의 단위는 어댑터 하나가 아니다

회귀 기록에는 편집기 버전, ACP 프로토콜, 어댑터 버전, SDK·CLI, 운영체제를 함께 적어야 합니다. 오늘 추가 버전이 나왔다는 이유만으로 검증 없이 바로 교체하는 것도 피해야 합니다. 작업 로그의 중복·누락, 권한 fallback, 명령의 종료 상태를 통과 기준으로 삼으세요.

세션이 이어지는 경험을 원한다면 문맥 보존과 작업 상태 전달을 따로 평가해야 합니다. 이 구분은 체크포인트와 스트림 관측에도 적용됩니다. 0.101의 가치는 생산성 향상 수치보다 테스트할 수 있는 계약이 구체적으로 바뀌었다는 데 있습니다.