build(deps)!: 의존성 취약점 HIGH·CRITICAL 37건을 버전을 올려 고친다 #4

Merged
donghyeon.kang merged 14 commits from claude/v1-vuln-fix-e089b9 into main 2026-11-07 13:42:09 +00:00
Owner

무엇을, 왜

PR 단계 차단 검사 trivy(dependency-vulnerability.yml의 「Block High and Critical vulnerabilities」)가 HIGH·CRITICAL 37건(CVE 24개)으로 실패한다. Gitea Actions를 켜면 이 단계가 모든 PR을 막는다. 37건은 구조 정리 전 트리(ac03192d)에도 같이 있었다.

이 PR은 37건을 버전 올리기로 고친다. 무시 목록(.trivyignore.yaml)에는 아무것도 더하지 않았다.

라이브러리 (설치 버전) 건수 처리 커밋
tomcat-embed-core 11.0.24 (CRITICAL), jackson 2.21.5, jackson 3.1.5 4+5+5 Spring Boot 4.0.8 → 4.0.9(tomcat 11.0.27, jackson 2.21.7·3.1.7) afe30e73
jackson 3.0.2 (build-logic만 씀) 10 카탈로그 jackson3 → 3.1.7 ff6fdf8d
grpc-netty-shaded 1.68.1 1 grpc 1.75.0, 짝인 protobufGrpc 3.25.8 3b9b738c
httpcore5·httpcore5-h2 5.3.6 2 BOM 속성 override: httpcore5 5.4.3 + 짝인 httpclient5 5.6.3 d5b324dd
guava (gRPC·Error Prone·Checkstyle이 가져옴) 4 새 카탈로그 묶음 pinned-*로 33.7.2-jre 고정(모든 구성) 2cf6aafd
plexus-utils 3.3.0 (Checkstyle) 1 pinned-plexus-utils 3.6.1 81573f70
lz4-java 1.10.1, snappy-java 1.1.10.7 (Kafka) 1+2 pinned-lz4-java 1.11.4, pinned-snappy-java 1.1.10.9 9fcab227
assertj-core 3.27.6 1 빌드에 없는 구성(지운 source set)의 옛 lockfile 줄. 5개 파일에서 지움 3744736c
querydsl-jpa 5.1.0 (고친 버전 없음) 1 persistence-jpa가 쓰는 타입(Predicate)이 있는 querydsl-core로만 컴파일. README도 고침 8e3bef0f, 6ad8f4b6

고른 방법과 버린 대안

  • 기본은 고친 버전 중 가장 작은 것이다. 짝으로 움직이는 라이브러리는 upstream이 선언한 짝을 따른다.
    • httpclient5 5.6.x는 httpcore5 5.4에 맞춰 빌드된다.
    • grpc-protobuf 1.75.0은 protobuf-java 3.25.8을 선언한다.
  • Boot BOM이 관리하는 것은 Boot 패치를 먼저 봤다. 4.0.9 하나로 15건이 풀렸다.
    • Boot 4.1.x는 버렸다. 마이너 업그레이드라 Kafka 4.2, httpclient5 5.6 등이 같이 바뀐다.
  • 어떤 leaf도 선언하지 않는 전이 의존성은 카탈로그 pinned-*에 두고, JavaConventionsPlugin이 Spring dependency management로 모든 구성에 건다.
    • Gradle constraint는 버렸다. Checkstyle·Error Prone 구성까지 닿게 하려면 구성마다 걸어야 한다.
    • Error Prone 2.51 · Checkstyle 14.4로 올리기도 버렸다. gRPC 쪽 guava가 남고, 새 검사 규칙이 들어온다.
  • QueryDSL은 세 안을 총괄에게 묻고 정했다.
    • 고른 안: querydsl-core로 바꾸기.
    • 버린 안: OpenFeign 포크로 좌표 옮기기, 90일 무시.
  • 고른 이유와 버린 대안은 커밋마다 본문에 있다. 고르는 순서는 결정 색인(docs/work/reference/decisions.md)에 두 행으로 적었다.

위험과 영향

  • 파생 서비스가 따라 할 일이 있다: 업그레이드 안내 B-54(docs/upgrade/2026-11-maturity-review.md 3.7절). 그래서 제목에 !를 달았다. 각 커밋 제목에는 !가 없다. push한 커밋이라 고쳐 쓰지 않았다.
    • merge 때 gradle.lockfile이 충돌하니 다시 써야 한다.
    • httpcore5 5.4.3은 HTTP client가 받는 HTTP/1 응답에 줄 길이 8192, 헤더 100개 상한을 기본으로 건다.
    • pinned-guava는 하한이 아니라 정확한 고정이다. 더 새 guava가 필요하면 그 leaf가 직접 선언한다.
  • Kafka 압축(lz4·snappy)은 이 저장소에서 켜지 않는다. 그래서 기존 테스트가 부르지 않는다. 탐침을 따로 돌렸다: kafka-clients 4.1.2가 새 jar로 압축 batch를 쓰고 다시 읽었다. 압축을 켠 실제 브로커 왕복은 보지 않았다.
  • 살아 있는 문서의 Boot 버전은 이 PR이 고치지 않았다. main에 들어온 번역이 이미 정본(src/gradle/libs.versions.toml)을 가리키게 바꿨다. 그래서 4.0.9로 올린 것도 문서에 따로 맞출 곳이 없다.
    • 「4.0.8」이 남은 곳은 일부러 둔 것뿐이다: 결정 기록 docs/adr/ADR-GRPC-001…:23, 업그레이드 안내 B-54의 「4.0.8 → 4.0.9」, 문서 검사 자기 시험, build-logic 테스트가 스스로 만드는 카탈로그.
  • MEDIUM 4건이 남는다. 게이트는 막지 않는다: opentelemetry-api·extension-trace-propagators 1.55.0, ognl 3.3.4.

검증

모두 desktop에서 돌렸다. 새 detached worktree에서 Gradle 명령마다 --no-build-cache를 붙였다. 로그는 ~/v1-vuln-fix-logs/({pr,main,tag}-summary.txt)에 있다.

대상은 head e6c3d1b9(트리 842483ba)다. main b3f63be6을 합친 트리다.

단계 결과 주요 수치
PR 28개 (gates.md 3절) 모두 rc=0 :ci :verifyDependencyLocks 6분 30초, 실행 1043·FROM-CACHE 0, 테스트 7390(skip 28) 실패 0 · optional ci 593 · web 35 · websocket 8+4 · httpclient 계약 17+17, Spring 7.0 23 · jpa pg16·pg18 각 432, migration 45 · redis 122 · build-logic 174 · minio 19 · 메시징 인증 37 · 문서 검사(check-docs와 자기 시험, check-work-docs, check-repo-layout, compose 검사) rc=0
main 18개 모두 rc=0 mainCheck 6분 52초, 테스트 394 · configuration-cache 3개 · integrationCheck 16분 9초, 958 · performanceCheck 26 · optional 성능 1, 통합 52 · http3 실험 360 · notification pr job 7개
태그 2개 모두 rc=0 releaseCheck -PgitRevision, 두 빌드
compose smoke 18 lane 통과 컨테이너 기록 80개 모두 restarts=0 oomKilled=false. 이미지를 이번에 새로 만들었다
빠른 시작 통과 scripts/bootstrap-local.sh: HTTP 200, status=UP
링크 검사(lychee 0.22.0 이미지) rc=0
  • FROM-CACHE는 두 곳뿐이다.

    • vtasks의 build-logic compileJava 1개: --rerun-tasks --no-build-cache로 다시 컴파일했고, 클래스 105개의 해시가 같다.
    • mainCheck의 75개: 모두 중첩 빌드(verifyFeatureScaffold) 안의 것이다. 바깥 빌드는 0이다.
  • fileserver·notification job 일부는 테스트 0으로 끝났다. 앞의 ci가 같은 worktree에서 이미 돌린 태스크라 UP-TO-DATE였다.

  • trivy aquasec/trivy:0.71.2(sha256:f5d0e600ecda7449e2a9b272805aef698631d3bb3f3a739a750de2c6819acdc9), 취약점 DB 2026-11-07 06:54 UTC, Java DB 01:07 UTC.

    • 기준 5ab1b418: rc=1, 37건(CVE 24개). 재현했다.
    • 이 PR의 head: HIGH·CRITICAL 단계 rc=0, 0건. KEV 목록(2026.11.06, 1769건)과 겹치는 것 0건.
  • 묶음 커밋마다 그 커밋의 트리에서 세 빌드의 lockfile을 다시 쓰고, 바뀐 leaf의 검사를 돌렸다. 숫자는 각 커밋 본문에 있다.

    • lockfile은 (좌표, 구성) 쌍으로 비교했고, 의도한 버전만 바뀌었다.
  • pinned 장치는 build-logic TestKit 테스트로 본다. 고치기 전 트리에서는 실패하고(pinned=null), 고친 뒤 통과한다.

  • 돌리지 못한 것: GitHub 전용 dependency-review·dependency-submission. Gitea에서는 건너뛴다.

리뷰어가 볼 곳

  • src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java: BOM 속성 override(httpcore5·httpclient5)와 pinned-* 반복문.
  • src/gradle/libs.versions.toml: 버전 변경과 「Pinned」 묶음 주석. CVE와 낡은 버전을 가져오는 곳을 적었다.
  • src/adapter/outbound/persistence-jpa/build.gradle, README.md: Querydsl.
  • lockfile은 기계적으로 만들었다. 명령은 ./gradlew resolveAndLockAll --write-locks, ./gradlew -p platforms/optional-build resolveAndLockAll --write-locks, ./gradlew -p build-logic dependencies --write-locks다. 커밋 3744736c만 다섯 파일을 지우고 같은 명령으로 새로 만들었다.

관련

  • 업그레이드 안내 B-54: docs/upgrade/2026-11-maturity-review.md 3.7절
  • 결정 색인: docs/work/reference/decisions.md 「취약점이 있는 의존성 버전」, 「Querydsl 취약 좌표」
  • main 병합: 1b0c14de(main b3f63be6, 충돌 없음). 합쳐진 업그레이드 안내의 머리는 고치지 않고 3.7절에 범위를 적었다(e6c3d1b9).
## 무엇을, 왜 PR 단계 차단 검사 trivy(`dependency-vulnerability.yml`의 「Block High and Critical vulnerabilities」)가 HIGH·CRITICAL 37건(CVE 24개)으로 실패한다. Gitea Actions를 켜면 이 단계가 모든 PR을 막는다. 37건은 구조 정리 전 트리(`ac03192d`)에도 같이 있었다. 이 PR은 37건을 버전 올리기로 고친다. 무시 목록(`.trivyignore.yaml`)에는 아무것도 더하지 않았다. | 라이브러리 (설치 버전) | 건수 | 처리 | 커밋 | | --- | --- | --- | --- | | tomcat-embed-core 11.0.24 (CRITICAL), jackson 2.21.5, jackson 3.1.5 | 4+5+5 | Spring Boot 4.0.8 → 4.0.9(tomcat 11.0.27, jackson 2.21.7·3.1.7) | `afe30e73` | | jackson 3.0.2 (build-logic만 씀) | 10 | 카탈로그 `jackson3` → 3.1.7 | `ff6fdf8d` | | grpc-netty-shaded 1.68.1 | 1 | `grpc` 1.75.0, 짝인 `protobufGrpc` 3.25.8 | `3b9b738c` | | httpcore5·httpcore5-h2 5.3.6 | 2 | BOM 속성 override: httpcore5 5.4.3 + 짝인 httpclient5 5.6.3 | `d5b324dd` | | guava (gRPC·Error Prone·Checkstyle이 가져옴) | 4 | 새 카탈로그 묶음 `pinned-*`로 33.7.2-jre 고정(모든 구성) | `2cf6aafd` | | plexus-utils 3.3.0 (Checkstyle) | 1 | `pinned-plexus-utils` 3.6.1 | `81573f70` | | lz4-java 1.10.1, snappy-java 1.1.10.7 (Kafka) | 1+2 | `pinned-lz4-java` 1.11.4, `pinned-snappy-java` 1.1.10.9 | `9fcab227` | | assertj-core 3.27.6 | 1 | 빌드에 없는 구성(지운 source set)의 옛 lockfile 줄. 5개 파일에서 지움 | `3744736c` | | querydsl-jpa 5.1.0 (고친 버전 없음) | 1 | persistence-jpa가 쓰는 타입(`Predicate`)이 있는 querydsl-core로만 컴파일. README도 고침 | `8e3bef0f`, `6ad8f4b6` | ## 고른 방법과 버린 대안 - 기본은 고친 버전 중 가장 작은 것이다. 짝으로 움직이는 라이브러리는 upstream이 선언한 짝을 따른다. - httpclient5 5.6.x는 httpcore5 5.4에 맞춰 빌드된다. - grpc-protobuf 1.75.0은 protobuf-java 3.25.8을 선언한다. - Boot BOM이 관리하는 것은 Boot 패치를 먼저 봤다. 4.0.9 하나로 15건이 풀렸다. - Boot 4.1.x는 버렸다. 마이너 업그레이드라 Kafka 4.2, httpclient5 5.6 등이 같이 바뀐다. - 어떤 leaf도 선언하지 않는 전이 의존성은 카탈로그 `pinned-*`에 두고, `JavaConventionsPlugin`이 Spring dependency management로 모든 구성에 건다. - Gradle constraint는 버렸다. Checkstyle·Error Prone 구성까지 닿게 하려면 구성마다 걸어야 한다. - Error Prone 2.51 · Checkstyle 14.4로 올리기도 버렸다. gRPC 쪽 guava가 남고, 새 검사 규칙이 들어온다. - QueryDSL은 세 안을 총괄에게 묻고 정했다. - 고른 안: querydsl-core로 바꾸기. - 버린 안: OpenFeign 포크로 좌표 옮기기, 90일 무시. - 고른 이유와 버린 대안은 커밋마다 본문에 있다. 고르는 순서는 결정 색인(`docs/work/reference/decisions.md`)에 두 행으로 적었다. ## 위험과 영향 - **파생 서비스가 따라 할 일이 있다: 업그레이드 안내 B-54**(`docs/upgrade/2026-11-maturity-review.md` 3.7절). 그래서 제목에 `!`를 달았다. 각 커밋 제목에는 `!`가 없다. push한 커밋이라 고쳐 쓰지 않았다. - merge 때 `gradle.lockfile`이 충돌하니 다시 써야 한다. - httpcore5 5.4.3은 HTTP client가 받는 HTTP/1 응답에 줄 길이 8192, 헤더 100개 상한을 기본으로 건다. - `pinned-guava`는 하한이 아니라 정확한 고정이다. 더 새 guava가 필요하면 그 leaf가 직접 선언한다. - Kafka 압축(lz4·snappy)은 이 저장소에서 켜지 않는다. 그래서 기존 테스트가 부르지 않는다. 탐침을 따로 돌렸다: kafka-clients 4.1.2가 새 jar로 압축 batch를 쓰고 다시 읽었다. 압축을 켠 실제 브로커 왕복은 보지 않았다. - 살아 있는 문서의 Boot 버전은 이 PR이 고치지 않았다. main에 들어온 번역이 이미 정본(`src/gradle/libs.versions.toml`)을 가리키게 바꿨다. 그래서 4.0.9로 올린 것도 문서에 따로 맞출 곳이 없다. - 「4.0.8」이 남은 곳은 일부러 둔 것뿐이다: 결정 기록 `docs/adr/ADR-GRPC-001…:23`, 업그레이드 안내 B-54의 「4.0.8 → 4.0.9」, 문서 검사 자기 시험, build-logic 테스트가 스스로 만드는 카탈로그. - MEDIUM 4건이 남는다. 게이트는 막지 않는다: opentelemetry-api·extension-trace-propagators 1.55.0, ognl 3.3.4. ## 검증 모두 desktop에서 돌렸다. 새 detached worktree에서 Gradle 명령마다 `--no-build-cache`를 붙였다. 로그는 `~/v1-vuln-fix-logs/`(`{pr,main,tag}-summary.txt`)에 있다. 대상은 head `e6c3d1b9`(트리 `842483ba`)다. main `b3f63be6`을 합친 트리다. | 단계 | 결과 | 주요 수치 | | --- | --- | --- | | PR 28개 (`gates.md` 3절) | 모두 rc=0 | `:ci :verifyDependencyLocks` 6분 30초, 실행 1043·FROM-CACHE 0, 테스트 7390(skip 28) 실패 0 · optional ci 593 · web 35 · websocket 8+4 · httpclient 계약 17+17, Spring 7.0 23 · jpa pg16·pg18 각 432, migration 45 · redis 122 · build-logic 174 · minio 19 · 메시징 인증 37 · 문서 검사(check-docs와 자기 시험, check-work-docs, check-repo-layout, compose 검사) rc=0 | | main 18개 | 모두 rc=0 | mainCheck 6분 52초, 테스트 394 · configuration-cache 3개 · integrationCheck 16분 9초, 958 · performanceCheck 26 · optional 성능 1, 통합 52 · http3 실험 360 · notification pr job 7개 | | 태그 2개 | 모두 rc=0 | `releaseCheck -PgitRevision`, 두 빌드 | | compose smoke | 18 lane 통과 | 컨테이너 기록 80개 모두 restarts=0 oomKilled=false. 이미지를 이번에 새로 만들었다 | | 빠른 시작 | 통과 | `scripts/bootstrap-local.sh`: HTTP 200, status=UP | | 링크 검사(lychee 0.22.0 이미지) | rc=0 | | - FROM-CACHE는 두 곳뿐이다. - vtasks의 build-logic `compileJava` 1개: `--rerun-tasks --no-build-cache`로 다시 컴파일했고, 클래스 105개의 해시가 같다. - mainCheck의 75개: 모두 중첩 빌드(`verifyFeatureScaffold`) 안의 것이다. 바깥 빌드는 0이다. - fileserver·notification job 일부는 테스트 0으로 끝났다. 앞의 `ci`가 같은 worktree에서 이미 돌린 태스크라 UP-TO-DATE였다. - trivy `aquasec/trivy:0.71.2`(`sha256:f5d0e600ecda7449e2a9b272805aef698631d3bb3f3a739a750de2c6819acdc9`), 취약점 DB 2026-11-07 06:54 UTC, Java DB 01:07 UTC. - 기준 `5ab1b418`: rc=1, 37건(CVE 24개). 재현했다. - 이 PR의 head: HIGH·CRITICAL 단계 rc=0, 0건. KEV 목록(2026.11.06, 1769건)과 겹치는 것 0건. - 묶음 커밋마다 그 커밋의 트리에서 세 빌드의 lockfile을 다시 쓰고, 바뀐 leaf의 검사를 돌렸다. 숫자는 각 커밋 본문에 있다. - lockfile은 (좌표, 구성) 쌍으로 비교했고, 의도한 버전만 바뀌었다. - pinned 장치는 build-logic TestKit 테스트로 본다. 고치기 전 트리에서는 실패하고(`pinned=null`), 고친 뒤 통과한다. - 돌리지 못한 것: GitHub 전용 dependency-review·dependency-submission. Gitea에서는 건너뛴다. ## 리뷰어가 볼 곳 - `src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java`: BOM 속성 override(httpcore5·httpclient5)와 `pinned-*` 반복문. - `src/gradle/libs.versions.toml`: 버전 변경과 「Pinned」 묶음 주석. CVE와 낡은 버전을 가져오는 곳을 적었다. - `src/adapter/outbound/persistence-jpa/build.gradle`, `README.md`: Querydsl. - lockfile은 기계적으로 만들었다. 명령은 `./gradlew resolveAndLockAll --write-locks`, `./gradlew -p platforms/optional-build resolveAndLockAll --write-locks`, `./gradlew -p build-logic dependencies --write-locks`다. 커밋 `3744736c`만 다섯 파일을 지우고 같은 명령으로 새로 만들었다. ## 관련 - 업그레이드 안내 B-54: `docs/upgrade/2026-11-maturity-review.md` 3.7절 - 결정 색인: `docs/work/reference/decisions.md` 「취약점이 있는 의존성 버전」, 「Querydsl 취약 좌표」 - main 병합: `1b0c14de`(main `b3f63be6`, 충돌 없음). 합쳐진 업그레이드 안내의 머리는 고치지 않고 3.7절에 범위를 적었다(`e6c3d1b9`).
donghyeon.kang added 14 commits 2026-11-07 13:01:12 +00:00
문제: lockfile 5개가 이제 빌드에 없는 구성의 잠금 상태를 들고 있다.
- application-core: redisPolicyContractTest(source set은 5f10b791d에서 지움)
- shared-contract: edgeRateLimitContractTest
- objectstorage: objectStorageMinioContractTest·objectStorageMinioFaultTest
  (두 lane은 지금 `integrationTest` source set에서 돈다)
- persistence-jpa·persistence-mongo: testkit(testFixtures로 바뀜)
`--write-locks`는 그 빌드에서 해석한 구성만 다시 쓰고 나머지 줄은 그대로
둔다. 그래서 source set을 지워도 줄이 남았다. STRICT 잠금은 해석하는
구성만 대조하므로 빌드는 이 줄을 쓰지 않지만, trivy는 lockfile을 읽어
그 버전을 취약점으로 센다. trivy HIGH 한 건(assertj-core 3.27.6,
CVE-2026-24400)은 application-core의 이 옛 줄에서만 나온다. 해석되는
구성은 모두 3.27.7이다.

고친 방법: 다섯 파일을 지우고 `resolveAndLockAll --write-locks`로 새로
만들었다. 다른 lockfile은 같은 방법으로 새로 만들어도 바이트가 같았다
(주 빌드, optional 빌드, build-logic 모두).
- 버린 대안: 옛 줄만 손으로 지우기. lockfile 머리말이 손 편집을 막고,
  Gradle이 쓴 결과와 같다는 보장이 없다.
- 버린 대안: assertj 무시 항목. 쓰지 않는 버전을 무시 목록에 올리는 것이다.

위험·한계: 같은 방법으로 남는 옛 줄을 막는 장치는 없다. source set을
지우는 사람이 lockfile도 새로 만들어야 한다.

검증(desktop, 기준 5ab1b418):
- lockfile 전부를 지우고 새로 만든 결과와 커밋된 결과를 (좌표, 구성) 쌍으로
  비교했다. 다른 것은 위 다섯 파일의 사라진 구성뿐이고, 남은 구성의 쌍은
  하나도 다르지 않다.
- `./gradlew verifyDependencyLocks` rc=0(leaf 태스크 55개와 루트 집계).
문제: Boot 4.0.8 BOM이 고르는 버전에 trivy HIGH·CRITICAL이 있다.
- tomcat-embed-core 11.0.24: CRITICAL 4건. CVE-2026-65182(보안 제약 우회),
  CVE-2026-65637(HTTP/2 SNI 검사 우회), CVE-2026-65905(DIGEST 인증 재전송),
  CVE-2026-68525(FORM 인증 우회). 11.0.25에서 고쳤다.
- jackson 2.21.5(core·databind): HIGH CVE-2026-89407·89425·68497·91776·91777.
  2.21.7에서 고쳤다.
- jackson 3.1.5(core·databind): 같은 CVE 다섯. 3.1.7에서 고쳤다.
이 셋이 trivy 37건 중 15건이다.

고친 방법: Boot 패치 4.0.9 하나로 올린다. 4.0.9 BOM은 tomcat 11.0.27,
jackson-bom 2.21.7·3.1.7을 고른다. Spring이 함께 시험한 묶음을 그대로 받는다.
- 버린 대안: `tomcat.version`·`jackson-2-bom.version`·`jackson-bom.version`
  BOM 속성 override. Boot가 고른 짝과 어긋나고, 지울 조건을 세 곳에 둬야 한다.
- 버린 대안: Boot 4.1.x. 마이너 업그레이드다(Kafka 4.2, httpclient5 5.6 등이
  같이 바뀐다).
카탈로그 주석의 「Spring Boot 4.0.8's own plugin」도 4.0.9로 고쳤다. 4.0.9의
플러그인도 dependency-management 1.1.7을 가져온다.

같이 바뀐 것(모두 4.0.9 BOM 안의 패치): Spring Framework 7.0.9→7.0.10,
Security 7.0.7→7.0.8, Data 4.0.7→4.0.8(Mongo 5.0.7→5.0.8), Integration
7.0.6→7.0.7, GraphQL 2.0.5→2.0.6, graphql-java 25.0→25.1, Hibernate
7.2.24→7.2.25, Hibernate Validator 9.0.1→9.0.2, Netty 4.2.17→4.2.19, Jetty
12.1.12→12.1.14, Micrometer 1.16.7→1.16.8, Reactor 3.8.7→3.8.8, slf4j
2.0.18→2.0.20, PostgreSQL JDBC 42.7.13→42.7.14. lockfile 65개.

위험·한계: 위 라이브러리의 패치 범위 동작 변화는 받는다. commons-lang3
override(3.20.0)는 4.0.9도 3.19.0을 관리하므로 그대로 둔다. 문서에 적힌
「Spring Boot 4.0.8」은 이 커밋에서 고치지 않는다(check-docs 예외 목록에 얼어
있다). build-logic 테스트 fixture의 4.0.8은 그 테스트가 스스로 만드는
카탈로그 값이다.

검증(desktop, 이 트리 2d387179):
- 세 빌드(주, optional, build-logic)를 `--write-locks`로 다시 쓴 뒤 lockfile을
  (좌표, 구성) 쌍으로 비교: 위 버전만 바뀌었고 새로 생기거나 사라진 구성 0.
- `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` rc=0, 6분 2초,
  태스크 752(executed 589, from cache 106, up-to-date 57).
- `./gradlew -p platforms/optional-build ci verifyDependencyLocks` rc=0, 1분 7초.
문제: build-logic만 카탈로그 `jackson3`(3.0.2)를 그대로 해석한다. 그 lockfile의
jackson-core·databind 3.0.2에 trivy HIGH가 10건 있다.
- jackson-core: CVE-2026-29062(중첩 깊이, 3.1.0), CVE-2026-68494(비동기
  파서, 3.1.4), GHSA-2m67-wjpj-xhg9(문서 길이 제한 우회, 3.1.1),
  CVE-2026-89407·CVE-2026-89425(3.1.7)
- jackson-databind: CVE-2026-54512·CVE-2026-54513(PolymorphicTypeValidator
  우회, 3.1.4), CVE-2026-68497(3.1.6), CVE-2026-91776·CVE-2026-91777(3.1.7)
leaf는 이 키를 쓰지 않고 Boot BOM의 jackson-bom을 따른다.

고친 방법: `jackson3`를 3.1.7로 올린다. 위 10건을 모두 고친 가장 작은 버전이고,
바로 앞 커밋의 Boot 4.0.9 BOM이 leaf에 주는 버전과 같다. 그래서 빌드와
애플리케이션이 같은 Jackson을 쓴다. 키 설명도 그 뜻으로 고쳤다.
- 버린 대안: 3.2.x. 마이너를 하나 더 넘고, leaf와 다른 Jackson이 된다.

위험·한계: build-logic은 Jackson으로 registry JSON과 설정 metadata만 읽는다
(`ModuleRegistry`, `ConfigurationMetadataClasspath`). 3.0→3.1 사이 동작 차이는
이 두 곳의 테스트가 본다.

검증(desktop, 이 트리 c0ddf259):
- 세 빌드를 `--write-locks`로 다시 썼다. 바뀐 lockfile은 build-logic 하나이고,
  jackson-core·databind·bom 3.0.2→3.1.7, jackson-annotations 2.20→2.21이다.
- `./gradlew -p build-logic check javadoc` rc=0, 테스트 173 실패 0 skip 0.
- `./gradlew verifyDependencyLocks architectureCheck` rc=0(registry를 Jackson으로
  읽는 설정 단계 포함). optional 빌드 `verifyDependencyLocks` rc=0.
문제: gRPC BOM 1.68.1의 grpc-netty-shaded에 HIGH CVE-2025-55163(Netty HTTP/2
"MadeYouReset" 서비스 거부)이 있다. 1.75.0에서 고쳤다. adapter:inbound:grpc,
app-bootstrap, optional 빌드의 grpc-testkit lockfile이 이 버전을 가진다.

고친 방법: `grpc`를 고친 가장 작은 버전 1.75.0으로 올린다. 같이
`protobufGrpc`를 3.25.5→3.25.8로 올린다. grpc-protobuf 1.75.0이 선언하는
protobuf-java가 3.25.8이고, adapter:inbound:grpc의 protobuf-bom import가 실제로
해석되는 버전을 정하므로, 그대로 두면 gRPC가 자기가 빌드된 것보다 오래된
runtime에서 돈다. 같은 키를 쓰는 grpc-contract의 protoc도 3.25.8이 된다.
protobuf 다른 두 줄(4.33.2, 4.29.3)은 건드리지 않는다.
- 버린 대안: Boot 4.1이 관리하는 1.84.x. 열 버전 가까이 넘고, gRPC 플랫폼
  leaf 전체를 다시 검증해야 한다. 이 커밋의 목적은 CVE 하나다.
- 버린 대안: protobufGrpc를 3.25.5로 두기. 위 이유.

위험·한계: build-logic `PlatformModuleConventionTest`의 1.68.1은 그 테스트가
스스로 만드는 카탈로그 값이라 저장소 카탈로그와 상관없다. 고치지 않는다.
guava는 1.75.0도 낡은 버전(33.3.1-android)을 가져온다. 다음 커밋이 고정한다.

검증(desktop, 이 트리 92b9061f):
- 세 빌드를 `--write-locks`로 다시 썼다. 바뀐 lockfile 9개(adapter:inbound:grpc,
  app-bootstrap, gRPC 플랫폼 leaf 6개, grpc-contract). io.grpc 1.68.1→1.75.0,
  protobuf-java·util 3.25.5→3.25.8, guava 33.2.1→33.3.1, proto-google-common-protos
  2.41.0→2.59.2 등 gRPC가 가져오는 것만 바뀌었다.
- `:adapter:inbound:grpc:check :adapter:inbound:grpc:grpcTransportQualificationTest
  :app-bootstrap:check :app-bootstrap:conditionalTransportBuildContractTest
  verifyDependencyLocks` rc=0. 테스트: grpc leaf test 74, grpc 전송 lane 29,
  app-bootstrap test 225(skip 4), 조건부 전송 lane 3, 실패 0.
- `./gradlew -p platforms/optional-build ci verifyDependencyLocks` rc=0, 1분 15초.
문제: Boot 4.0.9 BOM은 아직 httpcore5 5.3.6을 고른다. HIGH 두 건이 있고,
5.3 줄에는 고친 버전이 없다.
- CVE-2026-54399(httpcore5): HTTP/1 헤더 수·줄 길이 제한 없음, 메모리 고갈
- CVE-2026-54428(httpcore5-h2): HPACK 헤더 목록 크기 제한 없음
adapter:outbound:httpclient와 app-bootstrap이 이것을 가진다.

고친 방법: JavaConventionsPlugin에서 commons-lang3와 같은 BOM 속성 override로
`httpcore5.version`=5.4.3, `httpclient5.version`=5.6.3을 준다.
- core 5.4.3: 두 건을 고친 첫 버전.
- client를 함께 올리는 이유: client 릴리스마다 core 한 줄에 맞춰 빌드된다
  (5.5는 core 5.3, 5.6은 core 5.4). core 5.4는 client가 쓰는 classic-over-async
  bridge를 다시 설계했다. 5.6.2가 core 5.4.3을 선언하는 첫 client이고, 5.6.3은
  같은 core에 5.5.2에도 있는 MEDIUM GHSA-hjcp-jmpx-g3qm(Content-Encoding 디코딩
  중 연결 누수)을 고친다. 그래서 5.6.3이다.
- 버린 대안: core만 5.4.3. Apache가 시험하지 않은 짝이다.
- 버린 대안: Boot 4.1.2가 고르는 5.6.5·5.4.4. 5.4.4는 HTTP/1.1 기본 버퍼를
  32KiB로 바꾸는 등 이 CVE와 상관없는 기본값 변경이 더 있다.
카탈로그 머리말의 「일부러 여기 없는 것」 문단에 두 override를 더했다.

위험·한계: core 5.4.3은 들어오는 HTTP/1 메시지(HTTP client에게는 응답)에 줄
길이 8192, 헤더 100개 상한을 기본으로 건다. 넘는 응답은 거절된다. 5.6에서
client 기본값이 더 바뀐 것이 있으면 httpclient leaf의 테스트와 성능 lane이
본다. Boot가 httpcore5 5.4.3 이상을 관리하면 두 override를 지운다.

검증(desktop, 트리 a2bc6e76. 커밋 트리 d5bf2fd9는 여기에 주석 한 줄 줄바꿈만
더했고 build-logic `compileJava` rc=0):
- 세 빌드를 `--write-locks`로 다시 썼다. 바뀐 lockfile은 httpclient와
  app-bootstrap 둘이고 httpclient5·httpcore5·httpcore5-h2만 바뀌었다.
- `:adapter:outbound:httpclient:check :app-bootstrap:check verifyDependencyLocks`
  rc=0. httpclient test 360, httpClientSecurityTest 9, 실패 0.
- `httpClientStableContractTest -Phttpclient.contract.transports=apache`·`=jdk`
  (pr-adapters의 matrix) 둘 다 rc=0, 각 17 실패 0.
- `spring70CompatibilityTest` 23, `httpClientFailureInjectionTest` 4,
  `httpClientPerformanceTest`(상한 단언) 5, 모두 실패 0.
문제: guava의 HIGH CVE-2026-102554(역직렬화 중 메모리 할당 제한 없음)는
33.7.2에서 고쳤다. 그런데 guava는 어떤 leaf도 직접 선언하지 않고, 낡은 버전이
셋에서 들어온다.
- gRPC 1.75.0: 33.3.1-android(lockfile에는 jre 변형 이름으로도 남는다)
- Error Prone 2.49.0(annotationProcessor 구성): 33.5.0-jre
- Checkstyle 13.5.0(checkstyle 구성): 33.6.0-jre
leaf 거의 전부의 lockfile에 걸린다.

고친 방법: 카탈로그에 `pinned-*` 라이브러리 묶음을 두고, JavaConventionsPlugin이
그 묶음을 Spring dependency management로 모든 leaf에 건다. 첫 항목이
`pinned-guava`(33.7.2-jre)다. 버전 키 주석에 CVE와 낡은 버전을 가져오는 곳을
적고, 그곳들이 고친 버전을 가져오면 지운다.
- dependency management를 쓰는 이유: Boot BOM처럼 모든 구성에 걸린다.
  checkstyle·annotationProcessor 구성도 받는다(lockfile에서 checkstyle 구성의
  commons-lang3가 BOM override 3.20.0인 것이 이미 그 증거다). Gradle constraint는
  구성마다 따로 걸어야 한다.
- 버전을 카탈로그에 두는 이유: 이 빌드가 고르는 버전이다(카탈로그 머리말).
  BOM이 관리하는 것을 덮는 override와 다르다.
- build-logic `PlatformModuleConventionTest`에 시험을 하나 더했다. fixture
  카탈로그의 `pinned-fixture`는 checkstyle 구성의 관리 버전이 되고,
  `unpinned-fixture`는 관리되지 않는다.
- 버린 대안: Error Prone 2.51.0, Checkstyle 14.4.0으로 올리기. 둘 다 guava
  33.7.2를 가져오지만 gRPC 쪽은 남고, 새 검사 규칙이 들어와 범위가 커진다.
  Checkstyle 14는 메이저다.

위험·한계: dependency management는 하한이 아니라 정확한 고정이다. 나중에
33.7.2보다 새 guava를 요구하는 라이브러리가 들어와도 33.7.2로 내린다. 그때는
그 leaf가 guava를 버전과 함께 직접 선언하면 그 선언이 이긴다. gRPC가 쓰던
android 변형 대신 jre 변형이 들어간다. jre 변형은 android 변형의 API를 모두
가진다. guava 33.7.2가 요구하는 대로 error_prone_annotations 2.50.0,
failureaccess 1.0.3, j2objc-annotations 3.1, jspecify 1.0.1이 같이 들어오고
checker-qual은 빠진다.

같은 커밋의 작은 정리: 앞 커밋이 넣은 httpcore5 주석의 줄바꿈을 고쳤다.

검증(desktop, 트리 49191720 위에 시험·주석 정리를 얹은 9a97dbbb):
- 세 빌드를 `--write-locks`로 다시 썼다. lockfile 64개에서 guava가 33.7.2-jre
  하나가 됐다(checkstyle·annotationProcessor 구성 포함). 위 동반 라이브러리 외에
  바뀐 것은 없고, 새로 생기거나 사라진 구성 0.
- RED: 장치 없는 트리(앞 커밋)에 새 시험만 얹으면 실패한다
  ("pinned=null unpinned=null").
- GREEN: `./gradlew -p build-logic check javadoc` rc=0, 테스트 174 실패 0.
- `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` rc=0, 6분 33초,
  태스크 752(executed 641, up-to-date 111, from cache 0). 모든 leaf가 새 guava로
  Error Prone·Checkstyle을 돌렸다.
- `./gradlew -p platforms/optional-build ci verifyDependencyLocks` rc=0, 1분 11초.
문제: Checkstyle 13.5.0의 doxia 1.12.0이 plexus-utils 3.3.0을 가져온다. HIGH
CVE-2025-67030(extractFile 경로 조작)이 있고 3.x 줄에서는 3.6.1, 4.x에서는
4.0.3에서 고쳤다. 모든 leaf의 checkstyle 구성에 걸린다.

고친 방법: 앞 커밋의 `pinned-*` 묶음에 `pinned-plexus-utils`(3.6.1)를 더한다.
3.x 안에서 고친 가장 작은 버전이다.
- 버린 대안: 4.0.3. 메이저다. 4.0은 XML 클래스를 plexus-xml로 떼어 냈다.
- 버린 대안: doxia를 뺀 Checkstyle 13.11.0으로 올리기. plexus-utils는
  사라지지만 Checkstyle 규칙이 여섯 마이너만큼 바뀐다.

위험·한계: doxia는 Checkstyle의 사이트 문서 생성에만 쓰여 Gradle checkstyle
태스크에서는 plexus-utils를 거의 부르지 않는다. 그래도 모든 leaf의
checkstyle이 이 구성으로 돈다.

검증(desktop, 이 트리 00b8e235):
- 세 빌드를 `--write-locks`로 다시 썼다. lockfile 64개의 checkstyle 구성에서
  plexus-utils 3.3.0→3.6.1만 바뀌었다.
- `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` rc=0, 6분 32초,
  태스크 752(executed 641, up-to-date 111). checkstyle 태스크 109개가 실제로 돌았다.
- `./gradlew -p platforms/optional-build ci verifyDependencyLocks` rc=0,
  checkstyle 태스크 17개 실행.
문제: Boot 4.0.9가 고르는 kafka-clients 4.1.2가 압축 라이브러리 두 개의 낡은
버전을 가져온다.
- at.yawk.lz4:lz4-java 1.10.1: HIGH CVE-2026-106451(공유 임시 폴더로 native
  라이브러리를 풀어 코드 실행). 1.11.4에서 고쳤다.
- org.xerial.snappy:snappy-java 1.1.10.7: HIGH CVE-2026-93451(손상된 압축
  입력으로 버퍼 넘침), CVE-2026-108106(압축 해제 중 메모리 할당 제한 없음).
  1.1.10.9에서 고쳤다.
messaging 플랫폼의 kafka leaf 셋, adapter:inbound:messaging,
adapter:outbound:messaging-kafka, app-bootstrap이 가진다.

고친 방법: `pinned-*` 묶음에 `pinned-lz4-java`(1.11.4)와
`pinned-snappy-java`(1.1.10.9)를 더한다. 둘 다 고친 가장 작은 버전이다.
lz4 1.11.4는 1.11.1~1.11.4에서 고친 lz4 MEDIUM·LOW 공지 다섯도 함께 푼다.
- 버린 대안: kafka-clients를 올리기(`kafka.version` override). 4.1 줄에는
  고친 패치가 없고, 4.3.2가 lz4 1.11.4·snappy 1.1.10.11을 가져오지만 Boot 4.0의
  spring-kafka가 시험한 Kafka 줄을 벗어난다.

위험·한계: kafka-clients 4.1.2는 lz4 1.10.1에 맞춰 빌드됐다. Kafka 4.2.2가
1.11.2를, 4.3.2가 1.11.4를 쓰므로 Kafka가 쓰는 lz4 API는 1.11에서도 같다.
이 저장소는 Kafka 압축을 켜지 않아(설정·테스트에 `compression.type` 없음) 기존
테스트는 두 라이브러리를 부르지 않는다. 그래서 아래 탐침으로 kafka-clients의 압축
경로를 따로 봤다. 압축을 켠 실제 브로커 왕복은 보지 않았다.

검증(desktop, 이 트리 c5ed4659):
- 세 빌드를 `--write-locks`로 다시 썼다. Kafka를 쓰는 lockfile 6개에서
  lz4-java 1.10.1→1.11.4, snappy-java 1.1.10.7→1.1.10.9만 바뀌었다.
- `:messaging:messaging-kafka:check :messaging:messaging-spring-boot-starter-kafka:check
  :messaging:messaging-spring-boot-starter:check :adapter:inbound:messaging:check
  :adapter:outbound:messaging-kafka:check :app-bootstrap:check verifyDependencyLocks`
  rc=0. 클래스패스가 바뀐 leaf의 test가 다시 돌았다: messaging-kafka 87,
  starter 77, starter-kafka 2, adapter:outbound:messaging-kafka 4, 실패 0.
- `verifyMessagingCertificationEvidence`(messaging-certification workflow의 PR job,
  실제 Kafka 컨테이너) rc=0, 인증 lane 37 실패 0.
- 탐침(커밋하지 않음): kafka-clients 4.1.2의 `MemoryRecords.withRecords`로 lz4·snappy
  batch를 만들고 다시 읽는 프로그램. 새 jar 쌍과 옛 jar 쌍 모두 rc=0, 두 레코드와
  값 10006바이트를 그대로 읽었고 batch 크기도 같다(lz4 145, snappy 581바이트).
문제: persistence-jpa의 compileOnly·testImplementation
`com.querydsl:querydsl-jpa:5.1.0:jakarta`에 HIGH CVE-2024-49203(orderBy를 통한 HQL injection)이 있다. 그 좌표에는 고친 버전이
없다(GHSA-6q3q-6v5j-h6vg: com.querydsl:querydsl-jpa·querydsl-apt <=5.1.0, 고친
버전 없음). trivy 37건 중 마지막 남은 한 건이다.

고친 방법: 이 leaf가 쓰는 Querydsl 타입은 `querydsl.PredicatePolicy`의
`com.querydsl.core.types.Predicate` 하나이고, 이것은 querydsl-core에 있다(공지 대상이
아니다). 그래서 두 줄을 `com.querydsl:querydsl-core`(Boot BOM이 관리하는 5.1.0)로
바꾼다. 둘 다 compileOnly·test 범위라 배포물은 원래부터 Querydsl을 싣지 않는다.
JPAQuery를 만드는 querydsl-jpa는 이 capability를 켜는 서비스가 직접 더하는 것으로
그대로 둔다(README의 안내와 같다). build.gradle 주석에 이유를 적었다.
- 버린 대안: OpenFeign 포크 `io.github.openfeign.querydsl:querydsl-jpa`(5.6.1, 6.10.1+)로
  옮기기. 좌표가 바뀌어 파생 서비스가 같이 바꿔야 하고, 이 leaf에는 필요 없는 jar다.
- 버린 대안: `.trivyignore.yaml`에 90일 무시. 쓰지 않는 jar의 위험을 기한부로 안는다.
이 선택은 총괄에게 물었고 답을 받기 전에 권하는 안으로 진행했다.

위험·한계: querydsl-jpa를 직접 더하는 서비스는 여전히 고친 버전이 없는 좌표를 쓴다.
업그레이드 안내 B-54에 OpenFeign 포크를 검토하라고 적는다. 동작 변화는 없다
(compileOnly 클래스패스에서 쓰지 않는 jar 하나가 빠진다).

검증(desktop, 이 트리 6831ad47):
- 세 빌드를 `--write-locks`로 다시 썼다. persistence-jpa lockfile에서 querydsl-jpa가
  7개 구성에서 빠졌고 querydsl-core 5.1.0은 그대로다.
- `:adapter:outbound:persistence-jpa:check :adapter:outbound:persistence-jpa:testQualityCheck
  verifyDependencyLocks` rc=0, test 666 실패 0(`PredicatePolicyTest`,
  `JpaModuleBoundaryTest` 포함).
- `:adapter:outbound:persistence-jpa:compileJava --rerun` rc=0: 운영 코드가
  querydsl-core만으로 컴파일된다.
- 앞 커밋 트리(c5ed4659)를 깨끗한 worktree로 꺼내 돌린 trivy에서 남은
  HIGH·CRITICAL은 이 한 건이었다.
문제: 앞 커밋 아홉 개가 파생 서비스가 받는 버전을 바꿨다(Spring Boot 4.0.9,
gRPC 1.75.0, httpclient5·httpcore5, 새 `pinned-*` 고정, Querydsl 컴파일 의존,
lockfile 옛 줄). 업그레이드 안내에 행이 없으면 파생 서비스는 merge 때 lockfile
충돌과 httpcore5의 새 응답 헤더 상한을 미리 알 수 없다. 버전을 고르는 규칙과
Querydsl 처리도 결정 색인에 없어 다음 세션이 다시 묻는다.

고친 방법:
- `docs/upgrade/2026-11-maturity-review.md`: 새 3.7절과 B-54 행(무엇이 바뀌었나,
  증상, 할 일, 근거 커밋). 이 안내는 아직 main에 합쳐지지 않았으므로 결정 색인
  「아직 합치지 않은 업그레이드 안내」대로 머리 「커밋:」 목록에 한 항목을 더했다.
- `docs/work/reference/decisions.md` 2.7절: 「취약점이 있는 의존성 버전」(고르는
  순서와 놓는 곳)과 「Querydsl 취약 좌표」 두 행. 둘 다 기본값이고, Querydsl은
  총괄 확인 전이라고 적었다.
- `docs/web/repository-adaptation.md:65`: baseline 숫자 4.0.8→4.0.9만 고쳤다.
  같은 숫자가 있는 다른 살아 있는 문서 8곳은 `scripts/check-docs-exceptions.txt`의
  number 예외로 얼어 있어 고치지 않았다(고치면 문서 검사가 실패하고, 예외 파일은
  이 작업의 범위 밖이다).

위험·한계: 위 8곳은 Boot 4.0.8로 남는다. 번역 작업이 그 문서를 옮길 때 숫자를
정본(카탈로그)을 가리키는 말로 바꾸고 예외 줄을 지워야 한다.

검증: `python3 scripts/check-docs.py` rc=0(number 걸림 28, 예외 28, 실패 0),
`python3 scripts/check-work-docs.py` rc=0. 고친 세 문서를 읽는 테스트는 없다
(`grep -rn --include='*.java'`로 파일 이름을 찾았다).
문제: persistence-jpa README 「라이브러리 API」가 Querydsl을 쓰는 서비스에
`com.querydsl:querydsl-jpa:5.1.0:jakarta`를 직접 추가하라고 한다. 그 좌표에는
HIGH CVE-2024-49203(orderBy를 통한 HQL injection)이 있고 고친 버전이 없다.
8e3bef0f가 이 leaf를 querydsl-core로 옮겼는데, 살아 있는 문서는 아직 그
좌표를 권한다.

고친 방법: 총괄이 권한 안 A를 확인하고 이 문장도 고치라고 했다(2026-11-07).
문장을 넷으로 나눴다: 템플릿은 querydsl-core의 `Predicate`만 쓴다, JPA 질의가
필요한 서비스는 querydsl-jpa를 직접 더한다, 그 좌표 5.1.0에는 CVE-2024-49203이
있고 고친 버전이 없다, 쓰려면 OpenFeign 포크(`io.github.openfeign.querydsl`)를
검토한다. Envers 안내는 그대로다. 결정 색인 「Querydsl 취약 좌표」 행의 「누가」를
「총괄 확인 전」에서 위임(총괄 확인)으로 바꾸고 README를 출처에 더했다.
- 원래는 8e3bef0f와 같은 커밋이어야 했다. 그 커밋은 이미 push해서 고쳐 쓰지
  않고 바로 뒤에 붙인다.

위험·한계: README 줄은 문서 번역 작업(D2b) 범위 안이다. 총괄이 D2b에 이 줄을
건드리지 말라고 알린다.

검증(desktop, 이 커밋과 다음 커밋을 얹은 트리 fbb325c1):
`python3 -m unittest discover -s scripts/tests` OK, `check-docs.py` rc=0,
`check-work-docs.py` rc=0, 같은 범위 상대 링크 555개 깨짐 0, `check-repo-layout.py`
rc=0. lychee(0.22.0 이미지)는 rc=2이고 실패 4건이 앞 트리와 같다(기록 문서의
404, 이 변경 전부터). 이 README를 읽는 테스트는 없다(`grep -rn --include='*.java'`).
문제: cb67b879가 `docs/web/repository-adaptation.md:65`의 baseline 숫자를
4.0.8에서 4.0.9로 고쳤다. 이 파일은 문서 번역 작업(D2d)이 지금 옮기고 있고,
총괄은 숫자를 하나도 고치지 않기로 정했다(2026-11-07). 번역 작업이 숫자를
복사하는 대신 정본(`src/gradle/libs.versions.toml`)을 가리키게 바꾸므로 4.0.9도
그때 맞춰진다.

고친 방법: 그 한 줄을 4.0.8로 되돌린다. 이 파일은 기준 커밋 5ab1b418과 같아진다.
- cb67b879는 이미 push해서 고쳐 쓰지 않고 되돌림 커밋을 붙인다.

위험·한계: 번역이 끝날 때까지 이 줄과 check-docs 예외로 얼린 8곳이 실제 Boot
4.0.9와 다른 숫자를 말한다.

검증: 앞 커밋과 같다(트리 fbb325c1에서 문서 검사 전부 rc=0).
`git diff 5ab1b418 -- docs/web/repository-adaptation.md`가 비어 있다.
main(b3f63be6, 문서 2단계 통합 PR #3)을 V1 브랜치에 합친다. 충돌은 없었다.

- docs/web/repository-adaptation.md: V1이 숫자를 고쳤다가 되돌려(23f04afb) 기준과
  같았으므로 main의 번역(숫자 없이 카탈로그를 가리킴)이 그대로 들어왔다.
- src/adapter/outbound/persistence-jpa/README.md: V1의 Querydsl 문장(71~75줄)과
  main의 번역이 자동으로 함께 남았다.
- docs/work/reference/decisions.md, docs/upgrade/2026-11-maturity-review.md: V1이
  더한 행과 main의 행이 모두 남았다.
- main 쪽에서 들어온 workflow 변경은 없다.

검증(노트북, 합친 트리): check-docs.py rc=0(넓어진 숫자 검사 포함 걸림 0),
자기 시험 OK, check-work-docs.py rc=0, check-repo-layout.py rc=0. 게이트는
desktop에서 이 커밋으로 돌린다.
문제: cb67b879는 `docs/upgrade/2026-11-maturity-review.md` 머리의 「커밋:」 목록에
「의존성 취약점 수정(3.7절 B-54)」을 더했다. 그 안내는 PR #2(03a313ed)로 이미
main에 합쳐졌다. 결정 색인 「아직 합치지 않은 업그레이드 안내」는 합쳐진 안내를
고치지 말고 새 행을 더하라고 한다. 머리의 「범위:」도 main → 리뷰 브랜치라 V1을
포함하지 않는다.

고친 방법: 머리 「커밋:」 목록을 main과 같게 되돌리고, 3.7절 첫머리에 이 절의
범위(`5ab1b418..claude/v1-vuln-fix-e089b9`)와 머리를 고치지 않은 이유를 적는다.
B-54 행은 그대로다. 이제 이 파일의 main과의 차이는 3.7절 하나다.

검증: check-docs.py rc=0, check-work-docs.py rc=0.
donghyeon.kang merged commit 9fbf72fb42 into main 2026-11-07 13:42:09 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#4