Commit Graph
966 Commits
Author SHA1 Message Date
DongHyeonka c9aa73fbfd refactor(scale): vite 빌드 입력 목록을 한 모듈에 둔다
문제: 초기 JS 측정(scripts/scale/measure-feature-shape-growth.ts)과
VITE_PRODUCT_FEATURES=none 빌드 테스트
(tests/unit/product-feature-selection-build.test.ts)가 임시 폴더에 복사할
빌드 입력 8개를 따로 적는다. vite.config.ts가 새 로컬 파일을 import하면
두 목록이 함께 낡고, 한쪽만 고치면 원인을 말하지 않는 "Could not resolve"로
실패한다(7f9a515, 799ab7f가 두 곳을 같이 고쳤다).

고른 방법: scripts/lib/vite-build-inputs.ts에 VITE_BUILD_INPUTS 하나를 두고
두 파일이 import한다. 측정 스크립트가 테스트 파일을 import하지 않는다.
새 tests/unit/vite-build-inputs.test.ts가 (1) 두 소비자에 자기 목록이
없고 이 모듈을 쓰는지, (2) vite.config.ts가 상대 경로로 닿는 모든 파일이
목록 안에 있는지 본다. (2)는 새 로컬 import를 목록에 넣지 않으면 빌드
전에 그 파일 이름으로 실패한다.
버린 대안: 목록을 vite.config.ts에서 export — 설정 파일을 빌드 도구 밖에서
import하면 플러그인 초기화가 따라온다.

위험·한계: import 그래프는 정규식으로 따라간다. 동적 import나 alias로
읽는 파일은 보지 못한다(지금은 없다). scripts/lib/removal-fixture.ts의
복사 목록은 저장소 전체 사본용이라 목적이 달라 합치지 않았다. 측정
스크립트는 참조 기능과 함께 지워지므로(test:sample-removal), (1)은 있는
소비자만 본다. 템플릿에서 그 파일이 없어지면
tests/unit/feature-shape-growth.test.ts가 import에서 실패한다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/vite-build-inputs.test.ts
tests/unit/product-feature-selection-build.test.ts
tests/unit/feature-shape-growth.test.ts
corepack pnpm ci:gate FE-GATE-020 (참조 기능을 지운 사본의 test:all)

Refs: 1105/15-03
2026-11-06 01:23:48 +09:00
DongHyeonka 48c1ab7ab6 fix(server-state)!: 손으로 적은 뮤테이션 operation ID를 타입 검사에서 막는다
문제: 1103/16-05 수정으로 commandMutationIdentity가 생겼지만
BoundMutation.operationId는 여전히 string이다. 정책에 operation ID를
문자열로 직접 적으면 오타가 check:types와 check:registries를 통과하고,
저장할 때마다 실행기가 보내기 전에 MISSING_IDEMPOTENCY_KEY 위반으로
거부한다. 매뉴얼 01은 이것을 "못 잡음"으로 적고 있었다.

고른 방법: BoundMutation.operationId를 brand 타입 MutationOperationId로
바꾼다. 이 값을 돌려주는 것은 commandMutationIdentity뿐이라, 문자열을
직접 적으면 check:types가 실패한다. 런타임 값은 descriptor의 문자열
그대로이고 실행기·intent factory는 바뀌지 않는다. 참조 기능과 쓰기 slice
생성기는 이미 commandMutationIdentity를 spread하므로 고칠 것이 없다.
템플릿 테스트의 손글씨 ID 20곳은 tests/helpers/mutation-operation-id.ts
(commandMutationIdentity를 거치는 test helper)나 그 파일의 descriptor로
바꿨다. 매뉴얼 01·patterns 표·state 설계 예시를 맞췄다.
버린 대안: (1) 위반 이름을 INTENT_OPERATION_MISMATCH로 나누는 것. 실행
때만 드러나는 것은 같고, 공개 위반 어휘에 값이 하나 늘어 다운스트림
분기가 바뀐다. (2) 설치된 operation ID의 union 타입. 기능마다 늦게
적재되는 계약 전체를 타입으로 모을 곳이 없다.

위험·한계: 공개 타입(src/contracts/server-state.ts)이 좁아진다. 정책에
operation ID를 문자열로 적은 다운스트림 코드는 동기화 뒤 check:types가
실패한다. commandMutationIdentity에 descriptor 상수 대신 손으로 만든
객체를 넘기면 여전히 오타가 통과한다(매뉴얼 "못 잡음"). HTTP가 아닌
뮤테이션은 descriptor 모양 객체를 넘겨야 한다. 이 repo에는 그런 소비자가
없다.

검증: desktop batch에서 확인.
corepack pnpm check:types:test
tests/unit/command-mutation-identity.test.ts의 @ts-expect-error가 부모
커밋에서는 쓰이지 않아(TS2578) 실패하고 이 커밋에서 통과한다.
node scripts/run-vitest.ts run tests/unit/command-mutation-identity.test.ts tests/component/application-mutation-admission.test.tsx tests/component/application-mutation-scope-fence.test.tsx tests/component/application-query.test.tsx tests/component/form-foundation.test.tsx

BREAKING CHANGE: BoundMutation.operationId는 string이 아니라
MutationOperationId다. 뮤테이션 정책의 `operationId: "<ID>"`와
`requiresIdempotencyKey`를 `...commandMutationIdentity(<OPERATION>_CONTRACT)`
로 바꾼다(src/contracts/server-state.ts). commandMutationIdentity의 반환
타입도 operationId가 MutationOperationId다.

Refs: 1103/16-05
2026-11-05 22:26:27 +09:00
DongHyeonka 00076992f7 fix(recipes): 쿠키 세션 모드의 서버 401을 템플릿 세션에 잇는다
문제: 짝 백엔드 Redis session 모드를 쿠키 recipe와 매뉴얼 04 4.3대로
이으면 서버 401이 세션에 닿지 않는다. 1103/09-01 수정 뒤 조립 루트는
제품 provider 프로필의 401을 제품의 선택 hook `onCredentialRejected`에만
알린다. 쿠키 모드의 operation은 모두 제품 프로필(SESSION_COOKIE_*)인데
매뉴얼 예시는 그 hook을 잇지 않았고, recipe와 매뉴얼은 "서버 401 →
unauthenticated"라고 적었다. 이으려 해도 ProductCompositionContext에
세션에 알릴 길이 없었다. 리뷰 09-cookie401에서 세션 만료 뒤에도 상태가
authenticated, 이전 scope가 current로 남았다.

고른 방법: 두 가지를 더했다.
- ProductCompositionContext.notifySessionUnauthenticated(): 템플릿 세션의
  자기 401과 같은 판정(authSession.onUnauthenticated)을 제품이 부를 수
  있게 한다(리뷰 안 C).
- recipe의 createSessionCookieRejectionHandler(context): SESSION_COOKIE_*
  프로필의 401만 세션에 넘긴다. 다른 제품 프로필의 401은 넘기지 않으므로
  1103/09-01의 완료 기준(세션과 무관한 provider의 401은 로그아웃시키지
  않는다)은 그대로다.
매뉴얼 04 4.3 예시에 `onCredentialRejected` 한 줄을 넣고, recipe 주석,
매뉴얼 04 흐름도, 매뉴얼 02 5절과 7절 업로드 예시(BACKEND_SESSION 쿠키
세션)를 맞췄다. 버린 대안: recipe가 owner와 provider를 한 번에 만드는
함수(안 B). owner는 composeProductSessionOwner, provider는 composeProduct
에서 따로 만들어져 모듈 변수가 필요하다. provider 선언에 "세션 자격
증명" 표시를 두는 안(D)은 계약 칸이 늘고 판정이 선언과 hook 둘로 갈린다.

위험·한계: 제품이 이 한 줄을 빼면 여전히 세션 만료를 모른다. 이것을
막는 검사는 없다(매뉴얼과 recipe 주석이 적는다). 이미 recipe를 복사한
다운스트림은 handler를 복사본에 옮기고 composeProduct에 한 줄을 더해야
한다. ProductCompositionContext에 칸이 하나 늘었다. 이 context는 템플릿만
만들므로 제품 코드는 깨지지 않는다. 실제 Redis 백엔드에는 붙이지
않았다(1103/09-03 남은 부분).

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/recipes/session-owners-runtime.test.ts tests/recipes/cookie-session-owner.test.ts
조립 루트를 지나는 테스트가 매뉴얼 4.3 연결로 쿠키 읽기·쓰기 401 뒤
세션 unauthenticated, 이전 scope not current를 본다.

Refs: 1105/09-02
2026-11-05 22:26:27 +09:00
DongHyeonka daf3474252 fix(contracts): 짝 백엔드 답 표를 pin한 백엔드 표의 사본과 대조한다
문제: 짝 백엔드 답 표 JSON(backend-idempotency-answers.json)이 pin한
백엔드 http-contract.md와 같은지 아무 검사도 보지 않는다.
backend-contract-pin.test.ts는 pin과 답 표 두 파일만 읽고, drift
스크립트는 pin과 HEAD 사이에 문서 글자가 바뀌었는지만 본다. 그래서
답 표 status 오타나 옮기지 않은 행(§4 RATE_LIMIT_*)은 어디서도 걸리지
않는다. drift 스크립트는 옆 checkout이 없으면 "skipped"로 rc=0이고
(worktree에서 늘 그렇다), 매뉴얼에는 스크립트가 없다.

고른 방법: 게이트가 백엔드 checkout 없이 볼 수 있게, 백엔드 §2·§4 표의
`|` 줄을 pin 커밋 그대로 config/contracts/backend-http-contract-excerpt.json
에 옮겼다. 읽는 함수는 scripts/lib/backend-contract-excerpt.ts 하나다.
- test:unit(backend-contract-pin.test.ts): 답 표의 행마다 사본의 같은 절에
  같은 code·status 행이 있는지, 사본의 행마다 답 표에 있거나 pin의
  `notCopied`에 이유와 함께 있는지 본다. `notCopied`에는 RATE_LIMIT_* 둘을
  적었다(리뷰가 지적한 sectionsCompared §4의 실제 범위).
- check:backend-contract-drift(게이트 밖): pin 커밋의 문서에서 같은 표를
  읽어 사본과 글자 단위로 비교하고, 답 표도 그 표와 비교하고, pin 뒤
  HEAD에서 바뀐 사본 표 행을 찍는다. checkout이 없거나 pin 커밋·문서가
  없으면 rc=2("not compared")로 끝난다. 기본 경로는 main checkout 옆이라
  linked worktree에서도 같은 백엔드를 찾는다. `--write-excerpt`는 pin을
  올릴 때 사본을 pin 커밋에서 다시 옮긴다.
- 매뉴얼 01 Envelope 단계와 계약 문서 4.1에 언제 무엇을 돌리는지 적었다.
버린 대안: 백엔드 문서의 digest만 pin에 두는 것. 게이트는 digest로 답
표를 확인할 수 없다. 계약 패키지(리뷰 안 D)는 배포 경로가 아직 없다.

위험·한계: 사본과 백엔드 문서의 일치는 여전히 백엔드 checkout이 있을
때만 drift 스크립트가 본다. 게이트는 답 표와 사본의 일치만 본다. 사본을
손으로 같이 고치면 게이트는 통과한다(drift 스크립트가 잡는다). 답 표의
refusedBeforeWrite·sameKeyResend는 백엔드 문장(클라이언트 행동)을 사람이
읽은 값이라 기계로 대조하지 않는다. 그 문장이 바뀌면 사본 diff와 drift
출력에 보인다. 백엔드 표 형식(머리글 `error.code`·`코드`·`status`)이
바뀌면 파서도 고친다. pin의 comparedOn을 사본을 옮긴 날로 올렸다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/backend-contract-pin.test.ts tests/unit/backend-contract-drift.test.ts
drift 테스트는 가짜 백엔드 git repo로 D6g(pin 뒤 status 변경), 답 표
status 오타, 사본 오타, 옮기지도 적지도 않은 행, checkout 없음,
--write-excerpt를 돈다.

Refs: 1105/07-01
2026-11-05 22:17:57 +09:00
DongHyeonka 3b62ccd5db fix(registry): 응답 스키마 행을 REJECT_UNKNOWN으로 좁히면 breaking으로 본다
문제: 응답 DTO를 `.strict()`로 바꾸고 FE-REG-SCHEMA 행의
`unknownFieldPolicy`를 STRIP_UNKNOWN에서 REJECT_UNKNOWN으로 같이 고치면
check:registries가 behavior-change로 통과한다(리뷰 배치 07-R1). 1103/07-03
수정은 행과 검증기를 묶었지만 등급은 그대로였다. 그 뒤 백엔드가 응답에
필드 하나를 더하면 그 API는 SCHEMA_MISMATCH로 실패한다. 같은 경계에서
FE-REG-API는 acceptedStatuses 축소를 breaking으로 본다.

고른 방법: 분류기에 규칙 하나를 더한다. `direction: "RESPONSE"` 행의
`unknownFieldPolicy`가 REJECT_UNKNOWN이 아니던 값에서 REJECT_UNKNOWN으로
바뀌면 kind `response-reader-narrowed`, breaking이다. 반대 방향
(REJECT→STRIP, 읽는 쪽을 넓힘)과 REQUEST 행(프론트가 스스로 채우는 값)은
그대로 behavior-change다. 버린 대안: governance의 FE-REG-SCHEMA
breakingFields에 `unknownFieldPolicy`를 넣는 것(리뷰 안 B). 넓히는 변경까지
증거를 요구하게 되고, governance 계약이 바뀌어 템플릿과 다운스트림 모두
기준선을 다시 승인해야 한다. 이 규칙은 기준선과 governance를 바꾸지 않는다.
리뷰 안 (1)의 fieldTypes 선언도 같은 이유로 하지 않았다.

위험·한계: 규칙은 칸 이름(`unknownFieldPolicy`)과 값 어휘
(src/contracts/schema-registry.ts)에 묶여 있다. 어휘를 바꾸면 이 함수도
고친다. route-params·route-search(REQUEST 방향, URL을 읽는 쪽)를
REJECT_UNKNOWN으로 좁히는 변경은 여전히 behavior-change다. 지금 템플릿
스냅샷은 기준선과 같아 결과는 none 그대로다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/registry-compatibility.test.ts
리뷰 07-R1 패치(응답 DTO `.strict()` + 응답 행 두 개 REJECT_UNKNOWN)를
다시 적용하면 check:registries가 `breaking change missing evidence:
FE-REG-SCHEMA:ReferenceResource(List)Payload:unknownFieldPolicy:
response-reader-narrowed`로 실패해야 한다.

Refs: 1105/07-02
2026-11-05 22:10:05 +09:00
DongHyeonka 2e1acb1f21 fix(bootstrap): 금지된 설정 키로 멈춘 부팅 오류에 그 키 이름을 싣는다
문제: 런타임 설정에 비밀처럼 보이는 키(`CLIENT_SECRET` 등)가 있으면
부팅이 CONFIG_SECRET_NAME_REJECTED로 멈추지만, 안전한 부팅 오류에는
buildId만 있고 어느 키인지가 없다. assertSafeConfigNames가 던진 오류의
message에는 키 이름이 있었지만 loadRuntimeConfig가 그 오류를 버렸다.
같은 파일의 스키마 실패는 키 이름을 invalidKeys로 싣는다.

고른 방법: assertSafeConfigNames가 UnsafeConfigNameError를 던지고 그
`key`에 거절한 키의 점 경로(`CAPABILITY_OVERRIDES.AUTH_TOKEN`,
`FEATURE_OVERRIDES.<id>.CLIENT_SECRET`)를 싣는다. 로더는 그 경로를
스키마 실패와 같은 SAFE_KEY_PATTERN으로 거른 뒤 invalidKeys에 넣는다.
오류 화면은 이미 invalidKeys를 "잘못된 설정 키"로 보인다. 값은 어디에도
싣지 않는다. 버린 대안: message에서 키를 정규식으로 다시 읽는 것.
message 문구가 바뀌면 조용히 빠진다.

위험·한계: 키 이름은 거절된 문서에서 온다. 그래서 길이·문자를 제한하고,
그 밖의 이름은 빼고 코드만 남긴다. 첫 번째로 걸린 키 하나만 싣는다
(검사가 첫 키에서 멈추는 동작은 그대로). assertSafeConfigNames의
시그니처와 message는 바꾸지 않았다. UnsafeConfigNameError는
src/contracts/env.ts에 새로 더한 export다(추가만).

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/runtime-schema/runtime-config.test.ts

Refs: 1103/07-04
2026-11-05 22:08:22 +09:00
DongHyeonka bfd9d50d2b fix(registries): 계약 조립 실패의 원인을 check:registries에 한 번만 찍는다
문제: 계약 조립이 실패하면 check:registries 출력에 같은 원인이 두 번
나온다. 1103/09-07 수정이 ContractContributionError의 message 끝에
reason을 붙였고, 1103/14-06 수정이 loadErrorText에서 message 뒤에
"(reason: ...)"를 또 붙였다. 두 수정이 다른 브랜치에서 들어왔다.
기존 테스트는 reason이 message에 없는 가짜 오류로만 시험해 중복을
보지 못했다.

고른 방법: loadErrorText가 message에 reason이 이미 들어 있으면 붙이지
않는다. reason을 message에 싣지 않는 오류(기존 테스트의 가짜 오류)는
지금처럼 "(reason: ...)"가 붙는다. 버린 대안: ContractContributionError
message에서 reason을 다시 빼는 것. message만 찍는 다른 출구(부팅 오류,
테스트 출력)가 원인을 잃는다(1103/09-07이 고친 문제).

위험·한계: message 첫 줄만 보므로 여러 줄 reason은 다시 붙는다. 지금
reason은 한 줄이다. docs/manual/reference/errors.md의 출력 형식 줄을
실제 출력에 맞췄다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/registry-governance.test.ts
새 테스트는 실제 ContractContributionError를 던지는 source로
check:registries를 돌려 원인이 한 번만 나오는지 본다.

Refs: 1105/09-03
2026-11-05 22:06:33 +09:00
DongHyeonka e85c8361b6 docs(review): 2026-11-05 4라운드 성숙도 리뷰 결과를 기록한다
2026-11-03 리뷰의 조치가 main(409d72e)에 들어간 뒤 전체를 다시 봐야
한다. 지난 README 14.4절의 상태 판정("그 밖의 81건 고침")과, 조치가
검사를 약하게 했는지는 아무도 확인하지 않았다.

가이드 기준으로 16개 영역을 다시 리뷰했다. 기준은 8a44226(= main
409d72e 트리)이다. desktop에서 merge 단계 14개(workflow env)와
CLAUDE.md 게이트 목록을 직접 돌렸다. 실험은 게이트가 끝난 뒤 78항목을
한 묶음으로 하나씩 돌렸고, 항목마다 checkout을 기준 커밋으로 되돌렸다.
처음에는 영역마다 따로 실행했으나 공유 잠금에 30여 건이 줄을 서서
취소했다(README 11.4절).

결과: 새 발견 48건(High 0, Medium 11, Low 37 / P1 3, P2 15, P3 30).
P1은 09-01, 12-01, 13-01. 지난 96건은 고쳐짐 74, 일부 22이고,
14.4절이 고침이라 한 13건을 일부로 바로잡았다. merge 게이트는 13/14
통과, FE-GATE-013은 호스트 user namespace 제한으로 실패한다.

위험·한계: 실제 Gitea 러너와 짝 백엔드 연동은 확인하지 못했다(README
8절). 리뷰라 코드는 고치지 않았다. 영역 문서의 실행 기록 일부는
리뷰 세션 scratchpad 경로를 가리킨다.

검증: desktop에서 이 커밋으로 documentation-readiness,
deletable-history-documents, changelog-review-ids 테스트와
verify:documentation(옆 백엔드 checkout 없이)을 돌렸다.

Refs: docs/reviews/2026-11-05-maturity-review/README.md
2026-11-05 20:52:21 +09:00
donghyeon.kang 409d72e721 Merge pull request 'fix: UI 감사와 11-01 성숙도 리뷰의 발견과 결정 24건을 반영한다' (#4) from fix/ui-design-audit-2026-11-01 into main
Reviewed-on: #4
2026-11-05 10:33:57 +00:00
DongHyeonka 8a4422624e docs(review): desktop merge 게이트 11회차와 FE-GATE-008 연속 3회를 기록한다
문제: 14.5절 표에 메인 세션의 ee7e195 실행(11-10을 찾은 회차)과 11-10 조치
뒤 FE-GATE-008 확인이 없었다.

방법: 11회차(ee7e195, 008·013 실패, 013은 desktop 환경)와 12~14회차(8c5e047,
GATES="008" 연속 3회, RUN_NO 45·46·47 모두 통과)를 더했다.

검증: desktop에서 changelog-review-ids test와 verify:documentation(scoped).
2026-11-05 10:01:24 +09:00
DongHyeonka 8c5e047576 docs(review): 11-10(클릭 도중 움직이는 capability test 버튼)을 기록한다
문제: 메인 세션이 desktop(ee7e195, 부하 0.96)에서 FE-GATE-008의 firefox
capability 실패를 다시 찾았다. 14.7절은 같은 실패(browser-files 다운로드
test)를 부하 탓 flake로 적어 두었는데 틀렸다.

방법:
- 13절에 11-10(Medium·P1, 관점 10·21, 고침 ee37dd86)을 더했다. 근거는
  진단 event 기록 6건(mouseup이 홈 화면 내용), 위치 기록 3건(scrollY
  그대로, body·button 12 px 아래로), ×30 재현 3/60 두 번이다.
- 색인·발견 수(95건)·14.4 행을 맞췄다.
- 14.7절의 Firefox 줄을 지우고 정정을 적었다. "FE-GATE-008이 한 번에
  통과하지 않을 수 있다"는 줄도 지웠다.

검증: desktop에서 changelog-review-ids test와 verify:documentation(scoped).
2026-11-05 09:51:48 +09:00
DongHyeonka 9d5eb5cfc6 docs(changelog): capability 파일·다운로드 test의 고정 층을 적는다
문제: ee37dd86(1103/11-10)이 firefox에서 FE-GATE-008을 가끔 떨어뜨리던
capability test의 구조를 고쳤는데 CHANGELOG에 없었다.

방법: 게이트·드릴 행의 11-09 문장 뒤에 이어 적었다.

검증: desktop에서 changelog-review-ids test(README 커밋과 함께).
2026-11-05 09:51:48 +09:00
DongHyeonka ee37dd86a2 fix(test): capability 파일·다운로드 테스트의 버튼을 앱 위 고정 층에 둔다
문제: FE-GATE-008의 test:browser-capabilities가 firefox에서 가끔 30초 시간
초과로 떨어졌다. browser-files.spec.ts의 두 test가 번갈아 걸렸다. 하나는
"filechooser"를, 다른 하나는 "download"를 기다리다 끝났다. desktop에서
firefox capability suite를 30회씩 돌리면 두 test 60건 중 3건이 떨어졌다(두
번 모두). 부하와는 상관없었다(1.05에서도 남). 리뷰 14.7절은 이것을 "알려진
flake"로 두었다(1103/11-10).

원인: 두 test는 `goto("/")` 직후 label·input·button을 `<body>` 끝, 앱 root
뒤에 붙이고 그 button을 누른다. 그때 앱은 아직 그리는 중이다. 실패한 6건의
event 기록(진단 branch, 커밋 안 함)은 모두 같았다.
- pointerdown·mousedown은 button("Choose test file"/"Download generated").
- 30~45 ms 뒤 pointerup·mouseup은 홈 화면 내용("프로젝트 시작점…").
- click은 둘의 공통 조상(앱 root)이라 button의 handler가 돌지 않았다
  (`__browserFileResult` 없음). 그래서 picker도 download도 없었다.
- 위치까지 적은 3건에서 그 사이 scrollY는 24로 같았다. body 높이는 744에서 756으로, button top은
  696에서 708로 둘 다 12 px 늘었다. 앱 내용이 클릭 도중 12 px 자랐고,
  viewport 아래 끝의 button 중앙 좌표가 button 밖이 됐다. 통과한 run은
  pointerdown 때 이미 756이었다.

고른 방법: 두 test가 붙이는 control을 `position: fixed` 층(왼쪽 위, 가장
높은 z-index)에 둔다. 앱의 흐름 밖이라 앱이 늦게 그려도 button이 움직이지
않는다. 제품 코드는 바꾸지 않는다.

버린 대안:
- 앱이 다 그려질 때까지 기다린다. "다 그려짐"을 정할 신호가 없다. 늦게 오는
  글꼴이나 내용이 생기면 다시 깨진다.
- `dispatchEvent("click")`이나 `force` click. 신뢰된 사용자 입력이 아니어서
  firefox가 file picker를 열지 않는다. test가 증명하려는 것을 지운다.
- 재시도·timeout 늘리기·worker 줄이기. 금지된 우회이고 원인이 남는다.

위험·한계: 고정 층이 앱 header 왼쪽 위를 덮는다. 두 test는 앱 UI를 누르지
않는다. 다른 capability spec은 body에 control을 붙이지 않는다(grep).

검증 (desktop):
- RED(커밋 안 한 재현): mousedown 때 앱 root에 400 px를 더하고 layout을
  다시 계산한다(앱이 늦게 그리는 것과 같은 일). 수정 전 spec은 세 엔진 두
  test 6/6 실패(filechooser·download 대기 시간 초과).
- GREEN: 같은 재현에서 수정 뒤 6/6 통과.
- 실제 조건 firefox capability suite ×30: 수정 전 두 번 다 3 failed /
  657 passed, 수정 뒤 660 passed.
2026-11-05 09:51:10 +09:00
DongHyeonka ee7e195fb2 docs(review): desktop에서 돌린 merge 게이트 9·10회차를 기록한다
문제: 14.5절 표에 메인 세션의 desktop 실행(8a3b16a, 11-09를 찾은 회차)과
11-09 조치 뒤 실행이 없었다.

방법: 9회차(8a3b16a, 008·013 실패, 013은 desktop 환경)와 10회차(37c63e8,
008·005·012·020 통과)를 더했다. 10회차에 초기 JS를 조치 전후로 적었다.
제품 입력은 같고 차이 6 B는 빌드에 박힌 커밋 ID다.

검증: desktop에서 changelog-review-ids test와 verify:documentation.
2026-11-05 08:40:19 +09:00
DongHyeonka 37c63e8370 docs(review): 11-09(WebKit preload 추정에 기댄 브라우저 테스트)를 기록한다
문제: 메인 세션이 desktop(부하 0.68)에서 8a3b16a의 FE-GATE-008 webkit
실패(i18n.spec.ts:60)를 찾았다. 14.7절은 같은 경고(production-csp.spec.ts:52)를
부하 탓 flake로 적어 두었는데 틀렸다.

방법:
- 13절에 11-09(Medium·P1, 관점 10·21, 고침 aad005cb)를 더했다. 근거는 실패
  trace의 시각, 재현 3/10·0/10·2/2, 이전 fixture가 정말 안 쓴 preload를
  놓친 probe다.
- 색인·발견 수(94건)·14.4 행을 맞췄다.
- 14.7절의 webkit flake 줄을 지우고 정정을 적었다. FE-GATE-008이 한 번에
  통과하지 않을 수 있는 이유는 이제 Firefox 다운로드 건 하나다.

검증: desktop에서 changelog-review-ids test와 verify:documentation.
2026-11-05 08:14:53 +09:00
DongHyeonka 8b70a5a992 docs(changelog): 브라우저 테스트의 preload 사용 검사를 적는다
문제: aad005cb(1103/11-09)이 strict fixture의 WebKit preload 경고 처리와
새 preload 사용 검사를 바꿨는데 CHANGELOG에 없었다. 다운스트림은 build
script를 직접 fulfill하는 test에 `fulfillBuildScript`를 써야 한다.

방법: 게이트·드릴 행의 11-08 문장 뒤에 이어 적었다. FE-GATE-008이 가끔
떨어지던 게이트 문제라 같은 행에 둔다.

검증: desktop에서 tests/unit/changelog-review-ids.test.ts(아래 README
커밋과 함께).
2026-11-05 08:14:53 +09:00
DongHyeonka aad005cbce fix(test): 브라우저 테스트가 WebKit의 3초 preload 추정 대신 실제 사용을 검사한다
문제: FE-GATE-008이 webkit에서 가끔 "The resource … was preloaded using
link preload but not used within a few seconds from the window's load
event" 경고로 떨어졌다(desktop 부하 0.68, i18n.spec.ts:60, 반복 10회 중
3회). 부하 탓이 아니었다. WebKit은 load 3초 뒤 한 번, 아직 아무 요청도 쓰지
않은 preload를 경고한다. 플랫폼 구성 화면은 들어갈 때 기능 실행부를 모두
불러오고(15-01), Vite는 그 청크와 정적 의존 청크를 한꺼번에 modulepreload
한다. 화면을 load 뒤 2.5초쯤 열면 module graph가 가장 깊은
reference-schemas에 닿기 전에 WebKit 검사가 돈다. 그 청크는 곧 쓰인다(표가
그려지고 link로 한 번만 받는다). 반대로 정말 안 쓰는 preload는 Chromium·
Firefox에서 늘, WebKit에서도 test가 3초 전에 끝나면 아무도 잡지 않았다
(1103/11-09).

고른 방법:
- strict fixture가 WebKit의 그 문구 하나만 정확한 패턴으로 무시한다. 다른
  console warning·error는 그대로 실패다.
- 대신 tests/support/browser/preload-use.ts가 세 엔진에서 같은 방법으로
  "preload한 script가 실제로 실행됐는가"를 본다.
  - 문서가 받은 `<link rel=modulepreload|preload>`를 첫 바이트 전부터
    MutationObserver로 적고, 끝에 남은 link도 더한다.
  - page.route로 build script(`/assets/*.js`)에 "이 URL이 평가됐다"를 적는
    문장 하나를 앞에 붙인다.
  - test 끝에 preload됐는데 평가되지 않은 script를 `preloadunused:`로
    실패시킨다. 진행 중인 dynamic import는 5초까지 기다린다.
- "사용"을 평가로 판정하는 이유: preload는 받기만 하거나(WebKit·Firefox)
  받아서 parse만 한다(Chromium). 어느 엔진도 평가하지 않는다. 그래서 그
  문장은 module graph가 그 청크를 실제로 실행했을 때만 돈다. WebKit의
  "참조됨"과 달리 시각에 기대지 않는다.
- 볼 수 없는 것은 따로 이름을 붙여 실패시킨다(fail closed).
  - script가 아닌 preload는 `preloadunverifiable:<as>:`.
  - Service Worker가 문서를 제어할 때 만든 preload는
    `preloadunverifiable:service-worker:`. 그 요청은 worker가 답해서
    page.route가 못 본다. context.route로 worker가 받는 것을 표시하면
    release manifest의 sha256 대조가 깨진다.
  - route.fetch가 세 번 실패해 표시 없이 넘어간 script는
    `preloadunverifiable:unmarked:`. 처음 구현은 이때 조용히
    route.continue()로 넘겨 쓰인 청크를 안 쓴 것으로 보고했다(webkit
    reference-form 1건).
- 일부러 실패를 일으키는 spec은 그 실패가 남기는 preload만 허용한다.
  - boot-module-failure: 깨진 build의 boot 정적 closure.
  - old-tab-chunk-recovery: 없어진 청크와 함께 preload된 청크. 전에는 이
    허용이 WebKit 경고 문구로만 있었다.
  - service-worker-update: worker 제어 중 preload만.
  - production-csp는 build script를 직접 fulfill하므로, 표시를 유지하는
    fulfillBuildScript를 쓴다.

버린 대안:
- (A) lazy dynamic import의 JS 의존성 preload를 끈다. 경고는 원리상 없어지지만
  test의 추정에 맞춰 제품을 바꾸는 것이다. lazy 라우트 첫 진입마다 1~2 RTT가
  늘고, 그 화면은 lab이 재는 화면(FE-GATE-026)이다.
- 청크 단계를 줄인다. 창이 좁아질 뿐이다.
- 3초 뒤에 화면에 들어간다. 사용자가 보는 경고를 test에서 숨긴다.

위험·한계:
- 모든 strict fixture test가 build script를 page.route로 받는다.
- 끝에 열려 있는 문서만 검사한다. 이동해 버린 문서의 기록은 같이 사라진다.
- fixture가 검사하는 것은 fixture의 page 하나다(console 검사와 같다).
- worker가 제어하는 문서의 preload는 검사하지 못한다(이름을 붙여 실패,
  service-worker-update만 허용).

검증 (desktop, CI=true와 workflow env):
- RED(검사 stub): 새 preload-use.spec 9건 중 7건 실패.
  - 변이 test는 세 엔진 모두 Expected
    ["preloadunused:/assets/async-state-Cxfod8c-.js"], Received [].
  - 부모 청크 3.5초 지연 scenario는 webkit만 "console:warning:The resource
    …/reference-schemas-DICBcHlO.js was preloaded using link preload but not
    used …"로 실패.
- GREEN: 9 passed.
- 변이를 fixture에 직접 넣은 probe(커밋 안 함), 안 쓰는 modulepreload 하나:
  - 이전 fixture(8a3b16a): chromium·firefox·webkit 3/3 통과(놓침).
  - 새 fixture: 3/3 실패,
    "preloadunused:/assets/async-state-Cxfod8c-.js".
- 부모 청크 3.5초 지연 probe:
  - 이전 fixture: webkit 실패.
  - 새 fixture: 3/3 통과. webkit은 여전히 reference-schemas 경고를 냈다
    (probe guesses ["reference-schemas-DICBcHlO.js was preloa…"]).
- 전체 e2e(playwright.config.ts): 202 passed, 3 skipped(기존 firefox SW skip).
- check:types:test, 바꾼 파일 eslint 통과.
2026-11-05 08:13:56 +09:00
DongHyeonka 8a3b16adb3 docs(review): 11-08과 CI=true로 다시 돌린 merge 게이트 결과를 기록한다
문제: 14.5절 X4의 1~7회차와 799ab7f 결과는 CI=true와 CI_RUNNER_IMAGE
없이 돌린 것이라, 메인 세션이 c7c7887에서 workflow env로 찾은
FE-GATE-005·008·020 실패(11-08)를 놓쳤다. 리뷰 기록에 그 사실과 새 발견이
없었다.

방법:
- 13절에 11-08(Medium·P1, 고침 b693600, 안내 cd7e784)을 더하고 색인·
  14.4 행·발견 수(93건)를 맞췄다.
- 14.5절에 앞 회차가 CI=true 없이 돌았다고 적고, 8회차(cd7e784, CI=true와
  CI_RUNNER_IMAGE digest)와 최종 행을 더했다. 표 중간의 빈 줄로 7회차와
  최종 행이 표 밖으로 빠져 있던 것도 고쳤다.
- 14.7절에 FE-GATE-008을 한 번에 통과시키지 못하게 하는 두 flake(Firefox
  다운로드 시간 초과, webkit preload 경고)와 원인 조사 결과를 적었다.
  Blob URL을 일찍 회수하는 경쟁을 의심해 A/B로 쟀으나 둘 다 60/60이라
  테스트는 고치지 않았다.

위험·한계: 실제 Gitea 러너가 아니라 로컬에서 workflow env를 준 실행이고
CI_RUNNER_IMAGE는 가짜 digest다. 두 flake의 원인은 찾지 못했다.

검증: 깨끗한 clone(cd7e784)에서 14개 ci:gate. 001~007·009~013·020은 한
번에, 008은 세 번째 실행에서 통과. verify:documentation PASS_SCOPED.
2026-11-05 05:06:50 +09:00
DongHyeonka d6b340b556 docs(changelog): 테스트 안의 로컬 빌드가 CI=true에서도 로컬로 도는 변경을 적는다
문제: b693600(1103/11-08)이 fixture 빌드·시각 골든 build·dev server를
CI=true와 CI 식별값에서 떼어 놓았는데 CHANGELOG에는 11-07의 vitest·dev
server 조치만 있었다.

방법: 게이트·드릴 행의 11-07 문장 뒤에 11-08을 이어 적었다. 새 행을 만들지
않은 것은 같은 원인(CI env가 로컬 빌드로 샌다)의 두 번째 조치라서다.

검증: tests/unit/changelog-review-ids.test.ts 통과,
verify:documentation PASS_SCOPED(짝 백엔드 checkout 없음).
2026-11-05 05:06:50 +09:00
DongHyeonka cd7e784242 docs: 로컬 merge 게이트 실행 안내에 workflow의 CI env를 적는다
문제
README의 로컬 merge 게이트 반복문과 매뉴얼 01, 생성 명령 출력은 CI=true와
CI 빌드 식별값 없이 돌리는 법만 적는다. 그렇게 통과해도 workflow(CI=true)에서
떨어지는 결함 두 건(1103/11-07, 11-08)이 이 차이로 숨었다.

고른 방법
- README 반복문 아래에 workflow와 같은 env 블록(CI=true, VITE_COMMIT_SHA,
  VITE_BUILD_ID, RELEASE_ID, CI_RUNNER_IMAGE digest)과 깨끗한 clone에서 돌리라는
  말을 더한다. 테스트가 만드는 로컬 빌드는 이 값과 무관하게 로컬 빌드로
  돈다는 것도 적는다.
- 매뉴얼 01 "merge 전에 돌릴 것"과 생성 명령 Next 2번이 그 블록을
  가리킨다.

검증
- verify:documentation PASS_SCOPED, tests/unit/create-feature.test.ts 43건.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-08
2026-11-05 04:27:29 +09:00
DongHyeonka b693600103 fix(ci): 테스트가 만드는 로컬 빌드는 CI=true에서도 release 빌드로 검사되지 않는다
문제
workflow는 모든 job에 CI=true와 CI 빌드 식별값을 준다. 메인 세션이 깨끗한
clone에서 그 env 그대로(CI=true 포함) merge 단계 14개를 돌리자 FE-GATE-005·
008·020이 실패했다.
- vitest 안의 fixture 빌드(tests/e2e/support/fixture-builds.ts →
  build-frontend.ts)가 CI=true를 물려받아 release 빌드처럼 검사된다.
  af312de가 vitest에서 VITE_COMMIT_SHA를 지워 "missing required CI build
  environment: VITE_COMMIT_SHA"로 멈춘다(service-worker-build-output 7건이
  돌지 않음, 제거 드릴 안에서도 같다).
- 시각 골든 build(9bddfa5)가 VITE_COMMIT_SHA="local"을 받는데 CI=true가
  40·64자리 hex를 요구해 webServer가 뜨지 않는다.
내 X4가 CI=true 없이 돌아 놓쳤다. 1103/11-07과 같은 원인이다.

고른 방법
- scripts/lib/build-environment.ts에 둘을 둔다.
  - localBuildEnvironment(env): spawn하는 로컬 빌드용. CI와 CI 빌드 식별값을
    뺀 사본. fixture-builds.ts, service-worker-builds.ts가 쓴다.
  - LOCAL_BUILD_IDENTITY: Playwright web server용. Playwright가 env를
    process.env 위에 합치므로 CI를 지우지 않고 ""로 덮는다(검사는
    CI === "true"일 때만). visual·capabilities·dev 설정이 쓴다.
- assertCiBuildEnvironment의 CI=true 검사는 그대로다. job 자신의 release
  빌드(build:release-candidate 등)는 계속 검사된다.
- 버린 대안: 로컬 빌드에 유효한 가짜 커밋 id(0×40)를 주기. CI=true 검사의
  다른 칸(CI_RUNNER_IMAGE, SOURCE_DATE_EPOCH)도 함께 맞춰야 하고, 로컬
  빌드가 release 빌드인 척한다.

위험·한계
- 로컬 빌드 안에서 CI를 읽어 동작을 바꾸는 코드가 있으면 그 빌드는 이제
  CI가 아닌 쪽으로 돈다(지금은 build-environment 검사뿐이다).

검증
- tests/unit/local-build-environment.test.ts 3건: 구현 전 2건 실패(RED),
  CI job 자체 검사는 유지.
- CI=true·VITE_COMMIT_SHA·VITE_BUILD_ID=gitea-41-1·RELEASE_ID·
  CI_RUNNER_IMAGE·SOURCE_DATE_EPOCH로: service-worker-build-output 7건,
  test:visual 6/6, test:unit 2,883, test:component 270, test:integration 189
  통과. 수정 전 service-worker-build-output은 7건 미실행.
- check:types, lint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-08
2026-11-05 04:26:44 +09:00
DongHyeonka c7c7887937 docs(review): 2026-11-03 리뷰 조치 결과와 merge 단계 검증을 기록한다
문제
리뷰 README에 조치 결과가 없다. 사용자가 "나머지 전부 진행하세요"라고
했고, 이 세션이 발견 90건과 0929/03-03을 고치고 통합했다.

고른 방법
- 13절에 조치 중 찾은 발견 둘(11-07 CI 빌드 식별값 누출, 16-09 dev
  manifest 고정 contract set)을 36.3 양식으로 더하고 색인을 92건으로 고친다.
- 14절을 새로 둔다: 방법(수정 브랜치 11개, wave 1~3), 결정 D1~D6, 통합에서
  생긴 것, 발견별 상태(일부 9건과 결정 대기 3건), 깨끗한 clone의 merge 단계
  14개 회차별 결과(X4), 매뉴얼 재실험 막힘 7건과 처리(X2), 남은 문제.

위험·한계
- X2(매뉴얼만 보는 재실험)는 고친 뒤 다시 돌리지 않았다. 고친 것은 생성
  기능을 넣은 clone 확인과 X4로 확인했다.
- 실제 Gitea 러너, 짝 백엔드·nginx·Keycloak·Redis 연동은 확인하지 않았다.

검증
- 최종 커밋 799ab7f, 깨끗한 clone, CI env: FE-GATE-001~013·020 통과
  (FE-GATE-008은 첫 실행 Firefox 다운로드 시간 초과 1건, 재실행 2회 통과).
- verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 14절
2026-11-05 04:08:56 +09:00
DongHyeonka 6ee20eff89 docs(changelog): dev manifest 행을 최종 방식(생성·제거 때 다시 쓰기)으로 고친다
문제
미출시 절은 "corepack pnpm dev가 설치된 기능의 contract set으로 release
manifest를 낸다"고 적는다. 그 미들웨어는 799ab7f에서 지웠고, 지금은
create:feature와 기능 제거 드릴이 public/release-manifest.json을 다시 쓴다.

고른 방법
- 행을 지금 동작([계약]: 다시 쓰는 명령, 커밋할 것, 낡으면 실패하는 테스트)과
  dev server 감시 제외로 고친다.

검증
- changelog-review-ids·documentation-readiness 테스트 20건 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6 16-09
2026-11-05 04:08:56 +09:00
DongHyeonka 799ab7f667 fix(dev): dev manifest를 기능 생성·제거 때 다시 쓰는 커밋 파일로 둔다
문제
c15345c·db5728b·0eba082의 dev 전용 Vite 미들웨어(dev server가 설치된
기능의 contract set으로 manifest를 냄)를 넣은 뒤로, dev server를 쓰는
capability e2e가 "requestfailed:GET:/release-manifest.json:net::ERR_ABORTED"로
떨어졌다. 같은 호스트에서 번갈아 쟀다: 미들웨어 있음 5/30·2/30 실패, 없음
0/30·0/30(부하가 더 높았다). trace에서는 첫 manifest 요청이 200 헤더 뒤
끊기고 65 ms 뒤 두 번째 요청이 성공한다. 원인을 끝까지 좁히지는 못했다.
감시 이벤트(파일 쓰기)를 없애도 같았다.

고른 방법
- 미들웨어를 지운다. dev server는 커밋된 public/release-manifest.json을
  그대로 낸다.
- 그 파일의 contractSet을 설치된 기능으로 다시 쓰는 일을 명시적 단계로
  둔다: `create:feature`가 생성 뒤 scripts/write-dev-release-manifest.ts를
  돌리고, 기능 제거 드릴이 지운 뒤 돌린다. 매뉴얼의 되돌리기·기능 지우기
  절과 errors.md에 같은 명령을 적었다. 레지스트리 기준선과 같은 방식이다.
- tests/unit/dev-release-manifest.test.ts가 커밋된 파일이 설치된 기능의
  contract set과 같은지 보고, 다르면 다시 쓰는 명령을 말한다.
- 함께: vite.config.ts가 artifacts/·dist/·.tmp/를 감시하지 않는다.
  Playwright trace의 .html이 열린 페이지를 모두 다시 불러오게 했다(dev
  server 로그의 page reload).
- 버린 대안: dev 부팅에서 contract set 검사 건너뛰기. 검사하는 테스트와
  같은 조건을 dev만 따로 두게 된다.

위험·한계
- 기능을 손으로 지우고 명령을 잊으면 dev server가 부팅하지 못한다.
  test:unit이 그 상태를 이름과 명령으로 알린다.

검증
- test:unit 2,880건, dev-release-manifest·create-feature 테스트 45건,
  check:types, lint, verify:documentation 통과.
- 생성 기능을 넣은 clone의 dev capability e2e와 merge 단계 14개는 이 커밋
  뒤 깨끗한 clone에서 돈다.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.5 14.6 X2 #3, 16-09
2026-11-05 03:30:56 +09:00
DongHyeonka 0eba0821bd fix(dev): dev release manifest를 파일로 쓰지 않고 메모리에서 낸다
문제
깨끗한 clone의 FE-GATE-008에서 dev server를 쓰는 capability e2e가
"requestfailed:GET:/release-manifest.json:net::ERR_ABORTED"로 1~4건씩
떨어졌다(세 번 중 세 번, 부하 9~30). 플러그인(db5728b)이 dev server 시작
때 .generated/frontend-runtime/에 manifest를 쓰는데, polling 감시
(CHOKIDAR_USEPOLLING=1)가 그 새 파일을 서버가 뜬 뒤에 보고 부팅 중인 페이지를
다시 불러오면 진행 중인 manifest 요청이 끊긴다고 본다. 플러그인을 넣기 전
같은 부하의 회차들은 66건 모두 통과했다.

고른 방법
- 자식 프로세스가 manifest를 stdout으로 내고, 플러그인은 그 문자열을
  메모리에 두고 낸다. 파일을 쓰지 않으므로 감시가 볼 것이 없다.
  devReleaseManifest(source)가 문자열을 돌려준다.

위험·한계
- 원인을 감시 이벤트로 직접 관측하지는 않았다(추론). 수정 뒤 재실행으로
  확인한다.

검증
- tests/unit/dev-release-manifest.test.ts 2건, check:types, lint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.5 X4
2026-11-05 03:12:27 +09:00
DongHyeonka 2e4595e2ff fix(scaffold): 기능 생성 드릴이 생성 뒤 초기 JS 기록을 다시 쓴다
문제
test:feature-scaffold(12-02)는 기능 둘을 생성한 fixture에서 merge 단계
명령을 돈다. 15-02의 test:unit은 초기 JS 기록
(config/scale/feature-shape-ceilings.json)을 빌드와 대조한다. 두 브랜치를
합치자 드릴 안의 test:unit·test:coverage가 "initialJavascript is stale"로
실패해 FE-GATE-020이 떨어진다. 제품은 생성 명령 Next: 3번대로 기록을 다시
쓰지만 드릴은 그 단계를 하지 않았다.

고른 방법
- 생성이 성공하면 fixture를 봉인하기 전에 measure-feature-shape-growth.ts
  --initial-baseline --write를 돌린다. 측정 스크립트가 없으면(샘플이 없으면)
  건너뛴다. 결과는 별도 검사(initial-javascript-record)로 보고한다.

위험·한계
- 드릴이 빌드 한 번만큼 길어진다.

검증
- check:types, eslint 통과. FE-GATE-020은 깨끗한 clone에서 다시 돈다.

Refs: docs/reviews/2026-11-03-maturity-review/12-guardrails-ci.md 12-02, 15-performance.md 15-02
2026-11-05 02:22:27 +09:00
DongHyeonka db5728b75f fix(dev): dev release manifest를 src 밖에 쓰고 Vitest에서는 만들지 않는다
문제
c15345c의 플러그인은 apply: "serve"라 Vitest가 Vite를 띄울 때도 돌아,
test:unit마다 자식 프로세스로 manifest를 쓴다. 출력 위치
src/.generated/dev-release-manifest.json에는 자리표시자의 routeChunks(샘플
경로)가 들어 있다. test:sample-removal의 잔여 검사는 src/를 훑으므로
FE-GATE-020이 "fixture-id-residue: src/.generated/dev-release-manifest.json"으로
실패한다.

고른 방법
- 출력을 빌드의 contract set 생성물 옆 .generated/frontend-runtime/로 옮긴다
  (무시 대상).
- apply가 serve이면서 VITEST가 없을 때만 돈다. 테스트는 서버에서
  manifest를 받지 않는다.

검증
- browser-files capability spec(dev server) chromium 3건 통과, 생성물이 새
  위치에 생긴다.
- test:unit 2,880건 통과, 실행 뒤 src/.generated에 manifest가 없다.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6 X2 #3
2026-11-05 02:04:15 +09:00
DongHyeonka 8b382aa64f test(dev): dev release manifest 테스트가 설치된 기능에 기대지 않는다
문제
dev-release-manifest 테스트의 둘째 경우가 생성 결과를 커밋된 자리표시자와
통째로 비교한다. 템플릿 기능만 있으면 같지만, 기능을 더한 제품이나 생성
기능을 넣은 제거 드릴 fixture에서는 contract set이 달라 실패한다. 깨끗한
clone의 FE-GATE-020(test:sample-removal 안의 test:unit)에서 떨어졌다. 이
리뷰가 여러 번 고친 "템플릿 그대로일 때만 맞는 테스트"와 같은 결함을 새로
만들었다.

고른 방법
- 둘째 경우는 contract set을 뺀 나머지 칸이 자리표시자와 같고, contract
  set이 설치된 기능의 buildContractSet()과 같은지 본다.

검증
- 테스트 2건, eslint, check:types 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6 X2 #3
2026-11-05 01:52:53 +09:00
DongHyeonka 0c9fcbd632 docs(changelog): 기능 추가 재실험에서 고친 것을 미출시 절에 더한다
문제
매뉴얼만으로 기능을 더한 재실험(리뷰 조치 X2)의 막힘 7건과 깨끗한 clone
검증에서 고친 것이 미출시 절에 없다.

고른 방법
- 그 밖의 수정에 한 행으로 적는다(dev release manifest 1103/16-09, 기능 제거
  드릴의 초기 JS 재기록 15-02, 파일 상한 32 15-05, 업로드 client 포트
  분리 01-01, 타입 검사 탐침 09-02, 시각·storybook 11-07).

검증
- tests/unit/changelog-review-ids.test.ts 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6
2026-11-05 01:39:22 +09:00
DongHyeonka 7f9a515dd9 fix(build): 빌드 복사본 입력 목록에 dev release-manifest 플러그인을 더한다
문제
c15345c가 vite.config.ts에서 scripts/lib/dev-release-manifest.ts를
import한다. 초기 JS를 재는 measure-feature-shape-growth.ts와
product-feature-selection-build 테스트는 빌드할 복사본에 정해진 파일만
복사하는데(BUILD_INPUTS), 그 목록에 새 파일이 없다. 그래서 복사본의 vite
build가 "Could not resolve './scripts/lib/dev-release-manifest.ts'"로 실패해
test:unit 두 파일과 세 capability 제거 드릴이 떨어졌다. c15345c 뒤에
test:unit 전체를 돌리지 않아 놓쳤다.

고른 방법
- 두 BUILD_INPUTS에 그 파일을 더한다.
- 두 목록이 같은 내용의 사본이다. 하나로 합치는 것은 이 수정의 범위 밖으로
  둔다(남은 문제).

검증
- test:unit 193파일 2,880건 통과, lint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6 X2 #3
2026-11-05 01:39:22 +09:00
DongHyeonka 3d3d6527ef fix(http): Fileserver 업로드 client가 browser-file-storage 포트를 import하지 않는다
문제
src/adapters/http/fileserver-upload.ts(1103/01-01)가 입력 타입으로
application/ports/browser-file-storage의 FileByteSource를 import한다.
test:browser-file-storage-removal(FE-GATE-020)은 그 선택 런타임과 포트를
지우고 남은 코드가 import하지 않는지 본다. 그래서 "Removed browser
file/storage runtime is still imported by: src/adapters/http/
fileserver-upload.ts"로 항상 실패한다(리뷰 조치 X2 #7).

고른 방법
- client 안에 같은 모양의 FileserverByteSource(byteLength, stream이
  Result<Uint8Array, { code }>를 낸다)를 두고 배럴로 낸다. client가 쓰는
  것은 이 셋뿐이다. 제품은 FileContentPort.openSource가 준 FileByteSource를
  그대로 넘긴다(구조 타입).
- 버린 대안: 드릴이 이 client도 함께 지우기. http 배럴이 export하므로 배럴도
  고쳐야 하고, 파일 runtime을 쓰지 않는 제품도 업로드 client를 잃는다.

위험·한계
- FileByteSource 모양이 바뀌면 두 타입이 어긋날 수 있다. 통합 테스트가
  FileByteSource 값을 client에 넘기므로 check:types가 그 어긋남을 잡는다.

검증
- check:types(테스트의 FileByteSource → client 호환), lint,
  check:architecture, test:integration 통과. 드릴은 이 커밋 뒤 재실행한다.

Refs: docs/reviews/2026-11-03-maturity-review/01-adapters-browser-transfer.md 01-01, README.md 14.6 X2 #7
2026-11-05 01:35:37 +09:00
DongHyeonka 72b8ab1507 docs(manual): 기능 추가 안내가 초기 JS 기록·로컬 게이트 조건·드릴 범위를 맞게 말한다
문제
매뉴얼만으로 기능을 더한 재실험(리뷰 조치 X2)에서 안내가 틀리거나 빠진
곳이 나왔다.
- 생성 명령 출력과 매뉴얼 01이 초기 JS 기록(config/scale/feature-shape-
  ceilings.json)을 말하지 않는다. 출력은 "baseline does not change"만 적는다.
- 01·create-feature.md가 "드릴은 check:bundle을 돌리지 않는다"고 적는다.
  12-02 뒤로 드릴은 merge 단계 명령으로 check:bundle을 돈다.
- 로컬에서 FE-GATE-013은 VITE_COMMIT_SHA가 40자리 커밋이어야 한다. 실패한
  게이트의 로그 위치가 어디에도 없다.
- 01 6단계가 "생성된 판은 파라미터가 없다"고 적지만 --with-create 상세
  라우트는 codec을 넘긴다. global-ids.md의 API 경로 예가 옛 생성 경로다.

고른 방법
- 생성 명령 Next에 3번(기록 다시 쓰기)과 로그 위치·FE-GATE-013 조건을
  더한다. 매뉴얼 01 "merge 전에 돌릴 것"에 같은 내용과 파일 수 상한을
  적는다. 나머지 문장을 지금 동작에 맞춘다.

검증
- tests/unit/create-feature.test.ts 43건, verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6 X2 #2 #5 #6
2026-11-05 01:33:38 +09:00
DongHyeonka 2fef27d57f build(perf): 초기 JS 파일 상한에 기능 하나가 더할 여유를 둔다
문제
initialJsFiles 상한이 템플릿 그대로의 수(26)와 같다(1b8cb12). 기능의 지연
페이지가 셸과 같은 구성요소(Button, SearchField)를 쓰면 그 구성요소가 공유
청크로 떨어져 초기 파일이 하나 는다. 매뉴얼의 검색 폼 예제를 따른 기능
하나로 FE-GATE-012가 "27 > budget 26"으로 실패했다(리뷰 조치 X2 #4).

고른 방법
- 상한을 32(지금 26 + 6)로 둔다. 템플릿은 HTTP/2 서빙을 요구하고
  (1103/13-02, FE-GATE-019), 그때 파일 하나의 비용은 거의 없다(15 영역
  측정). 상한은 청크가 통째로 쪼개지는 회귀를 막는 용도다.
- performance-evidence.md에 이유와, 넘었을 때 먼저 청크 그룹을 볼 것을
  적는다.
- 버린 대안: 상한을 지금 수로 두고 제품마다 올리기. 템플릿 소유 파일을
  기능마다 고치게 된다.

위험·한계
- 합계 바이트 예산(204,800 B)은 그대로다. 여유는 1,873 B다.

검증
- performance-budgets·bundle-artifact-contract 테스트 14건,
  verify:documentation 통과.

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-05, README.md 14.6 X2 #4
2026-11-05 01:33:38 +09:00
DongHyeonka 72c6e9db4a fix(removal): 기능 제거 드릴이 지운 뒤 초기 JS 기록을 다시 쓴다
문제
config/scale/feature-shape-ceilings.json의 initialJavascript는 지금 설치된
기능으로 만든 빌드를 기록하고, test:unit이 빌드와 대조한다(1103/15-02).
제품이 기능을 더하면 기록을 다시 써야 FE-GATE-005가 통과한다. 그러면
`test:sample-removal -- --feature=<id>`가 그 기능을 지운 fixture에서 반대
이유("record 27, build 26")로 실패한다. 두 게이트를 함께 통과시킬 방법이
없다(리뷰 조치 X2 #2).

고른 방법
- 드릴이 레지스트리 기준선을 다시 찍는 것과 같은 자리에서
  measure-feature-shape-growth.ts --initial-baseline --write를 fixture에서
  돌린다. 제품이 기능을 지운 뒤 할 일을 드릴이 그대로 한다.
- 샘플 제거는 측정 스크립트를 함께 지우므로 그때는 건너뛴다.

위험·한계
- 측정이 빌드를 하므로 기능 제거 드릴이 1~2분 길어진다.

검증
- eslint 통과. 기능 제거 드릴은 X4 재실행(test:feature-scaffold 안의
  feature-removal)에서 확인한다.

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-02, README.md 14.6 X2 #2
2026-11-05 01:33:38 +09:00
DongHyeonka 235143c5ba test(features): 제품 확장 타입 검사 탐침이 제품 이름·파일·제거 상태와 겹치지 않는다
문제
tests/unit/product-extension-typecheck.test.ts(1103/09-02)는 복사본에 제품
파일과 기능 하나를 넣고 tsc 세 프로그램을 돈다. 세 가지가 제품과
제거 드릴에서 깨진다(리뷰 조치 X2 #1, #7).
- 탐침 ID가 notice-feature·notice-context다. 매뉴얼 예시가 모두 "공지"라
  제품이 같은 ID를 쓰면 FE-GATE-005가 원인을 말하지 않는 TS 오류 약
  20줄로 실패한다.
- product-capabilities.ts가 템플릿의 빈 선언 그대로여야 한다고 단언하고
  그 선언을 바꿔 쓴다. 자기 capability를 적은 제품에서 실패한다.
- 복사 대상을 모두 복사한다. test:optional-recipe-removal의 fixture에는
  recipes/가 없어 ENOENT로 떨어진다.

고른 방법
- 탐침 이름을 typecheck-probe-*(capability typecheckProbeSettings, 설정 키
  TYPECHECK_PROBE_PAGE_SIZE)로 바꾸고, 그 기능 폴더가 이미 있으면 이름을
  말하며 실패한다.
- capability 타입은 제품 파일 끝에 같은 이름 interface로 덧붙인다.
  TypeScript가 합치므로 제품의 선언이 남는다.
- 없는 복사 대상은 건너뛴다.

위험·한계
- product-contracts.ts·product-composition.ts는 여전히 탐침 내용으로 바꿔
  쓴다. 제품 기능이 이 두 파일의 이름 있는 export를 import하면 복사본에서
  타입 오류가 날 수 있다.

검증
- 테스트 통과, eslint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/09-app-core.md 09-02, README.md 14.6 X2
2026-11-05 01:33:38 +09:00
DongHyeonka c15345cb1d fix(dev): dev server가 설치된 기능의 contract set으로 release manifest를 낸다
문제
`create:feature`가 만든 기능은 계약 패키지(`@org-contracts/<base>`)를
선언한다. dev server는 커밋된 자리표시자 public/release-manifest.json을
그대로 내주는데, 그 contractSet.packages는 고정된 빈 목록이다. 부팅이 이
집합을 설치된 선언과 대조하므로, 기능을 생성한 직후 `corepack pnpm dev`가
CONTRACT_SET_PACKAGE_MISSING으로 "애플리케이션을 시작할 수 없습니다"를
보인다. 같은 이유로 dev server를 쓰는 FE-GATE-008의
test:browser-capabilities가 38건 실패하고("Execution context was
destroyed"), 매뉴얼에는 이 파일을 고치라는 말이 없다. 매뉴얼만으로 기능을
더하는 재실험(리뷰 조치 X2 #3)에서 찾았다.

고른 방법
- dev 전용 Vite 플러그인(scripts/lib/dev-release-manifest.ts)이 dev server를
  시작할 때 scripts/write-dev-release-manifest.ts를 자식 프로세스로 돌려
  src/.generated/dev-release-manifest.json(무시되는 생성물)을 쓰고,
  `/release-manifest.json` 요청에 그것을 낸다. 내용은 자리표시자에
  설치된 기능의 contract set(build와 같은 buildContractSet)을 넣은 것이다.
- 자식 프로세스로 돌리는 이유: contract set을 만들려면 설치된 기능 선언을
  import해야 하는데, Vite 설정이 그것을 불러오면 안 된다.
- build는 바뀌지 않는다. 빌드 manifest는 generate-build-manifest.ts가 만든다.
- 버린 대안: dev 자리표시자에서 contractSet을 빼기. V2 manifest 스키마가
  contractSet을 요구한다. 생성기가 추적 파일(public/release-manifest.json)을
  다시 쓰기: 기능 선택이 바뀌는 실행마다 추적 파일이 바뀐다.

위험·한계
- dev server를 켠 뒤 기능을 더하거나 지우면 dev server를 다시 켜야 한다.
- 자리표시자의 routeChunks는 여전히 손으로 둔다(부팅이 dev에서 보지 않는다).

검증
- tests/unit/dev-release-manifest.test.ts 2건(낡은 집합을 설치된 집합으로
  바꾼다, 템플릿 그대로면 자리표시자와 같다).
- check:types, lint, check:architecture, check:ci 통과.
- 생성 기능을 더한 깨끗한 clone의 capability 실행은 X4 재실행에서 본다.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.6 X2 #3
2026-11-05 01:33:38 +09:00
DongHyeonka 5ca5340e11 fix(removal): 샘플 제거 뒤 남는 파일에 샘플 ID 글자를 쓰지 않는다
문제
test:sample-removal의 잔여 검사(REFERENCE_RESOURCE|reference-feature|
reference-resource)가 샘플을 지운 fixture에서 두 파일을 잡아 FE-GATE-020이
실패한다. tests/unit/hosting-probe.test.ts는 비상 스위치 예시로
FEATURE_OVERRIDES에 "reference-feature"를 쓰고(13-01), platform-examples-
context의 머리 주석은 참조 context 경로를 적는다(09-04).

고른 방법
- 테스트 값을 "platform-examples-feature"로 바꾸고, 주석은 샘플 이름 없이
  적는다. 동작은 바뀌지 않는다.

검증
- tests/unit/hosting-probe.test.ts 37건, lint 통과. 제거 드릴은 X4 재실행에서
  확인한다.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.5
2026-11-05 01:26:27 +09:00
DongHyeonka 9bddfa529f fix(ci): 시각 골든 빌드가 CI의 빌드·release 식별값을 물려받지 않는다
문제
홈 화면과 플랫폼 구성 화면은 build id와 release id를 글자로 그린다. CI는
workflow 전체에 VITE_BUILD_ID·VITE_COMMIT_SHA·RELEASE_ID를 준다. 그래서
test:visual(FE-GATE-008)의 build가 골든과 다른 글자를 그려, 셸 넓은 화면·
좁은 서랍·플랫폼 구성 3장이 1,109~1,545 px 달라 항상 실패한다. 깨끗한
clone에 CI env를 준 merge 단계 재실행에서 찾았다(af312de와 같은 원인,
1103/11-07).

고른 방법
- playwright.visual.config.ts webServer env로 로컬 식별값(local-build,
  local, local-release)을 준다. 골든은 템플릿의 모양 계약이고 그 값으로
  찍었다.
- 버린 대안: 식별값 글자를 화면마다 가리기. 가릴 곳이 화면마다 늘고,
  식별값을 그리는 새 화면이 생길 때마다 다시 빠진다.

위험·한계
- 시각 테스트의 build는 CI 식별값을 쓰지 않는다. 식별값 표시 자체는
  e2e(compact smoke, 11-06)가 CI 값으로 본다.

검증
- VITE_BUILD_ID=gitea-1-1·VITE_COMMIT_SHA·RELEASE_ID를 주고 test:visual 6/6,
  env 없이 6/6 통과. 수정 전 CI env에서 3건 실패.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-07
2026-11-05 01:26:27 +09:00
DongHyeonka 2c2d459b17 docs(operations): 성능 기록 문서가 샘플과 함께 지워지는 경로를 백틱 없이 적는다
문제
fix/r1103-release(15-02)가 performance-evidence.md에 기준선 기록 파일
(config/scale/feature-shape-ceilings.json)과 측정 테스트
(tests/unit/feature-shape-growth.test.ts)를 백틱 경로로 적었다. 둘 다 참조
기능을 복사해 재므로 test:sample-removal이 함께 지운다. 그래서 제거
fixture에서 verify:documentation이 실패하고 documentation-readiness
테스트 36건이 떨어진다(깨끗한 clone FE-GATE-020). 14-04 규칙(지울 수 있는
샘플 경로는 백틱 없이)과 2f2426a와 같은 결함이다.

고른 방법
- 두 경로를 백틱 없이 적고, 샘플과 함께 지워진다고 적는다.

검증
- verify:documentation PASS_SCOPED. 제거 fixture는 X4 재실행에서 확인한다.

Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-04, 15-performance.md 15-02
2026-11-05 00:50:44 +09:00
DongHyeonka f92cfd9a98 test(storybook): workshop spec이 a11y 애드온 자동 검사와 겹치지 않는다
문제
깨끗한 clone의 FE-GATE-008에서 test:storybook이 "Axe is already running"으로
떨어졌고, 이 worktree에서도 두 번에 한 번 떨어진다. @storybook/addon-a11y
10.6.5(13-03이 올린 판)는 story를 그린 뒤 afterEach에서 axe를 스스로 돌린다
(globals.a11y.manual이 true가 아니면). spec의 AxeBuilder.analyze()는 그 페이지의
같은 axe 인스턴스를 쓰므로, 두 실행이 겹치면 두 번째가 거절된다.

고른 방법
- spec이 story를 `globals=a11y.manual:!true`로 연다. 애드온은 자동 검사를
  건너뛰고, 접근성 판정은 지금처럼 spec의 AxeBuilder가 한다.
- 버린 대안: 애드온 실행이 끝나길 axe 내부 상태로 기다리기. 공개 API가
  아니고, 애드온 실행이 시작되기 전에 확인하면 여전히 겹친다.
- 버린 대안: preview 전체에서 애드온 자동 검사 끄기. workshop에서 쓰는
  사람이 패널 결과를 잃는다.

위험·한계
- 이 spec만 바꿨다. 다른 storybook spec이 생기면 같은 URL을 쓴다.

검증
- test:storybook 5회 연속 통과(heavy lock). 수정 전 2회 중 1회 실패.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 14.5
2026-11-05 00:50:44 +09:00
DongHyeonka 53567879e7 docs(changelog): 깨끗한 clone 검증에서 찾은 CI 빌드 식별값 수정을 미출시 절에 더한다
문제
af312de(vitest와 dev server Playwright가 CI의 VITE_BUILD_ID·VITE_COMMIT_SHA를
물려받지 않는다)는 CHANGELOG 재작성(44aa44d) 뒤에 들어왔다. 미출시 절
머리의 끝 커밋 설명도 그 뒤의 변경을 말하지 않는다.

고른 방법
- 게이트·드릴 행에 1103/11-07 행을 더한다. 리뷰 README 13절에 발견으로
  적는다.
- 머리에 f887817 뒤로 검증 수정과 pin 갱신이 더해졌다고 적는다.

검증
- tests/unit/changelog-review-ids.test.ts 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-07
2026-11-05 00:25:24 +09:00
DongHyeonka 580be5839d docs(contracts): 짝 백엔드 계약 기준점을 45d2a478로 올린다
문제
check:backend-contract-drift가 백엔드 HEAD 45d2a478에서 http-contract.md §2
두 행의 설명 변경을 알린다. IDEMPOTENT_IN_FLIGHT(PostgreSQL 저장소는 409
대신 첫 요청이 끝날 때까지 기다림)와 IDEMPOTENCY_UNAVAILABLE(processing
lease가 시작 전에 끝나 저장소가 시작을 거절함)이다. 같은 커밋이 6.1절이
인용하는 GlobalExceptionHandler와 IdempotencyExecutor도 고쳤다.

고른 방법
- 두 행의 code·status·retryable·재전송 규칙은 같다. 프론트 판정(처리 중
  MAYBE_APPLIED·같은 키, UNAVAILABLE 실행 안 됨·같은 키 자동 재전송)은
  바꾸지 않는다.
- 6.1절이 인용하는 블록 13개를 두 판에서 대조했다. 내용은 모두 같고
  GlobalExceptionHandler 4개, IdempotencyExecutor 1개의 줄 번호만 옮겼다.
  인용한 다른 백엔드 파일 15개는 바뀌지 않았다.
- pin, 답 표 JSON, 계약 문서 4.1·6·6.1절, CHANGELOG의 pin 행과 알려진
  제한을 같이 고친다.

위험·한계
- PostgreSQL 저장소의 기다림이 프론트 totalDeadline보다 길면 응답 없는
  끝(결과 불명, 키 유지)이 된다. 판정은 안전 쪽이다.
- Fileserver 계약(docs/fileserver/http-contract.md)은 bbe944bd 이후 바뀌지
  않았다.

검증
- check:backend-contract-drift --backend <백엔드 checkout>: pinned
  45d2a478.
- backend-contract-pin·changelog-review-ids 테스트 11건,
  verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/12-guardrails-ci.md 12-06
2026-11-05 00:24:59 +09:00
DongHyeonka 01b9def556 chore(review): 1103 CHANGELOG·문서 정리 브랜치를 합친다
Refs: docs/reviews/2026-11-03-maturity-review/README.md 14-01 14-02 16-08 P-07-07
2026-11-05 00:23:06 +09:00
DongHyeonka 0d7b9dfe01 docs(readme): 로컬 merge 게이트 반복문과 업데이트 절을 이 묶음에 맞춘다
문제
- "CI and evidence"의 로컬 merge 게이트 반복문이 13개이고 FE-GATE-012가 없다.
  f41e3d5가 번들 예산 게이트를 merge 단계로 옮겨 gates.json의 merge 단계는
  14개다. "Updating a copied project"가 이 반복문을 가리키므로, 동기화한
  제품은 번들 예산을 건너뛴다.
- 배포 슬롯을 채우는 곳이 config/ci/product-gates.json으로 바뀌었고(12-07),
  FE-GATE-019는 HTTP/2·entry 압축이 없는 호스트도 실패시킨다(13-02).
  README는 둘 다 말하지 않는다.
- CHANGELOG 미출시 절이 동기화 단위 순 요약이 됐는데(14-01 D5 (b)), 업데이트
  절은 그 절을 어떻게 받는지 말하지 않는다.

고른 방법
문장 셋만 고친다. 반복문에 012를 넣고 개수를 14로, 제품 merge 검사
(PRODUCT-GATE-NNN)는 workflow의 product_merge_gate job이 돈다고 적었다.
업데이트 절에는 미출시 절을 범위째 받고 "먼저 할 일"부터 하라는 한 문장을
더했다. cherry-pick 절차는 그대로 둔다(한 수정을 받을 때는 여전히 맞다).

위험·한계
- README의 다른 절(0929/14-02의 범위 동기화 절차 전체)은 다시 쓰지 않았다.

검증
- verify:documentation PASS_SCOPED, documentation-readiness 테스트 통과.
- config/ci/gates.json merge 단계 gateIds 14개와 반복문을 대조했다.

Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-01
Refs: docs/reviews/2026-11-03-maturity-review/12-guardrails-ci.md 12-07
2026-11-05 00:22:19 +09:00
DongHyeonka 65fa0a78e3 docs(manual): 기능 추가 문서의 낡은 문장 넷을 지금 검사·백엔드에 맞춘다
문제
리뷰 16-08이 적은 다섯 문장 중 넷이 f887817에서도 코드와 다르다.
- 01 3단계: 라우트 루트 검사를 tests/architecture/context-route-roots.test.ts가
  "실행한다"고 적는다. 그 테스트는 fixture만 쓰고 설치된 기능을 보지 않는다.
  실제로 막는 것은 앱 모듈을 적재하는 테스트와 부팅이다.
- 01 3단계·02 결정표: 인증 프로필이 틀리면 "operation을 적재하는 모든 게이트가
  실패한다". 변이로 확인하면 check:registries와 그 기능을 적재하는 테스트만
  실패하고 check:types·check:architecture·verify:documentation은 통과한다.
- 01 8단계: "서버 422 오류를 받을 필드". 짝 백엔드의 필드 검증은 400
  VALIDATION_FAILED + details다. 공유 MSW 시나리오의 validation-422는
  Envelope operation에서 결과 불명이다.
- starter-experience.md: "`NoRequest` already belongs to the sample". src에
  NoRequest가 없다. 생성 명령이 <Pascal>NoRequest를 쓴다.
다섯째("테스트 2개")는 생성기 브랜치가 이미 고쳤다(테스트 3개와 test-app).

고른 방법
문장만 고친다. 리뷰가 검토하라고 한 공유 시나리오 validation-400 추가는 하지
않았다. 문서 작업 범위 밖이고, 생성된 작성 폼 테스트가 400 본문을 이미 손으로
적는다. 매뉴얼에 그 테스트를 가리켰다.

위험·한계
- 문장의 게이트 목록은 참조 기능에 넣은 변이 한 번으로 확인했다. build는
  돌리지 않았다.

검증
- 인증 프로필 오타 변이: check:registries rc=1(reason 포함), check:types rc=0,
  check:architecture PASS, verify:documentation PASS_SCOPED. 되돌림.
- verify:documentation PASS_SCOPED, documentation-readiness 테스트 통과.

Refs: docs/reviews/2026-11-03-maturity-review/16-structure-patterns.md 16-08
2026-11-05 00:22:05 +09:00
DongHyeonka 44aa44dbc5 docs(changelog): 미출시 절을 동기화 단위의 순 변경 요약으로 다시 쓴다
문제
미출시 절은 fix/ui-design-audit-2026-11-01 한 브랜치의 누적 기록이었다.
- 같은 묶음에 들어온 그 브랜치 뒤 16커밋(ece944d d0414c8 7d85589 7c8cb19
  17fa8d1 27f4523 8a09c90 e5b7b3e 등)과 2026-11-03 조치 11개 브랜치가 없다.
- V2를 고친 행과 V2를 지운 행이 함께 있고, 알려진 제한 13줄 중 대부분이
  이미 고쳐졌다.
- BREAKING 이행 안내가 "memento-web이 V2 API 행을 쓴다"고 적었다. memento-web의
  apiOperations는 비어 있고, 실제 작업은 descriptor 29개의 FE-REG-API 행,
  스키마 행 43개, zod가 아닌 검증기다. tech-log의 직접 조립 경로는 안내가
  없었다.
- 0.2.0의 17d617a 행이 설정 스키마 분류기를 "레지스트리 호환성 분류기"라고
  부르고, 그 커밋이 고치지 않은 scripts/check-registries.ts를 적는다.

고른 방법
- 결정 D5 (b): 752a61f → fix/maturity-review-2026-11-03 범위를 한 동기화
  단위로 보고 최종 상태만 적는다. 머리에 범위·세 갈래·읽는 법, 이어서
  "먼저 할 일 (BREAKING)"을 옮기기 전 / 옮기는 법 / 옮긴 뒤 확인 순서로,
  그 뒤 영역별 [보안]·[계약] 표, 그 밖의 수정, f887817에서 사실인 알려진
  제한을 둔다. 뒤 커밋이 바꾼 중간 상태 행(V2 Envelope·V2 거절·V2/V3 대조,
  REST 보안 프로필 메시지, 초기 청크 16→25개 등)은 최종 행에 합치거나 지웠다.
- 14-02: 두 다운스트림(memento d3810a0, tech-log 7a4e201a)을 읽고 단계마다
  실제 모양을 적었다. memento: PRODUCT_LOCAL_CONTRACT 출처, ownsShell·APP_HOME
  다리, SW ACTIVE 선택, 손으로 쓴 검증기. tech-log: NOT_INSTALLED 직접 조립과
  기능 모듈로 바꾸는 길(fixture-layout-product 모양).
- 리뷰 P-07-07은 경로를 scripts/lib/registry-compatibility.ts로 바꾸라고
  했지만, 17d617a가 고친 것은 src/contracts/compatibility.ts(FE-GATE-014)다.
  경로를 바꾸면 틀린다. 그래서 이름을 "설정 스키마 호환성 분류기"로,
  둘째 경로를 scripts/check-compatibility.ts로 고쳤다.
- 머리 규칙에 미출시 절이 동기화 단위 순 요약이라는 줄을 더했다.
- 버린 대안: 브랜치별 누적 기록을 유지하고 빠진 행만 더하기(14-01 (a)).
  다운스트림이 서로 뒤집는 행을 직접 걸러야 한다. 커밋 trailer 검사
  (14-01 (c))는 이번에 넣지 않았다.

위험·한계
- 안내를 두 제품 코드에 적용해 게이트를 돌려 보지 않았다. memento 숫자는
  정적 집계다. 알려진 제한에 적었다.
- 끝 커밋은 f887817 기준이다. 이 브랜치를 합친 뒤 끝이 바뀌어도 해시 규칙
  (범위 안)은 그대로다.
- 짝 백엔드가 pin c508b1ba 뒤로 바뀐 것(HEAD 45d2a478, §2 두 행 설명)을
  알려진 제한에 적었다. pin은 올리지 않았다.

검증
- 미출시 절의 이 repo 해시 148개: 모두 f887817에서 닿고 752a61f에서 닿지
  않는다(merge-base --is-ancestor 스크립트). 나머지는 기준점 2개와 다른
  repo 커밋 4개.
- vitest changelog-review-ids, documentation-readiness 20건 통과.
- verify:documentation PASS_SCOPED, check:types, lint 통과.
- 인증 프로필 오타 변이(참조 기능): check:registries가 reason과 함께 실패,
  check:types·check:architecture·verify:documentation 통과를 확인했다.

Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-01
Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-02
Refs: docs/reviews/2026-11-03-maturity-review/07-contracts.md P-07-07
2026-11-05 00:21:49 +09:00
DongHyeonka 2f2426a670 docs: 샘플과 함께 지워지는 경로를 백틱 없이 적는다
문제
ac52a93이 backend-api-and-server-state-contract.md를 docs/README.md 1절에서
링크해 이 문서도 경로 검사를 받는다. 이 문서는 참조 기능 파일 둘을 백틱
경로로 적는다. static-delivery.md는 config/scale/feature-shape-ceilings.json
(15-02, 샘플 제거 때 함께 지워짐)을 백틱 경로로 적는다. 그래서 참조 기능을
지운 제거 fixture에서 verify:documentation이 "names paths that do not exist"로
실패하고, 그 fixture의 documentation-readiness 테스트 36건이 떨어진다
(FE-GATE-020). 14-04가 정한 규칙(지울 수 있는 샘플 경로는 백틱 없이)을
어겼다.

고른 방법
- 세 경로를 백틱 없이 적고, static-delivery에는 샘플과 함께 지워진다고
  적는다.

검증
- verify:documentation PASS_SCOPED. 제거 fixture 확인은 X4 재실행에서 한다.

Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-04, 14-03
2026-11-05 00:13:49 +09:00
DongHyeonka af312deeca fix(ci): 테스트와 dev server가 CI의 빌드 식별값을 물려받지 않는다
문제
.gitea/workflows/quality-gates.yml은 workflow 전체 env에
VITE_BUILD_ID=gitea-<run>-<attempt>와 VITE_COMMIT_SHA를 넣는다. Vite는 이
값을 import.meta.env로 번들에 넣는다. 그래서 CI와 같은 env로 돌리면:
- vitest: 앱을 local-build fixture release로 조립하는 테스트가
  CONFIG_BUILD_MISMATCH로 실패한다(runtime-application,
  boot-unexpected-failure, runtime-composition-service-worker-telemetry,
  reference-production-vertical, 생성 기능 페이지 테스트). FE-GATE-005·006·
  007과 제거 드릴(FE-GATE-020)이 떨어진다.
- capability e2e: dev server는 public/config.json(BUILD_ID local-build)을
  내주는데 번들은 gitea-1-1이라, 페이지마다 rolling-release 불일치로 한 번
  다시 불러오고 그다음 실패 화면이 된다. page.evaluate가 "Execution context
  was destroyed"로 30건 실패한다(FE-GATE-008).
깨끗한 clone에서 merge 단계 14개를 CI env로 돌려(리뷰 조치 X4) 찾았다.
로컬에서는 이 값이 없어서 늘 통과한다. 1103/11-06과 같은 원인이다.

고른 방법
- vitest.config.ts가 npm scope 변수를 지우는 것과 같은 자리에서
  VITE_BUILD_ID·VITE_COMMIT_SHA를 지운다. 테스트는 로컬 빌드 식별값으로
  시작한다.
- dev server를 띄우는 Playwright 설정(capabilities, dev)은 webServer env로
  VITE_BUILD_ID=local-build, VITE_COMMIT_SHA=local을 준다. 그 dev server가
  내주는 config.json과 같은 값이다.
- build·preview를 쓰는 e2e·visual은 바꾸지 않았다. 빌드가 같은 값으로
  config.json을 만들므로 맞는다.
- 버린 대안: 테스트마다 기대값을 env에서 읽기(11-06 방식). 같은 모양의
  fixture가 여러 파일에 있고, 다음 테스트가 또 같은 실수를 한다.

위험·한계
- vitest 안에서 CI 빌드 식별값을 읽는 것을 검사하려는 테스트는 값을 직접
  넣어야 한다(지금은 없다).
- CI=true와 러너 이미지 조건은 재현하지 않았다.

검증
- VITE_BUILD_ID=gitea-1-1, VITE_COMMIT_SHA=<HEAD>로: test:unit 2,878,
  test:component 270, test:integration 189, test:reference-feature 97,
  test:recipes 77 통과. browser-files capability spec chromium 3건 통과
  (수정 전 3건 실패, env 없으면 통과).

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-06
2026-11-05 00:13:49 +09:00
DongHyeonka f88781760e test(scale): 통합 뒤 초기 JS 기준선을 빌드에서 다시 적는다
문제
fix/r1103-release(15-02)는 초기 JS 기준선을 feature-shape-ceilings.json의
initialJavascript 한 곳에 두고, test:unit이 빌드와 대조하게 했다. 열 개
조치 브랜치를 합친 빌드는 그 브랜치 하나로 잰 기록(200,939 B, 25개)과
다르다(15-01이 떨어뜨린 파일 하나, 세션·업로드·생성기 변경). 그래서
feature-shape-growth 테스트가 "initialJavascript is stale"로 실패한다.

고른 방법
- 기록 절차(performance-evidence.md)대로
  measure-feature-shape-growth.ts --initial-baseline --write로 다시 쓴다.
- 결과: 202,927 B, 26개, 기능 하나 +768 B, context 하나 +233 B.
  예산 204,800 B에 여유 1,873 B다.

위험·한계
- 여유가 작다. --with-create 기능 하나(+약 964 B)를 넣으면 약 900 B가
  남는다.

검증
- tests/unit/feature-shape-growth.test.ts 통과(heavy lock,
  CHOKIDAR_USEPOLLING=1).

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-02 15-04
2026-11-04 23:51:14 +09:00
DongHyeonka 41f8801d64 chore(review): 1103 기능 생성기·기능 패턴 조치 브랜치를 합친다
Refs: docs/reviews/2026-11-03-maturity-review/README.md 03-07 09-06 16-01 16-04~16-07

# Conflicts:
#	docs/manual/01-add-a-feature.md
#	docs/manual/reference/create-feature.md
#	docs/manual/reference/patterns.md
#	scripts/create-feature.ts
#	scripts/test-feature-scaffold.ts
2026-11-04 23:49:27 +09:00