34장. 계약 변경·SDK Upgrade

공급자 SDK major upgrade를 직접 business code에 합치지 않고 adapter branch에서 비교한다. lockfile, transitive dependency, required runtime, network endpoint, default timeout/retry, serialization, error type, telemetry를 diff한다.

기존 contract fixture를 old/new adapter에 동일 실행한다. additive field는 허용하되 required field 삭제·type 변경·error semantic 변경을 막는다. sandbox뿐 아니라 synthetic production canary와 webhook callback을 확인한다.

릴리스는 provider/operation별 traffic을 작게 옮기고 success, p95, 429, unknown outcome, cost를 비교한다. rollback은 SDK package만이 아니라 config·credential·webhook schema의 호환성을 포함한다.