322 Commits
Author SHA1 Message Date
donghyeon.kang c7649c7fea Merge pull request 'perf: 공개 첫 화면에서 MOCK·Studio 코드를 빼고 초기 JS 예산을 측정값으로 정한다' (#9) from perf/initial-js-budget into main 2026-11-12 21:51:04 +00:00
DongHyeonka 8422c41e76 fix(build): 번들 기능 소유 검사가 직접 조립하는 TechLog를 받아들인다
문제
FE-GATE-012의 check:app-build-input:bundle은 production 번들에 든
`src/features/<dir>/` 모듈이 모두 앱의 context가 소유한(생성기로 설치한)
기능이어야 한다고 본다. TechLog는 조립부가 직접 붙이는 기능이라
(`src/features/tech-log/NOT_INSTALLED`) 어떤 context도 소유하지 않는다.
그래서 이 검사는 TechLog의 모든 production 번들을 거절한다. 9-29 템플릿
동기화(af3d8e6)로 들어온 뒤, 같은 게이트의 번들 예산 검사가 먼저 실패해
한 번도 이 단계까지 가지 않았다. 예산을 맞추자 드러났다.

고른 방법
- DIRECTLY_COMPOSED_FEATURE_DIRECTORIES(["tech-log"])를 두고, 번들 쪽
  검사에서만 이름으로 허용한다.
- 생성 인덱스 쪽 검사는 그대로다. 생성기가 TechLog를 import하면 여전히
  실패한다.

버린 대안
- NOT_INSTALLED 표시가 있는 디렉터리를 모두 허용: reference-feature와
  local-draft-feature도 NOT_INSTALLED다. 그 샘플이 번들에 새면 이 검사가
  잡아야 한다.

위험·한계
- 템플릿 소유 스크립트를 고친다. TechLog를 feature-module.ts로 옮기는
  후속 작업(docs/operations/template-sync-2026-09-29.md)을 하면 이 목록을
  지운다.

검증
- tests/architecture/app-build-input.test.ts: TechLog 모듈은 받아들이고,
  같은 번들의 reference-feature는 거절한다.
- desktop CI env에서 이 커밋 전 head로 돌린 FE-GATE-012: 번들 예산은 PASS
  (229,223 / 230,400 B), check:app-build-input:bundle이 "production bundle
  contains feature \"tech-log\" not owned by app template-app"으로 실패.
2026-11-12 22:38:22 +09:00
DongHyeonka 7558a8f495 build(perf): 초기 JS 예산을 TechLog 측정값으로 225 KiB에 둔다
문제
예산 204,800 B는 템플릿을 받을 때의 기본값이다. TechLog는 기능을
붙인 뒤 예산을 다시 정하지 않았다(템플릿 문서는 첫 기능을 추가하기
전에 정하라고 한다). 앞 커밋들로 초기 JS를 300,869 B에서 229,224 B로
줄였지만, 템플릿 공통 부분(react-dom·react-router·zod·tanstack·플랫폼
src)만 약 205 KB여서 TechLog 코드를 모두 빼도 204,800 B 안에 들지
않는다.

고른 방법
- 템플릿 규칙(1106/15-01, 결정 D9)을 그대로 쓴다. CI env 측정값에
  기능 하나의 상한 1 KiB를 더해 KiB 단위로 올린다. 229,224 + 1,024 =
  230,248 B → 225 KiB = 230,400 B. 여유 1,176 B는 기능 하나와 올림
  몫이다.
- docs/operations/performance-evidence.md에 전후 수치, 뺀 것, 204,800 B로
  돌아가지 못한 이유, 다시 볼 조건과 되돌림 규칙을 적는다.
  feature-shape-ceilings.json의 예산 언급도 맞춘다.

버린 대안
- 남은 TechLog 몫(문구 catalog 약 7.5 KB, 공개 HTTP gateway·mapping 약
  6.7 KB, Studio·관리·공개 계약 약 6.6 KB, 모듈 단독 gzip)을 더 빼기.
  문구와 계약은 부팅 때 합쳐 검증하는 구조라, 템플릿 15-01(기능 실행부를
  라우트 진입 때 적재)을 옮기는 템플릿 동기화 일이다. 공개 gateway는
  첫 화면 데이터 요청에 쓰인다.

위험·한계
- 예산이 템플릿보다 23,552 B 크다. 템플릿 동기화로 15-01을 받으면 다시
  재고 같은 규칙으로 내린다. 측정값이 203,776 B 이하이면 200 KiB로
  돌아간다.

검증
- desktop CI env(CI=true, VITE_BUILD_ID, RELEASE_ID, VITE_COMMIT_SHA,
  CI_RUNNER_IMAGE): 초기 JS 229,224 B, 초기 파일 28개, 가장 큰 lazy
  chunk 40,038 B(예산 122,880 B).
2026-11-12 22:33:48 +09:00
DongHyeonka 0bb8f1df9c perf(build): design-system 모듈을 side effect 없음으로 선언한다
문제
공개 셸은 design-system/index.ts 배럴에서 Button 몇 개를 가져온다.
번들러는 배럴이 다시 내보내는 모듈을 side effect가 있다고 보고 모두
싣는다. 그래서 공개 첫 화면이 쓰지 않는 navigation·overlays·patterns
primitive와 폼 모듈(use-app-form 등)이 초기 JS에 있었다.

고른 방법
- 템플릿 1101/08-08(51941a54)과 같은 treeshake.moduleSideEffects 규칙을
  vite.config.ts에 둔다. 같은 vite 8.1.5다.
- design-system 파일은 선언만 하고 top-level 효과가 없다. 효과만을 위한
  import(`import "x"`)는 이 선언 아래에서 모듈과 같이 사라지므로,
  tests/unit/design-system-side-effects.test.ts가 그런 import가 없는지
  본다. CSS는 bootstrap/main.tsx에서 읽는다.
- 배럴을 통해서만 닿던 폼 모듈도 같이 빠진다. 폼 모듈에도 top-level
  효과가 없는 것을 확인했다.

위험·한계
- 초기 파일 수가 27개에서 28개로 는다. HTTP/2에서는 진입 청크의
  preload 목록으로 병렬로 받는다(템플릿 같은 판단).

검증
- desktop CI env 분석 빌드: 초기 JS 229,765 → 226,554 B(-3,211 B,
  분석 빌드 기준. 공식 수치는 예산 커밋).
2026-11-12 22:33:48 +09:00
DongHyeonka 02cf5ed3f9 perf(studio): Studio 셸을 /studio에 들어갈 때 받는다
문제
라우트 레이아웃 표(tech-log-route-runtime.tsx)가 StudioShell을 정적으로
가져와, 공개 화면의 초기 JS에 StudioProvider·Studio 머리말·문서 server
state가 들어갔다.

고른 방법
- STUDIO 레이아웃은 lazy StudioShell을 Suspense와 ChunkRecoveryBoundary로
  감싼다. 청크를 못 받으면 라우트 청크와 같은 recoverChunk가 한 번 새로
  읽기를 정한다(chunkId `tech-log-studio-shell`).
- tests/features/tech-log/boot-graph.test.ts가 부팅 그래프(main.tsx, 그
  정적 import, 진입점이 바로 동적으로 읽는 boot·render-boot-failure)를
  빌드 없이 따라가, MOCK 소스·정적 콘텐츠·Studio 화면·HTTP Studio
  gateway가 다시 들어오지 않는지 본다. 공개 셸과 기능 입력 조립이
  그래프에 있는지도 봐서 빈 결과로 통과하지 않는다.

버린 대안
- 템플릿 소유 app-router.tsx에서 레이아웃 route에 lazy를 거는 것: 템플릿
  파일을 고치게 되고, 자식 화면 청크는 여전히 셸 뒤에 받는다.

위험·한계
- /studio 첫 진입은 셸 청크를 받은 뒤 화면 청크를 받는다(직렬 왕복 하나).
  Studio는 작성자 한 사람이 쓰는 화면이다.
- 셸을 받는 동안 LoadingSurface가 보인다.

검증
- desktop CI env 빌드: 앞 커밋과 함께 초기 JS 300,869 → 232,337 B.
- boot-graph.test.ts 통과.
2026-11-12 22:33:48 +09:00
DongHyeonka 8e0ea60eac perf(tech-log): MOCK 소스와 Studio gateway를 첫 사용 때 받는다
문제
런타임 문서가 MOCK·HTTP를 고르므로 두 소스가 모든 빌드에 들어간다.
기능 입력 조립(create-tech-log-feature-input.ts)이 MOCK 공개 콘텐츠,
MOCK·HTTP Studio gateway를 정적으로 가져와, 운영(HTTP) 공개 화면을
여는 사람도 그 코드를 초기 JS로 받았다. MOCK이 쓰는 content-format은
마크다운 파서(micromark·mdast·unified)까지 끌고 왔다. 초기 JS는 main
에서 300,869 B(gzip)로 예산 204,800 B를 넘는다(FE-GATE-012).

고른 방법
- 포트는 이미 모두 Promise를 돌려준다. deferAsyncPort가 포트를 먼저
  만들고 첫 호출에서 구현 모듈을 동적 import해 넘긴다. 호출하는 쪽과
  feature input의 모양(publicContent, createStudioApplication)은 그대로다.
  - 포트 키 목록은 `Record<keyof Port, true>`로 적어, 포트에 메서드가
    늘거나 줄면 타입 검사가 실패한다.
  - 구현 받기에 실패하면 잊고 다음 호출에서 다시 받는다.
- MOCK 공개 콘텐츠는 첫 조회 때 받는다. HTTP 공개 gateway는 공개 첫
  화면의 데이터 요청에 쓰이므로 그대로 둔다.
- Studio gateway 셋(MOCK이면 Studio state 하나를 나눠 씀)은 묶음 하나로
  받는다(mock-studio-gateways.ts, http-studio-gateways.ts).
  createStudioApplication은 Studio가 마운트될 때 불리므로 그때 바로 받기
  시작한다(startNow). 첫 조회 때 받으면 화면 청크 → 조회 → gateway 청크
  → 요청으로 한 번 더 기다린다.

버린 대안
- createStudioApplication을 async로 바꾸기: StudioProvider와 시험 15곳이
  함께 바뀐다. 포트가 이미 비동기라 필요 없다.
- 공개 HTTP gateway도 지연 로드: 첫 화면 데이터 요청 앞에 청크 왕복이
  하나 생긴다.

위험·한계
- MOCK 빌드(로컬·e2e·visual)는 첫 공개 조회와 첫 Studio 조회 앞에 청크를
  한 번 받는다.
- 포트 메서드가 동기 값을 돌려주게 바뀌면 이 방식은 맞지 않는다. 타입
  제약(모든 멤버가 Promise를 돌려줌)이 그때 컴파일에서 막는다.

검증
- desktop CI env 빌드: 초기 JS 300,869 → 232,337 B(Studio 셸 지연을
  포함한 측정, 다음 커밋). 빠진 모듈 179개 중 npm(마크다운 파서) 약
  88 KB, mock 23 KB, static 11 KB(모듈 단독 gzip 합).
- tests/features/tech-log/deferred-async-port.test.ts: 한 번만 받기, 동시
  첫 호출, 실패 뒤 다시 받기, 키·freeze, gateway 셋의 state 공유, startNow.
2026-11-12 22:33:48 +09:00
donghyeon.kang e5fe335e5a Merge pull request 'fix: 브라우저 게이트를 초록으로(Studio mock·화면 도착 처리·부팅 실패 청크·visual 기준·WebKit 경합)' (#8) from fix/browser-gates-green-v2 into main 2026-11-12 11:28:36 +00:00
DongHyeonka bf03c28682 test(visual): 지금 화면으로 visual 기준 이미지 129장을 다시 만든다
visual 기준 이미지는 2026-08-18(cf45bcc)이 마지막이다. 그 뒤로 화면을
바꾼 커밋이 130개 들어왔고, 기준은 한 번도 갱신되지 않았다. 그래서
test:visual 133건 가운데 2건(평문 NOT_FOUND)만 통과했다.

달라진 이유는 아래와 같다(이미지별 표는 PR 본문).
- 공개 화면: 9월 개편(b9d0585 바탕화면 디자인 수정본, 0b0c5cb 홈의 길,
  fe1f235·d3bf392 기록 머리와 읽기 품질, e88ed5e·5399e19 조사 상태,
  aca4f18·de4cb8b 주제 목록과 탭 등), 질문 라벨 대비(cd4fa8c).
- Studio 화면: 로그인한 Studio를 찍는다(500dbc6). Studio 재설계와 v4 블록
  편집기(9545860, d72eae2 등), MOCK 관리 데이터(이 브랜치의 관리 mock:
  대시보드 「지금 집중하는 것」).
- 모르는 slug 20장: SPA 안의 not-found(6784eb1, 이 브랜치의 visual 수정).
- 편집기 360px: 블록 손잡이 여백(이 브랜치의 935px 이하 수정).

검토한 방법:
- visual이 찍는 56개 화면을 같은 조건(고정 시계, Studio 로그인)으로 열어
  오류 화면, aria-busy, 로그인 관문, 콘솔 오류를 셌다. 의도한 not-found
  화면 말고는 없었다.
- 옛 기준과 새 기준을 나란히 놓고 범주마다 봤다. 의도와 다른 차이가 하나
  있었다. 공개 화면 h1에 파란 초점 테두리가 생긴 것이다(이 브랜치의 도착
  초점 처리가 h1에 data-route-heading을 달지 않았다). 그것은 기준을
  바꾸지 않고 코드에서 고쳤다(f78ce58에 합침).
- desktop 호스트(chromium, CI env)에서 test:visual:update. 그 뒤
  test:visual 두 번 연속 132건 통과(즉시 미리보기 1건은 지웠다).

한계: 이 호스트에서 만든 기준이다. 8월 기준도 같은 호스트에서 만든 것이고
평문 NOT_FOUND 2장이 이번에도 바이트까지 같다. CI 컨테이너
(playwright --with-deps)에서 픽셀까지 같은지는 확인하지 못했다.
2026-11-12 18:38:37 +09:00
DongHyeonka 4a39300941 test(e2e): Studio 화면 시험이 로그인 뒤 데이터가 그려진 다음 시작한다
signInToStudio는 로그인 뒤 Studio 머리말과 networkidle까지 기다린다. 그런데
mock Studio는 네트워크를 쓰지 않아 networkidle이 바로 오고, 화면은 그 뒤
약 0.3초 동안 aria-busy(데이터 로딩)였다가 본문을 그린다. 그래서 visual
「TECH_LOG_STUDIO_DOCUMENT_EDIT 360px」가 두 번 연속 로딩 상태(1000px)를
찍어, 다시 만든 기준(2077px)과 달라 떨어졌다.

main 안에 aria-busy가 없어질 때까지 기다린다.

검증: 로그인 뒤 100 ms마다 잰 값(chromium, 360px)에서 /studio,
/studio/documents, 편집 화면 모두 처음 세 번은 busy 1, 높이 1000이었고
네 번째부터 busy 0과 본문 높이가 됐다. 고친 뒤 test:visual 두 번 연속
132건 통과(PR 표).
2026-11-12 18:38:30 +09:00
DongHyeonka 40075c9afd test(browser): WebKit의 「preload를 몇 초 안에 안 썼다」 추측 경고를 받아들인다
WebKit은 load 이벤트 3초 뒤, 아직 쓰이지 않은 link preload마다 경고를
한 번 낸다. 공용 fixture는 경고를 실패로 센다. 그런데 desktop 호스트의
WebKit은 화면 하나를 여는 데 4초 안팎이 걸려, 곧 쓰일 청크에도 이 경고가
나온다. app-shell 시험이 3회 반복 중 한 번 이것으로 떨어졌다
(document-kind-labels-*.js).

템플릿(1103/11-09)과 같은 문장 정규식으로 이 경고만 무시한다.

한계: 템플릿은 이 추측 대신 「preload한 스크립트가 실제로 실행됐는지」를
모든 엔진에서 직접 검사한다(preload-use.ts, 시험 서버가 빌드 스크립트에
표시를 넣는다). 그 장치는 CSP·SW 시험의 응답 가로채기까지 같이 고쳐야
해서 옮기지 않았다. 그래서 쓰이지 않는 preload는 지금 어느 엔진에서도
잡히지 않는다. 다음 템플릿 동기화 때 옮길 일이다.

검증: app-shell을 포함한 다섯 시험을 세 엔진에서 3회 반복해 81건 통과.
2026-11-12 18:38:30 +09:00
DongHyeonka 9095c6337e test(e2e): 템플릿에서 온 시험이 앱이 그려진 뒤부터 잰다
scroll-restoration, production-csp, old-tab-chunk-recovery,
boot-module-failure는 템플릿처럼 page.goto 뒤 첫 expect(5초) 안에 첫
화면이 그려지기를 기다린다. desktop 호스트의 WebKit은 화면 하나를 여는
데 혼자 돌 때도 3.8~4.6초가 걸린다(Case 화면, Chromium 0.93초). 그래서
다른 worker와 함께 돌면 5초를 넘겨 「불러오는 중」에서 떨어진다. 전체
test:e2e와 3회 반복에서 webkit만 이렇게 떨어졌다.

이 제품의 다른 브라우저 시험처럼 앱이 그려진 것(.site-frame, 부팅 실패면
alert)을 먼저 기다린다. scroll-restoration은 gotoTechLog로 연다. 시험하는
것(스크롤 위치, CSP, 다시 불러오기 횟수, 실패 화면 내용)은 그대로다.

부팅 실패 청크 수정 전후 WebKit 시간이 같아서(JS 14개일 때 3.8~4.6초,
36개일 때 3.8~4.1초) 청크 수가 원인은 아니다.

검증: 네 시험과 app-shell을 chromium·firefox·webkit에서 --repeat-each=3으로
81건 모두 통과.
2026-11-12 18:38:30 +09:00
DongHyeonka abe4ec97bc fix(studio): 블록 편집기 손잡이 여백이 935px 이하에서 화면 밖으로 나가지 않는다
본문 블록 편집기(d72eae2, 09-16)는 드래그 손잡이와 블록 동작 칸을 읽기
단 바깥에 둔다. 그래서 section.studio-block-editor에 margin 0 -38px를 준다.
그런데 편집 화면의 옆 여백은 936px 이상에서만 38px 이상이다. 그 아래로는
24px(single-surface .studio-main이 100% - 48px), 760px 이하에서는 14px다.
그래서 761~935px에서는 14px, 760px 이하에서는 4px만큼 페이지 전체가
가로로 스크롤된다(760px 이하 규칙의 -18px도 14px 여백보다 넓다).

e2e의 「Studio editor has no overflow」는 이것을 잡지 못했다. 블록
편집기는 폼의 나머지보다 늦게 그려지는데, 시험은 그 전에 폭을 쟀다.
WebKit에서만 가끔 늦게 재서 900·820·768px이 떨어졌다.

손잡이 여백을 그 폭의 옆 여백에 맞춘다. 935px 이하는 24px(손잡이 칸
20px), 760px 이하는 14px(손잡이 칸 14px)이다. 936px 이상은 그대로다.
시험은 블록 편집기가 그려진 뒤에 잰다.

버린 대안: 상위 요소에 overflow-x: clip. 스크롤은 없어지지만 손잡이가
화면 밖에서 잘린 채 남는다.

검증:
- 폭별 측정(chromium): 고치기 전 935px 1, 930px 3, 920px 8, 900~761px 14,
  760px 이하 4px 넘침. 936px 이상은 0.
- 시험만 고친 상태에서 chromium·chromium-compact의 Studio editor 20건 중
  14건(935px 이하 일곱 폭 × 2) 실패. 고친 뒤 tech-log-responsive.spec.ts가
  chromium·firefox·webkit·chromium-compact에서 88건 모두 통과.
2026-11-12 18:38:30 +09:00
DongHyeonka 75eea39a0e test(visual): 편집기에서 빠진 즉시 미리보기의 visual을 지운다
「Studio immediate preview」 visual은 편집기의 「즉시 미리보기」 영역을
찍는다. d72eae2(09-16)가 편집기의 편집/미리보기 모드를 없애며 이 영역을
뺐고, 단위 시험은 그때부터 「없음」을 확인한다. visual만 남아 영역을 찾지
못하고 떨어진다.

시험과 기준 이미지를 지운다. 공개 렌더는 Public Preview 화면의 visual
(current-preview 등)이 계속 본다.
2026-11-12 18:38:30 +09:00
DongHyeonka f3a4e83b7e test(visual): 모르는 slug 화면이 SPA 안의 not-found를 찍는다
visual의 「unknown Public …」 20건은 /projects/missing-project 같은 경로가
서버의 평문 「Not Found」를 받는다고 기대하고, 그것을 찍는다. 6784eb1
(08-20)부터 서버는 등록된 Public 경로 패턴이면 SPA를 내고, 게시되지 않은
slug는 화면 안의 not-found(「페이지를 찾을 수 없습니다.」)가 된다. 그래서
글자를 찾지 못해 스크린샷 전에 떨어진다.

화면 안의 not-found h1과 site-frame을 확인하고 찍는다. 경로가 없는
NOT_FOUND의 평문 응답 visual은 그대로다. 기준 이미지는 visual 기준 갱신
커밋에서 새로 만든다.
2026-11-12 18:38:30 +09:00
DongHyeonka 0dc11797a9 test(e2e): 오래된 탭 시험이 새 화면의 h1을 기다린다
오래된 탭 시험은 A 빌드 탭에서 「프로젝트」를 누른 뒤
getByRole("heading", { name: "프로젝트" })가 보이면 다시 불러오기가 한 번
있었는지 센다. 그런데 탭이 아직 머물러 있는 홈 화면에도 h2 「프로젝트」가
있다. 그래서 A의 프로젝트 청크가 404가 나고 다시 불러오기가 시작되기 전에
조건이 맞고, 다시 불러오기 0번으로 떨어진다. 청크가 잘게 나뉜 뒤(부팅
실패 청크 수정) 다시 불러오기가 조금 늦어지면서 firefox·webkit에서
드러났다. PR #7에서 이 화면을 고를 때 이 h2를 보지 못했다.

새 화면의 h1을 기다린다.

검증: firefox trace에서 A의 route-tech-log-projects 청크가 404였고 그
뒤 release-manifest를 다시 받는 중이었다(다시 불러오기 직전). 고친 뒤
chromium·firefox·webkit에서 통과.
2026-11-12 18:38:30 +09:00
DongHyeonka c524a21463 test(browser): 다운로드 시험이 브라우저가 파일을 받은 뒤 런타임을 정리한다
이 시험은 BOUNDED_OBJECT_URL 다운로드로 Blob을 앵커에 넘기고, 브라우저의
download 이벤트를 기다린다. 그런데 deliver()가 handoff를 마치자마자
.finally(() => runtime.dispose())가 돈다. dispose()는 살아 있는 object URL을
즉시 해제한다(평소에는 30초 유예를 두지만 dispose는 정리라서 예외다).
WebKit은 앵커 클릭 뒤 다운로드를 비동기로 시작하므로, URL이 먼저 해제되면
다운로드가 시작되지 않는다. 그러면 download 이벤트 없이 30초 시험 제한으로
떨어진다. 2026-11-12 capability 실행 4번 중 1번 WebKit에서 이렇게 떨어졌다.

런타임을 전역에 두고, 다운로드 내용을 다 읽은 뒤 페이지에서 dispose한다.
제품의 해제 규칙(30초 유예, dispose 즉시 해제)은 바꾸지 않는다. 실제
화면에서 런타임은 다운로드 직후 버려지지 않는다.

검증: WebKit에서 --repeat-each=20으로 20회 모두 통과. 고치기 전 같은
조건 10회에서는 이 시험이 실패하지 않아 재현율은 낮다. 근거는 위 실패
로그와 dispose의 즉시 해제 코드(download-delivery-adapter.ts)다.
2026-11-12 18:38:30 +09:00
DongHyeonka 84afff4d75 test(browser): 막힌 IndexedDB 업그레이드 시험이 지나간 BLOCKED 상태도 본다
이 시험은 다른 탭이 v1을 연 채로 v2를 열게 하고, 런타임 상태가
BLOCKED가 되는지 본다. BLOCKED는 blockedTimeoutMs(500 ms) 동안만
있다가 CLOSED/NOT_OPENED로 바뀐다. 시험은 getStatus()를 바깥에서
expect.poll로 묻는데, poll 간격이 100·250·500·1000 ms로 벌어진다.
blocked 이벤트가 늦게 오면 그 500 ms가 두 번의 물음 사이에 지나가고,
시험은 뒤따른 CLOSED만 보다가 5초 뒤 떨어진다. WebKit에서 이 시험
하나가 10회 중 1회 이렇게 떨어졌다.

런타임의 subscribeStatus로 페이지 안에서 상태가 바뀔 때마다 기록하고,
그 기록에 BLOCKED가 있는지 본다. 재시도나 timeout을 늘려 덮지 않는다.
나머지 검증(열기 실패의 BLOCKED 오류, 막은 탭이 닫힌 뒤 늦은 연결을
닫음, 삭제)은 그대로다.

검증: WebKit에서 --repeat-each로 고치기 전 10회 중 1회 실패. 고친 뒤
20회 모두 통과(같은 실행의 다운로드 시험 20회 포함 40건).
2026-11-12 18:38:30 +09:00
DongHyeonka f78ce58201 fix(public): 공개 화면 이동 뒤 초점·해시·뒤로 가기 스크롤을 맞춘다
TechLog 공개 화면은 화면에 도착했을 때 할 일을 아무도 하지 않는다.
- 초점: 템플릿은 라우터가 #main-content에, PageHeader가 h1에 초점을
  준다. 이 제품은 9월 동기화 때 라우터의 초점 이동을 빼며 「shell이
  맡는다」고 적었지만, Public shell에는 그 처리가 없다. TechLog 화면은
  PageHeader를 쓰지 않는다. 그래서 이동 뒤에도 초점이 누른 링크(모바일
  메뉴에서는 닫힌 details 안의 링크)에 남는다.
- 해시: /cases/...#section으로 열면 맨 위에 머문다. 본문은 데이터를
  받은 뒤에 그려져, 브라우저의 기본 앵커 이동이 일어날 때 대상이 없다.
- 뒤로 가기: 브라우저 기본 복원은 돌아갈 화면이 그려지기 전에 일어난다.
  firefox는 0으로, webkit은 가끔 0으로 돌아간다.

Public shell에 useRouteArrival을 둔다. 템플릿의 PageHeader 방식을 따른다.
- 새 경로에 도착하면, 화면이 그려진 뒤(#main-content의 h1이 있고
  aria-busy가 없을 때, 최대 5초) 해시 대상을 보이게 스크롤한다. 그다음
  초점을 받을 수 있는 해시 대상, 아니면 h1(tabindex -1)에 초점을
  준다(preventScroll). 첫 로드에서는 아무것도 초점을 갖지 않았을 때만
  옮긴다.
- 뒤로·앞으로 가기: history entry(location.key)마다 떠날 때의 위치를
  기억하고, 화면이 그만큼 길어지면 그 위치로 돌린다. Public shell이 떠
  있는 동안 history.scrollRestoration을 manual로 둔다. 새로고침은 mount
  전이라 브라우저 복원을 그대로 쓴다. 떠나는 위치는 새 entry를 렌더할 때
  기록한다. 짧은 화면이 commit되면 window.scrollY가 그 순간 줄어들기
  때문이다.
- 쿼리만 바뀌거나 같은 화면의 # 링크는 도착이 아니다.
- jsdom에서는 라우터의 스크롤 처리와 같이 아무것도 하지 않는다.

버린 대안:
- 라우터(템플릿 소유 app-router.tsx)에 되살리기. Studio 화면들은 자기
  초점 처리를 따로 갖고 있어 영향이 넓다. 이번 결함은 Public 화면이다.
- 공개 화면 14개의 h1마다 PageHeader 같은 컴포넌트를 씌우기. 같은 일을
  화면마다 반복하게 된다.
- 위치를 sessionStorage에 두기. 저장소 API는 adapter 소유라 lint가
  막는다. 메모리 Map으로 충분하다(새로고침은 브라우저가 복원한다).

위험: 화면이 5초 안에 그려지지 않으면 그때의 h1이나 대상에 맞춘다.
Studio 경로는 바뀌지 않는다.

검증:
- 이 커밋 전에는 app-shell drawer 초점, scroll-restoration 해시가
  chromium에서 실패한다. 뒤로 가기는 firefox·webkit에서 실패한다.
- 이 커밋 뒤에는 app-shell, scroll-restoration, production-csp가
  chromium·firefox·webkit에서 통과한다. webkit scroll-restoration은 3회
  연속 통과했다.
- 공개 화면 단위 시험 5파일과 router 시험(합쳐 86건) 통과. check:types,
  lint rc=0.
2026-11-12 18:38:30 +09:00
DongHyeonka 8ca90db72f test(e2e): 스크롤 복원 시험이 900px 지점에서 화면을 떠난다
scroll-restoration 시험은 Case를 900px 내린 뒤 주요 탐색의 「프로젝트」를
누르고, 뒤로 가서 900px로 돌아오는지 본다. TechLog 머리말은 sticky가
아니어서, Playwright는 링크를 누르기 전에 머리말까지 페이지를 올린다.
그래서 화면을 떠나는 위치가 0이 되고, 900을 기대한 시험은 복원이 되든
안 되든 떨어진다. 템플릿의 머리말은 sticky라서 이 문제가 없었다.

링크를 스크롤 없이 누른다(dispatchEvent). 실제 사용자가 머리말까지 올려
누르면 떠나는 위치는 맨 위이고, 그것이 복원할 위치다.

검증: 이 수정만 넣고(복원 처리 없음) 돌리면 chromium은 브라우저 기본
복원으로 통과한다. firefox는 두 번 모두 실패하고, webkit은 두 번 중 한 번
실패한다. 다음 커밋이 그 복원을 맡는다.
2026-11-12 18:38:30 +09:00
DongHyeonka 9e20d471b0 fix(build): 부팅 실패 화면이 앱 그래프 청크 없이 그려진다
앱 모듈 하나가 평가 중에 예외를 던지면 main.tsx는 부팅 실패 화면
(render-boot-failure.tsx)을 그린다. 그런데 그 청크가 route-not-found
청크에서 값 둘을 import하고, route-not-found에는 React, i18n 카탈로그,
installed-feature-messages.ts가 같이 들어 있다. 그래서 예외를 던진
청크에 실패 화면도 같이 걸려 그리지 못하고, 정적 「불러오는 중」
화면이 계속 남는다(boot-module-failure e2e, 세 엔진 모두).

원인은 vite.config.ts의 manualChunks다. Rolldown은 manualChunks를
includeDependenciesRecursively가 기본값(true)인 group으로 바꾼다. 그래서
route-not-found로 지정한 Public not-found 화면이 자기 정적 의존을 전부
그 청크로 끌고 간다. PR #6 전(27e342d) 빌드도 같은 import가 있었다.

템플릿과 같은 output.codeSplitting.groups 형식으로 바꾼다. react-dom과
route 화면 group은 includeDependenciesRecursively: false로 둬서, 화면
모듈만 그 이름의 청크에 들어가게 한다. 공유 모듈은 Rolldown이 쓰는
쪽에 따라 나눈다. preload-helper·react-dom·route 청크 이름은 그대로다.

검증:
- build-environment-bundle.test.ts에 시험 하나를 더했다. 실패 화면
  청크에서 정적 import로 닿는 청크 가운데 installed-feature-messages의
  오류 문구가 든 것이 없어야 한다. 고치기 전에는
  route-not-found-*.js가 잡혀 실패했고, 고친 뒤 통과한다.
- vite-route-chunks, bundle-*, chunk-recovery*, performance-budgets 단위
  시험(29건) 통과.
- e2e: boot-module-failure, old-tab-chunk-recovery,
  service-worker-update·recovery, production-csp가 chromium·firefox·
  webkit에서 통과한다.
2026-11-12 18:38:30 +09:00
DongHyeonka baece798d2 test(e2e): Studio 이탈 확인 시험이 지금 Studio 탐색의 「게시」를 누른다
이탈 확인(저장하지 않은 변경) 시험 셋은 작업본을 고친 뒤 「게시 기록」
링크를 누른다. Studio 머리말의 주 탐색은 지금 「작업·구조·자료·게시」로
묶여 있어 그 이름의 링크가 없다. 그래서 로그인과 관리 mock이 갖춰진
뒤에도 링크를 기다리다 30초 제한으로 떨어진다.

같은 곳(/studio/publications)으로 가는 「Studio 주 탐색」의 「게시」
링크를 누른다. visual의 같은 장면도 같이 바꾼다.

검증: tech-log-accessibility.spec.ts와 accessibility.spec.ts가
chromium·firefox·webkit에서 102건 모두 통과한다.
2026-11-12 18:38:30 +09:00
DongHyeonka 03ac641a78 fix(studio): MOCK Studio의 주제·프로젝트·릴리즈 관리도 mock으로 돈다
create-tech-log-feature-input.ts는 Studio 문서와 Asset은
studioSource에 따라 mock과 HTTP를 고르는데, 관리 표면(주제·프로젝트·
릴리즈·홈 포커스·작업본 삭제)만 언제나 HTTP gateway를 썼다. 그래서
MOCK 빌드(로컬 개발, e2e·visual 빌드)에서 로그인한 Studio의 대시보드와
편집기가 주제·프로젝트를 읽으려고 API_BASE_URL의
/api/v1/studio/session으로 나가고, 연결이 거부된다. 브라우저 시험에서는
Studio 편집기 반응형 40건, Studio 접근성 7건, 경로별 axe의 Studio 두
경로 6건이 이것으로 떨어진다.

mock 문서 gateway와 같은 방식으로 mock 관리 gateway를 둔다.
- 메모리 안에만 있고, Studio 애플리케이션 하나가 사는 동안 유지된다.
- 주제는 MOCK_CATALOG, 프로젝트와 릴리즈는 공개 화면의 정적 콘텐츠
  (public-content.ts)에서 시작한다. 같은 이름과 slug를 쓴다.
- 실패는 백엔드와 같은 코드로 낸다(VERSION_CONFLICT, *_NOT_FOUND,
  게시된 것을 지울 때 CONFLICT).
- 같은 idempotency 키는 첫 결과를 돌려준다.
- 문서 gateway와 Studio state 하나를 나눠 써서, 관리 쪽에서 작업본을
  지우면 문서 목록에서도 빠진다. 그래서 createMockStudioGateway가
  state를 받을 수 있게 했다(주지 않으면 지금처럼 새로 만든다).

버린 대안: e2e에서 /api/v1/studio/**를 page.route로 가로채기. 로컬
개발 빌드는 그대로 깨진 채 남고, 시험만 초록이 된다.

한계: 결정(decision)과 프로젝트 활동은 빈 목록으로 시작한다. 공개
화면의 결정·활동 fixture는 관리 계약의 모양과 달라, 옮겨 담지 않았다.

검증:
- 새 단위 시험 mock-management-gateway.test.ts. 연결 전에는 첫 시험이
  「HTTP executor에 닿았다」로 실패했고, 연결 뒤 5건 모두 통과한다.
  mock-studio-gateway·Studio 화면 smoke·게시 흐름 시험(27건)도 통과한다.
- check:types, lint rc=0.
- chromium에서 Studio 편집기 반응형 10건, Studio 작업 흐름, 경로별 axe의
  Studio 경로가 통과한다(전에는 연결 거부로 실패).
2026-11-12 18:38:29 +09:00
DongHyeonka fcc35c73f4 fix(studio): 홈 포커스 편집기가 자기 초기화를 끝없이 반복하지 않는다
Studio 대시보드의 「지금 집중하는 것」(HomeFocusEditor)은 홈 포커스를
읽으면 effect에서 form.reset으로 값을 채운다. effect는 [focus,
form.reset]에 걸려 있다. 그런데 useAppForm의 reset은 defaultValues에
의존하고, 이 편집기는 defaultValues를 렌더마다 새 객체 리터럴로 넘긴다.
그래서 포커스가 한 번 읽히면 reset → 상태 갱신 → 다시 렌더 → 새 reset →
effect가 끝없이 돈다. 운영(HTTP)에서는 포커스가 있으면 대시보드가 계속
다시 그려진다. 시험 환경에서는 act가 끝나지 않아 시험이 멈춘다.

MOCK Studio에서는 지금까지 관리 기능이 HTTP로 나가 실패했기 때문에
포커스가 비어 있었고, 이 경로가 돌지 않았다. 관리 mock(다음 커밋)을 넣자
studio-shell-smoke.test.tsx의 첫 시험이 멈췄다(vitest worker CPU 100%로
19분, FE-GATE-005가 끝나지 않음).

defaultValues를 모듈 상수로 둔다. release-editor.tsx가 같은 이유로
EMPTY_RELEASE_DRAFT를 쓰는 방식과 같다.

검증: 관리 mock을 넣은 상태에서 이 수정 전에는 studio-shell-smoke의 첫
시험이 60초 timeout으로 끝나지 않는다. 수정 후 studio-shell-smoke·
studio-screens-smoke 8건이 5초에 통과한다. check:types, eslint rc=0.
2026-11-12 18:38:29 +09:00
donghyeon.kang 032ba31980 Merge pull request 'test: 브라우저 게이트의 시험 쪽 실패를 고치고 질문 라벨 대비를 올린다' (#7) from fix/browser-gates into main 2026-11-12 06:45:21 +00:00
DongHyeonka 9077a8d987 test(e2e): 오래된 탭 시험이 홈에서 미리 받지 않는 화면 청크를 쓴다
old-tab-chunk-recovery 시험은 A 빌드 탭을 연 채 B를 배포하고 「탐색」을
누른다. A의 탐색 청크가 서버에 없으니 탭이 한 번 B로 다시 불러와야 한다.
그런데 홈 화면이 탐색(과 프로필) 청크를 modulepreload로 미리 받는다.
탭이 이미 그 청크를 가지고 있어 서버에 묻지 않고, 다시 불러오기가 0번이라
떨어진다.

미리 받지 않는 「프로젝트」와 「주제」 화면으로 바꾼다. 허용하는 실패
요청 정규식도 그 두 청크 이름으로 바꾼다.

검증: 이 시험이 chromium·firefox·webkit 모두 통과한다. 홈에서 받는
route 청크 목록(explore·case·profile·search·not-found·home)은 빌드한 앱을
열어 performance 항목으로 확인했다.
2026-11-12 15:03:17 +09:00
DongHyeonka a124e11463 test(e2e): Service Worker 갱신 시험을 이 제품의 빌드에 맞춘다
service-worker-update 시험이 두 가지를 템플릿 빌드 기준으로 가정한다.
- 빌드 B에서 바꿀 route 화면으로 src/presentation/pages/not-found-page.tsx를
  연다. 이 제품에는 없는 파일이라 beforeAll이 ENOENT로 떨어지고, 이
  파일의 시험 넷이 전부 돌지 않는다.
- 캐시 목록을 dist/assets/의 모든 파일과 비교한다. 템플릿 빌드는 그
  폴더가 곧 정적 자산 집합이다. 이 제품은 두 방향으로 다르다. IBM Plex
  Mono의 .woff 대체 파일은 캐시 대상 확장자가 아니고(SW-RR-03, .woff2만),
  dist/media/의 SVG는 캐시 대상이다.

바꿀 화면은 같은 방식으로 lazy load되는 TechLog Public not-found 화면이다.
기대하는 캐시 목록은 빌드가 선언한 집합, 즉 생성기의 collectStaticAssets
결과다. route 청크가 사라졌는지 보는 곳은 그대로 dist/assets를 쓴다.

검증: service-worker-update.spec.ts 4개 시험이 chromium·firefox·webkit
모두 통과한다.
2026-11-12 15:03:16 +09:00
DongHyeonka 70f3125c8e test(e2e): 부팅 실패 fixture가 TechLog 메시지 카탈로그를 두 번 합친다
boot-module-failure 시험은 빌드 사본의 installed-feature-messages.ts에서
`composeInstalledMessageCatalogs(\n  INSTALLED_PRODUCT_FEATURE_MODULES,\n)`를
찾아 두 번 합치게 고친다. 같은 메시지 키가 두 번 들어가 모듈 평가 중에
예외가 나야 한다. 이 제품은 동기화 때 그 줄을 TechLog 카탈로그를 같이
합치는 배열로 바꿨다. 그래서 문자열을 찾지 못하고 빌드 전에 떨어진다.

TechLog 카탈로그 줄을 두 번 넣는다. 키가 겹쳐 같은 TypeError가 난다.

한계: 이제 fixture는 의도대로 동작하지만 시험은 여전히 떨어진다. 제품
결함이다. 예외가 나는 모듈이 route-not-found 청크에 묶이고, 부팅 실패
화면(render-boot-failure 청크)이 그 청크에서 두 값을 import한다. 그래서
부팅 실패 화면도 그리지 못하고 「불러오는 중」이 계속된다. 27e342d(PR #6
전) 빌드도 같은 import를 가지고 있어 react-dom 청크 분리 때문은 아니다.
청크 구성을 고치는 일은 이 PR 밖이다.

검증: 빌드 사본에서 「Duplicate ko-KR message key: route.TECH_LOG_HOME.title」
TypeError가 route-not-found 청크에서 나는 것을 trace로 확인했다.
2026-11-12 15:03:16 +09:00
DongHyeonka c408cc2e0e test(e2e): 템플릿에서 온 화면 시험을 TechLog 화면으로 옮긴다
09-29 템플릿 동기화(c80320d, ebea300→af3d8e6)가 템플릿 e2e 시험을
그대로 들여왔다. 그 시험은 이 제품이 지운 템플릿 예시 화면을 연다.
- app-shell: 제목 「Tech Log」(지금 브랜드는 「TechLog」), 템플릿 drawer의
  「메뉴」 버튼과 /examples/states.
- production-csp: 제목 「Clean Architecture Frontend」와 「화면 상태」 링크.
- scroll-restoration: /examples/ui와 .app-shell__header.
그래서 세 엔진 모두에서 요소를 찾지 못해 떨어진다.

같은 동작을 TechLog 화면으로 본다.
- 홈 제목은 TechLog, 이동할 화면은 주요 탐색의 「프로젝트」.
- drawer는 TechLog의 details.mobile-nav와 「모바일 주요 탐색」.
- 긴 화면은 Case(1280x720에서 약 6,000px), 해시 대상은 그 안의 h2.
- production-csp는 경로가 바뀐 것을 URL과 제목으로만 확인한다. 초점은
  app-shell 시험이 따로 본다. 그래야 초점 결함과 상관없이 CSP 검사가 돈다.

위험·한계: 옮긴 시험 가운데 셋은 제품이 그 동작을 하지 않아 여전히
떨어진다. 시험을 고쳐서 생긴 실패가 아니라, 템플릿 이름 때문에 가려져
있던 실패다.
- 경로 이동 뒤 초점: app-router.tsx는 「shell이 초점을 맡는다」며 이동을
  뺐지만, TechLog Public shell에는 초점 처리가 없다. drawer 링크로 이동해도
  새 화면의 제목으로 초점이 가지 않는다.
- 뒤로 가기 스크롤 복원: Case에서 900px 내려갔다가 다른 화면에 갔다
  돌아오면 0이다.
- 해시로 연 Case에서 대상 h2로 스크롤하지 않는다. TechLog 화면은 해시를
  처리하는 PageHeader를 쓰지 않는다(project-decisions-page만 따로 처리).
정할 것(초점 정책)이 있어 이 PR에서 제품을 고치지 않는다.

검증: production-csp는 세 엔진 모두 통과한다. 첫 번째 app-shell
시험(홈 부팅)과 scroll-restoration의 화면 열기까지는 통과하고, 위 세
동작에서 떨어진다.
2026-11-12 15:03:16 +09:00
DongHyeonka cfe587c13e test(e2e): HTTP 계약 시험이 경로 패턴으로 서빙하는 지금 서버를 따른다
6784eb1(08-20)부터 운영 서버는 빌드가 본 slug 목록이 아니라 등록된
Public 경로 패턴으로 SPA를 낸다. 빌드 뒤에 게시한 기록도 열려야 하기
때문이다. 그래서 /projects/missing-project는 이제 200으로 SPA를 받고,
화면 안에서 not-found를 보인다. 시험은 아직 그 경로가 edge 404라고
기대해 세 엔진 모두 떨어진다.

모르는 slug는 200 SPA를 기대한다. edge 404 사례는 경로 매개변수가 한
segment만 맞는다는 것을 보이는 /projects/missing-project/unknown-tab으로
바꾼다. 경로가 없는 /definitely-not-a-product-route는 그대로 둔다.

검증: tech-log-http-contract.spec.ts가 세 엔진 모두 통과한다.
2026-11-12 15:03:16 +09:00
DongHyeonka db69e5203b test(e2e): Studio 작업 흐름 시험을 fixture 시계로 돌린다
tech-log-studio-workflow.spec.ts만 page.goto로 들어가 실제 시계를 쓴다.
mock 저장본의 검증 결과는 2026-08-14 09:40~10:10 KST에만 유효해서,
실제 시각에서는 「지난 결과 · 저장 후 다시 검증해야 합니다」가 나오고
「현재 저장 버전의 검증을 통과했습니다」를 찾지 못해 떨어진다. 로그인도
하지 않았다.

다른 Studio 시험처럼 gotoTechLogStudio(fixture 시계 2026-08-14T01:00Z,
reduced motion, 데모 로그인)로 들어간다.

검증: 두 시험이 chromium·firefox·webkit 모두 통과한다.
2026-11-12 15:03:16 +09:00
DongHyeonka 500dbc6217 test(e2e): Studio 화면 시험은 데모 세션으로 로그인한 뒤 본다
5e2b1a5(08-20)부터 로그인하지 않은 방문자는 Studio 경로에서 로그인
화면만 받는다. e2e 빌드는 local profile(AUTH_MODE demo)이고, 데모
세션은 로그아웃 상태로 시작해 메모리에만 있다. 그런데 Studio 시험은
로그인하지 않고 들어간다. 그래서
- 편집기·접근성 시험은 로그인 화면에서 「저장」 버튼이나 「요약」 칸을
  기다리다 떨어지고,
- 경로별 axe 검사(accessibility.spec)와 visual 시험은 Studio 경로 12개에서
  Studio 화면 대신 로그인 화면을 검사하고 있었다.

tech-log-fixtures.ts에 gotoTechLogStudio를 둔다. gotoTechLog 뒤에
작성자가 쓰는 「로그인 시작」 버튼을 누르고, 로그인한 세션만 받는
Studio 머리말이 뜰 때까지 기다린다. Studio 경로를 여는 e2e·접근성·visual
시험이 이것을 쓴다.

버린 대안: 앱의 세션을 시험에서 직접 authenticated로 바꾸기. 로그인
버튼과 관문 동작을 건너뛰게 되고, 앱 내부에 시험용 구멍이 필요하다.

위험: 이 변경으로 Studio 화면을 실제로 검사하게 되면서, 로그인 화면에
가려져 있던 결함이 드러난다. MOCK Studio에서도 관리 기능(주제·프로젝트·
릴리즈)이 실제 HTTP(/api/v1/studio/session)로 나가 연결이 거부된다
(create-tech-log-feature-input.ts의 createManagementGateway에 MOCK 분기가
없다). 그 결함은 이 PR 밖이다. 그동안 Studio 편집기·대시보드 시험은
그 이유로 실패한다.

검증: Studio 경로에서 로그인 뒤 Studio 머리말과 주 탐색이 뜨는 것을
error-context 스냅숏으로 확인했다. 남은 실패는 모두 위 HTTP 요청이다.
2026-11-12 15:03:16 +09:00
DongHyeonka cd4fa8ce29 fix(a11y): 질문의 「다음 검증」 라벨을 WCAG AA 대비로 올린다
Question 화면의 「다음 검증」 상자 안 라벨(「왜 다음인가」 등)은
--faint(#6c6f76)를 info 바탕(#eef1fc) 위에 쓴다. 대비가 4.46:1이라
WCAG AA 4.5:1에 못 미친다. axe가 세 엔진 모두에서 color-contrast
serious로 잡아 FE-GATE-009(TECH_LOG_QUESTION)가 떨어진다.

이 두 라벨만 --muted(#5a5d64)로 바꾼다. 같은 바탕에서 5.85:1이다.
--faint 토큰 자체는 흰 바탕에서 5.03:1이라 다른 곳은 문제가 없어서
건드리지 않는다.

위험: 라벨 글자가 조금 진해진다. visual 기준 이미지 가운데 Question
화면이 바뀐다. visual 기준 이미지는 이 변경과 상관없이 8월 18일 것이라
전부 다시 검토해야 한다(PR 본문).

검증: test:a11y에서 TECH_LOG_QUESTION이 chromium·firefox·webkit 모두
통과한다(고치기 전 세 엔진 모두 color-contrast 실패).
2026-11-12 15:03:16 +09:00
DongHyeonka 0665cd764f test(browser): Firefox의 Pretendard name 표 경고 한 줄만 받아들인다
Firefox는 번들된 pretendard 1.3.9 가변 폰트를 열 때마다 콘솔에
「downloadable font: name: name records are not sorted」 경고를 낸다.
브라우저 시험의 공용 fixture(strict-browser-test.ts)는 경고도 실패로
세므로, Firefox에서는 폰트를 쓰는 거의 모든 시험이 떨어진다.
2026-11-12 main(7853ff1d) 기준으로 FE-GATE-008 e2e의 Firefox 실패
143건 중 118건, capability 19건 전부, FE-GATE-009의 29건이 이것
하나뿐이었다.

경고는 폰트 파일 안 name 레코드의 순서를 말한다. Firefox의 폰트 검사기
(OTS)가 순서를 고치고 폰트를 그대로 쓴다. Chromium과 WebKit은 아무것도
내지 않는다. 그래서 이 경고 한 줄만 fixture에서 무시한다. 폰트 이름,
가중치 범위, 파일 이름까지 맞는 문장만 받는다. 폰트가 거부되면
「rejected by sanitizer」 같은 다른 문장이 나오고, 그것은 여전히 실패다.

버린 대안: 폰트를 다시 써서(fonttools로 저장) 정렬된 파일을 repo에 두기.
npm 패키지 대신 고친 바이너리를 직접 관리하게 되고, 패키지를 올릴 때마다
다시 만들어야 한다.

위험: Pretendard를 다른 판으로 바꿔 경고 문장이 달라지면 이 정규식이
맞지 않아 다시 실패한다. 그때는 그 문장을 보고 판단한다.

검증 (desktop, Playwright 1.62, CI env):
- Firefox에서 빌드한 앱: Pretendard Variable status "loaded",
  document.fonts.check('16px "Pretendard Variable"') true, h1 글꼴
  Pretendard Variable. 경고는 그대로 한 줄 나온다.
- test:browser-capabilities: Firefox 실패 19건 → 0건.
2026-11-12 15:03:16 +09:00
donghyeon.kang 7853ff1d93 Merge pull request 'fix: main에서 실패하던 typecheck·unit·registry 게이트를 고친다' (#6) from fix/main-gates into main 2026-11-12 04:28:28 +00:00
DongHyeonka 953381a998 fix(ci): coverage 증거 검사가 summary의 branchesTrue를 받는다
FE-GATE-005의 증거 검사(scripts/lib/ci-artifact-validator.ts)는
coverage-summary.json 항목마다 lines·statements·functions·branches만
허용하는 .strict() schema를 쓴다. istanbul-lib-coverage 3.2.2는 summary에
branchesTrue를 넣으므로, 시험이 모두 통과해도 증거 단계에서 게이트가
"Unrecognized key: branchesTrue"로 실패한다. 같은 파일을 읽는
risk-coverage 검사는 이 키를 허용해 두 검사기가 갈라져 있었다.

템플릿 bca5fc27을 그대로 가져온다(git apply, 충돌 없음). 키 목록을
scripts/lib/coverage-summary-metrics.ts 한 곳에 두고 두 검사기가 같이 쓴다.
평가하는 네 지표와 보고기가 더할 수 있는 선택 지표(branchesTrue)를 나누고,
선택 지표도 counter 형식은 그대로 검사한다.

위험·한계: 다른 모르는 키는 여전히 거절한다(의도).

검증: 템플릿 커밋의 tests/unit/coverage-summary-artifact.test.ts를 같이
가져왔다. 결과는 이 브랜치 전체 게이트 실행에 적는다.
2026-11-12 13:10:47 +09:00
DongHyeonka f14ff71c9b fix(test): 낡은 검사 둘을 지금 코드에 맞춘다
앞 단계 시험이 실패해 가려져 있던 실패 둘이다. 둘 다 main에서도 같다.

- request-fanout(아키텍처 시험)이 collect-catalog.ts의 반복 안
  gateway.getCatalog()를 행마다 요청하는 N+1로 잡는다. 이것은 다음
  요청이 앞 응답의 nextCursor에 기대는 커서 페이지 넘기기라 묶을 수 없다.
  검사기가 정한 방식대로 그 줄에 `// fanout-reviewed: <이유>`를 단다.
- release-manifest 시험이 TechLog Studio 계약 버전을 3.0.0으로 기대한다.
  계약(contracts/studio/canonical-source.json)은 3.1.0이다. 시험은 일부러
  값을 글자 그대로 두는 설계라 그 값을 3.1.0으로 맞춘다.

검증: 두 시험 파일이 통과한다(고치기 전 각 1건 실패, main에서도 같음).
2026-11-12 12:50:28 +09:00
DongHyeonka a06cc8e4c4 fix(ci): 시험과 dev server가 CI의 빌드 식별값을 물려받지 않는다
CI workflow는 전체 env에 VITE_BUILD_ID=gitea-<run>-<attempt>와
VITE_COMMIT_SHA를 둔다. Vite는 이 값을 import.meta.env에 넣는다. 그래서
CI와 같은 env로 돌리면 앱을 local-build fixture release로 조립하는 시험
(runtime-application, boot-unexpected-failure,
runtime-composition-service-worker-telemetry)이 CONFIG_BUILD_MISMATCH로
실패한다. 로컬에서는 값이 없어 늘 통과한다.

템플릿 af312dee를 그대로 가져온다. vitest.config.ts가 두 값을 지우고,
dev server를 띄우는 Playwright 설정 둘은 webServer env로
VITE_BUILD_ID=local-build, VITE_COMMIT_SHA=local을 준다. build·preview를 쓰는
설정은 빌드가 같은 값으로 config.json을 만들므로 그대로 둔다.

위험·한계: vitest 안에서 CI 빌드 식별값을 검사하려는 시험은 값을 직접
넣어야 한다(지금은 없다). capability e2e(FE-GATE-008)는 돌리지 않았다.

검증: VITE_BUILD_ID를 준 채로 세 component 시험이 통과한다.
2026-11-12 12:50:28 +09:00
DongHyeonka 588ebca54f fix(registry): 9월 경로 변경을 registry에 등록하고 근거를 남긴다
check-registries가 이 repo에서 실패한다. 9월 커밋(67a54917 주제 변형
화면, b9e29369 UX 리뷰 H1)이 경로 계약을 바꿨지만 governance와 schema
registry는 그대로였다. 2026-09-29 템플릿 동기화의 baseline 승인도 「TechLog
경로 변경은 승인하지 않은 채 남긴다」고 적었다. 단위 시험
second-api-feature-registries가 이 실패를 그대로 드러냈다.

- schema registry에 TechLogTopicVariantParams(route-params,
  REJECT_UNKNOWN)를 더한다. 코덱(tech-log-route-codecs.ts)은 이미 있다.
- governance의 FE-REG-ROUTE 허용 값에 TechLogTopicVariantParams,
  TechLogStudioDocumentsSearch, TechLogStudioPublicationsSearch를 더한다.
- breaking 변경 여섯에 근거를 남긴다: 출시 화면이 주 내비에서 빠짐
  (navigationLabel·navigationOrder), Studio 문서·게시 목록이 검색·필터·
  쪽수를 주소에서 읽음(searchSchema·searchCodec).

baseline은 다시 만들지 않는다. 이 repo는 지금까지 breaking 변경마다 근거를
더하고 baseline은 템플릿 동기화 때만 승인했다(c5c8b942 등).

위험·한계: 근거의 내용은 이미 운영에 나간 변경을 사후에 적은 것이다.

검증: node scripts/check-registries.ts가 "11 registries PASS;
compatibility=breaking"을 낸다(고치기 전 11건 실패).
2026-11-12 12:50:28 +09:00
DongHyeonka ed47b562bc perf(build): react-dom을 자기 청크로 빼 빌드 id만 바뀐 배포의 캐시 손실을 줄인다
빌드 id는 부트 실패 화면이 보여 주므로 render-boot-failure 청크에
들어간다(getBuildConfig). react-dom과 scheduler가 같은 청크에 있어서
빌드 id만 다른 두 빌드에서 그 190,478 B 청크의 이름이 바뀌었다. 해시
자산은 오래 캐시되는데, 재방문 사용자는 코드가 같아도 배포마다 이만큼
다시 받았다. 단위 시험 build-environment-bundle이 이 청크가 바뀐다고
실패했다.

템플릿 af6d0a9f(1103/15-06)와 같은 방식이다. manualChunks에서 react-dom·
scheduler를 react-dom 청크로 뺀다. 시험은 템플릿 새 판처럼 디자인 시스템
청크를 이름 대신 내용(ui-button--pending)으로 찾아 고정됐는지 보고,
react-dom 청크가 고정이며 render-boot-failure가 아닌지 본다. 이전 시험은
빌드 id를 일부러 담는 render-boot-failure를 공용 청크로 잘못 골랐다.

위험·한계: 정규식은 pnpm의 node_modules 배치를 가정한다. 배치가 바뀌어
그룹이 비면 시험이 실패한다. boot(약 320 KB)는 빌드 id로 설정을 대조하므로
계속 이름이 바뀐다(템플릿과 같음).

검증: 빌드 id만 다른 두 빌드에서 이름이 바뀐 청크는 boot·index·
render-boot-failure 셋이고, render-boot-failure는 12,138 B로 줄었다.
react-dom 청크와 디자인 시스템 청크는 두 빌드에서 이름이 같다.
2026-11-12 12:50:28 +09:00
DongHyeonka 731612c04d fix(typecheck): route-runtime 음성 fixture가 이 제품의 경로로 진단을 낸다
FE-GATE-003의 route-runtime 음성 fixture는 템플릿 그대로
`{ APP_HOME: true } satisfies Record<RouteId, boolean>`이다. 이 제품에는
APP_HOME 경로가 없어서, 기대한 「빠진 경로」 진단(TS2740) 대신 「모르는
속성」(TS2353)이 나와 UNEXPECTED_DIAGNOSTIC로 떨어진다.

템플릿 e47a0ab2와 같은 방식으로 고친다. 정확히 한 경로만 뺀
`Omit<Record<RouteId, boolean>, "TECH_LOG_HOME">`을 대입하고, 기대 진단을
TS2741로 바꾼다. 빠진 키가 하나면 경로 수와 상관없이 TS2741이다(TS2739·
TS2740은 빠진 목록의 길이에 따라 갈린다). 뺄 경로는 이 제품에 있는
TECH_LOG_HOME이다.

검증: tsc -p tests/fixtures/typecheck/tsconfig.route-runtime.json이
TS2741(missingRuntime)과 TS2353(ORPHAN_ROUTE, 두 번째 음성 경우)을 낸다.
2026-11-12 12:50:28 +09:00
donghyeon.kang 27e342dd40 Merge pull request 'feat(deploy): 운영 frontend를 비특권 nginx로 돌릴 수 있게 한다(opt-in)' (#5) from feat/frontend-nonroot into main 2026-11-12 02:02:05 +00:00
donghyeon.kang eac1140d11 Merge branch 'main' into feat/frontend-nonroot 2026-11-12 02:01:49 +00:00
donghyeon.kang 0cff7213d3 Merge pull request 'feat(deploy): 운영 backend를 prod profile로 돌릴 수 있게 한다(opt-in)' (#4) from feat/backend-prod-profile into main 2026-11-12 01:58:41 +00:00
DongHyeonka ab3ad93886 Merge remote-tracking branch 'origin/main' into feat/frontend-nonroot 2026-11-12 10:14:31 +09:00
DongHyeonka be0e9e9c26 Merge remote-tracking branch 'origin/main' into feat/backend-prod-profile 2026-11-12 10:14:23 +09:00
donghyeon.kang 3b4c13e242 Merge pull request 'chore: 운영 이미지에만 있던 커밋 넷을 main에 넣는다' (#3) from chore/sync-production-7a4e201 into main 2026-11-12 01:13:39 +00:00
DongHyeonka e1441bedd7 copy: 주제 화면의 흐름 제목을 「맥락 순서」로 바꾼다
「결론까지 이어진 사고 흐름」은 추상어를 쌓은 말이었다. 이 구역이 하는 일은
이 주제를 어떤 순서로 읽으면 되는지 보이는 것이다.

(cherry picked from commit 7a4e201a2934e708c383bd0db132557ea659afad)
2026-11-12 08:28:55 +09:00
DongHyeonka 7420e29af0 fix: 본문이 2KB를 넘는 문서가 저장되지 않던 것
저장을 눌러도 요청이 나가지 않고 「저장하지 못했습니다.」만 떴다. 갓 만든
문서는 저장되고 글을 쓴 문서만 안 되어서 원인을 짚기 어려웠다.

명령의 신원을 만들 때 플랫폼은 `identity` 훅이 없으면 입력 전체를 쓴다.
그 신원은 `canonicalize` 를 지나고 거기에는 문자열 하나당 2KB 한도가 있다
(`contracts/query-keys.ts` 의 `maxStringBytes`). 본문이 그 한도를 넘는
순간 신원을 만들다 던지고, 명령은 `NOT_STARTED` 로 끝난다 — 전송 전이라
네트워크에도 콘솔에도 아무것도 남지 않는다. 실제로 걸린 문서의 본문은
11,222 바이트였다.

명령을 가리키는 이름은 「어느 문서에 대한 무슨 명령인가」이지 본문이 아니다.
문서 id 만 넘긴다. 같은 문서의 저장을 한 번에 하나만 돌리는 것이
`REJECT_WHILE_ACTIVE` 가 원하는 바이므로 이것으로 충분하다.

검사는 두 쪽을 같이 본다: 입력을 그대로 쓰면 실제로 던진다는 것과, 넘기는
신원은 본문 크기와 무관하다는 것. 앞의 절반이 없으면 한도가 사라져도
검사가 통과한다.

(cherry picked from commit 27f2182c7da2d6c5afbcf13ae0cf4ceaf6d9638c)
2026-11-12 08:28:55 +09:00
DongHyeonka 2fea5c58f4 fix: 다크 모드에서 흰 바탕에 흰 글씨로 나가던 것
배색을 토큰 별칭으로 옮기면서 TechLog 가 템플릿의 `--color-*` 를 가리키게
됐는데, 템플릿에는 `:root[data-theme="dark"]` 가 있고 그쪽이 더 구체적인
선택자라 TechLog 의 `:root` 를 이긴다. 운영체제가 어두운 화면을 쓰는 사람에게는
글자색만 뒤집히고 배경은 이 파일의 원색(`rgba(252, 252, 251, 0.94)`)이 그대로
남았다 — 스튜디오 헤더가 흰 바탕에 흰 글씨였고, 링크가 안 보이니 눌러도
아무 일이 없는 것처럼 읽혔다.

이 파일의 값은 전부 밝은 화면 하나만 상정하고 고른 것이므로 다크에도 같은
값을 건다. 템플릿의 밝은 값을 그냥 쓰던 여섯 개(hover·pressed·on-action·
disabled 계열)도 이름을 적어 둔다 — 적지 않으면 그 여섯만 혼자 어두워진다.

어두운 배색을 따로 그리는 일은 하지 않았다. 지금은 한 벌만 쓴다.

검사는 「템플릿이 어둡게 덮는 토큰은 TechLog 도 같은 조건에서 되돌린다」를
본다. 템플릿이 새 토큰을 어둡게 덮기 시작하면 그 이름을 짚는다 — 손으로
맞춘 목록은 반드시 낡는다.

(cherry picked from commit 42d1ae1f2da395eb69a29dfaec8bebcd7a003b63)
2026-11-12 08:28:55 +09:00
DongHyeonka c80320dfc7 chore: sync the frontend template from ebea300 to af3d8e6
Carries 359 template commits, tag v0.2.0 plus one documentation commit: the
generator-built feature index with its app, bounded-context and feature
declarations, the src/platform kernel and scale tooling, the 2026-09-24 src
review fixes, and the 2026-09-25 maturity review round with its CHANGELOG
[보안]/[계약] rows. 691 of the 824 template paths are applied, 85 of them
merged with product changes; 127 are not carried.

Product identity is unchanged: name, version 0.1.0, routes, design and the
TechLog domain.

Three decisions worth naming. TechLog stays composed directly, as the last
two syncs recorded; its directory carries a NOT_INSTALLED marker that says so,
and every installed-* composer takes the template's projection with TechLog
added on top. The reference sample is no longer installed: the template now
installs a feature only through feature-module.ts and context-routes.ts,
which load the screens this product deleted, so its three operations, six
schemas and one topic leave the registries, recorded as registry change
evidence. And AppRouter mounts the platform and TechLog routes only; the
template's bounded-context route gateway waits for a generator-installed
feature.

Required fixes: readSubject on the BFF session owner (without it every HTTP
Studio session would close as integration-failed), zod through the facade in
nine TechLog files, noUnusedLocals, and public/config.json written out to
match the local profile. Derived baselines were recomputed after reproducing
both sides' values: CI contract 101 commands / 106 references / 141
artifacts, gate shape c9adcf85; registry approval 2dc6c3a3; the runtime
config schema baseline equals the schema at 8210d48.

Verified here: types, lint, architecture, adapter inventory, CI contract,
i18n, design system, diagnostics, browser security, dev release manifest,
TechLog contract and build pass; 220 component, 155 integration, 15
contract, 418 TechLog, 43 reference-feature, 18 recipe and 46
release-coherence tests pass, and 2381 of 2383 unit tests. Reproduced at
8210d48 first and unchanged: check:registries (byte-identical),
test:runtime-schema, verify:documentation. Brought by the template and
escalated rather than suppressed: check:request-fanout on TechLog's cursor
pagination, check:remediation-ledger (fails upstream too), the shared-chunk
hash test, and the registry-dependent sample removal and second-feature
tests. Playwright suites were not run.

Full record, the five open questions and the follow-ups in
docs/operations/template-sync-2026-09-29.md.

(cherry picked from commit b2170cf265dea45dc9cc05d3c61e627e97f31cdb)
2026-11-12 08:28:54 +09:00