fix(registries)!: 옮긴 worker 파일을 가리키게 하고 문서 검사가 registry 경로를 본다 #46

Merged
donghyeon.kang merged 2 commits from claude/be-main-red2-metrics into main 2026-11-18 12:44:06 +00:00
2 Commits
Author SHA1 Message Date
DongHyeonka a00d559c84 ci(docs)!: 문서 검사가 registry YAML이 가리키는 경로도 본다
pr / done (pull_request) Successful in 2m29s
문제: 코드 파일을 옮기는 PR은 docs/registries/*.yaml 행의 source·
registered_by가 옛 경로로 남아도 초록이다. scripts/check-docs.py의 reference
검사는 마크다운만 읽고, 행과 코드를 대조하는 MetricsRegistryCodeAlignmentTest·
HeaderRegistryRuntimeAlignmentTest는 main 단계에서만 돈다. #38이 이렇게
병합돼 main이 빨강이 됐고, main이 빨강인 동안 다른 PR 병합이 모두 멈췄다.

방법: reference 검사가 docs/registries/*.yaml의 줄에서 repo 경로 모양의 낱말
(PATH_ROOTS로 시작, 공백·따옴표·한글에서 끊는다)을 찾아 git이 아는 파일인지
본다. headers.yaml의 "service: src/..." 같은 접두어 붙은 값과 주석의 경로도
같은 규칙으로 잡는다. gates.md 2절에 「지표·헤더를 등록하는 코드를 옮기거나
바꿈 → :app-bootstrap:documentContractTest」 행을 따로 두고, 「지우거나 옮김」
행에 registry YAML을 적는다. docs/README.md 「문서 검사」 표와 관측 업그레이드
안내(14번 행)를 고친다.
버린 대안: (1) 대조 시험을 PR 단계로 옮기기 — 문서 대조는 main 단계라는
결정(2026-09-16)을 바꾸고 Gradle lane 하나를 PR에 더한다. (2) gates.md에
사람이 돌릴 lane만 적기 — #38도 그 표를 따랐어야 했지만 기계가 막지 않으면
다시 샌다.

PR 단계에 두는 이유(gates.md 7절 5번): 이미 PR에서 도는 check-docs.py의
기존 검사가 볼 파일만 넓힌다. 새 태스크·job이 없고 Gradle 없이 1초 안에
끝난다. 옮기는 PR에서 잡지 못하면 main이 빨강이 되어 모든 병합이 멈춘다.

위험·한계: 경로가 있는지만 본다. 파일은 남고 등록 줄만 다른 파일로 옮긴
경우는 여전히 main 단계 document-contract lane이 잡는다(gates.md 새 행).
파생 서비스는 registry 주석에 적은 경로가 없으면 PR에서 새로 실패한다. 주석은
지금까지 어떤 검사도 보지 않았다. source·registered_by는 main 단계 대조
시험에서 이미 실패하던 경로다.

검증: 노트북 `bash scripts/verify.sh docs` rc=0(스크립트 시험 170개 통과).
옛 metrics.yaml에서 `check-docs.py --only reference`가 rc=1로
metrics.yaml:878을 가리킨다. 새 시험 셋은 옛 check-docs.py에서 실패하고, 정규식
변이 셋(따옴표 안 값만 보기, 한글에서 안 끊기, 주석 건너뛰기)이 각각 시험
하나 이상을 실패시킨다.

BREAKING CHANGE: docs/registries/*.yaml의 값과 주석에 적은 repo 경로가 지금
트리에 없으면 PR 단계 documentCheck가 실패한다. 파생 서비스는
`python3 scripts/check-docs.py --only reference`로 자기 행·주석을 확인한다
(docs/upgrade/2026-11-round9-observability.md 14번).
2026-11-18 21:17:34 +09:00
DongHyeonka b43fd78c23 fix(registries): notification.queue.depth 행이 옮긴 worker 파일을 가리킨다
문제: main 99cc4f59(#38 병합) push run의 :app-bootstrap:documentContractTest가
MetricsRegistryCodeAlignmentTest.everyRowNamesTheMainFileThatRegistersIt에서
실패한다. #38의 2d274a684가 NotificationSchedulerWorker를
adapter:outbound:notification(platform/dispatch)에서
composition:notification-platform(composition/notification)으로 옮겼는데,
metrics.yaml의 notification.queue.depth 행 registered_by는 옛 경로를
가리킨다. 이 대조 시험은 main 단계(mainCheck)에서만 돌아 #38의 PR run은
초록이었다. #37은 이 파일을 건드리지 않았다.

방법: 코드가 맞다. 옮긴 것은 #38의 의도한 구조 변경이고 gauge는 새 파일
96줄에서 NotificationMetricName.QUEUE_DEPTH로 등록된다. 그래서 registry의
registered_by만 새 경로로 바꾼다.

같은 모양: #37·#38이 지우거나 옮긴 파일 27개의 옛 경로와 클래스 이름을
살아 있는 문서·registry에서 찾았다. 남은 것은 이 행 하나다.

검증: desktop, 트리 fcc67388, `./gradlew :app-bootstrap:documentContractTest
--rerun --no-build-cache` rc=0, 79개 통과(실패 0). 로그
~/be-main-red2-logs/c-doccontract.log. 수정 전 실패는 main run의 같은 태스크
(79개 중 1개 실패).

Fixes: 2d274a684e3a ("refactor(application)!: 시스템 쓰기와 운영자 연산을 유스케이스 계약 안으로 옮긴다")
2026-11-18 21:03:54 +09:00