fix(ci): 실패한 ci:gate가 실패한 명령, 로그 경로, 로그 끝줄을 말한다 #30

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/r9-gate-failure-output AGit into main
Owner

무엇을, 왜

corepack pnpm ci:gate <ID>가 실패하면 콘솔에는 FE-GATE-013 security: FAIL 한 줄만 나온다. 어느 명령이 실패했는지, 원인이 남은 로그가 어디인지 말하지 않는다. verify.sh의 게이트 로그도 그 세 줄뿐이라 원인을 보려면 artifacts/quality/gates/ 아래 로그를 따로 찾아야 한다. 규칙(.claude/rules/gates-and-budgets.md)은 실패 메시지가 넘은 항목·잰 값·고칠 파일을 말하라고 한다(1112/08-13). 이 round에서도 F8 문서 게이트 실패의 원인을 찾느라 같은 일을 했다.

고른 방법과 버린 대안

  • scripts/lib/ci-gate-failure.ts의 formatGateFailure가 FAIL 줄, 실패한 명령(없으면 명령 밖 검사라고), 로그 경로, 로그 끝 20줄을 만든다.
  • scripts/run-ci-gate.ts가 기대에 어긋난 명령을 기억해 넘긴다.
  • PR 전 자체 리뷰가 「순수 함수만 시험해 연결 줄을 지워도 통과한다」를 찾았다. tests/system/ci-runner와 같은 임시 root 방식으로 FE-GATE-004의 명령 하나를 일부러 실패시킨 계약을 run-ci-gate.ts로 돌려 stderr를 보는 시험을 더했다(커밋 36f8c00f). timeout은 같은 방식 시험의 잰 값을 쓴다.
  • 버린 안: 명령 출력을 그대로 흘리기(PASS일 때도 콘솔이 길어진다).

위험과 영향

  • 끝 20줄에 원인이 없을 수 있다. 로그 경로가 있으니 거기서 본다.
  • PASS 출력은 그대로다.

검증

desktop, CI env, scripts/verify.sh(flock).

  • RED(기준 5250ff95에 새 시험만): tests/unit/ci-gate-failure.test.ts 모듈이 없어 실패. 로그 /tmp/claude-gates/r9f9-red/.
  • GREEN(첫 커밋): 3 passed. 로그 /tmp/claude-gates/r9f9-green/.
  • 연결 시험(head 36f8c00f): ci-gate-failure.test.ts 4 passed. run-ci-gate.ts에서 failedCommand = commandLine;을 지운 변이에서는 새 시험이 실패한다(stderr가 failed command: none …). 로그 /tmp/claude-gates/r9f9b/.
  • 게이트(트리 f87ac5b3 = head 트리): FE-GATE-002 rc=0, FE-GATE-003 rc=0. FE-GATE-013은 rc=1이다. desktop 호스트가 unprivileged user namespace를 막아 test:system의 사전 점검이 실패한다(결정 D8의 그 실패). 그 실패에서 새 출력이 나왔다: failed command: $ corepack pnpm test:system, log: artifacts/quality/gates/FE-GATE-013.txt, 사전 점검이 낸 원인 줄. 로그 /tmp/claude-gates/r9f9-gates/.

리뷰어가 볼 곳

  • scripts/run-ci-gate.ts의 failedCommand.

관련

  • 발견: docs/reviews/2026-11-round9-08-guardrails-docs.md 08-13(PR #23)
  • Refs: 1112/08-13
## 무엇을, 왜 `corepack pnpm ci:gate <ID>`가 실패하면 콘솔에는 `FE-GATE-013 security: FAIL` 한 줄만 나온다. 어느 명령이 실패했는지, 원인이 남은 로그가 어디인지 말하지 않는다. `verify.sh`의 게이트 로그도 그 세 줄뿐이라 원인을 보려면 `artifacts/quality/gates/` 아래 로그를 따로 찾아야 한다. 규칙(`.claude/rules/gates-and-budgets.md`)은 실패 메시지가 넘은 항목·잰 값·고칠 파일을 말하라고 한다(1112/08-13). 이 round에서도 F8 문서 게이트 실패의 원인을 찾느라 같은 일을 했다. ## 고른 방법과 버린 대안 - `scripts/lib/ci-gate-failure.ts`의 `formatGateFailure`가 FAIL 줄, 실패한 명령(없으면 명령 밖 검사라고), 로그 경로, 로그 끝 20줄을 만든다. - `scripts/run-ci-gate.ts`가 기대에 어긋난 명령을 기억해 넘긴다. - PR 전 자체 리뷰가 「순수 함수만 시험해 연결 줄을 지워도 통과한다」를 찾았다. `tests/system/ci-runner`와 같은 임시 root 방식으로 FE-GATE-004의 명령 하나를 일부러 실패시킨 계약을 `run-ci-gate.ts`로 돌려 stderr를 보는 시험을 더했다(커밋 `36f8c00f`). timeout은 같은 방식 시험의 잰 값을 쓴다. - 버린 안: 명령 출력을 그대로 흘리기(PASS일 때도 콘솔이 길어진다). ## 위험과 영향 - 끝 20줄에 원인이 없을 수 있다. 로그 경로가 있으니 거기서 본다. - PASS 출력은 그대로다. ## 검증 desktop, CI env, `scripts/verify.sh`(flock). - RED(기준 `5250ff95`에 새 시험만): `tests/unit/ci-gate-failure.test.ts` 모듈이 없어 실패. 로그 `/tmp/claude-gates/r9f9-red/`. - GREEN(첫 커밋): 3 passed. 로그 `/tmp/claude-gates/r9f9-green/`. - 연결 시험(head `36f8c00f`): `ci-gate-failure.test.ts` 4 passed. `run-ci-gate.ts`에서 `failedCommand = commandLine;`을 지운 변이에서는 새 시험이 실패한다(stderr가 `failed command: none …`). 로그 `/tmp/claude-gates/r9f9b/`. - 게이트(트리 `f87ac5b3` = head 트리): FE-GATE-002 rc=0, FE-GATE-003 rc=0. FE-GATE-013은 rc=1이다. desktop 호스트가 unprivileged user namespace를 막아 `test:system`의 사전 점검이 실패한다(결정 D8의 그 실패). 그 실패에서 새 출력이 나왔다: `failed command: $ corepack pnpm test:system`, `log: artifacts/quality/gates/FE-GATE-013.txt`, 사전 점검이 낸 원인 줄. 로그 `/tmp/claude-gates/r9f9-gates/`. ## 리뷰어가 볼 곳 - `scripts/run-ci-gate.ts`의 `failedCommand`. ## 관련 - 발견: `docs/reviews/2026-11-round9-08-guardrails-docs.md` 08-13(PR #23) - Refs: 1112/08-13
donghyeon.kang added 2 commits 2026-11-12 18:47:53 +00:00
`corepack pnpm ci:gate <ID>`가 실패하면 콘솔에는 `FE-GATE-013 security: FAIL`
한 줄만 나온다. 어느 명령이 실패했는지, 원인이 남은 로그가 어디인지
말하지 않는다. 그래서 verify.sh의 게이트 로그도 그 세 줄뿐이고, 원인을
보려면 artifacts/quality/gates/ 아래 로그를 따로 찾아야 한다. 규칙
(.claude/rules/gates-and-budgets.md)은 실패 메시지가 넘은 항목·잰 값·
고칠 파일을 말하라고 한다.

고른 방법: scripts/lib/ci-gate-failure.ts의 formatGateFailure가 FAIL 줄,
실패한 명령(없으면 명령 밖 검사라고), 로그 경로, 로그 끝 20줄을 만든다.
run-ci-gate.ts가 기대에 어긋난 명령을 기억해 넘긴다. 버린 대안: 명령의
출력을 그대로 흘리기(PASS일 때도 콘솔이 길어진다).

위험·한계: 끝 20줄에 원인이 없을 수 있다. 로그 경로가 있으니 거기서 본다.

검증: tests/unit/ci-gate-failure.test.ts 셋이 고치기 전에는 모듈이 없어
실패하고 고친 뒤 통과한다. desktop의 FE-GATE-013(호스트 제약으로 실패)이
새 출력을 낸다(PR 본문).

Refs: 1112/08-13
test(ci): ci:gate 실패 출력이 실패한 명령을 받는 연결을 실행으로 지킨다
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 / merge / static checks (pull_request) Successful in 3m54s
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 / checker self-tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 10m30s
36f8c00fd7
앞 커밋의 시험은 출력 문구를 만드는 순수 함수(formatGateFailure)만 본다.
run-ci-gate.ts에서 실패한 명령을 기억하는 줄(failedCommand = commandLine)을
지워도 그 시험은 통과한다(확인 리뷰, fe-testing 함정 1).

고른 방법: tests/system/ci-runner의 임시 root 방식 그대로, FE-GATE-004의 명령
하나를 일부러 실패하는 script로 바꾼 계약으로 run-ci-gate.ts를 돌린다. stderr가
게이트, 실패한 명령, 로그 경로, 원인 줄을 말하는지 본다. timeout은 같은 방식의
그 시험에서 잰 값을 쓴다.

검증: 실패한 명령을 기억하는 줄을 지운 변이에서 새 시험이 실패하고 원래
코드에서 통과한다(desktop, PR 본문).

Refs: 1112/08-13
donghyeon.kang added 1 commit 2026-11-12 19:29:34 +00:00
Merge remote-tracking branch 'origin/main' into fix/r9-gate-failure-output
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 / 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
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
fb1ca6af6c
Author
Owner

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

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