fix(r9): 업로드 401을 주인에게 보내고 짝 계약 pin과 SW 제품 칸을 고친다 #53
Merged
donghyeon.kang
merged 3 commits from 2026-11-13 18:03:45 +00:00
donghyeon.kang/r9-credential-contract-sw AGit into main
3
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
a5e6719b18 |
fix(service-worker): 제품 활성화 칸을 열고 갱신 실패를 관측한다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m17s
frontend-quality-gates / merge / tests (pull_request) Successful in 11m53s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m36s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: 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 |
||
|
|
762393a940 |
fix(contracts): 짝 백엔드 pin을 백엔드 main d32b4b53으로 옮긴다
문제: 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 |
||
|
|
803d0f45aa |
fix(bootstrap): 업로드 401을 자격 증명을 붙인 주인에게 보낸다
문제: 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 |