Commit Graph
1165 Commits
Author SHA1 Message Date
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 397664e439 test(features): 제품 확장 타입 검사 탐침이 제품 파일을 덮어쓰지 않고 덧붙인다
문제
tests/unit/product-extension-typecheck.test.ts(1103/09-02 탐침)는 저장소
복사본의 src/contracts/product-contracts.ts와
src/bootstrap/product-composition.ts를 탐침 내용으로 통째로 바꿔 쓴다.
탐침의 composeProduct는 typecheckProbeSettings 하나만 돌려준다. 제품이
자기 capability를 product-composition.ts에서 만들고 자기 기능의 needs에
적으면, 복사본에서는 그 값이 사라져 app 프로그램이
src/bootstrap/runtime-adapters.ts에서 TS2741로 실패한다. memento와
tech-log 모두 제품 capability를 쓰므로, 동기화 직후 FE-GATE-005가 코드와
무관하게 실패한다(리뷰 실험 09-probe-downstream).

고른 방법
- 탐침은 복사본의 product-contracts.ts·product-composition.ts를 같은
  폴더의 typecheck-probe-product-contracts.ts·
  typecheck-probe-product-composition.ts로 옮긴다. 새 파일은 옮긴 모듈을
  export *로 다시 내보낸다. 그리고 런타임 설정 필드, env 행,
  composeProduct 결과와 그 capabilities를 펼친 뒤 탐침의 키·행·capability만
  더한다. 인증 프로필, credential provider, 선택 칸, session owner, 제품이
  더한 다른 export는 그대로 남는다.
- capability 타입은 저장소가 아니라 복사본의 product-capabilities.ts 끝에
  덧붙인다.
- 같은 함수로 "제품 capability를 기능에 주는 다운스트림"을 먼저 만들고 그
  위에 탐침을 올리는 케이스를 더했다(describe 1105/09-01). 다운스트림
  흉내도 덧붙이는 방식이라, 실제 다운스트림에서 이 테스트를 돌려도 그
  제품의 파일을 지우지 않는다. 이름은 예약 접두사
  typecheck-probe-downstream-*를 쓴다.
- 예약 이름 검사는 기능 폴더에 더해 context 폴더와 옮길 파일 이름도 본다.

버린 대안
- 제품 파일이 출하 상태가 아니면 탐침을 건너뛴다(리뷰의 (나)). 다운스트림
  상태의 타입 경로 확인을 잃고, 건너뛰기로 검사를 약하게 한다.
- 다운스트림 흉내를 제품 파일 전체를 새로 쓰는 방식으로 만든다. 실제
  다운스트림에서 이 테스트를 돌리면 그 제품의 capability를 지워 같은
  TS2741이 다시 난다.

위험·한계
- 제품 파일의 export 이름(composeProduct, composeProductSessionOwner,
  PRODUCT_*)에 기댄다. 템플릿이 그 이름을 import하므로 계약이다.
- credentialProviders와 인증 프로필은 Record라 빠져도 tsc가 모른다.
  펼쳐서 남기지만 테스트로 증명하지는 않는다.
- 탐침 context는 여전히 소유 앱을 template-app으로 고정한다. 앱 id를
  바꾼 제품에서는 생성기가 멈출 수 있다(리뷰 09-01의 남은 가정, 실행
  안 함). 이 커밋 범위 밖이다.
- 케이스가 하나 늘어 이 파일의 tsc 실행이 3회에서 6회가 된다. 케이스별
  제한 시간 120초는 그대로다.
- 결함이 테스트 파일 안의 탐침에 있어서, 표준 RED 구성(커밋의 테스트 +
  부모의 비테스트 파일)은 GREEN과 같다. RED는 커밋 위에 탐침을 부모처럼
  덮어쓰게 되돌리는 patch를 적용해 본다.

검증
- desktop batch에서 확인: node scripts/run-vitest.ts run
  tests/unit/product-extension-typecheck.test.ts, check:types, lint.
  RED patch를 적용하면 1105/09-01 케이스만 TS2741로 실패해야 한다.
- 이 노트북에서는 실행하지 않았다.

Refs: 1105/09-01
2026-11-05 22:05:52 +09:00
DongHyeonka 27e3dec5dd fix(realtime): poll execute에 생성 때 검사한 descriptor를 넘긴다
문제: bounded poll은 생성 때 descriptor의 `retryBudget`이 0인지 본다
(1103/04-01). 그런데 `execute` 입력에는 descriptor가 없다. 조합 코드는
실행기에 넘길 descriptor를 스스로 골라야 하고, 같은 경로의 기본 GET
(`retryBudget: 2`)을 넘겨도 막는 것이 없다. 리뷰 04-R1 P5에서 poll 3회가
요청 9회, 실행기 대기 6번이었다. 타입 주석과 설계 9.2가 "같은 객체를
넘긴다"고 적을 뿐이다.

고른 방법: coordinator가 생성 때 검사한 그 객체를 모든 `execute` 호출에
`input.operation`으로 넘긴다. 생성 때 한 번 잡아 두므로 나중에
dependencies 객체가 바뀌어도 검사한 객체가 간다. 조합 코드는 클로저의
descriptor 대신 이것을 실행기에 넘기면 된다. 테스트의 V3 조합도 그렇게
바꿨다. 타입 주석(`bounded-polling.ts`, `bounded-poll-coordinator.ts`)과
설계 9.2를 고쳤다.
버린 대안: coordinator가 실행기를 직접 받아 부르기. 실행기 타입은
`adapters/http`에 있어 realtime 어댑터가 import할 수 없다(adapter 사이
import 금지, kernel 예외 아님). 구조 타입을 새로 두면 결과 매핑까지
coordinator가 정해야 해서 공개 모양이 크게 바뀐다.

위험·한계: 일부만 닫는다. 조합 코드가 `input.operation`을 무시하고 다른
descriptor를 실행기에 넘기면 여전히 attempt마다 요청이 최대 3번이다.
설계 9.2가 이 남은 틈을 적는다. 입력 칸을 더한 것이라 기존 `execute`는
그대로 돈다.

검증: desktop batch에서 확인.
- node scripts/run-vitest.ts run tests/unit/realtime/
- RED: "hands every execute call the descriptor it checked at creation"
  (받은 값이 undefined), "sends one request per poll attempt with a poll
  descriptor"(실행기에 undefined가 가서 요청 0개, PROTOCOL_MISMATCH)가
  옛 코드에서 실패한다.

Refs: 1103/04-01
2026-11-05 22:05:31 +09:00
DongHyeonka 05330e30a8 fix(realtime)!: 던지는 poll execute를 서버 장애가 아니라 PROTOCOL_MISMATCH로 끝낸다
문제: bounded poll은 `execute`의 throw를 PROVIDER_UNAVAILABLE/retryable로
바꿔 lease 안에서 다시 부른다(af00067). 설계 9.2가 권하는 조합은
`execute` 안에서 V3 실행기를 부르는 것이고, 실행기는 fetch 거절을 던지지
않고 NETWORK_FAILURE 결과로 돌려준다. 그래서 그 조합에서 throw는 결과
매핑·디코딩 같은 조합 코드 결함이다. 지금은 그 결함이 maxAttempts번의
요청과 ATTEMPT_FINISHED: PROVIDER_UNAVAILABLE, 끝으로
POLL_BUDGET_EXHAUSTED가 되어 서버 장애로 보인다. 원인 예외는 남지 않는다.

고른 방법: 리뷰 04-02의 선택지 (b). throw를 모양이 틀린 결과와 같은
계약 위반으로 본다. coordinator는 이미 `parseAttemptResult`가 거절한
결과를 재시도 없이 PROTOCOL_MISMATCH로 끝낸다. throw도 그 길로 보낸다.
lease 자신의 abort로 생긴 throw는 지금처럼 abort의 이유(ABORTED,
OFFLINE, 예산 소진 등)로 끝난다. `execute` 타입 주석, 설계 9.2와 13.1의
PROVIDER_UNAVAILABLE·PROTOCOL_MISMATCH 행을 같이 고쳤다.
버린 대안:
- (c) 주석과 13.1에만 "throw는 서버 장애로 재시도된다"를 적기. 완료
  기준은 "결과를 보고 조합 결함과 서버 장애를 구분한다"인데, (c)는 읽는
  사람만 알고 결과는 그대로라 구분할 수 없다.
- 관측에 throw 표시 칸을 더하기. 닫힌 관측 어휘를 넓히고, 결과 kind는
  여전히 서버 장애다.

위험·한계:
- 배럴로 공개된 bounded poll의 결과가 바뀐다. repo 안 소비자는 테스트뿐이다.
- `fetch`를 직접 부르는 조합은 네트워크 실패를 결과로 바꾸지 않으면 첫
  거절에서 lease가 끝난다. 설계가 권하지 않는 조합이고, 타입 주석과
  9.2가 "실패도 결과로 돌려준다"를 적는다.
- reconnect coordinator는 던지는 `attempt`를 계속 PROVIDER_UNAVAILABLE로
  재시도한다. 그쪽 attempt는 브라우저 연결 API를 감싸는 자리라 이번
  범위 밖이다.
- CHANGELOG.md 미출시 [계약] 행의 "poll은 던지는 execute도 lease 안에서
  다시 시도한다"는 이 커밋과 맞지 않는다. CHANGELOG는 오케스트레이터가
  고친다.

검증: desktop batch에서 확인.
- node scripts/run-vitest.ts run tests/unit/realtime/
- RED: "ends the lease with PROTOCOL_MISMATCH for an async execute that
  rejects"·"... throws before returning"가 옛 코드에서 execute 3회,
  POLL_BUDGET_EXHAUSTED로 실패한다. "keeps ABORTED ..."는 양쪽에서 통과한다
  (보존 조건).

BREAKING CHANGE: createBoundedPollCoordinator의 `execute`가 던지면(abort로
생긴 것 제외) 재시도 없이 PROTOCOL_MISMATCH(retryable: false)로 lease가
끝난다. 전에는 PROVIDER_UNAVAILABLE로 maxAttempts까지 재시도했다.
네트워크 실패를 throw로 내던 `execute`는 그것을 retryable
PROVIDER_UNAVAILABLE 결과로 바꿔 돌려준다.

Refs: 1105/04-02
2026-11-05 22:03:56 +09:00
DongHyeonka bde7fa4609 test(realtime): 조합 transport의 OFFLINE 재시도 규칙을 테스트로 다시 막는다
문제: 0929/04-01 규칙은 "환경이 online이면 transport가 낸 OFFLINE도
online 이벤트를 기다리지 않고 backoff로 재시도한다"이다
(reconnect-coordinator.ts의 RealtimeReconnectEnvironment 주석, 설계 5.3).
이 규칙을 막던 두 테스트는 SSE fetch·reader 거절이 OFFLINE이던 것을
이용했다. af00067(1103/04-04)이 SSE 거절을 PROVIDER_UNAVAILABLE로 바꾼 뒤
두 테스트는 그 kind의 재시도만 본다. 4d27b20이 지운 requireOnline() 두
줄을 되살리는 변이(MR1)에서 realtime 테스트가 모두 통과했다(리뷰 04-R4).

고른 방법: 조합 코드가 만든 transport로 그 경로를 직접 지나는 테스트
둘을 더한다. 환경은 계속 online이다.
- attempt가 OFFLINE/CONNECT/retryable로 실패한다 → 3회 시도, backoff
  [50, 100], OFFLINE retryable로 끝난다. 관측 순서도 고정한다.
- 세션이 열린 뒤 OFFLINE/RECEIVE/retryable로 닫힌다 → 3회 시도,
  OFFLINE retryable로 끝난다.
리뷰 대조 C1·C2와 같은 입력이고, `as never` 없이 파일의 도우미를 쓴다.
버린 대안: SSE 테스트 기대값을 OFFLINE으로 되돌리기. 템플릿 SSE는 이제
OFFLINE을 내지 않으므로 실제 동작과 다른 테스트가 된다.

위험·한계: 테스트만 더했다. 동작은 바뀌지 않는다. 그래서 RED(부모
코드)에서도 이 테스트는 통과한다. 결함을 보이는 방법은 변이 MR1이다.

검증: desktop batch에서 확인.
- GREEN: node scripts/run-vitest.ts run tests/unit/realtime/
- 변이 MR1(reconnect-coordinator.ts의 두 retry 분기 뒤 OFFLINE이면
  requireOnline()): 새 두 테스트가 attempts 1, result null로 실패해야 한다

Refs: 1105/04-01
2026-11-05 22:01:01 +09:00
DongHyeonka dae44f5cf4 test(http): interaction signal listener 정리도 고정한다
문제
실행기는 호출자·interaction·scope 세 signal에 abort listener를 달고
끝날 때 셋을 모두 지운다(src/adapters/http/http-execution-v3.ts:662-664).
listener 정리 테스트는 호출자와 scope signal만 감시해서, interaction
signal 쪽 제거 줄(:663)을 지운 변이 R2b가 107파일 995개를 모두
통과했다. 한 interaction 안에서 요청을 여러 번 보내면 요청마다
listener 하나(lifetime controller를 잡은 closure)가 interaction
마감까지 남는다.

고른 방법과 버린 대안
- 같은 테스트(tests/unit/http-execution-v3.test.ts)에
  createExecutionContext로 만든 interaction을 넘기고, 그
  cancellation.signal도 감시 목록에 넣는다.
- 끝나는 경우에 "interaction cancel"을 더한다. interaction 취소는
  호출자 abort와 같은 forwarder를 타지만 listener를 단 signal이 달라서
  따로 본다.
- 별도 테스트를 새로 만드는 안은 버렸다. 세 signal은 같은 정리 함수가
  지우므로 한 테스트에서 함께 보는 편이 규칙과 맞다.

위험·한계
- 테스트만 바꿨다. 실행기 코드는 그대로다. 실제 누수량은 재지 않는다.

검증
- desktop batch에서 확인:
  node scripts/run-vitest.ts run tests/unit/http-execution-v3.test.ts
- 변이 R2b(:663 제거)를 넣으면 세 경우 모두 "removes the listeners it
  added to the caller, interaction and scope signals after …"가
  실패해야 한다.

Refs: 1105/10-02
2026-11-05 21:58:39 +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
DongHyeonka c7b15f994d test(scaffold): 생성 KEYED 작성이 409 IDEMPOTENT_IN_FLIGHT를 결과 불명으로 남기는지 본다
문제
09-06의 완료 기준은 짝 백엔드 wire의 KEYED 생성, 400 필드 오류와 함께 409
IDEMPOTENT_IN_FLIGHT를 실행하는 기능 예제다. --with-create --keyed가 만드는
gateway 테스트는 503 IDEMPOTENCY_UNAVAILABLE 재전송만 보고 409 처리 중은 보지
않는다.

고른 방법
KEYED 생성 gateway 테스트에 409 IDEMPOTENT_IN_FLIGHT 사례를 더한다. 결과는
MAYBE_APPLIED이고 code가 그대로이며, 실행기는 스스로 다시 보내지 않는다(같은
키 재전송은 폼이 한다, http-contract.md §2). NEVER 생성은 키가 없어 이 답을
받지 않으므로 더하지 않는다.

위험·한계
- Retry-After 대기는 뮤테이션 조정자 쪽이라 이 gateway 테스트는 보지 않는다.

검증
- keyx-feature --with-create --keyed를 만들어 gateway 테스트 13건 통과, eslint
  통과. 생성 기능은 지웠다. tests/unit/create-feature.test.ts 43건 통과.

Refs: docs/reviews/2026-11-03-maturity-review/09-app-core.md 09-06
2026-11-04 23:47:24 +09:00