198e9856f64d20e54998468ee9e1efa06fd11a64
261
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
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( |
||
|
|
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개를 확인했다. |
||
|
|
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). |
||
|
|
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)은 이 브랜치가 바꾼 파일과 겹치지 않는다. |
||
|
|
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 예외로 적었다. |
||
|
|
5d3e0f59ae | Merge remote-tracking branch 'origin/main' into claude/w3-experts-fe | ||
|
|
e9e98b8aa7 |
Merge branch 'main' into claude/fe-b-docs-korean-645f55
정리 3·4단계 PR #14와 CI 재편 PR #16(main
|
||
|
|
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 사본에서도 돌렸고, 집합 하나의 읽는 곳을 지우면 두 곳 모두 실패한다. |
||
|
|
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 단계는 이 커밋 뒤에 돈다. |
||
|
|
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,
|
||
|
|
0d8e4f5adf |
perf(scripts): browser-file-storage 경계 검사를 ESLint 한 번으로 돌린다
문제: check:browser-file-storage-boundaries는 fixture마다
`pnpm exec eslint`를 새로 띄운다(파일 21개 + stdin 13번). 프로세스마다
flat config를 다시 읽어 desktop에서 53초가 걸리고, FE-GATE-010(66초)의
대부분이다. 같은 검사를 FE-GATE-020의 feature-scaffold 드릴이 복사본에서
한 번 더 돌아(62초) merge 1회에 약 2분을 쓴다.
고른 방법: ESLint Node API 인스턴스 하나로 같은 fixture를 같은 옵션으로
돈다. --no-ignore는 `ignore: false`, --max-warnings=0은 경고가 하나라도
있으면 실패, 파일이 없거나 설정을 못 읽으면 CLI처럼 2로 둔다. 실패
보고는 CLI 기본과 같은 stylish 형식이다. 같은 repo의 check-architecture.ts
·check-i18n.ts가 이미 API를 쓴다. 검사 대상·판정·통과 문구는 그대로다.
위험·한계: CLI가 아닌 API로 돌아 eslint CLI만의 동작(캐시, 색) 차이는
있다. 판정에는 쓰지 않는다.
검증(desktop,
|
||
|
|
79a225b6f9 |
fix(scripts): verify.sh parts가 게이트 명령의 args를 넘긴다
문제: `scripts/verify.sh parts <ID>`는 게이트의 명령을 하나씩 돌리면서 config/ci/gates.json 명령의 `script`만 읽고 `args`를 버린다. 그래서 FE-GATE-009의 `review:a11y-manual -- --format-only`가 인자 없이 돌아 release 증거를 찾다가 rc=1이 되고, production 게이트의 `drill:runbook -- FE-RB-00N --release-root …` 여섯 개도 다른 명령이 된다. ci:gate(run-ci-gate.ts)는 `pnpm <script> ...args`로 돌려 영향이 없다. desktop 측정에서 parts만 009를 실패로 냈다. 고른 방법: 계약을 읽는 python이 필드를 \x1f로, args를 \x1e로 나눠 내보내고 bash가 배열로 받아 `corepack pnpm -s <script> ...args`로 돌린다. 탭 구분은 빈 expectedExitCode 칸이 이어지는 탭과 합쳐져 다음 칸이 밀리므로 쓰지 않았다. 위험·한계: args 안에 \x1e·\x1f가 들어가면 잘못 나뉜다. 지금 계약에는 없다. 검증(노트북): python3 -m unittest discover -s scripts/tests 통과. 새 시험은 args가 있는 게이트 7개 모두에서 수정 전 실패, 수정 뒤 통과. |
||
|
|
7b09c215f0 |
test(docs): verify:documentation을 띄우는 시험에 넉넉한 시간을 준다
문제: tests/unit/documentation-readiness.test.ts의 사례마다 verify:documentation을 새 프로세스로 띄운다. 이 브랜치에서 그 검사가 살아 있는 문서 전부를 읽게 돼 한 번 도는 시간이 늘었고, 부하가 큰 desktop(load 25)에서 FE-GATE-020의 기능 생성 드릴이 사본 안에서 이 파일을 돌릴 때 세 사례가 기본 시간 10초를 넘겨 실패했다. 같은 사례는 부하가 낮을 때 1~8초다. 고른 방법: 이 파일의 사례에 저장소 관례대로 시간 한도 60초를 준다 (`VERIFY_TIMEOUT`). 그리고 livingDocuments가 문서 내용을 읽지 않고 경로만 고르게 해 한 번 도는 일을 줄인다. 버린 안: vitest 전역 testTimeout을 올리는 것(다른 시험의 멈춤을 늦게 알게 된다). 위험: 진짜로 멈춘 검사를 60초 뒤에야 알게 된다. 검증: desktop에서 이 파일과 FE-GATE-005·FE-GATE-020을 다시 돌린다. |
||
|
|
743f6fcc68 |
fix(docs): 문서 경로 검사가 줄임표 「…」를 자리표시자로 본다
문제: 하네스 PR #13이 더한 scripts/hooks/README.md는 `node scripts/…`처럼 줄임표 「…」(U+2026)로 「아무 스크립트」를 적는다. 참조 검사가 살아 있는 문서 전부로 넓어지자 verify:documentation이 `scripts/…`를 없는 경로로 잡아 실패한다. 경로 검사는 `...`만 자리표시자로 알고 「…」는 몰랐다. 같은 repo의 문서 검사(scripts/lib/docs-system.ts의 PLACEHOLDER)는 이미 「…」를 자리표시자로 본다. 고른 방법: verify-documentation-readiness.ts의 경로 후보 거르기에 「…」를 더해 두 검사를 맞춘다. 버린 안: 하네스 문서의 표기를 바꾸는 것(같은 표기를 다른 문서도 쓸 수 있고, 검사 둘이 다르게 판정하는 것이 원인이다). 위험: 「…」가 든 진짜 경로는 검사에서 빠진다. 파일 이름에 「…」를 쓰는 일은 없다고 본다. 검증: documentation-readiness 시험의 자리표시자 사례에 `node scripts/…`를 더했다. 고치기 전 코드에서는 그 사례가 실패하고 고친 뒤 통과한다(desktop). |
||
|
|
5757742ed0 |
docs(work): 하네스 문서를 새 문서 위치와 검사 범위에 맞춘다
문제: 하네스 PR #13이 더한 작업 매뉴얼·규칙은 이 브랜치가 바꾼 문서 체계의 옛 모습을 적는다. - 옛 경로: `docs/architecture/decisions/`, `docs/superpowers/`, 루트 `SPEC.md`, 목표 설계였던 `docs/testing/frontend-platform-testing-strategy.md` - 옛 검사 범위: 「docs/README.md 1절이 링크한 문서, 폴더 링크는 바로 아래 .md만」. 지금 verify:documentation은 살아 있는 문서 전부를 보고 언어· 문체·숫자·머리 블록도 본다 - 옛 docs/README.md 절(1절 묶음 / 2절 목표 설계 / 3절 작업 이력)과 README 절 이름(「Support scope」, 「Updating a copied project」) - #13의 template-contract-documents 시험은 README 지워도 되는 표를 `docs/superpowers/` 행으로 찾는데, 그 행은 이제 없다 고른 방법: 그 줄만 새 위치·새 절 이름·새 범위로 고친다(.claude/rules/docs.md, docs/work의 docs-writing·operate·research-design·reference 다섯, docs/problem-statement.md). 시험은 `docs/history/` 행으로 표를 찾는다. docs/work/evidence.md는 백엔드처럼 매뉴얼 규칙의 근거 기록이라 고치지 않고 `HISTORY_HOLDERS`에 넣어 참조·숫자 검사에서 뺀다. 위험: 하네스 문서의 다른 문장은 건드리지 않았다. 하네스 세션이 쓴 뜻을 바꾸지 않으려는 것이다. 검증: 문서 검사 여섯이 0건, `git grep -n -E 'docs/superpowers|architecture/decisions'`가 기록·CHANGELOG·출처 표시 밖에서 0건. |
||
|
|
fb446e471e |
Merge branch 'main' into claude/fe-b-docs-korean-645f55
하네스 PR #13(main
|
||
|
|
7cd2d9e89b |
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
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. |
||
|
|
9676101a4d |
chore(merge): main을 받은 정리 3단계 브랜치를 받는다
PR #16은 PR #14(chore/layout-3-merge) 위에 쌓았다. #14가 하네스 PR #13이
들어간 main을 합친 커밋(
|
||
|
|
568f332892 |
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
main(
|
||
|
|
5fab0e462a |
fix(scripts): adapter 목록 합계를 맞추고 verify.sh parts에 SOURCE_DATE_EPOCH를 준다
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (pull_request) Failing after 24s
frontend-quality-gates / FE-GATE-002 / lint (pull_request) Failing after 27s
frontend-quality-gates / FE-GATE-003 / typecheck (pull_request) Failing after 27s
frontend-quality-gates / FE-GATE-004 / runtime-schema (pull_request) Failing after 36s
frontend-quality-gates / FE-GATE-005 / unit (pull_request) Failing after 25s
frontend-quality-gates / FE-GATE-007 / integration (pull_request) Failing after 26s
frontend-quality-gates / FE-GATE-011 / build (pull_request) Failing after 26s
frontend-quality-gates / FE-GATE-012 / bundle (pull_request) Failing after 28s
frontend-quality-gates / FE-GATE-013 / security (pull_request) Failing after 25s
frontend-quality-gates / FE-GATE-020 / removability (pull_request) Failing after 32s
frontend-quality-gates / FE-GATE-008 / e2e (pull_request) Failing after 2m56s
frontend-quality-gates / FE-GATE-009 / accessibility (pull_request) Successful in 3m45s
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 / FE-GATE-006 / component (pull_request) Failing after 36s
frontend-quality-gates / FE-GATE-010 / architecture (pull_request) Failing after 1m28s
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(트리
|
||
|
|
f117a5af41 |
docs(src): 계층 폴더마다 지역 규칙 AGENTS.md를 두고 CLAUDE.md가 가져온다
계층별 규칙이 Claude만 읽는 .claude/rules/에만 있어 다른 에이전트에는 보이지 않았다. 하네스 자료의 3단계는 레이어마다 그 폴더에 AGENTS.md다. src/의 9개 계층 폴더마다 AGENTS.md(16~20줄)를 둔다: 그 폴더가 하는 일, 그 폴더에만 걸리는 import 금지(.dependency-cruiser.json에서 from이 그 폴더에 맞는 규칙을 뽑아 이름과 함께), 검사하는 게이트, 테스트 위치. 모든 폴더에 걸리는 규칙은 루트 AGENTS.md와 layers.md를 가리킨다. 옆에 @AGENTS.md 한 줄 CLAUDE.md를 둬 Claude Code가 그 폴더 파일을 열 때 같은 책을 읽는다(백엔드와 같은 짝). - .claude/rules/adapters·features는 폴더 AGENTS.md를 가리키게 줄였다. - scripts/check-work-docs.py: src/**/AGENTS.md도 이력 ID 0·200줄·짝·링크를 본다. 훅 N5는 이 파일들을 노트북 확인 파일로 친다. - docs/reviews/adapters/INVENTORY.md: check:adapter-inventory가 src/adapters 아래 추적 파일을 모두 요구하므로 두 행(142·143)을 더했다. - 루트 AGENTS.md 지도가 가장 가까운 src/<계층>/AGENTS.md와 비전·문제 정의 양식을 가리킨다. 버린 대안: .claude/rules/만 두기(다른 에이전트가 못 읽는다), 폴더 CLAUDE.md 없이 AGENTS.md만(Claude Code는 같은 폴더에 CLAUDE.md가 없고 Read로 열 때만 읽어 백엔드와 갈린다). 위험·한계: 규칙 이름은 지금 규칙 파일에서 뽑았다. 규칙을 더하거나 바꾸면 이 문서도 손으로 고쳐야 한다(정본은 규칙 파일과 check:architecture). 검증: scripts/verify.sh docs rc=0(src/**/AGENTS.md 9개, 최대 20/200), python3 -m unittest discover -s scripts/tests 62건 통과. |
||
|
|
11530b1adf |
docs: runbook·보안·스타일·접근성·계약·테스트 문서와 모듈 README를 한국어로 옮긴다
문제: docs/runbooks, docs/security, docs/styling/design-tokens.md, docs/accessibility, docs/contracts, docs/testing/taxonomy.md와 src/adapters/browser-transfer/image-cdn/README.md는 본문이 영어다. PRODUCT.md는 「~합니다」 체라 한 문서 안 문체 규칙(「~한다」)과 다르다. 고른 방법: 뜻을 바꾸지 않고 옮긴다. runbook 제목의 ID와 오류 code, 기록 양식의 영어 키(`Status:`, `M1 Keyboard:` 등, 코드 블록 안)는 그대로 둔다. PRODUCT.md는 디자인 도구가 읽는 제목(`## Users` 등)을 두고 문장 끝만 바꾼다. 위험: 이 커밋으로 문서 검사의 예외 목록이 빈다. 앞으로 영어 문서나 높임 문체를 더하면 verify:documentation이 실패한다. 검증: 백틱 span·링크 대상·코드 블록을 옮기기 전과 python으로 비교해 같다. 문서 검사 여섯이 모두 0건이고 예외 목록과 FROZEN이 비었다. |
||
|
|
45e8cb774c |
docs(operations): 운영 문서와 adapter 재검토 처리 원장을 한국어로 옮긴다
문제: docs/operations의 release-cache-rollback.md와 adapter-remediation-ledger.md는 본문이 영어이고, 나머지 복구 문서와 ci-quality-gates.md에도 영어 문단이 남아 있다. 고른 방법: 뜻을 바꾸지 않고 옮긴다. 원장은 check:remediation-ledger가 읽으므로 같은 변경에서 스크립트를 맞춘다. - `SECTION_HEADING`을 옮긴 절 제목(`## 세 번째 재검토 (2026-08-14)`)으로 - 「모두 닫혔다」를 잡는 `BLANKET_CLOSURE`에 한국어 대안을 더한다. 영어 대안은 원장이 인용한 옛 문장을 잡도록 그대로 둔다 - 표 구조, id 칸, disposition 칸의 백틱 값, file-transfer 예산 숫자는 그대로다 - ci-quality-gates.md의 advisory 표가 복사한 zod·react-router 버전을 `package.json`·`pnpm-lock.yaml`을 가리키게 바꾼다(number 검사) 위험: check:remediation-ledger는 게이트 밖이라 CI가 돌리지 않는다. desktop에서 손으로 돌려 확인했다. 검증: dispositions.json의 id 25개가 그 절의 행과 맞는지, 예산 숫자가 있는지를 스크립트로 확인했다. 문서 검사의 language·number 줄이 0이 되어 예외 목록에서 지웠다. |
||
|
|
af10cae9a6 |
docs(architecture): 현재 계약 문서와 매뉴얼의 영어 부분을 한국어로 옮긴다
문제: docs/architecture의 현재 계약 문서 가운데 scale-architecture.md, starter-experience.md, capability-consumer-experience.md, contract-ownership.md, static-delivery.md, review-evidence.md는 본문이 영어이고, backend-api-and-server-state-contract.md와 optional-adapter-recipes.md에는 영어 문단이 남아 있다. 고른 방법: 뜻을 바꾸지 않고 옮긴다. 백틱 안, 링크 대상, 절 번호(코드 주석이 `scale-architecture.md §N`으로 인용한다), 표 구조, 코드 블록은 그대로 둔다. 문서를 읽는 테스트와 절 이름을 인용한 곳을 같은 변경에서 고친다. - tests/unit/feature-tracked-files.test.ts: starter-experience.md 표를 자르는 시작·끝 문장과 표 행마다 찾는 낱말(`병합 충돌`) - 「Ownership declarations」「Adding a feature」를 인용한 주석 (create-feature.ts, generate-product-feature-index.ts, app-module.ts)과 docs/manual의 절 이름 인용 - optional-adapter-recipes.md의 recipe 개수 복사를 카탈로그를 가리키게 바꾼다(number 검사) 위험: create-feature.ts 417줄은 생성하는 context-module.ts의 JSDoc이라 새로 만드는 기능의 주석 글자가 바뀐다. 그 글자를 비교하는 테스트는 없다. review-evidence.md는 산문만 옮겼고 해시·점수 칸은 그대로다. 검증: 백틱 span·링크 대상·코드 블록·번호 제목을 옮기기 전과 python으로 비교해 같다. 문서 검사의 language 줄이 이 문서들에서 0이 되어 예외 목록에서 지웠다. |
||
|
|
7a9aefdf25 |
feat(docs): 문서 체계 검사를 verify:documentation에 더하고 입구 문서를 고친다
문제: 프론트 문서 체계는 백엔드와 다르다. docs/README.md는 "README와 입구 문서는 영어"라고 정해 두어 2026-11-07 소유자 결정(살아 있는 문서는 본문까지 한국어)과 반대이고, 기록의 머리 블록·언어·숫자 복사를 보는 검사가 없다. verify:documentation은 docs/README.md 1절이 링크한 문서의 경로만 본다. 고른 방법: 백엔드 scripts/check-docs.py의 규칙(language, head, number, map, readme, style)을 같은 이름·문턱으로 TypeScript로 옮겨 scripts/lib/docs-system.ts에 두고 verify:documentation(FE-GATE-017)이 부르게 한다. 참조 검사는 지금 있는 것을 그대로 쓰고 대상만 살아 있는 문서 전부로 넓힌다. FE-GATE-017 job은 workflow_dispatch(documentation 단계)에서만 돌아서, PR에서 실패하도록 merge 단계 FE-GATE-005의 documentation-readiness 시험이 이 repo를 그대로 두고 verify:documentation을 한 번 돌린다. - 버린 안: 새 게이트나 package script를 더하는 것. config/ci(정리 3단계·CI 세션 범위)와 CI 계약의 개수·해시를 건드린다. - 버린 안: check-docs.py를 그대로 복사하는 것. 프론트 CI 이미지와 도구는 Node뿐이고, 참조 검사(짝 백엔드 pin, 지운 샘플, 생성 산출물)는 이미 TS에 있다. - 예외 목록 scripts/docs-system-exceptions.txt는 줄기만 한다(줄마다 FROZEN 지문). 이 커밋의 줄은 아직 옮기지 않은 문서의 기준선이고 뒤 번역 커밋들이 지운다. - docs/README.md를 모든 문서 폴더를 덮는 지도와 수명·언어·머리 블록· 검사 규칙으로 다시 쓰고, 루트 README.md를 docs-system.md 6.1절의 필수 절 순서로 한국어로 다시 쓴다. README의 src 폴더 설명은 layers.md 표와 글자가 같아야 하므로 layers.md·overview.md·foundation.md를 같이 옮긴다. - README 「복사한 뒤 지워도 되는 것」을 읽는 정규식과, 문서를 바꿔 넣는 테스트의 기대 문자열을 새 한국어 문장으로 고친다. 검사기는 기록 폴더 이름을 적지만 지운 사본에서도 통과하므로 deletable-history-documents 테스트의 검사 대상에서 뺀다(그 이유를 테스트와 검사기 시험에 적었다). 위험: 파생 서비스가 이 변경을 받으면 자기 살아 있는 문서가 영어일 때 verify:documentation이 실패한다. CHANGELOG에 「먼저 할 일」로 적는다. review-evidence.md는 다른 작업 공간의 경로를 적은 사본이라 참조·숫자 검사에서 뺐다(HISTORY_HOLDERS). 검증: tests/unit/docs-system.test.ts(조건마다 실패 입력), documentation-readiness·template-feature-removal-documents· deletable-history-documents 시험, verify:documentation을 desktop에서 돌렸다. |
||
|
|
f6b2b96c53 |
ci(gates): 검사기 자기 시험과 gating 검사를 main 단계로 내리고 계약 기준선을 지운다
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절 |
||
|
|
0739f26b80 |
ci(gates): merge 단계 job 14개를 셋으로 합친다
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절 |
||
|
|
c50da34712 |
feat(scripts): verify.sh가 인자를 넘기고 원격에서 바뀐 파일을 돌려받는다
cold-read 시험에서 두 곳이 막혔다. script 단계가 인자를 넘기지 못해 test:sample-removal -- --feature=<id>를 돌릴 수 없었고, desktop에서 만든 파일(create:feature, 초기 JS 기록 다시 쓰기)을 노트북으로 가져올 길이 없었다. dry-run은 공백 든 인자를 실제와 다르게 보였다. - script <이름> -- <인자…>: 인자는 script가 하나일 때만 넘긴다. - exec -- <명령…>: 한 테스트 파일이나 package script가 아닌 node 스크립트. - 원격에서 바뀐 파일은 로그 폴더의 changes.patch에 남고, --apply-back이면 노트북 작업 트리에 얹는다. - VERIFY_SNAPSHOT=1이면 artifacts·dist·test-results를 snapshot/에 복사한다 (리뷰어가 함께 읽는 사본). VERIFY_INSTALL=0은 설치를 건너뛴다(시험용). - dry-run이 인자를 %q로 보인다. - 원격 호출은 단계 다음에 --on here를 둔다. 뒤에 두면 `--` 뒤 명령 인자가 되어 원격이 자기를 다시 원격으로 보냈다(시험에서 잠금 교착으로 드러났다). - 원격 준비가 일찍 실패해도 /tmp의 패치 파일을 지운다. 위험·한계: --apply-back은 노트북 작업 트리가 원격 기준과 다르면 패치가 얹히지 않는다. 그때는 rc=4와 원격 패치 경로를 알린다. 검증: python3 -m unittest scripts/tests/test_verify.py 통과(인자 전달, exec, 잘못된 인자 10가지가 원격 호출 0, 가짜 ssh로 원격에서 만든 파일 둘을 돌려받음, 바뀐 것 없는 단계의 changes.patch는 빈 파일). |
||
|
|
e902e657d1 |
test(layout): 저장소 배치 규칙 R3~R9를 검사로 두고 매뉴얼에 적는다
소유자가 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절 |
||
|
|
79dc945a67 |
refactor(layout): 루트 경로 목록을 등록부 하나에서 고르고 schemas/를 옮긴다
루트 항목 하나를 옮기려면 코드 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절 |
||
|
|
bf485f449a |
refactor(typecheck): 음성 타입 fixture 23개를 실행기 하나로 돈다
음성 타입 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 |
||
|
|
98f5c6e73e |
docs(docs): AGENTS.md와 docs/work를 문서 검사에 넣고 템플릿 계약으로 둔다
README의 지워도 되는 파일 표가 루트 CLAUDE.md를 "템플릿 repo 자신의
리뷰 지시, 자기 것으로 바꿔라"로 분류했다. 소유자 결정(2026-11-07 Q4)은
루트 지침을 템플릿 계약으로 정했다. 그리고 AGENTS.md와 docs/work/는
verify:documentation 범위 밖이라 그 안의 경로·script·게이트 ID가 틀려도
아무 검사도 알리지 않는다.
- README: 문서 절에 AGENTS.md와 docs/work/ 포인터를 더하고, 지워도 되는
표에서 CLAUDE.md 행을 빼고 docs/ledger/estimates.jsonl("줄을 비운다")을
넣는다.
- docs/README.md 1절: ../AGENTS.md, work/, work/reference/를 링크한다.
- tests/unit/template-contract-documents.test.ts: 지워도 되는 표에
AGENTS.md·CLAUDE.md·.claude·docs/work가 없고, 1절이 셋을 링크하는지
본다. 표는 제목이 아니라 docs/superpowers/ 행으로 찾아 제목을 옮겨도
돈다. 문서를 읽으니 REMOVAL_FIXTURE_DOCUMENT_TESTS에 올렸다.
- deletable-history-documents.test.ts: CLAUDE.md 패턴을 뺀다(이제 지워도
되는 문서가 아니다).
- 제거 드릴의 문서 사본(REMOVAL_FIXTURE_DOCUMENT_TARGETS)과
template-feature-removal-documents.test.ts의 사본에 AGENTS.md를 더한다.
사본 안에서 검사기를 돌리므로, 1절이 링크한 AGENTS.md가 없으면
FE-GATE-020과 그 단위 시험이 실패한다.
버린 대안: AGENTS.md를 링크하지 않고 백틱으로만 적기. 검사가 빠진다.
위험·한계: 문서 체계 세션이 README를 한국어로 옮기면 표 제목이 바뀐다.
새 시험은 행으로 찾지만, verify-documentation-readiness.ts의 지운 이력
목록은 영어 제목을 읽으니 그 세션이 같이 고친다.
검증: 새 시험은 README·docs/README.md를 고치기 전 트리에서 둘 다
실패했고(desktop test:unit), 고친 뒤 통과한다. verify:documentation과
merge 단계는 PR 전 합친 트리에서 돌린다.
Refs: design-docs harness/01-harness-design.md 4.4절·13절 Q4
|
||
|
|
9d65a41d82 |
chore(ledger): 예측·실측 장부를 두고 이 작업의 착수 예측을 남긴다
작업마다 착수할 때의 예측과 끝날 때의 실측을 남길 곳이 프론트에 없었다. 소유자 결정(2026-11-07 Q11)은 repo마다 docs/ledger/estimates.jsonl이다. docs/ledger/README.md(백엔드와 같은 형식)와 estimates.jsonl을 두고, 여러 브랜치가 끝에 줄을 더해도 병합이 멈추지 않게 .gitattributes가 merge=union을 준다. 첫 줄은 이 작업(fe-c-harness)의 착수 예측이다. 위험·한계: 복사한 프로젝트는 템플릿의 줄을 받는다. README 지워도 되는 표에 "줄을 비운다"로 적는다(뒤 커밋). 검증: python3 -m unittest scripts/tests/test_ledger.py 통과. Refs: design-docs harness/01-harness-design.md 10절·13절 Q11 |
||
|
|
c6e4252802 |
feat(scripts): 검증 진입점 scripts/verify.sh가 단계를 desktop으로 옮겨 돈다
desktop에서 게이트를 돌리는 법이 문서와 세션마다 다른 손 절차였다 (checkout 바꾸기·되돌리기, CI env 넣기, runner 스크립트 복사). 같은 빈틈이 되풀이됐고, 공유 checkout의 브랜치를 바꾼 채 두는 위험이 있었다. scripts/verify.sh <단계>는 claude-harness template/scripts/verify.sh의 운반부를 쓰고 단계를 채운다. - 단계: config/ci/gates.json의 stage id(merge·release·production·field· documentation)는 그 gateIds 전부를 ci:gate로, gate <ID>…, parts <ID>(그 게이트의 명령을 하나씩 끝까지, FE-GATE-013 진단용), script <이름>…, docs·hooks(노트북). stage는 실패가 있어도 끝까지 돌고 게이트마다 rc와 초를 남긴다. - desktop: 지금 트리를 기준 커밋에 대한 패치로 보내 공유 checkout에서 새 worktree를 만들고, 트리 해시를 맞춘 뒤 commit-tree로 깨끗한 HEAD를 만든다. CI=true pnpm install --frozen-lockfile --offline 뒤 flock 잠금 아래 CI env(CI, VITE_COMMIT_SHA, VITE_BUILD_ID, RELEASE_ID, CI_RUNNER_IMAGE)로 돌리고, /tmp/claude-gates/<이름>/에 summary·로그·게이트 산출물· status-after를 남긴 뒤 worktree를 지운다. push하지 않는다. - 잘못된 단계·게이트는 desktop에 보내기 전에 노트북에서 거절한다. 버린 대안: 공유 checkout의 브랜치를 잠금 안에서 바꾸고 되돌리기(지금 손 절차). 다른 세션의 checkout을 건드리고, 끝나지 않으면 바뀐 채 남는다. 위험·한계: 새 worktree의 오프라인 설치는 desktop pnpm store에 의존한다. 없으면 온라인 설치로 넘어간다. CI workflow가 아직 이 스크립트를 부르지 않는다(CI 재편 몫). 검증: python3 -m unittest scripts/tests/test_verify.py 통과(stage마다 계약의 gateIds, parts의 명령, 잘못된 인자는 원격 호출 0, 가짜 ssh로 패치 → 같은 트리 해시 → 로그 → worktree 정리, 없는 원격 repo는 rc=4). desktop에서 실제 운반을 한 번 돌려 트리 해시 일치와 worktree 정리를 봤다. Refs: design-docs harness/01-harness-design.md 6절 |
||
|
|
9961ecb106 |
feat(hooks): 편집 직후 경계·게이트 기준·문서 알림과 턴 끝 desktop 알림을 건다
경계 위반, 늘어난 skip·only, 작업 매뉴얼 규칙 위반은 desktop 게이트에서야 드러났고, desktop 검증 없이 턴을 끝내도 아무것도 알리지 않았다. scripts/hooks/hooks.py(백엔드 hooks.py와 같은 모양, 표준 라이브러리와 git만)를 .claude/settings.json에 단다. - N3: src TypeScript를 고치면 import를 .dependency-cruiser.json의 forbidden 규칙(path·pathNot·$1)에 그대로 대 본다. 규칙 파일을 읽으므로 규칙이 바뀌면 따라간다. - N6: 테스트에 .skip·.only·.fixme·.todo가 마지막 커밋보다 늘거나, 예산· 기준선·ungated 목록·스냅숏을 고치면 알린다. - N2: .md를 고치면 scripts/check-work-docs.py의 실패 줄을 알린다. - N5: desktop만 확인할 수 있는 파일을 고친 뒤 desktop 실행이 없으면 턴 끝을 한 번 막고 이유를 준다. 모두 넛지다. repo 안 편집에 되돌릴 수 없는 것이 없어 차단 훅은 없다. 고른 방법: 노트북에서는 정적 검사만 하고 포맷·린트·타입은 desktop scripts/verify.sh에 둔다(brief, 2026-11-08). 설계 13절 Q6은 편집 훅에서 한 파일 eslint를 골랐지만, 프론트 eslint는 pnpm·node_modules가 필요해 "pnpm은 desktop에서만" 규칙과 부딪친다. 위험·한계: N3는 정규식으로 import를 뽑아 주석 속 따옴표 같은 드문 모양을 놓칠 수 있다. 정본은 check:architecture다. 훅 시험은 아직 CI workflow가 부르지 않는다. 훅은 세션 시작에 읽혀 이 세션에서는 돌지 않았다. 검증: python3 -m unittest scripts/tests/test_hooks.py 26건 통과. 실제 규칙과 src 377개 파일에서 N3 알림 0(거짓 양성 시험). 조건 하나씩 끈 변이 10개를 모두 시험이 잡았다. Refs: design-docs harness/01-harness-design.md 5.2·5.3절 |
||
|
|
9f8596280c |
feat(claude): 경로별 규칙·스킬·결과만 돌려주는 서브에이전트를 둔다
Claude Code 세션이 테스트·문서·adapter·게이트 기준·기능 폴더를 고칠 때 읽을 규칙이 루트 한 파일에 섞여 있었고, desktop 실행과 새 기능 절차를 부르는 스킬, 결과만 받는 리뷰어 정의가 없었다. - .claude/rules/: tests, docs, adapters, gates-and-budgets, features. paths로 그 파일을 열 때만 읽힌다. - .claude/skills/: desktop-gates(scripts/verify.sh로 desktop에서 돌리기), new-feature(create:feature부터). 소유자 결정대로 모델이 부르고, 설명에 발동 조건을 문단으로 쓴다. 본문은 정본 playbook을 가리킨다. - .claude/agents/: arch-reviewer(경계 규칙), verify-app(desktop에서 빌드·브라우저 확인), code-simplifier. 쓰기 도구가 없다. - .claude/settings.json: 하네스 플러그인 harness@claude-harness를 켜고 실제 .env 읽기·쓰기를 막는다. Agent deny는 두지 않는다. - .gitignore: .claude/는 이 넷만 추적하고 worktree·훅 상태· settings.local.json은 무시한다. 버린 대안: Agent deny 유지(소유자 결정 2026-11-07 Q5가 풀었다), 스킬을 사용자 호출 전용으로(Q9가 모델 호출을 골랐다). 위험·한계: 규칙 paths는 지금 있는 파일로 시험하지만 Claude Code가 실제로 읽는지는 이 세션에서 보지 않았다(설정은 세션 시작에 읽힌다). 검증: python3 -m unittest scripts/tests/test_claude_setup.py 통과 (서브에이전트 쓰기 도구 없음, 스킬 설명 길이와 발동 조건, 규칙 paths가 가리키는 파일 있음). Refs: design-docs harness/01-harness-design.md 13절 Q3·Q5·Q9 |
||
|
|
6e8cc963ec |
docs(agents): 루트 AGENTS.md를 정본으로 두고 CLAUDE.md가 가져온다
루트에는 리뷰 기준만 담은 CLAUDE.md(26줄)가 있었다. 꼭 지킬 경계 규칙, 지도, 검증 진입점, 맡은 일 라우터가 없었고, "서브에이전트를 병렬로"는 소유자 결정(2026-11-07)과 맞지 않았다. AGENTS.md(35줄)에 무엇인가 · 꼭 지킬 것 5 · 지도 · 맡은 일 · 검증 · 일하는 방식을 둔다. CLAUDE.md는 @AGENTS.md와 Claude 전용 줄(10줄)이다: settings·훅, 하네스 플러그인과 비대화형 설치 두 명령, 규칙·스킬· 서브에이전트 위치, 리뷰 기준이 옮겨 간 곳, 소유자 환경. 리뷰 기준과 전체 리뷰 절차는 docs/work/reference/review-criteria.md와 docs/work/improve.md 4.1절로 옮겼다. scripts/check-work-docs.py는 백엔드 검사기를 옮긴 것이다: 지도 40줄, CLAUDE.md 15줄, README 80줄, playbook 150줄, 진입 경로 350줄, 9절 뼈대, 진입 문서의 이력 ID 0, 상대 링크. 이력 패턴에 이 repo의 꼴(1105 README, P-43·O-12·D-14)을 더했다. 표준 라이브러리만 써서 노트북에서 돈다. 버린 대안: CLAUDE.md만 두기(다른 에이전트가 못 읽는다), 심볼릭 링크 (Claude 전용 줄을 둘 수 없다). 위험·한계: 지도 40줄은 자료와 백엔드에 맞춘 값이다. brief 상한 80보다 좁다. 검증: python3 scripts/check-work-docs.py rc=0, python3 -m unittest scripts/tests/test_check_work_docs.py 통과. Refs: design-docs harness/01-harness-design.md 4.3절·13절 Q1·Q2 |
||
|
|
e3c8db48ae |
chore(features): 참조 기능과 예제 화면을 지우고 레지스트리를 다시 승인한다
소유자 결정(2026-11-07, design-docs repo-structure/README.md 3.4절)으로 템플릿 샘플을 지운다. 샘플이 맡던 시험 대상은 앞 커밋들이 옮겼다. 참조 기능과 예제 화면, 두 context, 그 시험, e2e 3개, 수동 접근성 기록 7개, 런타임 프로필 키, test:reference-feature(명령, 산출물, 게이트 참조), 커버리지 정책 행을 지웠다. removable-template-features 목록은 비우고 장치는 남겼다: test:sample-removal은 인자가 없으면 목록을 하나씩 지우고, 비면 SKIP을 출력하고 보고서에 건너뛴 사례를 남긴다. 기능 스위치 시험과 홈 시작 링크 스위치 시험은 시험 전용 fixture 기능으로 옮겼다. browser soak은 생성 기능을 넣은 빌드에서 돈다. 문서의 샘플 경로를 고쳤다. 날짜가 붙은 설계·리뷰 기록의 본문은 그대로 두었다. 레지스트리 기준선(update:registry-baseline, OWNER DongHyeonka), CI 계약 기준선과 workflow, 초기 JS 기록(194,354B, 17파일, 첫 기능 6,327B, 기능 539B, context 4B)을 다시 받았다. 위험: 레지스트리 행 삭제는 breaking이다. 샘플을 고쳐 쓰는 다운스트림은 수정/삭제 충돌을 만난다. 성능 lab의 기능 라우트 측정은 템플릿에 공개 기능 라우트가 없어 measured:false다. TEMPLATE_FIXTURE 출처는 플랫폼 코드에 남았다. 검증(desktop): check:types, lint, check:architecture, check:registries, check:ci, verify:documentation, test:unit, test:component, test:contract, test:integration, test:recipes, test:coverage(Risk coverage PASS 378/378, 문턱 68개), test:e2e 183, test:a11y, test:visual, test:storybook, test:browser-capabilities, test:feature-scaffold PASS(76 checks), test:sample-removal SKIP, build, check:bundle. |
||
|
|
b2042de9be |
test(scale): 규모 측정을 참조 기능 대신 생성 기능 사본으로 잰다
규모 측정(S4 3.1절 S-6)은 참조 기능을 복사해 이름을 바꿔 잰다. create:feature의 planFeature로 사본마다 --with-create --keyed 기능 파일을 만든다(자기 계약 패키지와 topic, context당 200개). 초기 JS 기록에 firstFeatureGzipBytes를 더하고, context 비용은 둘째 기능을 새 context에 둘 때와 같은 context에 둘 때의 차이로 잰다. 옛 정의는 기능이 없는 템플릿에서 첫 기능의 공용 코드까지 context 비용으로 세어 5,788B로 상한 512B를 넘었다. 몇 바이트짜리 비용에는 기록 허용치 하한 16B를 둔다(빌드 ID에 따라 gzip이 1~2B 흔들린다). 이 트리(샘플이 아직 있는 상태)의 기록: 204,266B, 27파일, 첫 기능 797B, 기능 521B, context 12B. 위험: 성장 기준선(0·25·100개)은 샘플을 지운 트리에서 뒤 커밋이 다시 잰다. 이 커밋의 기준선 파일은 아직 참조 사본으로 잰 값이다. 검증(desktop): feature-shape-growth 등 4파일 57 passed, test:unit 통과. |
||
|
|
01cac930e0 |
docs(manual): 샘플 대신 생성 기능 경로와 시험하는 코드 조각을 예제로 둔다
매뉴얼 예제 칸 14곳(S4 3.3절)과 산문 30여 곳이 참조 기능을 가리킨다. problem details(Envelope가 아닌 백엔드) 응답 매핑의 예는 참조 기능에만 있다. 생성기 출력이 그 모양을 만들면 그 경로로 바꿨다. 없으면 매뉴얼 안 코드 조각으로 썼다: problem details의 분류와 매핑(02 결정표 4절, 소유자 결정 D1), 도메인 모델, 검색값 스키마와 hook, 실패 행동 hook, 403 페이지 시험. 조각마다 manual-code-block 표식에 둘 경로를 적는다. tests/unit/manual-code-blocks.test.ts가 저장소 사본에 create:feature invoice-feature --with-create를 만들고 조각을 그 경로에 그대로 넣어 tsc(app, test), eslint, check:architecture, 그 기능 폴더의 vitest를 돈다. 조각의 동작은 tests/fixtures/manual-code-blocks/가 본다. 위험: 403 조각은 본문 없는 403으로 답한다. 공유 시나리오 forbidden-403(JSON 본문)은 jsdom + MSW에서 실행기의 본문 cancel이 끝나지 않아 화면이 로딩에 머물렀다. 실행기는 고치지 않았다. 사본에 이미 invoice-feature가 있는 프로젝트에서는 이 시험이 생성 단계에서 실패한다. 검증(desktop): test:unit 213 files 3096 passed(이 커밋까지), verify:documentation PASS_SCOPED, lint 통과. |
||
|
|
b72cd7d4a7 |
test(fixtures): local-draft 샘플을 IndexedDB 소비자 fixture로 옮긴다
src/features/local-draft-feature는 기능이 아니라 IndexedDB recipe의 소비자다. 시험 5개와 recipe가 쓰고, 그래서 생성기에 NOT_A_FEATURE 예외가 있었다(S4 3.1절 S-3). 코드를 tests/fixtures/indexeddb-consumer/로 옮기고 import만 고쳤다. NOT_A_FEATURE 표식은 이 폴더만 썼고 다운스트림 둘에도 없어 생성기에서 지웠다. 선언 없는 폴더는 밖으로 옮기라는 메시지로 실패한다. 매뉴얼 오류표, README, starter-experience, capability-consumer-experience, patterns를 고쳤다. 위험: fixture는 기능 폴더 밖이라 기능 계층 규칙(dependency-cruiser)이 걸리지 않는다. recipe가 tests/ 아래 파일을 type import한다. 검증(desktop): test:contract, test:recipes, test:browser-capabilities, test:unit 통과. |
||
|
|
c7e80f2f8a |
test(visual): 갤러리를 Storybook story로 옮기고 골든 대상을 바꾼다
예제 화면 /examples/ui·/examples/states가 visual 골든 2장과 갤러리
브라우저 시험의 대상이다. 2026-11-07 소유자 결정으로 예제 화면을
지우므로 그 역할을 먼저 옮긴다(design-docs repo-structure/
04-frontend-layout.md 9.2절 2단계 (1)).
두 갤러리 화면을 그대로 src/presentation/design-system/
galleries.stories.tsx로 옮겼다. 화면 단위 story(parameters.page)는
preview가 여백을 더하지 않아 앱 안과 같은 폭으로 그려진다. visual
설정은 Storybook 정적 빌드를 두 번째 web server로 띄우고
(TEST_VISUAL_WORKSHOP_PORT, 빌드 명령은 workshop 설정과 같은
scripts/lib/storybook-static.ts), 골든 2장은 그 story를 찍는다. 어두운
골든은 테마 선택기가 없어 시스템 dark(colorScheme)로 그린다. e2e의
갤러리 상호작용(텍스트 필드, 모달 포커스, 메뉴·탭·토스트, 열린 대화
상자 axe, 320px 리플로)은 tests/storybook/galleries.spec.ts로 옮겼다.
위험: 골든의 픽셀 색 허용치(threshold 0.2)는 그대로다. 미세한 토큰
변화는 옛 골든처럼 새 골든도 잡지 못한다.
검증(desktop): test:storybook 6 passed, test:visual 7 passed,
playwright-run-isolation 단위 시험 통과. 변이 확인: --color-action을
파랑→빨강으로 바꾸면 새 골든이 어두운 쪽 42,313px, 밝은 쪽 22,359px
차이로 실패했다. 옛 골든(main
|
||
|
|
95141f1d85 |
docs(a11y): 한 자원 GET을 부르지 않는 라우트는 자기 paramsSchema를 둔다고 적는다
문제: 9c4cddc의 report는 "로그인 라우트의 paramsSchema = 한 자원 GET의 입력 스키마"만으로 실패 화면 기록을 기대한다. 그 라우트의 페이지가 그 GET을 실제로 부르는지는 보지 않는다. 손으로 쓴 기능이 하위 항목 작성 폼 (`/things/:thingId/parts/new`)의 paramsSchema로 상세 GET과 같은 ThingParams를 쓰면, spec은 한 자원 응답을 보지 못해 기록을 남기지 않고 report가 `a11y.json not written:`으로 FE-GATE-009를 실패시킨다. 그런데 errors.md는 "spec의 기록 호출을 본다. 기능 파일은 고치지 않는다"고만 안내했다. 이 경우 고칠 곳은 기능의 라우트 스키마 ID다. 고른 방법: 리뷰의 첫 방향. report 판정은 그대로 두고 안내를 고친다. errors.md 행이 두 원인(spec이 기록을 놓침 / 페이지가 그 GET을 부르지 않음)과 각각 고칠 곳을 적는다. 매뉴얼 01 6단계에 같은 경우와 고치는 법 (그 라우트에 자기 paramsSchema)을 더했다. CHANGELOG 1106 절 11-01 행에 같은 줄을 더했다. report의 실패 문장 끝에도 같은 안내를 붙였다. 판정 조건과 문장 앞부분은 그대로라 단위 테스트의 기대(`stringContaining`)도 그대로다. 버린 대안: spec이 "기대했지만 보지 못함"을 따로 기록하고 report가 그 경우를 다르게 다룬다. report 판정이 바뀌어 이번 범위(문서) 밖이다. 위험·한계: 같은 스키마를 쓰면서 그 GET을 부르지 않는 라우트는 여전히 실패한다. 안내로만 풀린다. 그 라우트에 스키마를 따로 두면 FE-REG-SCHEMA 행과 route codec이 하나씩 는다. 검증: desktop batch에서 확인. 테스트 없음(문서와 실패 문장 끝). corepack pnpm verify:documentation node scripts/run-vitest.ts run tests/unit/a11y-report.test.ts tests/unit/changelog-review-ids.test.ts Refs: 1106/11-01 (diff review DR-05) |