fix(ci): 게이트 실패 요약에 실패한 명령의 첫 실패 블록을 보인다 #67

Merged
donghyeon.kang merged 1 commits from donghyeon.kang/fix/ci-gate-failure-first-block AGit into main 2026-11-19 09:59:43 +00:00
Owner

무엇을, 왜

ci:gate가 실패하면 job 로그에는 그 게이트 출력의 끝 20줄만 남는다(scripts/lib/ci-gate-failure.ts). Playwright는 실패 블록 뒤에 첨부·개수 줄·자기 stderr를 찍고, 제거 드릴은 실패한 vitest 뒤에 다른 명령 줄을 찍는다. 그래서 단언의 기대·받은 값이 20줄 밖으로 밀린다.

  • runner run 371 FE-GATE-008: job 로그에 expect.poll(...).toEqual(...)의 코드 틀만 있고 Expected - 8 / Received + 1과 받은 Array []가 없었다. 원인을 보려고 artifact를 받아야 했다.
  • run 376 FE-GATE-030: 드릴 안 vitest의 FAIL 줄과 ENOENT가 빠지고 코드 틀만 남았다.

이 PR은 실패 요약에 「first failure in the log」를 더한다. 실패한 명령의 출력에서 Playwright나 vitest가 찍은 첫 실패 블록을 끝 줄 앞에 싣는다. 끝 줄은 그대로다.

고른 방법과 버린 대안

  • 고른 것: 실패한 명령 줄 뒤에서 reporter의 실패 블록 머리를 찾는다.
    • Playwright: 1) [project] › file:line:col › 제목부터 다음 실패나 개수 줄(1 failed, 68 passed) 앞까지.
    • vitest: Failed Suites N·Failed Tests N·Unhandled Errors 줄부터 닫는 구분선([1/N] 또는 맨 줄)까지. 이 모양은 desktop에서 vitest 4.1을 돌려 얻은 출력으로 확인했다(fixture vitest-suites-tests-unhandled.txt).
    • 블록은 40줄(FIRST_FAILURE_MAX_LINES)까지 싣고 넘는 줄 수를 적는다. 끝 20줄이 이미 보이는 부분은 다시 싣지 않는다. 색 코드는 판정할 때만 뗀다.
    • 앞 명령은 기대를 채웠으니(음성 fixture가 일부러 낸 실패) 보지 않는다.
  • 버린 것:
    • 끝 줄 수만 늘리기: 드릴처럼 뒤 출력이 길면 또 밀리고, job 로그만 길어진다.
    • Error: 낱말 찾기: 통과한 시험의 stderr에도 나온다(run 376 FE-GATE-030 로그의 chunk-recovery-boundary 줄).

위험과 영향

  • 실패 요약(stderr)의 꼴만 바뀐다. 게이트 판정·종료 코드·게이트 로그 파일(artifacts/quality/gates/)은 그대로다. 이 출력을 읽는 코드·문서는 없다(리뷰에서 확인).
  • reporter 형식에 기댄다. 형식이 바뀌어 블록을 못 찾으면 지금처럼 끝 줄만 보인다(진단이 줄 뿐 판정은 안 바뀐다).
  • 실패한 명령 안에서 다른 실패가 먼저 찍히면(드릴 안의 음성 fixture 출력) 그 블록을 고른다. 실행기는 명령의 stdout 다음에 stderr를 붙이므로 「첫」은 로그 안의 순서다(scripts/run-ci-gate.ts, 이 PR은 바꾸지 않음).
  • fixture 셋: 두 run의 게이트 로그를 줄이고 checkout 경로를 /workspace/repo로 바꾼 것, vitest 4.1 탐침 출력. 비밀 값·개인 정보 없음.
  • CHANGELOG는 고치지 않았다. 최근 fix PR과 같이 통합 때 한 세션이 쓴다(docs/work/improve.md 4.4절).

검증

모두 desktop에서 scripts/verify.sh로, 깨끗한 worktree에서 돌렸다. 로그는 desktop /tmp/claude-gates/<이름>/.

무엇 트리 결과 로그
RED: 기준 2b9a7715 + 새 시험, node scripts/run-vitest.ts run tests/unit/ci-gate-failure.test.ts bd066876 rc=1, 새 시험 4건 실패(기대·받은 값, vitest FAIL 줄, 명령 영역, 상한) · 5 통과 fe-next1-red
GREEN: 같은 시험 파일 7d88e5d1 rc=0, 13개 통과 fe-next1-green2
lint, check:types 7d88e5d1 rc=0, rc=0 fe-next1-static2
변이 8건(Playwright 끝 조건 둘, vitest 끝 조건·구분선 포함, Unhandled Errors 머리, 명령 영역, 40줄 상한, 겹침 제거) 7d88e5d1 + 변이 8건 모두 rc=1, 그 변이를 겨눈 시험이 실패 fe-next1-mut2-*
scripts/verify.sh merge(CI env) 7d88e5d1 14개 모두 rc=0(FE-GATE-005 138s, 008 199s, 013 115s 시스템 컨테이너, 020 320s) fe-next1-merge
scripts/verify.sh gate FE-GATE-029 FE-GATE-030(main 단계) 7d88e5d1 rc=0 23s, rc=0 270s fe-next1-main
  • main 단계 게이트를 돌린 이유: FE-GATE-030 제거 드릴이 tests/를 사본에 복사해 test:unit을 돌린다. 새 시험·fixture가 그 입력이다.
  • vitest Failed Suites·Failed Tests·Unhandled Errors 출력 모양은 desktop에서 탐침 시험 둘을 돌려 얻었다(fe-next1-probe). 탐침 파일은 커밋하지 않았다.
  • 리뷰: 새 눈 리뷰 1회(fe-testing 렌즈) Low 3(블록 끝 조건 시험 없음, 상한 정확히 고정 안 함, Unhandled Errors 미포함) → 모두 반영 → 확인 리뷰 1회 통과, 새 발견 없음.

리뷰어가 볼 곳

  • scripts/lib/ci-gate-failure.ts: firstFailureBlock의 시작·끝 규칙, formatGateFailure의 겹침 제거와 상한.
  • tests/unit/ci-gate-failure.test.ts: 「formatGateFailure with a reporter's failure block」 describe.
  • fixture는 tests/fixtures/ci-gate-failure/.

관련

  • fe-ci-next brief (1), runner run 371 job 3894(FE-GATE-008), run 376 job 4031(FE-GATE-030).
## 무엇을, 왜 `ci:gate`가 실패하면 job 로그에는 그 게이트 출력의 끝 20줄만 남는다(`scripts/lib/ci-gate-failure.ts`). Playwright는 실패 블록 뒤에 첨부·개수 줄·자기 stderr를 찍고, 제거 드릴은 실패한 vitest 뒤에 다른 명령 줄을 찍는다. 그래서 단언의 기대·받은 값이 20줄 밖으로 밀린다. - runner run 371 FE-GATE-008: job 로그에 `expect.poll(...).toEqual(...)`의 코드 틀만 있고 `Expected - 8 / Received + 1`과 받은 `Array []`가 없었다. 원인을 보려고 artifact를 받아야 했다. - run 376 FE-GATE-030: 드릴 안 vitest의 `FAIL` 줄과 ENOENT가 빠지고 코드 틀만 남았다. 이 PR은 실패 요약에 「first failure in the log」를 더한다. 실패한 명령의 출력에서 Playwright나 vitest가 찍은 첫 실패 블록을 끝 줄 앞에 싣는다. 끝 줄은 그대로다. ## 고른 방법과 버린 대안 - 고른 것: 실패한 명령 줄 뒤에서 reporter의 실패 블록 머리를 찾는다. - Playwright: `1) [project] › file:line:col › 제목`부터 다음 실패나 개수 줄(`1 failed`, `68 passed`) 앞까지. - vitest: `Failed Suites N`·`Failed Tests N`·`Unhandled Errors` 줄부터 닫는 구분선(`[1/N]` 또는 맨 줄)까지. 이 모양은 desktop에서 vitest 4.1을 돌려 얻은 출력으로 확인했다(fixture `vitest-suites-tests-unhandled.txt`). - 블록은 40줄(`FIRST_FAILURE_MAX_LINES`)까지 싣고 넘는 줄 수를 적는다. 끝 20줄이 이미 보이는 부분은 다시 싣지 않는다. 색 코드는 판정할 때만 뗀다. - 앞 명령은 기대를 채웠으니(음성 fixture가 일부러 낸 실패) 보지 않는다. - 버린 것: - 끝 줄 수만 늘리기: 드릴처럼 뒤 출력이 길면 또 밀리고, job 로그만 길어진다. - `Error:` 낱말 찾기: 통과한 시험의 stderr에도 나온다(run 376 FE-GATE-030 로그의 chunk-recovery-boundary 줄). ## 위험과 영향 - 실패 요약(stderr)의 꼴만 바뀐다. 게이트 판정·종료 코드·게이트 로그 파일(`artifacts/quality/gates/`)은 그대로다. 이 출력을 읽는 코드·문서는 없다(리뷰에서 확인). - reporter 형식에 기댄다. 형식이 바뀌어 블록을 못 찾으면 지금처럼 끝 줄만 보인다(진단이 줄 뿐 판정은 안 바뀐다). - 실패한 명령 안에서 다른 실패가 먼저 찍히면(드릴 안의 음성 fixture 출력) 그 블록을 고른다. 실행기는 명령의 stdout 다음에 stderr를 붙이므로 「첫」은 로그 안의 순서다(`scripts/run-ci-gate.ts`, 이 PR은 바꾸지 않음). - fixture 셋: 두 run의 게이트 로그를 줄이고 checkout 경로를 `/workspace/repo`로 바꾼 것, vitest 4.1 탐침 출력. 비밀 값·개인 정보 없음. - CHANGELOG는 고치지 않았다. 최근 fix PR과 같이 통합 때 한 세션이 쓴다(`docs/work/improve.md` 4.4절). ## 검증 모두 desktop에서 `scripts/verify.sh`로, 깨끗한 worktree에서 돌렸다. 로그는 desktop `/tmp/claude-gates/<이름>/`. | 무엇 | 트리 | 결과 | 로그 | | --- | --- | --- | --- | | RED: 기준 2b9a7715 + 새 시험, `node scripts/run-vitest.ts run tests/unit/ci-gate-failure.test.ts` | bd066876 | rc=1, 새 시험 4건 실패(기대·받은 값, vitest FAIL 줄, 명령 영역, 상한) · 5 통과 | `fe-next1-red` | | GREEN: 같은 시험 파일 | 7d88e5d1 | rc=0, 13개 통과 | `fe-next1-green2` | | `lint`, `check:types` | 7d88e5d1 | rc=0, rc=0 | `fe-next1-static2` | | 변이 8건(Playwright 끝 조건 둘, vitest 끝 조건·구분선 포함, `Unhandled Errors` 머리, 명령 영역, 40줄 상한, 겹침 제거) | 7d88e5d1 + 변이 | 8건 모두 rc=1, 그 변이를 겨눈 시험이 실패 | `fe-next1-mut2-*` | | `scripts/verify.sh merge`(CI env) | 7d88e5d1 | 14개 모두 rc=0(FE-GATE-005 138s, 008 199s, 013 115s 시스템 컨테이너, 020 320s) | `fe-next1-merge` | | `scripts/verify.sh gate FE-GATE-029 FE-GATE-030`(main 단계) | 7d88e5d1 | rc=0 23s, rc=0 270s | `fe-next1-main` | - main 단계 게이트를 돌린 이유: FE-GATE-030 제거 드릴이 `tests/`를 사본에 복사해 `test:unit`을 돌린다. 새 시험·fixture가 그 입력이다. - vitest `Failed Suites`·`Failed Tests`·`Unhandled Errors` 출력 모양은 desktop에서 탐침 시험 둘을 돌려 얻었다(`fe-next1-probe`). 탐침 파일은 커밋하지 않았다. - 리뷰: 새 눈 리뷰 1회(fe-testing 렌즈) Low 3(블록 끝 조건 시험 없음, 상한 정확히 고정 안 함, `Unhandled Errors` 미포함) → 모두 반영 → 확인 리뷰 1회 통과, 새 발견 없음. ## 리뷰어가 볼 곳 - `scripts/lib/ci-gate-failure.ts`: `firstFailureBlock`의 시작·끝 규칙, `formatGateFailure`의 겹침 제거와 상한. - `tests/unit/ci-gate-failure.test.ts`: 「formatGateFailure with a reporter's failure block」 describe. - fixture는 `tests/fixtures/ci-gate-failure/`. ## 관련 - fe-ci-next brief (1), runner run 371 job 3894(FE-GATE-008), run 376 job 4031(FE-GATE-030).
donghyeon.kang added 1 commit 2026-11-19 09:28:34 +00:00
fix(ci): 게이트 실패 요약에 실패한 명령의 첫 실패 블록을 보인다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m26s
frontend-quality-gates / merge / tests (pull_request) Successful in 17m2s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m42s
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
829733cff4
문제: `ci:gate`가 실패하면 job 로그에는 게이트 출력의 끝 20줄만
남는다. Playwright는 실패 블록 뒤에 첨부·개수 줄·자기 stderr를 찍고,
제거 드릴은 실패한 vitest 뒤에 다른 명령 줄을 찍는다. 그래서 단언
(기대·받은 값)이 20줄 밖으로 밀린다. runner run 371의 FE-GATE-008은
`expect.poll(...).toEqual(...)`의 코드 틀만, run 376의 FE-GATE-030은
vitest 코드 틀만 남기고 `FAIL` 줄과 ENOENT를 잃었다. 원인을 보려면
artifact를 받아야 했다.

고른 방법: 실패한 명령의 줄 뒤에서 Playwright나 vitest가 찍은 첫 실패
블록을 찾아 「first failure in the log」로 끝 줄 앞에 둔다.
- Playwright: `1) [project] › file:line:col › 제목`부터 다음 실패나
  개수 줄(`1 failed`, `68 passed`) 앞까지.
- vitest: `Failed Suites N`·`Failed Tests N`·`Unhandled Errors` 줄부터
  닫는 구분선(`[1/N]` 또는 맨 줄)까지. 모양은 desktop에서 vitest 4.1을
  돌려 확인했다.
앞 명령은 기대를 채웠으니(음성 fixture가 일부러 낸 실패) 보지 않는다.
블록은 40줄까지 싣고 넘는 줄 수를 적는다. 끝 줄이 이미 보이는 부분은
다시 싣지 않는다. 색 코드는 판정할 때만 떼고 줄은 그대로 싣는다.
버린 것: 끝 줄 수만 늘리기(드릴처럼 뒤 출력이 길면 또 밀리고 job
로그만 길어진다), `Error:` 낱말 찾기(통과한 시험의 stderr에도 나온다,
run 376 FE-GATE-030 로그의 chunk-recovery-boundary 줄).

위험·한계: reporter 형식(Playwright 번호 줄, vitest 구분선)에 기댄다.
형식이 바뀌어 블록을 못 찾으면 지금처럼 끝 줄만 보인다. 실패한 명령
안에서 다른 실패가 먼저 찍히면(드릴 안의 음성 fixture 출력) 그 블록을
고른다. 실행기는 명령의 stdout 다음에 stderr를 붙이므로 「첫」은 로그
안의 순서다. 끝 줄은 늘 그대로 있다. fixture 셋 중 둘은 두 run의 게이트
로그(artifacts/quality/gates/)를 줄이고 checkout 경로를 줄인 것, 하나는
vitest 4.1 탐침 출력이다.

검증(desktop, `scripts/verify.sh`, 깨끗한 worktree):
- RED: 기준 2b9a7715 + 새 시험 → 새 시험 4건 실패(rc=1).
- GREEN: `tests/unit/ci-gate-failure.test.ts` 13개 통과, lint·
  check:types rc=0. 변이 8건(끝 조건 넷, Unhandled 머리, 명령 영역,
  상한, 겹침 제거) 모두 새 시험이 잡음.
- `scripts/verify.sh merge` 14개 rc=0, `gate FE-GATE-029 FE-GATE-030`
  rc=0(제거 드릴이 tests/를 사본에 복사해 이 시험을 돌린다).

Refs: fe-ci-next (1), runner run 371 FE-GATE-008, run 376 FE-GATE-030
donghyeon.kang merged commit 972139e679 into main 2026-11-19 09:59:43 +00:00
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#67