e2bf08e9ea8938c923b05ff13554d5647c124a1b
1235
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
e2bf08e9ea |
docs(changelog): PR #19 이어받은 커밋들을 미출시 절에 적는다
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-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (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 / checker self-tests (pull_request) Canceled after 0s
|
||
|
|
37a850040d |
test(http): deadline 분류 시험이 대기 지점에서 가짜 시계로 deadline을 낸다
문제: 「times out at the <phase> wait when the deadline fires」가 실제 시계로 30ms deadline을 잡는다. 전송 실패(transport backoff)나 503 (retry backoff)을 처리하는 시점에 이미 30ms가 지났으면 실행기는 backoff할 시간이 없다고 보고 그 실패로 끝낸다(`remaining() > 0`이 거짓). 그래서 기대한 TIMEOUT 대신 NETWORK_FAILURE·503 결과가 나온다. desktop 부하 31에서 한 번 떨어졌다(PR #19 W2-FE 기록 F). 고른 방법: deadline 경우만 가짜 시계(`vi.useFakeTimers`)로 돌고, 그 대기에 닿은 것을 확인한 뒤 30ms를 진행한다. 시험이 보려는 것(대기 중에 deadline이 나면 DEADLINE·TIMEOUT)을 그대로 보고 기계 속도에는 기대지 않는다. 두 backoff 단계는 답하기 전에 실제 시간 40ms를 멈춘다 (`Atomics.wait`). 실제 시계로 되돌리면 이 시험이 매번 실패한다. - 버린 대안: deadline을 늘리기. 경쟁이 남고 규칙 밖이다. - 버린 대안: `vi.waitFor`로 기다리기. 가짜 시계에서는 확인할 때마다 시계를 진행해 대기에 닿기 전에 deadline이 날 수 있다. 위험·한계: 실행기 동작은 바꾸지 않았다. deadline이 이미 지난 뒤 도착한 전송 실패를 NETWORK_FAILURE로 보고하는 것이 맞는지는 이 커밋이 정하지 않는다. 검증(desktop): 시험 파일 72개 3회 연속 통과. 변이: 가짜 시계를 빼고 실제 30ms deadline에 같은 40ms 멈춤을 두면 transport backoff·retry backoff 둘이 매번 실패(나머지 넷 통과). eslint·check:types rc=0. 로그 /tmp/claude-gates/w2fe2-http1·2/. |
||
|
|
f805203702 |
docs(ledger): W2-FE 실측과 PR #19 이어받기 예측을 남긴다
W2-FE 세션의 실측을 세션 기록에서 다시 세어 적는다(인계 절의 값은 20:40 기준이라 그 뒤 기록이 빠져 있었다). 이어받는 세션의 예측도 같이 적는다. 근거는 줄 안의 basis다. |
||
|
|
198e9856f6 |
test(schemas): 스키마 생성 시험이 fsync 없는 writer로 임시 폴더에 쓴다
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 / 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-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (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
문제: json-schema 시험 「generates deterministic … detects drift」가 임시 폴더에 스키마 넷을 쓸 때 파일과 폴더를 fsync한다. 이 시험의 대부분이 fsync이고, 디스크가 바쁘면 시간이 크게 뛴다(desktop 89~1,075ms, CPU를 제한한 coverage 측정에서 7.4초). 이 시험은 생성한 바이트와 drift 판정을 보고, 내구성은 validated-json-artifact 시험이 본다. 기본 timeout 10초 아래라 자기 timeout도 없다. 고른 방법: `generateArtifactSchemas`가 writer를 받는다(기본은 지금의 `writeValidatedJsonArtifact`). 시험은 같은 검증·원자적 rename writer를 `createValidatedJsonArtifactWriter`로 만들고 sync만 뺀다. - 버린 대안: 시험에 timeout 선언. 시간을 줄이지 않고 흔들림을 덮는다. 위험·한계: 생성 명령과 check:artifact-schemas의 쓰기는 그대로다. 검증(desktop, 고치기 전·후 번갈아 3회, 부하 11~16): 89/1,075/98 → 36/48/35ms. coverage + CPU 소모 12개에서도 208~519 → 73~151ms. 시험 통과, check:artifact-schemas rc=0, check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-slow2·6/. |
||
|
|
0bb1f0afc0 |
perf(coverage): 위험 커버리지 모듈 목록을 Babel 파서와 동기 fs로 만든다
문제: `buildProductionModuleInventory`가 `src/` 모듈 375개를 하나씩 `@babel/eslint-parser`로 읽고, 파일마다 lstat→realpath→open→stat→ read→close 여섯 비동기 호출을 차례로 기다린다. runner에서 이 목록을 만드는 시험(「historical 14-file summary」)이 unit 8.2초·coverage 9.8초였다(run 113). check:risk-coverage도 같은 목록을 만든다. 고른 방법: - 파서: @babel/core `parseSync`(babelrc·configFile 끔)로 Babel AST를 읽는다. eslint-parser는 같은 파서를 돈 뒤 트리와 토큰 전체를 ESTree로 바꾼다. 여기서 보는 최상위 문장의 type·declare·const·importKind· declaration·body는 두 트리에서 같다. repo 모듈 375개 전부에서 두 파서의 문장 모양을 대조해 차이 0을 확인했다. 시간 845 → 305ms. `scripts/check-architecture.ts`가 같은 방식을 이미 쓴다. - fs: 기본 구현이 같은 호출을 같은 순서로 동기로 한다. 부하가 큰 기계에서는 호출마다 thread pool을 거쳐 event loop 차례를 기다리는 시간이 일보다 컸다. 주입하는 fs(경쟁 시험용)는 그대로 async다. symlink·파일 바꿔치기 검사와 오류 순서는 바뀌지 않는다. - 버린 대안: 파일을 병렬로 처리하기. 대기는 줄지만 여러 파일이 잘못됐을 때 어느 오류를 내는지가 달라진다. 시험 timeout 늘리기는 규칙 밖이다. 위험·한계: 목록을 만드는 동안 event loop를 잡는다(desktop 약 0.7초). gate CLI와 시험만 부른다. 검증(desktop, 같은 세션에서 고치기 전·후를 번갈아 3회): - 부하 11~12: 그 시험 1,913/1,420/1,938 → 715/642/742ms. - coverage + CPU 소모 프로세스 12개(부하 6~16): 8,033/8,493/10,347 → 4,703/5,039/6,121ms. - risk-coverage·risk-coverage-files 시험 47개 통과, check:coverage:fixture는 전처럼 기준 미달로 rc=1, check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-slow3·5·6/, w2fe2-parse1/. |
||
|
|
543518ad2a |
fix(coverage): coverage 대상 패턴을 저장소 루트에 고정한다
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-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (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 / checker self-tests (pull_request) Canceled after 0s
문제: vitest는 coverage include·exclude를 모듈의 절대 경로에 picomatch
`contains: true`로 맞춘다. 그래서 `src/**/*.{ts,tsx}`가 경로 어디에서나
맞는다. checkout이 이름이 `src`로 끝나는 폴더(`~/work/app-src/`)에
있으면 `vite.config.ts`·`scripts/**` 같은 루트 파일이 coverage에 들어가
risk-coverage가 저장소 목록 밖의 행으로 실패한다(tech-log 동기화 때
desktop에서 본 일). CI 경로에는 `src`가 없어 runner에서는 안 보였다.
고른 방법: `scripts/lib/coverage-scope.ts`의 `rootAnchoredGlobs`가
패턴 앞에 루트를 붙인다. 루트는 vitest의 glob 라이브러리(tinyglobby
0.2)가 cwd를 escape하는 식 그대로 escape해, 괄호 같은 glob 문자가 든
루트도 자기 자신에만 맞고 안 불린 파일 glob도 `src/...`로 풀린다.
`vitest.config.ts`와 `check:v8-coverage-counter-semantics`의 자식
설정이 이 함수를 쓴다.
- 막는 시험: counter-semantics 검사가 fixture를
`checkout (copy)-src/` 아래로 복사하고, fixture 시험이 `src/` 밖
모듈(`outside-src.ts`)도 불러온다. 고정이 빠지면 그 모듈이 행으로
들어와 행 집합 검사가 실패한다. 이 검사는 test:coverage 첫 단계에서
이미 자식 vitest를 띄우므로 프로세스가 늘지 않는다. 단위 시험은
repo 설정의 모든 패턴이 루트로 시작하는지와 escape를 본다.
- 버린 대안: picomatch로 vitest의 판정을 흉내 내는 단위 시험. 직접
의존성이 아니고, vitest가 옵션을 바꾸면 거짓 통과한다.
위험·한계: Windows 루트는 `/`로 바꾼 뒤 같은 식으로 escape한다.
올바른 Windows 경로에서는 tinyglobby의 Windows escape와 결과가 같다고
보았지만 Windows에서 돌려 보지는 않았다.
검증(desktop): coverage-scope·v8-coverage-counter-semantics 시험 통과,
check:v8-coverage-counter-semantics rc=0. 변이: 자식 설정을 예전
`["src/**/*.ts"]`로 되돌리면 같은 검사가 `additional: outside-src.ts`로
rc=1. check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-cov1/.
|
||
|
|
2f5eb2b4a5 |
ci(workflow): 같은 PR·브랜치의 새 push가 앞 run을 취소한다
문제: runner가 하나(capacity 1)인데 PR에 push할 때마다 run이 하나씩 쌓인다. 낡은 head의 run이 runner를 25분씩 잡아 새 head와 백엔드 run이 뒤로 밀린다. 고른 방법: workflow에 concurrency를 둔다. group은 `frontend-quality-gates-<event>-<ref>-<stage>`다. PR run의 ref는 `refs/pull/<번호>/head`라 PR마다 group 하나, branch push는 branch마다 하나, release tag는 tag마다 하나다. cancel-in-progress는 수동 실행만 거짓이다. Gitea 1.27.0은 group과 cancel-in-progress를 서버에서 식으로 계산하고(`services/actions/concurrency.go`, `inputs` 포함), 같은 group의 앞 run을 대기 중이면 언제나, 실행 중이면 cancel-in-progress가 참일 때 취소한다. - 수동 실행에 stage를 group에 넣고 취소를 끈 이유: 다음 수동 실행이 검증과 승격 사이의 release run을 끊지 않게 한다. - 버린 대안: 백엔드처럼 event·ref만으로 group을 짓기. 프론트는 수동 실행 하나가 stage 여섯을 받아, 다른 stage의 수동 실행끼리 취소된다. 위험·한계: 실제 취소는 runner에서 push 두 번으로 확인해야 한다(다음 커밋들의 PR run으로 남긴다). 이 커밋 전에 만들어진 대기 run은 group이 없어 취소되지 않는다. 검증(desktop): generate:ci-workflow, ci-workflow-generation 시험 파일 전부 통과(스냅샷 갱신 포함), check:ci-workflow rc=0, check:types rc=0, eslint rc=0. 로그 /tmp/claude-gates/w2fe2-gen1/, w2fe2-cov1/. |
||
|
|
ba72b86595 |
chore(merge): FE-GATE-013 판정·시험 timeout PR들이 들어간 main을 받는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m7s
frontend-quality-gates / merge / tests (pull_request) Successful in 20m56s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m56s
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
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
main( |
||
|
|
f6e2560e4d |
docs: FE-GATE-013이 시스템 컨테이너에서 도는 것을 지침과 운영 문서에 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m49s
frontend-quality-gates / merge / tests (pull_request) Successful in 22m18s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m54s
frontend-quality-gates / FE-GATE-014 / config-compatibility (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-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (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-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
문제: 작업 매뉴얼·루트 지침·스킬이 「desktop의 FE-GATE-013은 호스트 제약
실패로 적고 merge 가능 여부는 소유자가 정한다(결정 대기 D8)」라고 적고
있다.
|
||
|
|
f90ffb6c9a |
fix(tests): provider 기준 사본이 .claude 아래 추적 파일을 함께 복사한다
문제: tests/system의 provider 기준 사본은 `.git`을 함께 복사하면서 `.claude` 폴더를 통째로 뺀다(노트북 checkout의 `.claude/worktrees/`를 피하려고). 2026-11-08 하네스가 `.claude/` 아래에 agents·rules·skills를 추적 파일로 더한 뒤로, 사본의 `git ls-files`가 그 파일을 말하는데 디스크에 없어 공급망 생성이 `ENOENT ... .claude/agents/arch-reviewer.md`로 멈춘다. FE-GATE-013이 어디서도 끝까지 돈 적이 없어(runner는 사전 점검, desktop은 userns에서 멈춤) 드러나지 않았다. 시스템 컨테이너에서 처음 끝까지 돌자 provider 시험 18개가 이것으로 실패했다. 고른 방법: 빼는 것을 저장소 루트 기준 경로로 바꾸고 `.claude` 대신 `.claude/worktrees`만 뺀다. `.git`을 복사하지 않는 다른 빌드 사본 (e2e fixture-builds·service-worker-builds, run-output-root-build)은 그대로 둔다. 위험·한계: 다른 checkout을 품는 새 폴더가 생기면 이 목록에 더해야 한다. 검증: desktop 묶음(w2fe-p4)에서 scripts/verify.sh gate FE-GATE-013. |
||
|
|
35b60a049a |
fix(tests): 드릴 경로 시험이 선택 recipe를 지운 사본에서도 통과한다
문제: b4210753이 더한 removal-drill-test-paths 시험과 고친
feature-scaffold-drill 시험이 test:recipes가 있다고 가정한다. FE-GATE-020의
optional-recipe-removal 드릴은 recipe를 지운 사본에서 test:all을 돌고,
그 사본의 package.json에는 test:recipes가 없어 두 시험이 실패한다
(desktop merge 단계,
|
||
|
|
5250ff950e |
Merge pull request 'test(setup): 자식 프로세스 시험 timeout을 잰 값으로 정하고 흔들리던 시험 둘을 고친다' (#22) from fix/child-process-test-timeouts into main
frontend-quality-gates / main / checker self-tests (push) Successful in 56s
frontend-quality-gates / merge / static checks (push) Successful in 2m12s
frontend-quality-gates / merge / browser tests (push) Successful in 8m23s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / merge / tests (push) Failing after 12m24s
|
||
|
|
a593feb252 |
docs(changelog): 자식 프로세스 시험 timeout과 흔들리던 시험 둘의 고침을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m37s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m15s
frontend-quality-gates / merge / browser tests (pull_request) Failing after 7m3s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (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
정리 단계 절에 이 브랜치의 범위를 넣었다. 먼저 할 일 17을 더했다: 기본 timeout인 Vitest 시험이 자식 프로세스를 띄우면 실패하니, 다운스트림은 자기 시험에 childProcessTimeout(<잰 ms>)을 준다. 옮긴 뒤 확인 1에는 test:integration과 17단계를 더했다. 계약 표 한 줄과, 그 밖의 수정에 guardian lease 고침과 archive 시험의 임시 파일 경합 고침을 한 줄씩 적었다. 검증(desktop): verify:documentation, test:unit. |
||
|
|
db4c632d53 |
test(archive): 다른 시험이 쓰는 중인 임시 파일은 사본에 복사하지 않는다
tests/integration/security-followup-archive.test.ts는 후보 빌드에 쓸 증거를 얻으려고 checkout의 artifacts/를 통째로 사본에 복사한다. 같은 integration 실행에서 tests/integration/http-scenario-catalog.test.ts가 artifacts/tests/http-scenario-executions.json을 임시 파일에 쓰고 rename한다. 복사가 목록을 읽은 뒤 그 임시 파일이 rename되면 ENOENT로 실패한다. desktop FE-GATE-007(2026-11-12, load 9)에서 났다. 복사 filter가 원자적 쓰기의 임시 파일(.<이름>.<무작위>.tmp)을 건너뛴다. 그런 파일은 쓰는 중이라 증거가 아니다. fs.cp는 filter를 stat보다 먼저 부르므로, 건너뛴 파일은 사라져도 오류가 없다. 버린 것: - 필요한 증거 경로만 복사: 공급망 생성이 추적 파일(artifacts의 .gitkeep 포함)을 모두 lstat하고 build가 읽는 증거가 여러 곳이라, 목록을 따로 관리해야 한다. - 두 시험을 같이 돌지 않게 하기: integration 층 전체를 직렬로 돌려야 한다. 위험: 임시 파일이 아닌 파일을 다른 시험이 지우는 경합은 남는다. 지금 artifacts/ 아래에서 그렇게 하는 시험은 찾지 못했다. 검증(desktop): - 다른 프로세스가 artifacts/tests에 임시 파일 10개를 계속 만들고 rename하는 동안 이 시험을 돌렸다. main 6b4f703c는 3회 중 2회가 같은 ENOENT(.tmp)로 실패했고, 이 커밋은 3회 모두 통과했다. - test:unit, check:types, check:ci, lint, verify:documentation. |
||
|
|
77c01b03c1 |
test(guardian): lease가 시험 대상이 아니면 시험 timeout만큼 준다
tests/integration/provider-guardian-transaction.test.ts가 부하 때 lease
만료로 실패한다. guardian이 스스로 SIGKILL한 것이다. desktop 기록 둘:
- FE-GATE-007: 「still publishes near the lease deadline」
- FE-GATE-020 drill: 「owns raw and sealed publication through the
authenticated client lease」
FE-B 실행에서도 load 28에 같은 실패가 2건 났다. 다시 돌리면 통과한다.
원인은 두 가지다.
- startProviderGuardian은 guardian을 띄우자마자 절대 deadline
(Date.now() + leaseMs)을 찍는다. 그래서 client 경로 시험의 2~3초
lease가 node 시작 시간까지 낸다. 부하 때 시작에는 상한이 없다.
- 직접 프로토콜 시험은 guardian이 load를 마친 뒤 가드를 보낸다
(
|
||
|
|
91962e24e3 |
test(setup): 자식 프로세스를 띄우는 시험이 잰 시간으로 timeout을 정한다
자식 프로세스를 띄우는 Vitest 시험 91개(24파일)가 기본 timeout 10초에 기대고 있었다. 셋은 FE-GATE-013에서만 도는 tests/system 시험이다. 기본값은 프로세스 안에서 도는 시험에 맞춘 값이다. 부하가 높은 desktop에서는 자식 프로세스 시험이 평소보다 크게 느려진다. FE-GATE-020 drill 사본에서 평소 0.4~1.2초인 문서 시험이 10.6초 걸려 실패했다(2026-11-12). 가장 위험한 것은 tests/architecture/app-build-input .test.ts로, desktop에서 이미 5.7초까지 걸렸다. 무엇을 고칠지는 desktop 계측으로 정했다. - test:coverage 묶음(maxWorkers=4)과 test:unit을 세 번씩 돌렸다. 시험마다 띄운 자식 프로세스는 child_process 함수를 감싸 기록했고, 소요 시간은 JSON reporter로 받았다. - 시험마다 실제 timeout은 task.timeout으로 기록했다. - 자식 프로세스를 띄우는 시험 140개 중 88개가 기본값이었다. tests/system은 그 묶음에 없어서, 아래 검사가 잡은 셋을 따로 세 번 쟀다. 고친 것: - tests/helpers/child-process-timeout.ts의 childProcessTimeout(<잰 최대 ms>)는 그 15배를 30초 단위로 올린 값이다. 15배는 위 0.7초 → 10.6초에서 왔다. 시험마다 자기가 잰 최대값을 인자로 적어 근거가 호출 자리에 남는다. - describe 안의 기본값 시험이 모두 자식 프로세스를 띄우면 describe에, 일부만 띄우면 그 시험에 준다. 프로세스 안에서 도는 시험의 hang을 늦게 잡지 않으려는 것이다. - tests/setup.ts가 child_process 함수를 감싼다. 기본 timeout인 시험이 자식 프로세스를 띄우면 그 호출에서 실패시키고, helper 이름을 알린다. helper나 시험이 import한 스크립트가 띄워도 잡는다. util.promisify가 읽는 속성은 원래 함수에서 옮긴다. - docs/work/reference/testing.md 2절에 값 정하는 법과 이 검사를 적었다. 버린 것: - 전역 testTimeout 올리기: 프로세스 안 시험의 hang을 늦게 잡는다. - 시험마다 손으로 정한 숫자: 근거가 남지 않고, 이미 있는 값도 60_000·120_000처럼 근거가 없었다. - 자식 프로세스를 띄우지 않게 바꾸기: 검사 스크립트를 CLI 그대로 시험하는 것이 이 시험들의 목적이라 범위가 커진다. - 파일에 timeout 선언이 있는지만 보는 정적 검사: helper가 띄우는 경우와 같은 파일의 다른 시험을 놓친다. 위험: - hook(beforeAll 등)에서 띄우는 프로세스는 검사하지 않는다. 계측에서 hook이 띄운 곳은 둘이고, 둘 다 180초를 선언했다. - 같은 파일 안에서 it.concurrent로 도는 시험이 섞이면 어느 시험의 timeout인지 틀릴 수 있다. 지금은 그런 시험이 없다. - 다운스트림 시험이 기본값으로 자식 프로세스를 띄우면 test:unit 등이 실패한다. 메시지가 helper를 알린다. 검증(desktop): - 다섯 검사(test:unit·check:types·check:ci·lint·verify:documentation) rc=0. - 자식 프로세스를 띄우는 시험 파일 40개와 tests/scale: rc=0, 검사 위반 0. - tests/system: 115개 중 18개 실패. 모두 bwrap 호스트 제약이고 검사 위반은 0이다. - 변이: 검사를 끄면 tests/unit/child-process-timeout.test.ts가 실패한다. tracked-artifacts describe의 timeout을 지우면 그 시험이 검사 메시지로 실패한다. - 재현: CPU 10% 제한에서 app-build-input·registry-governance·hosting-probe ·design-system-rules를 돌렸다. main 650d22fa는 11개가 10초 timeout으로 실패했다. 이 커밋은 71개 모두 통과했고, 가장 긴 시험은 17.7초였다. |
||
|
|
6b4f703c59 |
Merge pull request 'docs(work): FE-GATE-013 desktop 판정을 정하고 스킬 절 인용을 대조한다' (#21) from donghyeon.kang/claude/fe-b-docs-followup-2 into main
frontend-quality-gates / merge / static checks (push) Successful in 2m19s
frontend-quality-gates / merge / tests (push) Failing after 12m33s
frontend-quality-gates / merge / browser tests (push) Successful in 9m0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m14s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
|
||
|
|
c8b70f5a2b |
docs(changelog): FE-GATE-013 판정·스킬 절 대조·ungated reason을 적는다
frontend-quality-gates / merge / tests (pull_request) Failing after 13m9s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m30s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m18s
frontend-quality-gates / main / checker self-tests (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
문제: desktop FE-GATE-013 판정 규칙, 스킬 절 인용 시험, ungated-tests reason 번역이 변경 이력에 없다. 절 인용 시험은 자기 문서의 절 이름을 바꾼 다운스트림이 스킬도 같이 고쳐야 통과한다. 고른 방법: 「정리 단계」 절 머리에 이 브랜치 범위를 더하고 「그 밖의 수정」에 세 줄을 더한다. 위험: 커밋 해시는 이 브랜치의 것이다. main이 다시 바뀌어 rebase하면 함께 고친다. 검증: 문서 검사는 desktop에서 돌린다. |
||
|
|
ac19de85ac |
docs(ci): ungated-tests.json의 reason을 한국어로 옮긴다
문제: config/ci/ungated-tests.json의 reason 6개(같은 문장)가 영어다. 설정 파일의 사람이 읽는 설명 칸은 한국어로 쓴다(docs/README.md 2절). 고른 방법: scripts/lib/ungated-tests.ts는 빈 문자열만 막고, 시험은 reason 내용을 읽지 않는다. 경로·명령·게이트 ID·리뷰 ID는 그대로 두고 문장만 옮겼다. ungated-scripts.json의 같은 scale 이유와 말을 맞췄다. 위험: 없다고 본다. 읽는 코드가 내용을 보지 않는다(위 확인). 검증: diff가 reason 6줄뿐이다(키·순서·항목 수 같음). ungated-tests 시험과 check:ci:gating(FE-GATE-029)은 desktop에서 돌린다. |
||
|
|
bdda84f844 |
docs(work): desktop FE-GATE-013을 조건부로 merge 판정에서 빼기로 정한다
문제: FE-GATE-013을 멈춤 기준에서 어떻게 셀지가 결정 대기라, desktop에서 merge 판정을 하면 매번 「merge 가능 여부는 소유자가 정한다」로 끝났다. desktop의 ssh 셸은 비특권 user namespace를 막아 test:system 사전 점검이 호스트 원인으로 실패한다. 고른 방법: 소유자 결정(2026-11-11, 「그 조건이 되는 실행 환경을 찾아 초록으로」)에 따라 총괄이 권하는 안으로 정했다(2026-11-12). - merge 판정에서 빼는 조건 둘: 실패가 사전 점검의 user namespace 제한 하나뿐이고, `scripts/verify.sh parts FE-GATE-013`의 뒤 명령이 모두 rc=0. - 게이트 「충족」은 조건을 갖춘 runner에서 FE-GATE-013이 통과한 것으로만 센다. - decisions.md: 3.1절(열린 결정)에서 빼고 2.2절에 결정·버린 안·재검토 조건을 적었다. evidence.md 행에 결정 번호를 더했다. - gates.md 3절의 보고 문구, improve.md 멈춤 조건 3, operate.md 4.1절, new-feature.md 완료 기준, desktop-gates 스킬 6단계를 새 규칙으로 고쳤다. 버린 안: runner에서 통과할 때까지 merge 판정을 미충족으로 두기. 그 runner가 아직 없어 모든 PR의 merge 판정이 막힌다. 위험: desktop에서 test:system의 provider 테스트는 여전히 돌지 않는다. 그 몫의 결함은 runner가 FE-GATE-013을 돌 때까지 merge 판정에서 안 보인다. 뒤 명령 목록을 옮겨 적지 않고 gates.json `commandIds`를 가리킨다. 검증: python3 scripts/check-work-docs.py OK(지난 ID 줄 0), python3 -m unittest discover -s scripts/tests 71개 통과. 문서 검사는 desktop에서 돌린다. |
||
|
|
1b3eee41e3 |
test(claude): 스킬이 인용하는 절 이름을 문서 제목과 대조한다
문제: 스킬은 정본 문서의 절을 「이름」이나 「N절」로 가리킨다. 문서 검사 (verify:documentation)는 경로만 보므로, 문서를 번역하거나 절을 바꾸면 인용한 절이 사라져도 통과한다. 지금 9곳이 그렇다. - fe-structure: 「Decision rule」(지금 「판단 규칙」), 「The adapter kernel」(지금 「adapter kernel」) - fe-a11y: 「What the automated run scans」, 「Included primitives」 - fe-design-system: 「Arbitrary-value policy」 - fe-performance: 「Service Worker steps」 - fe-ux: 「routing 6.4절」이 앞 인용(typescript 설계서)의 6.4절로 읽힌다. 그 설계서에는 6.4절이 없다. - desktop-gates: 경로 없이 `gates.md`·`operate.md`라고만 쓴다. 고른 방법: scripts/tests/test_claude_setup.py의 SkillTest에 시험을 더한다. - 모든 repo 스킬에서 읽는 인용 꼴: `경로.md` 「이름」, `경로.md` N절 (3·4절, 6.1·11절), `경로.md` N절 「이름」, 같은 문서 N절, `fe-x` 「이름」(다른 스킬의 절). - 인용마다 대상 파일에 그 제목이 있는지 본다. 제목은 앞 번호와 끝 괄호를 뗀 꼴도 받는다. 「이름:」만 있는 소제목 줄도 받는다. 코드 블록 안 제목은 보지 않는다. - 파서와 제목 읽기를 따로 고정하는 시험 둘을 함께 둔다. - 9곳은 지금 제목으로 고치고, 짧게 쓴 경로는 전체 경로로 쓴다. 버린 대안: 문서 검사(scripts/lib/docs-system.ts)에 넣는 방법. 스킬 구성의 다른 규칙이 이미 이 시험 파일에 있고, `scripts/verify.sh hooks`로 노트북에서 바로 돈다. 위험: 「 」 안의 말이 절 이름이 아닌데 경로 바로 뒤에 붙으면 거짓 실패가 난다. 경로 뒤의 —, 괄호, 문장 끝에서 읽기를 멈춰 지금 196개 인용에는 그런 경우가 없다. 「N절」이 다른 문서를 줄여 부르면(「routing 6.4절」) 앞 경로로 읽으니 전체 경로로 쓴다. 이 시험은 게이트가 아니라 hooks 단계에서 돈다. 검증: python3 -m unittest scripts.tests.test_claude_setup. - 고치기 전: 새 시험이 9곳(과 처음 판에서 거짓 실패 2곳)을 냈다(RED). - 고친 뒤: 24개 모두 통과했다. 인용 196개를 확인했다. |
||
|
|
d2239c6764 |
Merge pull request 'docs: 문서 체계 후속으로 VD 보완 표시와 낡은 서술을 고친다' (#20) from donghyeon.kang/claude/fe-b-docs-followup into main
frontend-quality-gates / merge / browser tests (push) Successful in 9m46s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / merge / static checks (push) Successful in 2m17s
frontend-quality-gates / merge / tests (push) Failing after 12m23s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m7s
|
||
|
|
36eb6b0b35 |
docs(changelog): 문서 체계 후속 고침을 정리 단계 절에 적는다
frontend-quality-gates / merge / browser tests (pull_request) Successful in 11m27s
frontend-quality-gates / merge / tests (pull_request) Failing after 15m24s
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
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m56s
문제: VD 보완 표시, 낡은 서술 고침, drill 복구 항목 이름, ungated reason 번역이 변경 이력에 없다. drill 이름은 record.json의 값을 바꾸고, 자기 runbooks.json을 고친 다운스트림은 drill도 같이 고쳐야 한다. 고른 방법: 같은 동기화 단위인 「정리 단계」 절 머리에 이 브랜치 범위를 더하고, 「그 밖의 수정」에 네 줄을 더한다. 위험: 커밋 해시는 이 브랜치의 것이다. 병합 방식이 merge commit이라 main에서도 같은 해시로 찾을 수 있다. 검증: 문서 검사는 desktop에서 돌린다. |
||
|
|
b824195cdc |
docs(ci): ungated-scripts.json의 reason을 한국어로 옮긴다
문제: config/ci/ungated-scripts.json의 reason 18개가 영어다. 설정 파일의 사람이 읽는 설명 칸은 한국어로 쓴다(docs/README.md 2절). 고른 방법: 읽는 코드를 먼저 봤다. scripts/lib/ungated-scripts.ts는 빈 문자열만 막고, tests/unit/ungated-scripts.test.ts는 check:feature-index의 reason에 verify:extreme-scale이 들어 있는지만 본다. 그래서 script 이름· 경로·명령·게이트 ID·리뷰 ID는 그대로 두고 문장만 옮겼다. 옮기다 본 verify:extreme-scale의 「24 scripts」는 실제 23개라 숫자 대신 EXTREME_SCALE_GATES를 가리킨다. 위험: 같은 형식의 config/ci/ungated-tests.json reason은 범위 밖이라 영어로 남았다. 검증: diff가 reason 18줄뿐이다(키·순서·항목 수 같음). ungated-scripts 시험과 check:ci:gating은 desktop에서 돌린다. |
||
|
|
6571d8cb9d |
fix(runbook): drill 복구 항목 이름을 runbooks.json과 같게 한다
문제: scripts/drill-runbook.ts의 복구 확인 항목 이름은 영어 리터럴이고, config/runbooks/runbooks.json의 recoveryEvidence는 2026-11-08에 한국어로 옮겼다. 둘을 비교하는 곳이 없어 record.json과 UNVERIFIED 줄이 runbook에 없는 이름을 쓴다. 앞으로 한쪽만 고쳐도 아무 신호가 없다. 고른 방법: 다섯 drill의 항목 이름 20개를 recoveryEvidence 문자열로 바꾸고, 이름과 순서가 recoveryEvidence와 같은지 보는 시험을 runbook-drill.test.ts에 더한다. 판정 근거 문구(evidence)와 오류 메시지는 영어 그대로다. 버린 대안: drill이 recoveryEvidence를 위치로 읽어 이름을 붙이는 방법은 코드에서 항목과 판정의 짝이 보이지 않고, 설정 순서를 바꾸면 조용히 어긋난다. 위험: artifacts/runbooks/<id>/record.json의 assertion 값이 한국어가 된다. record schema는 빈 문자열만 막으니 통과하지만, 그 값을 영어로 읽는 바깥 도구가 있으면 바꿔야 한다. 이 repo에는 없다. 검증: desktop에서 node scripts/run-vitest.ts run tests/unit/runbook-drill.test.ts — 고치기 전 새 시험 5개 실패(RED), 고친 뒤 runbook-drill 14개· runbook-contract 2개 통과(GREEN). |
||
|
|
374af98640 |
docs: 번역하며 찾은 낡은 서술을 코드·설정에 맞춘다
문제: 살아 있는 문서를 옮길 때 뜻을 바꾸지 않는다는 규칙 때문에 남겨 둔 낡은 서술이 있다. - contract-ownership: 계약 파일 「39개」. 지금 src/contracts의 .ts는 44개다. - capability-consumer-experience: Local Draft를 「두 번째 구체 소비자」, 「두 feature」라고 부른다. 지금은 제품 feature가 아니라 테스트 fixture (tests/fixtures/indexeddb-consumer)다. - static-delivery: initialJavascript.files가 「예시 feature 기준」이라고 한다. feature-shape-ceilings.json은 feature가 없는 지금 템플릿 빌드라고 적는다. - .dependency-cruiser.json:254 주석이 번호 없는 layers.md의 「§4」를 가리킨다. - runbook 문서 제목 셋이 runbooks.json title과 다르다. FE-RB-002는 영어 원문부터 manifest가 빠져 있었고, 001·003은 번역에서 갈라졌다. - ci-quality-gates: zod 행의 고친 버전은 4.6.6인데 이유 칸은 4.6.7을 말한다. 4.6.7은 올렸을 때 잰 버전이다( |
||
|
|
8acf07c2f6 |
docs(adr): VD-09·11·13을 채택(보완)으로 올리고 보완 절을 단다
문제: 세 결정 기록은 결정한 뒤 본문을 제자리에서 고쳤지만 본문에 날짜가 붙은 보완 메모가 없어, 2026-11-08 머리 블록을 달 때 기계 규칙대로 「채택」이 됐다. 머리 블록은 본문이 결정한 때의 원문이라고 말하지만 실제로는 고친 뒤의 내용이다. 고른 방법: git 이력에서 결정 뒤 본문을 바꾼 커밋을 찾아 상태를 「채택(보완)」으로 올리고, 맨 아래 「보완」 절에 날짜·커밋·바뀐 절을 적는다(docs/README.md 2절). 본문은 고치지 않는다. 처음 커밋한 본문을 보는 git show 명령도 적는다. - VD-09: 2026-07-30 6c52cdb9(스크립트 경로 .mjs→.ts), 2026-08-02 92e5cace(결정 6~11번, 도식, 검증, Rollback) - VD-11: 2026-09-18 ec7f20e2(case 수 고정 문단을 규칙으로 바꿈) - VD-13: 2026-11-06 02a761f0(Web Storage key 이름을 정본 가리키기로) 6f6c48eb(2026-09-24)는 이력을 다시 시작한 커밋이라 세 본문 모두 그 앞 커밋과 내용이 같다. 그래서 보완에 넣지 않았다. 위험: 둘째 줄 「본문은 결정한 때의 원문이다」는 검사기가 고정한 문구라 그대로다. 보완 절의 첫 인용 블록이 실제 사정을 적는다. 검증: 각 커밋의 diff를 git diff <앞>:<경로> <뒤>:<경로>로 읽었다. 인용한 커밋 다섯 개가 모두 main의 조상이다. 문서 검사는 desktop에서 돌린다. |
||
|
|
650d22fa65 |
Merge pull request 'chore(layout): R2·R5 검사를 저장소 전체와 소유자 기준으로 마무리한다' (#18) from chore/layout-rules-r2-r5 into main
frontend-quality-gates / merge / static checks (push) Successful in 2m21s
frontend-quality-gates / merge / tests (push) Failing after 13m58s
frontend-quality-gates / merge / browser tests (push) Successful in 8m37s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m7s
|
||
|
|
c28bf92c21 |
Merge branch 'main' into chore/layout-rules-r2-r5
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m32s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m8s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m33s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (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
main이 PR #17(분야 전문가 스킬)을 받아 39d00b28이 됐다. 충돌은 없고, #17이 바꾼 파일(.claude/, docs/work/, AGENTS.md, CLAUDE.md, scripts/tests/test_claude_setup.py)은 이 브랜치가 바꾼 파일과 겹치지 않는다. |
||
|
|
39d00b282c |
Merge pull request 'feat(claude): 분야 전문가를 지식 스킬 아홉 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다' (#17) from donghyeon.kang/w3-experts-fe into main
frontend-quality-gates / merge / static checks (push) Successful in 2m54s
frontend-quality-gates / merge / tests (push) Failing after 13m52s
frontend-quality-gates / merge / browser tests (push) Failing after 7m15s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m1s
|
||
|
|
2d3e58895f | chore(merge): 문서 체계 PR #15가 들어간 main을 받는다 | ||
|
|
f5344f2166 |
Merge branch 'main' into chore/layout-rules-r2-r5
main이 PR #15(문서 체계)를 받아 db6a6eb6이 됐다. CHANGELOG 정리 단계 절 머리의 범위 문장이 충돌했고, 문서 체계 단계와 이 브랜치의 범위를 둘 다 남겼다. 나머지 파일은 자동으로 합쳐졌다. PR #15가 더한 tests/unit/docs-system.test.ts의 가상 저장소 목록은 앞 커밋 R2 예외로 적었다. |
||
|
|
b96f3b4564 |
test(layout): R2가 메모리 안 가상 저장소 목록은 이유와 함께 건너뛴다
main이 받은 PR #15의 tests/unit/docs-system.test.ts는 문서 검사기 시험을 위해 메모리 안에 가상 저장소를 만든다. 그 knownPaths 배열(docs, docs/architecture, docs/architecture/layers.md, src, src/platform)을 R2 검사가 루트 경로 목록으로 잡아, main을 이 브랜치에 합치면 test:unit이 실패한다. 이 목록은 실제 루트 항목을 옮겨도 바뀌지 않으니 등록부 집합으로 고를 것이 아니다. R2 시험에 MADE_UP_REPOSITORY_LISTS를 두고 파일·목록·이유를 적는다. - 그 파일의 그 목록만 건너뛰고, 같은 파일의 다른 목록은 그대로 본다. - 적힌 목록이 그 파일에 더 없으면 실패한다. 그래서 낡은 예외가 뒤에 새 목록을 덮지 못한다. 제거 drill 사본처럼 그 파일이 검사 대상에 없으면 보지 않는다. - 이 커밋에는 아직 그 파일이 없다. 다음 merge 커밋이 main을 합쳐도 모든 커밋이 시험을 통과하도록 merge 앞에 둔다. 매뉴얼 03 E절 R2 칸과 CHANGELOG 먼저 할 일 15에 이 예외를 적는다. 버린 것: - docs-system 시험의 배열을 둘로 나누기: 검사를 피하려고 코드 모양을 바꾸는 것이다. - 가상 경로를 다른 이름으로 바꾸기: 문서 검사기가 docs/ 경로를 규칙으로 보므로 시험의 뜻이 바뀐다. - 집합을 고르게 하기: 가상 저장소가 실제 저장소 배치에 묶인다. 위험: 다운스트림이 같은 꼴의 fixture를 두면 이 목록에 적어야 한다. 검증(desktop): 이 커밋과 다음 merge 커밋에서 test:unit, check:types, check:ci, lint, verify:documentation. merge 커밋에서 변이 셋을 넣었다. 예외를 지우면 R2 시험이 docs-system 목록을 대며 실패한다. 목록 내용을 바꾸면 바뀐 목록을 대며 실패한다. 목록이 파일에서 없어지면 낡은 예외로 실패한다. |
||
|
|
2901785436 |
fix(claude): fe 스킬이 문서 체계 개편으로 옮긴 문서를 가리키게 한다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m35s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m34s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 11m54s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (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-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-018 / field-web-vitals (pull_request) Skipped
문제: #15가 결정 기록을 docs/adr/로, 설계서 넷을 docs/design/의 설계 기록으로 옮겼다. fe-* 스킬 8개가 옛 경로를 적고 있어 verify:documentation(FE-GATE-017)과 그 시험(tests/unit/documentation-readiness.test.ts, FE-GATE-005)이 실패했다. 고른 방법: 옛 경로를 옮긴 곳으로 바꿨다(VD-* → docs/adr/, design-system-platform· frontend-platform-testing-strategy·routing-pages-and-patterns· typescript-state-and-data-flow → docs/design/2026-07-26-*-design.md). 스킬이 인용한 절 번호는 기록에 그대로 있다. 버린 대안: 기록 머리의 「현재 정본」으로 바꾸기 (인용한 절이 정본 쪽에 없는 것이 많아 근거가 끊긴다). 위험: 설계 기록은 쓴 때의 원문이라 지금 동작과 다를 수 있다. 스킬이 그 절을 근거로 든 규칙은 검사기·시험 경로를 함께 적어 두었다. 검증: 바꾼 문서에서 백틱 경로를 검사기 방식으로 다시 뽑아 없는 경로 0개, python3 -m unittest discover -s scripts/tests 통과, scripts/verify.sh docs rc=0. |
||
|
|
5d3e0f59ae | Merge remote-tracking branch 'origin/main' into claude/w3-experts-fe | ||
|
|
db6a6eb6fb |
Merge pull request 'docs: 문서 체계를 백엔드와 같게 하고 살아 있는 문서를 한국어로 옮긴다' (#15) from donghyeon.kang/claude/fe-b-docs-korean-645f55 into main
frontend-quality-gates / merge / static checks (push) Successful in 2m29s
frontend-quality-gates / merge / tests (push) Failing after 14m2s
frontend-quality-gates / merge / browser tests (push) Failing after 7m20s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m24s
|
||
|
|
414fc2aa4a |
docs(manual): R1·R2·R5 규칙 문장과 CHANGELOG를 새 검사에 맞춘다
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m4s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 21m46s
frontend-quality-gates / FE-GATE-017 / diagram-review (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 / merge / tests (pull_request) Failing after 14m14s
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 / 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
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
매뉴얼 03 E절의 R1(종류 untracked), R2(저장소 전체 코드, 인자 목록은 `--` 뒤, 집합마다 읽는 코드), R5(소유자를 따라가는 대상 여섯 가지) 검사 칸과, 새 목록이 필요할 때 집합을 더하는 단계를 고쳤다. CHANGELOG 정리 단계 절에 먼저 할 일 15·16과 계약 표 한 줄을 더했다. 그 밖의 수정에 provider fixture의 .claude 수정 한 줄을 더했다. 절 머리의 범위에 이 브랜치를 넣었다. 알려진 제한의 R2·R5 두 줄은 해결로 표시하고 새 검사가 못 보는 곳을 적었다. runner 줄은 PR #16 실행 #5 결과로 고쳤다. 검증(desktop): verify:documentation, test:unit, merge 단계 job 셋과 main_gate, FE-GATE-017. |
||
|
|
ceaf21ea84 |
fix(test): provider fixture가 추적되는 .claude 파일도 복사한다
FE-GATE-013의 system 시험 tests/system/ci-runner/ci-artifact-contract.test.ts 에서 verified promotion finalizer 시험 18개가 desktop에서 실패한다. 오류는 `ENOENT … .claude/agents/arch-reviewer.md`다. 기준 fixture는 checkout을 .git째 복사하면서 .claude를 통째로 건너뛴다. 하네스 PR #13 뒤로 .claude/에 추적 파일이 11개 있다. 공급망 생성(scripts/lib/repository-file-inventory.ts) 은 추적 파일마다 lstat하므로, 빠진 파일에서 후보 빌드가 멈춘다. main 38c0dc7d에서도 같다. runner에서는 이 시험이 bwrap 없음으로 돌지 못해 드러나지 않았다. .claude 대신 다른 worktree가 들어 있는 .claude/worktrees만 건너뛴다. - 등록부의 provider-fixture-skip 집합은 .claude 항목의 setPaths로 그 경로를 고른다. - 복사 filter는 첫 경로 조각이 아니라 경로 앞부분으로 비교한다. 버린 것: - inventory가 .claude를 건너뛰게 하기: 실제 후보 빌드의 inventory까지 추적 파일을 빠뜨린다. - fixture의 git index에서 .claude 파일을 지우기: fixture가 실제 checkout과 달라진다. 위험: runner에서는 FE-GATE-013이 여전히 bwrap 없음으로 실패해, 이 수정은 desktop에서만 확인된다. 사본에 .claude/ 11파일이 더 들어간다. 검증(desktop): 이 시험 파일 전체를 main 38c0dc7d와 이 커밋에서 돌렸다. - main: 18개 ENOENT 실패, 36개 건너뜀(기준 fixture 빌드 실패). - 이 커밋: finalizer 18개 통과, ENOENT 0. 남은 18개 실패는 모두 provider sandbox의 `bwrap: loopback: Failed RTM_NEWADDR`(desktop 비특권 network namespace 제약)다. - test:unit, check:types, check:ci, lint, verify:documentation. |
||
|
|
bbbc6abd98 |
docs(changelog): 하네스·정리 3·4단계를 받은 뒤의 문서 체계 고침을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m20s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m18s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m33s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (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
문제: 정리 단계 미출시 절이 main을 두 번 받은 뒤 더한 문서 체계 고침(하네스 문서 맞추기, 줄임표 자리표시자, 시험 시간 한도, a11y 기록 경로)을 적지 않는다. 고른 방법: 「그 밖의 수정」에 세 줄을 더한다. 계약 행은 바뀌지 않는다. 검증: changelog-review-ids 시험과 verify:documentation을 desktop에서 본다. |
||
|
|
e9e98b8aa7 |
Merge branch 'main' into claude/fe-b-docs-korean-645f55
정리 3·4단계 PR #14와 CI 재편 PR #16(main
|
||
|
|
6805ed62a4 |
fix(claude): 분야 파일을 고치기 전에 fe 스킬을 부르도록 규칙에 파일과 스킬 짝을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m41s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m11s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m41s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (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
문제: 백엔드 템플릿 실제 세션 평가에서 분야 스킬이 목록에 떠도 세 번 중 한 번만 불렸다. 같은 모양인 이 repo 규칙도 "어느 스킬인지는 experts.md 3절 표"라고만 해서 한 번 더 읽어야 짝을 알았다. 고른 방법: 규칙에 고칠 것 → 스킬 짝을 한 줄로 적고, 처음 Edit·Write하기 전에 Skill 도구로 부르며 문서를 읽었어도 부른다고 적었다. 버린 대안: 폴더마다 AGENTS.md에 한 줄 더하기(파일 수가 늘고 배치 규칙과 겹침), 강조어(과다 호출을 부른다). 위험: 규칙이 붙는 세션마다 약 300토큰이 는다. 여러 분야를 부르면 호출이 는다. 검증: python3 -m unittest discover -s scripts/tests 68건 통과, scripts/verify.sh docs rc=0. |
||
|
|
1f57c38e40 |
test(layout): R5를 게이트 대상의 소유자를 따라가는 검사로 바꾼다
R5 검사는 샘플의 기능 ID와 라우트 경로가 goto 문자열, 증거 경로, 규모 기록 본문에 들어 있는지 찾았다. 조립한 경로, 여러 줄 goto, origin을 붙인 template 문자열, import로 샘플을 쓰는 spec은 놓쳤다. 이제 대상마다 소유자를 따라간다. - visual·e2e goto 경로 → 라우트 표(ROUTE_REGISTRY)의 라우트와 기능. 선언된 경로가 없으면 catch-all. - workshop story id → title이 그 id를 만드는 stories 파일. - spec의 import → 불러오는 파일을 끝까지. src/.generated/에서 멈춘다. - gates.json의 라우트 기록 → 라우트. 라우트 표에 없으면 실패. - 게이트 명령 → package script 그래프로 닿는 script, 경로 인자, --feature 인자. - config/scale/feature-shape-growth.json의 sourceFeature → 기능. 실제 저장소로 돈 결과가 비지 않는지, 샘플이 플랫폼 화면·디자인 시스템·메시지 카탈로그를 소유했다면 실제 spec·게이트에서 무엇이 걸리는지, 합성 샘플로 각 경로가 잡히는지를 시험한다. 검증(desktop): test:unit, check:types, check:ci, lint, verify:documentation. |
||
|
|
3f64c68991 |
refactor(layout): 남은 루트 경로 목록도 등록부 집합에서 고른다
정리 4단계의 R2 검사는 등록부를 쓰는 7곳만 봤다. 그 밖에 루트 이름을 담은 목록이 코드 15파일에 19개 따로 있어, 루트 항목 하나를 옮기면 여전히 여러 곳을 같이 고쳐야 했다. - 등록부에 집합 12개를 더했다. 사본 복사에서 건너뛰는 항목 셋 (checkout·provider·공급망 fixture), fixture 코드 범위, pnpm 매니페스트, Playwright 설정, visual 증거, 문서 입력, 에이전트 하네스, tsconfig 묶음 셋. 각 집합 설명에 읽는 파일을 적었다. - 사본이 건너뛰는 node_modules·dist·.tmp 같은 추적 안 하는 항목은 종류 untracked(optional)로 적는다. 추적 파일이 있으면 시험이 실패한다. - 19개 목록이 모두 집합을 고른다. 집합의 원소는 전과 같아 동작은 바뀌지 않는다. - R2 시험이 추적되는 코드 파일 전체를 본다. 루트 항목(이나 그 안 경로)만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 실패. 인자 목록은 `--` 뒤만 본다. main의 옛 목록 18개를 이 검사가 잡는 것을 확인했다. - 집합마다 selectRepositoryPaths·selectRepositoryEntries로 고르는 코드가 있는지 본다. 문서를 복사하지 않는 제거 drill(FE-GATE-020)은 문서 시험(REMOVAL_FIXTURE_DOCUMENT_TESTS)을 지우는데, 집합 셋 (agent-harness·documentation-inputs·feature-typecheck)은 그 시험만 읽는다. 시험이 이 셋을 적어 두고, 문서 시험이 지워진 사본에서만 셋이 비는 것을 허용한다. 셋이 바뀌면 전체 checkout에서 실패한다. - 파서가 kinds·sets 설명과 코드의 목록이 같은지 본다. - .gitignore 주석이 a11y 기록을 아직 artifacts/ 아래라고 적던 것을 고쳤다(정리 3단계에서 docs/로 옮김). 검증(desktop): test:unit, check:types, check:ci, lint, verify:documentation. repository-layout 시험을 문서 없는 제거 사본과 feature-scaffold 사본에서도 돌렸고, 집합 하나의 읽는 곳을 지우면 두 곳 모두 실패한다. |
||
|
|
27876ffcba |
chore(ledger): W2-FE CI 성능 작업의 예측을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m17s
frontend-quality-gates / merge / tests (pull_request) Failing after 16m50s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m44s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (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
|
||
|
|
1f09c1cc88 |
perf(tests): vitest setup이 DOM이 있는 파일에만 Testing Library를 불러온다
문제: tests/setup.ts는 모든 시험 파일에 @testing-library/jest-dom과 @testing-library/react(그리고 react-dom)를 불러온다. tests/unit 215개 파일 중 DOM(jsdom)을 쓰는 것은 3개뿐인데, Node 환경 파일마다 이 import가 돈다. runner의 test:unit에서 setup이 누적 124~165초로, 시험 본문 다음으로 크다(run 80·81). 고른 방법: setup 파일이 `document`가 있을 때만 두 모듈을 불러오고 configure를 건다. afterEach 하나에서 cleanup → 실제 timer 복원 순서를 그대로 지킨다. 버린 대안: vitest projects로 node·jsdom 설정을 나누기. 같은 효과에 설정·명령 변경이 커서 뒤로 미뤘다. 위험·한계: Node 환경 파일에서 jest-dom matcher를 쓰면 이제 실패한다. 그런 파일은 없다(아래 검증의 unit·component 전부 통과로 확인). 검증: desktop 묶음(w2fe-p2) A·B 단계 — unit·component 전·후 각 2회. |
||
|
|
92abfd2089 |
ci(gates): 브라우저 job을 Playwright 이미지에서 돌린다
문제: merge / browser tests job은 `playwright install --with-deps`로 매번 apt 276개(180MB)와 브라우저 넷(전체 Chrome 포함), 글꼴 220MB를 받는다. runner에서 job마다 198~242초, 약 900MB다(run 56·80·81). run 54에서는 이 단계 중 desktop 루트가 90%까지 차 Gitea가 내려갔다. 고른 방법: browser-install 단계에 `image`를 두고, 생성기가 그 job의 container로 그린다. 값은 @playwright/test와 같은 버전의 Playwright 공식 이미지 digest(mcr.microsoft.com/playwright:v1.62.0-noble@sha256:baed…)다. 그 이미지에는 1.62의 브라우저와 OS 라이브러리가 들어 있다. 단계는 visual 골든의 글꼴만 apt로 설치한다(이미지에 패키지 목록이 없어 apt-get update 먼저). job env의 CI_RUNNER_IMAGE를 그 이미지로 적어, 빌드가 기록하는 runner 이미지가 실제와 맞는다. - 계약: image는 Playwright 레지스트리의 noble 태그 + digest만 받고, gate-sequence job에만 둔다(matrix의 비브라우저 lane까지 그 이미지로 돌지 않게). tests/unit/ci-browser-image.test.ts가 태그 버전 = package.json @playwright/test 버전을 지킨다. - release_gate(lab-performance)는 그대로 둔다(release 단계, 범위 밖). - 버린 대안: runner 이미지 위에 브라우저를 구운 자체 이미지(레지스트리 쓰기 토큰과 빌드 경로가 필요), 브라우저 폴더 캐시(apt 의존성 100초가 남는다). 위험·한계: 이미지의 OS 라이브러리 판이 runner 이미지와 조금 다를 수 있어 visual 골든(maxDiffPixels 50)이 바뀔 수 있다. runner 실행으로 확인한다. 이미지(압축 947MB)를 runner의 dind가 한 번 받는다. Playwright를 올릴 때 이미지 digest도 같이 바꿔야 한다(위 시험이 막는다). 검증(desktop): generate:ci-workflow 뒤 check:ci PASS, ci-workflow-generation ·ci-browser-image 시험 통과(스냅샷 1개 갱신), check:types·eslint rc=0. runner 실행은 PR에서. |
||
|
|
1d3eb901d2 |
ci(gates): FE-GATE-013을 일회용 systemd 컨테이너 안에서 돌린다
문제: FE-GATE-013의 test:system은 provider sandbox를 실제로 띄운다. systemd user manager(systemd-run --user --scope)와 cgroup v2 위임, bubblewrap(--unshare-net 등)이 필요하다. runner의 job 컨테이너는 entrypoint가 sleep이라 systemd가 없고 bwrap도 없어 사전 점검에서 실패한다 (run 56·80·81). desktop 호스트는 다 있지만 Ubuntu 24.04의 apparmor_restrict_unprivileged_userns=1이 비특권 bwrap을 막는다. 그래서 이 게이트는 runner와 desktop 어디서도 초록인 적이 없다. 고른 방법(소유자 결정 2026-11-11 5절 e: 조건이 되는 실행 환경을 찾는다): - config/ci/system-container.Dockerfile: Ubuntu 24.04(digest 고정) + systemd PID 1 + root linger + bubblewrap 등 hostRequirements의 도구. - scripts/run-in-system-container.sh: 이미지(Dockerfile 해시 태그)가 없으면 만들고, privileged·자체 cgroup namespace로 띄워 systemd와 root user manager를 기다린 뒤, 작업 트리·git 이력·호출한 쪽의 node와 corepack을 복사해 명령을 root로 돌리고 artifacts/를 되가져온 다음 지운다. root는 호스트의 userns 제한을 받지 않는다. - gates.json 게이트 필드 hostEnvironment: "system-container"(FE-GATE-013). 생성기는 그 게이트의 run 줄에 래퍼를 붙이고, 실행 검사 (workflowGateExecutionFailures)는 계약이 정한 접두어로 돈 줄만 센다. scripts/verify.sh gate·parts·stage도 같은 래퍼로 돌린다. - CI에서는 runner의 Docker proxy로 안쪽 dind daemon을 쓴다(platform-core gitea-runner README가 「남은 위험」으로 적은 길: proxy가 privileged 컨테이너를 막지 않는다). - 버린 대안: 전용 VM runner(문서 조건을 그대로 만족하지만 platform-core 변경과 VM 자원·runner 등록이 필요), 호스트 AppArmor profile(호스트 userns 제한을 푸는 보안 설정 변경, 소유자 sudo). 위험·한계: - root로 돌아 「비특권 runner에서 bwrap userns」 조건 자체는 증명하지 않는다. release 단계 provider job 둘은 아직 job 컨테이너에서 돈다(범위 밖, 같은 래퍼나 VM runner가 필요). - runner가 rootless dind로 바뀌면 privileged 컨테이너를 못 띄워 깨진다. - 래퍼 준비(이미지 확인·기동·복사)에 desktop에서 50~60초가 든다. 검증(desktop): 래퍼로 check-system-test-prerequisites → PASS(root), tests/system/ci-runner/provider-process-group.test.ts 1개 통과. python3 -m unittest scripts.tests.test_verify 통과, check:ci PASS(게이트 28), ci-workflow-generation 시험 통과. 게이트 전체(test:system 116개 포함)는 이 브랜치 끝의 merge 단계에서 돈다. |
||
|
|
b5e7f54bd1 |
feat(claude): 분야 전문가를 지식 스킬 아홉 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m3s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m34s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 9m26s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (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
문제: 하네스에 분야 지식이 없다. QA·디자인/UX·디자인 시스템·React·폴더 구조·시험 환경·접근성·성능·보안의 이 repo 규칙(배럴 경계, 토큰 밖 색 금지, axe 태그 범위, 예산, FE-GATE 실행법 등)은 문서와 검사기에 흩어져 있고, 여러 분야에 걸친 일을 누가 보고 어떻게 합치는지 정한 곳이 없다. 고른 방법(소유자 결정 2026-11-11 「W3 설계대로」, 백엔드와 같은 모양): - 지식 스킬 fe-* 9개(.claude/skills/). paths를 걸어 그 분야 파일을 만질 때만 목록에 뜬다. 본문은 언제 쓰나 → 함정 → 실패는 이렇게 보인다 → 검증 → 이 repo에서 정한 것 순서. 초안은 이 repo 문서만 본 서브에이전트가 썼고 glob 75개가 모두 파일에 걸리는 것을 확인했다. - 서브에이전트 reviewer(렌즈 = brief의 스킬 경로). arch-reviewer는 fe-structure를, verify-app은 fe-qa를 미리 싣는다(QA 탐색 차터). - .claude/rules/expert-skills.md: 분야 파일을 고치기 전에 그 스킬의 「함정」·「검증」을 보게 하는 두 줄. - docs/work/experts.md: 명단·경로 → 렌즈·넘김 지도(백엔드 repo로 가는 API 계약 차이는 총괄을 거침)·충돌·비용. 루트 AGENTS.md·CLAUDE.md 한 줄씩, README 3절 4단계와 delegate.md 4.3절에 가리키는 말. - 시험: 에이전트 넷, Agent 도구 금지, 설명 합 1,200자, 미리 싣는 스킬, 지식 스킬의 paths·설명 300자·금지어·절 순서·150줄·glob이 파일에 걸림, 명단이 모든 전문가를 담음, 규칙 목록에 expert-skills. - 문서 PR #15와 겹치지 않게 docs/는 docs/work/만 건드렸다. 버린 대안: 분야마다 서브에이전트(QA·디자인·접근성 …). Anthropic 2026-10-22·2026-01-23·2026-04-07 글이 반대하고, 설명이 모든 세션에 든다. 위험: 플러그인 lead·new-expert·harness-eval은 claude-harness PR #3(0.3.0)이 병합돼야 받는다. fe-ux·fe-a11y의 paths는 템플릿에 기능 화면이 없어 src/presentation/**까지만 건다(기능이 생기면 넓힌다). 검증: scripts/verify.sh docs → rc=0, scripts/verify.sh hooks → 68건 통과. 새 시험은 조건을 깰 때마다 실패했다. desktop merge 단계는 이 커밋 뒤에 돈다. |
||
|
|
66138440f4 |
build(deps): 쓰지 않는 dependency-cruiser를 지운다
문제: D-11(2026-11-05)로 dependency-cruiser 실행을 뺐다. CLI가 TypeScript 7을 못 읽어 check:architecture가 `.dependency-cruiser.json`을 규칙 파일로 직접 읽는다. 그런데 패키지는 devDependencies에 남아 job마다 설치된다. 코드·script·시험 어디서도 import하거나 실행하지 않는다 (`git grep dependency-cruiser`는 규칙 파일 이름과 기준선만 나온다). 잠금 파일 564개 snapshot 중 20개가 이 패키지 때문에만 들어온다. 고른 방법: `pnpm remove dependency-cruiser`로 package.json과 잠금 파일을 고치고, update:dependency-baseline으로 의존성 기준선을 다시 승인한다 (562 → 542개). 규칙 파일 `.dependency-cruiser.json`은 이름 그대로 둔다 (D-11). 위험·한계: 파생 프로젝트가 이 CLI를 따로 돌리고 있었다면 직접 다시 더해야 한다. 템플릿 문서는 이미 「CLI를 쓰지 않는다」고 적고 있다. 기준선 승인 기록의 owner는 이전 기록과 같은 이름으로 두었다. 리뷰에서 확인이 필요하다. 검증(desktop): pnpm remove rc=0, update:dependency-baseline "Supply chain: LOCAL PASS (542 dependencies)". merge 단계 게이트는 이 브랜치 끝에서 돈다. |
||
|
|
b4210753f0 |
perf(scripts): FE-GATE-020 드릴이 같은 시험 파일을 한 복사본에서 두 번 돌지 않는다
문제: FE-GATE-020이 desktop merge 단계 27.4분 중 17.2분이다. 그 안에서
같은 시험 파일이 한 복사본에서 두 번 돈다.
- feature-scaffold 드릴은 merge 단계 명령을 차례로 돌며 test:runtime-schema
·test:unit·test:contract·test:component·test:integration을 돌고, 바로
FE-GATE-005의 test:coverage가 같은 경로를 다시 돈다(약 80초).
- feature-removal 확인은 test:all을 돈 뒤 test:coverage를 돈다. test:all의
경로는 tests/recipes 말고 모두 coverage 안에 있다(약 110초).
고른 방법:
- scaffold 드릴 제외 목록에 다섯 suite를 넣는다. 그 복사본의 merge 단계에
test:coverage가 있을 때만 뺀다. 없으면 plain으로 다시 돈다.
- feature-removal은 test:coverage 다음에 coverage 밖에 남는 suite
(REMOVAL_DRILL_SUITES_OUTSIDE_COVERAGE = test:recipes)만 돈다.
- tests/unit/removal-drill-test-paths.test.ts가 경로를 package.json에서
읽어 「뺀 suite의 경로 ⊆ coverage 경로」, 「test:all 경로 ⊆ coverage +
남긴 suite」, coverage가 없으면 다시 도는 것을 지킨다.
- 버린 대안: FE-GATE-005 자체의 plain test:unit·test:contract를 빼고
coverage 실행에서 junit을 나누기. 그 script가 어느 게이트에서도 안 돌게
되어 ungated 목록을 늘려야 한다(게이트 기준을 낮추는 일).
위험·한계: plain 실행만의 차이(coverage 계측 없음, worker 수 기본값,
tests/platform을 test:platform처럼 파일 차례로 도는 것)는 드릴에서 더
보지 않는다. merge 단계의 FE-GATE-005가 coverage로 같은 파일을 병렬로
돌고 있어 그 모양이 이미 게이트다. 선택 기능 제거 드릴 셋의 test:all은
그대로다(그 드릴은 coverage를 돌지 않는다).
검증(desktop,
|