ci(gates): merge job을 셋으로 합치고 검사기 자기 시험을 main 단계로 내린다 #16

Merged
donghyeon.kang merged 7 commits from chore/ci-merge-jobs into main 2026-11-11 13:36:14 +00:00
Owner

무엇을, 왜

프론트 CI 재편이다(design-docs repo-structure/03-ci.md 7.3절 F1·F2·F3, 결정 repo-structure/README.md 3.3절, 소유자 승인 2026-11-07). 정리 3·4단계 PR #14(브랜치 chore/layout-3-merge) 위에 쌓았다. #14가 먼저 병합돼야 한다. 이 PR의 diff에는 #14의 커밋도 보인다(main이 아직 #14 앞이라서).

  • merge 단계가 게이트마다 job 하나(행렬 14개)라서 PR마다 checkout·setup-node·pnpm install을 14번, 브라우저 설치를 2번 한다. runner는 소유자 기계 한 대다.
  • merge 단계가 변경이 아니라 검사기 자신을 시험하는 명령까지 PR에서 돈다: *:fixture 자기 시험, 모든 시험·script가 게이트에 걸렸는지 보는 ungated 검사, CI 계약의 개수·해시 기준선(config/ci/contract-baseline.json). 기준선은 명령 하나를 더해도 OWNER·REASON을 붙여 다시 받아야 했다.

고른 방법과 버린 대안

커밋 다섯과 merge 둘이다. merge는 아래층 PR #14를 받는 것이다: c4195bac(#14의 16eb200f), 9676101a(main의 하네스 PR #13을 받은 #14의 568f3328, 충돌 없음).

  1. 0739f26b F1 — job 종류 gate-sequence. merge job 셋이 게이트를 차례로 돈다. 게이트마다 FE-GATE-NNN / <이름> 단계이고 if: ${{ !cancelled() }}라 앞 게이트가 실패해도 다음 게이트가 돈다(행렬의 fail-fast: false와 같은 효과).

    job 게이트 이유
    merge_static (merge / static checks) 001 002 003 010 011 012 소스를 읽고 빌드하는 검사
    merge_test (merge / tests) 004 005 006 007 013 020 시험. FE-GATE-013 runner 요구 주석이 여기 붙는다
    merge_browser (merge / browser tests) 008 009 브라우저 설치가 필요한 둘만

    release 단계는 셋을 모두 기다린다. 설치 횟수(merge 단계) 14 → 3.

    • 버린 것: 행렬을 두고 install만 캐시하기(runner 한 대에서 job 수만큼 준비가 남는다), 한 job에 모두 넣기(모든 게이트가 브라우저 설치를 기다린다).
  2. f6b2b96c F2 — 새 단계 main(MAIN_READY, 승격을 막지 않는다), 새 게이트 FE-GATE-029 checker-self-tests, 새 job main_gate(브랜치 push와 workflow_dispatch stage=main에서만). FE-GATE-001·005·008·010·013의 *:fixture 명령 15개와 그 증거 10개, check:ci에서 뗀 ungated 검사(check:ci:gating, scripts/check-ci-gating.ts)를 옮겼다. contract-baseline.json·update:ci-contract-baseline·그 검사를 지웠다(소유자 결정). merge 단계 명령 참조 64 → 49.

    • 설계와 다르게 고른 것 하나: 음성 타입 fixture(check:types:fixtures)는 이름이 *:fixture여도 merge(FE-GATE-003)에 남겼다. 검사기가 아니라 src 포트·계약 타입을 시험한다. 정리 3단계 9.3절 변이(TelemetryPort.emit 인자를 string으로)를 PR에서 막는 것이 이 명령이다. 03 문서 3.5절의 「38개」는 이 23개를 *:fixture로 함께 셌다.
    • 개수를 고정하던 단위 시험의 개수 단언(명령·참조·실패 명령·증거·산출물 수)도 뺐다. 같은 기준선의 다른 사본이라서다. 게이트 id 목록, job 13개, stage 6개는 남겼다.
  3. 3ce77d9e F3 — scripts/check-*.ts 30개 이전 판정 표 docs/operations/ci-script-assessment.md. 코드는 바꾸지 않았다. 시험 8, 일부 이전 9, 스크립트 유지 11, ESLint 규칙 1, 지움 1.

  4. 657afca1 CHANGELOG 「먼저 할 일」 13·14와 계약 표 두 줄.

  5. 7cd2d9e8 main에 들어온 하네스 매뉴얼 두 줄(docs/work/reference/gates.md, testing.md)이 ungated 검사를 check:ci라고 적어, 2번에서 옮긴 check:ci:gating(main 단계 FE-GATE-029)으로 고쳤다. 생성기 주석의 merge_gate 한 줄도 고쳤다.

위험과 영향

  • 검사기를 망가뜨린 PR은 merge를 통과하고 main push에서 FE-GATE-029가 빨개진다. 새 시험 파일·script를 게이트에 안 걸어도 PR은 통과한다(설계 7.5절의 교환).
  • 한 job 안의 게이트가 같은 작업 공간을 쓴다. desktop에서 job과 같은 순서·같은 깨끗한 트리로 돌려 확인했다(아래).
  • !cancelled()와 job 셋의 실제 해석은 Gitea runner에서 확인했다(아래 「Gitea Actions」).
  • runner에서는 merge 단계가 아직 초록이 아니다. FE-GATE-013(runner 이미지에 bwrap·systemd bus 없음)과, 시험 하나(fixture-node-modules.test.ts F-4)로 FE-GATE-005·020이 실패한다. main의 옛 workflow도 같은 셋이 같은 원인으로 실패하므로 이 PR 범위 밖이다(아래 실행 #5).
  • 다운스트림: 브랜치 보호의 필수 검사를 옛 job 이름으로 걸었으면 바꾼다. 자기 기준선 파일은 지운다(CHANGELOG 13·14).
  • 다른 세션 소관 파일 중 고친 것: docs/operations/ci-quality-gates.md(지운 기준선 절, job 설명 한 단락, merge_gate를 가리키던 두 줄, gating 검사가 도는 곳), 하네스 매뉴얼 docs/work/reference/gates.md·testing.md(각 1줄, 5번). 새 문서 docs/operations/ci-script-assessment.md.

검증

main(#13)을 받은 뒤 다시 돌린 것 — head 7cd2d9e8, 2026-11-11 21:01~21:30, desktop FEA/c, workflow CI env, 공유 잠금 아래. 로그 desktop /tmp/claude-gates/fea-v4/. 아래층 #14(568f3328)의 merge 게이트 14개도 같은 실행에서 돌렸다(#14 본문).

대상 결과
9676101a·7cd2d9e8 커밋별 test:unit · check:types · check:ci · lint · verify:documentation 둘 다 5개 모두 rc=0
merge_static(깨끗한 트리): FE-GATE-001·002·003·010·011·012 모두 rc=0
merge_test(깨끗한 트리): FE-GATE-004·005·006·007·020 모두 rc=0 (005 149초, 020 916초)
merge_test: FE-GATE-013 rc=1, 1초(호스트 bwrap 조건). 부분 실행: 시스템 vitest 115개 중 18 실패 · 61 통과 · 36 건너뜀(모두 ci-artifact-contract.test.ts), verify:reproducible-build · build:release-candidate · verify:local-evidence · check:browser-security rc=0
merge_browser(깨끗한 트리): FE-GATE-008·009 모두 rc=0 (008 202초)
main_gate(깨끗한 트리): FE-GATE-029 rc=0 (26초)
FE-GATE-017 documentation rc=0

게이트별 결과가 #14(합치기 전, 한 checkout)와 같다. 아래는 main을 받기 전(c4195bac까지)의 결과다.

모두 desktop(~/workspace/clean-architecture-frontend-template-lanes/FEA/c, 공유 checkout은 건드리지 않음), workflow의 CI env, 공유 잠금 아래. 로그는 desktop /tmp/claude-gates/fea-prb-2/(1차 fea-prb-1/), fea-c3/.

커밋마다 test:unit · check:types · check:ci · lint · verify:documentation

커밋 결과
0739f26b 5개 모두 rc=0
f6b2b96c 5개 모두 rc=0
3ce77d9e 5개 모두 rc=0
657afca1 check:types·check:ci·lint·verify:documentation rc=0. test:unit은 1회 rc=1(시간에 민감한 시험 2개: http-execution-v3의 deadline 대기, indexeddb-runtime의 가짜 트랜잭션 대기. 이 커밋은 CHANGELOG만 바꾼다). 그때 desktop 부하가 27(12코어)이었다. 같은 커밋의 FE-GATE-005 안 test:unit과 부하가 내려간 뒤 재실행(fea-c3)에서 5개 모두 rc=0
c4195bac (merge) 5개 모두 rc=0

합치기 전후 merge 단계 비교(F1·7.4절) — 전: PR #14 head(한 checkout에서 게이트를 차례로, fea-pra-1·fea-pra-2). 후: 이 PR의 657afca1을 workflow의 job처럼 돌렸다. job마다 git clean -fdx한 트리에서 install 한 번, 그 job의 게이트를 job 순서대로.

게이트 전 후 (job)
FE-GATE-001 manifest-lockfile rc=0 rc=0 (merge_static)
FE-GATE-002 lint rc=0 rc=0 (merge_static)
FE-GATE-003 typecheck rc=0 rc=0 (merge_static)
FE-GATE-010 architecture rc=0 rc=0 (merge_static)
FE-GATE-011 build rc=0 rc=0 (merge_static)
FE-GATE-012 bundle rc=0 rc=0 (merge_static)
FE-GATE-004 runtime-schema rc=0 rc=0 (merge_test)
FE-GATE-005 unit rc=0 rc=0 (merge_test)
FE-GATE-006 component rc=0 rc=0 (merge_test)
FE-GATE-007 integration rc=0 rc=0 (merge_test)
FE-GATE-013 security rc=1 (호스트) rc=1 (호스트, merge_test)
FE-GATE-020 removability rc=0 rc=0 (merge_test)
FE-GATE-008 e2e rc=0 rc=0 (merge_browser)
FE-GATE-009 accessibility rc=0 rc=0 (merge_browser)
FE-GATE-029 checker-self-tests (없음, 명령은 각 merge 게이트 안에서 rc=0) rc=0 (main_gate, 깨끗한 트리에서 26초)
FE-GATE-017 documentation rc=0 rc=0

게이트별 결과가 같다. job 시간(부하 있는 desktop): merge_static 약 2.5분, merge_test 약 20분(FE-GATE-020이 16분), merge_browser 약 3.7분, main_gate 0.5분. install은 merge 단계 14번 → 3번.

FE-GATE-013은 desktop 호스트가 bwrap user namespace를 막아 사전 점검에서 멈춘다(알려진 호스트 조건). 부분 실행: 시스템 vitest 18 실패/97 통과(모두 ci-artifact-contract.test.ts provider 시험, #14·2단계와 같은 수), verify:reproducible-build·build:release-candidate·verify:local-evidence·check:browser-security rc=0. 옮긴 fixture 명령 셋(supply-chain·provider·security)은 FE-GATE-029 안에서 rc=0.

1차 실행(fea-prb-1)에서 걸린 것: F2 커밋의 supply-chain.test.ts가 보안 fixture 명령을 FE-GATE-013에서 찾음(FE-GATE-029로 고침), F3 문서가 지운 script 이름 check:types:recipes를 코드 표기로 적음(verify:documentation 실패, 고침), CHANGELOG 리뷰 ID(#14와 같은 원인). push 전에 커밋을 고쳐 다시 쌓았다.

Gitea Actions

실행 #1(run_id 54, 2026-11-09 02:29 KST, workflow_dispatch stage=merge, chore/ci-merge-jobs c4195bac, runner desktop-runner 라벨 ubuntu-latest): 실패. 원인은 이 PR이 아니라 repo Actions 변수가 없는 것이다.

job 시간 결과
merge / static checks 29초 게이트 6개가 차례로 돌고 모두 FAIL. 산출물 merge-static-54 업로드
merge / tests 28초 게이트 6개가 차례로 돌고 모두 FAIL. 산출물 merge-test-54 업로드
merge / browser tests 4시간 24분 브라우저 설치 중 02:32 desktop 디스크 압박으로 Gitea가 내려가 멈춘 뒤 실패 처리
  • 게이트 로그(산출물): missing required CI build environment: CI_RUNNER_IMAGE. workflow가 CI_RUNNER_IMAGE: ${{ vars.RUNNER_IMAGE_DIGEST }}를 읽는데 repo 변수가 없다(설정 화면 「아직 변수가 없습니다」). main의 옛 workflow도 같은 줄이라 어느 브랜치든 같다. 값은 …@sha256:<64자> 형식이어야 한다(scripts/lib/build-environment.ts).
  • 이 실행으로 확인한 것: workflow가 Gitea 1.27에서 그대로 파싱된다. merge job 셋이 정의대로 시작한다. 게이트마다 FE-GATE-NNN / <이름> 단계로 보인다. 앞 게이트가 실패해도 if: ${{ !cancelled() }}로 다음 게이트가 모두 돈다(각 job의 게이트 6개가 모두 실행됨). job마다 산출물이 하나씩 올라간다.
  • 확인하지 못한 것: 게이트 명령이 runner 안에서 통과하는지. 변수를 넣고 디스크 여유를 확보한 뒤 다시 돌려야 한다.

실행 #5(run_id 81, 2026-11-11, push로 생긴 pull_request 이벤트, head 7cd2d9e8, runner desktop-runner 라벨 ubuntu-latest, repo 변수 RUNNER_IMAGE_DIGEST 설정 뒤): job 셋 중 둘 성공, 하나 실패. 21:30에 push했고 main run #4(옛 workflow) 뒤에서 29분 기다렸다. 시간은 KST.

job 시간 결과
merge / static checks 21:59:40~22:02:04 (2분 24초) 성공. FE-GATE-001·002·003·010·011·012 모두 PASS
merge / tests 22:02:04~22:15:04 (13분) 실패. FE-GATE-004·006·007 PASS, 005·013·020 FAIL(020이 10분)
merge / browser tests 22:15:04~22:25:53 (10분 49초, 그중 브라우저 설치 4분) 성공. FE-GATE-008·009 PASS
main / checker self-tests 돌지 않음 pull_request 이벤트라서다(설계대로, 브랜치 push와 dispatch stage=main에서만)

실패 셋의 원인(job 산출물 merge-test-81의 게이트 로그):

  • FE-GATE-013: runner 이미지에 /usr/bin/bwrap과 systemd manager bus가 없어 check-system-test-prerequisites.ts에서 멈춘다. desktop과 같은 부류의 호스트 조건이다.
  • FE-GATE-005: 3,118개 중 1개 실패. tests/unit/fixture-node-modules.test.ts 「pnpm inside a linked fixture (F-4) > installs through the linked directories unless told not to」. 보호 env 없이 돌린 pnpm이 공유 트리에 설치한다는 전제(changed === true)가 runner에서 false로 나온다. desktop에서는 통과한다. 원인은 아직 보지 않았다.
  • FE-GATE-020: drill 사본 안에서 같은 F-4 시험이 4번(test:unit·test:coverage·feature-removal), test:integration에서 tests/integration/provider-guardian-transaction.test.ts 「still publishes near the lease deadline when post-processing completes in time」이 1번(시간에 민감한 시험, 그때 desktop 부하 약 20) 실패했다.

같은 runner에서 합치기 전과 비교 — 같은 날 main push로 돈 run #4(run_id 80, d1b9c087, 옛 workflow 행렬 14 job, 21:18:05~21:59:37).

run #4 (main, 14 job) run #5 (이 PR, 3 job)
PASS 001 002 003 004 006 007 008 009 010 011 012 001 002 003 004 006 007 008 009 010 011 012
FAIL 005 013 020 005 013 020
실패 원인 005·020 같은 F-4 시험(020 안에서 4번), 013 같은 bwrap·systemd 전제 같음(020에 시간 시험 1개 더)
install / 브라우저 설치 14번 / 2번 3번 / 1번
merge 단계 runner 시간 41분 32초 26분 13초

게이트별 결과가 같다. 코드가 다르고(main은 #14 앞) 부하도 달라 시간은 참고만 한다. 실패 셋은 main에서도 같은 원인으로 나므로 이 PR이 만든 것이 아니다.

이 실행으로 더 확인한 것: 게이트 명령이 runner 안에서 실제로 돈다(14개 중 11개 PASS). 005가 실패한 뒤에도 !cancelled()로 006·007·013·020이 돌았다. job마다 산출물(merge-static-81 2.4MB, merge-test-81 0.2MB, merge-browser-81 3.3MB)이 올라갔다.

리뷰어가 볼 곳

  • scripts/contracts/ci-gates.ts: job 소유·그래프·단계 표, gate-sequence, 기준선 코드 삭제.
  • scripts/generate-ci-workflow.ts: gate-sequence 렌더, main 조건. .gitea/workflows/quality-gates.yml은 생성물이다.
  • config/ci/gates.json: FE-GATE-029와 옮긴 명령·증거. 만든 방법은 python 한 번(명령 id 목록으로 옮기고, 옮긴 명령만 만드는 산출물을 증거에서 함께 옮김). 기준 c54c3813.
  • scripts/check-ci-gating.ts: check-ci-contract.ts에서 그대로 뗀 ungated 검사.

관련

  • design-docs repo-structure/03-ci.md 3.5·7.3·7.4·7.5절, repo-structure/README.md 3.3절
  • 정리 3·4단계 PR #14(이 브랜치의 아래층)
## 무엇을, 왜 프론트 CI 재편이다(design-docs `repo-structure/03-ci.md` 7.3절 F1·F2·F3, 결정 `repo-structure/README.md` 3.3절, 소유자 승인 2026-11-07). 정리 3·4단계 PR #14(브랜치 `chore/layout-3-merge`) 위에 쌓았다. #14가 먼저 병합돼야 한다. 이 PR의 diff에는 #14의 커밋도 보인다(main이 아직 #14 앞이라서). - merge 단계가 게이트마다 job 하나(행렬 14개)라서 PR마다 checkout·setup-node·`pnpm install`을 14번, 브라우저 설치를 2번 한다. runner는 소유자 기계 한 대다. - merge 단계가 변경이 아니라 검사기 자신을 시험하는 명령까지 PR에서 돈다: `*:fixture` 자기 시험, 모든 시험·script가 게이트에 걸렸는지 보는 ungated 검사, CI 계약의 개수·해시 기준선(`config/ci/contract-baseline.json`). 기준선은 명령 하나를 더해도 OWNER·REASON을 붙여 다시 받아야 했다. ## 고른 방법과 버린 대안 커밋 다섯과 merge 둘이다. merge는 아래층 PR #14를 받는 것이다: `c4195bac`(#14의 `16eb200f`), `9676101a`(main의 하네스 PR #13을 받은 #14의 `568f3328`, 충돌 없음). 1. `0739f26b` F1 — job 종류 `gate-sequence`. merge job 셋이 게이트를 차례로 돈다. 게이트마다 `FE-GATE-NNN / <이름>` 단계이고 `if: ${{ !cancelled() }}`라 앞 게이트가 실패해도 다음 게이트가 돈다(행렬의 `fail-fast: false`와 같은 효과). | job | 게이트 | 이유 | |---|---|---| | `merge_static` (merge / static checks) | 001 002 003 010 011 012 | 소스를 읽고 빌드하는 검사 | | `merge_test` (merge / tests) | 004 005 006 007 013 020 | 시험. FE-GATE-013 runner 요구 주석이 여기 붙는다 | | `merge_browser` (merge / browser tests) | 008 009 | 브라우저 설치가 필요한 둘만 | release 단계는 셋을 모두 기다린다. 설치 횟수(merge 단계) 14 → 3. - 버린 것: 행렬을 두고 install만 캐시하기(runner 한 대에서 job 수만큼 준비가 남는다), 한 job에 모두 넣기(모든 게이트가 브라우저 설치를 기다린다). 2. `f6b2b96c` F2 — 새 단계 `main`(`MAIN_READY`, 승격을 막지 않는다), 새 게이트 FE-GATE-029 `checker-self-tests`, 새 job `main_gate`(브랜치 push와 `workflow_dispatch` stage=main에서만). FE-GATE-001·005·008·010·013의 `*:fixture` 명령 15개와 그 증거 10개, `check:ci`에서 뗀 ungated 검사(`check:ci:gating`, `scripts/check-ci-gating.ts`)를 옮겼다. `contract-baseline.json`·`update:ci-contract-baseline`·그 검사를 지웠다(소유자 결정). merge 단계 명령 참조 64 → 49. - **설계와 다르게 고른 것 하나**: 음성 타입 fixture(`check:types:fixtures`)는 이름이 `*:fixture`여도 merge(FE-GATE-003)에 남겼다. 검사기가 아니라 src 포트·계약 타입을 시험한다. 정리 3단계 9.3절 변이(`TelemetryPort.emit` 인자를 `string`으로)를 PR에서 막는 것이 이 명령이다. 03 문서 3.5절의 「38개」는 이 23개를 `*:fixture`로 함께 셌다. - 개수를 고정하던 단위 시험의 개수 단언(명령·참조·실패 명령·증거·산출물 수)도 뺐다. 같은 기준선의 다른 사본이라서다. 게이트 id 목록, job 13개, stage 6개는 남겼다. 3. `3ce77d9e` F3 — `scripts/check-*.ts` 30개 이전 판정 표 `docs/operations/ci-script-assessment.md`. 코드는 바꾸지 않았다. 시험 8, 일부 이전 9, 스크립트 유지 11, ESLint 규칙 1, 지움 1. 4. `657afca1` CHANGELOG 「먼저 할 일」 13·14와 계약 표 두 줄. 5. `7cd2d9e8` main에 들어온 하네스 매뉴얼 두 줄(`docs/work/reference/gates.md`, `testing.md`)이 ungated 검사를 `check:ci`라고 적어, 2번에서 옮긴 `check:ci:gating`(main 단계 FE-GATE-029)으로 고쳤다. 생성기 주석의 `merge_gate` 한 줄도 고쳤다. ## 위험과 영향 - 검사기를 망가뜨린 PR은 merge를 통과하고 main push에서 FE-GATE-029가 빨개진다. 새 시험 파일·script를 게이트에 안 걸어도 PR은 통과한다(설계 7.5절의 교환). - 한 job 안의 게이트가 같은 작업 공간을 쓴다. desktop에서 job과 같은 순서·같은 깨끗한 트리로 돌려 확인했다(아래). - `!cancelled()`와 job 셋의 실제 해석은 Gitea runner에서 확인했다(아래 「Gitea Actions」). - runner에서는 merge 단계가 아직 초록이 아니다. FE-GATE-013(runner 이미지에 bwrap·systemd bus 없음)과, 시험 하나(`fixture-node-modules.test.ts` F-4)로 FE-GATE-005·020이 실패한다. main의 옛 workflow도 같은 셋이 같은 원인으로 실패하므로 이 PR 범위 밖이다(아래 실행 #5). - 다운스트림: 브랜치 보호의 필수 검사를 옛 job 이름으로 걸었으면 바꾼다. 자기 기준선 파일은 지운다(CHANGELOG 13·14). - 다른 세션 소관 파일 중 고친 것: `docs/operations/ci-quality-gates.md`(지운 기준선 절, job 설명 한 단락, `merge_gate`를 가리키던 두 줄, gating 검사가 도는 곳), 하네스 매뉴얼 `docs/work/reference/gates.md`·`testing.md`(각 1줄, 5번). 새 문서 `docs/operations/ci-script-assessment.md`. ## 검증 **main(#13)을 받은 뒤 다시 돌린 것** — head `7cd2d9e8`, 2026-11-11 21:01~21:30, desktop `FEA/c`, workflow CI env, 공유 잠금 아래. 로그 desktop `/tmp/claude-gates/fea-v4/`. 아래층 #14(`568f3328`)의 merge 게이트 14개도 같은 실행에서 돌렸다(#14 본문). | 대상 | 결과 | |---|---| | `9676101a`·`7cd2d9e8` 커밋별 test:unit · check:types · check:ci · lint · verify:documentation | 둘 다 5개 모두 rc=0 | | merge_static(깨끗한 트리): FE-GATE-001·002·003·010·011·012 | 모두 rc=0 | | merge_test(깨끗한 트리): FE-GATE-004·005·006·007·020 | 모두 rc=0 (005 149초, 020 916초) | | merge_test: FE-GATE-013 | rc=1, 1초(호스트 bwrap 조건). 부분 실행: 시스템 vitest 115개 중 18 실패 · 61 통과 · 36 건너뜀(모두 `ci-artifact-contract.test.ts`), verify:reproducible-build · build:release-candidate · verify:local-evidence · check:browser-security rc=0 | | merge_browser(깨끗한 트리): FE-GATE-008·009 | 모두 rc=0 (008 202초) | | main_gate(깨끗한 트리): FE-GATE-029 | rc=0 (26초) | | FE-GATE-017 documentation | rc=0 | 게이트별 결과가 #14(합치기 전, 한 checkout)와 같다. 아래는 main을 받기 전(`c4195bac`까지)의 결과다. 모두 desktop(`~/workspace/clean-architecture-frontend-template-lanes/FEA/c`, 공유 checkout은 건드리지 않음), workflow의 CI env, 공유 잠금 아래. 로그는 desktop `/tmp/claude-gates/fea-prb-2/`(1차 `fea-prb-1/`), `fea-c3/`. **커밋마다** test:unit · check:types · check:ci · lint · verify:documentation | 커밋 | 결과 | |---|---| | `0739f26b` | 5개 모두 rc=0 | | `f6b2b96c` | 5개 모두 rc=0 | | `3ce77d9e` | 5개 모두 rc=0 | | `657afca1` | check:types·check:ci·lint·verify:documentation rc=0. test:unit은 1회 rc=1(시간에 민감한 시험 2개: `http-execution-v3`의 deadline 대기, `indexeddb-runtime`의 가짜 트랜잭션 대기. 이 커밋은 CHANGELOG만 바꾼다). 그때 desktop 부하가 27(12코어)이었다. 같은 커밋의 FE-GATE-005 안 test:unit과 부하가 내려간 뒤 재실행(`fea-c3`)에서 5개 모두 rc=0 | | `c4195bac` (merge) | 5개 모두 rc=0 | **합치기 전후 merge 단계 비교(F1·7.4절)** — 전: PR #14 head(한 checkout에서 게이트를 차례로, `fea-pra-1`·`fea-pra-2`). 후: 이 PR의 `657afca1`을 workflow의 job처럼 돌렸다. job마다 `git clean -fdx`한 트리에서 install 한 번, 그 job의 게이트를 job 순서대로. | 게이트 | 전 | 후 (job) | |---|---|---| | FE-GATE-001 manifest-lockfile | rc=0 | rc=0 (merge_static) | | FE-GATE-002 lint | rc=0 | rc=0 (merge_static) | | FE-GATE-003 typecheck | rc=0 | rc=0 (merge_static) | | FE-GATE-010 architecture | rc=0 | rc=0 (merge_static) | | FE-GATE-011 build | rc=0 | rc=0 (merge_static) | | FE-GATE-012 bundle | rc=0 | rc=0 (merge_static) | | FE-GATE-004 runtime-schema | rc=0 | rc=0 (merge_test) | | FE-GATE-005 unit | rc=0 | rc=0 (merge_test) | | FE-GATE-006 component | rc=0 | rc=0 (merge_test) | | FE-GATE-007 integration | rc=0 | rc=0 (merge_test) | | FE-GATE-013 security | rc=1 (호스트) | rc=1 (호스트, merge_test) | | FE-GATE-020 removability | rc=0 | rc=0 (merge_test) | | FE-GATE-008 e2e | rc=0 | rc=0 (merge_browser) | | FE-GATE-009 accessibility | rc=0 | rc=0 (merge_browser) | | FE-GATE-029 checker-self-tests | (없음, 명령은 각 merge 게이트 안에서 rc=0) | rc=0 (main_gate, 깨끗한 트리에서 26초) | | FE-GATE-017 documentation | rc=0 | rc=0 | 게이트별 결과가 같다. job 시간(부하 있는 desktop): merge_static 약 2.5분, merge_test 약 20분(FE-GATE-020이 16분), merge_browser 약 3.7분, main_gate 0.5분. install은 merge 단계 14번 → 3번. FE-GATE-013은 desktop 호스트가 bwrap user namespace를 막아 사전 점검에서 멈춘다(알려진 호스트 조건). 부분 실행: 시스템 vitest 18 실패/97 통과(모두 `ci-artifact-contract.test.ts` provider 시험, #14·2단계와 같은 수), verify:reproducible-build·build:release-candidate·verify:local-evidence·check:browser-security rc=0. 옮긴 fixture 명령 셋(supply-chain·provider·security)은 FE-GATE-029 안에서 rc=0. 1차 실행(`fea-prb-1`)에서 걸린 것: F2 커밋의 `supply-chain.test.ts`가 보안 fixture 명령을 FE-GATE-013에서 찾음(FE-GATE-029로 고침), F3 문서가 지운 script 이름 `check:types:recipes`를 코드 표기로 적음(`verify:documentation` 실패, 고침), CHANGELOG 리뷰 ID(#14와 같은 원인). push 전에 커밋을 고쳐 다시 쌓았다. ### Gitea Actions **실행 #1**(run_id 54, 2026-11-09 02:29 KST, workflow_dispatch stage=merge, `chore/ci-merge-jobs` `c4195bac`, runner `desktop-runner` 라벨 `ubuntu-latest`): **실패**. 원인은 이 PR이 아니라 repo Actions 변수가 없는 것이다. | job | 시간 | 결과 | |---|---|---| | merge / static checks | 29초 | 게이트 6개가 차례로 돌고 모두 FAIL. 산출물 `merge-static-54` 업로드 | | merge / tests | 28초 | 게이트 6개가 차례로 돌고 모두 FAIL. 산출물 `merge-test-54` 업로드 | | merge / browser tests | 4시간 24분 | 브라우저 설치 중 02:32 desktop 디스크 압박으로 Gitea가 내려가 멈춘 뒤 실패 처리 | - 게이트 로그(산출물): `missing required CI build environment: CI_RUNNER_IMAGE`. workflow가 `CI_RUNNER_IMAGE: ${{ vars.RUNNER_IMAGE_DIGEST }}`를 읽는데 repo 변수가 없다(설정 화면 「아직 변수가 없습니다」). main의 옛 workflow도 같은 줄이라 어느 브랜치든 같다. 값은 `…@sha256:<64자>` 형식이어야 한다(`scripts/lib/build-environment.ts`). - 이 실행으로 확인한 것: workflow가 Gitea 1.27에서 그대로 파싱된다. merge job 셋이 정의대로 시작한다. 게이트마다 `FE-GATE-NNN / <이름>` 단계로 보인다. 앞 게이트가 실패해도 `if: ${{ !cancelled() }}`로 다음 게이트가 모두 돈다(각 job의 게이트 6개가 모두 실행됨). job마다 산출물이 하나씩 올라간다. - 확인하지 못한 것: 게이트 명령이 runner 안에서 통과하는지. 변수를 넣고 디스크 여유를 확보한 뒤 다시 돌려야 한다. **실행 #5**(run_id 81, 2026-11-11, push로 생긴 pull_request 이벤트, head `7cd2d9e8`, runner `desktop-runner` 라벨 `ubuntu-latest`, repo 변수 `RUNNER_IMAGE_DIGEST` 설정 뒤): job 셋 중 둘 성공, 하나 실패. 21:30에 push했고 main run #4(옛 workflow) 뒤에서 29분 기다렸다. 시간은 KST. | job | 시간 | 결과 | |---|---|---| | merge / static checks | 21:59:40~22:02:04 (2분 24초) | 성공. FE-GATE-001·002·003·010·011·012 모두 PASS | | merge / tests | 22:02:04~22:15:04 (13분) | 실패. FE-GATE-004·006·007 PASS, 005·013·020 FAIL(020이 10분) | | merge / browser tests | 22:15:04~22:25:53 (10분 49초, 그중 브라우저 설치 4분) | 성공. FE-GATE-008·009 PASS | | main / checker self-tests | 돌지 않음 | pull_request 이벤트라서다(설계대로, 브랜치 push와 dispatch stage=main에서만) | 실패 셋의 원인(job 산출물 `merge-test-81`의 게이트 로그): - FE-GATE-013: runner 이미지에 `/usr/bin/bwrap`과 systemd manager bus가 없어 `check-system-test-prerequisites.ts`에서 멈춘다. desktop과 같은 부류의 호스트 조건이다. - FE-GATE-005: 3,118개 중 1개 실패. `tests/unit/fixture-node-modules.test.ts` 「pnpm inside a linked fixture (F-4) > installs through the linked directories unless told not to」. 보호 env 없이 돌린 pnpm이 공유 트리에 설치한다는 전제(`changed === true`)가 runner에서 false로 나온다. desktop에서는 통과한다. 원인은 아직 보지 않았다. - FE-GATE-020: drill 사본 안에서 같은 F-4 시험이 4번(test:unit·test:coverage·feature-removal), test:integration에서 `tests/integration/provider-guardian-transaction.test.ts` 「still publishes near the lease deadline when post-processing completes in time」이 1번(시간에 민감한 시험, 그때 desktop 부하 약 20) 실패했다. **같은 runner에서 합치기 전과 비교** — 같은 날 main push로 돈 run #4(run_id 80, `d1b9c087`, 옛 workflow 행렬 14 job, 21:18:05~21:59:37). | | run #4 (main, 14 job) | run #5 (이 PR, 3 job) | |---|---|---| | PASS | 001 002 003 004 006 007 008 009 010 011 012 | 001 002 003 004 006 007 008 009 010 011 012 | | FAIL | 005 013 020 | 005 013 020 | | 실패 원인 | 005·020 같은 F-4 시험(020 안에서 4번), 013 같은 bwrap·systemd 전제 | 같음(020에 시간 시험 1개 더) | | install / 브라우저 설치 | 14번 / 2번 | 3번 / 1번 | | merge 단계 runner 시간 | 41분 32초 | 26분 13초 | 게이트별 결과가 같다. 코드가 다르고(main은 #14 앞) 부하도 달라 시간은 참고만 한다. 실패 셋은 main에서도 같은 원인으로 나므로 이 PR이 만든 것이 아니다. 이 실행으로 더 확인한 것: 게이트 명령이 runner 안에서 실제로 돈다(14개 중 11개 PASS). 005가 실패한 뒤에도 `!cancelled()`로 006·007·013·020이 돌았다. job마다 산출물(`merge-static-81` 2.4MB, `merge-test-81` 0.2MB, `merge-browser-81` 3.3MB)이 올라갔다. ## 리뷰어가 볼 곳 - `scripts/contracts/ci-gates.ts`: job 소유·그래프·단계 표, `gate-sequence`, 기준선 코드 삭제. - `scripts/generate-ci-workflow.ts`: `gate-sequence` 렌더, `main` 조건. `.gitea/workflows/quality-gates.yml`은 생성물이다. - `config/ci/gates.json`: FE-GATE-029와 옮긴 명령·증거. 만든 방법은 python 한 번(명령 id 목록으로 옮기고, 옮긴 명령만 만드는 산출물을 증거에서 함께 옮김). 기준 `c54c3813`. - `scripts/check-ci-gating.ts`: `check-ci-contract.ts`에서 그대로 뗀 ungated 검사. ## 관련 - design-docs `repo-structure/03-ci.md` 3.5·7.3·7.4·7.5절, `repo-structure/README.md` 3.3절 - 정리 3·4단계 PR #14(이 브랜치의 아래층)
donghyeon.kang added 11 commits 2026-11-08 14:26:17 +00:00
음성 타입 fixture마다 옵션이 같은 tsconfig 하나, package script 하나,
게이트 명령 하나가 있었다(23벌). 옵션은 모두 같고 파일 하나만 달라서
fixture를 더할 때마다 세 곳을 같이 고쳤다. `tsconfig.recipes.json`도
`tsconfig.test.json`과 lib가 같고 types만 하나 적었다.
`tsconfig.web-worker.json`은 `files: []`로 0파일을 검사하고 통과했다
(2026-09-25 리뷰가 기록, FE-GATE-003이 통과로 보였다).

고른 방법(design-docs repo-structure/04-frontend-layout.md 5.3절 (가),
소유자 승인 2026-11-07):
- fixture 첫 줄에 기대(`// expect: TS2322`, `// expect: pass`)를 쓰고
  `scripts/check-type-fixtures.ts`가 fixture마다 `.tmp/type-fixtures/`에
  한 파일 tsconfig를 써서 tsc를 돈다. 판정은 run-ci-gate.ts가 명령마다
  하던 것과 같다(exit 1과 `error TS<code>:`). 결과를 fixture별로 출력한다.
  기대 줄이 없는 fixture와 fixture 0개는 실패한다.
- recipes는 `tsconfig.test.json` include로 옮긴다.
- web-worker tsconfig와 script는 지운다(결정 D4). Worker를 들일 때 더하는
  단계는 매뉴얼 03에 쓴다(뒤 커밋).
- `scripts/check-typecheck-inputs.ts`를 `check:types` 끝에 둔다. package
  script가 tsc에 넘기는 tsconfig마다 이 repo 파일이 1개 이상인지 본다.
  `files: []` tsconfig가 통과로 보이던 구멍을 막는다(R8).

버린 것: TypeScript API로 한 프로세스에서 돌리는 방법. 이 repo의
TypeScript 7.0(네이티브판)은 JS API를 싣지 않는다. 위반마다
`@ts-expect-error`를 쓰는 방법(5.3절 (나))은 오류 코드 고정을 잃는다.

위험: recipe가 이제 `vite/client` 타입이 있는 프로그램에서 검사된다.
recipe가 `import.meta.env`를 쓰면 전에는 실패했고 이제는 통과한다
(복사한 제품도 Vite라 가치가 작다, 설계 5.1절). CI 계약 기준선을 다시
받았다(명령 99 → 76).

검증(desktop): `check:types:fixtures` 23개 PASS, 각 fixture의 기대 코드가
출력에 그대로 나온다. `TelemetryPort.emit` 인자를 `string`으로 넓히는
변이(2026-09-25 리뷰 07-05)에서 `invalid-diagnostics-port.ts`가 TS2578로
FAIL, 실행기 rc=1. 되돌린 뒤 작업 트리 0줄. `check:types` rc=0
(Typecheck inputs: app 379, node 312, service-worker 22, test 915).

Refs: design-docs repo-structure/04-frontend-layout.md 5.3·9.2·9.3절, README.md 3.4절 D4
루트 항목 하나를 옮기려면 코드 7곳의 루트 경로 목록을 같이 고쳐야
했다(복사 대상, 비밀값 검사 범위, 공급망 시험의 필수 입력, 이력 문서
검사, 규모 입력, vite 입력, TS 전용 규칙). 서로 다른 부분집합이고 한
곳에서 선언하지 않았다. 목록이 갈라져 공급망 생성이 깨진 적도 있다
(removal-fixture.ts 주석). 루트에는 JSON Schema 5개만 담은 `schemas/`가
`config/` 옆에 따로 있었다. `artifacts/`(출력 폴더)에는 사람이 쓴 수동
a11y 기록이, `config/hosting/`(호스트 계약)에는 시험 fixture가 섞였다.

고른 방법(design-docs repo-structure/04-frontend-layout.md 9.2절 3단계,
11절 R1·R2, 소유자 승인 2026-11-07):
- `config/repository-layout.json`이 루트 항목마다 종류·역할·읽는 곳과
  들어가는 목록(`sets`, 항목 안 경로는 `setPaths`)을 적는다.
  `scripts/lib/repository-layout.ts`가 읽고 검증한다. 6곳은 이름 붙은
  집합을 고른다. JSON인 비밀값 검사 정책은 집합의 사본을 두고 시험이
  같은지 본다(정책 파일은 릴리스 후보에 실려 형식을 바꾸지 않았다).
  공급망 시험의 필수 입력 목록은 그 시험으로 대신한다.
- `tests/unit/repository-layout.test.ts`: 등록부에 없는 루트 항목이
  추적되면 실패(R1). 7곳이 등록부 모듈을 쓰고 루트 이름 둘 이상의
  문자열 배열을 갖지 않는지(R2).
- `schemas/artifacts/` → `config/schemas/artifacts/`, recipe 카탈로그
  스키마 → `config/schemas/recipes/`. 정책 입력 순서(ASCII)에 맞춰
  `config/schemas/`가 `config/security/` 앞에 온다.
- 수동 a11y 기록 3개 → `docs/accessibility/route-reviews/`. `artifacts/`는
  `.gitkeep`만 추적한다. 기록은 단위 시험이 읽어서 drill 사본에도
  복사한다(`fixture-copy` 집합의 `docs/accessibility/route-reviews`).
- `config/hosting/response-headers.fixture.json` →
  `tests/fixtures/hosting/response-headers.json`.

버린 것: 비밀값 검사 정책이 집합 이름을 참조하게 바꾸는 방법. 정책
파일은 릴리스 후보와 로컬 증거 평가가 읽는 형식이라 바꾸면 릴리스
증거 계약이 바뀐다. 루트 항목이 지워졌는데 등록부에 남는 경우는
시험하지 않았다. drill 사본은 일부만 복사해 그 방향을 볼 수 없다.
그런 항목은 그 집합을 쓰는 곳(복사, 비밀값 검사)에서 실패한다.

위험: 하네스 작업(fe-c)이 더할 `AGENTS.md`·`.claude/`를 미리 등록했다
(optional). 등록부가 이력 문서(`SPEC.md`)와 `CLAUDE.md` 이름을 적어서
이력 문서 검사에서 등록부 파일은 뺐다. 다운스트림은 자기 루트 항목을
등록부에 더해야 한다(CHANGELOG). CI 계약 기준선을 다시 받았다(a11y
기록 산출물 id·경로).

검증(desktop): 아래 4단계 커밋까지 쌓은 트리에서 test:unit,
check:types, check:ci, lint, verify:documentation을 돌렸다(그 커밋에
적음). 이 커밋 단독으로 test:unit·check:ci·check:types를 돌렸다.

Refs: design-docs repo-structure/04-frontend-layout.md 2.4·9.2·11절, README.md 3.4절
소유자가 2026-11-07에 지적한 것(매뉴얼이 생긴 뒤에도 남은 샘플, 역할이
겹치는 루트 폴더, 0파일 검사, 문서 속 인프라 설정)은 매뉴얼과 리뷰가
먼저 잡아야 했다. 지금은 그 규칙이 글로도 검사로도 없다. 그래서 같은
지적이 다시 나와도 게이트가 모른다.

고른 방법(design-docs repo-structure/04-frontend-layout.md 11절, 기계
검사가 「예」인 규칙을 표의 게이트 칸대로):
- R4·R5 `tests/unit/example-feature-rules.test.ts`(FE-GATE-005): 샘플
  목록은 FE-GATE-020의 `test:sample-removal`(인자 없이, 빌드와 test:all
  포함)이 증명한다. 목록 샘플의 기능 ID·라우트가 visual·e2e의 `goto`,
  gates.json 산출물 경로, `config/scale/`에 나오면 실패한다. 템플릿
  목록은 비어 있어 가짜 샘플로 판정 함수를 시험한다.
- R6·R7(문서) `verify:documentation`(FE-GATE-017): `docs/manual/`이 목록
  샘플 경로를 가리키면, 현재 문서에 ```nginx```·```hcl``` 블록이나
  `kind: Deployment` 같은 매니페스트 줄이 있으면 실패한다. 이력 폴더는
  보지 않는다. 산출물 `documentation-review.json`에
  `layoutRuleViolations`를 더했다.
- R7(파일)·R9 `tests/unit/repository-layout.test.ts`(FE-GATE-005):
  nginx·Terraform·Helm·Kustomize 파일과 Kubernetes 매니페스트 YAML이
  추적되면 실패. 옵션이 같은 tsconfig 쌍이 있으면 실패.
- R3은 `tests/unit/tracked-artifacts.test.ts`, R8은 앞 커밋의
  `check-typecheck-inputs.ts`·`check-type-fixtures.ts`가 맡는다. R10의
  기계 몫(루트 *.md 등록)은 R1이다.
- 매뉴얼 03에 E절(R1~R10 규칙과 검사, 루트 항목을 더하는 순서)과 C절
  「Web Worker를 들일 때 tsconfig 더하기」(결정 D4)를 더했다.

위험: R5는 문자열 검색이라 샘플 ID를 다르게 쓴 대상(예: 라우트 경로를
조립하는 spec)은 놓친다. R7 문서 검사는 코드 블록 언어 태그와 매니페스트
줄로만 본다. R13(리뷰 가이드)은 design-docs 몫이라 넣지 않았다.

검증(desktop): 이 커밋에서 test:unit, check:types, check:ci, lint,
verify:documentation, check:architecture를 돌렸다.

Refs: design-docs repo-structure/04-frontend-layout.md 11절, README.md 3.4절
정리 단계 미출시 절에 3단계(합치기)와 4단계(배치 규칙 검사)를
더한다. 다운스트림이 할 일 7~12(음성 타입 fixture 기대 줄, 지운
tsconfig, a11y 기록과 스키마 이동, 루트 등록부, CI 계약 기준선)와 계약
표 세 줄, 알려진 제한 둘(R2가 보는 범위, R5의 문자열 검색)을 적었다.

위험: 다운스트림에 적용해 보지 않았다(절의 알려진 제한과 같다).

검증(desktop): `tests/unit/changelog-review-ids.test.ts`를 포함한
test:unit.

Refs: design-docs repo-structure/04-frontend-layout.md 9.2절
merge 단계가 게이트마다 job 하나(행렬 14개)라서 PR마다 checkout,
setup-node, `pnpm install`을 14번 하고 브라우저 설치를 2번 한다. Gitea
runner는 소유자 기계 한 대다. 사례(Vite 등)는 설치를 job당 한 번으로
묶는다(design-docs repo-structure/03-ci.md 3.5절).

고른 방법(03-ci.md 7.3절 F1, 소유자 승인 2026-11-07):
- job 종류 `gate-sequence`를 더한다. job 하나가 게이트 여럿을 차례로
  돈다. 게이트마다 `FE-GATE-NNN / <이름>` 단계이고 `if: !cancelled()`라
  앞 게이트가 실패해도 다음 게이트가 돈다(행렬의 fail-fast: false와 같다).
- merge job 셋: `merge_static`(001·002·003·010·011·012, 소스를 읽고
  빌드하는 검사), `merge_test`(004·005·006·007·013·020, 시험),
  `merge_browser`(008·009, 브라우저 설치). release 단계는 셋을 모두
  기다린다. 게이트 id·명령·증거·승격 공식은 그대로다.
- 증거 업로드는 job마다 하나(`merge-static-<run>` 등)다.

버린 것: 행렬을 두고 `pnpm install`만 캐시하는 방법. runner 한 대에서는
job 수만큼 checkout과 준비가 남는다. 게이트를 job 하나에 모두 넣는
방법은 브라우저 설치를 모든 게이트가 기다린다.

위험: 한 job 안의 게이트가 같은 작업 공간을 쓴다. 앞 게이트의 산출물이
뒤 게이트에 남는다. desktop의 merge 단계 실행(게이트를 한 checkout에서
차례로 도는 것)과 같은 조건이라 그 결과로 확인했다. 실제 Gitea runner의
`!cancelled()` 해석은 Actions를 켠 뒤 확인한다.

검증(desktop): check:ci, check:types, CI 시험 4파일 통과. 합치기
전후 merge 단계 게이트별 결과 비교는 PR 본문에 적는다.

Refs: design-docs repo-structure/03-ci.md 3.5·7.3·7.4절, README.md 3.3절
`docs/README.md` 표가 수동 a11y 기록을 아직 `artifacts/tests/a11y-manual/`로
가리킨다. 기록은 `docs/accessibility/route-reviews/`로 옮겼다(79dc945a).
`verify:documentation`은 `.gitignore`가 무시하는 경로를 생성 출력으로 보고
넘겨서 이 줄을 잡지 못했다.

검증(desktop): verify:documentation, test:unit.
merge 단계(=PR)가 변경이 아니라 검사기 자신을 시험하는 명령까지 돈다.
검사기가 나쁜 입력을 거부하는지 보는 `*:fixture` 명령 15개, 모든 시험
파일과 검증 script가 게이트에 걸렸는지 보는 ungated 검사, CI 계약의
개수·해시 기준선(`config/ci/contract-baseline.json`)이다. 기준선은 게이트
명령 하나를 더하거나 빼도 OWNER·REASON을 붙여 다시 받아야 했다.
소유자 결정(2026-09-16)은 개수·배선 검사를 main 단계에 두는 것이다.

고른 방법(design-docs repo-structure/03-ci.md 7.3절 F2, README.md 3.3절,
소유자 승인 2026-11-07):
- 새 게이트 FE-GATE-029 `checker-self-tests`, 새 단계 `main`
  (`MAIN_READY`, 승격을 막지 않는다), 새 job `main_gate`. 브랜치 push와
  `workflow_dispatch`(stage=main)에서만 돈다. PR과 태그에서는 돌지 않는다.
- FE-GATE-001·005·008·010·013의 `*:fixture` 명령 15개와 그 증거
  산출물 10개를 FE-GATE-029로 옮긴다.
- `check:ci`의 ungated 검사를 `scripts/check-ci-gating.ts`
  (`check:ci:gating`)로 떼어 FE-GATE-029에 둔다. `check:ci`는 계약·
  workflow 검사만 PR에서 돈다.
- 기준선 파일, `update:ci-contract-baseline`, 그 검사를 지운다(소유자
  결정). 계약 모양은 ci-gates.ts의 의미 검사가 지킨다. 개수를 고정하던
  단위 시험의 개수 단언도 뺐다.

남긴 것: 음성 타입 fixture(`check:types:fixtures`, FE-GATE-003)는
이름이 `*:fixture`여도 merge에 둔다. 검사기가 아니라 src의 포트·계약
타입을 시험한다. `TelemetryPort.emit`을 넓히는 변경을 PR에서 막는다(정리
3단계 9.3절 변이로 확인). merge 단계 명령 참조 64 → 49.

위험: 검사기를 망가뜨린 PR은 merge를 통과하고 main에서 빨개진다. 그
대가로 PR이 검사기 자기 시험을 기다리지 않는다(설계 7.5절의 같은 교환).
FE-GATE-029의 명령이 앞 게이트 산출물 없이 새 checkout에서 도는지는
desktop에서 따로 확인했다(PR 본문).

검증(desktop): check:ci, check:ci:gating, check:types, CI 시험 통과.
merge 단계·FE-GATE-029 실행 결과는 PR 본문에 적는다.

Refs: design-docs repo-structure/03-ci.md 7.3·7.4절, README.md 3.3절
scripts/check-*.ts 30개(6,351줄)가 게이트 명령의 상당수를 차지한다.
각각을 ESLint 규칙, dependency-cruiser 규칙, vitest 시험으로 옮길 수
있는지 판정 표로 남긴다(design-docs repo-structure/03-ci.md 7.3절 F3).
코드는 바꾸지 않는다.

판정: 시험 8, 일부 이전 9, 스크립트 유지 11, ESLint 규칙 1, 지움 1
(정리 3단계). 위험이 낮고 효과가 큰 후보 5개와, 옮길 때 같이 고칠
증거 계약·drill 목록을 적었다.

위험: 줄 번호는 판정 시점 `ad3a071f` 기준이다. 판정 중에 찾은 가짜 검사
2개(`check-design-system.ts`, `check-diagnostics.ts`의 fixture 표식 검사)는
고치지 않았다.

검증: 문서만. 스크립트를 읽어 판정했고 실행하지 않았다.

Refs: design-docs repo-structure/03-ci.md 7.3절 F3
정리 단계 미출시 절에 CI 재편(merge job 셋, main 단계 FE-GATE-029,
계약 기준선 삭제, F3 판정 표)을 더한다. 다운스트림이 할 일 13·14(기준선
파일 삭제, merge job 이름과 필수 검사), 옮긴 뒤 확인 한 줄, 계약 표 두
줄, 알려진 제한 한 줄(Gitea runner 실행 미확인)을 적었다.

위험: 다운스트림에 적용해 보지 않았다.

검증(desktop): changelog-review-ids를 포함한 test:unit.

Refs: design-docs repo-structure/03-ci.md 7.3절
하네스 PR(#13)이 루트에 `.gitattributes`(작업 장부 파일의 병합 규칙)를
더한다. 이 PR이 먼저 들어가고 그 PR이 나중에 들어가면 등록부에 없는
루트 항목이 생겨 `tests/unit/repository-layout.test.ts`(R1)가 실패한다.
`AGENTS.md`·`.claude`처럼 optional 항목으로 미리 적는다. 없으면 고르는
집합이 없어 다른 검사에 영향이 없다.

검증(desktop): test:unit, check:ci, verify:documentation.
PR B는 정리 3·4단계 브랜치(chore/layout-3-merge) 위에 쌓았다. 그 브랜치에
더한 커밋 16eb200f(하네스가 더할 .gitattributes를 등록부에 optional로
적음)를 받는다. PR B 커밋은 다시 쌓지 않아 CHANGELOG의 해시가 그대로다.
donghyeon.kang added 3 commits 2026-11-11 12:30:39 +00:00
chore(merge): 하네스 PR #13이 들어간 main을 받는다
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (pull_request) Successful in 1m20s
frontend-quality-gates / FE-GATE-002 / lint (pull_request) Successful in 1m13s
frontend-quality-gates / FE-GATE-003 / typecheck (pull_request) Successful in 1m2s
frontend-quality-gates / FE-GATE-004 / runtime-schema (pull_request) Successful in 1m4s
frontend-quality-gates / FE-GATE-005 / unit (pull_request) Failing after 2m13s
frontend-quality-gates / FE-GATE-006 / component (pull_request) Successful in 1m12s
frontend-quality-gates / FE-GATE-007 / integration (pull_request) Successful in 1m17s
frontend-quality-gates / FE-GATE-010 / architecture (pull_request) Successful in 1m38s
frontend-quality-gates / FE-GATE-011 / build (pull_request) Successful in 57s
frontend-quality-gates / FE-GATE-012 / bundle (pull_request) Successful in 53s
frontend-quality-gates / FE-GATE-013 / security (pull_request) Failing after 36s
frontend-quality-gates / FE-GATE-020 / removability (pull_request) Failing after 12m49s
frontend-quality-gates / FE-GATE-008 / e2e (pull_request) Successful in 9m9s
frontend-quality-gates / FE-GATE-009 / accessibility (pull_request) Failing after 6m43s
frontend-quality-gates / FE-GATE-017 / diagram-review (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
568f332892
main(d1b9c087)에 하네스 PR #13이 들어가 루트에 `AGENTS.md`, `.claude/`,
`.gitattributes`가 생겼다. 이 브랜치는 그 셋을 루트 등록부에 optional로
미리 적어 두었다.

충돌 둘을 풀었다.
- `scripts/lib/removal-fixture.ts`: main은 문서 복사 목록에 `AGENTS.md`를
  더했고 이 브랜치는 그 목록을 등록부의 `fixture-documents` 집합으로
  바꿨다. 등록부의 `AGENTS.md` 항목에 그 집합을 적었다.
- `tests/unit/template-feature-removal-documents.test.ts`: main은 문서
  목록에 `AGENTS.md`와 옛 a11y 기록 폴더를 더했다. a11y 기록은 이
  브랜치에서 `docs/`로 옮겼으므로 `AGENTS.md`만 남겼다.

등록부의 `AGENTS.md`·`.claude`·`.gitattributes`는 이제 추적되는 항목이라
optional을 빼고 역할을 실제 내용으로 고쳤다. 추적되는 루트 항목과
등록부 항목이 서로 남는 것 없이 같다.

검증(desktop): 커밋별 5검사와 merge 게이트 14개, verify:documentation.
PR #16은 PR #14(chore/layout-3-merge) 위에 쌓았다. #14가 하네스 PR #13이
들어간 main을 합친 커밋(568f3328)을 받는다. 충돌은 없었다.
docs(work): ungated 검사가 도는 곳을 check:ci:gating으로 고친다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m23s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 10m49s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (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
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / merge / tests (pull_request) Failing after 12m59s
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-provenance-provider (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
7cd2d9e89b
main에 들어온 하네스 매뉴얼(docs/work/reference/gates.md, testing.md)이
「새 script·시험 파일이 게이트에 안 걸리면 check:ci가 실패한다」고 적는다.
이 PR의 f6b2b96c가 그 검사를 check:ci에서 떼어 main 단계 FE-GATE-029의
check:ci:gating으로 옮겼다. 두 줄과 생성기 주석 한 줄(merge_gate)을
고친다. 하네스 작업은 끝났고(PR #13 병합) 옮긴 명령을 가리키는 줄만
고쳤다.

검증(desktop): verify:documentation, test:unit.
donghyeon.kang merged commit 38c0dc7dbf into main 2026-11-11 13:36:14 +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#16