docs(review): 리뷰가 놓친 merge 게이트 결함 2건을 더한다
문제
리뷰 README 10.1절의 게이트 목록은 merge stage 전체가 아니었다.
coverage 증거 검사, storybook, a11y, browser-capabilities, CI env 값의
e2e가 빠졌다. 리뷰를 맡긴 세션이 병합의 한쪽 부모 8c39e77에서
`ci:gate FE-GATE-NNN` 14개를 돌려, 실제 러너에서 항상 실패하는 merge
게이트 두 개를 찾았다.
고른 방법
- 11-06: tests/e2e/compact-smoke.spec.ts:18이 build id를 "local-build"로
고정하고, workflow는 VITE_BUILD_ID를 gitea-<run>-<attempt>로 준다.
FE-GATE-008이 CI에서 항상 실패한다.
- 12-09: scripts/lib/ci-artifact-validator.ts:79-91의 .strict() schema가
istanbul-lib-coverage 3.2.2 summary의 branchesTrue를 거절한다.
FE-GATE-005가 테스트가 모두 통과해도 실패한다.
- 두 결함의 코드를 e40684b에서 다시 읽고, README 13절에 36.3 양식으로
적었다. 사용 결정, P1 표, 개선 순서 2, 관점 21, 색인(90건), 미검증,
오케스트레이터 실수(10.5)에 반영했다. 등급은 02-06과 같은 기준으로
Medium·P1이다.
- 셋째 결함(FE-GATE-020)은 02-06과 같아 따로 세지 않았다.
worktree 안 checkout·inotify 부족은 환경 조건이라 결함으로 세지
않았다.
위험·한계
- e40684b에서 ci:gate를 실행하지 않았다. 재현은 8c39e77 깨끗한
복제본에서 다른 세션이 했다. CI=true와 러너 이미지 조건은 아무도
재현하지 않았다.
- 코드는 고치지 않았다.
검증
- verify:documentation PASS_SCOPED.
- documentation-readiness·changelog-review-ids 테스트 15건 통과.
Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절
This commit is contained in:
@@ -10,7 +10,7 @@
|
||||
|---|---|---|
|
||||
| 짝 백엔드에 붙는 쓰기 폼(생성 기능의 POST 포함) | **사용 보류** | 03-01: 업무 규칙 거절이 모두 "결과 불명"이 되어 고친 값을 다시 저장할 수 없다. 0929/03-03: 키 없는 쓰기의 결과 불명 화면이 같은 요청을 무방비로 다시 보낸다 |
|
||||
| 짝 백엔드와 함께 파일 업로드 출시 | **사용 보류** | 01-01: 프론트 업로드 프로토콜(`PRESIGNED_MULTIPART_V1`)이 짝 백엔드에 없다. 짝 백엔드 Fileserver를 부를 프론트 client도 없다 |
|
||||
| `create:feature`로 기능을 더하고 템플릿 CI로 머지 | **사용 보류** | 12-01: 기능 하나만 더해도 `test:visual`이 실패한다. 02-06: FE-GATE-020의 제거 드릴 3개가 기능과 무관하게 항상 실패한다. 11-01: 생성 기능 라우트를 접근성 e2e가 오류 화면으로 검사하고 통과시킨다. 16-02: 제품 기능의 제거 드릴이 시작하자마자 끝난다 |
|
||||
| `create:feature`로 기능을 더하고 템플릿 CI로 머지 | **사용 보류** | 12-01: 기능 하나만 더해도 `test:visual`이 실패한다. 02-06: FE-GATE-020의 제거 드릴 3개가 기능과 무관하게 항상 실패한다. 11-01: 생성 기능 라우트를 접근성 e2e가 오류 화면으로 검사하고 통과시킨다. 16-02: 제품 기능의 제거 드릴이 시작하자마자 끝난다. 11-06·12-09: 실제 러너 env에서는 FE-GATE-008·FE-GATE-005가 코드와 무관하게 항상 실패한다(13절) |
|
||||
| 이 미출시 묶음을 다운스트림(tech-log·memento)에 전파 | **사용 보류** | 14-01: CHANGELOG 미출시 절이 기준 커밋과 맞지 않는다. 14-02: BREAKING 이행 안내가 두 다운스트림의 실제 모양과 다르다 |
|
||||
| 템플릿 그대로 release 단계(`RELEASE_READY`)까지 가기 | **사용 보류** | 15-01: lab 게이트 FE-GATE-026이 1101/15-01 수정(`298201f`) 뒤로 계속 실패한다. 측정 화면이 모든 기능의 실행부를 받은 뒤 그린다 |
|
||||
| 배포 슬롯을 채워 desktop 서버로 자동 배포 | 사용 보류 | 13-01: FE-GATE-019가 같은 run에서 다시 빌드한 release를 통과시킨다. 13-03: lockfile이 템플릿 자신의 취약점 정책을 어기는데 merge·release에서 알 수 없다 |
|
||||
@@ -48,6 +48,8 @@
|
||||
| [14-01](14-template-product-docs.md) (+ [04-05](04-adapters-realtime.md)) | Medium | CHANGELOG 미출시 절이 기준 커밋과 맞지 않는다. 한 브랜치의 16커밋이 빠졌다. "알려진 제한" 13줄 중 9줄은 이미 사실이 아니다. handoff 결과 kind 변경(`17fa8d1`)의 [계약] 행도 없다 | 에이전트 `git log` 대조 |
|
||||
| [14-02](14-template-product-docs.md) | Medium | BREAKING 이행 안내가 두 다운스트림의 실제 모양과 다르다. memento-web의 V2 행은 0개다. 실제 작업은 스키마 행 약 42개와 zod 전용 칸이다. tech-log의 직접 조립 경로에는 안내가 없다. **"memento-web이 V2 행을 쓴다"는 문장은 오케스트레이터가 썼다(10.5절)** | 에이전트가 `memento-frontend` `d3810a0` 실제 파일을 대조 |
|
||||
| [15-01](15-performance.md) | Medium (조정, 2.3절) | lab 게이트 FE-GATE-026(release 단계)이 1101/15-01 수정(`298201f`) 뒤로 계속 실패한다. 측정 대상인 플랫폼 구성 화면의 route module이 그리기 전에 모든 기능의 실행부를 기다린다. 그래서 클릭 뒤 요청 묶음이 하나 더 생긴다. `298201f` 본문이 이 위험을 적었지만 재지 않았다. 147커밋 동안 아무 게이트도 알리지 않았다 | **오케스트레이터 확인 + 실행.** `loadPlatformOverviewPage`가 `await loadInstalledFeatureRuntimeRegistries()`를 한다(`src/presentation/examples/platform-overview-page.tsx:596-606`). 그 함수는 모든 기능 실행부를 dynamic import한다(`src/features/installed-feature-runtime-registries.ts:17-31`). `e40684b`에서 `corepack pnpm test:performance -- --runs=5`(부하 15): **FAIL**, 상호작용 중앙값 227 ms(표본 223·224·227·438·526) > 예산 200 ms. LCP 2,000 ms, CLS 0. `d99301b` 대조 A/B는 15 영역이 했다(117~118 ms PASS). 오케스트레이터는 다시 하지 않았다 |
|
||||
| [11-06](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium | compact smoke e2e가 `data-build-id`를 `"local-build"`로 고정했다. workflow는 `VITE_BUILD_ID: gitea-<run>-<attempt>`를 넣으므로 실제 CI에서 FE-GATE-008이 항상 실패한다 | 다른 세션이 `8c39e77` 깨끗한 복제본에서 `ci:gate FE-GATE-008` 재현. 오케스트레이터가 `e40684b`에서 두 줄을 다시 읽음(`tests/e2e/compact-smoke.spec.ts:18`, `.gitea/workflows/quality-gates.yml:28`) |
|
||||
| [12-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium | coverage 증거 검사의 `.strict()` schema가 istanbul summary의 `branchesTrue`를 거절한다. 테스트가 모두 통과해도 FE-GATE-005가 실패한다 | 다른 세션이 `8c39e77`에서 `ci:gate FE-GATE-005` 재현(unit 2,615·coverage 3,560 통과, 증거 검사 실패). 오케스트레이터가 `e40684b`에서 schema(`scripts/lib/ci-artifact-validator.ts:79-91`)와 istanbul-lib-coverage 3.2.2의 빈 summary(`lib/coverage-summary.js:23`)를 확인 |
|
||||
|
||||
### 2.3 심각도 조정
|
||||
|
||||
@@ -113,6 +115,7 @@
|
||||
| 짝 백엔드를 실제로 띄운 연동 | 백엔드는 읽기만 했다. 03-01·01-01의 백엔드 쪽은 생성기 템플릿과 문서로 확인했다 | 백엔드 생성 기능 + 프론트 생성 기능을 띄워 쓰기·업로드 한 번 |
|
||||
| 리뷰 중 바뀐 백엔드(`bbe944bd`) | 영역 에이전트는 `7ef8d0b4`를 읽었다. 오케스트레이터는 바뀐 파일 목록과 새 code 하나(`IDEMPOTENCY_COMPLETION_UNKNOWN`)만 대조했다 | 다음 라운드에서 짝 계약 대조 |
|
||||
| 다운스트림(tech-log·memento)이 03-01·0929/03-03·업로드 경로를 쓰는지 | 두 제품 코드는 14-02에 필요한 부분만 읽었다 | 두 제품의 descriptor `retrySemantics`·`responseEnvelope`와 재전송 버튼 grep |
|
||||
| merge 단계 게이트 전체(`ci:gate FE-GATE-NNN`)를 `e40684b`에서 | 오케스트레이터 게이트 목록이 merge stage 전체가 아니었다(10.5절). 다른 세션이 한쪽 부모 `8c39e77`에서 14개를 돌렸다(13절). `CI=true`와 러너 이미지 조건은 아무도 재현하지 않았다 | 깨끗한 복제본에서 `e40684b`로 `ci:gate` 14개, CI env 값으로 |
|
||||
| `test:system` 전체 | 이번 오케스트레이터 게이트 목록에 없다. 11 영역이 worktree 조건의 실패(11-04)와 시간 초과(11-03)를 보고했다 | 일반 checkout에서 한 번 |
|
||||
| lab 측정의 낮은 부하·CI 러너 결과 | 측정 내내 부하가 8~40이었다. 15 영역은 같은 부하에서 `d99301b`와 번갈아 재서 부하 탓이 아님을 보였다. 부하 5 미만과 러너에서는 재지 않았다. 늘어난 약 110 ms를 왕복·다운로드·조립·렌더로 나누지 않았다 | 조용한 호스트에서 `d99301b`/`e40684b` A/B 2회 |
|
||||
| 기능 N개일 때 플랫폼 구성 화면 진입 시간 | 15-01은 기능 1개(참조 기능)로만 쟀다 | 생성 기능 4·8개 상태에서 lab |
|
||||
@@ -123,7 +126,7 @@
|
||||
|---|---|---|---|---|
|
||||
| 1 | 0929/03-03 | 키가 없는 intent면 `resendUnknownEffect`가 `null`을 돌려준다. 훅이 재전송 가능 여부를 내고, 화면은 그때만 버튼을 그린다 | 수십 줄 | `NEVER` 쓰기의 결과 불명 화면에 재전송 버튼이 없다. KEYED는 그대로 같은 키로 재전송한다 |
|
||||
| 1 | 03-01 (= 08-01) | D2 ①: `commandEffect`에 `refusedBeforeWrite` code 목록을 둔다. 매뉴얼 02 4절과 생성기 쓰기 예시에 `<FEATURE>_INVALID`를 적는다 | 공개 타입 칸 1개, 조립 검사, 판정 한 줄, 문서 | X-B에서 선언한 code는 결과 불명이 아니고 저장 버튼이 켜진다. 처리 중 409를 목록에 넣으면 조립이 실패한다 |
|
||||
| 2 | 02-06 | 제외 목록을 `scripts/lib/removal-fixture.ts`의 상수 하나로 올리고 네 드릴이 같이 쓴다 | 몇 줄 | 세 드릴 exit 0 |
|
||||
| 2 | 02-06, 11-06, 12-09 | 02-06: 제외 목록을 `scripts/lib/removal-fixture.ts`의 상수 하나로 올리고 네 드릴이 같이 쓴다. 11-06: spec이 기대 build id를 env에서 읽는다. 12-09: schema가 `branchesTrue`를 받는다 | 각 몇 줄 | 세 드릴 exit 0. `VITE_BUILD_ID=gitea-1-1`로 `ci:gate FE-GATE-008`·`FE-GATE-005` 통과 |
|
||||
| 2 | 15-01 | 플랫폼 구성 화면이 제목과 선언 정보는 바로 그리고, 실행부 레지스트리 부분만 Suspense 뒤에서 채운다. release 전 수동 확인 목록에 `test:performance`를 넣는다 | 화면 한 파일 | 같은 호스트에서 `d99301b`가 통과하는 조건으로 A/B 2회 이상 PASS |
|
||||
| 2 | 12-01, 11-01, 16-02 | D3 (a) mask. D4 결정. 제품 기능 제거 드릴의 시작 오류 | spec 수십 줄, 골든 3장 1회 | 기능 1·4개 상태에서 `test:visual`·`test:a11y`가 골든 변경 없이 통과한다 |
|
||||
| 3 | 14-01, 14-02 | 미출시 절을 기준 커밋과 맞추고, 두 다운스트림의 실제 이행 작업을 적는다 | 문서 | 다운스트림 동기화 전에 끝낸다 |
|
||||
@@ -178,6 +181,7 @@
|
||||
| `test:sample-removal` | 통과 — 23 checks(FE-GATE-020의 나머지 드릴) | — |
|
||||
| `test:feature-scaffold` | 통과 — 16 checks | — |
|
||||
| `test:performance` (FE-GATE-026, release 단계) | **실패** — 상호작용 중앙값 227 ms > 200 ms(15-01). LCP 2,000 ms, CLS 0. 부하 15 | — |
|
||||
| FE-GATE-005·FE-GATE-008 (`ci:gate`) | `e40684b`에서는 돌리지 않았다. 다른 세션이 `8c39e77`에서 실패를 재현했다(12-09, 11-06). 나머지 merge 게이트 001~004·006·007·009~012는 `8c39e77`에서 통과했다 | — |
|
||||
|
||||
### 10.2 영역 분할 (지난 리뷰 9.2절 재사용)
|
||||
|
||||
@@ -229,6 +233,7 @@
|
||||
| 14-02 | CHANGELOG·커밋 `12f3bb7`에 "memento-web이 V2 API 행을 쓴다"고 적었다. memento-web의 `apiOperations`는 `{}`다 | 다운스트림 파일을 열지 않고 이름으로 추정했다 |
|
||||
| 04-01 | `BoundedPollOperationContract`를 "V2 HTTP 경로가 아니다"로 판정해 남겼다 | 선언이 실제 요청을 통제하는지 실행으로 보지 않았다 |
|
||||
| 07-01, 10-04, 03-06(`traceId`) | V2 삭제 때 "V2에만 있던 동작"을 셋만 찾았다. 행·parity 테스트가 하던 검사, 지운 테스트가 지키던 V3 동작, Envelope `traceId` 채우기를 놓쳤다 | 지운 코드의 "실행 동작"만 찾았다. 지운 검사·테스트가 무엇을 지키고 있었는지는 보지 않았다 |
|
||||
| 11-06, 12-09 | 10.1절 게이트 목록을 지난 라운드 목록에서 가져왔다. merge stage 전체가 아니었다. coverage 증거 검사, storybook, a11y, browser-capabilities, CI env 값의 e2e가 빠졌다. 그래서 merge 게이트 두 개가 실제 러너에서 항상 실패하는 것을 놓쳤다 | 리뷰 절차(CLAUDE.md 2단계)의 명령 목록만 돌리고, `config/ci/gates.json`의 merge stage `gateIds`와 대조하지 않았다 |
|
||||
|
||||
### 10.6 리뷰 중 바뀐 짝 백엔드
|
||||
|
||||
@@ -264,7 +269,7 @@
|
||||
| 18 | 배포 성숙도 | `OP>PPP>O>>P>P>P>` | P | 13-01 같은 run 재빌드 통과, 13-02 HTTP/2·압축 전제 |
|
||||
| 19 | 설정 성숙도 | `PPPPPPPPPPPPPPOP` | P | 13-04 FE-REG-ENV 행 불일치, 07-04 금지 이름 검사가 부팅 때만 |
|
||||
| 20 | 개발자 경험 | `X>PP>PPPPPPPPPPP` | **X** | 01 영역: 짝 백엔드로 파일 업로드를 붙이는 경로가 어느 문서에도 없다(01-01) |
|
||||
| 21 | Guardrail 성숙도 | `PPPPPPPPPPPPPPPP` | **X** | **오케스트레이터 판정.** 영역은 모두 P다. 그러나 merge 게이트 FE-GATE-020의 드릴 4개 중 3개가 항상 실패하는 것을 직접 재현했다(02-06). 지난 라운드에 같은 모양(1101/11-01 `test:system` 항상 실패)으로 X를 줬다. 12-01·11-01·15-01도 템플릿 그대로 또는 기능 하나로 게이트가 틀린 답을 낸다 |
|
||||
| 21 | Guardrail 성숙도 | `PPPPPPPPPPPPPPPP` | **X** | **오케스트레이터 판정.** 영역은 모두 P다. 그러나 merge 게이트 FE-GATE-020의 드릴 4개 중 3개가 항상 실패하는 것을 직접 재현했다(02-06). 지난 라운드에 같은 모양(1101/11-01 `test:system` 항상 실패)으로 X를 줬다. 12-01·11-01·15-01도 템플릿 그대로 또는 기능 하나로 게이트가 틀린 답을 낸다. 실제 러너 env에서는 FE-GATE-005·008도 항상 실패한다(11-06, 12-09) |
|
||||
| 22 | 추상화 성숙도 | `OPPPPOPPPPPP>>>P` | P | 04-01 polling 선언이 실행기를 통제하지 못함, 08 5.3 폼·코디네이터 상태 분리 |
|
||||
| 23 | 일관성 | `PPPPPPPPPPPPPPPP` | P | 01-02 같은 429에 단계마다 다른 `retryable`, 04-04 서버 끊김 실패 이름 |
|
||||
| 24 | 네이밍 / 의미 성숙도 | `PPPPPPPPPPPPPPPP` | P | 0929/03-03 "같은 요청으로 다시 보내기"가 키 없는 명령에도 동작, 09-09 `NOT_INSTALLED` 다의 |
|
||||
@@ -275,7 +280,7 @@
|
||||
|
||||
## 12. 발견 색인
|
||||
|
||||
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳐(10.3절) 색인은 88건이다: High 2 · Medium 34 · Low 52, P1 12 · P2 38 · P3 38, 확인된 결함 55 · 구조적 위험 23 · 개선 제안 10. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
|
||||
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 2건(11-06, 12-09, 13절)을 더해 색인은 90건이다: High 2 · Medium 36 · Low 52, P1 14 · P2 38 · P3 38, 확인된 결함 57 · 구조적 위험 23 · 개선 제안 10. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
|
||||
|
||||
| ID | 심각도·우선순위 | 성격 | 내용 | 관련 관점 | 합친 것·조정 |
|
||||
|---|---|---|---|---|---|
|
||||
@@ -285,7 +290,9 @@
|
||||
| [09-02](09-app-core.md) | Medium·P1 | 확인된 결함 | 제품 확장 지점의 타입 검사 경로가 막힌다: 문서 위치의 capability 보강은 node 검사에서 안 보이고, 기본값 있는 제품 설정 키는 템플릿 테스트 7개 파일의 타입을 깬다 | 3, 21, 25, 4, 8, 10, 19, 20 | |
|
||||
| [09-03](09-app-core.md) | Medium·P1 | 구조적 위험 | 짝 백엔드의 인증 방식에 맞는 세션 owner가 없어, 제품마다 첫 연동 전에 owner를 처음부터 써야 한다 | 3, 15, 20, 22, 25, 13 | |
|
||||
| [11-02](11-tests-browser-release-scale.md) | Medium·P1 | 확인된 결함 | CI merge job이 시각 테스트 글꼴 패키지를 설치하지 않아, 빈 러너에서는 FE-GATE-008이 코드와 무관하게 `visual-fonts` 단계에서 실패한다 (1101/11-02 남은 절반) | 21, 10, 19, 20, 16, 5 | |
|
||||
| [11-06](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | compact smoke e2e가 build id를 고정해 실제 CI 값에서 FE-GATE-008이 항상 실패한다 | 21, 10, 18, 19 | 13절(리뷰 뒤 추가) |
|
||||
| [12-01](12-guardrails-ci.md) | Medium·P1 | 확인된 결함 | `create:feature`로 기능 하나를 더하면 merge 게이트 `test:visual`이 실패하고, 통과시키려면 템플릿 소유 골든 PNG 3장을 다시 찍어야 한다 | 10, 25, 3, 21, 20, 26 | 조정 High·P1 → Medium·P1 |
|
||||
| [12-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | coverage 증거 검사가 istanbul summary의 `branchesTrue`를 거절해 FE-GATE-005가 항상 실패한다 | 21, 10, 16, 23 | 13절(리뷰 뒤 추가) |
|
||||
| [13-01](13-build-release-supply-chain.md) | Medium·P1 | 확인된 결함 | FE-GATE-019가 run 이름만 대조하고 `config.json` 내용과 슬롯의 후보 사용을 보지 않아, 같은 run에서 다시 빌드한 release를 통과시킨다 | 18, 21, 15, 19, 5, 28 | |
|
||||
| [13-03](13-build-release-supply-chain.md) | Medium·P1 | 확인된 결함 | 의존성 취약점 판정이 운영 승격 provider에만 있고, 지금 lockfile이 템플릿 자신의 정책을 어기는데 merge·release에서 알 수 없다 | 16, 15, 26, 21, 5 | |
|
||||
| [14-01](14-template-product-docs.md) | Medium·P1 | 확인된 결함 | CHANGELOG 미출시 절이 리뷰 기준 커밋과 맞지 않는다 | 30.4, 9, 17, 26, 5, 24 | 04-05 |
|
||||
@@ -367,3 +374,43 @@
|
||||
| [15-07](15-performance.md) | Low·P3 | 개선 제안 | react-router 개발 빌드가 운영 번들에 들어간다 | 16, 14 | |
|
||||
| [16-06](16-structure-patterns.md) | Low·P3 | 개선 제안 | 기능 작성자가 반드시 채우는 칸 중 화면·실행이 읽지 않는 칸이 있다 | 4, 22, 23, 24, 9 | |
|
||||
| [16-08](16-structure-patterns.md) | Low·P3 | 확인된 결함 | 기능 추가 경로 문서의 낡은 문장 (09-10·14-05에 없는 것) | 9, 20, 24, 10 | |
|
||||
|
||||
## 13. 리뷰 뒤 추가 발견 (2026-11-04)
|
||||
|
||||
이 리뷰를 맡긴 세션이 merge 단계 게이트 14개를 `ci:gate FE-GATE-NNN`으로 돌렸다. 대상은 병합의 한쪽 부모 `8c39e77`의 깨끗한 복제본이다. 그 결과 이 리뷰가 놓친 결함 2건이 나왔다. 셋째 결함(FE-GATE-020)은 02-06과 같다. 오케스트레이터는 두 결함의 코드를 `e40684b`에서 다시 읽었다. `e40684b`에서 게이트를 실행하지는 않았다. 영역 문서가 없으므로 36.3 양식을 여기에 적는다.
|
||||
|
||||
같은 세션이 보고한 환경 조건 두 가지는 결함으로 세지 않았다. 하나는 checkout 안의 `.claude/worktrees/`(23개)다. 이 폴더가 있으면 `ci-artifact-contract.test.ts`가 worktree의 node_modules까지 복사해 21건이 실패한다(11-04와 같은 원인). 다른 하나는 이 기계의 inotify 감시가 부족한 것이다. vite가 들어가는 게이트는 `CHOKIDAR_USEPOLLING=1`이 필요하다(02 영역 6.3절의 `ENOSPC`).
|
||||
|
||||
### 11-06 compact smoke e2e가 build id를 `"local-build"`로 고정해, 실제 CI 값에서는 FE-GATE-008이 항상 실패한다
|
||||
|
||||
| 필드 | 내용 |
|
||||
|---|---|
|
||||
| 성격 | 확인된 결함 |
|
||||
| 관련 관점 | 21, 10, 18, 19 |
|
||||
| 근거 | `tests/e2e/compact-smoke.spec.ts:18`이 `html`의 `data-build-id`를 `"local-build"`와 비교한다. `.gitea/workflows/quality-gates.yml:28`은 workflow 전체 env에 `VITE_BUILD_ID: "gitea-${{ gitea.run_id }}-${{ gitea.run_attempt }}"`를 넣는다. 다른 세션의 실행(`8c39e77` 깨끗한 복제본): CI와 같은 `VITE_BUILD_ID`를 주면 이 spec이 실패한다. 기본값으로 두면 FE-GATE-008의 7단계가 모두 통과한다(e2e 187, capabilities 63, storybook, visual 6). 이 세션은 `e40684b`에서 두 줄을 다시 읽었다. 다른 세션에 따르면 `98d4fd49`(2026-07-26)부터 있던 줄이다 |
|
||||
| 발생 조건 | Gitea Actions, 또는 같은 env를 주는 러너에서 merge job을 돌릴 때마다 |
|
||||
| 영향 | merge 게이트 FE-GATE-008이 코드와 무관하게 빨갛다. 11-02(글꼴 패키지 미설치)와 겹쳐 이 게이트는 실제 러너에서 두 이유로 실패한다. CI가 꺼져 있어(1101 U-1) 지금까지 드러나지 않았다 |
|
||||
| 심각도·우선순위 | Medium · P1 — 02-06과 같은 기준이다(2.3절). 사용자 피해는 없고, merge 게이트를 믿을 수 없게 만든다 |
|
||||
| 통제·증거 | 목표 M3 / 확인 M0(러너 env로 이 spec을 돌린 적 없음) · E3(다른 세션 재현, `8c39e77`) + E1(`e40684b` 코드) |
|
||||
| 확실성과 남은 가정 | `CI=true`와 러너 이미지 조건은 재현하지 않았다. `e40684b`에서 실행하지 않았다 |
|
||||
| 최소 개선 방향 | spec이 기대값을 빌드에 준 `VITE_BUILD_ID`에서 읽고, 없을 때만 `"local-build"`를 쓴다. 또는 build id가 비어 있지 않은지만 본다 |
|
||||
| 완료 기준 | `VITE_BUILD_ID=gitea-1-1`로 `ci:gate FE-GATE-008`이 통과한다. 기본값으로도 통과한다 |
|
||||
| 검증 방법 | 깨끗한 복제본에서 두 env 값으로 `ci:gate FE-GATE-008` |
|
||||
| 담당·기한·상태 | 미정 · 미정 · 신규 |
|
||||
|
||||
### 12-09 coverage 증거 검사가 istanbul summary의 `branchesTrue`를 거절해, 테스트가 모두 통과해도 FE-GATE-005가 실패한다
|
||||
|
||||
| 필드 | 내용 |
|
||||
|---|---|
|
||||
| 성격 | 확인된 결함 |
|
||||
| 관련 관점 | 21, 10, 16, 23 |
|
||||
| 근거 | `scripts/lib/ci-artifact-validator.ts:79-91`의 `coverageSummarySchema`는 항목마다 `lines`·`statements`·`functions`·`branches`만 허용하는 `.strict()` 객체다. istanbul-lib-coverage 3.2.2의 빈 summary는 `branchesTrue`를 항상 넣는다(`node_modules/.pnpm/istanbul-lib-coverage@3.2.2/node_modules/istanbul-lib-coverage/lib/coverage-summary.js:23`). 같은 산출물을 읽는 `scripts/lib/risk-coverage.ts:647`은 이 키를 허용한다. 다른 세션의 실행(`8c39e77`): unit 2,615건과 coverage 3,560건은 통과했다. 실패는 증거 검사 단계에서 났다. total에 `branchesTrue`가 있어서다. 다른 세션에 따르면 schema와 의존성은 `67cd3765`·`98d4fd49`(8월)부터 그대로다 |
|
||||
| 발생 조건 | `ci:gate FE-GATE-005`를 돌릴 때마다. 로컬과 러너 모두 |
|
||||
| 영향 | merge 게이트 FE-GATE-005가 항상 실패한다. 두 검사기가 같은 산출물을 서로 다르게 읽는다(5절 원인 4와 같은 모양) |
|
||||
| 심각도·우선순위 | Medium · P1 — 02-06과 같은 기준이다(2.3절) |
|
||||
| 통제·증거 | 목표 M3 / 확인 M0 · E3(다른 세션 재현, `8c39e77`) + E1(`e40684b` schema·의존성 코드) |
|
||||
| 확실성과 남은 가정 | `e40684b`에서 실행하지 않았다. main에서도 같을 것으로 본다(다른 세션의 추론, 실행 안 함) |
|
||||
| 최소 개선 방향 | schema에 `branchesTrue`를 선택 칸으로 더한다. 허용 키 목록을 risk-coverage와 한 상수로 쓴다 |
|
||||
| 완료 기준 | `ci:gate FE-GATE-005`가 통과한다. `branchesTrue`가 있는 summary와 없는 summary를 모두 받는 validator 테스트가 있다 |
|
||||
| 검증 방법 | validator 단위 테스트 + 깨끗한 복제본에서 `ci:gate FE-GATE-005` |
|
||||
| 담당·기한·상태 | 미정 · 미정 · 신규 |
|
||||
|
||||
Reference in New Issue
Block a user