[LivingLikeKrillin]

개요

결함을 관측할 수 없는 Orbit 기체 연동 시 스냅숏 부재로 인해 발생하는 리빌드 거부 및 연결 끊김 감지 누락 등의 영향을 분석하고 한계 문서에 반영합니다.
소유자 결정에 따라 당장의 계약 수정 대신 소비자 배포 요청 시 처리를 위한 유예 방안을 정의하고 관련 문서를 보강합니다.

주요 변경 사항

1. 결함 미관측 기체의 스냅숏 부재 영향

• OrbitAdapterTest 시험으로 고정되었듯 Orbit 어댑터 호스트는 결함 관측 불가(FaultObservation.NotObservable)에 따라 faultsObservable = false로 설정하고 getSnapshot에서 Status.UNAVAILABLE 예외를 던지며, ClientRobotPort.snapshot은 이를 null로 축약함
• 미들웨어 sync는 기체 뷰를 미관측 상태로 표시하여 재생를 건너뛰고, 연결 끊김 검사가 실행되지 않아 LINK_BROKEN이 발생하지 않음
• 결함 게이트는 실행을 차단하지 않고 결함 미관측을 1회 기록하지만, 리빌드(resume)는 스냅숏이 null일 때 RESUME_SNAPSHOT_UNREADABLE로 거부되어 picasso-ops가 DEFERRED 상태로 매 pump 무한 재시도함
• 리빌드 후 취소 부착은 스냅숏을 읽지 못할 때 기한 없이 대기하며, 실행 중 플릿 링크 단절 시 poll이 마지막 상태를 반환하여 정체 알림(PROGRESS_STALLED, 기본 300초)으로만 표출됨

2. 소유자 결정 및 연기된 해결 방안

• 2026-10-19 소유자 결정(항목 11)에 따라 당장 계약을 상향하지 않고 소비자 게이트 한계 행으로 관리하기로 결정
• 지연된 해결책인 옵션 A로 차기 계약 0.10.0의 GetSnapshotResponse에 결함 관측 열거형을 추가하고, 기존 발신자의 의미 보존을 위해 UNSPECIFIED를 관측됨으로 해석하도록 설계
• 어댑터 호스트가 Status.UNAVAILABLE 대신 NOT_OBSERVABLE과 빈 결함 필드로 태스크와 연결 정보를 반환하게 하여 리빌드, 취소 부착, 연결 끊김 감지가 동작하도록 유예
• 어댑터 호스트가 결함 없음을 거짓 보고하는 옵션 C는 결함 없는 기체로 허위 판단하므로 배제

3. 한계 행 신설 및 벤더 문서 반영

• docs/limits.md에 소비자 게이트 한계(§15.241 결함 못 보는 기체의 스냅숏) 및 외부 한계(§15.241 Orbit 기체 연결·결함 표면) 행 2건 추가
• OpenAPI 5.0.0 사양 및 공식 Python 클라이언트(323개 심볼) 조사 결과 Robot 스키마에 결함 및 연결 필드가 없음을 확인하고 부재 여부를 미상(UNKNOWN)으로 명시
• docs/vendors/orbit.md 미결 항목 6번을 신설하여 두 한계 항목과 연결하고 실제 인스턴스 검증 과제로 설정
• 코드, 계약 proto, SemVer 0.9.0, 작업 응답 형식, 내보내기 버전 변경 없는 순수 문서 변경으로 제한

검증 결과

• 문서 반영 뒤 :gate:test 277건, :picasso:test 580건 통과(실패 0, JUnit XML)
• 코드 변경이 없어 새 시험은 없음

🤖 Generated with Claude Code