frontend-quality-gates / merge / static checks (pull_request) Successful in 3m30s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m48s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 9m28s
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
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
main 5250ff95 전체를 분야 렌즈 아홉(React, 구조·공통 계약, 시험·QA,
UX·디자인 시스템, 접근성, 성능·빌드, 보안, 가드레일·문서, 나머지
adapter)과 지난 발견 재판정 둘로 나눠 리뷰했다. 새 발견은 반박 검증을
거쳐 80건이다(High 0, P1 1: 1112/08-02 템플릿 시험의 고정 기능 ID).
지난 리뷰가 연 118행은 고쳐짐 33, 일부 35, 남음 46, 재발 2다.
리뷰 README 하나와 영역 기록 열다섯을 docs/reviews/2026-11-round9-*.md
파일 묶음으로 둔다. 영역 기록은 서브에이전트가 쓴 원문이고, 작업 폴더
절대 경로만 줄였다. 리뷰 중 코드는 고치지 않았다.
위험·한계: 실행 증거는 desktop에 CI env를 준 실행이다(실제 runner
미검증). 실험 X-GD02·X-GD02b와 수정 라운드는 README 16절에 이어 적는다.
결정이 필요한 12건(R9-D1~D12)은 권하는 안과 함께 7절에 있다.
검증: scripts/verify.sh docs(노트북) 통과. 게이트 실행 결과는 README
11.1절(merge 13/14 rc=0, FE-GATE-013은 호스트 제약 조건 충족,
documentation rc=0).
Refs: round9 확인 리뷰
18 KiB
18 KiB
round9 반박 검증 V1 — L1 react · L9 adapters · L7 security
round9 리뷰(2026-11-12, 대상 main
5250ff95)의 영역 기록이다. 서브에이전트가 쓴 원문을 그대로 옮겼다. 바꾼 것은 이 인용 블록과, 작업 폴더 절대 경로를(작업 폴더)로 줄인 것뿐이다. 발견 ID는 이 파일의 이름표(R-01 등)이고, 라운드 ID(1112/NN-MM)와의 대응은 README 15절이다.
대상 5250ff95. 읽기만 했다. repo 파일을 고치지 않았고 노트북·desktop에서 아무것도 실행하지 않았다(증거 E1). L9의 2.5절 이월 항목은 뺐다.
0. 결론
- 13건 판정: 확인 11, 확인·등급 조정 0, 반박 2(그중 1건은 제안으로만 남김), 실행 필요 0.
- 반박: L9/R-03(문장이 repo 용어로 맞다), L9/C-01(코드 읽기로 네 지점 모두 bytes를 다시 만들지 않는다. 1106 05 영역 미검증 1행의 이월이다).
- 근거 일부를 고친 것: L1/R-01의 "401 재전송 뒤 둘이 엇갈린다" 예는 템플릿 세션 자격 증명에서는 성립하지 않는다(아래 표). 등급은 그대로다.
- 새 발견이 아닌 것: L1/R-02는 1106 README 16.8절 FR-03(남김)과 같은 결함이다. 이월로 한 번만 센다.
- 등급을 바꾼 것은 없다. 다만 L1/R-02는 PA가 이월 판정에서 Medium·P2로 둔다. 같은 모양의 1106 DR-03이 Low·P3라서 Low·P3를 권한다. README 「심각도 조정」에 둘 중 하나를 적어야 한다.
1. 판정 표
| 원 ID | 판정 | 최종 등급 | 근거·반박 이유(file:line) | RED 위치 또는 실험 | 소유자 결정 필요?(이유) | 중복 |
|---|---|---|---|---|---|---|
| L1/R-01 결과 불명 판정이 코디네이터·폼·생성 페이지 사본에 나뉨 | 확인(근거 일부 정정) | Medium·P2 (구조적 위험) | 성립: 코디네이터 resendLeavesUnknown(src/presentation/adapters/query/application-query.ts:643-646)과 폼 resendLeftUnknown(src/presentation/forms/use-app-form.ts:522-530)이 같은 판정을 따로 한다. 생성 페이지가 막기·안내·이동을 직접 한다(scripts/create-feature-write-slice.ts:639-656, :674-680, :724-750). repo 규칙 위반: docs/work/reference/structure.md 7절 "페이지마다 복사하지 않고 공용 폼 hook 안에서 한다(결함 패턴 C11)", src/application/AGENTS.md:9. C11의 사례가 1105/08-02·08-04이고, 이미 생성한 기능은 손으로 옮긴다(CHANGELOG.md:196). 정정: "401 재전송 뒤 코디네이터는 UNKNOWN을 쥐고 폼은 비운다"는 템플릿 세션에서는 틀리다. 401 → authSession.onUnauthenticated()(src/bootstrap/runtime-adapters.ts:620) → 같은 호출 안에서 scope FENCED(src/adapters/query-cache/server-state-scope-runtime.ts:120-150) → mutationFn이 SCOPE_GENERATION_CHANGED로 끝내고(application-query.ts:463-476) resendLeavesUnknown이 scope 검사로 false → admission 정리. 엇갈림은 fence하지 않는 제품 provider 401에서만 남는다 |
RED: 생성 출력 정적 시험(tests/unit/create-feature.test.ts): 생성된 <base>-create-page.tsx에 mutation.state.indicator 비교·useRef(false) 마운트 표시가 있으면 실패. 고친 뒤 platform hook 시험은 tests/component/form-foundation.test.tsx |
예. 새 공용 hook을 design-system 배럴에 내보내고 생성 출력을 바꾼다(배럴 표면). 대안 A/B/C 고르기도 소유자 몫 | 관련: PA-01(지운 재마운트 시험), L1/R-02 |
| L1/R-02 재마운트 폼 재전송이 보낸 적 없는 화면 값을 제출 값으로 씀 | 확인 | Low·P3 | use-app-form.ts:425 unknownSubmissionRef.current ?? values → 성공이면 applyOutcome → settleSuccessfulValues(화면 값)(:261-263, :218-229). 결과 불명에 남으면 화면 값을 보관(:430-435) → 확인 때 settleApplied가 그 값을 지움(:235, :248). 같은 상황의 settleApplied 재마운트 분기는 값을 둔다(:236-246, CHANGELOG.md:196). 덧붙임: 생성 페이지는 재전송 성공 때 pending 중에 상세로 이동하고 그동안 이탈 확인이 꺼진다(create-feature-write-slice.ts:680, :744). hook만 고쳐서는 이 경로의 입력이 남지 않는다. 페이지 쪽 동작은 R-01과 같이 정한다 |
RED: tests/component/form-foundation.test.tsx. 새 폼에 값을 입력하고 resendUnknown(성공) → 값·dirty=true가 남는지. 두 번째 경우: resendUnknown이 NOT_APPLIED 429로 남은 뒤 settleApplied → 값이 남는지. 실험 X-L1-01 |
아니오(폼 내부 동작) | 같은 결함: 1106 README 16.8 FR-03(남김), PA 1106/03-01 ① FR-03. 새 발견으로 세지 않는다. 등급: PA Medium·P2 대 L1 Low·P3. 같은 모양 DR-03이 Low·P3 |
| L1/R-03 생성 입력이 scope fence로 끊긴 요청을 실패 telemetry로 보냄 | 확인 | Low·P3 | scripts/create-feature.ts:941은 REQUEST_ABORTED만 뺀다. fence는 SCOPE_GENERATION_CHANGED로 온다(src/adapters/http/http-execution-v3.ts:720-732, src/adapters/http/feature-http-binding.ts:494-495, :557-558). 근거가 더 있다: 플랫폼 자신의 HTTP telemetry는 SCOPE_FENCE 취소와 SCOPE_FENCED 위반을 실패로 세지 않는다(src/bootstrap/runtime-adapters.ts:254-282). 렌즈 기준 .claude/skills/fe-react/SKILL.md:55 "abort를 … telemetry 실패로 세지 않는다" |
RED: scripts/create-feature.ts renderInputTest(:1271 옆)에 SCOPE_GENERATION_CHANGED 경우를 더한다. 생성·실행은 FE-GATE-020 드릴이 한다. 실험 X-L1-02 |
아니오(errors.ts에 판정 함수 추가는 추가만) |
없음 |
| L1/R-04 query·mutation 실패 진단이 원인을 버림 | 확인(영향 좁힘) | Low·P3 | (1) src/adapters/query-cache/tanstack-query-cache.ts:24-44가 모든 실패를 cache.operation.failed warn으로 남긴다. ApplicationQueryError에 kind가 없어(application-query.ts:54-62) safeErrorKind(src/contracts/diagnostics.ts:241-266)가 늘 APPLICATION_QUERY_ERROR를 낸다. 런북은 이 이벤트로 cache 장애 범위를 좁힌다(docs/operations/client-cache-and-storage-recovery.md:66). structure.md 7절 "서로 다른 실패를 같은 reason으로 남기지 않는다". (2) operationId 리터럴(application-query.ts:175, :704, :761) 그대로다. 좁힌 점: HTTP 요청의 원인은 http.request.completed에 error_kind로 남는다(runtime-adapters.ts:204-237, eventId :218). "원인을 버린다"는 cache 이벤트와 예상 밖 throw에만 맞다 |
RED: tests/unit/query-cache.test.ts에 createQueryClient + diagnostics spy, ApplicationQueryError 모양 실패 mutation 뒤 기록 0건(또는 kind 실림). (2)는 tests/component/application-query-bridge.test.tsx에서 bound query의 예상 밖 throw 실패 operationId가 정의 ID인지. 실험 X-L1-03 |
아니오 | 없음 |
| L1/R-05 stale 실패를 effect로 state에 복사, 다시 시도 초기화가 바로 덮임 | 확인 | Low·P3 | application-query.ts:103, :185-196. TanStack 5.101.4(package.json:131)는 data가 있으면 재조회 중에도 status: "error"를 둔다. isFetching 변화로 effect가 다시 돌아 true로 되돌린다. deriveAsyncState가 stale-degraded를 refreshing보다 먼저 고른다(src/application/view-models/async-state.ts:118-129). 렌즈 기준 .claude/skills/fe-react/SKILL.md:37, :49. 기존 시험은 다시 시도 중 표시를 보지 않는다(tests/component/application-query-bridge.test.tsx:51-111) |
RED: tests/component/application-query-bridge.test.tsx. 실험 X-L1-04. 다시 시도 중 보일 상태는 fe-ux가 정한다 |
아니오 | 없음 |
L1/R-06 "모든 시도가 받는 거절" 판정이 mapProblem이 바꿀 수 있는 code를 읽음 |
확인 | Low·P3 (구조적 위험) | src/contracts/errors.ts:273-279가 failure.code·httpStatus를 본다. code는 기능 mapProblem이 먼저 정한다(feature-http-binding.ts:339-341, :447-450). repo 약속과 어긋남: 매뉴얼은 mapProblem이 code를 바꿀 수 있지만 "적용 여부는 못 바꾼다"고 적는다(docs/manual/01-add-a-feature.md:390). 그런데 code로 결과 불명 정리 여부가 바뀐다. 생성 템플릿은 code를 그대로 넘긴다(create-feature-write-slice.ts:404-410). 그래서 템플릿 경로에서는 닿지 않는다 |
RED: tests/integration/에 실제 실행기 + 바인딩 + useApplicationMutation. KEYED Envelope create, mapProblem이 선언 code를 VALIDATION_FAILED로 바꾼다. 재전송 400 뒤 지금은 indicator === null, 고친 뒤 mutation-effect-unknown |
아니오(AppFailure에 선택 칸 추가는 추가만). 매뉴얼 01:390 문장도 함께 고친다 |
관련: 1106 FR-01(kind 쪽은 b41990cd가 고침. code 쪽이 남음) |
L9/R-01 매뉴얼 02 §7 업로드 예가 declare module로 capability를 보강 |
확인 | Low·P3 | docs/manual/02-decision-tables.md:467이 declare module로 보강한다. docs/manual/03-outside-feature-folder.md:118-119와 recipes/frontend-capabilities/browser-file-session-capability.ts:24-31은 이 방식을 막는다. node 프로그램은 scripts/**·*.config.ts만 넣어(tsconfig.node.json) product-composition.ts의 보강을 보지 못한다. 블록은 f8005493(2026-11-04), 규칙은 1105/02-03. 1105/02-03 수정이 놓친 사본이다 |
실험 X-L9-01. 상시 RED: §7 두 블록에 manual-code-block 표식을 달아 tests/unit/manual-code-blocks.test.ts가 타입 검사하게 한다(node 프로그램 포함) |
아니오(문서) | 같은 결함: L7 3절 넘김(ID 없음). 1105/02-03 「일부」로 셀 수도 있다 |
| L9/R-02 지금 규칙인 표 둘이 설계서에만 있음 | 확인 | Low·P3 | poll 결과 대응표는 설계서 9.2절에만 있다(docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md:1698-1710). 이 표대로 execute를 쓰는 쪽은 조합 코드다(src/adapters/realtime/polling/bounded-poll-coordinator.ts:115-121). 짝 백엔드 대응표는 같은 설계서 0.1절이고, 살아 있는 문서가 그 절을 출처로 가리킨다(docs/architecture/optional-adapter-recipes.md:235-238, docs/manual/03-outside-feature-folder.md:125). repo 규칙: docs/README.md:70 "설계서와 기록은 … 지금 동작을 설명하지 않는다", :115·.claude/rules/docs.md 기록은 머리 블록만 고친다. 성격은 같은 모양인 L8/GD-17에 맞춰 확인된 결함으로 봐도 된다 |
정적 RED: git grep -n "Design 9.2" -- src 1건, git grep -n "bounded-polling-design.md#01" -- docs/architecture docs/manual 2건이 고친 뒤 0건. 문서 검사에 넣으려면 L2/S-06 RED와 함께 |
아니오(문서 이동) | 같은 원인·다른 문서: L8/GD-17, L2/S-06(2026-11-08 99e76e87 이동). 함께 고친다 |
| L9/R-03 "현재 concrete runtime은 없다" 문장이 낡음 | 반박 | — | 이 repo 용어로 "concrete runtime"은 production bootstrap이 만들고 쓰는 runtime이다(COMPOSED 정의, docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md:64, docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md:63). 지금 조합은 realtime을 시작할 runtime이 없다. 고르면 조합을 거부한다(src/features/installed-runtime-capabilities.ts:19-28, src/bootstrap/optional-runtime-host.ts:23, :110-111). 그래서 문장은 catalog AVAILABLE_NOT_COMPOSED와 같은 말이다. 같은 절 다음 줄이 "이 repo의 SSE·realtime.v1 WebSocket 어댑터"를 적어 참조 코드가 있음도 밝힌다(optional-adapter-recipes.md:235-236). 1101 리뷰도 이 문장을 "조합에 runtime 없음"의 근거로 썼다(docs/reviews/2026-11-01-maturity-review/09-app-core.md:212) |
제안으로만: "reference runtime은 있고 조합은 없다"로 풀어 쓰면 덜 헷갈린다 | 아니오 | 없음 |
| L9/C-01 reconcile과 승인 partition 삭제의 겹침에 시험 없음 | 반박(제안으로만 남김) | — | 지킬 약속(docs/operations/browser-file-storage-recovery.md:490-491 "partitionDeleted면 bytes는 모두 지워졌다")을 네 지점 모두 코드가 지킨다. verify 전 삭제: manifest 없음 → false(src/adapters/storage/opfs/opfs-worker-runtime.ts:701-712) → staging이 partition 아래라(:1669-1676, :870-881) 이미 없음 → 없는 row의 rollback은 성공. verify 뒤 commit 전: commitMutation은 row가 없으면 CONFLICT로 끝나고 row를 만들지 않는다(src/adapters/storage/opfs/indexeddb-opfs-journal.ts:997-1027). commit 뒤 finalize 전: finalizePut이 create: false로 열고 NotFound면 staging 정리만 한다(opfs-worker-runtime.ts:951-990). finalize 뒤: 없는 row의 complete는 성공(indexeddb-opfs-journal.ts:579-600). 어디에도 create: true 경로가 없다. 시험 부재만으로는 약속 위반이 아니다. 1106 05 영역 5절 미검증 1행과 같은 항목이다(docs/reviews/2026-11-06-maturity-review/05-adapters-storage-kernel.md:145. 같은 문서 :18은 commitPut 앞·뒤 두 지점을 실행해 bytes가 남지 않았다고 적는다) |
선택: X-L9-02를 회귀 시험으로 올리면 E2가 된다 | 아니오 | 이월: 1106/05 미검증 1행 |
| L7/SEC-01 업로드 401이 세션에 닿지 않음, JWT 모드 업로드 자격 증명 경로 없음 | 확인 | Medium·P2 | 업로드 client는 401을 AUTH_REQUIRED 실패로만 돌려준다(src/adapters/http/fileserver-upload.ts:707-755, 종류는 envelopeFailureReading → src/contracts/errors.ts:320-321). 알릴 hook이 없다(:131-158). 401을 세션·onCredentialRejected로 보내는 곳은 V3 경로뿐이다(src/bootstrap/runtime-adapters.ts:605-623, :675-680). 업로드 capability는 감싸지 않고 넘긴다(:730-734). 매뉴얼은 반대로 적는다: docs/manual/02-decision-tables.md:492 "그 401은 세션을 로그아웃시킨다(5절)", 5절 :354 "서버가 401을 주면 그 요청의 자격 증명을 낸 쪽만 안다". JWT 쪽: 짝 백엔드 기본은 jwt다(docs/manual/04-paired-backend-session.md:16). ProductCompositionContext에 세션 자격 증명이 없다(src/bootstrap/product-composition-contract.ts:80-101). §7 안내는 쿠키 프로필만 다룬다. 덜어 주는 것(등급 유지): AUTH_REQUIRED의 action이 reauth라 기능이 다시 로그인 버튼을 줄 수 있다(src/contracts/errors.ts:69). 다음 V3 401이 세션을 내린다. 그래서 P1이 아니다 |
RED: tests/unit/runtime-adapters-credential-order.test.ts fixture에 제품 fileserverUpload capability + onCredentialRejected spy. MSW POST /v1/files 401 → spy 1회(지금 0회). 업로드 client 단위 동작은 tests/integration/fileserver-upload.test.ts:367 옆 |
예. (a) 템플릿이 업로드 capability를 감싸거나 (b) FileserverUploadClientDependencies에 hook을 더한다(http 배럴 표면). JWT용으로 ProductCompositionContext에 함수를 더한다(제품 조합 계약) |
없음. 같은 블록의 declare module은 L9/R-01 |
L7/SEC-02 minimumReleaseAgeExclude 네 줄이 자기 재검토 조건을 넘김 |
확인 | Low·P3 | pnpm-workspace.yaml:9-18. 주석의 재검토 조건("older than the configured minimum release age")이 이미 찼다. 설정 키가 없어 pnpm 11 기본 1,440분이다(tests/unit/pnpm-install-policy.test.ts:12, renovate.json:7). 네 버전은 2026-07-25에 넣었다. 지워도 시험은 빈 목록을 받는다(pnpm-install-policy.test.ts:28-36) |
줄만 지우면 시험은 필요 없다. 규칙을 더하려면 tests/unit/pnpm-install-policy.test.ts에 "항목마다 지나지 않은 만료일" 단언(지금 실패) |
아니오(설정 정리. 게이트 기준을 낮추지 않음) | 없음 |
| L7/SEC-03 secret scan·공급망 범위 설명이 실제보다 좁음 | 확인 | Low·P3 | 설명: config/repository-layout.json:15, docs/security/supply-chain.md:24-25. 코드: git ls-files 전부를 읽고(scripts/lib/repository-file-inventory.ts:89-91), trackedRoots는 비지 않았는지만 본다(:262-273). 정책에 includedPaths가 없어 전부 검사한다(scripts/lib/secret-scan-policy.ts:34, scripts/lib/secret-scan-evaluator.ts:172-175). 공급망 source 집합도 추적 파일 전부다(scripts/generate-supply-chain.ts:202). 코드 읽기로 충분해 EXP-L7-02는 필요 없다 |
지키는 시험: evaluateSecretScan에 trackedRoots 밖 추적 파일(docs/x.md)의 비밀값을 넣어 발견이 나는지 고정(지금도 통과) |
아니오(문서 문구. 검사 범위는 줄이지 않음) | 없음 |
2. 실험 목록
모두 확인을 E2로 올리는 실험이다. 판정을 가르는 데 꼭 필요한 실험은 없다. desktop에서 작업 폴더를 되돌리며 돈다. env 없음.
| ID | 대상 | 명령 | 패치 | 기대 결과 |
|---|---|---|---|---|
| X-L1-01 | L1/R-02 | scripts/verify.sh exec -- node scripts/run-vitest.ts run tests/component/r9-l1-form-resend-remount.test.tsx |
r1-L1-react.md 4절 X-L1-01 그대로. LocaleContext에 기본값이 있어(src/presentation/i18n/locale-provider.tsx:72) provider 없이 돈다. 둘째 경우를 더한다: resendUnknown(async () => ({ ok: false, error: createFailure("RATE_LIMITED", "X", 0, { effect: "NOT_APPLIED", httpStatus: 429 }) })) 뒤 settleApplied() → 값 유지 |
지금 두 경우 모두 실패(값 "", dirty=false). 고친 뒤 통과 |
| X-L1-02 | L1/R-03 | r1-L1-react.md X-L1-02 그대로 |
같은 곳 | 새 경우 1건 실패(emit 1회). 나머지 통과 |
| X-L1-03 | L1/R-04 | r1-L1-react.md X-L1-03 그대로. createQueryClient는 배럴에 있다(src/adapters/query-cache/index.ts:23) |
같은 곳 | 지금 실패(기록 1건, error_kind: APPLICATION_QUERY_ERROR) |
| X-L1-04 | L1/R-05 | r1-L1-react.md X-L1-04 그대로 |
같은 곳 | 지금 실패(다시 시도 중 stale-degraded) |
| X-L9-01 | L9/R-01 | r1-L9-adapters.md X-L9-01 그대로 |
같은 곳(수정 담당이 만든다) | 그대로 적용: check:types:node 실패, rc≠0. 고친 안: rc=0 |
| X-L9-02 | L9/C-01(선택) | scripts/verify.sh exec -- node scripts/run-vitest.ts run tests/unit/opfs-worker-runtime.test.ts |
r1-L9-adapters.md X-L9-02(네 지점 hook) + 변이 finalizePut의 getDirectory(…, false) → true |
변이 없음: 네 지점 모두 통과(반박 근거가 E2가 된다). 변이: "commit 뒤 finalize 전"이 실패. 변이 없이 실패하면 반박을 거두고 C-01을 확인된 결함으로 다시 매긴다 |