Files
clean-architecture-frontend…/SPEC.md
T
DongHyeonkaandClaude Opus 5.5 b95314245d docs: plan round 2 of the src review fixes
Add Q-requirements for every recommended/minor review finding plus the
round-1 follow-ups (SW fetch scope, bundle budget), decisions D-11..D-16,
and tasks T51-T115 across the same nine lanes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:00:41 +09:00

21 KiB
Raw Blame History

SPEC: src 리뷰(2026-09-24) 긴급·필수 항목 수정

목적

docs/reviews/2026-09-24-src-full-review.md의 긴급 1건 + 필수 46건을 고친다. 권장·사소 항목은 이번 범위가 아니다.

각 요구사항 ID(R-x.y)는 리뷰 문서의 섹션 번호(6.x-y)와 같다. 문제 설명, 근거 코드, 실패 시나리오는 리뷰 문서를 기준으로 한다. 이 문서에는 무엇이 되면 완료인지와 방향이 여러 개인 항목의 결정만 적는다.

범위 밖

  • 리뷰의 권장·사소 항목. 단, 같은 코드 줄을 고치다가 자연히 해결되는 경우는 예외다.
  • src/ 밖의 리팩터링. 단, R-0이 요구하는 스크립트와 설정 변경, 그리고 버그를 고정하고 있는 기존 테스트의 수정은 포함한다.
  • 공개 포트 시그니처의 파괴적 변경. 추가만 허용한다.

공통 완료 기준 (모든 요구사항)

  1. 버그를 재현하는 테스트가 먼저 실패하고(RED), 수정 뒤 통과한다(GREEN). 브라우저 없이는 재현할 수 없는 항목은 fake/fixture로 조건을 만들어 재현한다.
  2. corepack pnpm check:architecture, check:types:app, check:types:test, lint, test:unit, test:component이 통과한다.
  3. adapter 파일을 추가하거나 이동하면 docs/reviews/adapters/INVENTORY.md를 함께 고치고 check:adapter-inventory가 통과한다.
  4. adapter 간 공용 로직은 src/adapters/platform/(kernel)으로, 공유 어휘는 src/contracts/로 둔다. 새로운 파일 단위 예외 규칙은 만들지 않는다.
  5. 요구사항 하나에 커밋 하나. 커밋 메시지에 R-ID를 적는다.

요구사항

R-0 빌드 기반 (긴급)

  • 깨끗한 체크아웃(src/.generated/ 없음)에서 dev, build, check:architecture, check:types:app, test:unit, test:component, verify:documentation이 사전 수동 명령 없이 동작한다.
  • CI 게이트도 같은 조건에서 통과한다.

R-1 browser-transfer

  • R-1.1 dispose()가 deadline 초과로 실패한 뒤 작업이 끝나면, 다시 호출할 때 store를 닫고 CLOSED가 된다.
  • R-1.2 opaque ID 문법은 한 곳에서 정의한다. control plane이 받은 ID는 presigned 계층도 받는다.
  • R-1.3 동시성 정책 검증은 partSize × maxConcurrency × copyFactor를 기준으로 한다. 기본 정책은 이 검증을 통과하고, createSession은 실제 worker 수를 요청한다.
  • R-1.4 크기나 part 수 한도 초과는 LIMIT_EXCEEDED로 보고된다.

R-2 browser-files / cache-storage / cross-context

  • R-2.1 BOUNDED_OBJECT_URL 전략에서 source open이 실패하거나 abort되면 deliver()는 reject하지 않고 Result를 반환한다. 늦게 온 lease는 닫힌다.
  • R-2.2 source별 sequence watermark는 이벤트 TTL로 지워지지 않는다. 60초 넘게 쉰 뒤의 seq N+1은 NEXT다.
  • R-2.3 broadcast 발행이 실패해도 수신 listener는 유지된다. broadcast를 받을 수 없는 탭은 DEGRADED로 보고된다.
  • R-2.4 picker/save picker 함수는 options 객체에 bind되지 않는다. window 함수를 그대로 주입해도 동작한다.
  • R-2.5 기본 cache 정책이 Vary: Accept-Encoding 응답을 받아들인다. content-type이 허용 응답 헤더에 없는 정책은 정책 검증에서 거부된다.

R-3 http / query-cache / auth

  • R-3.1 경로 값 .과 ..는 V3와 V2 모두에서 PATH_VALUE_INVALID(V2는 PATH_PARAMETER_INVALID)로 거부된다.
  • R-3.2 세션 알림은 (상태, 주체)가 바뀔 때만 scope fence를 건다. demo 어댑터는 같은 값이면 알리지 않는다. V3의 요청 전 자격증명 없음은 onUnauthenticated()를 부르지 않는다. 서버 401만 부른다. [고위험: 인증·캐시]
  • R-3.3 5xx/408/425 응답의 problem 바디가 유효하지 않으면 HTTP status를 담은 서버 장애로 분류된다. 요청 쪽 위반은 서버 응답 오류(ENVELOPE_MISMATCH)로 매핑되지 않는다.
  • R-3.4 자격증명 헤더 값은 전송 전에 ByteString(제어문자 없음)으로 검증된다. 실패는 요청 전 단계의 인증 결함으로 분류된다. 대소문자만 다른 중복 헤더는 거부된다. [고위험: 인증]
  • R-3.5 feature 바인딩에서 mapSuccess/mapProblem이 던지면 MAPPING_CONTRACT_VIOLATION Result로 반환되고 effect가 보존된다.

R-4 realtime

  • R-4.1 await quiescence 뒤 DRAINING이면 recovery는 authority를 호출하지 않고 실패한다.
  • R-4.2 retryable:true인 PROVIDER_UNAVAILABLE/RATE_LIMITED는 서버 hint가 없어도 재연결 대상이다(reconnect와 polling 모두).
  • R-4.3 barrier가 필요 없는 recovery(barrier NONE)는 전송을 닫지 않고 계속된다.
  • R-4.4 SSE 파서는 문자마다 인코딩하지 않는다. 250KB chunk 처리가 기존 대비 10배 이상 빨라진다(수동 측정 기록).

R-5 storage

  • R-5.1 orphan 후보 목록은 커서로 이어서 볼 수 있다. 참조 중 청크가 100개를 넘어도 뒤의 orphan이 지워진다. [고위험: 삭제]
  • R-5.2 dedup으로 재사용한 청크는 grace period 보호를 다시 받는다(mtime 갱신). [고위험: 삭제]
  • R-5.3 mutation lock 대기 시간은 60초 RPC 타임아웃에 포함되지 않는다. lock 대기는 별도 상한 정책값으로 제한된다.
  • R-5.4 파티션 purge는 손상 행이 있어도 끝까지 지운다. 손상은 observe로 보고한다. [고위험: 삭제]
  • R-5.5 prepared-object 검증은 한 모듈에서 한다. 저장된 객체는 자기 manifest의 chunkSizeBytes로 검증되고, 현재 정책값은 새로 쓰는 데이터에만 적용된다. [고위험: 데이터 판독]

R-6 service-worker / web-push

  • R-6.1 확정 이후 메시지(ACCEPTED/RELOAD_REQUIRED)는 registration.waiting이 비어도 성공으로 처리된다. 메시지는 nonce/kind로 먼저 거른다.
  • R-6.2 drain 요청과 응답은 요청자 빌드와 무관하게 워커 buildId + nonce로 짝을 맞춘다. 다른 빌드 탭이 있어도 활성화가 끝난다.
  • R-6.3 앱이 reloadRequired/updateWaiting을 구독할 수 있다. current 캐시에 없는 asset은 previous 캐시에서 찾는다.
  • R-6.4 첫 방문에서 설치 중인 워커는 ACTIVE로 보고되지 않는다.
  • R-6.5 JavaScript MIME 동의어를 허용한다. content-encoding이 있으면 Content-Length와 압축 해제 크기를 비교하지 않는다.
  • R-6.6 fetch 핸들러는 manifest에 있는 same-origin GET(비 navigate) 요청에만 respondWith를 부른다.
  • R-6.7 reconcile에서 서버가 ABSENT이면, local association이 ACTIVE였던 경우에만 재등록한다. 그 밖에는 native 구독을 해제한다. [고위험: 동의]

R-7 contracts

  • R-7.1 멱등 키는 ^[\x21-\x7E]{1,256}$만 허용한다. 이 버그를 고정한 기존 테스트도 고친다.
  • R-7.2 FEATURE_OVERRIDES의 키(기능 ID)는 설정 이름 금지어 검사 대상이 아니다.
  • R-7.3 릴리스 매니페스트 URL은 해석 뒤 origin과 pathname이 입력과 같아야 한다. 탭, 개행, 인코딩된 점 세그먼트는 거부된다.
  • R-7.4 REST V2의 COMMAND는 POST/PUT/PATCH/DELETE만 허용된다. semantics/replayPolicy는 enum으로 검증된다. [고위험: CSRF]
  • R-7.5 operationId 문법은 contracts 한 곳에서 정의하고 텔레메트리와 진단이 재사용한다. V3가 받는 operationId의 실패 이벤트는 드롭되지 않는다.

R-8 presentation

  • R-8.1 청크 복구 실패 상태는 라우트가 바뀌면 초기화된다. 실패 화면에 "한 번 새로고침" 버튼이 있다.
  • R-8.2 WebKit(Importing a module script failed)과 Vite CSS preload 실패가 청크 실패로 인식된다.
  • R-8.3 선택한 로케일이 preferences에 저장되고 새로고침 뒤에도 유지된다. 세션이 바뀌어도 로케일과 테마는 초기화되지 않는다. unmount 시 router가 dispose된다.
  • R-8.4 로케일 변경은 제목과 문구만 갱신한다. 포커스 이동, 스크롤, route 변경 보고는 일어나지 않는다.
  • R-8.5 인증필요/잘못된 주소/비활성 기능 화면에서도 제목, 포커스, route 텔레메트리가 동작한다.
  • R-8.6 모바일 드로어에서 링크로 이동하면 포커스가 새 페이지(h1/main)로 간다. 메뉴 버튼으로 가지 않는다.
  • R-8.7 context 라우트 게이트웨이는 context가 바뀌면 이전 routes로 매칭하지 않는다. 모듈 로드 청크 실패는 recoverChunk를 거친다.
  • R-8.8 enabled:false 쿼리는 로딩으로 표시되지 않는다.

R-9 bootstrap / platform

  • R-9.1 TTL 안에 reload 마커가 있으면 키와 상관없이 자동 reload하지 않는다(세션당 최대 1회). 번갈아 오는 키 테스트를 추가하고, 연속 reload를 기대하던 테스트를 고친다.
  • R-9.2 dedup 창 안의 중복 발생 횟수가 수집기로 전달된다.
  • R-9.3 리댁션은 문자열 중간의 자격증명, URL 쿼리의 토큰, 이메일을 가린다. 키 목록에 pwd, pass, auth, otp, pin 계열을 추가한다. [고위험: 보안]

결정 (방향이 여러 개였던 항목의 기본값)

ID 결정 이유
D-1 (R-0) 생성 파일을 커밋하지 않는다. 생성 파일을 읽는 진입점(스크립트 또는 package script) 앞에서 생성기를 실행한다. 6f6c48e가 앱별 생성(PRODUCT_APP_ID)을 의도했으므로 gitignore를 유지한다.
D-2 (R-1.3) 기본 maxConcurrency를 실제 동작값에 맞춘다. 메모리 한도(maxInFlightBytes)는 올리지 않는다. 지금 기본 동작(동시 1)을 바꾸지 않고, 문서와 코드만 일치시킨다. 다운스트림이 올릴 수 있다.
D-3 (R-5.3) lock 범위는 줄이지 않는다(GC·dedup 정합성). lock 대기만 RPC 타임아웃에서 빼고, 별도 상한을 둔다. 범위를 줄이면 R-5.2 같은 경합이 새로 생긴다.
D-4 (R-2.3) 발행 쪽 이중 쓰기(broadcast + storage)는 하지 않는다. 수신 유지 + DEGRADED 보고만 한다. 가장 작은 변경으로 흔한 경로(발행 1회 실패)를 고친다.
D-5 (R-8.3) 로케일 저장은 테마와 같은 preferences 경로를 쓴다. Locale/Theme provider는 scope fence 바깥으로 올린다. 이미 있는 테마 패턴을 재사용한다.
D-6 (R-9.2) 누적 count는 dedup 창이 닫힐 때나 다음 flush 때 요약 이벤트의 occurrences로 보낸다. 기존 이벤트 스키마(occurrences)를 그대로 쓴다.
D-7 (R-6.3) previous 캐시 fallback은 hashed URL에만 적용한다. hashed URL은 같은 URL이면 같은 내용이라 안전하다.

2차 라운드: 권장·사소 항목과 1차 후속 결정

1차 라운드(R-0 ~ R-9.3)는 9bef702로 main에 병합했다. 2차 라운드에서는 리뷰의 권장·사소 항목 전부와 1차에서 남긴 결정 두 건을 처리한다. 요구사항 ID는 Q-<리뷰 섹션> 형식이다(예: Q-6.1-5 = 리뷰 6.1-5).

공통 완료 기준 (2차)

1차 공통 기준과 같다. 여기에 두 가지를 더한다.

  • 동작을 바꾸지 않는 정리(파일 분리, 중복 합치기): 새 RED 테스트 대신 기존 테스트가 안전망이다. 해당 경로에 테스트가 없으면 현재 동작을 고정하는 테스트(characterization)를 먼저 추가한다.
  • 번들: 정리가 끝난 뒤 check:optional-recipes가 통과해야 한다. 예산은 올리지 않는다(D-11).

요구사항

browser-transfer

  • Q-6.1-5 worker 하나가 실패하면 transfer 단위 abort로 나머지 worker를 즉시 멈춘다.
  • Q-6.1-6 해석할 수 없는 checkpoint 행이 있어도 abort는 그 행을 지우고 ORPHANED로 보고한다.
  • Q-6.1-7 PRIMARY_REQUIRED probe를 쓰는 preset은 fit이 cover/contain/fill일 때만 정책을 통과한다(D-12).
  • Q-6.1-8 probe의 decode는 EXIF/irot 회전을 적용하지 않는다(imageOrientation: "none").
  • Q-6.1-9 presigned HTTP helper를 한 모듈로 합친다. statusFailure recovery를 통일하고, 쓰지 않는 compensateLateResponse는 삭제한다. download Content-Length를 엄격하게 파싱하고, runtime attempt는 kernel createAbortableOperation을 쓴다.
  • Q-6.1-3b part마다 일어나는 방어적 복사 중 겹치는 것(Uint8Array.from과 slice())을 하나로 줄인다.
  • Q-6.1-10 resumable-upload-runtime.ts에서 서버 응답 검증과 의존성 snapshot 래퍼를 별도 모듈로 분리한다. 동작은 바꾸지 않는다.
  • Q-6.1-11 vault register는 snapshot 값만 읽는다.

browser-files / cache-storage / cross-context

  • Q-6.2-6 cache 조회 비용: JSON은 chunk를 모아 읽고, 검증된 marker는 메모리에 캐시하고, asset 탐색은 Map으로 한다.
  • Q-6.2-7 browser-files의 abort race를 kernel race와 compensate로 교체한다. 늦게 도착한 lease와 writable은 닫는다.
  • Q-6.2-8 native cancel을 한 번이라도 관찰했으면 focus fallback을 끈다.
  • Q-6.2-9 host factory가 비활성으로 끝날 때 observe로 보고한다. epoch는 releaseId를 인코딩해서 만든다.
  • Q-6.2-10 파일명 자르기를 O(n)으로 바꾸고, 중복 호출을 하나로 줄인다.
  • Q-6.2-11 public-response-cache-adapter.ts와 download-delivery-adapter.ts에서 코덱·검증 모듈을 분리한다. 동작은 바꾸지 않는다.
  • Q-6.2-12 MEDIA_TYPE/opaque 정규식과 positiveSafeInteger 중복을 합치고, object-url-lease.ts의 죽은 분기를 지운다.

http / browser-rpc / query-cache / auth

  • Q-6.3-6 요청 종료 사유 판정을 terminalOutcomeFor 하나로 모은다. 백오프 중 scope fence는 scope 종료로 분류된다.
  • Q-6.3-7 명령의 최종 effect는 누적 certainty와 합친다. MAYBE_APPLIED면 재시도하지 않는다.
  • Q-6.3-8 namespace 무효화를 병렬로 실행한다.
  • Q-6.3-9 RPC 명령이 전송 뒤 실패하면 MAYBE_APPLIED로 보고한다. 재시도 전에 scope를 확인하고, 소비자가 abort한 stream은 정리한다.
  • Q-6.3-11 V2 401 복구를 재시도 예산과 분리한다. "롤백 가능 seam" 문서의 잘못된 주장을 고친다(V2와 V3는 wire 형식이 다르다).
  • Q-6.3-12 cursor pagination의 누적 직렬화와 push(...) 한도 문제를 고친다. 쓰지 않는 validTransportFailure를 삭제하고, 따옴표가 닫히지 않은 W/" ETag를 거부한다.
  • Q-6.3-3b V2도 5xx/408/425의 HTML/빈 바디를 status를 담은 서버 장애로 분류하고 재시도 대상으로 둔다.

realtime

  • Q-6.4-5 chunk당 item 상한을 넘으면 실패하지 않고 다음 처리로 넘긴다. COMMENT는 상수 객체를 쓴다.
  • Q-6.4-6 dedupe는 FIFO로 제거하고, fingerprint는 해시로 저장하고, prune은 break한다. 가득 차도 전체 recovery를 하지 않는다.
  • Q-6.4-7 재시도 예산은 유효 신호가 있고 stableOpenMs가 지났을 때만 초기화한다.
  • Q-6.4-8 realtime 내부의 DataSnapshot과 abort/timeout race 헬퍼를 한 벌로 합친다. Retry-After 파싱과 JSON 중복 키 스캐너는 kernel(src/adapters/platform/)로 올리고, http retry-policy와 web-push codec도 이를 쓴다.
  • Q-6.4-9 반복되는 attempt 정리를 endAttempt()로 뽑고, 무시되던 _recovery 파라미터를 없앤다.
  • Q-6.4-10 probe 버퍼 상한을 현재 버퍼 기준으로 계산한다.
  • Q-6.4-11 사소 항목: poll execute가 throw하면 retryable OFFLINE으로 둔다. BOM은 한 번만 제거하고, 이중 encode와 이벤트마다 만드는 TextEncoder를 없애고, 잘못 붙은 JSDoc을 옮긴다.

storage

  • Q-6.5-6 openObject는 사전 검증에서 manifest만 대조하고, root digest는 스트림 끝에서 확인한다.
  • Q-6.5-7 IndexedDB 저장 행 타입·검증기·측정 공식을 indexeddb-records.ts 하나로 모은다. 동작은 바꾸지 않는다.
  • Q-6.5-8 삭제 후 재생성하면 revision/generation이 다시 시작한다는 점을 port 주석과 문서에 명시한다(D-13).
  • Q-6.5-9 보상이 실패해도 put의 원래 실패 코드를 유지하고, recovery만 RECONCILE로 바꾼다.
  • Q-6.5-10 kernel: succeed 뒤에 온 fail이 이기도록 하고, settle된 뒤의 upgrade는 abort한다.

service-worker / web-push

  • Q-6.6-6b fetch 가로채기를 "same-origin GET, navigate 아님, 해시 파일명 또는 manifest URL"로 넓힌다. previous 캐시 fallback이 옛 빌드 chunk에 실제로 동작해야 한다(1차 T29/T32 후속, 사용자 결정).
  • Q-6.6-8 후보 캐시 이름이 active 캐시와 같으면 설치 실패 시 지우지 않는다.
  • Q-6.6-9 activate는 오래된 캐시부터 지우고, marker 쓰기 실패가 삭제를 막지 않는다.
  • Q-6.6-10b 페이지 쪽 활성화 deadline에 워커 drain 시간과 여유분을 더한다.
  • Q-6.6-11 알림 클릭이 거절되면 handoff 데이터 없이 앱 루트를 연다. 조용한 push drop은 트레이드오프를 문서에 명시한다(D-14).
  • Q-6.6-12 web-push codec primitive(base64url, OPAQUE_ID, validAuthority, exactRecord)를 한 모듈로 합친다. page controller가 주입받은 document를 쓴다.

contracts

  • Q-6.7-6 exact-key/스냅샷 구현을 exact-snapshot.ts 하나로 모으고 배열 스냅샷을 추가한다. iterator·getter 우회를 막는다.
  • Q-6.7-7 검증된 인덱스·레지스트리는 createReadOnlyRegistry를 쓰고 row마다 스냅샷해서 얼린다.
  • Q-6.7-8 검증기 프로토콜과 MappingResult의 기준 모양을 하나로 정하고, 나머지는 호환 alias나 어댑터로 둔다(D-15).
  • Q-6.7-9 REST 인증 프로필은 설치된 레지스트리 하나를 기준으로 한다. V2 resolve도 검증된 레지스트리를 쓴다.
  • Q-6.7-10 배포 승인은 IPv6 loopback·ULA·link-local, IPv4-mapped, CGNAT, 0.0.0.0/8, .internal/.local을 사설 주소로 본다. 로컬 호스트 목록은 한 곳에 둔다.
  • Q-6.7-11 레지스트리 조회는 Object.hasOwn으로 한다. 목록에 없는 offline 전이는 false를 반환한다.
  • Q-6.7-12 release-tokens는 비교하지 않은 값을 통과로 보고하지 않는다. contract-set 중복은 실패 코드로 반환한다. query-keys 정렬은 필요할 때만 한다. dependency-cruiser에 contracts → presentation/bootstrap 금지 규칙을 추가한다.

presentation

  • Q-6.8-9 디자인시스템 링크(PageActionBar, Breadcrumbs, LinkButton)는 router Link로 렌더한다. Pagination은 다른 검색 파라미터를 보존한다.
  • Q-6.8-10 로딩·인증필요·404 화면을 하나씩으로 합치고, 세션 액션은 hook 하나로 묶는다. reject 시 멈추던 임시 로딩도 고친다.
  • Q-6.8-11 Tooltip: aria-describedby를 포커스되는 자식에 붙이고, Escape로 닫는다.
  • Q-6.8-12 Pagination은 현재 페이지 주변과 처음·끝만 보여주고(windowing), landmark 중첩을 없앤다.
  • Q-6.8-13a 플랫폼 라우트의 none 코덱은 모르는 쿼리 파라미터를 거부하지 않고 무시한다(D-16).
  • Q-6.8-13b 폼 제출은 비동기 검증 중에도 두 번 일어나지 않는다. 저장 직후 이동할 때 dirty guard가 뜨지 않는다.
  • Q-6.8-13c 기본 fallback 문구는 현재 로케일을 따른다. SearchField를 지우면 입력으로 포커스를 돌려준다.
  • Q-6.8-13d theme.css를 여러 파일로 나눈다. 빌드 결과 CSS 바이트가 달라지지 않아야 한다.

application / features / bootstrap / platform (+ telemetry adapter)

  • Q-6.9-4 텔레메트리 전송 계층을 하나로 합친다(rate limit, credentials omit, pagehide flush, dispose abort). best-effort fetch에 타임아웃을 둔다(6.3-10 포함).
  • Q-6.9-5 킬스위치로 끈 feature는 features.get()이 API를 돌려주지 않는다.
  • Q-6.9-6 adapter contribution의 featureId가 중복되거나 소속 module과 다르면 throw한다.
  • Q-6.9-7 execution context interaction에 완료/정리 API를 두어 부모 signal listener가 남지 않게 한다.
  • Q-6.9-8 부트 중에 정적 boot shell(로딩 표시, aria-busy)을 보여준다.
  • Q-6.9-9 chunk와 boot의 "한 번만 reload" 가드를 공용 guard 하나로 합친다.
  • Q-6.9-10 검증을 통과한 config 값만 safe 에러에 싣는다.
  • Q-6.9-11 텔레메트리 버퍼는 필요한 공간이 확보될 때만 낮은 severity를 지운다. 주석을 코드와 맞춘다.
  • Q-6.9-12 re-export만 하는 reference-feature-runtime.tsx를 삭제한다. CI 전용 정책(promotion-readiness, performance-budgets)은 src 소비자가 없으면 scripts/로 옮긴다. 메시지 로케일은 하드코딩하지 않고 카탈로그에서 도출한다.

통합

  • Q-B 번들 예산: 모든 레인을 병합한 뒤 check:optional-recipes를 통과시킨다. 필요하면 해당 번들 코드를 줄인다(D-11).

결정 (2차)

ID 결정
D-11 번들 예산은 올리지 않는다. 코드를 줄여 맞춘다(사용자 결정).
D-12 PRIMARY_REQUIRED는 fit cover/contain/fill만 허용한다. 비율을 유지하는 fit은 probe를 쓰지 않는 preset에서만 허용한다.
D-13 삭제 뒤 revision 재시작(ABA)은 스키마를 바꾸지 않고 문서로 계약을 명시한다. tombstone 도입은 저장 스키마 변경이라 범위 밖이다.
D-14 클릭 실패 시 앱 루트를 연다. push drop은 설계 의도로 두고 문서에 명시한다.
D-15 external-contract-runtime의 모양을 기준으로 삼는다. 다른 쪽은 호환 alias나 어댑터로 유지한다(공개 타입을 삭제하지 않음).
D-16 플랫폼 라우트의 모르는 쿼리 파라미터는 무시한다(strip). URL은 건드리지 않는다.