round9 그룹 B의 세 묶음이다(공유 노트 r9-fe-fix-plan.md 그룹 B, brief r9-briefs/fe-B.v2.md). 커밋은 묶음마다 하나다.
B2 자격 증명·업로드 401 (803d0f45): Fileserver 업로드의 서버 401이 세션에 닿지 않았고, JWT 모드에는 업로드에 세션 bearer를 붙일 지원 경로가 없었다. bootstrap은 "자격 증명 주인" 판정 순서를 두 함수에 따로 적었다. 매뉴얼 02 7절 예는 declare module로 capability를 보강해 check:types:node가 키를 못 봤다.
B3 짝 계약 pin (762393a9): pin 45d2a478이 백엔드 main보다 한참 뒤라 drift 검사가 exit 1이었다. 계약 문서 6.1절 근거 파일과 매뉴얼 04의 백엔드 기준도 낡았다. Fileserver 업로드 client의 게시 전 5xx 표는 pin 대조 밖이었다.
B5 SW 이월 (a5e6719b): SW를 켠 제품이 활성화·reload 안내를 붙이려면 템플릿 파일을 고쳐야 했다. 갱신 설치 실패·주기 검사 실패는 기록이 없었다. build.assetsDir를 바꾸면 사전 캐시가 조용히 비었다. 릴리스마다 바뀌지 않은 자산까지 다시 받았다. 쓰지 않는 protocol kind·상수와 사본 둘이 남았다.
고른 방법과 버린 대안
B2: credentialOwner(authProfileId) 하나가 NONE·PRODUCT·SESSION을 정하고, V3 자격 증명 붙이기와 401 전달이 둘 다 그것을 읽는다. ProductCompositionContext.credentials(V3와 같은 attachCredentials·onUnauthenticated 쌍)와 FileserverUploadClientDependencies.onUnauthenticated를 더했다(둘 다 추가만). 제품은 업로드 capability에 ...context.credentials를 펼친다. 버린 안: 템플릿이 제품 capability를 모양으로 찾아 감싸기 — 제품이 정한 키 이름을 추측해야 한다.
B3: pin·답 표·표 사본을 백엔드 d32b4b53(2026-11-13 main)으로 옮겼다. pin에 backend.codeSources(Fileserver code 파일과 게시 전 5xx 표)를 두고 drift 검사·pin 시험이 대조한다. 버린 안: 문서만 옛 pin에 맞추기 — drift는 계속 막힌다.
B5: ProductServiceWorkerWiring.onUpdateWaiting(activate)·onReloadRequired()(추가만). page controller가 update_install REDUNDANT·update_check FAILED를 observe로 낸다. 빈 asset 목록은 생성기와 설치가 거절한다. 설치는 이전 릴리스 캐시의 같은 URL을 digest·content type으로 다시 확인해 복사한다. 버린 안: 활성화 화면을 presentation 슬롯으로 — 문구와 흐름은 제품 것이다.
정한 기본값
R9-D13 대안(r9-fe 승인 2026-11-13). 권하는 안(product-capabilities.ts가 feature-adapter-contribution.ts에서 업로드 타입을 가져옴)은 그래프 순환이다. contribution 파일 9행이 이미 product-capabilities.ts를 type import하고, 그래프는 type import도 간선으로 센다(scripts/check-architecture.tsvisitSyntaxNode·findCycles → no-circular-dependencies). 그래서 템플릿이 indexedDb처럼 opt-in 키 fileserverUpload: FileserverUploadClientDependencies를 FeaturePlatformCapabilities에 선언했다(contribution 파일의 기존 type-only adapter import, 새 예외 없음). 제품은 product-composition.ts에서 값만 돌려준다. decisions.md 행은 r9-fe가 옮긴다.
새 pin d32b4b53. brief의 "main(a7e38c10 이후)" 중 작업 시점 main이다.
§4 OPERATION_NOT_FOUND(404)는 답 표에 옮기지 않았다(pin notCopied). durable operation 조회의 답이라 쓰기 적용 여부와 무관하고, 프론트는 그 조회를 부르지 않는다.
Fileserver 503 SERVER_BUSY는 NOT_APPLIED. 백엔드 697e62e8c가 permit·pool 포화를 429 TRANSFER_ADMISSION_REJECTED에서 503 SERVER_BUSY로 바꿨다. raise 자리 둘(TransferAdmissionController.java:79,88, BlockingTransferExecutor.java:61)이 모두 작업 전이다. 그 전과 같은 판정을 지킨다. V3 경로의 공용 SERVER_BUSY는 상태만 정해진 모든 503에도 붙어(HttpStatusErrorCodes.java:45) 단계를 code로 가를 수 없으니 V3 표에 넣지 않고 결과 불명 쪽에 둔다.
context.credentials를 조립 중에 부르면 TypeError("per request"). 전에는 TDZ ReferenceError였다.
0925/06-08은 vite.config.ts를 고치지 않고 시험이 build.assetsDir와 BUILD_ASSET_DIRECTORY를 대조한다(그 파일은 그룹 C가 고친다). 발견의 두 개선안 중 둘째다.
PR 나누기. brief 권함 (2) B2+B3, (3) B4+B5에서 B5를 이 PR로 옮겼다. B2와 B5가 같은 product-composition-contract.ts를 고쳐, 다른 PR로 내면 서로 기다린다. B4의 check-adapter-inventory.ts 때문에 S-04(B1)는 B4 PR로 간다.
위험과 영향
다운스트림이 따라 할 것(CHANGELOG로 옮길 것):
[계약] ProductCompositionContext.credentials 추가. 업로드 capability에 펼친다(매뉴얼 02 7절). 펼치지 않으면 업로드 401이 세션에 닿지 않는다.
[계약] FeaturePlatformCapabilities.fileserverUpload(opt-in). product-capabilities.ts나 declare module로 같은 키를 적은 제품은 지운다.
[계약] ProductServiceWorkerWiring.onUpdateWaiting·onReloadRequired 추가. 시작 때 이미 기다리던 갱신도 onUpdateWaiting 구독자에게 알린다.
[계약] 지움: ServiceWorkerMessageKind의 PAGE_HELLO·WORKER_HELLO_ACK·UPDATE_READY, SERVICE_WORKER_BOUNDS의 retainedPreviousCaches·reloadGuardBytes·reloadGuardTtlMs. 보내거나 읽는 곳이 없었다. 다른 빌드 worker가 보내면 UNKNOWN_KIND로 관측만 된다.
짝 계약 pin이 d32b4b53이다. CHANGELOG.md의 pin 줄(45d2a478)을 고친다. drift 검사는 codeSources도 본다.
SW 빌드가 빈 asset 목록이면 실패한다(build.assetsDir가 BUILD_ASSET_DIRECTORY와 다를 때).
짝 백엔드 main은 계속 움직인다. 다음 백엔드 병합 뒤 drift가 다시 1일 수 있다(설계된 신호).
쿠키 세션 모드 업로드 조각은 문장으로만 있다. 시험하는 조각은 JWT 모드다.
0925 P3(SW update spec 도우미 옵션)은 이 PR에 없다. 그룹 C의 0929/11-07이 같은 helper(tests/e2e/support/service-worker-builds.ts)를 고쳐, 그 뒤 그룹 B PR②에서 한다.
검증
RED(desktop, 고치기 전 코드 + 새 시험): scripts/verify.sh exec -- node scripts/run-vitest.ts run <B2·B3 시험 5개> → 10 failed / 90 passed. 실패한 것: 업로드 401 주인 시험 4, 업로드 onUnauthenticated, SERVER_BUSY 행, drift code source 2·scaffold 문구 1, pin 문서 대조(/tmp/claude-gates/r9b-pr1-red/exec_node.log).
drift(노트북, 백엔드 d32b4b53 공유 clone): 옮기기 전 exit 1(문서·scaffold 4건), 옮긴 뒤 exit 0.
scripts/verify.sh docs(노트북) OK.
desktop scripts/verify.sh merge(head a5e6719b, 트리 b49b1a8a, CI env, 공유 잠금, 로그 /tmp/claude-gates/r9b-pr1-merge2/): FE-GATE-001~013 rc=0(013은 test:system까지 전부 통과), FE-GATE-020 rc=1.
020 실패는 기능 제거 드릴 안 test:coverage의 tests/platform/cardinality/extreme-scale-registry.test.ts:144 증가율 측정이다(exponent 1.53, n=10k 2.03 ms → 100k 68.08 ms, load 17.89). 이 PR이 고친 코드와 닿지 않는 다른 원인이라 w2-fe-2의 흔들림 장부(FLAKY-1)로 넘겼다(delegation-loop 12.1).
같은 트리로 FE-GATE-020을 다시 돌렸다(/tmp/claude-gates/r9b-pr1-020b/): rc=0, 396s, load 16.59(FE-GATE-020 removability: PASS). 실패한 단계에서 GREEN을 봤다.
verify:documentation(노트북 감싸개, rc=0, 1s, 최대 부하 2.95, 로그 ~/laptop-gate-logs/r9b-pr1-docs-20261113-223557.log).
새 눈 리뷰(서브에이전트, 렌즈 fe-security·fe-structure·fe-performance·fe-testing) 한 번: High·P1 0. 고친 것: 조립 중 context.credentials의 불명확한 오류, 재사용의 content type 확인. 고치지 않은 것: CHANGELOG(brief상 r9-fe 몫, 위 「위험과 영향」), 계약 파일 export 삭제(위에 적음), 시작 때 알림이 두 번 날 수 있다는 지적(서로 다른 waiting worker 둘이라 맞는 동작).
발견 ID 표
ID
판정
커밋
1112/02-10
고침
803d0f45
1112/07-01
고침
803d0f45
1112/09-01
고침(R9-D13 대안)
803d0f45
1112/02-05
고침(pin d32b4b53)
762393a9
1112/08-18
고침(매뉴얼 04 기준·경로, AGENTS.md의 compose.yaml은 새 pin에 있음)
## 무엇을, 왜
round9 그룹 B의 세 묶음이다(공유 노트 `r9-fe-fix-plan.md` 그룹 B, brief `r9-briefs/fe-B.v2.md`). 커밋은 묶음마다 하나다.
- **B2 자격 증명·업로드 401** (`803d0f45`): Fileserver 업로드의 서버 401이 세션에 닿지 않았고, JWT 모드에는 업로드에 세션 bearer를 붙일 지원 경로가 없었다. bootstrap은 "자격 증명 주인" 판정 순서를 두 함수에 따로 적었다. 매뉴얼 02 7절 예는 `declare module`로 capability를 보강해 `check:types:node`가 키를 못 봤다.
- **B3 짝 계약 pin** (`762393a9`): pin `45d2a478`이 백엔드 main보다 한참 뒤라 drift 검사가 exit 1이었다. 계약 문서 6.1절 근거 파일과 매뉴얼 04의 백엔드 기준도 낡았다. Fileserver 업로드 client의 게시 전 5xx 표는 pin 대조 밖이었다.
- **B5 SW 이월** (`a5e6719b`): SW를 켠 제품이 활성화·reload 안내를 붙이려면 템플릿 파일을 고쳐야 했다. 갱신 설치 실패·주기 검사 실패는 기록이 없었다. `build.assetsDir`를 바꾸면 사전 캐시가 조용히 비었다. 릴리스마다 바뀌지 않은 자산까지 다시 받았다. 쓰지 않는 protocol kind·상수와 사본 둘이 남았다.
## 고른 방법과 버린 대안
- B2: `credentialOwner(authProfileId)` 하나가 NONE·PRODUCT·SESSION을 정하고, V3 자격 증명 붙이기와 401 전달이 둘 다 그것을 읽는다. `ProductCompositionContext.credentials`(V3와 같은 `attachCredentials`·`onUnauthenticated` 쌍)와 `FileserverUploadClientDependencies.onUnauthenticated`를 더했다(둘 다 추가만). 제품은 업로드 capability에 `...context.credentials`를 펼친다. 버린 안: 템플릿이 제품 capability를 모양으로 찾아 감싸기 — 제품이 정한 키 이름을 추측해야 한다.
- B3: pin·답 표·표 사본을 백엔드 `d32b4b53`(2026-11-13 main)으로 옮겼다. pin에 `backend.codeSources`(Fileserver code 파일과 게시 전 5xx 표)를 두고 drift 검사·pin 시험이 대조한다. 버린 안: 문서만 옛 pin에 맞추기 — drift는 계속 막힌다.
- B5: `ProductServiceWorkerWiring.onUpdateWaiting(activate)`·`onReloadRequired()`(추가만). page controller가 `update_install REDUNDANT`·`update_check FAILED`를 observe로 낸다. 빈 asset 목록은 생성기와 설치가 거절한다. 설치는 이전 릴리스 캐시의 같은 URL을 digest·content type으로 다시 확인해 복사한다. 버린 안: 활성화 화면을 presentation 슬롯으로 — 문구와 흐름은 제품 것이다.
## 정한 기본값
- **R9-D13 대안(r9-fe 승인 2026-11-13).** 권하는 안(`product-capabilities.ts`가 `feature-adapter-contribution.ts`에서 업로드 타입을 가져옴)은 그래프 순환이다. contribution 파일 9행이 이미 `product-capabilities.ts`를 type import하고, 그래프는 type import도 간선으로 센다(`scripts/check-architecture.ts` `visitSyntaxNode`·`findCycles` → `no-circular-dependencies`). 그래서 템플릿이 `indexedDb`처럼 opt-in 키 `fileserverUpload: FileserverUploadClientDependencies`를 `FeaturePlatformCapabilities`에 선언했다(contribution 파일의 기존 type-only adapter import, 새 예외 없음). 제품은 `product-composition.ts`에서 값만 돌려준다. `decisions.md` 행은 r9-fe가 옮긴다.
- **새 pin `d32b4b53`.** brief의 "main(`a7e38c10` 이후)" 중 작업 시점 main이다.
- **§4 `OPERATION_NOT_FOUND`(404)는 답 표에 옮기지 않았다**(pin `notCopied`). durable operation 조회의 답이라 쓰기 적용 여부와 무관하고, 프론트는 그 조회를 부르지 않는다.
- **Fileserver 503 `SERVER_BUSY`는 `NOT_APPLIED`.** 백엔드 `697e62e8c`가 permit·pool 포화를 429 `TRANSFER_ADMISSION_REJECTED`에서 503 `SERVER_BUSY`로 바꿨다. raise 자리 둘(`TransferAdmissionController.java:79,88`, `BlockingTransferExecutor.java:61`)이 모두 작업 전이다. 그 전과 같은 판정을 지킨다. V3 경로의 공용 `SERVER_BUSY`는 상태만 정해진 모든 503에도 붙어(`HttpStatusErrorCodes.java:45`) 단계를 code로 가를 수 없으니 V3 표에 넣지 않고 결과 불명 쪽에 둔다.
- **`context.credentials`를 조립 중에 부르면 `TypeError`**("per request"). 전에는 TDZ `ReferenceError`였다.
- **SW 재사용은 같은 URL·같은 digest·같은 content type일 때만.** 하나라도 다르거나 읽기가 실패하면 다운로드한다.
- **0925/06-08은 vite.config.ts를 고치지 않고** 시험이 `build.assetsDir`와 `BUILD_ASSET_DIRECTORY`를 대조한다(그 파일은 그룹 C가 고친다). 발견의 두 개선안 중 둘째다.
- **PR 나누기.** brief 권함 (2) B2+B3, (3) B4+B5에서 B5를 이 PR로 옮겼다. B2와 B5가 같은 `product-composition-contract.ts`를 고쳐, 다른 PR로 내면 서로 기다린다. B4의 `check-adapter-inventory.ts` 때문에 S-04(B1)는 B4 PR로 간다.
## 위험과 영향
- 다운스트림이 따라 할 것(CHANGELOG로 옮길 것):
- [계약] `ProductCompositionContext.credentials` 추가. 업로드 capability에 펼친다(매뉴얼 02 7절). 펼치지 않으면 업로드 401이 세션에 닿지 않는다.
- [계약] `FileserverUploadClientDependencies.onUnauthenticated` 추가(선택).
- [계약] `FeaturePlatformCapabilities.fileserverUpload`(opt-in). `product-capabilities.ts`나 `declare module`로 같은 키를 적은 제품은 지운다.
- [계약] `ProductServiceWorkerWiring.onUpdateWaiting`·`onReloadRequired` 추가. 시작 때 이미 기다리던 갱신도 `onUpdateWaiting` 구독자에게 알린다.
- [계약] 지움: `ServiceWorkerMessageKind`의 `PAGE_HELLO`·`WORKER_HELLO_ACK`·`UPDATE_READY`, `SERVICE_WORKER_BOUNDS`의 `retainedPreviousCaches`·`reloadGuardBytes`·`reloadGuardTtlMs`. 보내거나 읽는 곳이 없었다. 다른 빌드 worker가 보내면 `UNKNOWN_KIND`로 관측만 된다.
- 짝 계약 pin이 `d32b4b53`이다. `CHANGELOG.md`의 pin 줄(`45d2a478`)을 고친다. drift 검사는 `codeSources`도 본다.
- SW 빌드가 빈 asset 목록이면 실패한다(`build.assetsDir`가 `BUILD_ASSET_DIRECTORY`와 다를 때).
- 짝 백엔드 main은 계속 움직인다. 다음 백엔드 병합 뒤 drift가 다시 1일 수 있다(설계된 신호).
- 쿠키 세션 모드 업로드 조각은 문장으로만 있다. 시험하는 조각은 JWT 모드다.
- 0925 P3(SW update spec 도우미 옵션)은 이 PR에 없다. 그룹 C의 0929/11-07이 같은 helper(`tests/e2e/support/service-worker-builds.ts`)를 고쳐, 그 뒤 그룹 B PR②에서 한다.
## 검증
- RED(desktop, 고치기 전 코드 + 새 시험): `scripts/verify.sh exec -- node scripts/run-vitest.ts run <B2·B3 시험 5개>` → 10 failed / 90 passed. 실패한 것: 업로드 401 주인 시험 4, 업로드 `onUnauthenticated`, `SERVER_BUSY` 행, drift code source 2·scaffold 문구 1, pin 문서 대조(`/tmp/claude-gates/r9b-pr1-red/exec_node.log`).
- drift(노트북, 백엔드 `d32b4b53` 공유 clone): 옮기기 전 exit 1(문서·scaffold 4건), 옮긴 뒤 exit 0.
- `scripts/verify.sh docs`(노트북) OK.
- desktop `scripts/verify.sh merge`(head `a5e6719b`, 트리 `b49b1a8a`, CI env, 공유 잠금, 로그 `/tmp/claude-gates/r9b-pr1-merge2/`): FE-GATE-001~013 rc=0(013은 `test:system`까지 전부 통과), FE-GATE-020 rc=1.
- 020 실패는 기능 제거 드릴 안 `test:coverage`의 `tests/platform/cardinality/extreme-scale-registry.test.ts:144` 증가율 측정이다(exponent 1.53, n=10k 2.03 ms → 100k 68.08 ms, load 17.89). 이 PR이 고친 코드와 닿지 않는 다른 원인이라 w2-fe-2의 흔들림 장부(FLAKY-1)로 넘겼다(delegation-loop 12.1).
- 같은 트리로 FE-GATE-020을 다시 돌렸다(`/tmp/claude-gates/r9b-pr1-020b/`): rc=0, 396s, load 16.59(`FE-GATE-020 removability: PASS`). 실패한 단계에서 GREEN을 봤다.
- `verify:documentation`(노트북 감싸개, rc=0, 1s, 최대 부하 2.95, 로그 `~/laptop-gate-logs/r9b-pr1-docs-20261113-223557.log`).
## 리뷰어가 볼 곳
- `src/bootstrap/runtime-adapters.ts` `credentialOwner`·`attachCredentials`·`reportServerUnauthenticated`
- `src/adapters/http/fileserver-upload.ts` `reportUnauthenticated`, `NOT_APPLIED_5XX_CODES`
- `config/contracts/backend-contract-pin.json` `codeSources`, `docs/architecture/backend-api-and-server-state-contract.md` 6.1절
- `src/adapters/service-worker/service-worker-static-assets.ts` `reuseVerifiedAsset`, `src/bootstrap/create-runtime-composition.ts` `connectProductServiceWorker`
- 새 눈 리뷰(서브에이전트, 렌즈 fe-security·fe-structure·fe-performance·fe-testing) 한 번: High·P1 0. 고친 것: 조립 중 `context.credentials`의 불명확한 오류, 재사용의 content type 확인. 고치지 않은 것: CHANGELOG(brief상 r9-fe 몫, 위 「위험과 영향」), 계약 파일 export 삭제(위에 적음), 시작 때 알림이 두 번 날 수 있다는 지적(서로 다른 waiting worker 둘이라 맞는 동작).
## 발견 ID 표
| ID | 판정 | 커밋 |
|---|---|---|
| 1112/02-10 | 고침 | `803d0f45` |
| 1112/07-01 | 고침 | `803d0f45` |
| 1112/09-01 | 고침(R9-D13 대안) | `803d0f45` |
| 1112/02-05 | 고침(pin `d32b4b53`) | `762393a9` |
| 1112/08-18 | 고침(매뉴얼 04 기준·경로, `AGENTS.md`의 `compose.yaml`은 새 pin에 있음) | `762393a9` |
| 1105/01-02 프론트 몫 | 고침(`codeSources`) | `762393a9` |
| 1103/09-05 | 고침 | `a5e6719b` |
| 0925/06-05 | 고침 | `a5e6719b` |
| 0925/06-08 | 고침(대조 시험 + 빈 목록 거절) | `a5e6719b` |
| 1101/06-03 | 고침(지움) | `a5e6719b` |
| 1101/06-05 | 고침 | `a5e6719b` |
| 1101 R1 | 고침 | `a5e6719b` |
| 1101 R2 | 고침 | `a5e6719b` |
| 1101 R3 | 고침 | `a5e6719b` |
| 0925 P3 | 이 PR 밖(그룹 B PR②, 그룹 C helper 변경 뒤) | — |
## 관련
- 리뷰: `docs/reviews/2026-11-round9-02-structure-contracts.md` S-05·S-10, `-07-security.md` SEC-01, `-09-adapters.md` R-01, `-08-guardrails-docs.md` GD-18, `-10-prior-findings-a.md`
- 결정: R9-D2, R9-D4, R9-D13(대안)
문제: Fileserver 업로드 client가 서버 401을 AUTH_REQUIRED 실패로만
돌려준다. 세션은 authenticated로 남고 OIDC refresh도, 서버 상태 fence도
일어나지 않는다. JWT 모드(EXTERNAL_BEARER)에는 업로드에 세션 bearer를
붙일 지원 경로가 없어, 제품이 세션 owner를 붙잡아 scope fence 밖에서
부르게 된다. bootstrap은 "자격 증명 주인" 판정 순서를 attachCredentials와
reportServerUnauthenticated 두 곳에 따로 적는다. 매뉴얼 02 7절 업로드 예는
declare module로 capability를 보강해 check:types:node가 그 키를 못 본다.
고른 방법(R9-D2, R9-D13 대안):
- credentialOwner(authProfileId) 하나가 NONE·PRODUCT·SESSION을 정하고,
V3 attachCredentials와 401 전달이 둘 다 그것을 읽는다(02-10).
- ProductCompositionContext.credentials를 더한다. V3와 같은
attachCredentials와 같은 401 전달(onUnauthenticated)이다(추가만).
- FileserverUploadClientDependencies에 선택 onUnauthenticated를 더하고,
client는 서버 401이면 본문과 상관없이 한 번 부른다(추가만).
- 업로드 capability 타입은 indexedDb처럼 템플릿이
FeaturePlatformCapabilities에 opt-in 키 fileserverUpload로 선언한다.
R9-D13 권하는 안(product-capabilities.ts가 contribution 파일에서 타입을
가져옴)은 contribution 파일이 이미 product-capabilities.ts를 type
import해서 그래프 순환이 된다(r9-fe 승인 2026-11-13).
- 매뉴얼 02 7절을 context.credentials를 펼치는 조각 둘로 바꾸고
manual-code-block 표식을 단다. 시험은 제품 소유 파일 조각이 그 파일을
통째로 바꾸게 한다.
버린 대안: 템플릿이 제품 capability를 모양으로 찾아 감싸기 — 제품이 정한
키 이름을 템플릿이 추측해야 한다.
위험·한계: 업로드 capability에 context.credentials를 펼치지 않은 제품은
그대로 401이 세션에 닿지 않는다(매뉴얼 02 7절·04에 적음). 쿠키 세션
모드 조각은 문장으로만 있고 시험 조각은 JWT 모드다.
검증: desktop, RED — 고치기 전 코드에서 새 업로드·주인 시험이 실패
(/tmp/claude-gates/r9b-pr1-red/exec_node.log). check:types·lint·
check:architecture rc=0(/tmp/claude-gates/r9b-pr1-quick). merge 단계는
PR 본문.
Refs: 1112/02-10, 1112/07-01, 1112/09-01
문제: pin(45d2a478)이 백엔드 main보다 한참 뒤라 drift 검사가 exit 1이다.
그사이 백엔드가 폴더를 다시 배치하고(scaffold 원본 셋의 경로) 샘플을
지웠다. 계약 문서 6.1절 근거 파일 넷과 위치 목록이 main에 없고, 매뉴얼
04는 pin과 다른 bbe944bd를 기준이라 적는다. Fileserver 업로드 client의
게시 전 5xx 표는 pin 대조 밖이다(1105/01-02). 백엔드 697e62e8c부터
fileserver의 permit·pool 포화가 429에서 503 SERVER_BUSY로 바뀌어, client는
작업 전에 거절된 업로드를 결과 불명으로 읽는다.
고른 방법(R9-D4):
- pin, 답 표 source, 표 사본(--write-excerpt)을 d32b4b53으로 옮긴다.
§4의 새 행 404 OPERATION_NOT_FOUND는 durable operation 조회의 답이라
notCopied에 이유와 함께 둔다.
- scaffold 원본 세 경로를 새 위치로 고친다(내용 0줄 변경 확인).
- pin에 backend.codeSources를 더한다. Fileserver code 파일과 게시 전
5xx 표(codes)를 적고, readers에 fileserver-upload.ts를 넣는다. drift
검사가 그 파일들의 변경과, pin 커밋에 없는 경로(옮겨진 파일)를 알린다.
pin 시험이 client 표와 pin 사본을 양쪽으로 대조한다.
- NOT_APPLIED_5XX_CODES에 SERVER_BUSY를 더한다. raise 자리 둘
(TransferAdmissionController, BlockingTransferExecutor)이 모두 작업 전이다.
- 6.1절 표의 백엔드 파일:줄을 d32b4b53에서 다시 찾았다. 판정은 같다.
샘플과 함께 사라진 근거(참조 도메인 행, WorkLogWebMapper 등)는 뺐고,
새 출처(PatchBodies, 알림 컨트롤러 필드 거절)를 적었다.
- 매뉴얼 04의 기준을 pin으로 바꾸고 백엔드 경로 셋을 고친다.
버린 대안: 문서만 옛 pin 기준으로 맞추기 — drift 검사는 계속 막힌다.
위험·한계: V3 경로의 503 SERVER_BUSY는 상태만 정해진 모든 503에도 붙어
code로 단계를 가를 수 없다. 그래서 V3 표에 넣지 않고 결과 불명 쪽에
둔다(6.1절). 백엔드 main은 계속 움직이므로 다음 백엔드 병합 뒤 drift가
다시 1일 수 있다(설계된 신호).
검증: 노트북, 공유 clone(d32b4b53)으로
node scripts/check-backend-contract-drift.ts --backend <clone>: 옮기기 전
exit 1(문서·scaffold 4건), 옮긴 뒤 exit 0. desktop RED — pin·drift·
업로드 표 시험이 고치기 전 코드에서 실패
(/tmp/claude-gates/r9b-pr1-red/exec_node.log). merge 단계는 PR 본문.
Refs: 1112/02-05, 1112/08-18, 1105/01-02
문제: SW를 켠 제품이 새 버전 안내·reload 안내를 붙이려면 템플릿
파일을 고쳐야 한다(1103/09-05). 설치에 실패한 갱신(redundant)과 실패한
주기 검사는 아무 기록도 남기지 않는다(0925/06-05). build.assetsDir를
바꾸면 사전 캐시가 조용히 빈다(0925/06-08). 릴리스마다 바뀌지 않은
자산까지 no-store로 다시 받는다(1101/06-05). 쓰지 않는 protocol kind
셋과 reload guard 상수, void 참조, 손으로 쓴 protocol 버전 1, web-push의
fence 검사 두 벌이 남았다(1101/06-03, R1~R3).
고른 방법:
- ProductServiceWorkerWiring에 onUpdateWaiting(activate)·
onReloadRequired()를 더한다(추가만). create-runtime-composition이 worker
시작 전에 host 이벤트를 구독해 부르고, 던지면 버린다. page controller는
시작 때 이미 기다리던 갱신도 onUpdateWaiting 구독자에게 알린다.
- page controller가 update_install REDUNDANT, update_check FAILED를
observe로 낸다.
- 사전 캐시 생성기와 SW 설치가 빈 asset 목록을 거절하고, 시험이
vite.config.ts의 build.assetsDir와 BUILD_ASSET_DIRECTORY를 대조한다
(vite.config.ts는 그룹 C가 고치는 파일이라 건드리지 않았다).
- 설치가 이전 릴리스 캐시의 같은 URL을 digest로 다시 확인해 복사하고,
없거나 맞지 않을 때만 받는다.
- PAGE_HELLO·WORKER_HELLO_ACK·UPDATE_READY, reloadGuard*·
retainedPreviousCaches를 지운다. sync 알림은 createServiceWorkerMessage로
만든다. fence 검사는 push-association-fence-store.ts 하나다.
버린 대안: 활성화 화면을 presentation 슬롯으로 열기 — 화면 문구와 흐름은
제품 것이라 조합 계약의 함수 칸이 작다.
위험·한계: 지운 kind는 보내는 곳이 없었다. 다른 빌드의 worker가 보내도
UNKNOWN_KIND로 관측만 된다. 재사용은 이전 캐시를 읽는 비용이 들고,
읽기 실패는 다운로드로 돌아간다.
검증: desktop check:types·lint·check:architecture·
check:adapter-inventory rc=0, SW 시험 묶음 통과
(/tmp/claude-gates/r9b-pr1-quick). merge 단계는 PR 본문.
Refs: 1103/09-05, 0925/06-05, 0925/06-08, 1101/06-03, 1101/06-05, 1101/R1, 1101/R2, 1101/R3
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 그룹 B의 세 묶음이다(공유 노트
r9-fe-fix-plan.md그룹 B, briefr9-briefs/fe-B.v2.md). 커밋은 묶음마다 하나다.803d0f45): Fileserver 업로드의 서버 401이 세션에 닿지 않았고, JWT 모드에는 업로드에 세션 bearer를 붙일 지원 경로가 없었다. bootstrap은 "자격 증명 주인" 판정 순서를 두 함수에 따로 적었다. 매뉴얼 02 7절 예는declare module로 capability를 보강해check:types:node가 키를 못 봤다.762393a9): pin45d2a478이 백엔드 main보다 한참 뒤라 drift 검사가 exit 1이었다. 계약 문서 6.1절 근거 파일과 매뉴얼 04의 백엔드 기준도 낡았다. Fileserver 업로드 client의 게시 전 5xx 표는 pin 대조 밖이었다.a5e6719b): SW를 켠 제품이 활성화·reload 안내를 붙이려면 템플릿 파일을 고쳐야 했다. 갱신 설치 실패·주기 검사 실패는 기록이 없었다.build.assetsDir를 바꾸면 사전 캐시가 조용히 비었다. 릴리스마다 바뀌지 않은 자산까지 다시 받았다. 쓰지 않는 protocol kind·상수와 사본 둘이 남았다.고른 방법과 버린 대안
credentialOwner(authProfileId)하나가 NONE·PRODUCT·SESSION을 정하고, V3 자격 증명 붙이기와 401 전달이 둘 다 그것을 읽는다.ProductCompositionContext.credentials(V3와 같은attachCredentials·onUnauthenticated쌍)와FileserverUploadClientDependencies.onUnauthenticated를 더했다(둘 다 추가만). 제품은 업로드 capability에...context.credentials를 펼친다. 버린 안: 템플릿이 제품 capability를 모양으로 찾아 감싸기 — 제품이 정한 키 이름을 추측해야 한다.d32b4b53(2026-11-13 main)으로 옮겼다. pin에backend.codeSources(Fileserver code 파일과 게시 전 5xx 표)를 두고 drift 검사·pin 시험이 대조한다. 버린 안: 문서만 옛 pin에 맞추기 — drift는 계속 막힌다.ProductServiceWorkerWiring.onUpdateWaiting(activate)·onReloadRequired()(추가만). page controller가update_install REDUNDANT·update_check FAILED를 observe로 낸다. 빈 asset 목록은 생성기와 설치가 거절한다. 설치는 이전 릴리스 캐시의 같은 URL을 digest·content type으로 다시 확인해 복사한다. 버린 안: 활성화 화면을 presentation 슬롯으로 — 문구와 흐름은 제품 것이다.정한 기본값
product-capabilities.ts가feature-adapter-contribution.ts에서 업로드 타입을 가져옴)은 그래프 순환이다. contribution 파일 9행이 이미product-capabilities.ts를 type import하고, 그래프는 type import도 간선으로 센다(scripts/check-architecture.tsvisitSyntaxNode·findCycles→no-circular-dependencies). 그래서 템플릿이indexedDb처럼 opt-in 키fileserverUpload: FileserverUploadClientDependencies를FeaturePlatformCapabilities에 선언했다(contribution 파일의 기존 type-only adapter import, 새 예외 없음). 제품은product-composition.ts에서 값만 돌려준다.decisions.md행은 r9-fe가 옮긴다.d32b4b53. brief의 "main(a7e38c10이후)" 중 작업 시점 main이다.OPERATION_NOT_FOUND(404)는 답 표에 옮기지 않았다(pinnotCopied). durable operation 조회의 답이라 쓰기 적용 여부와 무관하고, 프론트는 그 조회를 부르지 않는다.SERVER_BUSY는NOT_APPLIED. 백엔드697e62e8c가 permit·pool 포화를 429TRANSFER_ADMISSION_REJECTED에서 503SERVER_BUSY로 바꿨다. raise 자리 둘(TransferAdmissionController.java:79,88,BlockingTransferExecutor.java:61)이 모두 작업 전이다. 그 전과 같은 판정을 지킨다. V3 경로의 공용SERVER_BUSY는 상태만 정해진 모든 503에도 붙어(HttpStatusErrorCodes.java:45) 단계를 code로 가를 수 없으니 V3 표에 넣지 않고 결과 불명 쪽에 둔다.context.credentials를 조립 중에 부르면TypeError("per request"). 전에는 TDZReferenceError였다.build.assetsDir와BUILD_ASSET_DIRECTORY를 대조한다(그 파일은 그룹 C가 고친다). 발견의 두 개선안 중 둘째다.product-composition-contract.ts를 고쳐, 다른 PR로 내면 서로 기다린다. B4의check-adapter-inventory.ts때문에 S-04(B1)는 B4 PR로 간다.위험과 영향
ProductCompositionContext.credentials추가. 업로드 capability에 펼친다(매뉴얼 02 7절). 펼치지 않으면 업로드 401이 세션에 닿지 않는다.FileserverUploadClientDependencies.onUnauthenticated추가(선택).FeaturePlatformCapabilities.fileserverUpload(opt-in).product-capabilities.ts나declare module로 같은 키를 적은 제품은 지운다.ProductServiceWorkerWiring.onUpdateWaiting·onReloadRequired추가. 시작 때 이미 기다리던 갱신도onUpdateWaiting구독자에게 알린다.ServiceWorkerMessageKind의PAGE_HELLO·WORKER_HELLO_ACK·UPDATE_READY,SERVICE_WORKER_BOUNDS의retainedPreviousCaches·reloadGuardBytes·reloadGuardTtlMs. 보내거나 읽는 곳이 없었다. 다른 빌드 worker가 보내면UNKNOWN_KIND로 관측만 된다.d32b4b53이다.CHANGELOG.md의 pin 줄(45d2a478)을 고친다. drift 검사는codeSources도 본다.build.assetsDir가BUILD_ASSET_DIRECTORY와 다를 때).tests/e2e/support/service-worker-builds.ts)를 고쳐, 그 뒤 그룹 B PR②에서 한다.검증
scripts/verify.sh exec -- node scripts/run-vitest.ts run <B2·B3 시험 5개>→ 10 failed / 90 passed. 실패한 것: 업로드 401 주인 시험 4, 업로드onUnauthenticated,SERVER_BUSY행, drift code source 2·scaffold 문구 1, pin 문서 대조(/tmp/claude-gates/r9b-pr1-red/exec_node.log).d32b4b53공유 clone): 옮기기 전 exit 1(문서·scaffold 4건), 옮긴 뒤 exit 0.scripts/verify.sh docs(노트북) OK.scripts/verify.sh merge(heada5e6719b, 트리b49b1a8a, CI env, 공유 잠금, 로그/tmp/claude-gates/r9b-pr1-merge2/): FE-GATE-001~013 rc=0(013은test:system까지 전부 통과), FE-GATE-020 rc=1.test:coverage의tests/platform/cardinality/extreme-scale-registry.test.ts:144증가율 측정이다(exponent 1.53, n=10k 2.03 ms → 100k 68.08 ms, load 17.89). 이 PR이 고친 코드와 닿지 않는 다른 원인이라 w2-fe-2의 흔들림 장부(FLAKY-1)로 넘겼다(delegation-loop 12.1)./tmp/claude-gates/r9b-pr1-020b/): rc=0, 396s, load 16.59(FE-GATE-020 removability: PASS). 실패한 단계에서 GREEN을 봤다.verify:documentation(노트북 감싸개, rc=0, 1s, 최대 부하 2.95, 로그~/laptop-gate-logs/r9b-pr1-docs-20261113-223557.log).리뷰어가 볼 곳
src/bootstrap/runtime-adapters.tscredentialOwner·attachCredentials·reportServerUnauthenticatedsrc/adapters/http/fileserver-upload.tsreportUnauthenticated,NOT_APPLIED_5XX_CODESconfig/contracts/backend-contract-pin.jsoncodeSources,docs/architecture/backend-api-and-server-state-contract.md6.1절src/adapters/service-worker/service-worker-static-assets.tsreuseVerifiedAsset,src/bootstrap/create-runtime-composition.tsconnectProductServiceWorkercontext.credentials의 불명확한 오류, 재사용의 content type 확인. 고치지 않은 것: CHANGELOG(brief상 r9-fe 몫, 위 「위험과 영향」), 계약 파일 export 삭제(위에 적음), 시작 때 알림이 두 번 날 수 있다는 지적(서로 다른 waiting worker 둘이라 맞는 동작).발견 ID 표
803d0f45803d0f45803d0f45d32b4b53)762393a9AGENTS.md의compose.yaml은 새 pin에 있음)762393a9codeSources)762393a9a5e6719ba5e6719ba5e6719ba5e6719ba5e6719ba5e6719ba5e6719ba5e6719b관련
docs/reviews/2026-11-round9-02-structure-contracts.mdS-05·S-10,-07-security.mdSEC-01,-09-adapters.mdR-01,-08-guardrails-docs.mdGD-18,-10-prior-findings-a.md