문제
HTTP 실행 경로가 둘이다. V3 실행기(createContractHttpExecutor)가 모든 기능을
실행하고, V2 클라이언트(createHttpClient)는 bootstrap의
createRuntimeHttpClient에서만 만들어지는데 그 함수를 앱 안에서 부르는 곳이
없다(테스트만 부른다). tech-log·memento도 같다. 그런데도 V2는 초기 청크에
들어가고, 짝 백엔드 해석(7db32e1~3261208)과 테스트를 두 벌로 유지하게 했다.
사용자 지시: 레거시를 두지 말고 최신 경로 하나만 남긴다.
고른 방법
- src/adapters/http/의 client.ts, bounded-json.ts, request-builder.ts,
resource-mapper.ts, retry-policy.ts, schema-registry.ts를 지웠다. Envelope
스키마는 backend-envelope.ts로 옮겼다. V3가 retry-policy.ts에서 쓰던
parseRetryAfter는 그것이 감싸던 platform/retry-after.ts의
parseRetryAfterDelay를 직접 부른다.
- 배럴의 V2 export와 bootstrap의 createRuntimeHttpClient·RuntimeHttpContract를
지웠다.
- V2 전용 테스트(http-client, http-diagnostics, auth-recovery,
legacy-http-credential-authority, bounded-json-compatibility,
request-builder, retry-policy)와 tests/helpers/http-contract-fixture.ts를
지웠다. 섞인 파일(http-execution-contract, runtime-adapters,
boundary-mapper)은 V2 블록만 지웠다.
- V2로 돌던 폼 테스트(form-foundation)는 Envelope을 읽는 V3 keyed create
계약으로 옮겼다. 400 VALIDATION_FAILED 필드 오류, {cause} 뒤 다시 저장,
422 뒤 저장 꺼짐을 그대로 검사한다. http-execution-v3-envelope 테스트는 V2와
비교하던 행을 기대 판정을 직접 적는 행으로 바꿨다.
- drill:runbook FE-RB-003은 V2 shouldRetry 대신 V3 실행기를 실제로 돌려
보낸 요청 수를 센다(NEVER 503: 1회, SAFE 503: 재시도, SAFE 스키마 불일치:
1회).
- check:diagnostics의 http 이벤트 생산자, registry-governance의 오류 표 소비자,
risk-coverage 고위험 경로, 아키텍처 금지 fixture, adapter INVENTORY, 문서의
경로를 V3 파일로 바꿨다.
버린 대안
- V2를 @deprecated로 한 릴리스 남기기: 템플릿과 두 다운스트림 모두 부르는
곳이 없어 옮겨 갈 사용자가 없다. 남기면 초기 JS와 두 벌 유지 비용만 남는다.
위험·한계
- BREAKING: 배럴과 bootstrap의 V2 이름을 쓰던 제품 코드는 컴파일이 깨진다.
CHANGELOG에 옮기는 방법을 적었다.
- V2에만 있던 동작이 사라졌다: 401 뒤 세션 복구 후 한 번 재전송, KEYED 503
자동 재시도. V3는 401을 UNAUTHENTICATED로 넘기고 KEYED 요청은 보낸 뒤
재시도하지 않는다.
- 기능마다 적는 V2 API 행(*-api-contract.ts, check:registries가 읽음)은 이
커밋에서 지우지 않았다. 다음 커밋이 지운다.
검증
- check:types, lint, check:architecture(금지 fixture 9건 거절),
check:adapter-inventory(140 files), check:diagnostics, check:registries,
check:ci, verify:documentation 통과.
- test:unit 2,585, test:integration 114, test:component 245, test:contract 23,
test:runtime-schema 56, tests/features 101 통과.
- drill:runbook FE-RB-003: no local check failed.
- check:bundle 통과. 초기 JS 203,354 → 201,598 B(−1,756 B).
BREAKING CHANGE: src/adapters/http/index.ts가 createHttpClient, HttpClient,
HttpClientDependencies, HttpFailure, HttpResult, LegacyHttpInput, Scheduler,
OperationRequestInput를, src/bootstrap/runtime-adapters.ts가
createRuntimeHttpClient, RuntimeHttpContract를 내보내지 않는다. 그 operation의
V3 descriptor를 만들어 createFeatureHttpBinding으로 실행한다.
16 KiB
16 KiB
Adapter 파일 전수 inventory
검토 기준:
develop(2026-08-14 재검토 반영)GOV-01. 이 표는 손으로 센 숫자가 아니라
corepack pnpm check:adapter-inventory가git ls-files src/adapters와 정확히 대조하는 목록이다.
rg --files src/adapters | sort결과 119개를 하나씩 고정한 coverage ledger다. 책임·의존성·finding·유지/변경 판정은 연결된 상세 리뷰의 파일별 표를 따른다.
| # | full path | 상세 리뷰 |
|---|---|---|
| 1 | src/adapters/auth/external-session-adapter.ts |
Network/state |
| 2 | src/adapters/auth/index.ts |
Network/state |
| 3 | src/adapters/browser-file-storage/index.ts |
Storage/files |
| 4 | src/adapters/browser-file-storage/result.ts |
Storage/files |
| 5 | src/adapters/browser-file-storage/storage-manager-adapter.ts |
Storage/files |
| 6 | src/adapters/browser-files/browser-file-picker.ts |
Storage/files |
| 7 | src/adapters/browser-files/browser-file-policy-registry.ts |
Storage/files |
| 8 | src/adapters/browser-files/browser-file-vault.ts |
Storage/files |
| 9 | src/adapters/browser-files/create-browser-file-runtime.ts |
Storage/files |
| 10 | src/adapters/browser-files/download-delivery-adapter.ts |
Storage/files |
| 11 | src/adapters/browser-files/download-input-validation.ts |
Storage/files |
| 12 | src/adapters/browser-files/file-observer.ts |
Storage/files |
| 13 | src/adapters/browser-files/file-policy.ts |
Storage/files |
| 14 | src/adapters/browser-files/index.ts |
Storage/files |
| 15 | src/adapters/browser-files/object-url-lease.ts |
Storage/files |
| 16 | src/adapters/browser-rpc/browser-rpc-runtime.ts |
Realtime/RPC |
| 17 | src/adapters/browser-rpc/index.ts |
Realtime/RPC |
| 18 | src/adapters/browser-rpc/transport.ts |
Realtime/RPC |
| 19 | src/adapters/browser-rpc/unavailable-browser-rpc-transport.ts |
Realtime/RPC |
| 20 | src/adapters/browser-transfer/image-cdn/README.md |
Browser transfer |
| 21 | src/adapters/browser-transfer/image-cdn/browser-image-probe.ts |
Browser transfer |
| 22 | src/adapters/browser-transfer/image-cdn/image-cdn-policy.ts |
Browser transfer |
| 23 | src/adapters/browser-transfer/image-cdn/image-cdn-runtime.ts |
Browser transfer |
| 24 | src/adapters/browser-transfer/image-cdn/image-header-metadata.ts |
Browser transfer |
| 25 | src/adapters/browser-transfer/image-cdn/index.ts |
Browser transfer |
| 26 | src/adapters/browser-transfer/image-cdn/p256-image-capability-verifier.ts |
Browser transfer |
| 27 | src/adapters/browser-transfer/index.ts |
Browser transfer |
| 28 | src/adapters/browser-transfer/presigned/http-common.ts |
Browser transfer |
| 29 | src/adapters/browser-transfer/presigned/incremental-sha256.ts |
Browser transfer |
| 30 | src/adapters/browser-transfer/presigned/index.ts |
Browser transfer |
| 31 | src/adapters/browser-transfer/presigned/presigned-capability-http-provider.ts |
Browser transfer |
| 32 | src/adapters/browser-transfer/presigned/presigned-capability-vault.ts |
Browser transfer |
| 33 | src/adapters/browser-transfer/presigned/presigned-transfer-executor.ts |
Browser transfer |
| 34 | src/adapters/browser-transfer/resumable-upload/checkpoint-schema.ts |
Browser transfer |
| 35 | src/adapters/browser-transfer/resumable-upload/fetch-json-transport.ts |
Browser transfer |
| 36 | src/adapters/browser-transfer/resumable-upload/http-control-plane-adapter.ts |
Browser transfer |
| 37 | src/adapters/browser-transfer/resumable-upload/index.ts |
Browser transfer |
| 38 | src/adapters/browser-transfer/resumable-upload/indexeddb-checkpoint-store.ts |
Browser transfer |
| 39 | src/adapters/browser-transfer/resumable-upload/presigned-upload-part-executor.ts |
Browser transfer |
| 40 | src/adapters/browser-transfer/resumable-upload/resumable-upload-runtime.ts |
Browser transfer |
| 41 | src/adapters/browser-transfer/resumable-upload/runtime-dependencies.ts |
Browser transfer |
| 42 | src/adapters/browser-transfer/resumable-upload/runtime-policy.ts |
Browser transfer |
| 43 | src/adapters/browser-transfer/resumable-upload/upload-byte-source.ts |
Browser transfer |
| 44 | src/adapters/browser-transfer/resumable-upload/upload-cancellation-channel.ts |
Browser transfer |
| 45 | src/adapters/browser-transfer/resumable-upload/upload-mutation-lock.ts |
Browser transfer |
| 46 | src/adapters/browser-transfer/resumable-upload/upload-response-validation.ts |
Browser transfer |
| 47 | src/adapters/cache-storage/index.ts |
Storage/files |
| 48 | src/adapters/cache-storage/public-cache-codec.ts |
Storage/files |
| 49 | src/adapters/cache-storage/public-cache-policy.ts |
Storage/files |
| 50 | src/adapters/cache-storage/public-cache-response-validation.ts |
Storage/files |
| 51 | src/adapters/cache-storage/public-response-cache-adapter.ts |
Storage/files |
| 52 | src/adapters/cross-context-invalidation/browser-cross-context-host.ts |
Network/state |
| 53 | src/adapters/cross-context-invalidation/browser-cross-context-invalidation.ts |
Network/state |
| 54 | src/adapters/cross-context-invalidation/index.ts |
Network/state |
| 55 | src/adapters/diagnostics/bounded-diagnostics.ts |
Network/state |
| 56 | src/adapters/diagnostics/index.ts |
Network/state |
| 57 | src/adapters/http/backend-envelope.ts |
Network/state |
| 58 | src/adapters/http/bounded-body-reader.ts |
Network/state |
| 59 | src/adapters/http/feature-http-binding.ts |
Network/state |
| 60 | src/adapters/http/http-contract-bridge.ts |
Network/state |
| 61 | src/adapters/http/http-effect-certainty.ts |
Network/state |
| 62 | src/adapters/http/http-execution-v3.ts |
Network/state |
| 63 | src/adapters/http/http-retry-lifecycle.ts |
Network/state |
| 64 | src/adapters/http/index.ts |
Network/state |
| 65 | src/adapters/http/platform-error-mapping.ts |
Network/state |
| 66 | src/adapters/platform/abortable-operation.ts |
Network/state |
| 67 | src/adapters/platform/bounded-capacity.ts |
Network/state |
| 68 | src/adapters/platform/browser-lifecycle.ts |
Network/state |
| 69 | src/adapters/platform/browser-mutation-intent-factory.ts |
Network/state |
| 70 | src/adapters/platform/index.ts |
Network/state |
| 71 | src/adapters/platform/indexeddb-connection.ts |
Network/state |
| 72 | src/adapters/platform/indexeddb-transaction.ts |
Network/state |
| 73 | src/adapters/platform/json-member-scanner.ts |
Network/state |
| 74 | src/adapters/platform/retry-after.ts |
Network/state |
| 75 | src/adapters/platform/system-clock.ts |
Network/state |
| 76 | src/adapters/query-cache/conditional-validator-store.ts |
Network/state |
| 77 | src/adapters/query-cache/cursor-pagination-contract.ts |
Network/state |
| 78 | src/adapters/query-cache/cursor-pagination-runtime.ts |
Network/state |
| 79 | src/adapters/query-cache/index.ts |
Network/state |
| 80 | src/adapters/query-cache/server-state-scope-runtime.ts |
Network/state |
| 81 | src/adapters/query-cache/tanstack-cache-coordinator.ts |
Network/state |
| 82 | src/adapters/query-cache/tanstack-query-cache.ts |
Network/state |
| 83 | src/adapters/realtime/event-codec.ts |
Realtime/RPC |
| 84 | src/adapters/realtime/event-consumer.ts |
Realtime/RPC |
| 85 | src/adapters/realtime/index.ts |
Realtime/RPC |
| 86 | src/adapters/realtime/live-poll-handoff-coordinator.ts |
Realtime/RPC |
| 87 | src/adapters/realtime/polling/bounded-poll-coordinator.ts |
Realtime/RPC |
| 88 | src/adapters/realtime/polling/index.ts |
Realtime/RPC |
| 89 | src/adapters/realtime/reconnect-coordinator.ts |
Realtime/RPC |
| 90 | src/adapters/realtime/reconnect-policy.ts |
Realtime/RPC |
| 91 | src/adapters/realtime/result.ts |
Realtime/RPC |
| 92 | src/adapters/realtime/sse/fetch-sse-connection.ts |
Realtime/RPC |
| 93 | src/adapters/realtime/sse/index.ts |
Realtime/RPC |
| 94 | src/adapters/realtime/sse/sse-parser.ts |
Realtime/RPC |
| 95 | src/adapters/realtime/stream-coordinator.ts |
Realtime/RPC |
| 96 | src/adapters/realtime/websocket/index.ts |
Realtime/RPC |
| 97 | src/adapters/realtime/websocket/websocket-connection.ts |
Realtime/RPC |
| 98 | src/adapters/realtime/websocket/websocket-protocol.ts |
Realtime/RPC |
| 99 | src/adapters/service-worker/index.ts |
Worker/push |
| 100 | src/adapters/service-worker/service-worker-entry.ts |
Worker/push |
| 101 | src/adapters/service-worker/service-worker-lifecycle.ts |
Worker/push |
| 102 | src/adapters/service-worker/service-worker-page-controller.ts |
Worker/push |
| 103 | src/adapters/service-worker/service-worker-protocol.ts |
Worker/push |
| 104 | src/adapters/service-worker/service-worker-removal.ts |
Worker/push |
| 105 | src/adapters/service-worker/service-worker-static-assets.ts |
Worker/push |
| 106 | src/adapters/storage/browser-storage-adapter.ts |
Storage/files |
| 107 | src/adapters/storage/browser-storage-codec.ts |
Storage/files |
| 108 | src/adapters/storage/index.ts |
Storage/files |
| 109 | src/adapters/storage/indexeddb/index.ts |
Storage/files |
| 110 | src/adapters/storage/indexeddb/indexeddb-governance.ts |
Storage/files |
| 111 | src/adapters/storage/indexeddb/indexeddb-maintenance.ts |
Storage/files |
| 112 | src/adapters/storage/indexeddb/indexeddb-migrations.ts |
Storage/files |
| 113 | src/adapters/storage/indexeddb/indexeddb-records.ts |
Storage/files |
| 114 | src/adapters/storage/indexeddb/indexeddb-runtime.ts |
Storage/files |
| 115 | src/adapters/storage/indexeddb/indexeddb-types.ts |
Storage/files |
| 116 | src/adapters/storage/opfs/browser-opfs-runtime.ts |
Storage/files |
| 117 | src/adapters/storage/opfs/index.ts |
Storage/files |
| 118 | src/adapters/storage/opfs/indexeddb-opfs-journal.ts |
Storage/files |
| 119 | src/adapters/storage/opfs/opfs-byte-store-adapter.ts |
Storage/files |
| 120 | src/adapters/storage/opfs/opfs-policy.ts |
Storage/files |
| 121 | src/adapters/storage/opfs/opfs-prepared-object.ts |
Storage/files |
| 122 | src/adapters/storage/opfs/opfs-worker-client.ts |
Storage/files |
| 123 | src/adapters/storage/opfs/opfs-worker-protocol.ts |
Storage/files |
| 124 | src/adapters/storage/opfs/opfs-worker-runtime.ts |
Storage/files |
| 125 | src/adapters/telemetry/best-effort-telemetry.ts |
Network/state |
| 126 | src/adapters/telemetry/feature-telemetry.ts |
Network/state |
| 127 | src/adapters/telemetry/index.ts |
Network/state |
| 128 | src/adapters/telemetry/telemetry-collector.ts |
Network/state |
| 129 | src/adapters/web-push/codec-primitives.ts |
Worker/push |
| 130 | src/adapters/web-push/inbound/notification-click-adapter.ts |
Worker/push |
| 131 | src/adapters/web-push/inbound/push-event-adapter.ts |
Worker/push |
| 132 | src/adapters/web-push/index.ts |
Worker/push |
| 133 | src/adapters/web-push/notification-registry.ts |
Worker/push |
| 134 | src/adapters/web-push/push-association-fence-store.ts |
Worker/push |
| 135 | src/adapters/web-push/push-codec.ts |
Worker/push |
| 136 | src/adapters/web-push/push-registration-gateway.ts |
Worker/push |
| 137 | src/adapters/web-push/push-subscription-adapter.ts |
Worker/push |
| 138 | src/adapters/web-push/runtime-support.ts |
Worker/push |
| 139 | src/adapters/web-push/service-worker-runtime.ts |
Worker/push |
| 140 | src/adapters/web-push/service-worker-scope-host.ts |
Worker/push |
합계: 140/140. 새 adapter 파일이 추가되면 이 ledger와 해당 상세 리뷰 inventory를 같은 변경에서 갱신한다.