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가 찍은 첫 실패 블록을 끝 줄 앞에 싣는다. 끝 줄은 그대로다.
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줄이 이미 보이는 부분은 다시 싣지 않는다. 색 코드는 판정할 때만 뗀다.
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).
문제: `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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
ci:gate가 실패하면 job 로그에는 그 게이트 출력의 끝 20줄만 남는다(scripts/lib/ci-gate-failure.ts). Playwright는 실패 블록 뒤에 첨부·개수 줄·자기 stderr를 찍고, 제거 드릴은 실패한 vitest 뒤에 다른 명령 줄을 찍는다. 그래서 단언의 기대·받은 값이 20줄 밖으로 밀린다.expect.poll(...).toEqual(...)의 코드 틀만 있고Expected - 8 / Received + 1과 받은Array []가 없었다. 원인을 보려고 artifact를 받아야 했다.FAIL줄과 ENOENT가 빠지고 코드 틀만 남았다.이 PR은 실패 요약에 「first failure in the log」를 더한다. 실패한 명령의 출력에서 Playwright나 vitest가 찍은 첫 실패 블록을 끝 줄 앞에 싣는다. 끝 줄은 그대로다.
고른 방법과 버린 대안
1) [project] › file:line:col › 제목부터 다음 실패나 개수 줄(1 failed,68 passed) 앞까지.Failed Suites N·Failed Tests N·Unhandled Errors줄부터 닫는 구분선([1/N]또는 맨 줄)까지. 이 모양은 desktop에서 vitest 4.1을 돌려 얻은 출력으로 확인했다(fixturevitest-suites-tests-unhandled.txt).FIRST_FAILURE_MAX_LINES)까지 싣고 넘는 줄 수를 적는다. 끝 20줄이 이미 보이는 부분은 다시 싣지 않는다. 색 코드는 판정할 때만 뗀다.Error:낱말 찾기: 통과한 시험의 stderr에도 나온다(run 376 FE-GATE-030 로그의 chunk-recovery-boundary 줄).위험과 영향
artifacts/quality/gates/)은 그대로다. 이 출력을 읽는 코드·문서는 없다(리뷰에서 확인).scripts/run-ci-gate.ts, 이 PR은 바꾸지 않음)./workspace/repo로 바꾼 것, vitest 4.1 탐침 출력. 비밀 값·개인 정보 없음.docs/work/improve.md4.4절).검증
모두 desktop에서
scripts/verify.sh로, 깨끗한 worktree에서 돌렸다. 로그는 desktop/tmp/claude-gates/<이름>/.2b9a7715+ 새 시험,node scripts/run-vitest.ts run tests/unit/ci-gate-failure.test.tsfe-next1-red7d88e5d1fe-next1-green2lint,check:types7d88e5d1fe-next1-static2Unhandled Errors머리, 명령 영역, 40줄 상한, 겹침 제거)7d88e5d1+ 변이fe-next1-mut2-*scripts/verify.sh merge(CI env)7d88e5d1fe-next1-mergescripts/verify.sh gate FE-GATE-029 FE-GATE-030(main 단계)7d88e5d1fe-next1-maintests/를 사본에 복사해test:unit을 돌린다. 새 시험·fixture가 그 입력이다.Failed Suites·Failed Tests·Unhandled Errors출력 모양은 desktop에서 탐침 시험 둘을 돌려 얻었다(fe-next1-probe). 탐침 파일은 커밋하지 않았다.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.tests/fixtures/ci-gate-failure/.관련
donghyeon.kang referenced this pull request2026-11-19 19:12:31 +00:00