fix(checkers): 시험 증거 검사가 checkout에 없는 Playwright 설정을 이름으로 댄다 #69

Merged
donghyeon.kang merged 2 commits from donghyeon.kang/fix/test-evidence-missing-registered-config AGit into main 2026-11-19 20:35:34 +00:00
2 Commits
Author SHA1 Message Date
DongHyeonka 2caa6966ed docs(changelog): 게이트 실패 요약과 시험 증거 검사의 새 실패 문구를 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m26s
frontend-quality-gates / merge / tests (pull_request) Successful in 13m13s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m21s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: 미출시 절에 두 변경의 행이 없다. 둘 다 파생 프로젝트가 자기
CI 출력에서 보는 것을 바꾼다.
- 829733cf(#67): `ci:gate`가 실패하면 job 로그의 끝 줄 앞에 실패한
  명령의 첫 실패 블록이 붙는다.
- 439d3271: 시험 증거 전체 검사(FE-GATE-008)가 checkout에 없는
  Playwright 설정을 ENOENT 스택 대신 파일과 등록부 항목으로 댄다.
  매뉴얼 03 E절에 루트 항목을 지울 때 할 일이 더해진다.
`docs/work/improve.md` 4.2절 8단계는 다운스트림에 보이는 변경을
미출시 절에 적게 한다.

고른 방법: 첫 미출시 절 「그 밖의 변경」 표 끝에 행 둘을 더한다.
표시는 없다. 백엔드·배포 설정·기능 코드가 함께 바뀌지 않고 게이트
판정도 같다. #67 행을 따로 커밋하지 않은 것은 같은 기준으로 같은 절에
더하는 문서 변경이라서다.

위험·한계: 없다(문서만, 해시 대조로 행의 커밋을 확인).

검증: `git merge-base --is-ancestor 829733cf HEAD`,
`git merge-base --is-ancestor 439d3271 HEAD` 통과. desktop
`scripts/verify.sh script verify:documentation`과 FE-GATE-005의
`tests/unit/changelog-review-ids.test.ts`는 이 커밋 위에서 돈다.

Refs: fe-ci-next (3), #67
2026-11-20 02:27:56 +09:00
DongHyeonka 439d327120 fix(checkers): 시험 증거 검사가 checkout에 없는 Playwright 설정을 이름으로 댄다
문제: 시험 증거 전체 검사(`scripts/check-test-evidence.ts`, FE-GATE-008)는
등록부(`config/repository-layout.json`)의 `playwright-configs` 집합,
또는 `--playwright-config`로 받은 설정을 읽어 `forbidOnly: true`를 본다.
그 파일이 checkout에 없으면 `readFile`의 ENOENT로 죽는다. 보고서도
쓰기 전이라 게이트 로그에는 스택만 남는다. 파생 프로젝트가 capability를
지우며 `playwright.capabilities.config.ts`를 지우고 등록부 항목을 남기면
이렇게 된다(#55 이전부터, #66이 fixture 실행만 고침).

고른 방법: (가)+(다).
- (가) 설정을 못 읽으면 ENOENT일 때만 실패 줄을 하나 더하고 다음
  설정으로 간다. 등록부에서 온 설정은 「등록부가 playwright-configs에
  적었지만 이 checkout에 그 파일이 없다, 되살리거나 항목을 지운다」,
  인자로 온 설정은 「--playwright-config가 적었지만 없다」. 릴리스 증거
  토큰을 읽는 `playwright.config.ts`가 없으면 토큰 검사를 건너뛰고, 등록부
  줄이 없을 때(설정을 인자로 받은 경우)만 따로 이름으로 댄다. 검사는 그대로
  실패하고(조용한 통과 없음) 보고서에 그 줄이 남는다. ENOENT가 아닌
  오류(설정 자리에 폴더가 있는 EISDIR 등)는 지금처럼 던진다. 이 검사가
  설명할 수 있는 오류가 아니라서다. 같은 파일의 source contract·visual 증거도
  없는 파일을 이름으로 대는 실패 줄로 낸다.
- (다) `docs/manual/03-outside-feature-folder.md`의 루트 항목 순서에
  「지울 때는 등록부 항목과 secret-scan `trackedRoots`도 지운다」를 더한다.
버린 것:
- (나) 그 항목을 `optional`로 두기: 등록부가 이 설정을 「없어도 되는
  것」으로 바꾸어 템플릿에서 설정이 사라져도 forbidOnly 검사가 조용히
  넘어간다. `fixture-copy`·`secret-scan` 집합에도 같이 걸린다.

위험·한계: 실패 문구만 바뀐다(종료 코드·게이트 판정 그대로). 같은
원인의 다른 자리: 제거 드릴의 사본 만들기(`scripts/lib/removal-fixture.ts`
`prepareRemovalFixture`)는 등록부 `fixture-copy` 경로를 `cp`로 복사해,
없는 항목에서 원문 ENOENT로 죽는다(`optional`인 `recipes`도 같다). 이
변경은 그것을 고치지 않는다(범위 밖, PR 본문에 적음). 문서대로 항목을
지우면 둘 다 일어나지 않는다.

검증(desktop `scripts/verify.sh`, 깨끗한 worktree):
- RED: 기준 972139e6 + 새 시험, `node scripts/run-vitest.ts run
  tests/unit/test-evidence-repository-configs.test.ts` → 새 시험 둘이
  stderr의 `ENOENT: … open 'playwright.capabilities.config.ts'`(등록부
  설정)·`… 'absent.config.ts'`(인자 설정) 스택으로 실패, 기존 시험 통과.
- 리뷰 반영(등록부 설정 넷을 하나씩 빼는 경우, 인자 설정과 e2e 설정이
  둘 다 없는 경우): 반영 전 트리에서 `playwright.config.ts` 경우와
  인자+e2e 경우만 실패.
- ENOENT 밖 오류 두 경우(설정 자리가 폴더): 설정 검사의 throw를 지운
  변이에서 「config check」 경우만, 토큰 읽기의 throw를 지운 변이에서
  「token read」 경우만 실패.
- GREEN: 같은 파일 + `tests/unit/test-evidence-source-rules.test.ts`
  3회 연속 14 통과(작은 checkout 시험 168~233ms, load 24).
  `lint`·`check:types` rc=0. merge 단계와 main 단계 게이트는 PR 본문에
  적는다.

Refs: fe-ci-next (3)
2026-11-20 02:27:56 +09:00