fix(scripts): verify.sh parts가 음성 fixture의 진단 문구까지 본다 #33

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/verify-parts-diagnostics AGit into main
Owner

무엇을, 왜

scripts/verify.sh parts <ID>가 음성 fixture(expect: fail)를 종료 코드만으로 판정한다. ci:gate는 정해진 종료 코드와 정해진 진단 문구(expectedDiagnosticId)가 둘 다 있어야 통과시킨다. 그래서 검사기가 깨져 엉뚱한 원인으로 exit 1을 내도 parts는 통과로 센다(round9 발견 1112/08-01 GD-01의 남은 절반. args 절반은 #19가 고쳤다).

고른 방법과 버린 대안

  • 계약에서 expectedDiagnosticId를 함께 읽고, 음성 fixture 명령의 출력을 따로 잡아 문구가 있는지 본다. 판정 규칙은 scripts/lib/ci-step-result.ts의 classifyGateStepResult와 같다.
  • 버린 대안: parts가 ci:gate를 명령마다 부르기. ci:gate는 게이트 단위라 명령 하나를 고를 수 없고, parts의 목적(첫 실패 뒤 명령도 끝까지)과 맞지 않는다.

위험과 영향

  • 문구가 빈 음성 fixture는 예전처럼 종료 코드만 본다(ci:gate도 빈 문구는 늘 맞는다).
  • merge 게이트 동작은 바뀌지 않는다. 바뀌는 것은 desktop 진입점 scripts/verify.sh parts뿐이다.

검증

  • scripts/tests/test_verify.py에 가짜 corepack 시험: 음성 fixture가 맞는 종료 코드에 엉뚱한 문구를 내면 parts FE-GATE-029가 rc=1, 등록된 문구를 내면 rc=0. 고치기 전에는 엉뚱한 문구에도 rc=0으로 시험이 실패했다(RED). 고친 뒤 python3 -m unittest scripts.tests.test_verify 9개 통과.
  • desktop 실제 검사기: scripts/verify.sh parts FE-GATE-029 rc=0(음성 fixture 9개가 등록된 문구를 냄). 로그 /tmp/claude-gates/w2fe2-gd01/.
  • scripts/verify.sh docs OK.

리뷰어가 볼 곳

  • scripts/verify.sh의 step(출력 잡기)과 run_parts(판정).

관련

  • round9 리뷰 docs/reviews/2026-11-round9-08-guardrails-docs.md GD-01(PR #23), 이 repo 1112/08-01.
## 무엇을, 왜 `scripts/verify.sh parts <ID>`가 음성 fixture(`expect: fail`)를 종료 코드만으로 판정한다. `ci:gate`는 정해진 종료 코드와 정해진 진단 문구(`expectedDiagnosticId`)가 둘 다 있어야 통과시킨다. 그래서 검사기가 깨져 엉뚱한 원인으로 exit 1을 내도 parts는 통과로 센다(round9 발견 1112/08-01 GD-01의 남은 절반. args 절반은 #19가 고쳤다). ## 고른 방법과 버린 대안 - 계약에서 `expectedDiagnosticId`를 함께 읽고, 음성 fixture 명령의 출력을 따로 잡아 문구가 있는지 본다. 판정 규칙은 `scripts/lib/ci-step-result.ts`의 `classifyGateStepResult`와 같다. - 버린 대안: parts가 `ci:gate`를 명령마다 부르기. `ci:gate`는 게이트 단위라 명령 하나를 고를 수 없고, parts의 목적(첫 실패 뒤 명령도 끝까지)과 맞지 않는다. ## 위험과 영향 - 문구가 빈 음성 fixture는 예전처럼 종료 코드만 본다(`ci:gate`도 빈 문구는 늘 맞는다). - merge 게이트 동작은 바뀌지 않는다. 바뀌는 것은 desktop 진입점 `scripts/verify.sh parts`뿐이다. ## 검증 - `scripts/tests/test_verify.py`에 가짜 `corepack` 시험: 음성 fixture가 맞는 종료 코드에 엉뚱한 문구를 내면 `parts FE-GATE-029`가 rc=1, 등록된 문구를 내면 rc=0. 고치기 전에는 엉뚱한 문구에도 rc=0으로 시험이 실패했다(RED). 고친 뒤 `python3 -m unittest scripts.tests.test_verify` 9개 통과. - desktop 실제 검사기: `scripts/verify.sh parts FE-GATE-029` rc=0(음성 fixture 9개가 등록된 문구를 냄). 로그 `/tmp/claude-gates/w2fe2-gd01/`. - `scripts/verify.sh docs` OK. ## 리뷰어가 볼 곳 - `scripts/verify.sh`의 `step`(출력 잡기)과 `run_parts`(판정). ## 관련 - round9 리뷰 `docs/reviews/2026-11-round9-08-guardrails-docs.md` GD-01(PR #23), 이 repo 1112/08-01.
donghyeon.kang added 1 commit 2026-11-12 19:47:39 +00:00
fix(scripts): verify.sh parts가 음성 fixture의 진단 문구까지 본다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / self-tests and removal drills (pull_request) Canceled after 0s
7fa825e57a
문제: `scripts/verify.sh parts <ID>`는 expect=fail 명령(검사기의 음성
fixture)을 종료 코드만으로 판정한다. `ci:gate`(run-ci-gate.ts의
classifyGateStepResult)는 정해진 종료 코드와 정해진 진단 문구
(`expectedDiagnosticId`)가 둘 다 있어야 통과시킨다. 그래서 검사기가
깨져 엉뚱한 원인으로 exit 1(TypeError 등)을 내도 parts는 그 음성
fixture를 통과로 센다. 문서가 검사기를 고친 뒤 `parts FE-GATE-029`를
돌리라고 하는 바로 그 경로다. args를 버리던 앞 절반은 79a225b6(#19)이
고쳤다.

고른 방법: 계약에서 `expectedDiagnosticId`를 함께 읽고, expect=fail
명령의 출력을 따로 잡아(`STEP_CAPTURE`) 진단 문구가 있는지 본다.
판정은 classifyGateStepResult와 같은 규칙(종료 코드가 같고, 출력에
문구가 들어 있음)이다. 어긋나면 무엇이 어긋났는지 한 줄을 stderr에
낸다.

위험·한계: 문구가 빈 음성 fixture는 예전처럼 종료 코드만 본다(ci:gate도
빈 문구는 늘 맞는다). 시스템 컨테이너 접두어가 붙은 게이트는 래퍼
출력까지 함께 잡는다.

검증: scripts/tests/test_verify.py에 가짜 corepack 시험을 더했다. 음성
fixture가 맞는 종료 코드에 엉뚱한 문구를 내면 parts FE-GATE-029가
rc=1이어야 하는데, 고치기 전 rc=0으로 실패했다(RED). 고친 뒤 9개 시험
통과. desktop 실제 검사기로 `scripts/verify.sh parts FE-GATE-029`
rc=0(음성 fixture 9개가 등록된 문구를 냄), 로그
/tmp/claude-gates/w2fe2-gd01/. `scripts/verify.sh docs` OK.

Refs: 1112/08-01 (GD-01)
Author
Owner

#40으로 병합됐다(main ee47480c). 이 PR의 head 7fa825e5가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).

#40으로 병합됐다(main `ee47480c`). 이 PR의 head `7fa825e5`가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:43:44 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#33