From fe80bb3ff36177fcf2fa52d955af8b812e3d5323 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 25 Sep 2026 14:06:51 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EB=A6=AC=EB=B7=B0=20=ED=9B=84=EC=86=8D?= =?UTF-8?q?=20=EB=B0=98=EC=98=81=20=ED=98=84=ED=99=A9=ED=91=9C=EC=99=80=20?= =?UTF-8?q?=EC=8B=A4=ED=96=89=20=EA=B3=84=ED=9A=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 2026-09-24 두 리뷰의 모든 항목을 6d27356e 기준으로 다시 판정한 현황표(812행)와 Wave 1-5 실행 계획, 소유자 결정 20건을 기록한다. Co-Authored-By: Claude Opus 5.5 (1M context) --- .../2026-09-25-review-followup-prompt.md | 121 ++ .../2026-09-25-review-followup-status.md | 1099 +++++++++++++++++ .../plans/2026-09-25-review-followup.md | 222 ++++ 3 files changed, 1442 insertions(+) create mode 100644 docs/reviews/2026-09-25-review-followup-prompt.md create mode 100644 docs/reviews/2026-09-25-review-followup-status.md create mode 100644 docs/superpowers/plans/2026-09-25-review-followup.md diff --git a/docs/reviews/2026-09-25-review-followup-prompt.md b/docs/reviews/2026-09-25-review-followup-prompt.md new file mode 100644 index 00000000..f8b08735 --- /dev/null +++ b/docs/reviews/2026-09-25-review-followup-prompt.md @@ -0,0 +1,121 @@ +# 새 세션용 프롬프트 — 2026-09-24 리뷰 남은 항목 전부 반영 + +> 사용법: 새 세션에서 아래 「프롬프트 본문」을 그대로 붙여 넣거나, `/goal docs/reviews/2026-09-25-review-followup-prompt.md 를 읽고 그대로 진행하자` 로 시작한다. +> 「사용자가 정할 것」 절의 기본값이 마음에 들지 않으면 붙여 넣기 전에 고친다. + +--- + +## 프롬프트 본문 + +### 0. 배경 (이미 끝난 일) + +- 입력 리뷰 두 개: + - 1차(결함 중심): `docs/reviews/2026-09-24-src-module-code-review.md` — Critical 15 / Required 76 / Consider 약 55, 그룹 A–O + - 2차(구조·유지보수): `docs/reviews/2026-09-24-src-maintainability-review.md` — BUILD, TEST, X1, X2, S1–S7 +- 2026-09-25 capability 포장 작업이 끝났고 `main`에 커밋 `6d27356e`로 들어가 있다. 설계는 `docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md`, 실행 기록은 `docs/superpowers/plans/2026-09-25-capability-module-packaging.md`(맨 아래 「진행 기록」 표)에 있다. +- 그 작업에서 반영된 것: + - 1차 리뷰 **Critical 15건 전부** + L-2(prod 에러 상세), L-3(sample loggers) + 알림 admin 결과 codec의 jsonb 공백 결함 + - 2차 리뷰 결정 D1–D6: 리팩터링 잔재·실험용 자리 삭제(D1), outbox 한 세대 + v1 fencing `V17`(D2), 멱등성 V2 정본화(D3), WebFlux 삭제(D4), 빌드 "바로 할 것" 1–12와 O3 일부(D5), 테스트 규칙을 `AGENTS.md`에 고정하고 sample에만 적용(D6) + - 부가 기능을 "있으면 켜지는 capability 모듈"로 포장, 기본 조립은 web·identifier·support·코어만, 나머지는 `app-bootstrap/build.gradle`의 주석 한 줄로 선택 +- 반영되지 **않은** 것: 1차 리뷰 Required 76건과 Consider 대부분(체계적으로 처리하지 않음 — 코드 삭제로 같이 사라진 것만 있음), 2차 리뷰의 구조 권고 중 D1–D6 밖의 것(에러 어휘 통합, SRP 분해, 공통 유틸, tenant 값 타입, 나머지 모듈의 테스트 규칙 적용 등), 그리고 아래 5절의 알려진 남은 문제. + +### 1. 목표 + +두 리뷰에 적힌 **모든 항목**(Critical·Required·Consider·Nit, 2차의 모든 Finding과 권고)을 현재 코드 기준으로 다시 판정하고, 남은 것은 전부 반영한다. 반영하지 않기로 한 항목은 이유와 승인자를 남긴다. "전부"의 정의는 3절 현황표의 모든 행이 `완료` / `해당 없음` / `보류(사유·승인자)` 중 하나로 끝나는 것이다. + +### 2. 먼저 읽을 것 + +1. `AGENTS.md` 전체 — HARD-STOP 7개, 「부가 기능(capability) 모듈 규칙」(완료 기준 7개, 모듈 기본 설정 로딩 규칙), 「테스트 전략」의 테스트 작성 규칙 6개 +2. `CLAUDE.md`, 작업할 leaf의 가장 가까운 `src/**/CLAUDE.md` +3. 위 리뷰 두 개, 계획서 `2026-09-25-capability-module-packaging.md`의 「진행 기록」, `docs/capability-status.md`(상태표 + 「제거된 코드 (2026-09-25 리팩터링)」 표) +4. `src/README.md`의 「기능 추가 = 한 줄 + env」 표 + +주의: 리뷰의 경로와 줄 번호는 `208077fd` 기준이다. 그 뒤로 코드가 많이 옮겨졌다(예: bootstrap의 startup helper → `adapter:outbound:support` `support.startup`, JPA startup/Flyway/validator → persistence-jpa `startup`, 알림 조립 → `composition:notification-platform`, web 알림 HTTP → `adapter:inbound:web-notification`, web 라이브러리 → `adapter:inbound:web-advanced`, redis-sdk 테스트 → redis-sdk leaf). 항목마다 **현재 코드에서 다시 찾는다.** + +### 3. 1단계 — 반영 현황표 (구현 전에 끝낸다) + +`docs/reviews/2026-09-25-review-followup-status.md`를 만든다. 한 행 = 리뷰 항목 하나. + +| 열 | 내용 | +|---|---| +| ID | 1차: `A-1`, `B-3`, … (그룹 문자 + 번호). 2차: `S2-#4`, `X1-#6`, `X2-P2-1`, `BUILD-바로할것-7`, `TEST-제안-3` 등 | +| 심각도 | Critical / Required / Consider / Nit / 권고 | +| 요약 | 한 줄 | +| 상태 | `완료` / `해당 없음(코드 삭제)` / `남음` / `결정 필요` | +| 근거 | 완료면 커밋·테스트 이름, 해당 없음이면 「제거된 코드」 표의 행, 남음이면 현재 `file:line` | +| Wave | 남음인 항목을 배정할 묶음 | + +- 판정은 grep·코드 읽기로 한다. 추측으로 `완료`나 `해당 없음`을 적지 않는다. +- 리뷰 항목이 여러 결함을 묶고 있으면 행을 나눈다. +- 서로 같은 결함(예: 1차 A-4 = I-1)은 한 행으로 합치고 ID를 둘 다 적는다. +- 병렬로 하면 그룹 단위로 나눠 읽기 전용 조사 에이전트에 맡기고, 결과만 표로 합친다. + +### 4. 2단계 — 실행 계획 후 실행 + +`docs/superpowers/plans/` 에 `writing-plans` 형식으로 계획을 쓰고 Wave 순서대로 끝까지 실행한다. 권장 순서: + +1. **보안·데이터 손실** (남은 Required 중 security/data): 예) 1차 A-1(예외 메시지 로그의 PII·비밀값), B-7(알림 admin reconcile tenant 검사), C-2(QUARANTINE 판정이 staged bytes 삭제), C-8(파일 권한이 role tier만 확인), H-2~H-4(httpclient dynamic target의 trace 헤더·리다이렉트·API key 헤더), E-6(tenant 규칙이 필드 이름 기반) 등 +2. **정합성** (correctness): 예) B-3~B-6, C-3~C-6·C-9, E-3~E-5, H-5·H-6, 1차 I·J·K·M·N 그룹의 Required +3. **구조** (2차 리뷰): 에러 어휘·응답 형식 하나로(X2 P2-1~P2-3), shared 예외에 `ApiErrorCarrier`(P2-2), traceparent 파싱 하나로(P2-4), tenant 값 타입(P2-6), caller 트랜잭션 guard 하나로(X1-#4), 공통 유틸(`Sha256`, `Backoff`), SRP 분해(`NotificationDispatchService`, `LocalPersistentControlPlane`, `GraphQlPlatformAutoConfiguration`, `RedisTopologyClientFactory` 등), 구현 1개짜리 인터페이스 정리, 이름 규칙(outbound `*Port`, inbound `*UseCase`) +4. **테스트 규칙 확산**: 포트별 추상 계약 테스트(`XxxContract`)를 fake와 adapter가 함께 통과(`IdempotencyStorePort` — fake·Redis·PostgreSQL 공통 계약 포함), 약한 단언 정리, 계층별 모범 모듈(2차 TEST 「Migration과 enforcement 계획」) +5. **문서 drift·Nit**: 리뷰의 docs/Nit 항목, leaf CLAUDE.md/README와 코드 불일치 + +각 Wave 시작 때 계획서에 그 Wave의 상세 Task를 추가하고, 끝나면 「진행 기록」에 검증 결과를 남긴다. + +### 5. 이미 알고 있는 남은 문제 (현황표에 행으로 넣는다) + +- CI compose smoke 18 lane을 실제로 돌리지 못함(정적 검사만). `scripts/run-compose-runtime-smoke.sh`는 이제 `/actuator/health`만 확인하고 `compose-profile-contracts.json`의 `expectedSwitchesOn`·`expectedPersistenceVendor`를 읽지 않음. 새 CI 잡(`build-logic.yml`, `integration-main.yml` 추가분)도 GitHub에서 미실행 +- outbox relay 조립(`OutboxConfig`)과 멱등성 executor 조립(`IdempotencyProviderSelectionConfig`)이 아직 app-bootstrap에 있음(capability 완료 기준 7 일부 미충족). sample은 `SampleIdempotencyConfig`로 조립을 따로 복사 +- fileserver 보상 트랜잭션에서 30초 트랜잭션 타임아웃이 사라짐(`PolicyTransactionPort` 제거의 부작용) +- Kafka: truststore/keystore 설정 키 없음, `MUTUAL_TLS` 미지원, producer 주소가 `spring.kafka.bootstrap-servers`만 읽음, credential rotation 미반영 +- Redis 실제 lane 기존 실패 4건(`LiveRedisSemanticPortsTest`: 테스트 ACL에 `TIME` 권한 없음, 시계 +1h). idempotency·lease adapter가 lane 거부를 `Indeterminate`로 분류 +- `S3AsyncResponseBodyBridgeTest`가 부하가 높을 때 간헐 실패 +- durable operation: 같은 operationId 재시도 시 outbox 중복 append. `SubmitDurableOperationUseCase`와 Get/Cancel use case를 쓰는 HTTP 어댑터·운영 조립 없음 +- 알림: reconcile `Unsupported`·모든 attempt 완료 행이 DISPATCHING에 남음(1차 B-4) +- GraphQL 요청 단계 에러가 `GraphQlWireErrorMapper`를 거치지 않음(2차 S5-#6). `shared-contract`의 `OperationalRecordStorePort` 사용처 0 +- web: JSON 엄격성(중복 키 등), CORS origin 기동 검증, 신뢰하지 않는 forwarded 헤더 거부가 운영 경로에 없음. web fixture 앱 2개와 sample 테스트가 `WebAdapterAutoConfiguration`을 이름으로 제외(자동 설정을 나누면 같이 고쳐야 함) +- fileserver를 JPA 줄 없이 고르면 Boot 관계형 자동 설정이 여전히 동작(문서에만 "JPA 필요") +- `bootstrap.autoconfigure` 패키지가 component scan 범위 안에 있음(루트가 아닌 `@Configuration`을 두면 조건 없이 등록됨) +- 빌드: `verifyEnvKeys`·JPA evidence/readiness(`ca.jpa-evidence`, `ca.jpa-qualification`)·redis topology lane을 leaf로 옮길지 미결. API surface 검사가 `mainCheck`로 옮겨가 PR에서 바로 안 잡힘. `messagingSampleContractQualificationTest`가 어떤 집계 태스크에도 묶여 있지 않음 +- `docs/study/*.ko.md`, `docs/*-superpowers-package/`가 삭제된 코드를 설명(학습 기록이라 남겨 둔 것 — 정리 여부 결정) + +### 6. 사용자가 정할 것 (시작 전에 AskUserQuestion으로 한 번에 묻는다 — 괄호는 기본값) + +1. 커밋 방식 (브랜치 `refactor/review-followup`에 Wave마다 커밋, `main` 병합·push는 사용자 확인 후) +2. HTTP 에러 응답 형식 (Envelope 하나로 통일, fileserver의 problem+json도 Envelope로 — tus 프로토콜이 요구하는 헤더만 유지) +3. outbox relay·멱등성 executor 조립 위치 (capability 모듈로 옮기되, ArchUnit `PERSISTENCE_DOES_NOT_DEPEND_ON_APPLICATION_SERVICES` 때문에 persistence-jpa가 아니라 별도 `composition:*` 모듈로) +4. 빌드 게이트 이동 (`verifyEnvKeys`는 bootstrap에 유지, JPA evidence manifest는 폐기하고 leaf 테스트로, redis topology lane은 유지) +5. `@DisplayName` 언어 (영어 유지) +6. 삭제된 코드를 설명하는 학습 문서 (삭제하지 않고 머리에 "208077fd 기준 기록" 한 줄 추가) + +### 7. 작업 규칙과 지난 세션에서 배운 것 + +- **TDD:** 결함 수정은 재현 테스트를 먼저 쓰고 FAIL 출력을 기록한 뒤 고친다. fake가 결함을 숨긴 포트는 추상 계약 테스트로 fake와 adapter를 함께 돌린다. +- **아키텍처:** `modules.json` 밖의 project edge 금지. 새 leaf는 registry 등록 + README(제공·한 줄·env). capability는 "있으면 켜짐, `enabled=false`면 완전히 꺼짐(Boot 자동 설정까지 exclude)". +- **migration:** 적용됐을 수 있는 versioned migration은 수정 금지. 새 버전을 추가하고 `src/adapter/outbound/persistence-jpa/src/test/resources/db/applied-migrations.sha256`에 한 줄 추가(`AppliedMigrationImmutabilityTest`). +- **재생성 태스크:** lockfile `./gradlew :resolveAndLockAll --write-locks`, API surface `update*ApiSurface -Papprove*` (notification은 `-PapproveNotificationApiSurfaceChange`), 확인 `verifyDependencyLocks`. +- **삭제 기록:** 지운 코드는 `docs/capability-status.md` 「제거된 코드」 표에 `| 대상 | 경로 | 마지막으로 존재한 커밋 | 이유 |`로 한 행씩(이번에는 커밋 `6d27356e`). +- **병렬 작업:** 서로 다른 leaf를 건드리는 묶음은 `rsync`로 만든 작업 복사본에서 병렬로 돌리고, 같은 시각의 baseline 복사본과 `diff -ruN`(제외: `build/`, `.gradle/`, `bin/`, `.git/`, `.approval_tests_temp/`, `.jqwik-database`)으로 변경분을 뽑아 `patch -p1 -E`로 main에 반영한다. Gradle은 한 작업 트리에서 동시에 하나만 돌린다. + - **적용 실패를 조용히 넘기지 않는다.** 지난 세션에 `patch --dry-run && patch ...; echo applied`로 dry-run 실패가 가려져 한 묶음이 통째로 빠진 적이 있다. 적용 스크립트는 실패 시 멈추게 하고, 반영 후 복사본과 main 파일을 `cmp`로 대조한다. + - `docs/capability-status.md`, `docs/registries/env-keys.yaml`, `src/.env.example`, `app-bootstrap/build.gradle`, lockfile은 여러 묶음이 함께 고치므로 충돌을 예상하고, lockfile은 손으로 합치지 말고 재생성한다. +- **에이전트 도구:** 셸 heredoc으로 파일을 쓰다 에이전트가 멈춘 적이 있다. 파일은 파일 쓰기 도구로 쓰고, 긴 Gradle 실행은 `timeout`을 건다. +- **검증 (Wave 종료마다, 결과 수치를 기록):** + ```bash + cd src + ./gradlew check --continue + ./gradlew ci verifyDependencyLocks --warning-mode=fail + ./gradlew mainCheck --continue + ./gradlew architectureCheck verifyPublicPathSnapshot :app-bootstrap:verifyEnvKeys configContractCheck + ./gradlew :app-bootstrap:integrationTest :sample-portfolio:integrationTest :sample-portfolio:systemTest + ./gradlew -p build-logic test && ./gradlew -p build-tools test && ./gradlew -p optional-platforms ci + ./gradlew :app-bootstrap:qualificationBootJar + # 건드린 영역의 실제 벤더 lane (Docker): persistence-jpa jpaPlatform*Test / postgresql*IntegrationTest, + # persistence-mongo mongo*Test, messaging starter integrationTest, redisTopologyTest, objectstorage MinIO lane + ``` +- **보고:** 전역 `CLAUDE.md`의 상사 보고 형식(변경 / 확인 / 남은 문제). Wave마다 Slack `#clean-architecture-전체`에 템플릿 1로 브리핑. + +### 8. 완료 조건 + +- `docs/reviews/2026-09-25-review-followup-status.md`의 모든 행이 `완료` / `해당 없음` / `보류(사유·승인자)` +- 계획서 「진행 기록」에 Wave별 검증 결과 +- 7절의 검증 명령이 main(또는 작업 브랜치)에서 전부 통과 diff --git a/docs/reviews/2026-09-25-review-followup-status.md b/docs/reviews/2026-09-25-review-followup-status.md new file mode 100644 index 00000000..08c48982 --- /dev/null +++ b/docs/reviews/2026-09-25-review-followup-status.md @@ -0,0 +1,1099 @@ +# 리뷰 반영 현황표 — 2026-09-25 + +| 항목 | 내용 | +|---|---| +| 입력 | 1차 `docs/reviews/2026-09-24-src-module-code-review.md`(그룹 A–O), 2차 `docs/reviews/2026-09-24-src-maintainability-review.md`(BUILD, TEST, X1, X2, S1–S7), 지난 세션 남은 문제(`NEW-*`) | +| 기준 코드 | 브랜치 `refactor/review-followup` 시작점 = `main` @ `6d27356e`. 리뷰의 경로·줄 번호는 `208077fd` 기준이라 항목마다 현재 코드에서 다시 찾았다 | +| 방법 | 그룹별 읽기 전용 조사 에이전트 12개(grep·git·코드 읽기, Gradle 미실행) → 결과 병합, 같은 결함은 한 행으로 합침(ID를 ` / `로 나열) | +| 실행 계획 | `docs/superpowers/plans/2026-09-25-review-followup.md` | +| 완료 조건 | 모든 행이 `완료` / `해당 없음` / `보류(사유·승인자)` | + +## 상태 정의 + +- `완료`: 현재 코드에서 수정을 직접 확인함. 근거에 `file:line`·테스트 이름·커밋. +- `해당 없음(코드 삭제)`: 대상 코드가 삭제됐고 같은 결함이 옮겨진 곳에도 없음. 근거에 `docs/capability-status.md` 「제거된 코드」 표 행. +- `남음`: 근거에 현재 `file:line`. Wave는 `W1` 보안·데이터 손실, `W2` 정합성, `W3` 구조, `W4` 테스트 규칙, `W5` 문서·Nit. +- `보류`: 반영하지 않기로 함. 사유와 승인자를 적는다. + +리뷰 항목이 여러 결함을 묶은 경우 `A-6a`, `A-6b`처럼 나눴다. 리뷰에 없던 결함을 조사 중 찾은 경우도 같은 그룹 행으로 넣었다(예: `B-2e`, `C-3d`, `C-12c`). + +## 소유자 결정 (2026-09-25) + +작업 시작 때 받은 6건: + +1. 커밋: 브랜치 `refactor/review-followup`에 Wave마다 커밋, `main` 병합·push는 사용자 확인 후. +2. HTTP 에러 응답: Envelope 하나로. fileserver problem+json도 Envelope로, tus 프로토콜 헤더만 유지. +3. outbox relay·멱등성 executor 조립: app-bootstrap에서 별도 `composition:*` 모듈로(ArchUnit `PERSISTENCE_DOES_NOT_DEPEND_ON_APPLICATION_SERVICES` 때문에 persistence-jpa가 아님). +4. 빌드 게이트: `verifyEnvKeys`는 bootstrap 유지, JPA evidence manifest는 폐기하고 leaf 테스트로, redis topology lane 유지. +5. `@DisplayName`: 한국어. +6. 삭제된 코드를 설명하는 학습 문서(`docs/study/*.ko.md`, `docs/*-superpowers-package/`): 현재 코드에 맞게 갱신. + +현황표 판정 뒤 `결정 필요` 행에 대해 받은 14건: + +| # | 질문 | 결정 | 해당 행 | +|---|---|---|---| +| 7 | outbox append 모델 | canonical(`OutboxAppendPort`)로 통일. 템플릿이 JSON encoder 제공, legacy 포트·legacy Kafka 발행 경로 삭제 | S1-#2b, S2-#4b, S2-lead-1, X1-#1b | +| 8 | 분산 lock·lease | 둘 다 capability로 유지, 공통 계약 테스트 | S1-#3b, X1-#6b, X1-지도-lock | +| 9 | httpclient reactive 스택 | 삭제(D4를 outbound에도 적용) | S3-#1 (H-5, H-7, S3-#2a가 따라감) | +| 10 | messaging Kafka 소비 | 지원. `MessageHandler` 하나 + starter-kafka가 consumer 조립 | S7-#2 | +| 11 | client 에러 문구 언어 | 한국어. `Category`별 문구 표 하나를 shared-contract에 | S5-lead-1 | +| 12 | Draft-12 offset 불일치 problem 문서 | 프로토콜 예외로 유지 | X2-P2-3b, S5-#1d | +| 13 | 알림 category 생략 | 거부(400), 판정은 유스케이스로 | I-6a | +| 14 | fileserver 인가 | 소유자 검사 추가(`ownerPrincipalId`) | C-8a | +| 15 | durable operation | HTTP 어댑터 추가 | NEW-7b | +| 16 | 설정 prefix | `app.*`로 통일, `APP_*` env 키 유지 | S6-#14 | +| 17 | SES 연동 | AWS SDK(sesv2)로 교체 | S4-lead-3 | +| 18 | gRPC `.proto` 처리 | protobuf Gradle 플러그인 + Buf(CI)로 전환 | S7-#13 | +| 19 | 의존성 checksum 검증 | 추가 안 함 → 보류 | O-5a | +| 20 | API surface 검사 단계 | PR(`check`)로 올림 | NEW-13d | + +기존 원칙에서 바로 따라 나와 에이전트가 정한 것(소유자가 뒤집을 수 있음): + +- M-2b: Kafka 주소는 `app.messaging.brokers..bootstrap-servers` 하나(AGENTS.md capability 기준 4 "prefix 하나"). +- NEW-11: fileserver·notification composition이 persistence-jpa를 `runtimeOnly`로 함께 가져옴("한 줄 = 기능 전체"). +- X1-#7a: readiness·evidence는 O3대로 소유 leaf 테스트로(결정 4와 같은 방향). +- X2-P1-4b: persistence 라이브러리의 서명 cursor codec은 유지(Wave 3 "라이브러리 유지"), 서명 헬퍼만 shared-contract로. +- X2-P2-2b: `IllegalArgumentException`은 모든 전송에서 400(web 현재 동작 유지). +- NEW-1a: compose smoke가 health component·info로 켜진 capability를 확인. +- BUILD-중복-8: sample-portfolio를 ArchUnit 대상에 다시 넣고, optional-platforms는 Gradle 방향 게이트로 충분하다고 명시. + +이전 계획(`2026-09-25-capability-module-packaging.md`)에서 이미 결정됐지만 실행되지 않은 것 — 이번에 실행한다: + +- 미조립 알림 provider 5종(FCM·APNs·WebPush·Twilio·Webhook) 삭제(W4 표, spec 6절 3). → S4-#3a +- notification persistence를 `persistence-notification` leaf로 추출(S2-#1). → S2-#1b +- gRPC 상수 gate·`GrpcStableModuleCatalog` 삭제(Wave 2 표 2-G). → S7-#4 + +에이전트 기본값(위 provider 5종 삭제와 같은 규칙 — 조립 경로가 없는 코드는 삭제하고 「제거된 코드」 표로 복구 경로를 남김): object storage direct·multipart 업로드 코드(약 3.2k줄, main 호출자 0)는 삭제한다. 이 기능을 capability로 완성하길 원하면 소유자가 뒤집는다. → D-7a + +## 요약 + +| 상태 | 행 수 | +|---|---| +| 완료 | 161 | +| 해당 없음 | 106 | +| 남음 | 544 | +| 보류 | 1 | +| 합계 | 812 (중복 병합 16행) | + +| Wave (남음) | 행 수 | +|---|---| +| W1 | 55 | +| W2 | 139 | +| W3 | 196 | +| W4 | 56 | +| W5 | 98 | + + + +## 1차 A Core · L Composition/sample + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| A-1a | Required | `FailOpenDependencyLogger.logFailure`가 `cause.getMessage()`를 WARN 로그에 그대로 남김(수신자 주소·webhook URL 누출 가능, Javadoc은 "PII cannot reach the log") | 남음 | `src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:39-47`(`:47` `cause.getMessage()`), Javadoc `:10-11`. 호출자 `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java:42` | W1 | `FailOpenDependencyLogger.java:41,47`에서 `getMessage()`를 빼고 `error="{}"`에 예외 클래스 simple name만 남긴다 | +| A-1b | Required | PII 누출 테스트가 메시지 `"connection refused"`로 `@gmail.com` 부재만 확인 → 아무것도 증명 못 함 | 남음 | `src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:65-72` | W4 | 같은 테스트에서 예외 메시지에 `alice@example.com`, `https://hooks.slack.com/services/...`를 넣고 렌더된 로그에 둘 다 없음을 단언 | +| A-2a | Required | websocket이 prod 판정을 손으로 재구현(`"prod".equals`, trim/소문자 없음) → `Prod` 프로필에서 prod 안전 검증 건너뜀 | 해당 없음(코드 삭제) | 「제거된 코드」 표 `app.websocket.platform.*` 설정(`WebSocketPlatformSafetyConfiguration`, `WebSocketPlatformStartupValidator` 포함) 행. `git log --diff-filter=D`로 `6d27356e` 삭제 확인, 현재 websocket main에 `getActiveProfiles` 호출 0건 | - | - | +| A-2b | Required | `RuntimeProfileSnapshot` Javadoc "repository에서 `getActiveProfiles`를 읽는 유일한 production 타입" 주장이 거짓 | 남음 | `src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/runtime/RuntimeProfileSnapshot.java:12-13`. 직접 읽는 곳: `src/adapter/inbound/graphql/.../autoconfigure/GraphQlPlatformAutoConfiguration.java:123`, `src/adapter/outbound/fileserver/.../platform/autoconfigure/FileserverSecurityConfiguration.java:81`, `src/adapter/outbound/httpclient/.../autoconfigure/HttpClientProfileAutoConfiguration.java:155-156`, `src/adapter/outbound/objectstorage/.../config/ObjectStorageCapabilityConfig.java:59-61` | W5 | `RuntimeProfileSnapshot.java:12-13` 문장을 "composition root(app-bootstrap)의 reader"로 좁히거나 삭제 | +| A-2c | Required | BOOT-002 가드 ArchUnit이 `dev.caskeleton.bootstrap..`만 검사 → 다른 leaf의 새 profile reader·손 판정은 못 잡음 | 남음 | `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java:12-21` (변경 없음, `git diff 208077fd 6d27356e` 0줄) | W3 | 같은 규칙을 `dev.caskeleton..`(messaging·sample 제외)로 넓히고 `getActiveProfiles` 호출 허용 목록을 현재 5곳(`RuntimeProfileSnapshot`, 위 graphql·fileserver·httpclient·objectstorage 클래스)으로 고정 — support에 의존 못 하는 graphql·objectstorage가 있어 snapshot 강제는 불가 | +| A-2d | Required | `RuntimeEnvironment` Javadoc이 bridge를 "app-bootstrap's `RuntimeProfileSnapshot`"이라 하고 bootstrap 외 reader가 없다고 서술 | 남음 | `src/shared-contract/src/main/java/dev/caskeleton/shared/runtime/RuntimeEnvironment.java:29-36` (bridge는 `adapter:outbound:support`에 있음) | W5 | `RuntimeEnvironment.java:32-36`을 "support의 `RuntimeProfileSnapshot` 또는 `getActiveProfiles` 결과를 직접 넘기는 platform config"로 정정 | +| A-3 / X1-#1e | Required | outbox V2 단건 발행 코드(`PublishNextOutboxDeliveryUseCase`, `OutboxV2RetryPolicy`)가 테스트 0·호출자 0, 동기 publish에 timeout 미적용 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "application-core outbox V2 포트·유스케이스 17종" 행(D2). `git grep PublishNextOutboxDelivery\|OutboxV2RetryPolicy -- src` 0건. 남은 v1 relay는 lease 만료 시 `STALE`로 기록(`src/application-core/src/main/java/dev/caskeleton/application/outbox/PublishPendingOutboxEventsUseCase.java:25-26`)
X1-#1e: `OutboxV2RetryPolicy`·`PublishNextOutboxDeliveryUseCase` 삭제(`docs/capability-status.md:175`), main 참조 0 | - | - | +| A-4a | Required | operation 조회·취소 유스케이스가 없어 web이 store 포트·트랜잭션·owner/tenant 인가를 직접 수행 (= I-1, Critical #12) | 완료 | `src/application-core/src/main/java/dev/caskeleton/application/operation/GetDurableOperationUseCase.java:14-51`(QueryUseCase + `@UseCaseCapability`), `CancelDurableOperationUseCase.java:74-121`(CommandUseCase + `@RequiresPermission` + `@UseCaseCapability`), 인가 `DurableOperationAccessPolicy.java:147-150`. web `OperationQueryService`는 「제거된 코드」 "durable operation HTTP 투영" 행. 테스트 `GetDurableOperationUseCaseTest.submitterInAnotherTenantReadsNothing`, `CancelDurableOperationUseCaseTest.submitterInAnotherTenantIsAnsweredAsIfTheOperationDidNotExist`, `DurableOperationAccessPolicyTest.onlyTheSubmitterInTheSubmittingTenantMayAccess`. 커밋 `6d27356e` | - | - | +| A-4b | Required | `SubmitDurableOperationUseCase`가 `CommandUseCase`를 구현하지 않음(자체 `submit` 메서드), production 호출자 0 | 남음 | `src/application-core/src/main/java/dev/caskeleton/application/operation/SubmitDurableOperationUseCase.java:53,85`. `LegacyOutboxAppendPort` 사용(`:56`)은 MSG-015 문서화된 seam(`src/messaging/CLAUDE.md:75-78`) | W3 | `SubmitDurableOperationUseCase`가 `CommandUseCase`를 구현하고 `submit`→`handle`로 이름 변경(Get/Cancel과 같은 모양) | +| A-5a | Required | shared-contract README가 "1001번째 tenant부터 bucket folding 자동 적용"을 약속하지만 적용 코드 없음 | 남음 | `src/shared-contract/README.md:350`. `CardinalityBounds`·`MetricNaming` main 참조 0(테스트 `MetricsAlertingContractTest`만), 실제 필터 `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/metrics/MetricsCardinalityMeterFilter.java`는 `ForbiddenMetricTags`만 사용 | W5 | `src/shared-contract/README.md:350`의 자동 folding 문장 삭제(연결은 필요해질 때) | +| A-5b | Required | `RedisHealthSnapshotProvider` 구현·소비자 0인데 CLAUDE.md는 "adapters and bootstrap health composition이 사용"이라 서술 | 남음 | `src/shared-contract/src/main/java/dev/caskeleton/shared/health/RedisHealthSnapshotProvider.java`(참조는 자기 파일·문서뿐), `src/shared-contract/CLAUDE.md:22-23`, `src/shared-contract/README.md:15` | W3 | `RedisHealthSnapshotProvider.java` 삭제 + `shared-contract/CLAUDE.md:22-23`, `README.md:15` 문장 삭제 | +| A-5c | Required | 소비자 없는 "계약" 타입(`AlertSeverity`, `BaggageAllowlist`, `CardinalityBounds`, `MetricNaming`)이 main에 있음 — 테스트에서만 사용 | 남음 | `src/shared-contract/src/main/java/dev/caskeleton/shared/metrics/{AlertSeverity,CardinalityBounds,MetricNaming}.java`, `.../shared/tracing/BaggageAllowlist.java`. main 참조 0, 사용처는 `src/app-bootstrap/src/test/.../contract/MetricsAlertingContractTest.java`, `DistributedTracingContractTest.java` | W3 | 4개 타입을 shared-contract `testFixtures`로 옮기거나 삭제하고 README(`:367,375,403`) 절 정리 | +| A-6a | Required | application-core CLAUDE.md/README가 코드와 다름: application-notification 소유 타입을 core 절로 설명, operation·cache·lease·realtime 절 없음 | 남음 | `src/application-core/CLAUDE.md:76-80`(Notification 절), `src/application-core/README.md:495-530`(`NotificationPort`를 "application-core로 옮긴" 타입으로 서술 — 실제 `src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPort.java`). 헤더 목록에 operation/cache/lease/realtime 없음(패키지는 `src/application-core/src/main/java/dev/caskeleton/application/{operation,cache,lease,realtime}/` 존재) | W5 | application-core `CLAUDE.md:76-80`·`README.md:495-530` 알림 절을 application-notification 문서로 옮기고, README에 operation(Get/Cancel/Submit)·cache(`CacheRegionPort`)·lease·realtime(`LiveEventReplayPort`) 절 추가 | +| A-6b | Required | identifier CLAUDE.md가 없는 ArchUnit 규칙과 없는 hook을 인용 | 남음 | `src/adapter/outbound/identifier/CLAUDE.md:33`(`identifier_adapter_does_not_depend_on_other_adapters_or_bootstrap` — `git grep` 결과 이 파일뿐), `:34`(`.claude/hooks/ca_import_gate.py` 없음), `:8` Boot 4.0.0. 의존성(`:28`)·테스트 이름(`:41`)은 `6d27356e`에서 고쳐짐 | W5 | `identifier/CLAUDE.md:32-34`를 "modules.json 방향 게이트가 차단"으로 교체, `:8` 버전 삭제 | +| A-6c | Required | identifier README 패키지 루트·SSOT 오기, 삭제된 UUID 능력을 설명 | 남음 | `src/adapter/outbound/identifier/README.md:3`(`dev.caskeleton.adapter.identifier`, 실제 `...adapter.outbound.identifier`), `:50`(`src/build.gradle`의 `allowedProjectDependencies`), `:11-12` UUIDv7 식별자 생성(main엔 `HmacUserPrincipalPseudonymizer`만). Spock 절은 삭제됨 | W5 | `identifier/README.md:3`, `:50`을 실제 패키지·`src/config/architecture/modules.json`으로, `:11-12` UUID 문장 삭제 | +| A-6d | Required | support README가 "CLAUDE.md 없음", SSOT를 `src/build.gradle`로, 없는 `OutboundHttpDependencyLogger`를 언급 | 남음 | `src/adapter/outbound/support/README.md:7-8`(`src/adapter/outbound/support/CLAUDE.md` 존재), `:24`(`class OutboundHttpDependencyLogger` 0건) | W5 | `support/README.md:7-8`을 modules.json·CLAUDE.md 참조로, `:23-24` 비교 문장 삭제 | +| A-6e | Required | shared-contract README가 없는 `RateLimiter`/`RateLimiterFactory`를 패턴 예시로 인용 | 남음 | `src/shared-contract/README.md:436,499`, 같은 인용 `src/shared-contract/src/main/java/dev/caskeleton/shared/concurrency/DomainContextPropagatorFactory.java:8` | W5 | 세 곳의 `RateLimiter*` 비교 문장 삭제 | +| A-7a | Consider | `ValidatedIntegrationEvent`가 `envelopeSha256`과 `envelopeBytes` 일치를 확인하지 않음 — DB 복원 경로가 저장된 해시를 그대로 신뢰 | 남음 | `src/application-core/src/main/java/dev/caskeleton/application/messaging/event/ValidatedIntegrationEvent.java:78-83`(null 검사만), 복원 `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java:197-214` | W2 | 생성자에서 `envelopeBytes`의 SHA-256을 계산해 `envelopeSha256`과 다르면 `IllegalArgumentException` | +| A-7b | Consider | `CORRELATION_GRAMMAR`가 `*`라 correlation/causation id 길이 무제한인데 오류 메시지는 "bounded" | 남음 | `ValidatedIntegrationEvent.java:36,54,58-59,159` | W2 | `CORRELATION_GRAMMAR`를 `[A-Za-z0-9][A-Za-z0-9._:-]{0,127}`로 | +| A-8a | Consider | v1 `IdempotencyExecutor.runAndComplete`가 완료 기록 실패를 action 실패로 처리 → 재시도 때 action 재실행 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "요청 멱등성 v1 모델 (`IdempotencyExecutor`(v1) …)" 행(D3). 현재 executor는 try가 `action.run()`만 감쌈(`src/application-core/src/main/java/dev/caskeleton/application/idempotency/IdempotencyExecutor.java:192-198`) | - | - | +| A-8b | Consider | 정본 executor(구 V2)에서 `preserveUnknown`이 던지면 원래 action 예외를 잃음 | 남음 | `src/application-core/src/main/java/dev/caskeleton/application/idempotency/IdempotencyExecutor.java:194-198`, `:210-213` | W2 | 두 곳에서 `preserveUnknown` 호출을 try/catch로 감싸 `failure.addSuppressed(e)` 후 원래 예외를 던진다 | +| A-9a | Consider | `UuidCodec` 죽은 코드(외부 참조 0, "canonical" 계약도 틀림) | 해당 없음(코드 삭제) | 「제거된 코드」 표 `UuidCodec` 행 | - | - | +| A-9b | Consider | application-core 테스트 헬퍼 `CompiledPackageScanner` 참조 0 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "application-core 테스트 헬퍼 `CompiledPackageScanner`" 행(다른 leaf 사본 2개는 사용 중) | - | - | +| A-9c | Consider | `@Deprecated(forRemoval)` `FileExportPort` 호출자 0 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "`FilePublicationPort`·`FileExportPort` 계약" 행 | - | - | +| A-10a | Nit | identifier가 `ca.spring-library`를 써서 순수 단위 테스트에 webmvc-test·tomcat 유입 | 남음 | `src/adapter/outbound/identifier/build.gradle:2` (main은 Spring 어노테이션 없는 `HmacUserPrincipalPseudonymizer` 하나) | W5 | `identifier/build.gradle:2`를 `id 'ca.java-library'`로(lockfile 갱신) | +| A-10b | Nit | `MasterSwitch.java:57-66` 주석 줄 깨짐 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "`MasterSwitch`, `MasterSwitchParser`, `MasterSwitchParseResult`" 행 | - | - | +| A-10c | Nit | `DomainContextStrategy`/`DomainContextPropagatorFactory`가 case 하나뿐인 확장 지점 | 남음 | `src/shared-contract/src/main/java/dev/caskeleton/shared/concurrency/DomainContextStrategy.java:12-19`(`THREAD_LOCAL` 하나), `DomainContextPropagatorFactory.java:14-18`, 바인딩 `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/concurrency/DomainContextSettings.java:12-16` | W3 | enum·factory·`DomainContextSettings`(`ca-skeleton.domain-context.strategy`)를 지우고 호출부가 `new ThreadLocalDomainContextPropagator()`를 직접 쓴다 | +| L-1 | Critical | outbox relay `@Scheduled`가 `@EnableScheduling` 없이는 안 돌고, 유일한 `@EnableScheduling`이 idempotency=jdbc 조건부 (Critical #5) | 완료 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfig.java:54` `@EnableScheduling`(outbox 켜짐 + `OutboxStorePort` bean 조건). 테스트 `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfigTest.java:28` `outboxCapabilityEnablesSchedulingWithIdempotencyDisabled`. `OutboxReaper`(persistence-jpa)도 같은 `ca-skeleton.outbox.enabled` 조건이라 함께 동작. 커밋 `6d27356e` | - | - | +| L-2a | Required | prod가 에러 상세(stacktrace/message/exception) 노출을 막는다고 적었지만 검사 코드가 없음 | 완료 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/ErrorDetailExposureSafetyValidator.java:39-62`(include-stacktrace/message/binding-errors ≠ never, include-exception=true → exit 71), 등록 `RuntimeSafetyConfig.java:28-31`. 테스트 `ErrorDetailExposureSafetyValidatorTest.prodRefusesToStartWhenErrorDetailsWouldReachClients`, `prodStartsWhenEveryErrorDetailStaysHidden`. 문서 `application-prod.yml:13`, `src/README.md:216-218`, `src/app-bootstrap/README.md:177-178,680-681` 정정. 커밋 `6d27356e` | - | - | +| L-2b | Required | `config/runtime.yml` 주석이 multi-instance를 "prod profile이 기동 시 강제", "instance-coordination bean 5종 필요"라고 서술(실제 검사는 profile 무관·lock provider 1개) | 남음 | `src/app-bootstrap/src/main/resources/config/runtime.yml:11-13` vs `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidator.java:42-61` | W5 | `runtime.yml:11-13`을 "true면 `distributedLockProvider`(persistence-jpa)가 없을 때 기동 실패(exit 72)"로 교체 | +| L-3 | Required | sample actuator `loggers`에 인증 없이 쓰기 가능 | 완료 | `src/sample-portfolio/src/main/resources/application.yml:116-117` `loggers.access: read-only`. 테스트 `src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/management/SampleActuatorLoggersAccessTest.java:15` `loggersEndpointIsReadOnlyBecauseTheSampleManagementPortIsUnauthenticated`. 커밋 `6d27356e` | - | - | +| L-4a | Required | sample이 중앙 ArchUnit에서 빠졌고 대체 규칙 3개가 HARD-STOP 2/3을 못 덮음(domain→application/adapter, application→web dto, controller→Spring Data/JPA) | 남음 | `src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java:25-69`(규칙 3개 그대로), `src/app-bootstrap/build.gradle`에 sample 참조 0 | W4 | `SampleArchitectureTest`에 `noClasses()` 3개 추가: domain→`..application..`/`..adapter..`/`..bootstrap..`, application→`..adapter.inbound.web..`, `..adapter.inbound.web..`→`org.springframework.data..`/`jakarta.persistence..` | +| L-4b | Required | sample CLAUDE.md 등이 없는 ArchUnit 규칙 `production_code_does_not_depend_on_sample_portfolio`와 없는 `testImplementation` 참조를 인용 | 남음 | `src/sample-portfolio/CLAUDE.md:38-41`, 같은 인용 `src/app-bootstrap/README.md:771`, `src/domain-core/README.md:27`. 규칙 정의 0건 | W5 | 세 곳을 "modules.json에 sample로 향하는 edge가 없어 방향 게이트가 차단"으로 교체 | +| L-4c | Required | `adapter:inbound:grpc`가 architectureTest classpath에 없음 | 완료 | `src/app-bootstrap/build.gradle:125`(`capabilityProjects`의 `:adapter:inbound:grpc`), `:155` `architectureTestRuntimeOnly`. 커밋 `6d27356e` | - | - | +| L-5 | Consider | 남은 `StartupSafetyValidator` 검사(multi-instance → lock provider)는 절대 실패할 수 없음 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "`DistributedLockConfig`와 `DistributedLockConfigTest`" 행 — bean이 opt-in persistence-jpa(`DistributedLockPersistenceConfig.java:83-92`)로 옮겨져, JPA 없는 기본 조립에서 `APP_MULTI_INSTANCE_ENABLED=true`면 이 검사만 실패시킴. 테스트 `StartupSafetyValidatorTest.multiInstanceEnabledWithMissingDistributedLockProviderFailsStartup` | - | - | +| L-6a | Consider | 관계형 의존 목록이 `DataSourceRequirement`와 `CapabilityDependencyValidator` 두 곳에 있고 fileserver 항목이 어긋남 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "`JpaOffAutoConfigurationImportFilter`, `DataSourceRequirement`" 행과 "bootstrap `activation` 패키지(`CapabilityDependencyValidator` …)" 행. fileserver는 `persistence-fileserver`가 data-jpa를 직접 가져옴 | - | - | +| L-6b | Consider | `SecretSourceValidator`가 DB 없는 prod 배포에도 `APP_DATASOURCE_PASSWORD`를 요구 | 완료 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidator.java:109-110`(`ca-skeleton.persistence-jpa.enabled` 아닐 때 건너뜀). 테스트 `SecretSourceValidatorTest.prodProfileWithoutRelationalPersistenceDoesNotRequireADatabasePassword`. 커밋 `6d27356e` | - | - | +| L-7a | Consider | actuator chain에 인증 수단(`oauth2ResourceServer`/`httpBasic`)이 없어 `loggers` GET과 `show-details: when-authorized`에 어떤 자격증명으로도 도달 불가 | 남음 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/management/security/ManagementSecurityConfig.java:25-42`, `src/app-bootstrap/src/main/resources/config/observability.yml:34,41` | W2 | 지금도 도달 불가라 잃는 동작이 없으므로 `observability.yml:34`에서 `loggers` 노출 제거, `:41`을 `show-details: never`로, `ManagementSecurityConfig.java:37-40` loggers 규칙 삭제 | +| L-7b | Consider | `ActuatorSecurityHttpTest`가 `.with(user("ops"))`로 보안 컨텍스트를 주입해 실제로는 도달 불가능한 200을 단언 | 남음 | `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ActuatorSecurityHttpTest.java:99-100`(`loggersReadIsAllowedForAuthenticatedCaller`), `:104-120` | W4 | L-7a 적용 후 `loggersReadIsAllowedForAuthenticatedCaller`·loggers write 테스트를 "loggers 비노출(404)" 단언 하나로 교체 | +| L-8a | Consider | sample 기본값 `flyway.out-of-order: true`(prod가 금지하는 값) | 남음 | `src/sample-portfolio/src/main/resources/application.yml:45` | W2 | `application.yml:45`를 `out-of-order: false` | +| L-8b | Consider | sample 기본값 `ddl-auto: update`가 Flyway 소유 스키마를 덮음(mapping/migration 불일치를 숨김) | 남음 | `src/sample-portfolio/src/main/resources/application.yml:53` | W2 | `application.yml:53`을 `${APP_DATASOURCE_DDL_AUTO:validate}` | +| L-9 | Nit | `NotificationApplicationCompositionAutoConfiguration`에 `@Bean` 12개, 고아 Javadoc, inline FQN | 완료 | `src/composition/notification-platform/src/main/java/dev/caskeleton/composition/notification/NotificationApplicationCompositionAutoConfiguration.java:14-27`(`@Bean` 0, `@Import` 3개) → `NotificationSubmissionConfiguration`(7), `NotificationDeliveryConfiguration`(5), `NotificationCallbackConfiguration`(2). 커밋 `6d27356e` | - | - | +| L-10a | Nit | outbox 설정 주석이 "NO env placeholders", "Bound into OutboxProperties"라 서술(실제 placeholder 있음, binder는 `OutboxSettings`) | 남음 | bootstrap `config/outbox.yml`은 삭제됐으나 주석이 `src/adapter/outbound/persistence-jpa/src/main/resources/config/module-defaults/persistence-jpa.yml:178-179`로 옮겨 살아 있음(placeholder `:188-192`, 바인더 `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxSettings.java`) | W5 | `persistence-jpa.yml:178-179`를 "Bound into OutboxSettings (app-bootstrap); enabled/relay-enabled/canonical-transport-enabled만 env"로, `:180`의 떨어진 relay-enabled 주석을 `:189` 위로 | +| L-10b | Nit | `config/idempotency.yml`이 없는 `IdempotencyProperties`를 이름으로 가리킴 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "bootstrap 멱등성 조립 (… `config/idempotency.yml`)" 행 | - | - | +| L-10c | Nit | app-bootstrap README "19개 leaf" 숫자 | 완료 | `src/app-bootstrap/README.md:7` "모든 leaf"로 바뀜, `[0-9]+개 leaf` 0건. 커밋 `6d27356e` | - | - | +| L-10d | Nit | app-bootstrap CLAUDE.md가 bootstrap의 삭제된 `RedisCapabilityConfig`/`RedisKeys`를 가리킴 | 완료 | `src/app-bootstrap/CLAUDE.md:92,102`가 `cache-redis`의 `capability/RedisCapabilityConfig`·`RedisKeys`로 정정, 두 파일 `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/capability/`에 존재. 커밋 `6d27356e` | - | - | +| L-10e | Nit | sample README가 삭제된 `TestEnclosedConfigurationFilter`와 두 곳 customizer를 설명 | 완료 | `src/sample-portfolio/README.md`에 `TestEnclosedConfigurationFilter`·`customizer` 0건. 커밋 `6d27356e` | - | - | +| L-10f | Nit | app-bootstrap build.gradle에 대상 없는 고아 주석 | 남음 | 원래 지적한 `:90-92` 주석은 삭제됐으나 같은 파일 `src/app-bootstrap/build.gradle:240-241`("Kafka producer ownership lives in adapter:outbound:messaging…")이 무관한 `jakarta.ws.rs-api` 줄 위에 남음 | W5 | `build.gradle:240-241` 두 줄 삭제 | +| L-11a | Nit | 테스트·sample yml이 `ca-skeleton.rate-limit.*`에 값을 넣지만 바인더는 `app.rate-limit` | 남음 | `src/app-bootstrap/src/test/resources/application-test.yml:113-117`, `src/sample-portfolio/src/main/resources/application.yml:189-194`; 바인더 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/ratelimit/EdgeRateLimitTransportSettings.java:14` | W5 | 두 yml 블록을 `app.rate-limit` 아래로 옮기거나 삭제(sample은 `APP_RATE_LIMIT_ENABLED`가 지금 아무 효과 없음) | +| L-11b | Nit | 테스트 yml이 `api-base-path: ""`와 `/api/healthcheck` 공개 경로를 짝지음(무해) | 남음 | `src/app-bootstrap/src/test/resources/application-test.yml:112,121` | W5 | `:121`을 `/healthcheck`로(또는 주석으로 의도 명시) | +| L-11c | Nit | 어디서도 참조하지 않는 `developer-experience/broken-readme.md` | 남음 | `src/app-bootstrap/src/test/resources/developer-experience/broken-readme.md` (`git grep broken-readme\|definitelyMissingDxTask` → 자기 자신과 리뷰 문서뿐) | W5 | 파일 삭제 | + +**조사 메모** + +- A-4a = I-1 = Critical #12. 같은 파일 `SubmitDurableOperationUseCase.java:102`의 `alreadyAccepted = !operation.operationId().equals(command.operationId())`는 같은 id 재시도 시 outbox를 한 번 더 append한다(Wave 1 진행 기록의 "durable operation 같은 id 재시도 시 outbox 중복", E 그룹 소관). +- A-2 관련, 그룹 밖: vendored messaging `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminDurabilityValidator.java:25,53-54`가 `Set.of("prod","production")::contains`(trim·소문자 없음)로 판정 → `Prod`면 durable journal 검사를 건너뛴다. A-2a와 같은 fail-open 모양이지만 messaging은 shared-contract를 쓰지 않는 설계라(`RuntimeEnvironment.java:38-39`) M 그룹에서 다룰 일. +- L-1: 소유자 결정대로 outbox relay 조립을 `composition:*`로 옮길 때 `OutboxConfig.java:54`의 `@EnableScheduling`과 `OutboxConfigTest.outboxCapabilityEnablesSchedulingWithIdempotencyDisabled`를 함께 옮겨야 L-1이 되살아나지 않는다. +- L-5: 리뷰 당시 전제("같은 조건의 bean이 bootstrap에 있어 항상 먼저 실패")는 `DistributedLockConfig`가 opt-in persistence-jpa로 옮겨지며 사라졌다. 지금은 JPA를 빼고 multi-instance를 켠 조립을 잡는 유일한 검사다. +- L-10b와 별개로 `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxSettingsTest.java:12`가 없는 `IdempotencyPropertiesTest`를 인용한다(W5). +- 리뷰 자체의 부정확: A-4 수정안은 owner·tenant 판정을 `ObjectAccessPolicy` 뒤로 옮기라 했으나, 구현은 application-core 안의 전용 `DurableOperationAccessPolicy`를 썼다. 인가가 application 계층에 있다는 목적은 충족하므로 완료로 판정했다. + +## 1차 B Notification · C File server + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| B-1a | Critical | lease recovery pass가 트랜잭션 없이 `@Modifying` 실행 → 매 pass 실패 | 완료 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/LeaseRecoveryService.java:112`(`inWrite(expireOverdue)`), `:144-151`(requeue `inWrite`). adapter에서 application-notification으로 이동. 테스트 `PostgreSqlNotificationBackgroundPassIntegrationTest.recoveryRequeuesADeliveryAbandonedBeforeAnyAttempt`·`recoveryRetiresADeliveryWhoseWindowClosed`(PG lane). 커밋 `6d27356e` | - | - | +| B-1b | Critical | projection의 attempt 매칭(`bindAttempt`)·`markFailed`가 트랜잭션 밖 | 완료 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java:57`(resolve 포함 전체 `inWrite`), `:69-73`(`markFailed` 자체 `inWrite`), `:139`. 테스트 `PostgreSqlNotificationBackgroundPassIntegrationTest.replayBindsAndProjectsACallbackThatArrivedBeforeItsAttempt`·`replayMarksAnEventWithNoProjectorFailed`. 커밋 `6d27356e` | - | - | +| B-1c | Critical | replay worker catch의 `markFailed`가 트랜잭션 밖 | 완료 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/ProviderEventReplayWorker.java:71-75`(projection 서비스의 트랜잭션 경유). 테스트 `PostgreSqlNotificationBackgroundPassIntegrationTest.replayMarksAnEventWhoseProjectionThrowsFailed`. 커밋 `6d27356e` | - | - | +| B-1d | Critical | reconciliation `ledger.append`가 트랜잭션 밖 | 완료 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java:89-105`(`inWrite`), `:119-125`. 테스트 `PostgreSqlNotificationBackgroundPassIntegrationTest.reconciliationRecordsAConfirmedAnswerOutsideAnyCallerTransaction`·`recoveryRecordsTheProvidersAnswerForAnAttemptThatMayHaveBeenSent`. 커밋 `6d27356e` | - | - | +| B-2a | Critical | SNS 인증서 host가 `*.amazonaws.com` suffix 허용(S3 bucket 통과) | 완료 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SnsSignatureVerifier.java:45-46`(`sns..amazonaws.com(.cn)` 정규식), `:94-119`(userinfo·query·port·path 제한). 테스트 `SnsCertificateUrlTest.aHostThatIsNotAnSnsRegionalEndpointIsRefused`·`aHostThatMerelyEndsWithTheSuffixIsRefused`·`anUnknownSignatureVersionIsRefused`. 커밋 `6d27356e` | - | - | +| B-2b | Critical | TopicArn allowlist 없음 | 완료 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesCallbackAdapter.java:75-78`, 콜백 켜면 필수 `.../platform/autoconfigure/NotificationPlatformSettings.java:349-355`. 테스트 `SesCallbackAdapterTest.aSignedMessageFromAnotherTopicIsRejected`, `NotificationPlatformSettingsTest.sesCallbacksWithoutAnAllowedTopicListFailBinding`. 커밋 `6d27356e` | - | - | +| B-2c | Critical | SNS `Timestamp` 미검사(재전송 무기한) | 완료 | `SesCallbackAdapter.java:79-81`·`withinReplayWindow`, `.../platform/autoconfigure/NotificationCallbackProviderConfig.java:93-98`(`callbacks.replay-skew`). 테스트 `SesCallbackAdapterTest.aSignedMessageOlderThanTheReplayWindowIsRejected`. 커밋 `6d27356e` | - | - | +| B-2d | Critical | 인증서 캐시 무제한, `computeIfAbsent` 안에서 네트워크 fetch | 완료 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationCallbackProviderConfig.java:34`(상한 64), `:49-62`(fetch를 map 밖에서). 테스트 `SnsCertificateCacheTest.theCacheForgetsCertificatesOnceItPassesItsBound`·`aCachedCertificateIsNotFetchedAgain`. 커밋 `6d27356e` | - | - | +| B-2e | Critical | 받아온 인증서의 subject 검사 없음 | 남음 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationCallbackProviderConfig.java:73-78`(`getPublicKey()`만 반환, `getSubjectX500Principal` 참조 0). host가 SNS 리전 host + https로 제한돼 잔여 위험은 낮음 | W1 | `NotificationCallbackProviderConfig`의 fetch에서 subject CN이 `sns.amazonaws.com`인지 확인 후 key 반환, 불일치 인증서 거부 테스트 추가 | +| B-3 | Required | dispatch의 render·profile 실패가 attempt row 전에 터져 영원히 재큐(poison pill) | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java:146-147`(`insertDispatching` `:149-159` 전, catch 없음). 제출 검증은 `.../dispatch/NotificationSubmissionService.java:115` `templates.get`뿐. render 실패 테스트 없음(`NotificationDispatchServiceTest` 메서드 2개) | W2 | `NotificationDispatchService.dispatch`에서 render/profile의 `NotificationException`을 잡아 recipient를 FAILED(`TEMPLATE_FAILURE`)로 전이 후 lease 해제; `NotificationSubmissionService`에서 변수 스키마 검증을 먼저 수행; 재현 테스트 | +| B-4a | Required | 모든 attempt가 완료된 DISPATCHING 행을 recovery가 그대로 둠 → 같은 행만 반복 선택 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/LeaseRecoveryService.java:123-139`(`completedAt` 있는 attempt는 건너뜀, 행 상태 불변), `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientDeliveryJpaRepository.java:184-190`(`ORDER BY lease_until LIMIT`). 해당 테스트 없음 | W2 | `LeaseRecoveryService.recoverOnce`에서 attempt가 전부 완료면 마지막 attempt로 retry policy를 다시 적용해 recipient 상태 확정; `LeaseRecoveryServiceTest`에 케이스 추가 | +| B-4b | Required | reconcile `Unsupported`(SMTP·SES)·`Failed`가 행을 DISPATCHING에 남김 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java:77-84`, `:126-133`(metric만 올림) | W2 | `ReconciliationService.reconcile`의 `Unsupported`·`Failed` 분기에서 recipient를 `RECONCILIATION_REQUIRED`로 전이(`inWrite`)해 recovery 대상에서 빼고 운영자에게 보이게 | +| B-5a | Required | recorder가 late-match 콜백 투영 직후 dispatch 시작 시점 snapshot으로 recipient를 덮어씀 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java:100-106`(`bindUnmatched`→`project`), `:109-135`(`recipient.deliveryOutcome()`·`evidenceLevel()` 옛 값으로 `save`). `DispatchOutcomeRecorderTest` fake는 projection 저장 no-op | W2 | 투영 뒤 recipient를 다시 읽고 recorder가 소유한 필드만 갱신; fake가 투영을 실제로 반영하는 테스트 | +| B-5b | Required | recorder의 recipient 저장이 lease fencing 없음(포트 계약 위반) | 남음 | `DispatchOutcomeRecorder.java:135` `recipients.save(updated)`; 계약 `.../dispatch/RecipientLeaseStorePort.java:14`("Every operation after the claim is fenced"); `saveHeldBy`는 `.../dispatch/RecipientDeliveryStorePort.java:35`에 이미 있음 | W2 | `record()`에 lease를 넘기고 `saveHeldBy(updated, lease)` 사용, 빈 결과면 lease 상실로 처리 | +| B-6 | Required | 알림 HTTP 응답 "상한"이 body 전체를 읽은 뒤 잘라냄 | 남음 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGateway.java:136-141`(`ofByteArray()` 후 `copyOf`), 주석 `:72-75`("끝없는 chunked 방지")는 사실과 다름. 초과 응답 테스트 없음. SNS 인증서 fetch도 이 gateway 사용(B-2d) | W1 | `boundedBody`를 `BodySubscribers.ofInputStream()`+`readNBytes(max)`(또는 상한 넘으면 구독 취소)로 교체, 초과 body 테스트 | +| B-7a | Required | admin reconcile에 tenant 검사 없음 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java:156-182`(`require(RECONCILE)`만; redrive `:105`·suppress `:210`은 `requireTenant` 호출) | W1 | attemptId마다 소유 tenant를 조회해 `authorization.requireTenant` 호출 | +| B-7b | Required | tenant 범위 actor가 전역 provider 상태를 바꿀 수 있음 | 남음 | `NotificationAdminApplicationService.java:287-289`(`require(PROVIDER_CONTROL)`만) | W1 | `setProviderState`에서 `actor.tenantId()`가 있으면 거부 | +| B-7c | Required | admin executor가 provider 호출까지 한 DB write 트랜잭션에 넣음 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutor.java:32-42`(claim+operation 한 `inWrite`) → reconcile 루프 `NotificationAdminApplicationService.java:179-182`의 provider 왕복이 한 트랜잭션 안 | W2 | executor는 claim과 결과 저장만 각각 트랜잭션으로, operation 본문(provider 호출)은 트랜잭션 밖에서 | +| B-7d | Required | tenant 거부를 항상 `SUPPRESS` 권한 부족으로 보고 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java:42-43` | W5 | `requireTenant` 거부 사유를 tenant 범위 전용 값으로(또는 호출한 연산의 authority를 인자로) | +| B-8a | Consider | caller 없는 R1 타입 약 95개 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "Notification R1 타입 96개(`NotificationPort`·`Notification`·`NotificationChannel` 제외)와 테스트 19개" 행. `git ls-files 'src/application-notification/src/main/java/dev/caskeleton/application/notification/*.java'` → 3개만 | - | - | +| B-8b | Consider | 조립 0인 Reactor facade와 `reactor-core`·`reactor-test` 의존 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "Notification Reactor facade와 `reactor-core`·`reactor-test`·`spring-web` 의존" 행. `.../notification/platform/reactor` ls-files 0건, `src/adapter/outbound/notification/build.gradle`에 reactor 0건 | - | - | +| B-8c | Consider | import 0인 `spring-web` 의존 | 해당 없음(코드 삭제) | 같은 표 행. `src/adapter/outbound/notification/build.gradle`에 `spring-web` 0건 | - | - | +| B-8d | Consider | `EmailNotifier`·`SmsNotifier`·`MobilePushNotifier`·`WebPushNotifier`·`ApplicationReceiptServiceImpl` caller 없음 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "notification platform `sms`·`push`·`email`·`webpush` facade와 `ApplicationReceiptServiceImpl`" 행. `git grep` 0건 | - | - | +| B-9a | Consider | SMTP 전송 전 실패(비 email 연락처, reveal 실패, 첨부 open 실패)가 ambiguous로 기록 | 남음 | `src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/smtp/SmtpNotificationProviderAdapter.java:86-93`(`reveal`, `IllegalArgumentException`), `:99`(`EmailAttachments.open`); `src/application-notification/.../dispatch/NotificationDispatchService.java:278-287`(그 외 `RuntimeException`→ambiguous) | W2 | `SmtpNotificationProviderAdapter.send`의 전송 전 단계 실패를 `ProviderCallNotStartedException`으로 변환 | +| B-9b | Consider | notBefore 미도달 시 `next_dispatch_at`을 NULL로 전이 → 다시 claim 안 됨 | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java:56-58`(`Blocked(READY_TO_DISPATCH)`) → `NotificationDispatchService.java:137-139`(`transition(..., Optional.empty())`); claim 조건 `src/adapter/outbound/persistence-jpa/.../notification/platform/RecipientClaimSql.java:29`(`next_dispatch_at <= :now`) | W2 | `Blocked`에 재시도 시각(`notBefore`)을 실어 `transition`에 전달 | +| B-10a | Consider | adapter README·CLAUDE.md가 구현 전체를 "R0 legacy"로 서술 | 남음 | `src/adapter/outbound/notification/README.md:1-5`, `src/adapter/outbound/notification/CLAUDE.md:18-33` | W5 | R2 platform(SES·SMTP) 기준으로 다시 쓰고 legacy는 `core/`·`email/google`·`slack/webhook` seam만으로 한정 | +| B-10b | Consider | `application-notification`에 CLAUDE.md 없음 | 남음 | `src/application-notification/`에 CLAUDE.md 없음(ls). 규칙은 `src/application-core/CLAUDE.md:78-79` 부근에 남아 있음 | W5 | `src/application-notification/CLAUDE.md` 신설, application-core의 notification 절을 옮김 | +| B-10c | Consider | CLAUDE.md의 Boot 버전 4.0.0 | 남음 | `src/adapter/outbound/notification/CLAUDE.md:8` vs `src/gradle/libs.versions.toml:84`(`4.0.8`) | W5 | 4.0.8로 고치거나 버전 문구 삭제 | +| B-10d | Consider | "inline FQN 금지" 규칙 위반 | 남음 | 규칙 `src/adapter/outbound/notification/CLAUDE.md:43`; adapter main 53줄(리뷰 당시 65), 예 `.../platform/autoconfigure/NotificationPlatformProviderConfig.java:118-119`, `.../platform/autoconfigure/NotificationHealthEndpoint.java:44` | W5 | 해당 줄을 import로 교체 | +| B-11 | Nit | 읽는 곳 없는 `contract-v1` 테스트 템플릿 4개 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "`contract-v1` 테스트 템플릿 4개" 행. `git ls-files src/adapter/outbound/notification/src/test/resources/notification/` 0건 | - | - | +| C-1a | Critical | tus `Upload-Checksum`을 chunk가 아니라 누적 digest와 비교 | 완료 | `src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/local/LocalAppendEngine.java:64-66`(chunk 전용 digest), `:128-139`; `src/adapter/inbound/web-fileserver/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/tus/TusController.java:159,166-173`(기대 checksum을 append로 전달); fake `InMemoryUploadApplicationService.java:82-83`도 chunk 단위. 테스트 `TusProtocolContractTest.chunksCarryingTheirOwnCorrectChecksumAreAllAccepted`. 커밋 `6d27356e` | - | - | +| C-1b | Critical | checksum 비교가 offset 커밋 뒤 → 불일치 chunk 저장·offset 전진 | 완료 | `LocalAppendEngine.java:74-80`(rollback 경계 안에서 검증, truncate); `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java:217-222`(append 성공 후에만 `commitOffset`). 테스트 `TusProtocolContractTest.aChunkRejectedForItsChecksumDoesNotAdvanceTheOffset`, `LocalStorageGatewayContractTest.aChunkWhoseChecksumDoesNotMatchIsRejectedAndRolledBackToItsPreAppendLength`. 커밋 `6d27356e` | - | - | +| C-1c | Critical | 불일치를 422로 응답(tus는 460) | 완료 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverErrorCode.java:47`(`CHECKSUM_MISMATCH(460)`). 테스트 `TusProtocolContractTest.aChunkWhoseChecksumDoesNotMatchAnswersChecksumMismatch`. 커밋 `6d27356e` | - | - | +| C-2a | Required | QUARANTINE 판정도 staging bytes 삭제 예약 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java:250-252`(REJECT·QUARANTINE 공통 `FAILED_VERIFICATION_CONTENT` enqueue), javadoc `:220-221`("only REJECT")과 모순 | W1 | `applyNonAcceptVerdict`에서 cleanup enqueue를 REJECT일 때만(QUARANTINE은 quarantine 영역으로 이동 또는 보존) | +| C-2b | Required | staging cleanup이 레코드 상태 재확인 없이 삭제 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java:134-146`(`isReclaimable` `:219-223`은 `cleanContent`에만 적용) | W1 | `cleanStaging`에서 fileId 레코드를 읽어 QUARANTINED면 skip | +| C-3a | Required | `reconcileRecoverable`·`RecoveryQueue`를 소비하는 곳 없음 | 남음 | bean 정의만 `src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/autoconfigure/FileserverMaintenanceServiceConfiguration.java:59-65`; main에서 `reconcileRecoverable` 호출 0(`git grep`); composition의 주기 worker는 `FileserverCleanupWorker`뿐 | W2 | `src/composition/fileserver-platform`에 `FileserverCleanupWorker`와 같은 방식으로 `reconcileRecoverable`을 주기 호출하는 worker 추가 | +| C-3b | Required | content key가 READY 커밋에만 기록 → pre-publish 복구 경로 도달 불가 | 남음 | `DefaultFinalizeUploadService.java:115`(publish) 뒤 `:303-310`(`publishAt(contentKey)`)에서만 key 저장, VERIFYING 전이 `:171-201`에는 key 없음 | W2 | `ContentKey`를 application이 정해 VERIFYING에 먼저 저장(write-ahead)한 뒤 move | +| C-3c | Required | publish의 `AmbiguousCompletionException`이 recovery queue로 안 감 | 남음 | `DefaultFinalizeUploadService.java:115`(try 없음). enqueue는 `commitReady` 실패 경로 `:318-323`뿐 | W2 | `publish` 호출을 감싸 ambiguous면 `recoveryQueue.enqueue`(`inNew`) 후 재던짐 | +| C-3d | Consider | (리뷰 외, `6d27356e` 회귀) 보상·복구용 REQUIRES_NEW 쓰기의 30초 상한 소실 | 남음 | `208077fd`의 `FileserverCompensationTransaction`(BUDGET 30s)을 `transactions.inNew`로 교체: `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java:155`, `DefaultFinalizeUploadService.java:321`; `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java:50-55`(requiresNew template timeout 미설정) | W2 | `SpringTransactionPort`의 `requiresNewTemplate`에 timeout(30s) 설정(`inNew`는 outbox·audit·보상 전용이라 공통 상한으로 충분) | +| C-4a | Required | cancel이 READY 파일에도 staging cleanup만 예약 → 게시된 bytes·quota 영구 잔존 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java:252-273`(`forStaging`만); `src/adapter/outbound/persistence-fileserver/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/repository/FileTransitionRepository.java:67-68`(`markDeleting`이 READY 허용) | W2 | UPLOADED 이후 cancel은 거부(409)하거나 `DefaultFileLifecycleService.delete`(`:71-104`)의 retire 경로 재사용 | +| C-4b | Required | staging cleanup이 DELETING→DELETED 전이를 안 함 → 취소된 upload 전부 DELETING 고착 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java:134-146`(`discardStaging`+`markDone`만) | W2 | `cleanStaging` 끝에서 레코드 DELETING→DELETED(+quota release)를 같은 트랜잭션으로 | +| C-5a | Required | 만료 upload를 치우는 sweep 없음(`EXPIRED_UPLOAD` 생산자 0) | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupType.java:10`; main에서 `EXPIRED_UPLOAD` enqueue 0(`git grep`) | W1 | cleanup worker에 `expiresAt` 지난 session을 EXPIRED로 전이하고 `EXPIRED_UPLOAD`를 예약하는 sweep 추가 | +| C-5b | Required | orphan 항목은 삭제 없이 done, orphan scan은 contentRoot만 | 남음 | `DefaultCleanupService.java:154-158`(fileId 없음→`markDone`); `src/application-fileserver/.../admin/DefaultFileserverAdminService.java:118-124`(quarantine로 옮긴 뒤 `forOrphan`); `src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/local/LocalOrphanScanAdapter.java:63,81` | W2 | orphan 항목은 quarantine 경로의 object를 실제 삭제; staging root도 scan | +| C-5c | Required | `Upload-Defer-Length: 1` 수락하지만 길이를 확정할 방법 없음 → 끝나지 않는 upload | 남음 | `src/adapter/inbound/web-fileserver/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/tus/TusRequestParser.java:64-66`; PATCH `TusController.java:153-184`는 `Upload-Length`를 읽지 않음 | W1 | 구현 전까지 `TusRequestParser.declaredLength`에서 `Upload-Defer-Length` 거부 | +| C-6 | Required | terminal 세션을 살아 있는 세션으로 취급 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java:32`(`terminal`, main 참조 0); `DefaultUploadApplicationService.java:321-329`(`requireActiveSession`), `:243-249`(`status`); `src/adapter/outbound/persistence-fileserver/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaUploadSessionStore.java:156-159`("lease held by another owner", retryable=true) | W2 | `requireActiveSession`·`status`에서 `terminal()`이면 410(또는 404) | +| C-7a | Required | append마다 prefix 전체를 다시 해시(O(n²) IO) | 남음 | `src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/local/LocalBlockingContentStore.java:386-395`(`reattach`가 매번 새 handle) → `LocalAppendEngine.java:59-62`(`rehashPrefix`) | W2 | uploadId별 상한 있는 digest 캐시(offset 키)를 store에 두고 `reattach`가 재사용 | +| C-7b | Required | finalize가 파일을 두 번 더 읽고 servlet 스레드에서 실행 | 남음 | `LocalBlockingContentStore.java:367-383`(`stagingDigest`), `.../platform/local/ContentPublishVerification.java:33`(`verifyStaged`); `TusController.java:178`(`transferExecutor` 밖) | W2 | `stagingDigest` 결과를 `verifyStaged`에 넘겨 재사용, finalize 호출을 `transferExecutor` 안으로 | +| C-8a | Required | 인가가 역할 등급만 보고 파일 owner가 없음 | 남음 | `src/adapter/outbound/fileserver/src/main/java/dev/caskeleton/adapter/outbound/fileserver/platform/security/RoleBasedFileAccessPolicy.java:51-68`(`descriptor` 미사용); `src/application-fileserver/.../api/metadata/FileDescriptor.java:10`(owner 필드 없음); 업로드는 모두 기본 namespace(`TusController.java:107`, `.../controller/FileUploadController.java:185`, `.../draft12/Draft12UploadController.java:87`) | W1 | 결정(2026-09-25): 소유자 검사 추가 — `FileRecord`에 `ownerPrincipalId`(새 migration), 기본 정책이 소유자·tenant 검사 | +| C-8b | Required | `FileOperation.FINALIZE`를 인가하지 않음 | 남음 | main에서 `FileOperation.FINALIZE` 참조 0(테스트 `RoleBasedFileAccessPolicyTest.java:66`뿐); `DefaultFinalizeUploadService.java:97-117`에 authorize 없음; `docs/fileserver/security.md:54`("Every public operation calls the injected FileAccessPolicy") | W1 | `DefaultFinalizeUploadService.finalizeUpload`에서 FINALIZE authorize(또는 enum 값 삭제+문서 정정) | +| C-8c | Required | admin 조회가 READ_METADATA 등급으로 인가 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/DefaultFileserverAdminService.java:209-211`(transport `RestrictedPathRule`로 완화됨) | W1 | admin 조회용 ADMIN 등급 operation으로 authorize | +| C-9a | Required | 업로드 동시성 한도 초과를 `QUOTA_EXCEEDED`(413, 재시도 불가)로 응답 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java:52-57`; `.../api/error/FileserverErrorCode.java:37` | W2 | scope 한도 초과도 `TRANSFER_ADMISSION_REJECTED`(429, retryable)로 | +| C-9b | Required | 모든 업로드가 기본 namespace 한 scope → 노드당 동시 업로드 4 | 남음 | `src/composition/fileserver-platform/src/main/resources/config/module-defaults/fileserver.yml:73-74`(scope 4 < instance 16); 컨트롤러 3곳 `defaultNamespace()`(C-8a 근거와 같음) | W2 | scope를 principal 기준으로(C-8a 결정과 함께) | +| C-10 / S2-#11 | Required | persistence-fileserver의 경쟁 조건 SQL에 leaf 테스트 0 | 남음 | `git ls-files src/adapter/outbound/persistence-fileserver` → `build.gradle`·lockfile·main만; 실 SQL 검증은 `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/.../readiness/PostgreSqlFileserver*IntegrationTest.java` 3개(다른 leaf)
S2-#11: `persistence-jpa/build.gradle:94-95,157-159`, jpa `postgresqlIntegrationTest/.../readiness/PostgreSqlFileserver*IntegrationTest.java` 3개 + `FileserverJpaTestContext`, `persistence-fileserver/.../JpaFileQuotaService.java:88,93` 테스트용 public, `persistence-fileserver/src`에 test 없음·README/CLAUDE.md 없음 | W4 | persistence-fileserver 자체 strict lane에 acquire-after-terminate, claim-while-leased, stale-token settlement 테스트 추가(PG 테스트 이관)
S2-#11: persistence-fileserver에 자기 IT source set(`testFixtures(project(':adapter:outbound:persistence-jpa'))` 재사용)으로 이동, 짧은 CLAUDE.md 추가 | +| C-11 | Consider | Draft-12 create가 POST body를 버리고 Content-Length를 최종 길이로 사용 | 남음 | `src/adapter/inbound/web-fileserver/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/draft12/Draft12UploadController.java:82-99`, `:171-174` | W2 | `declaredLength`를 `Upload-Length` 헤더에서 읽고, POST body가 있으면 append | +| C-12a | Nit | outbound/fileserver CLAUDE.md가 의존 2개·bootstrap 소유로 서술 | 완료 | `src/adapter/outbound/fileserver/CLAUDE.md:15-27`(modules.json SSOT 참조로 교체, bootstrap 소유 문구 삭제). 커밋 `6d27356e` | - | - | +| C-12b | Nit | composition build.gradle 주석이 HTTP는 `adapter:inbound:web`, 테이블은 `persistence-jpa`라고 서술 | 남음 | `src/composition/fileserver-platform/build.gradle:8-10`(실제 의존은 `:26` web-fileserver, `:32` persistence-fileserver) | W5 | 주석을 web-fileserver·persistence-fileserver로 | +| C-12c | Nit | (리뷰 이후 새 drift) 같은 CLAUDE.md가 "default off"·Boot 4.0.0 | 남음 | `src/adapter/outbound/fileserver/CLAUDE.md:8`, `:19` vs `src/composition/fileserver-platform/src/main/resources/config/module-defaults/fileserver.yml:22`(`enabled: ...:true`), `src/gradle/libs.versions.toml:84` | W5 | "모듈이 있으면 켜짐, false로만 끔"과 4.0.8로 | + +**조사 메모** + +- 리뷰 보정(2차 리뷰 94행): B-2의 "위조 콜백이 `SesSuppressionUpdater`로 suppression을 만든다"는 과장이다. 현재도 `SesSuppressionUpdater` 참조는 0이다(`git grep SesSuppressionUpdater` → 자기 파일뿐). 서명 우회 자체(B-2a~d)는 유효했고 고쳐졌다. 이 클래스는 dead code로 남아 있다. +- B-8·B-11은 권고 수정이 곧 삭제였으므로 `해당 없음(코드 삭제)`로 적었다. +- B-10d: FQN이 들어간 코드 일부(`LeaseRecoveryService` 등)가 application-notification으로 옮겨졌다(main 75줄, 예 `LeaseRecoveryService.java:41,104`). 그 leaf에는 CLAUDE.md가 없어 규칙이 적용되지 않는다(B-10b와 연결). +- B-2d와 B-6은 같은 gateway다. SNS 인증서 fetch도 B-6의 무제한 읽기를 거친다. +- C-8a와 C-9b는 한 결정으로 묶인다. owner/principal 모델을 정해야 scope 기준도 정해진다. + +## 1차 D Object storage · E JPA · F Mongo + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| D-1a | Required | staged `abort`가 operation 단계 확인 없이 provider `retire`(실제 삭제)부터 호출 → PUBLISHED면 삭제 후 `terminate`에서 예외, 참조·manifest는 PUBLISHED로 남음 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:257-269`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/control/ObjectOperationRecord.java:142-148`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectDataStore.java:147-155`. kernel·control은 208077fd 이후 무변경 | W1 | `abort`에서 `loadOperation`을 먼저 하고 `REFERENCE_PUBLISH_IN_PROGRESS`/`PUBLISHED`면 거부, `retire` 전에 ABORT_IN_PROGRESS를 CAS로 기록 | +| D-1b | Required | `authorizeAbort`가 stage·handoff만 보고 operation 단계를 보지 않음 → release 또는 lease 만료 후 publish 단계에서도 abort 허가 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/ObjectPublicationHandoffService.java:101-113`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/control/ObjectPublicationHandoffRecord.java:136-139` | W1 | `ObjectPublicationHandoffService.authorizeAbort`에서 operation을 읽어 `REFERENCE_PUBLISH_IN_PROGRESS` 이후면 거부 | +| D-1c | Required | `finalizePublication`이 handoff를 읽지 않고 `ObjectFinalizeRequest`에 fence·claimant가 없음 → lease 만료 후 늦은 finalize가 abort와 경쟁 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:183-237`, `src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectFinalizeRequest.java:11-17` | W1 | `ObjectFinalizeRequest`에 `handoffFence`·`claimant` 추가, finalize가 활성·일치 lease를 요구. sample `ReconcilePosterImageUploadUseCase.java:105-112` 호출부 갱신 | +| D-2a | Required | 이미 release된 handoff에 `release` 재호출 시 "owner/fence is stale" 예외 → sample reconcile이 terminal READY마다 `releaseClaim`을 불러 두 번째 reconcile이 항상 실패 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/control/ObjectPublicationHandoffRecord.java:119-120,165-171`, `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ReconcilePosterImageUploadUseCase.java:96-97,122-137` | W2 | `ObjectPublicationHandoffRecord.release`: 같은 fence·claimant로 이미 released면 쓰기 없이 REPLAYED, `releaseClaim`이 그 결과를 반환 | +| D-2b | Required | `authorizeAbort` 재호출이 idempotent하지 않음: 첫 호출이 `released=false`로 되돌려 lease가 남아 있으면 예외, 지났으면 새 revision을 쓰고 항상 APPLIED | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/control/ObjectPublicationHandoffRecord.java:136-152`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/ObjectPublicationHandoffService.java:101-113` | W2 | 이미 `abortAuthorized`이고 fence가 같으면 쓰기 없이 REPLAYED | +| D-2c | Required | 두 번째 staged `abort`는 `retire`=false로 "could not be retired" 예외 → sample `AbortPosterImageUploadUseCase`(IDEMPOTENT 표시)가 ABORT_AUTHORIZED에서 재호출하면 영구 정지 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:257-266`, `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/AbortPosterImageUploadUseCase.java:28,73-75,91-92` | W2 | `abort` 첫 단계에서 operation이 이미 ABORTED면 provider 호출 전 REPLAYED 반환(`DirectMultipartCoordinator.java:322-334` 방식) | +| D-3a | Required | stage: operation을 DATA_UPLOADED로 먼저 올리고 stage 기록은 나중 → 사이 crash 후 재시도가 "not uploadable", 데이터 고아·abort 불가 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:91-92,123-139` | W2 | operation 레코드를 단일 기준으로: 재시도에서 DATA_UPLOADED면 stage 기록을 create-or-require-same으로 보충하고 APPLIED/REPLAYED 반환 | +| D-3b | Required | verifyIntegrity: stage CAS 후 operation 전진 → 사이 crash 후 재시도는 REPLAYED로 끝나고 finalize가 "not finalizable" | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:156-171,206-207` | W2 | `integrityVerified` REPLAYED 경로에서 operation이 INTEGRITY_VERIFIED(SCAN_CLEAN이면 SCAN_PENDING) 미만이면 전진을 마저 수행 | +| D-3c | Required | finalize: REFERENCE_PUBLISH_IN_PROGRESS로 올린 뒤 crash하면 모든 재시도가 "not finalizable" | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:200-225` | W2 | `REFERENCE_PUBLISH_IN_PROGRESS`도 받아 idempotent `references.publish`를 다시 실행하고 PUBLISHED로 전진 | +| D-3d | Required | scan verdict: stage CAS 후 operation 전진(같은 순서), 재시도는 verdict가 같아 REPLAYED로 끝나 전진 누락 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectScanMaintenanceAdapter.java:82-110` | W2 | REPLAYED여도 operation이 SCAN_PENDING이면 SCAN_CLEAN/QUARANTINED 전이를 마저 수행 | +| D-4 | Required | staged kernel·handoff 서비스에 동작 테스트 없음 | 남음 | `src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernelTest.java:11-23`(`ObjectScanVerdictPolicy`만), `src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/ObjectPublicationHandoffRaceTest.java:23-24`(takeover 1건), `src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/objectstorage/ObjectStorageCompositionIntegrationTest.java:71-86`(legacy put/get), `src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/poster/PosterImagePublicationWorkflowTest.java:85-86`(포트 mock) | W4 | local-dev provider로 stage→verify→finalize→release, abort·replay 전 흐름 테스트 + `ObjectControlStore` 래퍼로 두 쓰기 사이 실패 주입(D-1~D-3 회귀 테스트 겸용) | +| D-5 / X1-#8b | Consider | local control store `create`가 `CREATE_NEW` 후 쓰기 → 동시 reserve가 빈/부분 파일을 decode 실패, 쓰기 중 crash면 키 영구 손상 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectControlStore.java:51-65`
X1-#8b: `objectstorage/.../filesystem/LocalDevObjectControlStore.java:51-65`(비교 대상이던 `LocalPublicationJournal`은 삭제) | W2 | temp 파일에 쓰고 `force` 후 `Files.createLink`로 게시(`LocalDevObjectDataStore.java:55-62`와 같은 방식)
X1-#8b: temp 파일에 다 쓰고 `force` 후 원자적으로 게시해 부분 파일이 보이지 않게 + 동시 create 테스트 | +| D-6a | Consider | legacy filesystem adapter `get`이 크기 제한 없이 `Files.readAllBytes` (L3 closure 기록과 코드 불일치) | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/FilesystemObjectStorageAdapter.java:71` | W1 | 읽기 전 `Files.size`를 설정 최대값과 비교해 초과 시 거부 | +| D-6b | Consider | legacy `put`이 `target.toUri()`(서버 절대 경로 `file:///…`)를 반환 → sample이 HTTP 응답 `location`에 노출, sample 기본 설정이 이 backend | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/FilesystemObjectStorageAdapter.java:61`, `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/PosterWebMapper.java:35`, `src/sample-portfolio/src/main/resources/application.yml:321-326` | W1 | `FilesystemObjectStorageAdapter.put`이 논리 URI(`objectstorage:` + key)를 반환 | +| D-7a | Consider | direct/multipart 코드 약 3.2k줄이 main 호출자 0(`DirectTransferCoordinator`, `DirectMultipartCoordinator`, `ManagedMultipartCoordinator`, `MultipartOperationResolver`, `S3ObjectOperationResolver`, `ObjectOperationResolutionService`, `ObjectOperationEpochRecord`, `SelectedObjectStorageProviderFactory.{managedMultipart,directTransfer,directMultipart}Provider`, 포트 `DirectObjectUploadPort`·`DirectObjectDownloadGrantPort`·`DirectMultipartUploadPort`) | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/{direct,multipart}/`(2,053줄) + S3 direct/multipart 타입(1,160줄), main 참조 0·테스트만(`src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ProviderCompositionTest.java:132,140`). `docs/capability-status.md` 「제거된 코드」 표에 없음 | W3 | D1 규칙(호출자 0 삭제)대로 `direct/`·`multipart/`·S3 direct/multipart provider·`Direct*Port`를 삭제하고 제거 표에 기록 | +| D-7b | Consider | 빈 자리 타입: `RoutingObjectDirectGrantAdapter`(참조 0), 빈 `@Configuration` `ObjectStorageMaintenanceCapabilityConfig` | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectDirectGrantAdapter.java:1-10`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageMaintenanceCapabilityConfig.java:10`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/ObjectStorageAutoConfiguration.java:25` | W3 | 두 타입 삭제, `ObjectStorageAutoConfiguration` import 목록에서 제거 | +| D-7c | Consider | 구현 없는 포트 `ObjectPurgeMaintenancePort` | 남음 | `src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPurgeMaintenancePort.java` (main 구현 0, 테스트 참조만) | W3 | 포트 삭제 | +| D-7d | Consider | S3 contribution이 쓰이지 않는 `S3ManagedMultipartProvider`(항상)와 presigner·direct provider(capability SUPPORTED일 때)를 생성 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ObjectStorageProviderContribution.java:110-158` | W3 | D-7a 삭제와 함께 `SelectedObjectStorageProviderFactory` 인자·생성 코드 제거 | +| D-7e | Consider | S3 자격 증명을 `System::getenv`로 해석(`SecretSourcePort` 미사용, httpclient H6와 같은 패턴) | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ObjectStorageProviderContribution.java:41` | W3 | `ObjectStorageCapabilityConfig`의 S3 contribution bean이 `SecretSourcePort`(`src/application-core/src/main/java/dev/caskeleton/application/outbound/SecretSourcePort.java`)를 받아 `S3ProviderBinding.SecretResolver`로 넘김 | +| D-8a | Consider | managed 경로의 참조 게시(`persistPublishedReference`/`createOrRequireSame`)가 `ObjectReferencePublicationService`와 중복 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectMutationAdapter.java:354-421`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/ObjectReferencePublicationService.java:20-92` | W3 | `RoutingObjectMutationAdapter`가 `ObjectReferencePublicationService.publish`를 호출하고 사본 삭제 | +| D-8b | Consider | `objectId`/`sha256Hex` 계산 중복 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectMutationAdapter.java:469-500`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/kernel/StagedObjectPublicationKernel.java:389-415` | W3 | `codec` 패키지에 identity helper 하나로 합치고 두 곳이 호출 | +| D-8c | Consider | route token 파싱 `split("\\.")[1]`이 두 곳에 복사 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectMutationAdapter.java:504`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectReadAdapter.java:103` | W3 | `ObjectReferenceCodec.routeToken(..)` 추가 후 두 곳 교체 | +| D-8d | Consider | `clock`을 주입받고도 `Instant.now()`를 12번 호출 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectMutationAdapter.java:60,70`(clock), `:128,152,192,201,212,223,229,283,311,329,341,349`(`Instant.now()`) | W3 | `Instant.now()`를 `clock.instant()`로 교체 | +| D-9 | Consider | `inspect`가 scan 상태를 항상 NOT_REQUIRED로 보고(SCAN_CLEAN destination 포함) | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/RoutingObjectReadAdapter.java:53` | W2 | destination `policySnapshot().publicationRequirement()`가 SCAN_CLEAN이면 CLEAN으로 보고 | +| D-10 | Nit | capability close가 역순이 아님(`Map.copyOf`는 순서 없음), 하나가 던지면 나머지 close를 건너뜀 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageCapabilityAssembler.java:74,111-118` | W2 | provider를 생성 순서 `List`로 보관, 역순 close를 try/catch + `addSuppressed`로 | +| D-11a | Nit | leaf CLAUDE.md 허용 의존에서 `application-objectstorage` 누락 | 남음 | `src/adapter/outbound/objectstorage/CLAUDE.md:30` (registry: `application-core`, `shared-contract`, `application-objectstorage`) | W5 | 의존 나열을 지우고 registry 참조 한 줄만 남김 | +| D-11b | Nit | CLAUDE.md가 object storage 포트·타입 위치를 `application-core`로 적음 | 남음 | `src/adapter/outbound/objectstorage/CLAUDE.md:17,40` | W5 | `application-objectstorage`로 수정. 같은 절 `:19` "disabled-by-default"도 현재 동작(`ObjectStorageCapabilityConfig`의 `matchIfMissing = true`, 있으면 켜짐)으로 | +| D-11c | Nit | CLAUDE.md 기준 버전이 Boot 4.0.0(실제 4.0.8) | 남음 | `src/adapter/outbound/objectstorage/CLAUDE.md:8` | W5 | 버전 문구 삭제 또는 4.0.8 | +| D-11d | Nit | README가 local-dev 거부 프로필을 `prod`/`production`으로 적음(코드는 `prod`만) | 남음 | `src/adapter/outbound/objectstorage/README.md:60`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageBindingCompiler.java:284`(`RuntimeEnvironment.isProductionActive`) | W5 | README를 `prod`로 수정 | +| D-11e | Nit | `.tmp` 고아를 "report-first reconciliation"이 처리한다는 주석, 해당 코드 없음 | 남음 | `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectDataStore.java:81`, `src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectControlStore.java:100` | W5 | 주석을 "정리 코드 없음, 수동 삭제"로 고침 | +| E-1a | Critical | V9를 적용 후 주석 수정 → 기존 DB checksum mismatch | 완료 | V9 현재 바이트 = `944a1e34`(`git diff 944a1e34 HEAD -- …/V9__widen_capability_schema_stream.sql` 출력 없음), `src/adapter/outbound/persistence-jpa/src/test/resources/db/applied-migrations.sha256:31`, 커밋 6d27356e | - | - | +| E-1b | Critical | V13을 적용 후 `char→varchar`, `NOT VALID` 수정 | 완료 | V13 현재 바이트 = `60b6a319`(diff 없음), 타입 변경은 새 버전 `src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V16__outbox_canonical_hash_columns_varchar.sql:8-13`, manifest `:21,24`, 커밋 6d27356e | - | - | +| E-1c | Critical | outbox-storage `V1__initialize_or_adopt.sql` 적용 후 수정 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "outbox V2 migration stream `jpa/outbox-storage`(V1·V2) … `applied-migrations.sha256`의 해당 4줄"(D2). `git ls-files '…/db/migration/jpa/outbox*'` 0건 | - | - | +| E-1d | Critical | 적용된 migration 해시 고정 테스트 부재 | 완료 | `src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/AppliedMigrationImmutabilityTest.java:29`(`appliedMigrationsKeepTheBytesTheyWereAppliedWith`), `:43`(`everyVersionedMigrationIsPinned`), 커밋 6d27356e | - | - | +| E-2a | Critical | 같은 요청 재제출이 unique 위반 후 같은 트랜잭션 재조회 → PostgreSQL 25P02 | 완료 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapter.java:43-70`(`submitIfAbsent` 후 조회), `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationJpaRepository.java:39-59`(`ON CONFLICT … DO NOTHING`), 테스트 `DurableOperationStoreAdapterContractTest`(postgresqlIntegrationTest) ← `DurableOperationStoreContract.identicalResubmissionInsideOneTransactionReturnsTheFirstOperation`, 커밋 6d27356e | - | - | +| E-2b | Required | (알려진 남은 문제) 같은 operationId 재시도 시 outbox 중복 append: `alreadyAccepted`를 operationId 불일치로만 판단 → 같은 id 재시도는 새 제출로 보고 `outbox.append` 재실행. `OutboxEventEntity`에 `Persistable`/`@Version`이 없어 `repository.save`가 merge로 기존 행을 PENDING·attempt 0으로 덮거나(reaper가 지웠으면 새 행) 재발행 | 남음 | `src/application-core/src/main/java/dev/caskeleton/application/operation/SubmitDurableOperationUseCase.java:99-116`, `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java:57-71`. merge 동작은 Spring Data `isNew` 규칙 기준 판단(실행 미확인) | W2 | `DurableOperationStorePort.submit`이 생성/재사용 여부를 돌려주게 하고(`submitIfAbsent` 영향 행 수 1/0) 그 값으로 append 여부 결정. `DurableOperationStoreContract`에 같은 id 재시도 케이스 추가 | +| E-3a | Required | `CanonicalOutboxAppendAdapter.append`에 caller 트랜잭션 확인 없음 → 트랜잭션 밖 호출 시 조용한 dual-write | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/CanonicalOutboxAppendAdapter.java:37` (형제 `OutboxStoreAdapter.java:58`에는 있음) | W2 | `append` 첫 줄에 caller 트랜잭션 guard 추가 | +| E-3b | Required | caller 트랜잭션 guard가 세 클래스에 복사됨 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java:130-135`, `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapter.java:169-174`, `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapter.java:163-168` | W3 | `persistence/transaction` 패키지에 공용 helper 하나를 두고 세 곳 + E-3a가 호출 | +| E-3c | Required | ownership 테스트가 canonical append adapter를 검사하지 않음 | 남음 | `src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/PersistenceTransactionOwnershipTest.java:25-47`(DurableOperation·LiveEvent만) | W4 | `PersistenceTransactionOwnershipTest`에 `CanonicalOutboxAppendAdapter`의 트랜잭션 없는 호출 거부 케이스 추가 | +| E-4a | Required | `markAllRead` 서브쿼리가 `read_at IS NULL`만 보고 state를 거르지 않음 → 읽지 않고 보관한 ARCHIVED 항목이 READ로 되살아남 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/InboxItemJpaRepository.java:83-104` | W2 | 서브쿼리에 `AND state NOT IN ('ARCHIVED','EXPIRED','DELETED')` 추가 | +| E-4b | Required | 엔티티 `markRead`/`markSeen`이 ARCHIVED·terminal 상태를 막지 않음 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/InboxItemEntity.java:107-127` | W2 | `markSeen`/`markRead`에서 `archivedAt != null`·terminal이면 false 반환 | +| E-4c | Required | inbox 통합 테스트가 운영 쿼리를 복사한 SQL 문자열을 실행하고 enum에 없는 `'UNREAD'`를 씀. `JpaNotificationInbox`/`InboxItemJpaRepository` 실행 테스트 없음 | 남음 | `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlInboxCutoffIntegrationTest.java:86-104,117` | W4 | 테스트가 실제 `InboxItemJpaRepository.markAllRead`를 호출하고 ARCHIVED 항목 유지 케이스 추가 | +| E-5a | Required | FIFO gate가 `occurred_at <`만 봐서 같은 `occurred_at` 이벤트는 함께 claim, 순서 미정 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlOutboxClaimRepository.java:15-29`(H2 `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2OutboxClaimRepository.java`도 같은 SQL), 특성화 테스트 `PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.equalTimestampRowsAreClaimedTogetherLegacyFifoLimitationCharacterization` | W2 | canonical row(`contract_id IS NOT NULL`)는 `(aggregate_sequence, event_index)`로 head 판정·정렬. 인덱스는 새 migration `V18`로 추가(+ `applied-migrations.sha256`) | +| E-5b | Required | gate가 `tenant_scope`·`aggregate_type`을 안 봐 다른 tenant/type의 같은 `aggregate_id` DEAD row가 서로 영구 차단 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlOutboxClaimRepository.java:20-25` | W2 | canonical row의 gate 키를 `(tenant_scope, aggregate_type, aggregate_id)`로(E-5a와 같은 SQL 변경, PostgreSQL·H2 두 곳) | +| E-5c | Required | README가 "한 배치에 aggregate 당 최대 한 row"라고 적음(같은 `occurred_at`이면 거짓) | 남음 | `src/adapter/outbound/persistence-jpa/README.md:248-249` | W5 | E-5a 수정 후 README를 실제 보장에 맞춤 | +| E-6a | Required | H10 tenant 규칙이 필드 이름 `tenantId`로만 판정("Structural" Javadoc과 반대) → `tenant`, `tenantScope` 엔티티 누락 | 남음 | `src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/TenantScopedRepositoryPredicate.java:12-19,49` | W4 | `tenant*` 필드 전부(또는 marker annotation)로 판정 | +| E-6b | Required | tenant 컬럼을 가진 세 리포지토리가 `JpaRepository`를 상속해 범위 없는 `findAll`/`deleteAll` 노출 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationJpaRepository.java:25-26`, `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyRecordJpaRepository.java:12-13`, `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxEventJpaRepository.java:16` | W3 | 세 리포지토리를 `Repository` marker + 쓰는 메서드만 선언으로 축소 | +| E-7 | Consider | 잘못된 canonical row 하나가 `claimBatch` 매핑에서 예외 → claim 트랜잭션 전체 롤백 → 매 주기 같은 row 재선택으로 relay 정지 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java:79-94,161-193` | W2 | 매핑 실패 row는 DEAD로 전이하고 배치의 나머지는 계속 | +| E-8a | Consider | outbox 지표 쿼리가 매 poll(PT5S)마다 테이블 전체를 status별로 셈(7일치 PUBLISHED 포함) | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxEventJpaRepository.java:54-56`, 호출 `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxMetrics.java:89` ← `OutboxRelayScheduler.java:36,49` | W2 | `countGroupedByStatus`에 `where e.status <> 'PUBLISHED'` | +| E-8b | Consider | `OutboxReaper`가 PUBLISHED 삭제를 한도 없는 단일 트랜잭션 DELETE로 실행 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxEventJpaRepository.java:21-23`, `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaper.java:40-42` | W2 | native `DELETE … WHERE ctid IN (SELECT … LIMIT n)`를 0건 될 때까지 배치별 트랜잭션으로 반복 | +| E-9 | Consider | `JpaObservabilityAutoConfiguration` 미사용 코드 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "JPA 두 번째 트랜잭션·재시도 엔진 19종 … `JpaObservabilityAutoConfiguration`". `git grep JpaObservabilityAutoConfiguration -- src` 0건 | - | - | +| E-10a | Consider | experimental tenant guard의 "audited" admin scope가 reason을 ThreadLocal에만 두고 기록하지 않음 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/experimental/tenant/TenantAwareRepositoryGuard.java:14-15,36-53` (production 호출자 0, 테스트만) | W1 | 생성자에 audit sink(`Consumer` 등)를 받아 scope 열 때 기록, 또는 "audited" 문구 삭제 | +| E-10b | Consider | public 생성자라 experimental 진입 게이트(`enabledBy`) 목록에서 빠짐 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "`backend.jpa.experimental.*` 플래그 8개(`ExperimentalFeature`, `ExperimentalFeatureGate`, … `enabledBy(..)` 팩토리)와 `ExperimentalEntryConsentTest`" — 게이트 자체 삭제, 진입점은 public 생성자가 정본 | - | - | +| E-10c | Consider | `releaseConnection`이 search_path reset 실패 시에도 tenant schema가 걸린 커넥션을 pool에 반환 | 남음 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/experimental/schema/SchemaMultiTenantConnectionProvider.java:50-57` | W1 | reset 실패 시 `connection.abort(Runnable::run)`(또는 unwrap 후 evict)로 pool 복귀를 막고 예외 전파 | +| E-11 / X1-#7d | 권고 | readiness card 외부 prerequisite가 없는 card(`messaging-cdc-dispatch.v1`)를 가리킴 | 해당 없음(코드 삭제) | 가리키던 card `jpa-outbox-cdc-retention-v1`이 「제거된 코드」 표 "readiness card `jpa-outbox-storage-v2`, `jpa-outbox-polling-delivery-v2`, `jpa-outbox-cdc-retention-v1`"로 삭제. `src/config/jpa/readiness-cards.yaml`에 `messaging`/`external` 0건
X1-#7d: 해당 카드 `jpa-outbox-cdc-retention-v1` 삭제(`docs/capability-status.md:179`), `grep messaging-cdc-dispatch src/config` → 0 | - | - | +| E-12 | Nit | JPA CLAUDE.md 벤더 SQLState 표에 `55P03 → DB_LOCK_TIMEOUT` 누락 | 남음 | `src/adapter/outbound/persistence-jpa/CLAUDE.md:264-270` vs `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMapping.java:16` | W5 | 표에 `55P03` 행 추가 | +| F-1a | Required | `PolicyAwareMongoQueryBuilder.whereEquals`(및 `whereAtLeast`/`whereBefore`)가 `Object` 값을 그대로 `Criteria.is/gte/lt`에 넣음 → `Map`/`Document`(`{"$ne":null}`)가 연산자로 해석돼 operator allowlist·regex 정책 우회 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/query/PolicyAwareMongoQueryBuilder.java:43-61` | W1 | 공용 `requireScalar(value)`(Map/Bson/Document 거부, EQ는 Collection도 거부)를 만들어 builder에서 호출 + `Map.of("$ne", …)` 회귀 테스트 | +| F-1b | Required | `AtomicFilter.id`/`andEquals`/`toQuery`가 값 타입 검사 없이 `.is(value)` → `AtomicFilter.id(Map.of("$gt",""))`로 단일 문서 보장 붕괴 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/AtomicFilter.java:38-53,66-74` | W1 | compact constructor에서 모든 값에 F-1a의 `requireScalar` 적용 | +| F-1c | Required | Javadoc이 operator injection을 "compile-time impossibility"라고 주장 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/query/PolicyAwareMongoQueryBuilder.java:16-19` | W5 | F-1a 후 "런타임 스칼라 검사로 막는다"로 수정 | +| F-1d | Required | security lane이 "injection" 검증을 표방하지만 injection 케이스 없음 | 남음 | `src/adapter/outbound/persistence-mongo/build.gradle:183`, `src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/security/MongoSecurityIntegrationLaneTest.java`(`$ne`/`$gt`/inject 0건) | W4 | lane에 operator-document 값 거부 케이스 추가 또는 설명에서 "injection" 삭제 | +| F-2a | Required | 여러 profile일 때 startup validator가 `active-profile`을 무시하고 모든 profile의 topology를 관측값과 비교 → REPLICA_SET+STANDALONE 조합이면 기동 항상 실패 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoStartupValidator.java:65-88`, `active-profile`은 `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfiguration.java:53-54`에서 raw `getProperty`로만 읽음 | W2 | `activeProfile`을 `MongoPlatformSettings`에 한 번 바인딩하고 validator는 그 profile만 검사 + 두 profile 테스트 | +| F-2b | Required | health가 `anyMatch(profile.topology() != observed)` → 다른 profile 때문에 readiness 영구 DOWN | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthIndicator.java:57-58,86-89` | W2 | F-2a의 바인딩된 active profile 하나만 비교 | +| F-3a | Required | change-stream pipeline이 같은 `clusterTime` 트랜잭션 이벤트를 버림 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "Mongo change stream(`changestream/**`)과 change-stream→messaging bridge(`advanced/bridge/`)". `git ls-files` 에 `changestream` 0건 | - | - | +| F-3b | Required | consumer가 `fullDocument`만 넘겨 delete 이벤트가 `{}` | 해당 없음(코드 삭제) | 위와 같은 행(`ReactiveMongoChangeStreamConsumer` 삭제) | - | - | +| F-3c | Required | BUSY/PARKED 뒤 다음 이벤트 checkpoint가 건너뛴 이벤트를 넘김 | 해당 없음(코드 삭제) | 위와 같은 행(`MongoChangeStreamRunner` 삭제) | - | - | +| F-3d | Required | `MongoResumeCheckpoint.belongsTo()` 호출자 없음, cluster 검사 미실행 | 해당 없음(코드 삭제) | 위와 같은 행. 남은 `MongoResumeException`·`MongoTopologyRequirement.changeStreams()`는 어휘만 남은 것으로 이 결함과 무관 | - | - | +| F-4a | Required | bulk 경로가 raw `getQueryObject()`/`getUpdateObject()`로 `UpdateOneModel`을 만들어 `@Field` 이름·custom conversion 미적용(atomic 경로는 `operations.updateFirst(…, documentType, …)`) | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/bulk/MongoBulkExecutor.java:76-78`, 비교 `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplate.java:139` | W2 | `documentType`을 받아 `QueryMapper`/`UpdateMapper`로 매핑(또는 `MongoOperations.bulkOps(…)` 사용) + `@Field`·비String 값 테스트 | +| F-4b | Required | bulk 크기 추정이 매핑 전 `toJson()`을 호출해 codec 없는 값(`DomainDocumentId`, `BigInteger`)에서 실패 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/bulk/MongoBulkWritePlan.java:68-69` | W2 | F-4a의 매핑 결과로 크기 추정 | +| F-5a | Required | CSFLE `schemaMap` 키가 `db.coll`이 아니라 bare collection → 드라이버가 매칭하지 못해 자동 암호화 안 됨 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/advanced/encryption/csfle/MongoCsfleClientFactory.java:40-41` | W1 | namespace(`database.collection`)로 키 지정 | +| F-5b | Required | `profile.fields()`를 읽지 않고 호출자가 준 JSON을 그대로 schema로 씀 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/advanced/encryption/csfle/MongoCsfleClientFactory.java:32-47`, `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/advanced/encryption/csfle/MongoCsfleProfile.java:18-22` | W1 | `fields()`로 schema를 생성하고 `encryptedFieldsMapJson` 인자 제거 | +| F-5c | Required | `keyVaultCredential`을 `keyVaultMongoClientSettings`로 넘기지 않음(프로필 Javadoc의 별도 자격 증명 약속 위반) | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/advanced/encryption/csfle/MongoCsfleClientFactory.java:43-47`, `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/advanced/encryption/csfle/MongoCsfleProfile.java:11-12,21` | W1 | 별도 credential로 `keyVaultMongoClientSettings` 설정 | +| F-5d | Required | CSFLE factory에 테스트·호출자 없음(README가 "테스트 없는 진입점"으로 명시) | 남음 | `src/adapter/outbound/persistence-mongo/README.md:159-162` | W4 | 생성된 `AutoEncryptionSettings`(namespace 키, schema, key-vault 설정) 단위 테스트 추가 | +| F-6 | Required | 공유 컬렉션 tenancy 강제 지점(`TenantScopedMongoOperations`) 구현·호출자 없음, 문서는 강제된다고 약속 | 완료 | 인터페이스 삭제(「제거된 코드」 표 "`MongoDataKeyResolver`, `MongoTenantDatabaseResolver`, `TenantScopedMongoOperations`"), 문서를 "adopter repository가 injector를 모든 경로에서 호출, facade 없음"으로 수정(`docs/mongodb/advanced/multi-tenancy.md:15-17`), 커밋 6d27356e | - | - | +| F-7 | Consider | reactive cursor가 row마다 두 번 직렬화 | 해당 없음(코드 삭제) | 「제거된 코드」 표 "Mongo reactive 경로(`reactive/**` …)". `MongoReactiveCursorPublisher` 0건 | - | - | +| F-8 | Consider | migration lock이 모든 쓰기 오류를 "경쟁에서 짐"으로 삼킴 | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/migration/MongoCollectionMigrationLock.java:112-114` | W2 | `lostTheRace.getError().getCode() == 11000`일 때만 `Optional.empty()`, 그 외 재던짐 | +| F-9a | Nit | `MongoPlatformAutoConfiguration`에 inline FQN 약 38줄(leaf CLAUDE.md 금지 규칙 위반) | 남음 | `src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformAutoConfiguration.java:41,65,72,132-134` 외, 규칙 `src/adapter/outbound/persistence-mongo/CLAUDE.md:69` | W5 | FQN을 import로 교체 | +| F-9b | Nit | 고아 Javadoc(`:192-198`) | 해당 없음(코드 삭제) | 고아 Javadoc이 있던 `ReactiveExecution` 블록이 reactive 경로와 함께 삭제(「제거된 코드」 표 reactive 행). 현재 파일에 연속·고아 Javadoc 0건 | - | - | +| F-9c | Nit | CLAUDE.md가 조립 방식을 `implementation(project(...))`로 적음(실제 `runtimeOnly`) | 완료 | `src/adapter/outbound/persistence-mongo/CLAUDE.md:52-53`(`runtimeOnly project(':adapter:outbound:persistence-mongo')`), `src/app-bootstrap/build.gradle:146`, 커밋 6d27356e | - | - | +| F-9d | Nit | CLAUDE.md 깨진 문장(":53 runtime SSOT; runtime classpath…") | 완료 | 해당 문단 재작성, 현재 `src/adapter/outbound/persistence-mongo/CLAUDE.md:52-57` 정상 문장, 커밋 6d27356e | - | - | + +**조사 메모** + +- E-2b는 오케스트레이터가 준 알려진 남은 문제(durable operation 같은 operationId 재시도 → outbox 중복 append)와 같다. E-2(25P02)는 고쳐졌고, 그 옆의 use case 판정(`SubmitDurableOperationUseCase.java:100`)이 남은 원인이다. +- `S3AsyncResponseBodyBridgeTest` 부하 시 간헐 실패(알려진 문제)는 Group D 리뷰 항목 중 대응하는 행이 없다. 별도로 추적해야 한다. +- 리뷰 문구 정정 D-2b: 리뷰는 "`authorizeAbort`가 released이고 lease가 남아 있으면 예외"라고 썼으나 코드 조건은 `!released && leaseExpiresAt.isAfter(now)`(`ObjectPublicationHandoffRecord.java:137`)다. 첫 호출이 `released=false`로 되돌리기 때문에 재호출이 예외가 나는 것이고, 결론(재호출이 idempotent하지 않음)은 맞다. +- 리뷰 전제 과함 E-1c: 리뷰는 outbox-storage V1도 "적용된 DB가 기동 실패"라고 했으나, 「제거된 코드」 표는 `jpa/outbox-storage` stream을 "어떤 composition도 Flyway location으로 설정한 적 없음"으로 기록했다. 실제 영향은 V9·V13 두 개였다. +- E-5 반론("V2 polling 경로는 이미 해결")은 D2로 V2가 삭제되어 더 이상 성립하지 않는다. canonical 이벤트는 이제 v1 claim(E-5a/b)만 탄다. +- D-7a는 D1(호출자 0 삭제) 적용 대상으로 봤다. 소유자가 S3 direct/multipart를 capability 기능으로 조립할 생각이면 이 행은 결정 필요로 바뀐다(조립 vs 삭제). + +## 1차 G Redis · H HTTP client/messaging bridge + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| G-1a | Critical | SCRIPT lane 한도(기본 8)가 연결 수가 아니라 동시 lease 수라 정상 Redis에서도 9번째 동시 호출부터 거부 | 완료 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeOwner.java:145-166`(lane별 fair `Semaphore`, `acquireTimeout`까지 대기 후 거부), `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java:234,241`. 테스트 `RedisScriptLaneAdmissionTest.callersBeyondTheScriptLaneLimitWaitForAReturnedConnectionInsteadOfBeingRefused`, `aCallerStillWaitingWhenTheAcquireTimeoutRunsOutIsRefusedAsNotSent`. 커밋 `6d27356e` | - | - | +| G-1b | Critical | Redis에 보내지 않은 lane 거부(`RedisCommandRejectedException`, not-sent)를 idempotency·lease adapter가 `Indeterminate`로 보고 | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/idempotency/RedisIdempotencyStoreAdapter.java:129-131`(외 243-248, 299-304, 331-336, 474-479), `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/lease/RedisDistributedLeaseAdapter.java:167-172`(외 225-227, 341-346, 372-375). `LeaseAcquireOutcome.Unavailable`·`IdempotencyClaimOutcome.Unavailable`는 있지만 쓰지 않음 | W2 | 두 adapter에 `RedisEdgeRateLimitAdapter.java:123-132`과 같은 `catch (RedisOperationException)` + `metadata().ambiguousExecution()` 분기를 넣어 not-sent는 `Unavailable`로 반환하고, 포화된 owner로 거부를 재현하는 테스트 추가 | +| G-1c | Critical | `redisRequired` health probe가 업무와 같은 REGULAR lane에서 lease를 빌려, lane 포화가 `acquireTimeout`을 넘으면 Redis 정상이어도 DOWN | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java:51,61-64`(borrow 거부도 `unreachable`). 대기 후 거부로 바뀌어 순간 포화는 완화됨 | W2 | `RedisHealthContributor.probe()`에서 borrow 거부(`RedisCommandRejectedException`)를 `unreachable`이 아닌 `saturated`(UP 유지)로 분리하거나 lane 한도 밖 전용 probe 연결 사용 | +| G-2a | Required | fixed-window/sliding-counter hash가 `windowStart-2w` 필드 하나만 지우고 매 허용마다 `PEXPIRE` 갱신 → 필드·key 무한 증가(M4 회귀) | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/ratelimit/RateLimitScripts.java:57-59,88-90`. 주석 `:39-40`("refreshed per hit이 아니다")은 여전히 코드와 반대 | W2 | `FIXED_WINDOW`는 `start`/`count` 두 필드 덮어쓰기, `SLIDING_COUNTER`는 `start`/`cur`/`prev` 회전으로 바꾸고 `:39-40` 주석 수정 | +| G-2b | Required | in-memory fake가 rate-limit 스크립트의 `HDEL`/`PEXPIRE`를 흉내내지 않아 hash 증가가 테스트되지 않음 | 남음 | `src/adapter/outbound/redis-runtime/src/testFixtures/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/InMemoryRedisCommandGateway.java:1717-1753`(필드 put만). cache-redis 테스트에 HLEN 단언 0건 | W4 | fake `fixedWindow`/`slidingCounter`를 G-2a의 새 필드 모델에 맞추고, `LiveRedisSemanticPortsTest`에 여러 window 뒤 HLEN ≤ 3 단언 추가 | +| G-3a | Required | lease replay(status 2)가 서버 잔여 `PTTL`을 버리고 재시도 시점부터 전체 TTL을 다시 부여 | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/lease/RedisDistributedLeaseAdapter.java:157-161` → `handle()` `:231-239`가 `localValidityOf(request.leaseTtl())` 사용 (`inspect()` `:213`만 `observedValidityOf`) | W2 | status 2 분기에서 `observedValidityOf(reply.remainingMillis())`로 handle 생성 | +| G-3b | Required | TTL ≤ drift 검사가 Redis 호출 뒤에 있어, 서버는 lease를 잡았는데 IAE가 catch돼 `Indeterminate` 반환 | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/lease/RedisDistributedLeaseAdapter.java:114-127`(검사), `:145-156`(먼저 스크립트 실행), `:167-172`(IAE를 `Exception`으로 잡음) | W2 | `tryAcquire`·`renew`에서 `localValidityOf(leaseTtl)`을 `owner.borrow` 전에 호출 | +| G-4a | Required | `capacity.maximum-in-flight-bytes`·`capacity.maximum-reply-bytes`가 바인딩만 되고 적용 안 됨 | 해당 없음(코드 삭제) | `docs/capability-status.md` 「제거된 코드」 `app.redis.limits.*`… 행(174). `RedisSdkSettings`에 getter 없음, env-keys에 `APP_REDIS_CAPACITY_MAXIMUM_*_BYTES` 없음 | - | - | +| G-4b | Required | `limits.*` 11개(`maxKeyBytes`~`offlineQueueCommands`·`maxBitmapOffset`)가 적용 안 되고 SDK는 하드코딩 `RedisOperationLimits.defaults()` 사용 | 해당 없음(코드 삭제) | 같은 표 행 174. `src/adapter/outbound/redis-sdk/README.md` "Configuration that is code, not settings" 절이 한도를 코드로 준다고 명시 | - | - | +| G-4c | Required | `timeout.collection`·`timeout.admin` 미적용 | 해당 없음(코드 삭제) | 같은 표 행 174. 현재 `Timeouts`는 `fast`·`script`·`batch`만 있고 모두 참조됨(`RedisTopologyClientFactory.java:310`, `RedisCapabilityConfig.java:78`, `RedisSdkAutoConfiguration.java:259`) | - | - | +| G-4d | Required | `advanced.*`(enabled·policies) 미적용 | 해당 없음(코드 삭제) | 같은 표 행 174 | - | - | +| G-4e | Required | `blocking.max-block` 미적용 | 해당 없음(코드 삭제) | 같은 표 행 174. `Blocking`에는 lane 한도로 쓰이는 `maxConnections`만 남음(`RedisSdkAutoConfiguration.java:232`) | - | - | +| G-4f | Required | `lifecycle.tls-handshake-timeout` 미적용 | 해당 없음(코드 삭제) | 같은 표 행 174 | - | - | +| G-4g | Required | `pubsub.overflow-policy` 미적용 | 해당 없음(코드 삭제) | 같은 표 행 174 | - | - | +| G-4h | Required | `lifecycle.acquire-timeout` 미적용 | 완료 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java:241` → `RedisRuntimeOwner.java:153` `tryAcquire(acquireTimeout)`. 테스트 `RedisScriptLaneAdmissionTest.aCallerStillWaitingWhenTheAcquireTimeoutRunsOutIsRefusedAsNotSent`. 커밋 `6d27356e` | - | - | +| G-4i | Required | 남은 `pubsub.buffer-capacity`(+`authentication.pubsub-credential-reference`)가 버퍼를 제한하지 않음. PUBSUB lane 연결 수(`/64`)로만 쓰이고 pub/sub 전송 구현이 없음 | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java:235-236`, `RedisSdkSettings.java:549-566`, `docs/registries/env-keys.yaml:2297`. main에 `implements RedisPubSubGateway` 0건 (= G-6b) | W3 | G-6b에서 pub/sub를 지우면 `RedisSdkSettings.PubSub`·env key `APP_REDIS_PUBSUB_BUFFER_CAPACITY`·`_PUBSUB_CREDENTIAL_REFERENCE`를 함께 삭제(AGENTS.md 완료 기준 3) | +| G-4j | Nit | deprecated env key의 "Replaced by"가 삭제된 key를 가리킴 | 남음 | `docs/registries/env-keys.yaml:1435`(`app.redis.limits.max-batch-request-bytes`), `:1467`(`app.redis.capacity.maximum-in-flight-bytes`) | W5 | 두 행의 "Replaced by" 주석을 "대체 없음(2026-09-25 삭제)"로 수정 | +| G-5a | Required | redis-runtime·redis-sdk 테스트가 cache-redis에 있어 두 leaf focused test가 빈 초록불 | 완료 | redis-sdk `src/test` 51개(`RedisSdkModuleBoundaryTest`, `LiveRedisOperationsFixture` 등), redis-runtime `src/test` 10개(`RedisRuntimeOwnerTest` 등), fake는 `src/adapter/outbound/redis-runtime/build.gradle:4,18-20` testFixtures로 공유, `src/adapter/outbound/cache-redis/build.gradle:8-17`에 redis-sdk edge 없음. 커밋 `6d27356e` | - | - | +| G-5b | Required | redis-runtime leaf에 README·CLAUDE.md 없음 | 남음 | `src/adapter/outbound/redis-runtime/`에 `build.gradle`·`src`만 있음. redis-sdk는 `README.md` 추가됨. runtime 규칙은 `src/adapter/outbound/cache-redis/CLAUDE.md` "Redis runtime and optional typed SDK" 절에 섞여 있음 | W5 | `src/adapter/outbound/redis-runtime/README.md`를 만들어 제공하는 것·붙이는 방법·env 키(`app.redis.*` 소유)를 적고 cache-redis CLAUDE.md의 runtime 절을 옮김 | +| G-6a | Required | SDK 진입 facade `RedisOperations`·`ReactiveRedisOperations` 구현체 0 | 해당 없음(코드 삭제) | `docs/capability-status.md` 「제거된 코드」 행 170. `implements RedisOperations\|ReactiveRedisOperations` 0건 | - | - | +| G-6b | Required | pub/sub 전송(`RedisPubSubGateway`) main 구현이 없어 SDK의 pub/sub·sharded pub/sub 연산을 쓸 수 없음 | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisPubSubGateway.java`(인터페이스만), 구현은 test `InMemoryRedisPubSubGateway`뿐. `src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisPubSubOperations.java` 외 3개가 이 gateway에 의존. `src/adapter/outbound/redis-sdk/README.md` 표는 pub/sub를 제공한다고 적음 | W3 | D1 기준으로 redis-sdk의 `*PubSub*Operations`·`LiveSubscription`·`PubSubOperationRequests`·api pub/sub 인터페이스와 runtime `RedisPubSubGateway`·PUBSUB role/lane을 삭제하고 README 표에서 제거 | +| G-6c | Required | redis-sdk `RedisConnectionRegistry`가 호출자 0이고 `RedisRuntimeOwner` lane 한도 로직과 중복 | 해당 없음(코드 삭제) | 「제거된 코드」 행 173 | - | - | +| G-6d | Required | cache-redis realtime adapter(`RedisEphemeralFanoutAdapter`, `RedisConnectionRegistryAdapter`) 조립처 없음 | 해당 없음(코드 삭제) | 「제거된 코드」 행 156, 210. cache-redis main에 `realtime/` 패키지 없음 | - | - | +| G-6e | Required | SDK를 도입할 조립 코드·경로가 없음 | 완료 | `src/adapter/outbound/redis-sdk/README.md` "Adding it"(서비스 어댑터 leaf에서 `implementation` + `modules.json` edge, AGENTS.md 라이브러리형 예외), per-structure `Lettuce*Operations` 구현 36개, 조립 예시 `LiveRedisOperationsFixture`(test). 커밋 `6d27356e` | - | - | +| G-7a | Consider | runtime `RedisCommandGateway`가 SDK 표면 전체(약 118개 메서드)를 들고 있는데 cache-redis·health는 4개만 씀 | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisCommandGateway.java`(1227줄), `LettuceRedisCommandGateway.java`(1282줄). cache-redis main이 쓰는 것: `loadScript`·`evaluateRegisteredForList`·`evaluateRegisteredForLong`, health는 `ping` | W3 | runtime에는 이 4개만 가진 좁은 gateway를 두고 나머지 메서드와 `api.command`(RAW_ONLY 등)는 redis-sdk 소유 gateway로 이동 | +| G-7b | Consider | raw 자격 증명·raw allowlist가 runtime에 있음 | 해당 없음(코드 삭제) | 「제거된 코드」 행 174(`raw.*`, `RedisCredentialRole.RAW`). `RedisCredentialRole.java:23-29`에 RAW 없음 | - | - | +| G-7c | Consider | SDK 전용 admin 자격 증명·ADMIN lane이 runtime에 있음 | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java:143-148,237`. 사용처는 redis-sdk `LettuceRedisAdminOperations`뿐 | W3 | G-7a 분리 때 admin 자격 증명 해석과 ADMIN lane 한도를 redis-sdk 쪽 조립으로 이동 | +| G-7d | Consider | runtime과 sdk가 같은 패키지 `…cache.redis.sdk.*`를 공유 | 남음 | redis-runtime main 전 파일이 `dev.caskeleton.adapter.outbound.cache.redis.sdk.*`(예: `.../sdk/lettuce/connection/RedisRuntimeOwner.java:1`) | W3 | redis-runtime 패키지를 `dev.caskeleton.adapter.outbound.cache.redis.runtime.*`로 이동 | +| G-7e | Consider | runtime `RedisCorrectnessRoles`가 소비자 selector 값(session·idempotency·rate-limit·lease)을 하드코딩 | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCorrectnessRoles.java:32-37` | W3 | selector 목록을 소비자인 cache-redis(`RedisCapabilitySettings`)로 옮기고 runtime은 "required 여부"만 받도록 변경 | +| G-8 | Consider | EVALSHA+NOSCRIPT 재로드 헬퍼가 4벌 복사, `CacheScripts`만 메시지 `startsWith("NOSCRIPT")` 폴백 | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/cache/CacheScripts.java:41-87`, `ratelimit/RateLimitScripts.java:209-263`, `lease/LeaseScripts.java:106-160`, `idempotency/IdempotencyScripts.java:213-271` | W3 | cache-redis에 `RegisteredLuaScript`(digest 캐시·NOSCRIPT 판별·재로드 1회) 하나를 두고 네 클래스가 사용 | +| G-9a | Consider | 장애 WARN이 capability·operation·type 조합마다 JVM 수명 동안 한 번뿐(`WARNED` 비우지 않음) | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/RedisSemanticFailureLogger.java:19,26` | W2 | `WARNED`를 key별 마지막 WARN 시각 맵으로 바꿔 시간 창(예: 1분)마다 다시 WARN | +| G-9b | Consider | `failureType`이 대부분 wrapper(`ExecutionException`) 이름 | 남음 | 같은 파일 `:24`. 호출부는 `.get()`에서 잡은 예외를 그대로 넘김(`RedisDistributedLeaseAdapter.java:167-168` 등) | W2 | `report()`에서 `ExecutionException`·`CompletionException` cause를 풀고 기록 | +| G-10a | Consider | SCRIPT ACL probe가 `return {1}`이라 스크립트 내부 명령(`TIME`/`HSET`/`PEXPIRE`/`DEL`) 권한 부족을 기동 때 못 잡음 | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/capability/RedisSemanticScriptAclProbe.java:20`. 실제로 `infra/redis-sdk/acl/application-advanced.acl:1`에 `+time`이 없어 `LiveRedisSemanticPortsTest`가 첫 요청에서 실패(알려진 lane 실패) | W2 | probe 스크립트를 probeKey에 `TIME`·`HSET`·`PEXPIRE`·`HGET`·`DEL`을 실제 실행하는 것으로 교체하고, 테스트 ACL에 `+time` 추가 | +| G-10b | Consider | `redisRequired`가 REGULAR lane만 probe → ADVANCED 자격 증명이 깨져도 readiness UP | 남음 | `src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java:51`, `RedisSdkAutoConfiguration.java:259,287` | W2 | script capability가 선택되면 required contributor가 SCRIPT lane에서 등록 스크립트 EVALSHA로 probe | +| G-11a | Consider | application executor를 adapter leaf에서 조립하고 provider마다 lease·codec 적용이 다름 | 완료 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java:32-55`(`IdempotencySettings` 하나로 한 번 조립), `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/capability/RedisIdempotencyConfig.java:31-35`(store만 제공). 「제거된 코드」 행 228. 테스트 `IdempotencyProviderCompositionTest.redisComposesOneExecutorOverTheRedisStoreAlone`. 커밋 `6d27356e` | - | - | +| G-11b | Consider | 소유자 결정: 멱등성 executor 조립을 별도 `composition:*` 모듈로 이동 — 아직 app-bootstrap에 있고 sample이 두 번째 executor를 조립 | 남음 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java:28-55`, `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/idempotency/SampleIdempotencyConfig.java:39`. `src/composition/`에는 fileserver·notification만 있음 | W3 | `composition:idempotency` leaf를 `modules.json`에 등록하고 `IdempotencyProviderSelectionConfig`·`IdempotencySettings`를 옮긴 뒤 app-bootstrap·sample이 그 leaf를 쓰게 하고 `SampleIdempotencyConfig` 삭제 | +| G-12a | Nit | `app-bootstrap/CLAUDE.md`가 없는 `autoconfigure/redis/RedisCapabilityConfig`·`RedisKeys`를 가리킴 | 완료 | `src/app-bootstrap/CLAUDE.md:92,102`가 `cache-redis`의 `capability/RedisCapabilityConfig`·`capability/RedisKeys`를 가리킴(두 파일 존재). 커밋 `6d27356e` | - | - | +| G-12b | Nit | `cache-redis/CLAUDE.md`의 Boot 버전 "4.0.0" 틀림 | 남음 | `src/adapter/outbound/cache-redis/CLAUDE.md:8`(실제 `src/gradle/libs.versions.toml:84` `4.0.8`). `:11` package root `…outbound.cache`는 실제 `…cache.redis`의 상위라 부정확 | W5 | `:8` 버전 줄 삭제(버전은 루트 CLAUDE.md가 소유)하고 `:11`을 `dev.caskeleton.adapter.outbound.cache.redis`로 수정 | +| G-12c | Nit | `src/README.md`가 orphaned key `APP_CACHE_REDIS_ENABLED`·`APP_CACHE_REDIS_CLIENT_MODE`를 동작하는 키처럼 설명 | 남음 | `src/README.md:312-317`(`CLIENT_MODE`가 managed/external을 고른다고 서술). `docs/registries/env-keys.yaml:2445-2480` `deprecated_orphaned: true`, Java 읽는 곳 0(sample yml `src/sample-portfolio/src/main/resources/application.yml:257-258`만 바인딩) | W5 | `src/README.md:312-313,316-317` 두 항목 삭제 | +| G-12d | Nit | cache-redis README의 테스트 명령이 다른 leaf(`:app-bootstrap:test`)를 가리킴 | 남음 | `src/adapter/outbound/cache-redis/README.md:220`. 테스트는 `src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/capability/RedisSemanticScriptAclProbeTest.java` | W5 | `./gradlew :adapter:outbound:cache-redis:test --tests '*RedisSemanticScriptAclProbeTest'`로 수정 | +| G-12e | Nit | redis-runtime `RedisSdkSettings`가 바인딩하는 `app.redis.*` env key의 `owner_module`이 cache-redis | 남음 | `docs/registries/env-keys.yaml:2130,2162,2299` 등 23개(`capacity.maximum-in-flight-commands`, `capacity.reject-when-disconnected`, `lifecycle.*`, `tls.*`, `sentinel.*`, `authentication.*`, `cluster.*`, `pubsub.*`)가 `adapter-outbound-cache-redis`. `capacity.maximum-script-connections`(`:2146`)만 runtime으로 고쳐짐 | W5 | 해당 23개 행 `owner_module`을 `adapter-outbound-redis-runtime`으로 변경(`app.redis.enabled`는 cache-redis 기본 설정이 소유하므로 유지) | +| H-1a | Critical | canonical bridge `@ConditionalOnBean(EncodedMessagePublisher)`가 platform auto-config보다 먼저 평가됨 | 완료 | `src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingBridgeRootAutoConfiguration.java:35-36`(`afterName = "...MessagingPlatformRootAutoConfiguration"`). 테스트 `MessagingPlatformBridgeAutoConfigurationTest.bridgeIsAssembledAfterThePlatformRootThatProvidesThePublisher`, 실제 starter 조립 `KafkaCapabilityActivationTest.presentModuleIsOnAndPublishesThroughKafka`. 커밋 `6d27356e` | - | - | +| H-1b | Critical | 빈 `producer-id`가 `@ConditionalOnProperty`를 통과해 `new ProducerId("")`로 기동 실패 | 완료 | 같은 파일 `:71,81-91`(`ProducerIdConfigured`: `StringUtils.hasText`). 테스트 `MessagingPlatformBridgeAutoConfigurationTest.blankProducerIdLeavesTheBridgeOutWithoutFailingStartup`("", " "). 커밋 `6d27356e` | - | - | +| H-2 | Required | Dynamic Target이 `trace-propagation=false`여도 `traceparent`·`X-Correlation-Id`를 외부 호스트로 보냄 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java:154`(무조건 `PlatformHeaderPropagation.apply`). `tracePropagation`은 바인딩(`DynamicTargetAutoConfiguration.java:46`)만 되고 main에서 읽지 않음. 문서 `docs/httpclient/configuration-reference.md:179` "Off by default" | W1 | `prepare()`에 policy를 넘겨 `if (policy.tracePropagation())`일 때만 적용하고, 헤더 부재 테스트 추가 | +| H-3a | Required | Dynamic redirect가 303에서 method만 GET으로 바꾸고 body는 유지 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java:98,134`, `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/api/operation/HttpOperation.java:91-101`(`withMethod`가 body 유지) | W1 | 303 hop에서 `EmptyBody`로 교체(`BlockingRedirectCoordinator`와 같은 처리) | +| H-3b | Required | Dynamic redirect가 307/308에서 `BODY_NOT_REPLAYABLE` 검사 없이 body 재전송 | 남음 | 같은 파일 `:121-136`(`RedirectEvaluator` 미사용) | W1 | hop마다 `RedirectEvaluator.evaluate`를 호출해 재전송 불가 body면 거부 | +| H-3c | Required | Dynamic redirect가 cross-origin hop에서 호출자 헤더(`X-Api-Key` 등 `HeaderPolicy` 허용 헤더)를 그대로 전달 | 남음 | 같은 파일 `:95-98`(매 hop `operation` 헤더 재사용, `SensitiveHeaderStripper` 미사용) | W1 | origin이 바뀌면 `SensitiveHeaderStripper.stripForCrossOrigin`으로 헤더 정리 후 다음 hop 준비 | +| H-3d | Required | `DefaultDynamicTargetGateway.exchange`를 호출하는 테스트 0건 | 남음 | httpclient 전체에서 `DefaultDynamicTargetGateway` 참조는 main 2파일(`DefaultDynamicTargetGateway.java`, `DynamicTargetAutoConfiguration.java`)뿐 | W4 | httpclient `src/test`에 redirect 계약 테스트(303 body 제거, 307 1회, cross-origin 헤더 제거, trace off) 추가 | +| H-4a | Required | 허용된 API-key 헤더 `X-Client-Key`가 cross-origin redirect에서 제거되지 않음 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/SensitiveHeaderStripper.java:23,31-33`(`x-api-key`·`api-key`만), `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/BlockingExecutionSupport.java:90`(`standard()` 사용), `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAuthenticationAutoConfiguration.java:34-35` | W1 | `BlockingRedirectCoordinator`의 cross-origin 처리에서 실제 해석된 `RequestCredentials.headers().keySet()`도 함께 제거 | +| H-4b | Required | `SensitiveHeaderStripper.withAdditional` main 호출자 0 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/SensitiveHeaderStripper.java:47-55` | W3 | H-4a 적용 후 `withAdditional` 삭제 | +| H-5a | Required | reactive 경로가 실패 단계를 기록하지 않아 전송 후 실패도 `VALIDATION`(NOT_SENT)으로 분류 → 호출자가 실행된 POST를 재전송 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveAttemptExecutor.java:166-167`(`baseMetadata.stage()`), webclient 패키지에 `AttemptProgressTracker` 0건. D4는 httpclient reactive를 건드리지 않음(`HttpServiceClientAutoConfiguration.java:52-54`가 계속 조립) | W2 | `exchangeToMono` 안에서 요청 전송 뒤 `REQUEST_BODY`, 응답 수신 시 `RESPONSE_HEADERS`/`RESPONSE_BODY`를 기록해 classifier에 넘김 | +| H-5b | Required | `DataBufferLimitException`(응답 크기 초과)이 어디서도 매핑되지 않아 NOT_SENT/connect 실패로 보고 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/WebClientResponseMapper.java:33`, `reactor/ReactorFailureClassifier.java:106-108`(fallback `notSent(UNKNOWN)`) | W2 | `WebClientResponseMapper`에서 `DataBufferLimitException`을 `HttpResponseTooLargeException`으로 변환 | +| H-5c | Required | 모르는 transport 실패가 mapper `default`에서 `HttpConnectException`이 됨 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/StableBlockingExceptionMapper.java:37` | W2 | `default`를 전용 unknown 예외 타입으로 바꾸고 blocking·reactive 둘 다 테스트 | +| H-6a | Required | OAuth2 토큰 네트워크 조회가 `ConcurrentHashMap.compute` 안에서 실행돼 같은 bin 호출자가 모니터에서 대기(N번째 ≈ N×10s) | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/auth/OAuth2CredentialProvider.java:61-67` | W2 | `cache.get` + 만료 검사 → lock 밖에서 `tokenLoader.load(key)` → `cache.put`(single-flight는 loader가 이미 보장) | +| H-6b | Required | timeout 난 호출자가 공유 future를 `cancel(true)` → 뒤늦은 합류자는 raw `CancellationException`, pool 스레드는 인터럽트 안 됨 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/auth/SingleFlightTokenLoader.java:79-83,104`(`CancellationException` catch 없음) | W2 | 호출자 timeout에서는 cancel하지 않고 `inFlight`에서만 제거, `CancellationException`을 `HttpAuthenticationException`으로 변환 | +| H-7a | Consider | `categoryOf`가 `getSimpleName()` 문자열 switch로 blocking·reactive에 중복 | 남음 | `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/BlockingAttemptExecutor.java:291-312`, `webclient/ReactiveAttemptExecutor.java:182-200` | W3 | `HttpClientException`에 `FailureCategory category()`를 두고 각 하위 예외가 구현, 두 switch 삭제 | +| H-7b | Consider | reactive `categoryOf`에 CircuitOpen·RateLimitRejected·BulkheadRejected가 없어 telemetry가 `UNKNOWN` | 남음 | `ReactiveAttemptExecutor.java:182-200`(3개 누락), 같은 예외를 `resilience/ReactiveAttemptResiliencePipeline.java:57-70`이 던짐 | W2 | H-7a로 해결. 별도로 하면 reactive switch에 세 case 추가 | +| H-8 | Consider | bridge `prepare`가 모든 `RuntimeException`을 cause 없이 `REJECTED_BEFORE_SEND`로 바꿈 | 남음 | `src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/platformbridge/PlatformIntegrationEventPublishAdapter.java:60-64` | W2 | catch를 `IllegalArgumentException`으로 좁히고 cause를 `OutboxRelayFailureReport`(또는 거부 예외)로 전달 | +| H-9 | Consider | Kafka seam이 `InterruptedException`을 삼켜 종료 중에도 relay가 항목당 최대 30s 계속 처리 | 남음 | `src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java:98-110`(`.get()`의 인터럽트가 `throws Exception`으로 나감), `src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapter.java:94`(→ AMBIGUOUS), `.../core/OutboundMessagePublisher.java:36`(로그 후 무시) | W2 | `kafkaSender` 람다에서 `InterruptedException`을 잡아 `Thread.currentThread().interrupt()` 후 재던지기, `OutboundMessagePublisher`는 interrupt 상태를 보존 | +| H-10a | Nit | `src/README.md`가 HTTP client 활성화를 `ca-skeleton.capabilities.http-client`·`OutboundHttpSettings.bindLegacy`로 설명(실제 `app.httpclient.enabled`, `OutboundHttpSettings`는 main에 없음) | 남음 | `src/README.md:331-361`. 같은 파일 `:266` 표는 올바름 | W5 | `:331-361` 절을 `app.httpclient.enabled`/`APP_HTTPCLIENT_ENABLED`와 `runtimeOnly` 한 줄 기준으로 다시 쓰고 legacy 문단 삭제 | +| H-10b | Nit | Kafka javadoc이 "프로젝트가 `KafkaSender`를 제공해야 한다"고 적음(leaf가 직접 제공) | 남음 | `src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSender.java:6-8`, `KafkaAdapterConfig.java:14`. 실제 `KafkaSenderAutoConfiguration.java:95-110`이 제공 | W5 | 두 javadoc을 "이 leaf가 `kafkaSeamProducer` 위 기본 `KafkaSender`를 제공하고 서비스가 bean으로 대체 가능"으로 수정 | +| H-10c | Nit | `KafkaAdapterSettings.addresses()` 호출자 0 | 남음 | `src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettings.java:41-45` | W5 | 메서드 삭제(파싱 검증은 `BrokerAddress`로 유지) | + +**조사 메모** + +- **다른 그룹과 겹침**: G-1a = 1차 Critical #14. H-1a·H-1b = 1차 Critical #6. G-4i·G-6b는 같은 결함(pub/sub 전송 없음)이다. G-11b는 소유자 결정 "outbox relay·멱등성 executor 조립을 `composition:*`로"의 멱등성 쪽이다. outbox relay 쪽은 L 그룹에서 다룬다. +- **알려진 남은 문제 반영**: G-10a를 실제로 증명하는 게 Redis 실제 lane 실패(TIME 권한 없음)다. `application-advanced.acl`에는 `+time`이 없는데 probe는 기동 때 통과하고 첫 요청에서 실패한다. lane 거부를 `Indeterminate`로 보고하는 문제는 G-1b에 넣었다. Kafka truststore/keystore 키 없음·`MUTUAL_TLS` 미지원·`spring.kafka.bootstrap-servers`만 읽음·credential rotation 미반영은 M 그룹(1차 Critical #8 후속) 항목이라 G/H 행이 없다. +- **리뷰 밖에서 본 것 (행 추가 안 함)**: legacy seam producer에 보안 설정이 없다. `kafkaSeamProducer`(`src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java:60-81`)는 bootstrap·serializer·acks·timeout만 넣고 `security.protocol`/SSL/SASL은 넣지 않는다. 그래서 platform Kafka TLS를 고쳐도 seam 경로는 평문으로 남는다. M 그룹 담당자 확인이 필요하다. +- **G-1 수정은 리뷰 제안과 방식이 다르다**: 리뷰는 REGULAR/SCRIPT에 공유 멀티플렉싱 연결 + in-flight 제한을 제안했다. 실제로는 lease마다 연결 하나를 독점하는 구조를 그대로 두고, 한도 초과분이 `acquireTimeout`까지 기다리게 했다(계획서 Wave 1 표 1-9). 이 방식으로 Critical은 닫혔지만, 동시성 상한은 여전히 "연결 수"다. G-1c도 그래서 남아 있다. +- **D4 범위**: D4(WebFlux 삭제)는 inbound 서버 스택만 삭제했다. httpclient의 WebClient/Reactor Netty 경로(`spring-webflux`·`reactor-netty-http` 의존, `HttpServiceClientAutoConfiguration.java:52-54`)는 그대로 조립된다. 그래서 H-5a~c와 H-7b는 살아 있다. D4를 outbound reactive client까지 넓히면 이 넷은 고치는 대신 `webclient/`·`reactor/`를 지우는 것으로 대체할 수 있다. 소유자 선택 사항이다. +- **리뷰가 틀렸거나 부정확했던 것**: G-12b의 "패키지 루트 틀림"은 과장이다. `dev.caskeleton.adapter.outbound.cache`는 실제 패키지의 상위라 틀렸다기보다 부정확하다. 나머지 인용(`getAcquireTimeout` 미사용 등)은 `208077fd`에서 확인한 결과 정확했다. 예를 들어 당시 `RedisRuntimeOwner` 생성자는 `drainTimeout`만 받았다. + +## 1차 I Web · J GraphQL · K Realtime/gRPC adapter + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| I-1a | Critical | durable operation 조회/취소의 저장소 호출·트랜잭션·접근 판정이 web 어댑터 안에 있음(HARD-STOP 4) (= A-4) | 완료 | 유스케이스로 이동: `src/application-core/src/main/java/dev/caskeleton/application/operation/GetDurableOperationUseCase.java`, `CancelDurableOperationUseCase.java:56`(`transactions.inWrite`), `DurableOperationAccessPolicy.java:14`. 테스트 `GetDurableOperationUseCaseTest.submitterInAnotherTenantReadsNothing`, `CancelDurableOperationUseCaseTest.submitterInAnotherTenantIsAnsweredAsIfTheOperationDidNotExist`, `DurableOperationAccessPolicyTest`. web `operationasync/` 삭제(제거 표 「durable operation HTTP 투영」). 커밋 `6d27356e` | - | - | +| I-1b | Critical | `OperationQueryService`가 testFixtures에서만 생성돼 켜면 기동 실패 | 해당 없음(코드 삭제) | 제거 표 「durable operation HTTP 투영 (`OperationQueryService`, `OperationHttpController` 외)」. `git ls-tree -r HEAD`에 `OperationQueryService`·`OperationFixtureSupport` 없음 | - | - | +| I-1c | Critical | `WebRequestContext` argument resolver는 등록되지만 `store` 호출이 0이라 선언한 컨트롤러는 항상 예외(500) | 남음 | 등록 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebMvcPlatformAutoConfiguration.java:64-74`, `WebMvcRequestContextHolder.store`(`.../mvc/context/WebMvcRequestContextHolder.java:34`) 호출처 main·test 0, `WebMvcRequestContextArgumentResolver.java:40`이 `require` → `IllegalStateException`. `WebRequestContext` 소비자 0 | W3 | 소비자가 없으므로 `core/WebRequestContext`·`mvc/context/*`·`webMvcRequestContextConfigurer` bean을 삭제(쓰려면 `WebMvcRequestIdFilter`에서 `store` 호출) | +| I-1d | Critical | `WebResourceNotVisibleException`이 기본 envelope 계약에서 catch-all 500 | 해당 없음(코드 삭제) | `208077fd`에만 `web/error/WebResourceNotVisibleException.java` 존재, HEAD grep 0. 제거 표 「WebProblem 어휘」「durable operation HTTP 투영」 | - | - | +| I-1e | Critical | 실서버 IT가 `OperationFixtureController`로 합성 context를 넣어 결함을 못 잡음 | 해당 없음(코드 삭제) | 제거 표 「WebProblem·budget·throttle·operation fixture와 lane」(`testkit/operation/`). HEAD에 `OperationFixtureController` 없음 | - | - | +| I-2a | Required | 인증 없는 알림 콜백이 `@RequestBody byte[]`로 본문 전체를 읽은 뒤 크기 검사 | 남음 | `src/adapter/inbound/web-notification/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/NotificationCallbackMvcController.java:78-85`, 같은 경로 `CallbackMvcSecurityConfiguration.java:35` `permitAll` | W1 | 컨트롤러가 `HttpServletRequest`만 받아 `getContentLengthLong() > maxBodyBytes`면 413, 본문은 `getInputStream().readNBytes(maxBodyBytes + 1)`로 읽고 초과 시 413 | +| I-2b | Required | 운영 servlet 앱 전체에 요청 본문 크기·JSON 깊이 상한이 없음 | 남음 | budget 필터 삭제 후 대체 없음: `src/adapter/inbound/web/src/main`·`src/app-bootstrap/src/main/resources`에 본문 상한/`StreamReadConstraints` 설정 grep 0. `docs/web/repository-adaptation.md:147-151`이 "application column 미적용"이라 기재 | W1 | web leaf에 Content-Length 초과 413 + 스트림 상한 필터 하나(또는 `JsonMapperBuilderCustomizer`로 `StreamReadConstraints.maxDocumentLength/maxNestingDepth`)를 두고 Envelope `PAYLOAD_TOO_LARGE`로 응답 | +| I-2c | Required | 콜백 크기 테스트가 배열을 직접 넘겨 컨버터 버퍼링 경로를 검증 안 함 | 남음 | `src/adapter/inbound/web-notification/src/test/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/NotificationCallbackMvcControllerTest.java:118-124`(`aBodyOverTheTransportCeilingIsRefusedBeforeIngress`) | W4 | MockMvc/실서버로 큰 본문(및 Content-Length 없는 chunked)을 보내 413과 ingress 미호출을 단언 | +| I-2d | Required | `backend.web.budgets.enabled=true`면 없는 `BudgetProblemMapper` 빈을 찾아 기동 실패 | 해당 없음(코드 삭제) | 제거 표 「요청 budget 필터 (`WebMvcBudgetFilter`, `BudgetProblemMapper`)」. `WebMvcBudgetExceptionHandler`·`backend.web.budgets` grep 0 | - | - | +| I-2e | Required | 문서가 본문 크기·JSON 깊이를 "Application, always"가 막는다고 기재 | 완료 | `docs/web/repository-adaptation.md:147-151` "Removed 2026-09-25 … no longer enforces the application column" 배너. 커밋 `6d27356e` | - | - | +| I-3a | Required | Envelope 계약에서 override 안 된 Spring MVC 예외(필수 파라미터·헤더·part 누락 등)가 `application/problem+json`으로 새어 나감 | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/error/GlobalExceptionHandler.java:52`(RESEH 상속, `handleExceptionInternal` override 없음), `.../envelope/EnvelopeBodyAdvice.java:44-46`(비 JSON은 감싸지 않음). 실경로: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterImagePublicationController.java:58`(필수 `Idempotency-Key`), `LegacyPosterImageController.java:36`(필수 part) | W3 | 소유자 결정(Envelope 통일)대로 `GlobalExceptionHandler`에서 `handleExceptionInternal` 하나를 override해 status → `OperationalError` 매핑 후 `ErrorResponseFactory.body` 반환 | +| I-3b | Required | `@Valid` 클래스 레벨 제약 위반이 `details: []`로 나감 | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/error/GlobalExceptionHandler.java:262-265`(`getFieldErrors()`만) | W2 | `getGlobalErrors()`도 `ClientSafeValidationDetails`로 변환해 details에 합침 | +| I-3c | Required | 필수 파라미터/헤더 누락·`HandlerMethodValidationException` 등의 에러 형식 테스트 0건 | 남음 | web·bootstrap·sample 테스트에 `MissingServletRequestParameter`/`MissingRequestHeader`/`HandlerMethodValidation` grep 0 | W4 | web slice 테스트로 필수 파라미터·헤더 누락 시 Envelope 400(`application/json`)을 단언 | +| I-4a | Required | `RequestLoggingFilter`가 Spring Security 뒤에서 돌아 401/403 응답 meta id가 null, 접근 로그 누락 | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/filter/RequestLoggingFilter.java:37`(`@Order` 없음 → LOWEST), MDC는 `:65-71`에서만 채움, `.../auth/AuthErrorResponseWriter.java:46,69`가 MDC 기반 meta 사용. 순서 테스트 `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/OperationalContractRuntimeTest.java:100-122`는 세 필터끼리만 비교, `src/adapter/inbound/web/src/testFixtures/java/dev/caskeleton/webtestkit/PipelineOrderFixtureApplication.java:46`은 `WebAdapterAutoConfiguration`을 제외 | W2 | MDC(request/correlation/trace id) 채우기를 `WebMvcRequestIdFilter`(HIGHEST+10)로 옮기고 `OperationalContractRuntimeTest`에 "request-id 필터 order < `springSecurityFilterChain` order" 단언 추가 | +| I-4b | Required | trace id를 두 필터가 따로 생성해 서로 불일치 | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/filter/RequestLoggingFilter.java:69`(자체 traceparent 생성) vs `.../mvc/filter/WebMvcRequestIdFilter.java:122`(`WebTraceId` 생성, 요청 속성 `:80`) | W2 | `RequestLoggingFilter`는 `WebMvcRequestIdFilter.traceId(request)`만 읽고 생성하지 않음 | +| I-5a | Required | `FORWARDED_HEADERS_TRUSTED` 레이트리밋 키가 XFF 맨 왼쪽 값을 peer 검증 없이 사용 → 비인증 레이트리밋 우회 | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/ratelimit/ForwardedHeaderClientIpResolver.java:15`, 테스트가 이 동작을 고정 `src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/ratelimit/RateLimitKeyResolverTest.java:79-86` | W1 | 이 모드를 삭제하고 `server.forward-headers-strategy=native` + `server.tomcat.remoteip.internal-proxies`로 `getRemoteAddr()`를 쓰는 `REMOTE_ADDR_ONLY` 하나로(운영 정본은 `forward-headers-strategy`라는 W3-2b 결정과 일치) | +| I-5b | Required | forwarded 헤더 신뢰 판단이 여러 곳에 흩어짐 | 남음 | `TrustedProxyPolicy`·reactive 콜백은 삭제됐으나 3곳 남음: `src/app-bootstrap/src/main/resources/config/server.yml:11`(`forward-headers-strategy`), `src/adapter/inbound/web-notification/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/ExternalRequestUrlResolver.java:31-53`(정확 문자열 집합), I-5a resolver(검증 없음) | W3 | `ExternalRequestUrlResolver`의 forwarded 파싱과 I-5a 모드를 지우고 Tomcat RemoteIpValve(`forward-headers-strategy=native`)가 고친 `getScheme/getServerName/getRemoteAddr`만 사용 | +| I-6a | Required | category 생략 시 컨트롤러가 `"transactional"`을 넣어 marketing suppression이 적용되지 않음(HARD-STOP 4 후보) | 남음 | `src/adapter/inbound/web-notification/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/submission/NotificationSubmissionController.java:51-52,88-90` | W2 | 결정(2026-09-25): category 필수 — 생략하면 400, 판정은 유스케이스로 이동 | +| I-6b | Required | 템플릿 버전 기본값 `1`, locale 기본값 `Locale.getDefault()`(호스트 JVM)를 컨트롤러가 결정 | 남음 | `.../submission/NotificationSubmissionController.java:48-49,82-84,121-123`, `.../submission/NotificationTemplateController.java:75`(경로 prefix는 I-6a와 같음) | W3 | 세 값을 command에서 `Optional`로 받고 기본값은 알림 유스케이스가 설정값으로 적용 | +| I-7 | Required | `wire-type-manifest.yaml`이 런타임에 없는 wire 계약(`LONG: INTEGER_STRING`, `BIG_DECIMAL: DECIMAL_STRING`)을 공개 | 남음 | 기본 web의 bean은 삭제(`WebMvcPlatformAutoConfiguration` 3 bean)됐지만 opt-in leaf로 옮겨져 남음: `src/adapter/inbound/web-advanced/src/main/resources/META-INF/web/wire-type-manifest.yaml:3-9,25-30`, `.../web-advanced/src/main/java/dev/caskeleton/adapter/inbound/web/advanced/contract/WebWireTypeManifest.java`. 적용하는 Jackson 설정 없음 | W5 | 소비자 0이므로 yaml과 `advanced/contract/` 4개 타입·테스트를 삭제하고 web-advanced README.md:45 행 정리 | +| I-8a | Consider | 운영 소비자 없는 라이브러리 코드가 기본 web leaf에 있고 운영 경로와 중복 | 완료 | 기본 web leaf 패키지는 `auth·authz·conditional·config·controller·core·envelope·error·filter·http·mvc·observability·pagination·ratelimit·settings`만(`security/cache/openapi/idempotency` 없음). 라이브러리는 opt-in `src/adapter/inbound/web-advanced`(README.md:45 목록), 중복 세대는 삭제(제거 표 「forwarded header 라이브러리」「CORS/CSRF 프로필」「cache 정책 카탈로그」「JSON mapper factory」「OpenAPI customizer」). D1 결정, 커밋 `6d27356e` | - | - | +| I-8b | Consider | 더 엄격한 CORS 규칙(`WebCorsPolicyValidator`)을 `CorsSettings`에 합치지 않고 삭제만 함 → 기동 시 origin 형식 검증 없음 | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/settings/CorsSettings.java:24-53`(빈 목록·`*`+credentials만 검사, 기본 allowedHeaders `*` `:48-49`), 사용처 `.../auth/SecurityConfig.java:151-154`. 옛 규칙은 `git show 208077fd:.../security/WebCorsPolicyValidator.java`(정확 origin·소문자·와일드카드·credentials+`*` 헤더 거부) | W1 | `CorsSettings` compact constructor에 옛 validator 규칙(origin = scheme://host[:port] 소문자·경로 없음·와일드카드 없음, credentials면 헤더 `*` 거부) 추가 + 거부 테스트 | +| I-8c | Consider | `observability/WebAuditPublisher` 참조 0 | 해당 없음(코드 삭제) | 제거 표 「2세대 관측 (`WebAccessLog*`, `WebAudit*` …)」, HEAD grep 0 | - | - | +| I-8d | Consider | `RateLimitInterceptor.disabled(...)`가 M2 이후 dead | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/ratelimit/RateLimitInterceptor.java:48`, 호출은 `src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/ratelimit/RateLimitInterceptorTest.java:137`뿐 | W3 | `disabled` 팩토리와 그 테스트 삭제 | +| I-8e | Consider | `cursor/CursorCodec.withDevKey()` 키 하드코딩 | 해당 없음(코드 삭제) | 제거 표 「서명 커서 코덱 (`CursorCodec`, `CursorException`)」, HEAD grep 0 | - | - | +| I-9a | Consider | `problem-catalog.yaml` `VALIDATION_FAILED` 422 vs `OperationalError` 400 | 해당 없음(코드 삭제) | 제거 표 「WebProblem 어휘 (… `problem-catalog.yaml` …)」 | - | - | +| I-9b | Consider | README D5에 opt-in problem 경로(`spring.mvc.problemdetails.enabled`) 미기재 | 해당 없음(코드 삭제) | opt-in problem 경로 삭제(제거 표 「WebProblem 어휘」). 현재 README는 거부만 기재 `src/adapter/inbound/web/README.md:174`, `src/app-bootstrap/src/main/resources/application.yml:17-22` false 고정 | - | - | +| I-9c | Consider | reactive problem 핸들러가 `spring.mvc.*`로 켜짐 | 해당 없음(코드 삭제) | 제거 표 「web WebFlux 플랫폼」(D4) | - | - | +| I-9d | Consider | reactive 스택엔 envelope 핸들러가 없어 스위치 off면 Boot 기본 에러 JSON | 해당 없음(코드 삭제) | 제거 표 「web WebFlux 플랫폼」「알림 콜백 WebFlux 핸들러」(D4) | - | - | +| J-1 | Critical | 인가 단계가 fragment를 예산 없이 지수적으로 전개(cost 단계 이전) | 완료 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlDocumentAuthorizationHandler.java:118-155`(fragment 1회 전개 + 방문 예산), `.../cost/GraphQlDocumentShapeAnalyzer.java:221-227`(같음). 테스트 `GraphQlDocumentAuthorizationHandlerTest.exponentialFragmentFanOutIsAuthorizedWithinTheTimeBound`(`doublingFragments(40)`). 커밋 `6d27356e` | - | - | +| J-2 | Required | `__typename`을 introspection으로 취급해 introspection off에서 Apollo/urql 쿼리 전부 거부 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/cost/GraphQlDocumentShapeAnalyzer.java:41,212`(`startsWith("__")`), 기본 off `src/adapter/inbound/graphql/src/main/resources/config/graphql.yml:19`. `__typename` 허용 테스트 없음 | W2 | `__schema`/`__type`만 막고 systemTest에 introspection off + `{ _health __typename }` 성공 추가 | +| J-3a | Required | 마스킹된 실패가 어디에도 로그되지 않음(executionId가 가리키는 기록 없음) | 남음 | graphql main에 `LoggerFactory/getLogger/System.Logger` 0 파일. 마스킹 분기 `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/error/GraphQlExceptionResolver.java:55`, 요청 단계 `.../runtime/GraphQlPlatformWebInterceptor.java:94-95,161-165`, `.../runtime/GraphQlPlatformInstrumentation.java:84-88` | W2 | 마스킹 분기(unknown → `INTERNAL_ERROR`)에서 executionId와 예외를 ERROR로 한 번 로그 | +| J-3b | Required | Javadoc이 "detail은 로그에 남는다"고 주장 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlWireErrorMapper.java:30-32`, `.../runtime/GraphQlPlatformRejectionMapper.java:26-29` | W5 | J-3a 로그 추가와 함께 문구를 실제 로그 위치에 맞춤 | +| J-4a | Required | DataLoader `GraphQlBatchTimeoutException`·`GraphQlMissingKeyException` CODE를 mapper가 몰라 `INTERNAL_ERROR`로 나감 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlPlatformRejectionMapper.java:54-121`에 두 타입 없음. 카탈로그 테스트는 "modelled-only"(`src/adapter/inbound/graphql/src/test/java/dev/caskeleton/adapter/inbound/graphql/error/GraphQlErrorCodeCatalogTest.java:52-55`)인데 `src/adapter/inbound/graphql/CLAUDE.md:161`은 DataLoader `wired` | W2 | `mapKnown`에 두 예외 매핑 추가(batch timeout은 `REQUEST_TIMEOUT`, missing key는 전용 code)하고 `platformCodes()`·카탈로그 테스트 갱신 | +| J-4b | Required | blocking bridge 포화가 Reactor `Schedulers.fromExecutor`를 거쳐 `RejectedExecutionException`으로 감싸여 `INTERNAL_ERROR` + 거부마다 ERROR 로그 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlBatchLoaderRegistrar.java:121-125`, `.../runtime/GraphQlBlockingBridge.java:78-85`; mapper에 `GraphQlBlockingBridgeFullException` 없음 | W2 | Reactor scheduler 대신 `Mono.fromFuture(CompletableFuture.supplyAsync(..., bridge executor))`로 거부를 `Mono.error`로 받고, cause chain에서 bridge-full을 찾아 `DEPENDENCY_UNAVAILABLE`로 매핑 | +| J-4c | Required | DataLoader 실패 테스트가 `getErrors().isNotEmpty()`만 단언 | 남음 | `src/adapter/inbound/graphql/src/test/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlBatchLoaderRegistrationTest.java:137,150,166,202` | W4 | 각 실패의 wire `extensions.code`/`category`를 단언 | +| J-5 / X1-#2d | Required | stable extensions allowlist가 아무도 처리하지 않는 `idempotencyKey`를 허용 | 완료 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/http/GraphQlExtensionsPolicy.java:40-42`(`stableDefaults()` → `none()`), 테스트 `GraphQlRequestEnvelopeValidatorTest.stableDefaultsRejectAnIdempotencyKeyExtensionAsUnregistered`. 제거 표 「GraphQL mutation 멱등성」. 커밋 `6d27356e`
X1-#2d: `GraphQlExtensionsPolicy.java:29` 기본 allowlist `Set.of()`, mutation 멱등성 타입 삭제(`docs/capability-status.md:231`), 커밋 `6d27356e` | - | - | +| J-6 | Required | `GraphQlClientPolicy.persistedOperationOnly`가 아무 동작도 안 함(fail-open) | 해당 없음(코드 삭제) | 제거 표 「`GraphQlClientPolicy`의 `persistedOperationOnly`·`maxResponseNodes`·`maxResponseBytes`」, graphql src grep 0 | - | - | +| J-7 | Consider | preparsed 캐시가 조회마다 전역 lock 아래 전체 항목을 순회 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/execution/BoundedPreparsedDocumentProvider.java:167-177`(끝까지 순회). 맵은 이미 access-order(`:57`) | W3 | `expireIdle`에서 첫 미만료 항목을 만나면 `break`(access-order라 뒤는 모두 더 최근) | +| J-8 | Consider | 인가 root 타입 이름을 `"Query/Mutation/Subscription"` 리터럴로 고정 → root 이름을 바꾸면 규칙 미적용(allow 규칙 fail-open) | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlDocumentAuthorizationHandler.java:74-84` | W1 | `context.schema().getQueryType()/getMutationType()/getSubscriptionType()`의 이름 사용 | +| J-9a | Consider | body-cap 필터 스트리밍 경로에서 `BodyTooLargeException`이 감싸이면 413 대신 500 가능 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/servlet/GraphQlRequestBodyLimitFilter.java:85-91`(예외 타입 직접 catch), `:205`(RuntimeException). 미확인: 실제 wrapping 여부는 실행해 봐야 함 | W2 | catch를 `Exception`으로 넓혀 cause chain에서 `BodyTooLargeException`을 찾으면 413 | +| J-9b | Consider | body-cap 필터의 chunked(Content-Length 없음) 경로 테스트 없음 | 남음 | graphql test·systemTest에 `chunked`/`Transfer-Encoding`/`BodyTooLarge` grep 0 | W4 | systemTest에 Content-Length 없는 chunked 초과 본문 → 413 케이스 추가 | +| J-10a | Consider | `advanced/**` 134파일 도달 불가 | 해당 없음(코드 삭제) | 제거 표 「graphql `advanced/**` 전체」 | - | - | +| J-10b | Consider | `compat`·`release`·`moduleboundary`(테스트 데이터가 운영 jar에) 도달 불가 | 해당 없음(코드 삭제) | 제거 표 「graphql 스키마 호환성 비교기 `compat/`」「graphql 릴리스 게이트 `release/`」「graphql 모듈 경계 모델 `moduleboundary/`」 | - | - | +| J-10c | Consider | `fetch`·`mutation`(·`pagination`) 패키지가 요청 경로에서 도달 불가 | 완료 | D1(분류 2) 결정대로 라이브러리 API로 등재: `src/adapter/inbound/graphql/README.md:214-226`, `CLAUDE.md:162`. graphql은 opt-in capability라 기본 조립에 실리지 않음. 커밋 `6d27356e` | - | - | +| J-10d | Consider | `http/` 병렬 HTTP 계층이 도달 불가 | 남음 | 9개는 삭제(제거 표 「병렬 HTTP 전송 모델」), 남은 `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/http/GraphQlRequestEnvelopeValidator.java`·`GraphQlHttpRequestEnvelope.java`는 테스트(`GraphQlRequestEnvelopeValidatorTest`, `GraphQlRequestBoundsTest`)만 참조, README 라이브러리 목록에도 없음 | W3 | 두 타입을 삭제하고 테스트는 실제 경로(`GraphQlPlatformWebInterceptor.verifyRequestBounds`, `GraphQlRequestSize`, `GraphQlJsonStructurePolicy`) 대상으로 옮김 | +| J-10e | Consider | 두 번째 에러 어휘: 요청 단계 거부가 `GraphQlWireErrorMapper`를 거치지 않아 `ApiErrorCarrier`가 `INTERNAL_ERROR`로 바뀜 | 남음 | `GraphQlRequestErrorMapper`는 삭제(제거 표)됐으나 경로는 여전히 둘: `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlPlatformWebInterceptor.java:161-165`, `.../runtime/GraphQlPlatformInstrumentation.java:84-88`이 `GraphQlPlatformRejectionMapper.map` 직접 호출. 사실은 `GraphQlWireErrorMapper.java:23-28` Javadoc이 인정 | W3 | 두 호출부를 `GraphQlWireErrorMapper`(bean 주입)의 요청 단계 메서드로 바꿔 필드·요청 단계가 같은 mapper를 쓰게 | +| J-10f | Consider | `GraphQlPlatformActuatorEndpoint`·`…ConfigurationReport`가 bean이 아님 | 해당 없음(코드 삭제) | 제거 표 「`GraphQlPlatformActuatorEndpoint`, `GraphQlPlatformConfigurationReport`」 | - | - | +| J-10g | Consider | `schema/` 19개 중 16개 도달 불가 | 해당 없음(코드 삭제) | 제거 표 「schema gate·병렬 조립기 … 14개」. 남은 `schema/` 3개(`GraphQlScalar*`)는 자동 설정에서 도달 | - | - | +| J-11a | Consider | CLAUDE.md가 Accept negotiation을 `wired`로 표기(`GraphQlMediaTypes` 도달 불가) | 해당 없음(코드 삭제) | 제거 표 「병렬 HTTP 전송 모델(… `GraphQlMediaTypes`, `GraphQlAcceptHeader` …)」, CLAUDE.md 등급 표에서 행 제거됨 | - | - | +| J-11b | Consider | README/CLAUDE가 없는 `GraphqlExceptionResolver`와 "비-carrier는 null 반환 → Spring 기본 처리"를 설명(실제는 전부 마스킹) | 남음 | `src/adapter/inbound/graphql/README.md:64-79`, `src/adapter/inbound/graphql/CLAUDE.md:52,125` | W5 | 현재 구조(`GraphQlDataFetcherExceptionResolver` → `GraphQlWireErrorMapper`, unknown은 마스킹)로 해당 절 재작성 | +| J-12 / X2-P2-6b | Consider | prod가 익명 principal resolver로 기동한 뒤 모든 요청을 `AUTHENTICATION_REQUIRED`로 거부 | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/autoconfigure/GraphQlPlatformAutoConfiguration.java:266-270`(기본 `anonymous()`), 같은 파일 `:296-309`는 authz policy만 prod에서 요구
X2-P2-6b: `AuthorizationPrincipal.java:13` tenant 없음, GraphQL 기본 resolver `GraphQlPrincipalResolver.anonymous()`(`GraphQlPlatformAutoConfiguration.java:269`), gRPC `GrpcAuthenticationPolicy.java:16` boolean, 가명은 `GraphQlIdentityFingerprinter`와 `UserPrincipalPseudonymizerPort`로 갈림 | W2 | `graphQlPrincipalResolver` 기본 bean도 `properties.production()`이면 `GraphQlPlatformConfigurationException`
X2-P2-6b: `AuthorizationPrincipal`에 tenant 추가해 모든 inbound가 생성, GraphQL에 Spring Security `Authentication` → principal 기본 resolver, 가명은 `UserPrincipalPseudonymizerPort` 하나로 | +| K-1 | Required | `HandshakeAdmissionPipeline`이 bearer/cookie 헤더 존재만으로 통과, 모든 사용자가 한 actor | 해당 없음(코드 삭제) | 제거 표 「platform catalog·정책 패키지 … `handshake` …」(K#1 명시). 현재 websocket main에 `handshake/` 없음 | - | - | +| K-2a | Required | servlet 런타임에서 frame/fragment 상한(`FragmentAssembler`)이 동작하지 않음 | 해당 없음(코드 삭제) | 제거 표 「`inbound/FragmentAssembler`, … `maxFrameBytes`·`maxFragments` …」(K#2 명시) | - | - | +| K-2b | Required | 실제 수신 상한이 Tomcat 기본 8 KiB이고 설정한 `maxMessageBytes`와 무관 | 완료 | handler가 whole message의 크기를 직접 검사 `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/servlet/PlatformWebSocketHandler.java:79-86`, 컨테이너 버퍼를 `maxMessageBytes`와 맞추는 조립 예·설명 `src/adapter/inbound/websocket/README.md:108-124`. 커밋 `6d27356e` | - | - | +| K-2c | Required | 크기 비교가 UTF-16 char 수를 바이트 예산과 비교 | 완료 | `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/servlet/PlatformWebSocketHandler.java:79`(`getBytes(UTF_8).length`), 테스트 `PlatformWebSocketHandlerTest.messageOverTheBoundInUtf8BytesClosesWith1009`. 커밋 `6d27356e` | - | - | +| K-3 | Required | `ReactiveFrameSink` 버퍼가 무제한 | 해당 없음(코드 삭제) | 제거 표 「reactive runtime `webflux/`(`ReactiveFrameSink` …)」(K#3 명시) | - | - | +| K-4 | Required | `SerializedOutboundWriter.drain()` 경쟁으로 메시지가 남겨짐 | 완료 | `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/outbound/SerializedOutboundWriter.java:111-122`(unlock 후 `hasQueued()` 재확인 루프), 테스트 `SerializedOutboundWriterTest.nothingIsStrandedWhenBusy`(수동 drain 제거). 커밋 `6d27356e` | - | - | +| K-5a | Required | `PlatformWebSocketHandler.stop()`이 웹 서버 종료 뒤 실행돼 1001을 못 보냄 | 완료 | `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/servlet/PlatformWebSocketHandler.java:155-161`(`SmartLifecycle.DEFAULT_PHASE`), 테스트 `PlatformWebSocketHandlerTest.stopRunsBeforeTheWebServerGracefulShutdown`. 커밋 `6d27356e` | - | - | +| K-5b | Required | 종료 IT가 context를 닫지 않고 `stop()`을 직접 호출 | 남음 | `src/adapter/inbound/websocket/src/systemTest/java/dev/caskeleton/adapter/inbound/websocket/runtime/TomcatWebSocketAbuseIT.java:71`(`handler.stop()`) | W4 | `shutdownClosesLiveConnections`에서 application context를 `close()`해 Spring lifecycle 순서로 1001을 받는지 단언 | +| K-6 | Required | gRPC 예외 인터셉터가 정상 close 뒤 `onComplete`·늦은 `onCancel`을 삼켜 스트리밍 정리 hook이 안 돎 | 남음 | `src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/GrpcExceptionHandlingInterceptor.java:67-80`(모든 콜백이 `closed`면 return), `:95`(OK close에도 `closed=true`). `GrpcExceptionHandlingInterceptorTest`에 onComplete/onCancel 테스트 없음 | W2 | `onComplete`/`onCancel`은 gate 없이 try/catch만으로 위임, gate는 `onMessage`/`onHalfClose`/`onReady`에만; `setOnCloseHandler`가 실행되는 wire 테스트 추가 | +| K-7 | Required | `WebSocketSessionRegistry` register/deregister 경쟁으로 actor당 상한 초과 | 해당 없음(코드 삭제) | 제거 표 「platform catalog·정책 패키지 … `session` …」(K#7 명시) | - | - | +| K-8 | Consider | conflation 교체가 연결당 상한을 건너뛰고 손실을 `CONFLATED`로 보고 | 완료 | `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/outbound/OutboundQueue.java:192-210`(로컬·전역 둘 다 검사, 실패 시 `DROPPED`), 테스트 `OutboundQueueTest.conflationThatDoesNotFitTheConnectionBoundIsReportedAsDropped`. 커밋 `6d27356e` | - | - | +| K-9 | Consider | `WebSocketCorrelationRegistry.countFor`가 노드 전체 in-flight를 요청마다 순회 | 해당 없음(코드 삭제) | 제거 표 「platform catalog·정책 패키지 … `handler` …」, 현재 websocket main에 `handler/` 없음 | - | - | +| K-10a | Consider | gRPC 인증 정책이 yes/no만 반환해 식별자를 `Context`로 넘기지 못함 | 남음 | `src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/GrpcAuthenticationPolicy.java:16`(`boolean isAuthenticated(Metadata)`) | W3 | `Optional authenticate(Metadata)`로 바꾸고 인터셉터가 `Context.Key`에 담아 `Contexts.interceptCall` | +| K-10b | Consider | gRPC 인증 정책 예외를 로그 없이 삼킴 | 남음 | `src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/GrpcAuthenticationInterceptor.java:35-41`(`catch (RuntimeException ignored)`) | W2 | 예외 타입·메서드명만 WARN 로그(자격 증명 제외) 후 UNAUTHENTICATED | +| K-11a | Consider | live STOMP inbound/outbound 채널 executor queue가 무제한(`Integer.MAX_VALUE`) | 남음 | `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/stomp/WebSocketConfig.java:66-69`(interceptor만 등록, `taskExecutor().queueCapacity` 없음), `configureClientOutboundChannel` 없음 | W1 | `registration.taskExecutor().corePoolSize/maxPoolSize/queueCapacity(n)`을 inbound·outbound 둘 다 설정(`WebSocketSettings`에서 값) | +| K-11b | Consider | 동기 `@EventListener` 브로드캐스트가 구독자 수만큼 발행 스레드에서 fan-out | 남음 | `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/stomp/LiveEventStompBroadcaster.java:57-87` | W3 | best-effort(R1) 문서 기준이면 브로커 채널에 executor를 두거나(`configureMessageBroker`의 `brokerChannel` taskExecutor) 리스너를 비동기로 | +| K-12a | Nit | `moduleboundary/WebSocketStableModule` `HANDSHAKE` Javadoc 중복 | 해당 없음(코드 삭제) | 제거 표 「websocket main의 검증용 코드(`moduleboundary`, `evidence`, `release`)」 | - | - | +| K-12b | Nit | websocket `CLAUDE.md`가 Boot 4.0.0 표기 | 완료 | `src/adapter/inbound/websocket/CLAUDE.md:8` "Spring Boot 4.0.8"(`208077fd`은 4.0.0). 커밋 `6d27356e` | - | - | +| K-12c | Nit | gRPC `CLAUDE.md`가 Boot 4.0.0 표기 | 남음 | `src/adapter/inbound/grpc/CLAUDE.md:8` | W5 | 버전 숫자를 지우고 "버전은 version catalog가 정본"으로(같은 문구가 `src/adapter/inbound/graphql/CLAUDE.md:8`에도 있음) | + +**조사 메모** + +- 겹침: I-1a는 리뷰 본문이 밝힌 대로 Group A #4와 같은 결함. I-3a는 소유자 결정(HTTP 에러 = Envelope 하나)의 web 쪽 적용 대상이고, fileserver problem+json 통일 항목과 같은 작업 단위. I-5a·I-5b는 리뷰의 H3(서버 기본값만 종결) 연장선. +- 리뷰가 틀렸던 것: J-7 수정안의 "access-ordered `LinkedHashMap`으로 바꾸라"는 부분은 이미 `208077fd`에서 access-order였다(`git show 208077fd:…/BoundedPreparsedDocumentProvider.java:57` `new LinkedHashMap<>(16, 0.75f, true)`). 필요한 건 `expireIdle`의 조기 `break`뿐. + +## 1차 M Messaging · N gRPC platform · O Build/CI + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| M-1 | Critical | outbox relay·DLQ·retry-topic이 이미 인코딩된 payload를 다시 인코딩해 전부 REJECTED (= Critical #7) | 완료 | `src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java:307-311` (`EncodedMessage` payload는 codec을 거치지 않고 content type만 확인). 테스트 `DefaultMessagePublisherTest.aDeadLetterPublishedThroughThisPublisherReachesTheTransportWithTheOriginalBytes`, `OutboxRelayTest.aRowRelayedThroughTheRealPublisherIsMarkedPublished`·`aRowRelayedThroughTheRealPublisherReachesTheTransportWithItsStoredBytes`(실제 `DefaultMessagePublisher` 사용). 커밋 `6d27356e` | - | - | +| M-2a | Critical | `KafkaSecurityConfigurer`를 producer에 적용하지 않아 TLS/SASL 설정이 있어도 PLAINTEXT·무인증으로 연결 (= Critical #8) | 완료 | `src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java:176,187-236` (security profile을 configurer로 병합, profile·CredentialProvider가 없으면 기동 실패). 테스트 `KafkaProducerSecurityTest.aTlsBrokerWithScramCredentialsConfiguresTheProducerForSaslSsl`·`aBrokerDeclaringTlsWithoutASecurityEntryFailsStartup`·`aSecurityEntryWithoutACredentialProviderFailsStartup`. 커밋 `6d27356e` | - | - | +| M-2b | Critical | producer는 `spring.kafka.bootstrap-servers`만 읽고, 필수로 검증하는 `app.messaging.brokers..bootstrap-servers`는 쓰지 않음(주소를 두 곳에 적어야 함) | 남음 | `src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java:155-165` vs `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java:97-99` | W2 | 결정(2026-09-25): capability 설정 prefix는 하나(AGENTS.md 기준 4) → producer가 `app.messaging.brokers..bootstrap-servers`를 읽고 `spring.kafka.bootstrap-servers` 의존 제거 | +| M-2c | Critical | broker별 `access.publishable` ACL이 compile만 되고 publish 판정에는 쓰이지 않음 | 남음 | `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java:235-238`에서 만든 정책을 아무도 안 씀. 판정은 `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java:414-419` (`DeclaredDestinationAccess.of(destinations.all())`) | W1 | `messagingDestinationAccess` bean이 선언 destination 집합과 compile된 `BrokerSecurityProfile`의 `publishable`을 교집합으로 쓰게 바꾸고, 허용 목록 밖 publish가 REJECTED인 테스트 추가 | +| M-2d | Critical | SASL JAAS username에 credential 참조 id가 들어감 | 남음 | `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java:148-151`. 새 테스트가 결함을 고정함: `src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerSecurityTest.java:84-94` (`username="kafka-producer"` = credential id) | W1 | `CredentialRuntime`(또는 provider 응답)에 username을 넣고 JAAS는 그 값을 쓰게 바꿈. 테스트 기대값도 provider가 준 username으로 교체 | +| M-2e | Critical | truststore/keystore 설정 키가 없음. `MutualTls`는 `SSL` + `sasl.mechanism=NONE`만 넣고 keystore를 안 넣음 → 사설 CA·mTLS broker 연결 불가 | 남음 | `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java:85-90,109`. `git grep -i "truststore\|keystore" -- 'src/messaging/*/src/main'` 0건 | W1 | `BrokerSecuritySettings`에 truststore/keystore(경로·유형·비밀번호 credential id) 추가 후 `ssl.truststore.*`/`ssl.keystore.*` 설정. 지원 전까지 `MutualTls`는 기동 거부 | +| M-2f | Critical | credential rotation이 producer에 반영 안 됨(기동 때 JAAS 문자열 1회 생성) | 남음 | `src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java:234-235` (`Instant.now()`로 1회 configure), `:246-250` (generation 1 고정). `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java:17-20` javadoc은 rotation이 된다고 적음 | W1 | rotation 시 producer를 새로 만들고 transport generation을 올리는 경로 추가. 당장 안 하면 javadoc을 정정하고 만료 임박 credential은 기동/주기 검사에서 경고 | +| M-3 | Required | handler timeout 때 `cancel(true)`가 실행 중 handler를 멈추지 않는데 permit을 바로 반환 → 같은 offset 중복 처리 (H6 회귀) | 남음 | `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java:316-319` (`!cancel(true) && !isDone()` 분기 도달 불가). 테스트 `src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java:157,201`은 `isCancelled()`만 확인 | W2 | timeout이면 항상 `handler.whenComplete(...)`에서 permit·work count를 반환. 테스트는 "첫 handler가 끝나기 전 같은 offset 재dispatch 없음"을 단언 | +| M-4a | Required | admission 거부(`MessageTooLarge`/`Backpressure`)가 `try` 밖에서 동기 예외로 던져짐 | 남음 | `src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java:227` | W2 | `admission.admit`을 `try` 안으로 옮겨 크기 초과는 REJECTED(retryable=false), backpressure는 REJECTED(retryable=true)로 반환 | +| M-4b | Required | relay에 row별 catch가 없고 CLAIM이 `attempts`를 올리지 않음 → poison row가 매 lease 재claim, 같은 batch 나머지도 lease 만료까지 묶임 | 남음 | `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelay.java:166-168,223-227` (`toEnvelope`·`publish` 예외가 `runOnce` 밖으로), `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java:113-135` (attempts 미증가), `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactory.java:71` (예약 header row에서 throw) | W2 | `runOnce` 루프에 row별 try/catch → `markFailed(lease, code)`. 테스트: 예약 header row는 FAILED, 같은 batch 나머지 row는 PUBLISHED | +| M-4c | Required | 실패한 relay pass를 로그 없이 삼키고 `failedPasses()`를 읽는 곳이 없음 | 남음 | `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayWorker.java:184-189`, `:155` (main 호출 0) | W2 | catch에서 원인 포함 WARN 로그, `failedPasses`를 meter로 노출 | +| M-5a | Required | publish가 deadline 적용 전 caller thread를 최대 약 65초 막음(InFlightLimiter 5초 + `max.block.ms` 기본 60초) | 남음 | `src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java:227-233`, `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java:436-437`, `src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java:162-177` (`MAX_BLOCK_MS` 없음) | W2 | `producerConfig`에 `max.block.ms`를 기본 publish timeout 이하로 설정, limiter 대기도 남은 budget 안으로 제한 | +| M-5b | Required | reactive facade가 blocking publish를 subscriber thread에서 실행 | 남음 | `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DefaultReactiveMessagePublisher.java:37` | W2 | `Mono.fromCompletionStage(...)` 뒤에 `.subscribeOn(Schedulers.boundedElastic())` | +| M-6 | Required | outbox/inbox cleanup job이 제한 없는 단일 DELETE (MSG-006 §6 불완전) | 남음 | `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/OutboxCleanupJob.java:50`, `src/messaging/messaging-inbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/inbox/InboxCleanupJob.java:56` (1-인자 purge), `InboxCleanupJob.java:21` `DEFAULT_BATCH_SIZE` 미사용. bounded 버전 `JdbcOutboxRepository.java:485`, `JdbcInboxRepository.java:141`은 main 호출 0 | W2 | 두 job이 `(cutoff, batchSize)` 버전을 삭제 수 < batch가 될 때까지 반복 호출. port의 1-인자 메서드(`src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java:103`, `InboxRepository.java:45`) 삭제 | +| M-7 | Required | consumer poison message가 지연 없이 무한 재시도(partition 영구 정지) | 남음 | `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java:115` (기본 quarantine `unavailable()`), `:607-609` (`enqueueRequeue(Duration.ZERO)`), `src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessor.java:70-97` (시도 한도 없음) | W2 | requeue에 `BackoffCalculator` 지연, 시도 한도 초과 시 DLQ/park. production에서 quarantine이 `unavailable()`이면 기동 거부 | +| M-8a | Consider | 옛 prefix `backend.messaging` 테스트 fixture yml 2개가 남아 있음(어떤 테스트도 로드 안 함) | 남음 | `src/messaging/messaging-spring-boot-starter/src/test/resources/application-valid.yml:2-3`, `src/messaging/messaging-spring-boot-starter/src/test/resources/application-invalid-ordering.yml:7-8`. `git grep "application-valid\|invalid-ordering" -- src/messaging` 0건 | W5 | 두 파일 삭제 | +| M-8b | Consider | kafka-share·stream-bridge 오류 메시지가 거부되는 옛 prefix를 안내, `app.messaging.experimental.*`는 바인딩만 | 해당 없음(코드 삭제) | 「제거된 코드」 표의 `messaging-kafka-share-experimental` leaf, `messaging-spring-cloud-stream-bridge` leaf, `MessagingSettings.Experimental`·`Bridge` 행 | - | - | +| M-9 | Consider | 구현·사용처 없는 messaging API 타입 7개 (known-open L7/L8) | 남음 | `src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/BatchMessageHandler.java`, `.../api/destination/CapabilityRegistry.java`, `.../api/publish/DelayedMessagePublisher.java`, `.../api/settlement/ManualMessageHandler.java`, `.../api/delivery/PauseResumeController.java`, `.../api/delivery/ProcessingGuarantee.java`, `src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingLifecycle.java` (main 참조 0, `git grep`로 확인) | W3 | 7개 파일 삭제 | +| M-10 | Consider | Rabbit publish sequence 예약이 원자적이지 않음 | 해당 없음(코드 삭제) | 「제거된 코드」 표의 `messaging-rabbit` leaf 행 | - | - | +| M-11 | Consider | outbox CLAIM이 `ordering_key`를 무시해 같은 key의 뒤 row가 먼저 나갈 수 있음 | 남음 | `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java:113-128` (`ORDER BY created_at` + `SKIP LOCKED`) | W2 | ordered destination을 outbox로 내보내는 조합을 기동 때 거부(최소 수정). 순서 보장이 필요하면 같은 key의 더 오래된 미완료 row가 있을 때 claim에서 제외 | +| N-1 | Critical | FAILED_TERMINAL 뒤 재시도가 claim 없이 PROCEED (= Critical #15) | 완료 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java:109-117` (`reclaimFailed` 성공 시에만 PROCEED), `src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java:53`, `src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java:92-96`. 공통 계약 `src/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java` (`aFailedClaimIsReclaimedByARetryOfTheSameRequest`, `aFailedClaimCannotBeCommittedWithoutBeingReclaimed`)을 fake(`InMemoryOperationLedgerContractTest`)와 JPA(`JpaGrpcOperationLedgerContractIT`)가 상속. 커밋 `6d27356e` | - | - | +| N-2 | Required | `GrpcDeadlineBudget`이 생성 시점 Duration만 들고 있어 시간이 지나도 만료되지 않음 | 남음 | `src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java:13,82-83` | W2 | 절대 시각(`long deadlineNanos` + 주입 `LongSupplier`)을 저장하고 `remaining(now)`/`expired(now)`로 변경, 시간 경과 테스트 추가 | +| N-3 | Required | starter `environment` 기본값 LOCAL → 설정 누락 시 TLS·reflection 검사 전부 꺼짐 | 남음 | `src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java:26`, `src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java:87` | W1 | 기본값 제거, `enabled=true`인데 environment가 없으면 startup violation. 누락 케이스 테스트 추가 | +| N-4 | Required | resolver service config의 retry/hedging을 검증하지 않고, 정상 `retryThrottling.maxTokens`는 `token` 부분일치로 거부 | 남음 | `src/grpc-advanced/grpc-advanced-resilience/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverSafetyPolicy.java:56-65,86-91` | W1 | JSON 파싱 + top-level 키 allowlist, `retryPolicy`/`hedgingPolicy`는 `GrpcMethodPolicyCatalog`로 검증하거나 거부, credential 정규식 삭제 | +| N-5a | Required | `GrpcAdmissionController.tryAdmit` check-then-act → 동시 호출 수만큼 bound 초과 | 남음 | `src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcAdmissionController.java:52-55` | W2 | `synchronized` 또는 `updateAndGet` CAS로 확인과 증가를 하나로, 동시성 테스트 추가 | +| N-5b | Required | `GrpcCredentialRotationManager` get/set 경합 → `completeDrain`이 새 generation을 되돌리거나 역방향 rotation 통과 | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManager.java:89-103,119-120` | W2 | `state.updateAndGet`/`compareAndSet` 루프로 교체, 동시 rotate·completeDrain 테스트 | +| N-5c | Required | `GrpcChannelRuntimeRegistry.rotate` get/set 경합으로 replacement가 drain 목록에서 빠져 누수, synchronizedList를 락 없이 순회 | 남음 | `src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java:91-107,127-129` | W2 | `holder.compareAndSet` 또는 profile 단위 `synchronized`, `retireQuiescent`·`draining`은 리스트 락 안에서 순회 | +| N-5d | Required | `GrpcServiceHealthRegistry`에서 `draining` 확인과 `put(SERVING)` 사이에 drain 시작 → drain 후 SERVING 복귀 | 남음 | `src/grpc/grpc-admin/src/main/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistry.java:50-53` vs `:85` | W2 | `markServing`/`markNotServing`/`beginDraining`을 같은 락으로 묶기 | +| N-5e | Required | `GrpcStreamAdmission`이 global bound 검사 전에 `computeIfAbsent` → 포화 시 거부된 caller마다 count 0 엔트리 영구 잔류 (M1(b) 미완) | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java:43-47` | W2 | global 검사를 `computeIfAbsent` 앞으로 옮김 | +| N-6a | Required | `GrpcSerializedStreamWriter`의 `LongSupplier` sizer가 실제 payload 크기를 모름 (H3 잔여) | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java:30,48` | W2 | `ToLongFunction`로 바꿔 메시지마다 크기 계산 | +| N-6b | Required | writer가 `PAUSE`를 `ACCEPTED`로 반환해 백프레셔 신호 소실 | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java:100-102` | W2 | `ACCEPTED_PAUSE` 결과를 추가해 PAUSE를 호출자에게 전달 | +| N-6c | Required | `flush()`가 `isReady`와 무관하게 큐 전체 전송 | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java:126-138` | W2 | `flush(BooleanSupplier ready)`로 바꿔 ready가 false면 중단 | +| N-7 | Consider | `GrpcContextBinder.wrap`이 io.grpc `Context`(취소·deadline)를 스레드 경계에서 버림 | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/context/GrpcContextBinder.java:86-98` (SNAPSHOT 값만 캡처) | W2 | `Context.current()`를 캡처해 `captured.wrap(...)` 안에서 `runWith` 실행 | +| N-8a | Consider | envoy 참조 설정의 `DownstreamTlsContext`에 인증서가 없음 | 남음 | `src/grpc-advanced/grpc-advanced-compat/src/main/resources/envoy/envoy.yaml:50-53` | W2 | 인증서 경로 placeholder를 넣고 `envoy --mode validate` 통과 확인 | +| N-8b | Consider | CORS header 목록이 실제 gRPC trailer와 다름(`expose_headers`에 `error-code,error-category`, 실제는 `error-reason`·`error-execution-id`·`completion-outcome`, `grpc-status-details-bin` 없음. `allow_headers`에 `x-user-agent`·`grpc-timeout` 없음) | 남음 | `src/grpc-advanced/grpc-advanced-compat/src/main/resources/envoy/envoy.yaml:37-38` vs `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java:31-39` | W2 | header 목록을 정정하고 `GrpcErrorMapper` 상수와 envoy.yaml을 대조하는 테스트 추가 | +| N-8c | Consider | route `timeout: 30s`가 server stream을 30초에 끊음 | 남음 | `src/grpc-advanced/grpc-advanced-compat/src/main/resources/envoy/envoy.yaml:32` | W2 | stream route는 `timeout: 0s` + `grpc_timeout_header_max: 0s` | +| N-8d | Consider | 참조 설정이 main resources라 jar에 포함, 테스트는 부분 문자열만 확인 | 남음 | `src/grpc-advanced/grpc-advanced-compat/src/main/resources/envoy/envoy.yaml` | W3 | test resources 또는 docs로 이동 | +| N-9a | Consider | starter의 `grpc-proto-contract`·`grpc-codegen` 의존이 main에서 안 쓰임 | 남음 | `src/grpc/grpc-spring-boot-starter/build.gradle:21-22` (starter main의 `grpc.contract`·`grpc.codegen` import 0) | W3 | 두 줄과 registry edge 삭제 | +| N-9b | Consider | `requireValid(..., Set.of())`로 advanced 격리 검사가 항상 통과 | 남음 | `src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java:129-133`, `src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java:58,175` | W3 | 파라미터와 `validateAdvancedIsolation` 삭제(격리는 Gradle 방향 게이트가 담당) | +| N-9c | Consider | 문서가 `GrpcStableBuildInvariant`가 runtime에 강제한다고 적지만 호출하는 `requireStableStarterIsClean`의 main 호출자 0 | 남음 | `src/grpc/CLAUDE.md:70`, `src/grpc-advanced/CLAUDE.md:19`, `src/grpc-advanced/grpc-advanced-bootstrap/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuard.java:75` (테스트에서만 호출) | W5 | 두 CLAUDE.md에서 "runtime에 강제" 문구 삭제(또는 guard와 함께 삭제) | +| N-10a | Consider | 같은 한계값(1 MiB/8192)이 여러 곳에 따로 정의되고 정합 검사 없음(server profile bean의 리터럴 복사 포함) | 남음 | `src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcServerProfile.java:70-71`, `src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java:59-60`, `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/policy/GrpcMessageSizeProfile.java:43`, `src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfile.java:80-81,95-96`, `src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java:33` | W3 | 상수를 `GrpcTransportLimits` 한 곳으로, starter bean은 `GrpcServerProfile` 팩토리 재사용, validator에 "method profile ≤ server profile" | +| N-10b | Consider | `GrpcStreamProfile`은 테스트에서만 쓰이고 `GrpcFlowControlPolicy`의 256/8MiB를 복제 | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamProfile.java:40,45` (참조는 `GrpcStreamEnvelopeTest`뿐), `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicy.java:43` | W3 | `GrpcStreamProfile`과 그 테스트 참조 삭제 | +| N-11a | Consider | ledger claim에서 insert 0행 + 조회 실패를 소유 획득으로 처리 | 남음 | `src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java:46-53` (`findById` 빈 결과 → `Optional.empty()` = 소유) | W2 | 0행인데 조회도 비면 `IllegalStateException` | +| N-11b | Consider | `callerFingerprint` 길이 제한이 없어 storageKey가 `VARCHAR(512)`를 넘을 수 있음 | 남음 | `src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java:21,36-37`, `src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V001__create_grpc_operation_ledger.sql:12` | W2 | fingerprint ≤256자 검증 또는 storage key를 해시로 고정 길이화 | +| N-12a | Nit | `GrpcClientMessageDeduplicator`가 "constant space"라지만 outcome이 세션 내내 누적, `endSession`이 O(N) `removeIf` | 남음 | `src/grpc-advanced/grpc-advanced-streaming/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicator.java:13,110-112` | W5 | outcome을 세션별 map으로 나눠 `endSession`은 한 번에 제거, javadoc 정정 | +| N-12b | Nit | `ReactiveGrpcClient.serverStream`은 List를 Flux로 감싸기만 함 | 남음 | `src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcClient.java:50` | W5 | 메서드 삭제 | +| O-1 | Critical | root plugin 적용 시 compose overlay가 없으면 설정 단계에서 빌드 전체 실패 (= Critical #1) | 완료 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/bootstrap/DeveloperBootstrapPlugin.java:79-88` (overlay 확인이 task `doFirst`로 이동). 테스트 `DeveloperBootstrapPluginFunctionalTest.configurationDoesNotRequireComposeFiles`. 커밋 `6d27356e` | - | - | +| O-2 / BUILD-계획-B1 / BUILD-바로할것-3 | Critical | `redis-sdk` CI job이 항상 실패하고 `release-gate`가 그 성공을 요구 (= Critical #2) | 완료 | `.github/workflows/ci-quality-gates.yml:74-100` (release-gate needs에 redis-sdk·`REDIS_RESULT` 없음), `_reusable-gradle.yml` 삭제됨. 커밋 `6d27356e`
BUILD-계획-B1: `_reusable-gradle.yml` 삭제(`6d27356e`), 모든 job이 `./.github/actions/setup-gradle-java` 사용
BUILD-바로할것-3: `ci-quality-gates.yml`에 redis-sdk job·release-gate needs 없음(`208077fd` 기준 `:109,225,240`에서 제거) | - | - | +| O-3a | Required | `verifyNoIgnoredSourcePackages`가 `src/main/java`·`src/test/java`만 검사(testFixtures·integrationTest·systemTest·architectureTest 미검사, sample 제외) | 남음 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java:193-205` | W2 | 각 project의 모든 source set `java.srcDirs`를 수집 | +| O-3b | Required | git 오류(exit 128, 실행 파일 없음)면 검사가 통과(fail-open) | 남음 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesTask.java:70-80` (exit code 미확인), `:117-119` (`IOException` → null → 통과) | W2 | 저장소에 `.git`이 있는데 git이 0/1 외 코드로 끝나거나 실행 불가면 `GradleException` | +| O-3c | Required | optional-platforms의 `ci`가 이 검사를 돌리지 않아 gRPC 소스 미검사 | 남음 | `src/optional-platforms/build.gradle:33-38` | W2 | optional build `ci`에 같은 검사 연결 | +| O-3d | Required | 이 검사의 테스트가 0개 | 남음 | `git grep -l IgnoredSource -- src/build-logic/src/test src/app-bootstrap/src src/build-tools/src/test` 0건 | W4 | TestKit 케이스: integrationTest source set에 ignore 대상 패키지 → 실패, git 실패 → 실패 | +| O-4a | Required | app-bootstrap `test`가 선언 안 된 저장소 파일(runbook, `.env.example`)을 읽어 UP-TO-DATE 거짓 통과 | 완료 | `src/app-bootstrap/build.gradle:276-294` (`docs/**`, `*.example`, `.env*` 등을 `repositoryContractInputs`로 RELATIVE 선언). 커밋 `6d27356e` | - | - | +| O-4b | Required | messaging adapter test가 schema 파일을 sysprop으로 읽으면서 입력 미선언 | 완료 | `src/adapter/outbound/messaging/build.gradle:45-48` (`inputs.file(config/messaging/evidence/build-evidence-manifest-v1.schema.json)`). 커밋 `6d27356e` | - | - | +| O-4c | Required | CI에서 커밋마다 jar manifest version이 바뀌어 test·SpotBugs cache가 항상 miss | 남음 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/release/ReleaseProvenancePlugin.java:29` (`GITHUB_SHA`), `src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java:65` (`Implementation-Version`), normalization 설정 0건 | W3 | 입력 선언이 끝났으므로(O-4a/b) `JavaConventionsPlugin`에 `normalization.runtimeClasspath.metaInf.ignoreAttribute("Implementation-Version")` 추가 | +| O-5a | Consider | 의존성 artifact checksum 검증(`verification-metadata.xml`)이 없음 | 보류 | `src/gradle/`에 `verification-metadata.xml` 없음 | - | 보류: lockfile로 버전은 고정됨, 의존성 갱신마다 metadata 재생성 부담을 지지 않음. 승인자: 저장소 소유자(2026-09-25) | +| O-5b | Consider | included build(build-logic/build-tools)의 plugin 의존성이 lock 없이 `gradlePluginPortal`에서 받아짐 | 남음 | `src/build-logic/settings.gradle:6-10`, build-logic·build-tools에 `gradle.lockfile`·`dependencyLocking` 없음 | W1 | `src/build-logic/build.gradle`에 `dependencyLocking { lockAllConfigurations() }` + lockfile 커밋(build-tools는 비울 예정이면 생략) | +| O-6 | Consider | 프로젝트 좌표 `dev.caskeleton:messaging-kafka` 중복(adapter vs vendored) | 완료 | `src/adapter/outbound/messaging-kafka/build.gradle:14-23` (`group = 'dev.caskeleton.adapter'`, `archivesName = 'adapter-outbound-messaging-kafka'`). 커밋 `6d27356e` | - | - | +| O-7 / BUILD-중복-1 / BUILD-바로할것-1 | Consider | runtime membership 검사가 방향 게이트와 중복 | 완료 | `ca.runtime-membership` 삭제: `src/build-logic/README.md:41`, `git ls-files src/build-logic \| grep RuntimeMembership` 0건. 커밋 `6d27356e`
BUILD-중복-1: `ca.runtime-membership` id·코드 grep 0건(`src/build-logic/build.gradle`), 삭제 표 `src/build-logic/README.md:41`. 컴파일러·방향 task·ArchUnit은 리뷰대로 유지
BUILD-바로할것-1: id·클래스 grep 0건, `src/build.gradle`에 적용 없음 | - | - | +| O-8 / BUILD-중복-2 / BUILD-바로할것-6 | Consider | "지정 테스트가 실행됐고 skip 없음" 검사 구현이 5개 | 남음 | 4개(`ca.strict-qualification`, `ca.conditional-transport-qualification`, `ca.graphql-platform`, `ca.evidence`)는 삭제되고 `strictTestLanes` + `RequiredTestExecution`으로 합쳐짐(`src/build-logic/README.md:42-44`). 남은 1개: `src/build-tools/src/main/java/dev/caskeleton/buildtools/junit/JUnitEvidenceReader.java` (사용처 `src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaEvidenceTestResultLocator.java`뿐)
BUILD-중복-2: 3개 남음: `StrictLaneExecutionTracker`(정본), `RedisTopologyExecutionTracker`(`src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyLanePlugin.java:81`, 소유자 결정으로 유지), `JUnitEvidenceReader`(`src/build-tools/src/main/java/dev/caskeleton/buildtools/junit/`, `JpaEvidenceTestResultLocator`가 사용). RejectSkippedTestsListener·JUnitEvidence·MongoJUnitXml은 grep 0건
BUILD-바로할것-6: `MongoJUnitXml` 삭제. `JUnitEvidenceReader`는 JPA evidence 전용으로 남음(`src/build-tools/src/main/java/dev/caskeleton/buildtools/junit/JUnitEvidenceReader.java`) | W3 | 소유자 결정대로 JPA evidence manifest(`ca.jpa-evidence`, `ca.jpa-qualification`)를 leaf 테스트로 옮길 때 `buildtools/junit/` 패키지를 함께 삭제
BUILD-중복-2: JPA evidence를 폐기할 때 `junit` 패키지(138+76줄)도 같이 삭제
BUILD-바로할것-6: BUILD-O3-2와 같이 삭제 | +| O-9 / BUILD-계획-B6 / BUILD-바로할것-2 | Consider | quarantine job이 테스트 0개를 돌리려고 저장소 전체를 컴파일 | 완료 | `.github/workflows/ci-quality-gates.yml`에 quarantine job 없음, `git grep quarantineTest 6d27356e -- src .github` 0건(README 제외), `src/build-logic/README.md:46`. 커밋 `6d27356e`
BUILD-계획-B6: quarantine grep 0건. jmh는 `me.champeau.jmh`로 3개 leaf에 적용, 수동 실행 전용(`src/build.gradle:11-12` "never part of a gate")
BUILD-바로할것-2: `JavaConventionsPlugin`, `src/build.gradle`, workflow에서 `quarantineTest` grep 0건 | - | - | +| O-10a | Nit | httpclient build가 같은 sysprop 3줄을 7번 반복 | 남음 | `src/adapter/outbound/httpclient/build.gradle:136-139,160-163,171-174,186-189,195-198,214-217,228-231` | W5 | `tasks.withType(Test).configureEach { ... }` 한 블록으로 | +| O-10b | Nit | `user.timezone=UTC`가 leaf build 파일 11개에 28번 반복 | 남음 | `git grep -c user.timezone -- '*.gradle'` (예: `src/adapter/inbound/web/build.gradle` 5번, `src/app-bootstrap/build.gradle` 4번), `JavaConventionsPlugin`에는 없음 | W5 | `JavaConventionsPlugin`에 `withType(Test).configureEach { systemProperty("user.timezone", "UTC") }` 한 번 넣고 leaf 줄 삭제 | +| O-11a | Nit | CLAUDE.md의 `ci` 정의가 실제 task와 다름 | 완료 | `CLAUDE.md:124-127` (ci = leaf checks + architectureCheck + qualityCheck, sample web contract는 mainCheck) = `src/build.gradle:130-148`. `verifyDependencyLocks`는 workflow가 명시 실행(`.github/workflows/ci-quality-gates.yml:50`). 커밋 `6d27356e` | - | - | +| O-11b | Nit | `libs.versions.toml` 주석이 BOM override를 `src/build.gradle`(이유 동반)에 있다고 적지만 실제는 `JavaConventionsPlugin`이고 이유 주석 없음 | 남음 | `src/gradle/libs.versions.toml:27-31`, `src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java:81-83` | W5 | override 옆에 이유(SpotBugs NoClassDefFoundError, CVE) 주석 복원, toml 주석 위치 정정 | +| O-11c | Nit | `netty.version` override가 Boot BOM 값과 같아 효과 없음 | 남음 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java:83` (`4.2.17.Final`). 미확인: Gradle을 실행하지 않아 Boot 4.0.8 BOM의 netty 값은 재확인 못 함(리뷰 근거 인용) | W5 | BOM 값과 같으면 줄 삭제 | +| O-11d | Nit | optional-platforms README에 모듈 개수("18") 기재(no-count 규칙 위반) | 남음 | `src/optional-platforms/README.md:3` | W5 | 개수 문구 삭제 | + +**조사 메모** + +- 1차 Critical 대응: M-1 = Critical #7, M-2a = #8, N-1 = #15, O-1 = #1, O-2 = #2. 모두 `6d27356e`에서 끝남. +- M-2b~f는 Wave 1 진행 기록의 "Kafka truststore/keystore 설정 키 없음" 등 알려진 남은 문제와 같다. M-2a는 끝났지만 같은 Critical의 나머지 결함이 남아 있어서 행을 나눴다. +- M-1 수정 방식: 리뷰는 세 호출자를 `publishEncoded`로 바꾸라고 했다. 실제로는 `DefaultMessagePublisher.encode`가 이미 인코딩된 payload를 그대로 통과시키게 한 곳만 고쳤다. 결함은 없어졌다. +- O-6 수정 방식: 리뷰는 leaf 이름을 바꾸라고 했다. 실제로는 group과 jar 이름만 따로 줬다. 좌표 충돌과 `BOOT-INF/lib` 충돌은 없어졌다. +- N-11 리뷰 일부가 틀렸다: "native insert가 `sha256:` 형식 검증을 안 거친다"는 부분. `GrpcOperationIdentity` 생성자가 claim 전에 prefix를 이미 검사한다(`src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java:29`). 실제로 남은 것은 N-11a/b뿐이다. +- M-2d: 이번에 새로 들어온 `KafkaProducerSecurityTest.theProducerLogsInWithTheProducerCredentialResolvedFromTheProvider`가 `username` = credential id를 정답으로 고정한다. 고칠 때 이 테스트도 바꿔야 한다. +- O-8은 소유자 결정(JPA evidence manifest 폐기)을 실행하면 같이 끝난다. +- M·N·O 원 항목에 없는 알려진 문제 두 가지는 이 표에 행이 없다. 따로 추적해야 한다. (1) API surface 검사가 `mainCheck`로 옮겨져 PR 단계에서 잡히지 않음(예: `src/adapter/outbound/persistence-jpa/build.gradle:260-262`). (2) `messagingSampleContractQualificationTest`(`src/sample-portfolio/build.gradle:196`)가 어떤 집계 task에도 연결되지 않음. 원인은 O-3처럼 게이트에 구멍이 난 종류다. +- gRPC(N-2~N-12)는 `208077fd..6d27356e` 사이에 N-1 관련 파일만 바뀌었다(`git diff --stat 208077fd 6d27356e -- src/grpc src/grpc-advanced`). grpc-advanced도 삭제되지 않았다(「제거된 코드」 표에 행 없음). 나머지는 모두 현재 코드에서 다시 확인했다. + +## 2차 BUILD · TEST + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| BUILD-결론-1 | 권고 | 빌드 코드가 목적에 비해 너무 큼(16,768줄 중 아키텍처 검사 13%) | 남음 | 현재 Java(main+test) build-logic 6,184 + build-tools 4,320 = 10,504줄. O3 목표는 3.5–4k줄 | W3 | BUILD-O3-2·5·6 진행으로 줄인다 | +| BUILD-결론-2 | 권고 | 기능별 증거 검사(E)가 46%로 가장 큰 덩어리 | 남음 | notification·messaging·mongo 플러그인은 삭제됨(`6d27356e`). 남은 E: build-tools `jpa` 2,701+706줄, `junit` 138+76줄, build-logic `redis` 270+151줄(소유자 결정으로 유지) | W3 | JPA evidence 폐기(BUILD-O3-2) | +| BUILD-결론-3 | 권고 | 아키텍처 게이트(방향 task·ArchUnit)는 크기가 적정하니 유지 | 완료 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java:58-223` 방향·순수성·ignored-source 유지, `src/app-bootstrap/build.gradle:45-52` architectureTest 레인 유지 | - | - | +| BUILD-결론-4 | 권고 | 09-16 단계 분리 계획이 절반만 이행됨(2단계 게이트가 PR에서 돎) | 남음 | 루트 `ci`는 leaf check + architecture + quality만(`src/build.gradle:127-132`). 남은 것은 BUILD-계획-B2·B3·B4-17·B4-27·B4-28·B4-30·C 행 | W3 | 해당 행 참고 | +| BUILD-중복-3 | 권고 | API surface 검사 구현이 3개 | 남음 | Notification 정규식 verifier 삭제, `ca.api-surface` 하나로 graphql·notification·jpa·mongo 처리. JPA adopter 검사는 import 정규식 테스트로 따로 남음: `src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/JpaAdopterApiSurfaceTest.java:29-60` | W3 | BUILD-바로할것-7과 같음 | +| BUILD-중복-4 | 권고 | fileserver 제외 규칙이 registry와 dependencyPolicy에서 서로 모순 | 완료 | `ca.dependency-policy` 삭제. fileserver는 선택형 capability `composition-fileserver-platform`으로 바뀜(`src/app-bootstrap/build.gradle:152` 주석 처리된 runtimeOnly 줄) | - | - | +| BUILD-중복-5 | 권고 | 빌드 단계 HS1 구멍: 순수성 task가 application-*만 봄 | 완료 | `ArchitecturePlugin.java:143-147,219-223` `isPure`에 domain-core·shared-contract 추가 | - | - | +| BUILD-중복-6 | 권고 | CI가 아키텍처 게이트를 여러 번 반복 실행 | 남음 | notification-platform·fileserver-certification·jpa-release의 중복 호출은 삭제 확인. 남은 것: `releaseCheck`가 `ci`를 통째로 다시 돌림(`src/build.gradle:148-154`, `.github/workflows/release.yml:60`), `.github/workflows/fileserver-pr.yml:53`의 `:app-bootstrap:architectureTest --tests '*Fileserver*'`(같은 PR의 ci-quality-gates와 중복) | W3 | `releaseCheck`에서 `ci` 의존을 빼고 tag 전용 검사만 남긴다. fileserver-pr의 architectureTest 호출은 삭제한다 | +| BUILD-중복-7 | 권고 | 기능 전용 플러그인 5개가 root에 적용됨 | 남음 | root에 기능 플러그인이 1개 남음: `ca.jpa-qualification`(`src/build.gradle:20`) | W3 | JPA evidence를 폐기할 때 root 적용도 제거(BUILD-O3-2) | +| BUILD-중복-8 | 권고 | ArchUnit이 모든 leaf를 보지 않음 | 남음 | websocket·grpc 어댑터는 이제 포함됨(`src/app-bootstrap/build.gradle:116-128,155` capabilityProjects를 architectureTestRuntimeOnly로). 여전히 제외: optional-platforms build의 `grpc:*`·`grpc-advanced:*` leaf(registry에 등록됨, `src/optional-platforms/build.gradle`의 `ci`는 `verifyCleanArchitectureDependencies`만 실행)와 `sample-portfolio`. 같은 파일 `:111` 주석은 "architecture suite sees every module"이라고 적혀 있음 | W3 | 결정(2026-09-25): sample-portfolio를 app-bootstrap ArchUnit 대상에 다시 넣고, optional-platforms는 Gradle 방향 게이트로 충분하다고 주석·문서에 명시 | +| BUILD-계획-A | 권고 | Track A: 망가진 게이트 24건 | 완료 | 리뷰 시점에 이미 완료. workflow에서 `*CleanArchitectureTest` 필터 grep 0건 | - | - | +| BUILD-계획-B2 | 권고 | release workflow를 1개로 | 남음 | tag `v*`에서 도는 workflow가 여전히 3개: `.github/workflows/release.yml:36`, `jpa-release.yml:14`, `fileserver-certification.yml:28` | W3 | jpa·fileserver의 tag job을 release.yml의 job으로 옮기고, 두 파일의 tag 트리거를 삭제 | +| BUILD-계획-B3 | 권고 | PR에서는 변경된 모듈만 실행 | 남음 | PR마다 모든 leaf의 `:ci` 실행(`.github/workflows/ci-quality-gates.yml:50`). `object-storage-qualification.yml:4`는 경로 필터 없는 `pull_request`로 MinIO 컨테이너를 띄우고, 같은 레인이 `src/adapter/outbound/objectstorage/build.gradle:96-98` `check`에도 걸려 있어 `ci`에서 한 번 더 돎 | W3 | object-storage-qualification에 경로 필터를 달거나 PR 트리거 제거. MinIO 레인은 objectstorage `check`에서 떼어 main 단계로. `ci`의 변경 모듈 한정은 따로 설계 | +| BUILD-계획-B4-15 | 권고 | conditional-transport 레인을 PR에서 main으로 | 완료 | 집계 task(`src/build.gradle:111-118`)가 `mainCheck`(`:143`)에만 연결됨. 각 레인은 leaf `check`에 연결되지 않음 | - | - | +| BUILD-계획-B4-17 | 권고 | API surface를 PR에서 main으로 | 남음 | Gradle 쪽은 완료: `src/build-logic/src/main/java/dev/caskeleton/buildlogic/apisurface/ApiSurfacePlugin.java:96-101`에서 leaf `mainCheck`에 연결. PR에 남은 것: `.github/workflows/notification-platform.yml:84-86` PR job이 `verifyNotificationApiSurface` 실행 | W3 | notification-platform.yml PR job에서 API surface step을 빼고 main push·nightly job으로 옮김 | +| BUILD-계획-B4-18 | 권고 | public-path 스냅샷을 PR에서 main으로 | 완료 | `ci-quality-gates.yml:50`에서 빠짐. `src/build.gradle:142`(mainCheck), `:153`(releaseCheck) | - | - | +| BUILD-계획-B4-22 | 권고 | verifyEnvKeys를 PR에서 main으로 | 완료 | `configContractCheck`(`src/build.gradle:75-79`)는 `mainCheck`(`:139`)에만 연결됨. notification-platform.yml의 호출도 삭제됨 | - | - | +| BUILD-계획-B4-23 | 권고 | graphql stable 레인을 PR에서 main으로 | 완료 | `src/build.gradle:144` mainCheck. graphql `check`에는 연결 없음. jar 검사는 leaf 테스트 `GraphQlProductionClassesTest`로 | - | - | +| BUILD-계획-B4-26 | 권고 | JPA evidence/qualification을 PR에서 main/tag로 | 완료 | jpa `check`와의 연결이 끊김. readiness는 `src/adapter/outbound/persistence-jpa/build.gradle:262-264`에서 mainCheck, candidate는 `.github/workflows/integration-main.yml:130-145`, release는 `jpa-release.yml`. 폐기는 BUILD-O3-2 | - | - | +| BUILD-계획-B4-27 | 권고 | notification API surface·evidence를 PR에서 main으로 | 남음 | API surface는 B4-17. evidence는 leaf 테스트 `NotificationEvidenceVerifierTest`로 옮겨져 `test`, 즉 PR의 `ci`에서 돎(`src/adapter/outbound/notification/build.gradle:79-94` inputs) | W3 | 문서 대조 테스트에 태그를 달아 `test`에서 빼고, `strictTestLanes` 레인(rejectSkipped)으로 만들어 leaf `mainCheck`에 연결 | +| BUILD-계획-B4-28 | 권고 | notification-configuration을 PR에서 main으로 | 남음 | env-keys.yaml과 대조하는 `NotificationEnvironmentRegistryTest`가 composition/notification-platform의 `test`에서 PR로 돎(`src/composition/notification-platform/build.gradle:31-35`) | W3 | B4-27과 같은 방식으로 main 레인에 둠 | +| BUILD-계획-B4-30 | 권고 | mongo-verification을 PR에서 main으로 | 남음 | 플러그인은 삭제. release-contracts.json과 대조하는 `MongoTestLaneContractTest`가 `test`, 즉 PR에서 돎(`src/adapter/outbound/persistence-mongo/build.gradle:224-231`) | W3 | B4-27과 같은 방식 | +| BUILD-계획-B4-34 | 권고 | qualificationCheck/systemTestCheck를 PR에서 main으로 | 완료 | `ci`에서 빠지고 `mainCheck`(`src/build.gradle:140`)로 이동. 참고: `src/app-bootstrap/build.gradle:71-73`의 `check`→`systemTestLaneCheck`(기본 조립 기동 `DefaultCompositionBootTest` 등 4개 클래스)는 `208077fd`에도 있었고 지금도 PR에서 돎 | - | - | +| BUILD-계획-B4-35 | 권고 | sampleWebContractCheck·configContractCheck를 PR에서 main으로 | 완료 | `src/build.gradle:139,141` mainCheck. `ci`(`:127-132`)에는 없음 | - | - | +| BUILD-계획-B5 | 권고 | gate matrix가 release 차단을 실제로 강제하도록 연결 | 해당 없음(코드 삭제) | matrix 파일 삭제(`.github/ci-gate-matrix.yml` 없음, `ci-quality-gates.yml:5-10` 주석) | - | - | +| BUILD-계획-C | 권고 | 컨테이너 이미지 서명 | 남음 | release.yml에 GHCR push·Trivy는 있음. `cosign`/`attest` grep 0건 | W3 | release.yml의 push 다음에 cosign keyless 서명 step 추가(`id-token: write`) | +| BUILD-O3-1 | 권고 | O3: 기능 검사를 소유 leaf 테스트로(notification·messaging·mongo·graphql) | 완료 | build-tools id 6개 삭제(`src/build-tools/build.gradle`에 jpa-evidence·config-contract·jpa-qualification만 남음). leaf 테스트 추가(`6d27356e`): `NotificationEvidenceVerifierTest`, `NotificationEnvironmentRegistryTest`, `MessagingEvidenceSchemaValidatorTest`, `MongoTestLaneContractTest`, `GraphQlProductionClassesTest`. 읽는 파일은 `test` inputs로 선언됨. 실행 단계 문제는 B4-27·28·30 | - | - | +| BUILD-O3-2 | 권고 | O3: JPA evidence manifest(`ca.jpa-evidence`, `ca.jpa-qualification`) 폐기, leaf 테스트로 | 남음 | 소유자가 폐기로 결정함. 코드는 그대로 남아 있음: `src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/` 2,701+706줄, `src/build.gradle:20`, `src/adapter/outbound/persistence-jpa/build.gradle:5,262-264`, `.github/workflows/integration-main.yml:130-145`, `jpa-r2-evidence.yml:34`, `jpa-release.yml:120-125` | W3 | 두 플러그인과 `junit` 패키지를 삭제하고, readiness/release registry 검사만 persistence-jpa 테스트(inputs 선언)로 옮김. workflow의 evidence task 호출도 정리 | +| BUILD-O3-3 | 권고 | O3: verifyEnvKeys 위치 | 완료 | 소유자 결정은 bootstrap에 유지. 현재 `src/app-bootstrap/build.gradle:5`(`ca.config-contract`), `src/build.gradle:75-79`→mainCheck | - | - | +| BUILD-O3-4 | 권고 | O3: redis topology lane을 strict lane으로 흡수 | 완료 | 소유자 결정은 유지. `src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/` 유지, `.github/workflows/redis-sdk-topology.yml` 경로 필터 PR | - | - | +| BUILD-O3-5 | 권고 | O3: build-logic에는 코어·컨벤션·레인 하나만 남김(인벤토리 #11·#18·#19·#20·#31) | 남음 | 남은 비핵심 플러그인(main+test 줄 수): publicpath 288+37, archive 216+46, release 138+71, bootstrap(developer-bootstrap·bootrun-dotenv) 328+203, auxiliary 151+145. leaf 버전은 아직 SHA 버전(`src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java:36-39`) | W3 | public-path는 app-bootstrap approval test로, release-provenance는 `springBoot { buildInfo() }`로 바꾸고, leaf 버전 고정 후 archive-hygiene 삭제. developer-bootstrap은 `scripts/`로, auxiliary는 `jvm-test-suite`로 | +| BUILD-O3-6 | 권고 | O3: build-tools를 비움 | 남음 | 남은 것: `config`(verifyEnvKeys) 488+211줄, `jpa`, `junit`(`src/settings.gradle:6` includeBuild) | W3 | JPA 폐기 후 `ConfigContractPlugin`을 build-logic으로 옮기고 `includeBuild('build-tools')` 삭제. task는 계속 `:app-bootstrap:verifyEnvKeys` | +| BUILD-바로할것-1b | Nit | runtime-membership 삭제 후 남은 주석 문구 | 남음 | `src/sample-portfolio/build.gradle:175`, `.github/workflows/ci-quality-gates.yml:55` "runtime-membership policy" | W5 | 두 주석에서 해당 문구 삭제 | +| BUILD-바로할것-4 | 권고 | `ca.strict-qualification`을 `strictTestLanes` requires + rejectSkipped로 (= O-8) | 완료 | `strictQualification` grep 0건, id 없음. 예: `src/app-bootstrap/build.gradle:61-68` 레인 `requires`+`rejectSkipped` | - | - | +| BUILD-바로할것-5 | 권고 | `ca.evidence` 삭제, conditional-transport를 레인으로 (= O-8) | 완료 | 두 id 모두 없음. leaf별 레인 3개 + app-bootstrap 레인 1개를 루트 `conditionalTransportQualification`(`src/build.gradle:111-118`)이 모음 | - | - | +| BUILD-바로할것-7 | 권고 | API surface 구현을 하나로 | 남음 | `JpaAdopterApiSurfaceVerifier`가 import 정규식 테스트로 바뀌어 남음(`JpaAdopterApiSurfaceTest.java:29-60`, 기준선 `docs/architecture/jpa-adopter-api-surface.txt`) | W3 | 리뷰 권고대로 adopter 목록을 `ca.api-surface` 기준선(`docs/architecture/jpa-api-surface.txt`)에 합치고 테스트 삭제 | +| BUILD-바로할것-8 | 권고 | `dependency-policy`를 Gradle 기본 기능으로 대체 | 완료 | 플러그인 삭제. `componentSelection` 거부 규칙: `src/adapter/outbound/notification/build.gradle:58-64`, `src/adapter/outbound/messaging/build.gradle:36-42`. fileserver는 registry·opt-in으로 처리 | - | - | +| BUILD-바로할것-9 | 권고 | 순수성 task 필터에 domain-core·shared-contract 추가 | 완료 | `ArchitecturePlugin.java:219-223` | - | - | +| BUILD-바로할것-10 | 권고 | workflow에서 아키텍처 게이트 중복 실행 제거 | 완료 | notification-platform(`:81-83` 주석으로 대체), fileserver-certification, jpa-release(`:115-125`)에서 `verifyCleanArchitectureDependencies`·`architectureTest` 호출 삭제. 남은 중복은 BUILD-중복-6 | - | - | +| BUILD-바로할것-11 | 권고 | `ca.test-jvm-agents`를 java-conventions에 합치고 jmh는 표준 플러그인으로 | 완료 | `JavaConventionsPlugin.java:147-170` Mockito agent. `src/gradle/libs.versions.toml:147` `me.champeau.jmh`. 두 id 모두 없음 | - | - | +| BUILD-바로할것-12a | 권고 | `ci`에서 configContractCheck·qualificationCheck·sampleWebContractCheck 제거 | 완료 | `src/build.gradle:127-132` | - | - | +| BUILD-바로할것-12b | 권고 | PR workflow에서 `:verifyPublicPathSnapshot` 제거 | 완료 | `.github/workflows/ci-quality-gates.yml:50` `:ci :verifyDependencyLocks`만 | - | - | +| BUILD-바로할것-12c | 권고 | graphqlStable·conditionalTransport·jpa-candidate·configuration-cache를 main 단계로 | 완료 | `src/build.gradle:143-144` mainCheck. `integration-main.yml:85-128` configuration-cache, `:130-145` jpa-candidate-evidence | - | - | +| BUILD-바로할것-12d | 권고 | notification·jpa·mongo·api-surface 검사를 leaf `check`에서 `mainCheck`로 | 남음 | api-surface·JPA readiness는 mainCheck로 옮김. notification evidence·env registry, mongo lane contract는 leaf `test`(PR)로 옮겨져 여전히 PR에서 돎. 상세는 B4-27·28·30 | W3 | B4-27과 같은 방식 | +| BUILD-바로할것-12e | 권고 | build-logic·build-tools job에 경로 필터 | 완료 | `.github/workflows/build-logic.yml:3-16` paths | - | - | +| BUILD-순수성 | 권고 | domain-core 순수성 구멍(빌드 단계 순수성 검사가 application-*만 봄) | 완료 | `ArchitecturePlugin.java:143-147`(주석·루프), `:219-223`(`isPure`) | - | - | +| BUILD-순수성-이름 | Nit | 순수성 task·클래스 이름이 아직 application-core만 가리킴 | 남음 | `ArchitecturePlugin.java:62` `verifyApplicationCoreDependencyPurity`, `:177` `VerifyApplicationCoreDependencyPurityTask`, `:181` 설명 "this application module" | W5 | `verifyPureModuleDependencies` 같은 이름으로 바꾸고 문서의 명령도 함께 수정 | +| TEST-F-1 | Required | fake가 실제 adapter와 같은 계약으로 묶여 있지 않음 | 남음 | 공통 추상 계약이 있는 포트: DurableOperationStore, GrpcOperationLedger, WorkLogRepository, OutboxLeaseFencing(fake·adapter 양쪽이 상속). 없는 포트: Redis, tus, DeliveryProjection, MessagePublisher, IdempotencyStore, ObjectControlStore(TEST-FAKE 행) | W4 | TEST-FAKE 행마다 계약 추가 | +| TEST-F-2a | Required | `claimsAreDeterministicallyOrdered`가 순서를 확인하지 않음 | 남음 | `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/PostgreSqlWorkClaimContractTest.java:78-86` `isNotEmpty()`만 | W4 | 두 번 claim해 기대 순서를 `containsExactly`로 단언 | +| TEST-F-2b | Required | `batchCreatePersistsEveryItemAtomically`가 원자성을 증명하지 못함 | 완료 | 이름과 단언을 맞춤: `src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogUseCasesTest.java:258-264` `savesAllItemsInOneWriteTransaction`이 `tx.committed()`를 단언 | - | - | +| TEST-F-2c | Required | PII가 없다는 단언이 항상 통과함 | 남음 | 예외 메시지에 원래 PII가 없음: `src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java:131`("provider-failure")→`:174`, `src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:69`("connection refused")→`:72` | W1 | 예외 메시지에 실제 PII를 넣고, 로그에서 빠지는지 단언 | +| TEST-F-2d | Required | "…BeforeIngress" 테스트가 converter 경로를 건너뜀 | 남음 | `src/adapter/inbound/web-notification/src/test/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/NotificationCallbackMvcControllerTest.java:118-126` 컨트롤러를 직접 호출 | W4 | MockMvc로 HTTP 경로를 거쳐 크기 제한을 단언 | +| TEST-F-2e | Required | SLO 버킷 대신 `isNotEmpty()`만 확인 | 남음 | `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/metrics/MetricsContractConfigTest.java:57-70` | W4 | 기대 SLO 경계값 목록을 `containsExactly`로 단언 | +| TEST-F-2f | Required | `assertThat(context).isNotNull()` | 남음 | `SampleApplicationContextTest`는 고쳐짐(`:50-81` 구체 단언). `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingActivationContextTest.java:80-83`은 남음 | W4 | 빈 endpoint로 기동한 뒤 exporter·bean 상태를 단언 | +| TEST-F-2g | Required | 약한 단언 약 1,050개(12%) | 남음 | 미확인: 리뷰 스크립트가 없어 같은 기준으로 다시 잴 수 없음. 참고용 regex 추정: 예외 단언 블록이 2개 이상인 테스트 254개, presence만 확인하는 테스트 약 51개 | W4 | TEST-이행-5 목록부터 작성 | +| TEST-F-3 | Required | 한 테스트에 행동이 여러 개 | 남음 | tus 사례는 해결됨(`src/adapter/inbound/web-fileserver/src/test/java/dev/caskeleton/adapter/inbound/web/fileserver/tus/TusProtocolContractTest.java:150-190`에서 정상 chunk 2와 거부 케이스를 분리). sample은 `// when` 2개 이상인 테스트 0개. 전체로는 예외 단언 블록이 2개 이상인 테스트 254개(regex). 예: `src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapterTest.java:159-179` 행동 5개 | W4 | 손대는 파일부터 `// when` 하나씩으로 나눔 | +| TEST-F-4 | Required | 복사 원본인 sample 테스트가 가장 약함 | 완료 | sample 테스트 275개(regex) 중 문장 3개 이상인 153개가 모두 GWT, 50줄 넘는 테스트 0개. FakeRepo 두 벌은 `InMemoryWorkLogRepository` 하나로(testFixtures). `WorkLogRepositoryAdapterTest.java:84` recursive 비교. `PosterImagePublicationWorkflowTest`는 행동별로 분리. 포트 mock은 TEST-이행-2b | - | - | +| TEST-F-5 | Consider | fake 중복 | 남음 | TransactionPort 구현 파일 26→11개(app-core `DirectTransactionPort` 외에 application-notification 4, fileserver 2, application-core test 4). MessagePublisher 10개 파일, ObjectControlStore 7개(objectstorage), RedisRuntimeClient 8개(`BrokenClient` 4), `extends Clock` 8개 | W4 | application-notification·fileserver에서 `testFixtures(project(':application-core'))`를 쓰고 로컬 TransactionPort fake 삭제. 나머지도 포트마다 testFixtures fake 하나로 | +| TEST-F-6 | Consider | 표 형태 테스트가 파라미터화되지 않음 | 남음 | `src/shared-contract/src/test/java/dev/caskeleton/shared/tracing/TraceParentTest.java` @Test 30개·@ParameterizedTest 0개, `src/shared-contract/src/test/java/dev/caskeleton/shared/error/OperationalErrorTest.java` 32/0, `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java` 55/0. `@ParameterizedTest` 사용 파일 45→63개 | W4 | 세 파일을 `@ParameterizedTest`+`@MethodSource`로 바꿈 | +| TEST-F-7 | Consider | 예외 단언이 when과 then을 한 식에 묶음 | 남음 | `assertThatThrownBy` 2,606회, `catchThrowable` 26→111회, 캐스팅 관용구 18줄→1줄(`MeteredDistributedLockPortTest.java:74`) | W4 | 규칙 3대로 손댈 때만 `catchThrowable`로 바꿈(일괄 변환 안 함). 캐스팅 1줄은 `isInstanceOfSatisfying`로 | +| TEST-F-8 | Consider | 내부 구현을 직접 다루는 테스트 약 170개 | 남음 | 미확인: 리뷰와 같은 기준으로 다시 재지 못함. 참고: reflection 호출 67줄(regex). 컨트롤러 직접 호출 예 `NotificationCallbackMvcControllerTest.java:118` | W4 | 손댈 때 공개 경로(HTTP·포트)로 바꿈 | +| TEST-F-9a | Nit | `assertThat(x.contains(y)).isTrue()` | 남음 | 29줄/14개 파일 → 5줄/4개 파일: `FetchPlanApplierTest.java:58`, `PgRangeTest.java:48-49`, `HibernateBulkDmlExecutorIntegrationTest.java:62`, `JpaLifecycleAssociationContractTest.java:61` | W5 | 컬렉션 대상 3줄만 `assertThat(x).contains(y)`로 바꿈 | +| TEST-FAKE-DurableOperationStorePort | 권고 | fake와 adapter가 같은 계약을 통과 | 완료 | `src/application-core/src/testFixtures/java/dev/caskeleton/application/operation/testkit/DurableOperationStoreContract.java` ← `InMemoryDurableOperationStoreContractTest`, `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapterContractTest.java`. web의 `TestDurableOperationStore` 삭제(fake 1개) | - | - | +| TEST-FAKE-GrpcOperationLedger | 권고 | fake와 adapter가 같은 계약을 통과(FAILED→COMMITTED) | 완료 | `src/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java:124-139` 실패 종료·재commit 거부 케이스 ← `InMemoryOperationLedgerContractTest`, `JpaGrpcOperationLedgerContractIT` | - | - | +| TEST-FAKE-RedisCommandGateway | 권고 | contract가 in-memory에서만 돎 | 남음 | contract 15개 클래스가 `new RedisOperationsFixture()`에 고정됨(`src/adapter/outbound/redis-sdk/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/*ContractTest.java`). `LiveRedisOperationsFixture`는 Live*Test 3개 클래스만 사용. 추상 계약 없음 | W4 | fixture를 추상 메서드로 빼고 live lane subclass 추가 | +| TEST-FAKE-UploadApplicationService | 권고 | tus fake와 실제 서비스가 같은 계약이 아님 | 남음 | fake `src/adapter/inbound/web-fileserver/src/test/java/dev/caskeleton/adapter/inbound/web/fileserver/testkit/InMemoryUploadApplicationService.java`, 실제 `DefaultUploadApplicationService`. 공통 계약 없음. 정상 chunk 2(자기 checksum) 케이스는 fake를 거치는 `TusProtocolContractTest.java:150`에만 있음. 실제 서비스 `src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java:208`은 불일치 케이스만 있음 | W4 | application-fileserver testFixtures에 UploadApplicationService 계약을 만들고 정상 chunk 2 케이스를 포함, fake·실제 둘 다 상속 | +| TEST-FAKE-DeliveryProjectionStorePort | 권고 | fake 3개, 계약 없음 | 남음 | 테스트 구현 3개: `DispatchOutcomeRecorderTest`, `NotificationPlatformNoops`, `ProviderEventLateMatchTest`(`src/application-notification/src/test/...`). adapter는 `JpaDeliveryAttemptStore`. 공통 계약 없음 | W4 | application-notification testFixtures에 fake 하나와 추상 계약을 두고 JPA PG lane에서도 상속 | +| TEST-FAKE-MessagePublisher | 권고 | 인코딩하지 않는 fake가 결함을 숨김 | 남음 | 테스트 구현 10개 파일. relay는 `RecordingOutboxPublisher`(`src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java:477`) 사용. `MessagingAdapterContract`는 harness 계약이지 MessagePublisher fake와 `DefaultMessagePublisher`의 공통 계약이 아님 | W4 | messaging-core-api testFixtures에 MessagePublisher 계약(인코딩 왕복 포함)을 두고 fake와 `DefaultMessagePublisher` 모두 상속 | +| TEST-FAKE-WorkLogRepository | 권고 | sample fake 두 벌이 서로 다르게 동작 | 완료 | `src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/WorkLogRepositoryContract.java` ← `InMemoryWorkLogRepositoryContractTest`, `WorkLogRepositoryAdapterContractTest`(integrationTest) | - | - | +| TEST-FAKE-IdempotencyStorePort | 권고 | fake 여러 개, 계약 없음 | 남음 | fake 4→2개(`src/application-core/src/testFixtures/java/dev/caskeleton/application/idempotency/testkit/InMemoryIdempotencyStore.java`, `IdempotencyExecutorTest` 로컬 구현). adapter는 `PostgreSqlOwnerSafeIdempotencyStore`, `RedisIdempotencyStoreAdapter`. 공통 추상 계약 없음 | W4 | application-core testFixtures에 `IdempotencyStoreContract`를 두고 fake·PG·Redis가 모두 상속. 로컬 구현 삭제 | +| TEST-FAKE-ObjectControlStore | 권고 | 한 모듈 안에 fake 7개, 계약 없음 | 남음 | objectstorage `src/test` 7개 파일(`ManagedMultipartCoordinatorTest` 등). adapter는 `LocalDevObjectControlStore`, `S3ConditionalObjectControlStore`. `ObjectStorageProviderContract`는 provider용이라 대상이 다름 | W4 | ObjectControlStore fake 하나와 계약을 objectstorage testFixtures에 두고 두 adapter도 상속 | +| TEST-FAKE-패턴 | 권고 | static kit 계약 금지, application-core testFixtures를 다른 모듈도 소비 | 남음 | static kit이 남음: `src/application-core/src/testFixtures/java/dev/caskeleton/application/outbox/testkit/LegacyOutboxAppendContract.java:18-52`. app-core testFixtures를 쓰는 leaf는 sample·app-bootstrap·web·persistence-jpa 4개뿐이고, application-notification·application-fileserver는 쓰지 않음 | W4 | `LegacyOutboxAppendContract`를 추상 클래스로 바꾸고, 두 application 모듈에 testFixtures 의존 추가 | +| TEST-제안-1 | 권고 | 이름은 lowerCamelCase 행동 문장이고, 이름의 성질을 단언 | 완료 | `AGENTS.md:155` | - | - | +| TEST-제안-2 | 권고 | @DisplayName은 필요할 때만, 언어는 하나 | 완료 | `AGENTS.md:156-157`(언어 변경은 TEST-DisplayName) | - | - | +| TEST-제안-3 | 권고 | GWT 주석, `// when`은 하나, 예외는 `catchThrowable` | 완료 | `AGENTS.md:158-161` | - | - | +| TEST-제안-4 | 권고 | `@Nested`는 테스트 10개 이상이고 연산 2개 이상일 때만 | 완료 | `AGENTS.md:162` | - | - | +| TEST-제안-5 | 권고 | 단언 규칙 | 남음 | `AGENTS.md:163-166`에 반영됐지만 제안의 `isNotEmpty` 금지, `assertThat(x).contains(y)` 형태, `isInstanceOfSatisfying`가 빠짐 | W5 | 규칙 5에 세 가지를 한 줄로 추가 | +| TEST-제안-6 | 권고 | fake와 mock 기준 | 남음 | `AGENTS.md:167-169`에 반영됐지만 "`thenAnswer` 안에서 assert 금지", "no-op fake는 결과를 단언하지 않는 협력자에만", Object Mother/builder 기준이 빠짐 | W5 | 규칙 6에 두 문장과 builder 기준(인자 6개 이상·필드 2개 이상 변경) 추가 | +| TEST-이행-1 | 권고 | 규칙을 AGENTS.md에 문서화하고 CLAUDE.md에서 가리킴 | 완료 | `AGENTS.md:153-172`, `CLAUDE.md:130-132` | - | - | +| TEST-이행-2a | 권고 | sample-portfolio 전체 이행(계약·TransactionPort fake 하나·Poster 분리) | 완료 | TEST-FAKE-WorkLogRepository, sample이 `DirectTransactionPort`(application-core testFixtures)만 사용, GWT 153/153, TEST-F-4 | - | - | +| TEST-이행-2b | 권고 | sample에서 포트를 Mockito로 대신함(규칙 6 위반) | 남음 | sample 테스트에 포트 mock 7개: `StagedObjectPublicationPort`·`ObjectPublicationHandoffPort`(`src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/poster/PosterImagePublicationWorkflowTest.java:85-86`), `AuditContextPort`, `PosterEventPublisher`, `PosterImageUploadIntentStorePort`, `PosterRepository` ×2 | W4 | sample testFixtures의 hand-rolled fake로 바꿈 | +| TEST-이행-3 | 권고 | 결함을 숨긴 6개 포트에 계약 도입 | 남음 | 2개만 완료(DurableOperation, gRPC ledger). Redis, tus, DeliveryProjection, MessagePublisher가 남음. 공용 TransactionPort fake(`DirectTransactionPort`)는 완료 | W4 | TEST-FAKE 행 참고 | +| TEST-이행-4 | 권고 | 계층별 모범 모듈 하나씩 | 남음 | 문장 3개 이상인 테스트 중 `// when`+`// then`을 갖춘 비율: app-core `operation` 7/13, `idempotency` 0/13, persistence-jpa `outbox` 1/22, `operation`(postgresqlIntegrationTest) 0/12, web `error` 2/30, redis-sdk `lettuce/operations` 0/159 | W4 | 위 6개 패키지를 규칙 1–6으로 다시 씀 | +| TEST-이행-5 | 권고 | 약한 단언 목록 작성(게이트 아님) | 남음 | `docs/`에 목록 문서 없음(grep 0건, 리뷰 문서 제외) | W4 | 모듈별로 presence만·no-throw만 확인하는 테스트 목록을 만들어 소유 모듈 이슈로 | +| TEST-이행-6 | 권고 | 강제 수단 판단: GWT 게이트는 만들지 않고 MethodLength는 보류 | 완료 | `AGENTS.md:171-172` | - | - | +| TEST-DisplayName | 권고 | @DisplayName 언어를 한국어로(소유자 결정) | 남음 | `AGENTS.md:156-157`에 아직 "영어로 통일". sample-portfolio `@DisplayName` 0개(`grep -rn '@DisplayName' src/sample-portfolio \| wc -l` = 0)라 바꿀 대상 0개. 저장소 전체는 영어 2,490개·한국어 1개(`MetricsAlertingContractTest.java:204`) | W4 | AGENTS.md 규칙 2를 "한국어로 통일, 기존 영어는 손댈 때 바꾼다"로 고침. sample은 바꿀 것 없음 | + +**조사 메모** + +- 같은 항목: BUILD-중복-5 = BUILD-바로할것-9 = BUILD-순수성. BUILD-중복-1 = BUILD-바로할것-1. BUILD-중복-3 = BUILD-바로할것-7. BUILD-중복-2는 BUILD-바로할것-4·5·6을 포함함. +- BUILD-바로할것-12d = BUILD-계획-B4-27·28·30. D5에서 검사를 leaf 테스트로 옮길 때 실행 단계를 따로 정하지 않아서 `test`, 즉 PR에서 돎. B4-17과 B4-27의 API surface 부분도 같은 항목. +- BUILD-O3-2 하나로 BUILD-중복-2(`JUnitEvidenceReader`), BUILD-중복-7, BUILD-바로할것-6, BUILD-결론-2가 함께 해결됨. +- TEST-F-1 = TEST-이행-3 = TEST-FAKE 포트 행. TEST-F-9의 DisplayName 부분은 TEST-DisplayName으로 옮김. +- 리뷰가 틀린 것: BUILD-바로할것-8의 `constraints { rejectAll() }` 제안은 동작하지 않음. Spring dependency management가 거부 버전을 덮어써서 `componentSelection`으로 대체함(`src/build-logic/README.md:43`, `src/adapter/outbound/notification/build.gradle:55-57`). 리뷰 자체에도 "미검증"이라고 적혀 있었음. +- 리뷰와 다르게 구현된 것: BUILD-바로할것-5는 "app-bootstrap 레인 1개로"가 아니라 leaf별 레인과 루트 집계 task로 구현됨. skip 금지와 필수 클래스 실행은 똑같이 보장됨. +- TEST-F-9a의 `PgRangeTest.java:48-49`는 도메인 boolean 메서드(`range.contains`)라 Nit 대상이 아님. 실제 대상은 3줄. +- TEST 측정치(메서드 수, GWT 비율, 약한 단언)는 이번에 regex로 잰 추정치라 리뷰 수치와 기준이 다름. 줄 수는 build-logic·build-tools의 `src/**/*.java`만 셈(계획 문서의 10.8k는 다른 기준). + +## 2차 X1 모듈 간 중복 · X2 공통 유틸/전송 경계 + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| X1-지도-Outbox | 권고 | Outbox 저장 모델 3개·append 포트 4개·relay 3개 → 앱 1벌(v1 + fencing), messaging outbox 유지 | 남음 | V2 전부·Debezium 삭제(`docs/capability-status.md:130,175-179`), v1 + `V17__outbox_event_lease_fencing.sql`로 1벌(커밋 `6d27356e`). 남은 것: append 포트 2개(`LegacyOutboxAppendPort`, `OutboxAppendPort`), `CanonicalOutboxAppendAdapter` guard 없음, relay 조립이 app-bootstrap | W3 | X1-#1b(결정) 뒤 append 포트 1개만 남기고, X1-#1c guard 추가, X1-#1i로 relay 조립을 `composition:outbox-relay`로 이동 | +| X1-지도-요청 멱등성 | 권고 | 계약 2개·store 3개·executor 조립 3곳·inbound ledger 3개 → V2 정본, 조립 1곳 | 남음 | v1 삭제·V2 개명, websocket·graphql ledger 삭제(`docs/capability-status.md:226-232`). `new IdempotencyExecutor` 2곳: `IdempotencyProviderSelectionConfig.java:48`, sample `SampleIdempotencyConfig.java:39` | W3 | X1-#2b대로 `composition:idempotency` 신설 후 두 곳을 모듈 하나로 | +| X1-지도-자연키 생성-또는-반환 | 권고 | durable operation을 notification 방식(`ON CONFLICT`)으로, upsert executor 삭제 (= E-2) | 완료 | `DurableOperationJpaRepository.java:48` `ON CONFLICT … DO NOTHING`, `DurableOperationStoreAdapter.java:46-58` 삽입 후 재조회, upsert 실행기 7종 삭제(`docs/capability-status.md:158`), 커밋 `6d27356e` | - | - | +| X1-지도-Inbox / 소비자 dedup | 권고 | app-core inbox 삭제, 나머지(messaging inbox·notification ledger) 유지 | 완료 | `application/inbox/`·`PostgreSqlSameStoreInboxAdapter` 삭제(`docs/capability-status.md:155`), mongo change stream dedup 삭제(`:151`); application-core 패키지 목록에 `inbox` 없음, 커밋 `6d27356e` | - | - | +| X1-지도-lock / lease / fencing | 권고 | 미사용 포트·claim executor 삭제, fencing은 contract kit로 | 남음 | claim executor·`CacheRefreshCoordinationPort`·`LeaseWatchdog` 삭제(`docs/capability-status.md:152-153,157`). 남은 포트 2개 모두 비즈니스 소비자 0: `DistributedLockPort`(참조는 `StartupSafetyValidator.java:51` 존재 검사뿐), `DistributedLeasePort`(참조 0) | W3 | 결정(2026-09-25): lock·lease 유지, 쓰지 않는 claim executor만 삭제, fencing은 계약 테스트로 | +| X1-지도-caller 트랜잭션 guard | 권고 | 9벌 복사 → persistence-jpa helper 1개 (= E-3) | 남음 | persistence-jpa 복사본 4벌 + guard 없는 곳 10개(세부 X1-#4) | W3 | X1-#4 | +| X1-지도-Backoff 계산식 | 권고 | 10개, "full jitter" 뜻 3가지 → shared-contract `Backoff` | 남음 | 앱 쪽 3개 남음(`OutboxBackoffPolicy.java:63-68`, `ExponentialFullJitterBackoff.java:78`, `RetryBackoff.java:42`), JPA 2개 삭제 | W3 | X1-#9 | +| X1-지도-Rate limit | 권고 | web 전용 병렬 타입 세트 삭제 (= I-8 일부) | 완료 | `WebRateLimiter`·web `RateLimitDecision`·`RateLimitFailurePolicy`·`WebMvcThrottleFilter` 삭제(`docs/capability-status.md:99`); 남은 경로 `RateLimitWebConfig.java:22` → `EdgeRateLimitTransportBridge` → shared `EdgeRateLimitPort`, 커밋 `6d27356e` | - | - | +| X1-지도-Admission / in-flight | 권고 | 유지하되 gRPC check-then-increment는 `Semaphore`로 (= N-5) | 남음 | web admission 삭제(`docs/capability-status.md:101`). `grpc/grpc-server/.../GrpcAdmissionController.java:51-60` `get() < max` 후 `incrementAndGet()` 그대로 | W2 | X1-#10a | +| X1-지도-Kafka producer | 권고 | legacy seam·platform 2개, 둘 다 TLS/SASL 없음 → outbox 정리에 포함 | 남음 | platform producer는 Wave 1(1-4)에서 보안 적용. legacy `KafkaSenderAutoConfiguration.java:60-80` `kafkaSeamProducer`에 `security.protocol`·SASL·SSL 설정 없음 | W1 | X1-#1f | +| X1-지도-파일 control plane / canonical JSON | 권고 | 소비자 0인 `FilePublicationPort` plane 삭제, parser 3개 → 1개 | 완료 | publication R1/R2 31개·`FilePublicationPort`·`FileExportPort` 삭제(`docs/capability-status.md:76-77`), 남은 직접 파서 `objectstorage/control/CanonicalJsonReader.java` 1개, 커밋 `6d27356e` | - | - | +| X1-지도-readiness / evidence / API-surface / moduleboundary | 권고 | 카드 스키마·검증기·API-surface gate·moduleboundary 여러 벌 → 하나로 | 남음 | moduleboundary main 3벌 삭제, API-surface는 `ca.api-surface` 하나. 남은 것: 카드 스키마 3개·검증기 3곳, JPA evidence plugin(build-tools `jpa/` 48파일) | W3 | 결정(2026-09-25): O3 — JPA readiness·evidence는 persistence-jpa 테스트로(manifest 폐기), messaging 카드 검증은 messaging leaf로 | +| X1-지도-테스트 fake / contract kit | 권고 | 같은 포트 fake가 모듈마다 따로 → 포트 소유 leaf testFixtures에 contract kit | 남음 | `TransactionPort` fake 21 → 10, kit 4개(DurableOperation·OutboxLeaseFencing·GrpcOperationLedger·sample WorkLogRepository) | W4 | X1-#3a~#3d | +| X1-#1a | Required | Outbox V2 삭제 + v1 claim에 owner+token fencing 이식 | 완료 | `persistence-jpa/.../db/migration/postgresql/V17__outbox_event_lease_fencing.sql`, `OutboxStoreAdapter.java:102-123`(markPublished·markFailed·markDead가 `lease.owner()`·`lease.token()` 조건부 UPDATE), V2 코드·`jpa/outbox-storage`·`jpa/outbox-polling` 삭제(`docs/capability-status.md:175-179`), 커밋 `6d27356e` | - | - | +| X1-#1b | Required | append 포트를 `OutboxAppendPort` 하나로, legacy는 cutover 후 삭제 | 남음 | `OutboxAppendPort` main 소비자 0(구현 `CanonicalOutboxAppendAdapter`뿐). `LegacyOutboxAppendPort` 소비자 4곳: `SubmitDurableOperationUseCase.java:56`, sample `PosterEventPublisher.java:25`·`PosterImagePublicationEventPublisher.java:12`·`CreateWorkLogUseCase.java:42`. canonical 경로는 `IntegrationEventEncoderPort` 구현이 필요한데 템플릿은 주지 않음(`src/messaging/CLAUDE.md:83-89`, main 구현 0) | W3 | 결정(2026-09-25): canonical 통일(S1-#2b와 같은 작업) | +| X1-#1c | Required | `CanonicalOutboxAppendAdapter`에 caller 트랜잭션 guard 없음 (= E-3) | 남음 | `CanonicalOutboxAppendAdapter.java:36-75` `append`가 트랜잭션 확인 없이 `repository.save` | W3 | X1-#4 helper를 `append` 첫 줄에서 호출(1곳) + 트랜잭션 없이 부르면 거부되는 테스트 | +| X1-#1d | Required | canonical 이벤트가 v1 claim을 타며 aggregate 순서·tenant 범위를 잃음 (= E-5) | 남음 | `PostgreSqlOutboxClaimRepository.java:15-29` FIFO gate가 `aggregate_id`·`occurred_at`만 사용, `tenant_scope`·`aggregate_sequence`·`event_index` 미사용 | W2 | X1-#1b에서 canonical 경로를 남기면: canonical row(`contract_id IS NOT NULL`) gate를 `(tenant_scope, aggregate_type, aggregate_id)` + `(aggregate_sequence, event_index)` 순서로, `H2OutboxClaimRepository`도 동일 | +| X1-#1f | Required | legacy Kafka producer에 TLS/SASL 없음 (Critical #8 = M-2와 같은 문제) | 남음 | `adapter/outbound/messaging-kafka/.../KafkaSenderAutoConfiguration.java:60-80` producer config에 bootstrap·serializer·acks·timeout만 | W1 | `KafkaAdapterSettings`에 security 블록(protocol·SASL·truststore) 추가 후 `kafkaSeamProducer` config에 반영, 또는 X1-#1b 결정으로 seam 자체 삭제 | +| X1-#1g | Required | `src/messaging/CLAUDE.md`에 "앱은 `messaging_outbox`를 쓰지 않는다" 명시 | 남음 | `grep -n messaging_outbox src/messaging/CLAUDE.md` → 0건 | W5 | `src/messaging/CLAUDE.md` MSG-015 절(:60-89)에 한 줄 추가 | +| X1-#1h | Required | fencing 시나리오를 contract kit로 fake·실제 adapter 양쪽에서 실행 | 완료 | testFixtures `OutboxLeaseFencingContract`를 `InMemoryOutboxStoreLeaseFencingContractTest.java:9`와 `PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest.java:45`가 상속, 커밋 `6d27356e` | - | - | +| X1-#1i | 권고 | outbox relay 조립이 app-bootstrap에 남음(소유자 결정: `composition:*`로 이동) | 남음 | `app-bootstrap/.../autoconfigure/outbox/OutboxConfig.java:44-118`이 `PublishPendingOutboxEventsUseCase`·`OutboxRelayScheduler` 생성, `AutoConfiguration.imports:2`. persistence-jpa로는 `AdapterBoundaryArchitectureTest.java:207` `PERSISTENCE_DOES_NOT_DEPEND_ON_APPLICATION_SERVICES` 때문에 못 옮김 | W3 | 새 leaf `composition:outbox-relay`(edge: application-core, adapter-outbound-support) 등록, `OutboxConfig`·`OutboxSettings`·`OutboxRelayScheduler`·`OutboxMetrics`·`OutboxLeaderElectionToken`·`OutboxCanonicalTransportRequirementValidator` 6개 + 테스트 5개 이동, app-bootstrap은 `runtimeOnly` 한 줄 | +| X1-#2a | Required | 멱등성 V2를 정본으로, v1 삭제, 이름에서 `V2` 제거, sample을 V2로 | 완료 | `application/idempotency/IdempotencyExecutor.java`·`IdempotencyStorePort.java`(V2 개명), v1 모델·JPA v1 store·bootstrap v1 조립 삭제(`docs/capability-status.md:226-229`), sample `PublishPosterImageUseCase`가 `IdempotencyExecutor` 사용. v1 완료 기록 결함(= A-8)도 함께 소멸. 커밋 `6d27356e` | - | - | +| X1-#2b | Required | executor 조립 1곳, provider는 store bean만 (= G-11 일부) | 남음 | Redis·PG provider는 store만 기여(`RedisIdempotencyConfig`·`PostgreSqlIdempotencyStoreConfig`에 executor 생성 0). executor 생성 2곳: `IdempotencyProviderSelectionConfig.java:48`, sample `SampleIdempotencyConfig.java:39`(같은 키·기본값을 `Binder`로 복사) | W3 | 새 leaf `composition:idempotency`(edge: application-core, adapter-outbound-support)로 `IdempotencyProviderSelectionConfig`·`IdempotencySettings` + 테스트 2개 이동, app-bootstrap·sample 둘 다 `runtimeOnly`; `SampleIdempotencyConfig`는 executor bean 삭제(Clock·`@EnableScheduling`만 유지) | +| X1-#2c | Required | websocket `CommittedResultLedger`(inbound가 가진 저장 SPI) 삭제 | 완료 | websocket command ledger 일체 삭제(`docs/capability-status.md:230`), websocket main 참조 0, 커밋 `6d27356e` | - | - | +| X1-#2e | Required | `DurableOperationStoreAdapter`를 `ON CONFLICT` 방식으로, upsert executor 삭제 (= E-2) | 완료 | X1-지도-자연키 행과 같은 근거(`DurableOperationJpaRepository.java:48`, `docs/capability-status.md:158`), 커밋 `6d27356e` | - | - | +| X1-#3a | Required | `TransactionPort` fake를 application-core testFixtures 1개로 | 남음 | testFixtures `DirectTransactionPort` 생김(사용 14파일), sample 6개는 0으로. 남은 자체 fake 10개: application-core test 4(`SubmitDurableOperationUseCaseTest`, `OutcomeAwareRelayTest`, `PublishPendingOutboxEventsUseCaseTest`, `TransactionPortTest`), application-notification 4(`PlatformFakes`, `AdminOperationExecutorTest`, `CallbackIngestionAtomicityTest`, `ProviderEventLateMatchTest`), application-fileserver `DirectTransactions`, composition `FileserverAssemblyFixture` (측정: 테스트 source set에서 `git grep -E "implements (\w+\.)*TransactionPort\b\|new (\w+\.)*TransactionPort\(\)"`) | W4 | 그냥 실행만 하는 fake는 `DirectTransactionPort`로 교체(application-notification·application-fileserver·composition에 application-core testFixtures 의존 추가), 호출 기록이 필요한 outbox relay fake만 유지 | +| X1-#3b | Required | 포트별 contract kit를 소유 leaf testFixtures에 두고 fake와 실제 adapter가 같이 실행 | 남음 | 있음: `DurableOperationStoreContract`, `OutboxLeaseFencingContract`, `GrpcOperationLedgerContract`(grpc-core-api testFixtures), sample `WorkLogRepositoryContract`. 없음: `IdempotencyStorePort`(testFixtures `InMemoryIdempotencyStore`, `RedisIdempotencyStoreAdapter`, `PostgreSqlOwnerSafeIdempotencyStore`가 공통 계약 없이 따로 테스트), `RecipientLeaseStorePort`(PG 전용 `PostgreSqlRecipientLeaseFencingIntegrationTest`만), tus upload, Redis gateway | W4 | application-core testFixtures `IdempotencyStoreContract`(구현 3개 상속), application-notification testFixtures `RecipientLeaseStoreContract`(fake + `JpaRecipientLeaseStore`)부터 추가(`AGENTS.md:218` 기준 5) | +| X1-#3c | Required | `ObjectControlStore` fake 7개 → `@TempDir` 위 `LocalDevObjectControlStore` | 남음 | objectstorage 테스트 source set에 `implements ObjectControlStore` 7개 | W4 | fake 7개를 `LocalDevObjectControlStore`(`@TempDir`)로 교체 | +| X1-#3d | Required | `DistributedLockPortContractTest`가 테스트 안에서 만든 fake를 검증 | 남음 | `application-core/src/test/.../lock/DistributedLockPortContractTest.java:46` `FakeDistributedLockPort` | W4 | X1-#6b 결정에 따라 테스트 삭제, 또는 testFixtures 추상 계약으로 바꿔 `LockRegistryDistributedLockAdapter`가 상속 | +| X1-#4 / S2-#6b | Required | caller 트랜잭션 guard 9벌 복사 → persistence-jpa `CallerTransaction.require` 하나 (= E-3) | 남음 | 복사본 4벌: `OutboxStoreAdapter.java:131`, `DurableOperationStoreAdapter.java:170`, `JpaLiveEventReplayAdapter.java:164`, `IdempotencyCapabilityGuard.java:93`(읽기 전용 변형 `JpaStreamScope.java:28` 별도). guard 0: `CanonicalOutboxAppendAdapter`, notification JPA store 9개(`persistence/notification/platform/*Store.java`, `@Transactional`도 0). messaging 2벌(`JdbcOutboxRepository.java:229`, `JdbcInboxRepository.java:102`)은 vendored라 유지
S2-#6b: `persistence-jpa/.../outbox/OutboxStoreAdapter.java:131`, `operation/DurableOperationStoreAdapter.java:170`, `liveevent/JpaLiveEventReplayAdapter.java:164`, `postgresql/idempotency/IdempotencyCapabilityGuard.java:93`; `outbox/CanonicalOutboxAppendAdapter.java`는 guard 0(조용한 dual-write) | W3 | persistence-jpa `transaction` 패키지에 `CallerTransaction.require(String op)` 추가, 복사본 4곳 교체 + `CanonicalOutboxAppendAdapter.append`와 notification store 9개의 쓰기 메서드에 호출 추가
S2-#6b: persistence-jpa에 `CallerTransaction.require(op)` 하나 두고 4곳 교체 + `CanonicalOutboxAppendAdapter.append`에 적용 | +| X1-#5 | Required | web 병렬 rate-limit 타입·throttle filter 삭제 (= I-8 일부) | 완료 | `docs/capability-status.md:99-100`, `WebRateLimiter`·`WebMvcThrottleFilter`·`ThrottleProblemWriter` main 참조 0, 남은 경로 `RateLimitWebConfig.java:22` → `EdgeRateLimitPort`, 커밋 `6d27356e` | - | - | +| X1-#6a | Required | 범용 claim executor(`PostgreSqlWorkClaimExecutor`·`WorkQueue*`) 삭제 | 완료 | `docs/capability-status.md:157`, main 참조 0, 커밋 `6d27356e` | - | - | +| X1-#6b | Required | lock과 lease 중 하나만 남김 | 남음 | `DistributedLockPort`(구현 `LockRegistryDistributedLockAdapter`, 참조는 `StartupSafetyValidator.java:51` 존재 검사뿐), `DistributedLeasePort`(구현 `RedisDistributedLeaseAdapter`, 소비자 0). `CacheRefreshCoordinationPort`는 삭제(`docs/capability-status.md:152`). `LeaseAttempt`·`IdempotencyClaimAttempt` 같은 구조 그대로 | W4 | 결정(2026-09-25): lock·lease 둘 다 유지(S1-#3b와 같은 작업) | +| X1-#6c | Required | app-core inbox 삭제로 `IdempotencyOwner`·`InboxOwner` 중복 record 해소 | 해당 없음(코드 삭제) | `application/inbox/` 삭제(`docs/capability-status.md:155`) | - | - | +| X1-#6d | Required | `ClaimFencingContract` kit를 application-core testFixtures에 두고 row lease store마다 실행 | 남음 | outbox 전용 `OutboxLeaseFencingContract`만 있음. durable operation(`claimNext`·`heartbeat`), notification `JpaRecipientLeaseStore`는 공통 fencing kit 없음 | W4 | `OutboxLeaseFencingContract`의 "밀려난 쪽 종결 쓰기는 0건" 시나리오를 범용 `ClaimFencingContract`로 올리고 durable operation·recipient lease store 2곳에 상속 추가 | +| X1-#6e | Required | notification `recipients.save`가 lease 확인 없이 씀 (= B-5) | 남음 | `application-notification/.../dispatch/DispatchOutcomeRecorder.java:135` `recipients.save(updated)` | W2 | projection 뒤 recipient를 다시 읽고 recorder 소유 필드만 `saveHeldBy(lease)`로 기록 + late-match 회귀 테스트 | +| X1-#6f | 권고 | shared-contract `OperationalRecordStorePort`(CAS 저장 포트) 사용처 0 — 리뷰 권고 "미사용분 삭제" 적용 대상 | 남음 | `shared-contract/.../opstore/OperationalRecordStorePort.java:19`, 같은 패키지 `OperationalRecord`·`OperationalRecordConflictException` 포함 구현·호출·테스트·문서 참조 0(`git grep -w OperationalRecordStorePort` → 자기 파일뿐) | W3 | `shared-contract/src/main/java/dev/caskeleton/shared/opstore/` 3개 삭제, `docs/capability-status.md` 제거 표에 한 줄 | +| X1-#7a | Required | readiness 카드 스키마 3개·검증기 3개, family별 evidence plugin | 남음 | 카드: `src/config/jpa/readiness-cards.yaml`(kebab JSON), `src/config/messaging/readiness-cards.yaml`(camelCase), `docs/registries/object-storage-readiness.yaml`(snake_case). 검증기: build-tools `JpaReadinessRegistryValidator.java`, app-bootstrap `MessagingCapabilityRegistryContractTest.java`, objectstorage `ObjectStorageReadinessRegistryTest.java`. messaging·notification·mongo evidence plugin은 leaf 테스트로 이동, JPA evidence는 build-tools `jpa/` 48파일에 남음(계획서 진행 기록 Wave 5 "남은 설계 결정") | W3 | 결정(2026-09-25): O3 방향(X1-지도-readiness와 같은 작업) | +| X1-#7b | Required | API-surface gate 3개 → `ca.api-surface` 하나 | 완료 | notification·persistence-jpa·persistence-mongo·graphql 모두 `id 'ca.api-surface'`(`adapter/outbound/notification/build.gradle:4`, `persistence-jpa/build.gradle:7`), `ca.notification-api-surface`·`verifyJpaAdopterApiSurface` 삭제. JPA adopter import 검사는 leaf 테스트 `JpaAdopterApiSurfaceTest`, 커밋 `6d27356e` | - | - | +| X1-#7c | Required | web·graphql·websocket main의 moduleboundary 3벌 → ArchUnit | 완료 | 3벌 삭제(`docs/capability-status.md:80,93,113`), graphql 규칙 2개는 `GraphQlTransportBoundaryArchitectureTest.java`로, 커밋 `6d27356e` | - | - | +| X1-#8a | Consider | 소비자 0인 `FilePublicationPort` plane 삭제, parser 3→1, 경계 결정 문서화 | 완료 | `docs/capability-status.md:76-77`, fileserver `FileserverControlRecordCodec`·`LocalPublicationJournalCodec` 삭제, 남은 파서 `CanonicalJsonReader.java` 1개, `docs/storage-capability-boundary.md` "Decision rule" 절, 커밋 `6d27356e` | - | - | +| X1-#9 | Consider | Backoff 계산식 10개, "full jitter" 뜻 3가지 → shared-contract `Backoff` | 남음 | JPA `BackoffCalculator`·`TransactionRetryBackoff`, httpclient `BackoffStrategy` 삭제. 앱 쪽 3개: `OutboxBackoffPolicy.java:63-68`(이름은 full jitter인데 `base·2ⁿ + U(0,base)`, 상한 없음), `ExponentialFullJitterBackoff.java:78`(`U(0,capped]`), notification `RetryBackoff.java:42`. mongo·messaging·grpc는 자체 유지 대상 | W3 | shared-contract에 `Backoff(base, max, Jitter)`(stdlib만) 추가, 사용처 2곳(`OutboxBackoffPolicy`, `ExponentialFullJitterBackoff`) 교체; notification은 application-notification→shared-contract edge를 registry에 추가할 때만 | +| X1-#10a | FYI | `GrpcAdmissionController` check-then-increment → `Semaphore.tryAcquire` (= N-5) | 남음 | `grpc/grpc-server/.../GrpcAdmissionController.java:51-60` | W2 | `inFlight`·`queued`를 `Semaphore` 또는 `updateAndGet` CAS로, 동시 호출 수 > 한도 테스트 1개(optional build) | +| X1-#10b | FYI | SHA-256 헬퍼 65벌, notification `MessageDigestPort`는 과한 추상화 → 흡수 | 남음 | `application-notification/.../dispatch/MessageDigestPort.java` + `Sha256MessageDigestAdapter.java` 그대로. 헬퍼 수는 X2-P1-5 | W3 | X2-P1-5와 같이. `MessageDigestPort`는 application-notification이 shared-contract edge를 가져야 흡수 가능 → edge 추가 후 포트·adapter 2개 삭제 | +| X2-P1-1a | Required | S3 시크릿이 `System::getenv` 고정 → `SecretSourcePort` bridge | 남음 | `objectstorage/.../s3/S3ObjectStorageProviderContribution.java:41` 기본 생성자가 `System::getenv` | W1 | S3 contribution에 `SecretSourcePort`를 주입해 `secretSource::resolve`(Redis `RedisCapabilityConfig.java:66-67` 방식), `System::getenv` 기본값 제거 | +| X2-P1-1b | Required | Mongo credential bridge 없음(기본 `unconfigured()`) | 남음 | `persistence-mongo/.../security/MongoCredentialResolver.java:31`; persistence-mongo 밖 `MongoCredentialResolver` bean 0; persistence-mongo는 registry edge 0이라 `SecretSourcePort`를 못 봄 | W1 | modules.json에 persistence-mongo→application-core edge 추가 후 Mongo auto-config에 `MongoCredentialResolver` bridge bean 1개(`secretSource::resolve`) | +| X2-P1-2a | Required | websocket prod 판정 직접 구현(`Prod`·공백 미인식) (= A-2) | 해당 없음(코드 삭제) | `WebSocketPlatformSafetyConfiguration`·`app.websocket.platform.*` 삭제(`docs/capability-status.md:186`), websocket main에 `"prod"` 문자열 0 | - | - | +| X2-P1-2b | Required | httpclient `profile/RuntimeEnvironment`가 정본과 이름이 같음(Nit) | 남음 | `adapter/outbound/httpclient/.../profile/RuntimeEnvironment.java` (httpclient 안 참조 파일 4개 + 정본 import 1개) | W5 | `HttpClientHardening` 등으로 개명, 참조 4파일 수정 | +| X2-P1-3a | Required(문서) | capability settings 규칙(strict 바인딩 + compact constructor)을 root 문서에 | 완료 | `AGENTS.md:216` capability 완료 기준 4, 커밋 `6d27356e` | - | - | +| X2-P1-3b | Required | gRPC adapter strict prefix `ca-skeleton.grpc`가 벤더 `ca-skeleton.grpc.platform`과 겹침 | 남음 | `adapter/inbound/grpc/.../GrpcServerSettings.java:17`(`ignoreUnknownFields = false`, `platform` 필드 없음) vs `grpc-spring-boot-starter/.../GrpcPlatformProperties.java:19`. 미확인: 두 스택 동시 기동 실패는 실행 안 함 | W2 | adapter prefix를 `ca-skeleton.grpc.server` 등으로 분리(설정 키·env key·README 갱신) | +| X2-P1-3c | Required | 오타 키 거부가 일부 capability에만 적용 | 남음 | strict 바인딩 4곳(fileserver·httpclient `StrictSettingsBinder`, `GrpcServerSettings.java:17`, `GrpcPlatformProperties.java:19`) / main `@ConfigurationProperties` 54파일(`git grep -l "@ConfigurationProperties" -- 'src/**/src/main/java/**'`) | W3 | `AGENTS.md:216` 기준대로 capability 모듈(cache-redis, persistence-jpa, persistence-mongo, messaging, notification, objectstorage, graphql, websocket) settings를 `StrictSettingsBinder`로 바인딩 | +| X2-P1-4a | Consider | web `cursor/CursorCodec`(dev key 하드코딩) 삭제 | 완료 | `docs/capability-status.md:94`, `HmacWebCursorCodec`도 삭제(`:97`), 커밋 `6d27356e` | - | - | +| X2-P1-4b | Consider | 서명 계층 하나(inbound에서 서명, persistence는 typed keyset), 남으면 공용 서명 헬퍼 | 남음 | HMAC codec 7 → 4: graphql `HmacGraphQlCursorCodec`, persistence-jpa `SignedJsonCursorCodec`, persistence-mongo `MongoKeysetCursorCodec`, 벤더 `GrpcResumeTokenCodec`. 앱 쪽 3개 모두 production 생성 0(라이브러리 API) | W3 | 결정(2026-09-25): Wave 3 라이브러리 유지 결정을 따름 — 서명 codec 유지, shared-contract에 sign/verify 헬퍼 하나로 중복 제거 | +| X2-P1-5 | Consider | SHA-256 보일러플레이트 → shared-contract `Sha256` | 남음 | `MessageDigest.getInstance` main 72곳/68파일(`208077fd`) → 40곳/36파일(현재, `git grep -c 'MessageDigest.getInstance' -- 'src/**/src/main/java/**'`). shared-contract에 `Sha256` 없음(app-core `application/messaging/contract/Sha256.java` 값 타입만) | W3 | shared-contract `Sha256.hex(String)`·`digest(byte[])` 추가, edge 있는 25파일 교체(objectstorage 12, sample 3, graphql 2, cache-redis 2, fileserver 2, notification 2, persistence-jpa 2); mongo 3·application-objectstorage 2(edge 없음)와 벤더 5는 유지 | +| X2-P1-6 | Consider | JSON 문자열 escape 동작 3가지 | 남음 | fileserver 사본 삭제. 남음: `OutboxEnvelopeJson.java:44-63`, sample `PosterEventPublisher.java:89-101`·`WorkLogReservedIntegrationEventMapper.java:56-68`(RFC 8259), sample `PosterImagePublicationEventPublisher.java:76-78`(`\`·`"`만 → 제어문자가 들어오면 잘못된 JSON), redis-sdk `JsonEnvelopeFraming.java:166-183`·`CanonicalJsonWriter`(유지 대상) | W3 | sample 3곳을 Jackson 직렬화(또는 sample 안 helper 1개)로 통일해 `PosterImagePublicationEventPublisher` 제어문자 누락 수정. 앱 쪽 사본은 `OutboxEnvelopeJson` 1개뿐이라 공용 `JsonStrings`는 만들지 않음 | +| X2-P1-7 | Consider | 주입된 Clock을 우회하는 시간 조회 | 남음 | `RoutingObjectMutationAdapter.java:60` `clock` 필드가 있는데 `Instant.now()` 12곳(:128-349), 기본 생성자 `Clock.systemUTC()`(:64); objectstorage 설정 5곳(`ObjectStorageBindingCompiler.java:40`, `ObjectStorageCapabilityConfig.java:110`, `ObjectStorageScanMaintenanceConfig.java:23`, `S3ObjectStorageProviderContribution.java:33,35`); `MvcStreamWriter` 5, `LiveEventStompBroadcaster`·`MongoTenantClientRegistry`·`KeyOperationRequests` 각 1. main 전체 `Instant.now()` 26곳/11파일, `Clock.systemUTC()` 11곳/10파일 | W3 | objectstorage 설정 5곳에 `Clock` bean 주입, `RoutingObjectMutationAdapter` 12곳을 `clock.instant()`로; 나머지 4파일은 생성자로 Clock 주입 | +| X2-P2-1a | Required | `VALIDATION_FAILED`가 Envelope 400 vs problem-catalog 422 (= I-9) | 해당 없음(코드 삭제) | `problem-catalog.yaml`·`ProblemCatalog` 삭제(`docs/capability-status.md:104`), 남은 정의 `OperationalError.java:15` 400 하나 | - | - | +| X2-P2-1b | Required | budget 경로가 `URI_TOO_LONG`·JSON 깊이 초과를 다른 코드·problem+json으로 | 해당 없음(코드 삭제) | `WebMvcBudgetFilter`·`BudgetProblemMapper` 삭제(`docs/capability-status.md:105`) | - | - | +| X2-P2-1c | Required | `ProblemCode`·`ProblemCatalog` 동의어 어휘 제거 | 완료 | `docs/capability-status.md:104`, `git grep -w ProblemCode -- 'src/**/src/main/**'` → 0, 커밋 `6d27356e` | - | - | +| X2-P2-1d | Required | GraphQL `retryable`을 코드가 아니라 category에서 계산 | 남음 | `GraphQlWireError.java:73` `category.retryable()`, `GraphQlWireErrorMapper.java:79-85` `fromApiError`가 `code.retryable()` 안 씀, `GraphQlErrorCategory.java:13-28` | W3 | `GraphQlWireError.of`에 retryable 인자 추가, `fromApiError`는 `code.retryable()`, 플랫폼 자체 코드만 category 기본값 | +| X2-P2-1e | Required | client-safe 메시지 표가 전송마다 다름(web 코드별 영어, GraphQL category별 한국어) | 남음 | `ClientSafeErrorMessages.java:14-40`, `GraphQlWireErrorMapper.java:105-111` | W3 | 코드별 메시지 표 하나를 shared-contract `ApiErrorCode` 옆에 두고 web·graphql 2곳이 사용, 언어 하나로 | +| X2-P2-1f | Required | gRPC trailer에 `retryable` 없음 | 남음 | `GrpcStatusMapper.java:22-27`(키 `error-code`·`error-category`뿐), `trailersFor` :51 | W3 | `error-retryable` trailer 키 추가(`code.retryable()`) | +| X2-P2-2a | Required | shared 예외가 `ApiErrorCarrier`를 구현하지 않아 web에서만 제대로 매핑 | 남음 | `MappingException.java:11`, `AdapterDisabledException.java:13`, `IdempotencyInFlightException.java:8`, `IdempotencyRequestMismatchException.java:9` 모두 평범한 `RuntimeException`(ScopeMissing은 삭제). web 타입별 handler `GlobalExceptionHandler.java:77,89,178,190`; GraphQL `GraphQlWireErrorMapper.java:66`·gRPC `GrpcExceptionHandlingInterceptor.java:121`은 carrier만 봄. V2에서 생긴 `IdempotencyUnavailableException`·`IdempotencyRecoveryRequiredException`은 어느 전송에도 매핑 없음 | W3 | 4종이 `ApiErrorCarrier` 구현(`MAPPING_FAILED`, `ADAPTER_DISABLED`, `IDEMPOTENT_IN_FLIGHT`, `IDEMPOTENT_REQUEST_MISMATCH`), web handler 4개를 carrier 분기 1개로 교체; V2 예외 2종도 코드를 정해 같은 방식 | +| X2-P2-2b | Required | `IllegalArgumentException`: web 400, GraphQL·gRPC `INTERNAL_ERROR` | 남음 | `GlobalExceptionHandler.java:101-106` → `BAD_PARAMETER` 400; GraphQL·gRPC는 carrier가 아니면 INTERNAL | W3 | 결정(2026-09-25): `IllegalArgumentException`은 모든 전송에서 400(GraphQL `BAD_USER_INPUT`, gRPC `INVALID_ARGUMENT`) — web 현재 동작 유지 | +| X2-P2-3a | Required | 같은 servlet 앱에서 Envelope와 fileserver problem+json 혼재(소유자 결정: Envelope 하나) | 남음 | `FileserverExceptionHandler.java:44` `APPLICATION_PROBLEM_JSON`, `FileserverProblem`·`FileserverProblemFactory`·`FileserverProblemTitles`·`BatchUploadItemProblem`. `FileserverErrorCode`는 이미 `ApiErrorCode`인데 `UNAUTHENTICATED`·`PRECONDITION_FAILED`·`UNSUPPORTED_MEDIA_TYPE`가 `OperationalError`와 이름 중복(`FileserverErrorCode.java:26,35,38`). budget·WebFlux 쪽은 삭제로 해소 | W3 | `FileserverExceptionHandler`가 web `ErrorResponseFactory.envelope`로 응답, `FileserverProblemHeaders`(Retry-After·Content-Range·tus 헤더)는 유지, problem 타입 4개 삭제, 이름 중복 3개는 `OperationalError` 사용 | +| X2-P2-3b | Required | Draft-12 upload offset 불일치 응답이 규격 problem 문서 | 남음 | `Draft12UploadController.java:136-143` problem+json, `Draft12OffsetProblem.java` type `…/http-problem-types#mismatching-upload-offset` | W3 | 결정(2026-09-25): Draft-12 offset 불일치 problem 문서는 프로토콜 예외로 유지(tus 헤더와 같은 취급), 예외 목록을 문서에 명시 | +| X2-P2-4 | Required | 한 요청에서 traceparent를 두 규칙으로 파싱 (= I-4 영역) | 남음 | `WebMvcRequestIdFilter.java:49-50,113-118` 정규식(version 무시, 전부 0인 trace-id 허용) vs `RequestLoggingFilter.java:105-106` `TraceParent.parse`. WebFlux 사본은 삭제. request id는 `RequestLoggingFilter.java:59-60`이 `WebRequestId`를 재사용하도록 바뀜 | W3 | `WebMvcRequestIdFilter`의 `TRACEPARENT` 정규식을 지우고 shared-contract `TraceParent.parse` 사용(1곳) | +| X2-P2-5 | Consider | correlation이 HTTP 밖으로 안 이어짐, `MdcKeys`가 web에 갇힘 | 남음 | `adapter/inbound/web/.../observability/MdcKeys.java`(사용 5파일, web-fileserver 포함), `MDC.put`은 `RequestLoggingFilter.java:65-71,147`뿐, `CorrelationIdPort` 구현은 `MdcCorrelationIdPortAdapter` 1개, GraphQL은 `GraphQlPlatformWebInterceptor.java:157` Spring request id | W3 | `MdcKeys`를 shared-contract로(원본 `docs/registries/mdc-keys.yaml`), 사용 5파일 import 변경; websocket STOMP·gRPC interceptor에 MDC 채우는 코드, GraphQL은 `WebRequestId` 사용 | +| X2-P2-6a | Required | 같은 이름 `TenantContext` 2개, 허용 문법이 다름 | 남음 | web `core/TenantContext.java:20` `[A-Za-z0-9][A-Za-z0-9_.-]{0,63}` vs graphql `context/TenantContext.java:17,30`(비어있지 않고 128자 이하). 그 밖에 persistence-jpa `experimental/tenant/TenantId`, application-notification `TenantId` | W3 | application-core에 tenant id 값 타입 1개(web 문법) 두고 web·graphql `TenantContext` 2곳이 감쌈, notification·jpa `TenantId`도 같은 타입으로 맞춤 | +| X2-P2-7a | Required | 연결 안 된 두 번째 rate-limit stack 삭제 (= I-8 일부) | 완료 | `WebRateLimiter`·`WebMvcThrottleFilter`·`ThrottleProblemWriter` 삭제(`docs/capability-status.md:99-100`), WebFlux throttle은 WebFlux와 함께 삭제(`:88`), 커밋 `6d27356e` | - | - | +| X2-P2-7b | Required | client IP 신뢰 규칙이 두 갈래 (= I-5) | 남음 | `web/ratelimit/ForwardedHeaderClientIpResolver.java:11-16` trusted proxy 확인 없이 XFF 첫 hop vs `web-notification/.../ExternalRequestUrlResolver.java:31` trusted proxy일 때만 | W1 | `ForwardedHeaderClientIpResolver`도 `remoteAddr`가 trusted proxy일 때만 XFF 사용(아니면 `remoteAddr`), 규칙은 `ExternalRequestUrlResolver`와 같은 설정 하나로 | +| X2-P2-8 | Consider | Origin 검증기 3개, env key 3개 기본값 다름 | 해당 없음(코드 삭제) | web `WebCorsPolicyValidator` 삭제(`docs/capability-status.md:206`), websocket platform origin 정책·`APP_WEBSOCKET_PLATFORM_*` 삭제(`:186`); 남은 검증은 `WebSocketSettings.java:25`(+`@AssertTrue`) 1개 | - | - | +| X2-P2-9a | FYI | 크기 제한 위반 코드 이름이 전송마다 다름 | 남음 | web `PAYLOAD_TOO_LARGE`(`GlobalExceptionHandler.java:342`), graphql `REQUEST_TOO_LARGE`(`GraphQlHttpOutcome.java:32`)·`GRAPHQL_DOCUMENT_SHAPE_REJECTED`, fileserver `FILE_TOO_LARGE`(`FileserverErrorCode.java:36`) | W3 | P2-1 정리 때 body 크기 초과는 `PAYLOAD_TOO_LARGE` 하나로(graphql 1곳), 문서 모양 거부·파일 크기는 별도 코드 유지 | +| X2-P2-9b | FYI | STOMP가 모든 실패를 `WEBSOCKET_REQUEST_REJECTED` 하나로 → carrier 코드 소실 | 남음 | `SafeStompSubProtocolErrorHandler.java:12,21-27` | W3 | 원인이 `ApiErrorCarrier`면 그 `code()`를 `error-code` 헤더에(메시지는 고정 유지), 나머지는 현재 값 | +| X-요약-capability 활성화 규칙 | 권고 | 활성화 규칙 6곳·기본값 3가지 → 표 하나(키·기본값·필요 조건·prod secret)에서 validator·endpoint 파생 | 해당 없음(코드 삭제) | `MasterSwitch`·`CapabilityDependencyValidator`·`AdapterActivationEndpoint` 등 삭제(`docs/capability-status.md:248-249`). 지금 규칙은 "모듈이 있으면 켜짐, `enabled`로 끔"(`AGENTS.md:212-213`), 기본값은 각 모듈 `config/module-defaults/<모듈>.yml` | - | - | + +**조사 메모** + +- 겹침: 기능 지도 13행은 「발견」 행과 같은 대상이다(Outbox=#1, 멱등성=#2, 자연키=#2e, lock/lease=#6, guard=#4, Backoff=#9, Rate limit=#5·P2-7a, Admission=#10a, Kafka producer=#1f, 파일 control plane=#8, readiness=#7, 테스트 fake=#3). 세부 판정은 「발견」 행 기준. X1-#10b와 X2-P1-5(SHA-256), X1-#5와 X2-P2-7a(rate limit)도 같은 작업이다. 상단 요약 표(37~49행)는 「capability 활성화 규칙」만 X1/X2에 없어 `X-요약` 행으로 추가했다. +- 다른 절과 겹침: X1-#1c·#4 = 1차 E-3, #1d = E-5, #6e = B-5, #8b = D-5, #10a = N-5, P2-7b = I-5, P2-6b = J-12·K-10. X1-#1i·#2b는 소유자 결정(`composition:*` 이동)을 반영한 행으로, 리뷰 원문에는 조립 위치 권고가 없다. +- 행을 만들지 않은 항목: X2 Part 1 표의 FYI 5개(상수 시간 비교, Base64url, 마스킹 `toString`, `requireNonBlank`, Size/Duration 파싱)는 권고가 "조치 없음"이다. X1-#10의 gRPC 스택 2개는 의도된 결정. X2-P1-2의 grpc `RuntimeEnvironment` 매핑은 "bridge를 붙일 때" 조건부라 지금 할 일이 없다. +- 리뷰 수치가 서로 다르다: SHA-256을 X1-#10은 "65벌", X2 요약 표는 "헬퍼 53개(47파일)", Part 1 표는 "파일 66개"로 적었다. `208077fd` main에서 `MessageDigest.getInstance`를 다시 세면 72곳/68파일이다. 현재 값은 X2-P1-5 행에 적었다. +- 리뷰가 적게 센 것: tenant 타입은 web·graphql `TenantContext` 2개만 적었지만 persistence-jpa `experimental/tenant/TenantId`·`TenantContext`, application-notification `TenantId`, 벤더 messaging `TenantContext`도 있다. X2-P2-2의 대상 예외는 V2 전환으로 바뀌었다(ScopeMissing 삭제, Unavailable·RecoveryRequired 추가). +- X1-#8의 UTF-8 처리 갈림(strict `FileserverControlRecordCodec` vs 느슨한 `CanonicalJsonReader.java:16` `new String`)은 strict 쪽이 삭제되어 더 이상 갈림이 아니다. 느슨한 디코딩 자체는 남아 있다. +- X-요약 행 보충: 기본값이 꺼진 스위치는 기능 옵션 3개뿐이다(`ca-skeleton.outbox.enabled` false: `persistence-jpa.yml:188`, `app.rate-limit.enabled` false: `cache-redis.yml:17`, `ca-skeleton.realtime.replay.enabled` false: `persistence-jpa.yml:175`). `app.redis.enabled`는 코드 조건에 `matchIfMissing`이 없지만 모듈 기본값 yml이 true로 채운다(`cache-redis.yml:13`). + +## 2차 S1 Core · S2 Persistence · S3 Redis/httpclient + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| S1-#1 | Required | 멱등성 엔진 2세대 공존, V2는 호출자 0 (= X1-#2, A-8) | 완료 | `6d27356e`: v1 삭제(「제거된 코드」 멱등성 v1 모델·JPA v1 store·bootstrap 조립 행), V2가 이름 없이 `application-core/.../idempotency/IdempotencyExecutor.java`로 정본. 조립은 `app-bootstrap/.../idempotency/IdempotencyProviderSelectionConfig.java:36-55` 한 곳(store 개수 검사 포함), provider는 store만(`cache-redis/.../capability/RedisIdempotencyConfig.java:51`) | - | - | +| S1-#2a | Required | outbox V2 append·폴링 포트, `OutboxV2RetryPolicy` (= X1-#1, A-3) | 해당 없음(코드 삭제) | 「제거된 코드」 "application-core outbox V2 포트·유스케이스 17종" 행. `application-core/.../outbox/`에 V2 파일 0, 폴링 `OutboxStorePort` 1개·retry `OutboxBackoffPolicy` 1개만 남음 | - | - | +| S1-#2b / S2-#4b | Required | append 포트 2개(legacy·canonical)가 같은 `outbox_event`에 공존, `ClaimedOutboxEvent` sealed 합집합 유지 (= X1-#1) | 남음 | `application-core/.../outbox/LegacyOutboxAppendPort.java:11`(sample 4곳 + `SubmitDurableOperationUseCase` 사용), `OutboxAppendPort.java:13`(main 호출자 0, 구현 `CanonicalOutboxAppendAdapter`뿐), `ClaimedOutboxEvent.java:11` `permits OutboxEvent, CanonicalClaimedOutboxEvent`
S2-#4b: `persistence-jpa/.../outbox/entity/OutboxEventEntity.java` public 62개, `outbox/OutboxStoreAdapter.java`(legacy) + `CanonicalOutboxAppendAdapter.java:28` | W3 | 결정(2026-09-25): canonical 통일 — 템플릿 JSON encoder 제공, `LegacyOutboxAppendPort` 소비자 4곳 이전 후 legacy 포트·legacy Kafka 발행 경로 삭제
S2-#4b: 결정(2026-09-25): canonical 통일 → legacy adapter·컬럼 접근자 삭제(적용된 migration 유지) | +| S1-#3a | Required | 호출자 없는 cache executor 20종·`LeaseWatchdog`·`TransactionCompletionResolver`·inbox·filepublication·`EphemeralFanoutPort` | 해당 없음(코드 삭제) | 「제거된 코드」 application-core cache 20종, `LeaseWatchdog`, `TransactionCompletionResolver`, same-store inbox, `FilePublicationPort`, `EphemeralFanoutPort` 행 | - | - | +| S1-#3b | Required | `lease/*` 399줄: Redis 구현만 있고 use case 호출자 0 (= X1-#6) | 남음 | `application-core/.../lease/`(13파일 399줄) 참조는 `cache-redis/.../lease/RedisDistributedLeaseAdapter.java`·`RedisLeaseConfig.java`뿐. JDBC `DistributedLockPort`도 비즈니스 소비자 0. cache-redis README가 lease를 제공 capability로 명시 | W4 | 결정(2026-09-25): lock·lease 둘 다 capability로 유지 — 포트별 추상 계약 테스트를 fake와 어댑터가 함께 통과 | +| S1-#4 | Required | `NotificationDispatchService` 생성자 15개, record 필드별 재조립·실패 분류가 한 클래스에 (B-5 구조 원인) | 남음 | `application-notification/.../dispatch/NotificationDispatchService.java:72`(인자 15개), `:208`·`:485` record 재조립, `:255-288` catch 분기, `:475`·`:513` 종료 상태 두 번 계산. `DispatchOutcomeRecorder.java:67,110` 재조립 2곳 | W3 | `DeliveryAttemptRecord.completed(result, at)`·`RecipientDeliveryRecord.advancedRoute(now)` 전이 메서드 추가, catch 분기는 `ProviderOutcomeClassifier` 정적 메서드로 분리 | +| S1-#5 | Required | fileserver retire 절차 3곳 복사, admin `forceDelete`는 content 없는 레코드를 DELETING에 남김 (C-4 관련) | 남음 | `application-fileserver/.../admin/DefaultFileserverAdminService.java:160-175`(contentKey 없을 때 DELETED 전이 없음) vs `lifecycle/DefaultFileLifecycleService.java:87-100`(있음), `upload/DefaultUploadApplicationService.java:258-269` | W2 | `retire(FileRecord)` 하나로 합치고 content 없으면 DELETING→DELETED 전이를 세 호출부 모두에 적용 | +| S1-#6a | Required | fileserver 단일 구현 인터페이스 6개(fake 없음) | 남음 | `CleanupService`, `WriterLeaseCoordinator`, `FileLifecycleService`, `TransferAdmissionController`, `FileReconciliationService`, `FileStateMachine` 모두 구현 1개(`Default*`) | W3 | 인터페이스 6개 삭제, `Default*`를 인터페이스 이름으로 개명 | +| S1-#6b | Required | fileserver 인바운드가 use-case 계약 밖(capability gate 미적용) | 남음 | `application-fileserver/src/main/java`에서 `@UseCaseCapability`/`CommandUseCase`/`QueryUseCase` 0건(notification 14파일) | W3 | transport가 부르는 연산을 `*UseCase` + `@UseCaseCapability`로 선언 | +| S1-#7 | Consider | 에러 코드마다 예외 서브클래스, 타입 분기는 몇 개뿐 | 남음 | fileserver `api/error/` 예외 23개 그대로(`FileNotFoundException`·`FileAlreadyExistsException`·`InvalidPathException` JDK 이름 충돌 유지). notification은 throw 0인 12개만 삭제(「제거된 코드」 행), 12개 남음 | W3 | base를 구체 클래스 + `of(code, …)`, 서브클래스는 catch로 타입 분기하는 5개만 남김 | +| S1-#8 | Consider | `PolicyTransactionPort` 계열이 호출 1곳용 | 해당 없음(코드 삭제) | 「제거된 코드」 `PolicyTransactionPort` 계열·`SpringPolicyTransactionPort`·`FileserverCompensationTransaction` 행. grep 0건 | - | - | +| S1-#9 | Consider | 같은 전략만 담은 레지스트리 2개 | 남음 | `application-notification/.../callback/ProviderEventProjectorRegistry.java:7`(Twilio/Ses projector는 `StandardDeliveryProjector` 상속만), `dispatch/TemplateRendererRegistry.java:7` + `adapter/outbound/notification/.../NotificationPlatformProviderConfig.java:57-65`(모든 channel에 같은 engine) | W3 | 레지스트리·`Map*Registry` 삭제, 구현체 직접 주입 | +| S1-#10a | Consider | `NotificationOrchestrator`·Reactor facade (= B-8) | 해당 없음(코드 삭제) | 「제거된 코드」 `NotificationOrchestrator`, Notification Reactor facade 행 | - | - | +| S1-#10b | Consider | 제출 흐름 `prepare→inWrite→recordAccepted`가 서비스 public 진입점과 use case 2개에 3벌 | 남음 | `application-notification/.../dispatch/NotificationSubmissionService.java:79,83,183-188`(main 호출자 0, 테스트만), `SubmitNotificationApplicationUseCase.java:45-49`, `ScheduleNotificationApplicationUseCase.java:45-49` | W3 | 서비스의 `submit`/`schedule`/`accept` 삭제(테스트는 use case로), 두 use case는 scheduleAt만 다른 private 헬퍼 1개 공유 | +| S1-#11 | Consider | SHA-256 헬퍼 분산, `MessageDigestPort`가 stdlib를 포트로 감쌈, `RequestFingerprint` 이름 충돌 (= X2 P1-5) | 남음 | `application-notification/.../dispatch/MessageDigestPort.java:4` + `adapter/outbound/notification/.../Sha256MessageDigestAdapter.java`, main 33파일이 `MessageDigest.getInstance("SHA-256")` 직접, `RequestFingerprint` 2개(`application-core/.../idempotency/RequestFingerprint.java:17`, `application-notification/.../dispatch/RequestFingerprint.java:15`) | W3 | 기존 `application-core/.../messaging/contract/Sha256`에 `hex(byte[])` 두고 포트·어댑터 삭제, notification 쪽은 `PlanFingerprint`로 개명 | +| S1-#12 | Consider | fileserver content SPI 확장 4개 구현·호출 0 | 남음 | `application-fileserver/.../api/content/{AsyncContentStore,CopyCapableContentStore,CapacityAwareContentStore,DelegatedDownloadStore}.java` 참조는 자기 자신과 `ContentStoreApiArchitectureTest`뿐, `BlockingContentStore`는 어댑터(`LocalBlockingContentStore`)만 사용 | W3 | 확장 4개 삭제, `BlockingContentStore`는 `adapter:outbound:fileserver` 내부로 이동 | +| S1-#13 | Consider | `FileStateMachine` 인터페이스+구현+bean이 전이표 Map 하나 | 남음 | `application-fileserver/.../api/FileStateMachine.java`, `DefaultFileStateMachine.java:14` | W3 | `FileState.canTransitionTo(target)` enum 메서드로 대체 | +| S1-#14 | Consider | notification platform 미사용 약 920줄(예외 12, security 3, sms/push/email/webpush) (= B-8) | 해당 없음(코드 삭제) | 「제거된 코드」 notification `sms`·`push`·`email`·`webpush` facade, throw 0 예외 12종, redaction 5종 행. 해당 디렉터리 없음 확인 | - | - | +| S1-#15a | Consider | shared-contract `activation/*`(bootstrap만 사용) | 해당 없음(코드 삭제) | 「제거된 코드」 `MasterSwitch`·`MasterSwitchParser`(shared-contract `activation` 전체) 행 | - | - | +| S1-#15b | Consider | shared-contract `opstore/*` 구현·소비자 0 | 남음 | `shared-contract/.../opstore/OperationalRecordStorePort.java` 외 2개, shared-contract 밖 참조 0(graphql `advanced/**` 삭제 뒤) | W3 | `opstore` 패키지 삭제 | +| S1-#15c | Consider | ratelimit 정책 타입이 cache-redis 전용 | 남음 | `shared-contract/.../ratelimit/RateLimitPolicy`·`RateLimitAlgorithm` main 소비자는 cache-redis뿐, `RateLimitEvaluationDedupPolicy`는 테스트만 참조 | W3 | 세 타입을 `adapter:outbound:cache-redis`로 이동(`EdgeRateLimitPort` 계열만 shared에 유지) | +| S1-#15d | Consider | shared-contract CLAUDE.md 책임 목록이 패키지 일부만 설명 | 남음 | `shared-contract/CLAUDE.md:17-30`은 response·error·request·health·tracing만, 실제 패키지 15개(annotation·concurrency·headers·metrics·operation·registry·runtime·security·ratelimit·opstore 누락) | W5 | 책임 목록을 현재 패키지 기준으로 갱신 | +| S1-#16 | Consider | 문서가 말하는 `application-core → domain-core` 의존이 빌드에 없음 | 남음 | `application-core/build.gradle:9-15`에 `domain-core` 없음, `application-*` main의 `dev.caskeleton.domain` import 0, 반면 `AGENTS.md:118-119`·registry(`modules.json`)는 이 방향을 허용·전제 | W3 | `application-core/build.gradle`에 `implementation project(':domain-core')` 복원, `NotificationIdGeneratorPort`·`UploadIdentifierFactory`를 `IdFactory` 기반으로 정리 | +| S1-#17a | Consider | objectstorage 식별자 클래스 6개·가드 2개 복사 | 남음 | `application-objectstorage/.../identity/{ObjectId,ObjectReference,ObjectStageHandle,ObjectVersionToken,PartReceiptToken,DirectTransferSessionId}.java` 각 40줄 클래스, `model/ObjectModelSupport.java` vs `request/ObjectRequestSupport.java:14-18` | W3 | 식별자를 record + `toString` 재정의로, 가드는 하나로 | +| S1-#17b | Consider | legacy `application.storage` 네임스페이스 공존(Javadoc 모순) | 남음 | `application-objectstorage/.../storage/ObjectStoragePort.java:6,12`("the only dependency" + "Legacy compatibility only"), 104줄 남음(migration은 삭제), 사용처 sample + objectstorage `S3ObjectStorageAdapter`·`FilesystemObjectStorageAdapter` | W3 | 「한 기능에 한 세대」: sample `UploadPosterImageUseCase`를 `application.objectstorage` 포트로 옮기고 legacy 포트·어댑터 2개 삭제 | +| S1-#18a | Consider | `V2` 접미사 타입 | 완료 | `6d27356e`: 멱등성 V2 → 무접미사, outbox V2 삭제. main의 `*V2*.java`는 sample 이벤트 스키마 버전 `PosterImageAttachmentReadyV2` 하나뿐 | - | - | +| S1-#18b | Consider | 포트·서비스 이름 규칙이 leaf마다 다름 | 남음 | outbound인데 `application-fileserver/.../api/metadata/FileQuotaService.java`, `FileMetadataStore`·`UploadSessionStore`·`*Gateway`, 인바운드 `*Service`+`Default*`(fileserver 10쌍) | W3 | 소유자 규칙대로 outbound `*Port`, inbound `*UseCase`로 기계적 개명 | +| S1-#19 | Nit | 이력 주석·inline FQN | 남음 | 재측정: 이력 문구("used to" 등) application-core 14·notification 23·fileserver 9·objectstorage 1줄, notification inline FQN 74줄 | W5 | 불변 조건 1~2줄만 남기고 이력은 git/ADR로, FQN은 import로 | +| S1-#20 | Nit | notification `dispatch/` 패키지에 여러 기능 | 남음 | `application-notification/.../platform/dispatch/` 46파일 3,855줄(제출·템플릿 게시·`ContactPoint*`·reconciliation 포함) | W5 | `submission/`, `dispatch/`, `reconciliation/`로 이동, `ContactPoint*`는 `contact/`로 | +| S1-lead-1 | 권고 | messaging 자체 outbox/inbox와 app-core outbox/inbox가 같은 패턴 3~4벌 | 완료 | app-core inbox 삭제(「제거된 코드」 same-store inbox 행), outbox V2 삭제. 남은 2벌(app outbox + vendored `messaging_outbox`)은 D2 결정(`docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md:104` "messaging platform outbox는 vendored라 유지") | - | - | +| S1-lead-2 | 권고 | UUID 생성기 제각각 | 남음 | notification 자체 `adapter/outbound/notification/.../dispatch/UuidV7Generator.java`, fileserver `RandomUploadIdentifierFactory`(v4), sample `Uuid*IdFactory`(uuid-creator v7) | W3 | notification `UuidV7Generator`를 sample이 쓰는 uuid-creator로 대체(v7 생성 1벌), fileserver v4는 유지 | +| S1-lead-3 | 권고 | 멱등성 executor 조립 위치 (= G-11) | 남음 | adapter 조립은 사라졌으나(`RedisIdempotencyConfig.java:51` store만) 조립이 `app-bootstrap/.../idempotency/IdempotencyProviderSelectionConfig.java:48`에 있음. 소유자 결정은 별도 `composition:*` 모듈 | W3 | `IdempotencyProviderSelectionConfig`·`IdempotencySettings`를 새 `composition:idempotency`(가칭) 모듈로 이동, registry 등록 | +| S1-lead-4 | 권고 | `Local*Gateway`가 `LocalBlockingContentStore`로 넘기기만 | 남음 | `adapter/outbound/fileserver/.../platform/local/` gateway 6개 385줄, 이 중 `LocalDownloadContentGateway`(26줄)·`LocalCleanupContentGateway`·`LocalZeroCopyDownloadGateway`는 위임만 | W3 | 위임만 하는 3개는 `LocalBlockingContentStore`가 해당 gateway 인터페이스를 직접 구현, 로직 있는 Copy/Upload는 유지 | +| S1-lead-5 | 권고 | persistence-jpa `SpringPolicyTransactionPort` 정리 | 해당 없음(코드 삭제) | 「제거된 코드」 `SpringPolicyTransactionPort`… 행 | - | - | +| S1-lead-6 | 권고 | fileserver 전이 규칙이 Java와 SQL 두 곳 | 남음 | `application-fileserver/.../api/DefaultFileStateMachine.java:14` vs `adapter/outbound/persistence-fileserver/.../repository/FileTransitionRepository.java:63-68`(DELETING 진입 가능 상태를 SQL 문자열로 하드코딩) | W2 | SQL의 허용 상태 목록을 `FileState` 전이표에서 파라미터로 넘기거나, 두 목록이 같은지 단언하는 테스트 추가 | +| S2-#1a | Required | JPA `notification/crypto` 505줄 테스트 전용 사본 | 해당 없음(코드 삭제) | 「제거된 코드」 "JPA notification crypto 6종과 테스트" 행 | - | - | +| S2-#1b | Required | persistence-jpa가 notification persistence를 품음(jpa→application-notification edge) | 남음 | `adapter/outbound/persistence-jpa/build.gradle:38` `implementation project(':application-notification')`, `persistence/notification/**` 6,573줄, `PersistenceJpaConfig.java:40-80` 19개 패키지 목록 ×2, `:88` `OPT_IN_NOTIFICATION_PACKAGE`, `PersistenceEntityScanCoverageTest.java:46`. 계획 W4가 추출을 적었으나 registry에 `persistence-notification` 없음 | W3 | `persistence-fileserver/build.gradle` 방식으로 `adapter:outbound:persistence-notification` leaf 추출, 목록 2개·상수·coverage 테스트 삭제 | +| S2-#2a | Required | Mongo: 바인딩 안 되는 `advanced.*.enabled`, 구현 없는 인터페이스 10개, reactive·change stream | 해당 없음(코드 삭제) | 「제거된 코드」 Mongo advanced 바인딩·search/vector·time series·GridFS·`MongoDataKeyResolver` 등·reactive·change stream 행. 인터페이스 9개 grep 0, `MongoTenantMigrationCheckpointStore`는 구현 생김(`MongoTenantMigrationCoordinator.java:96`) | - | - | +| S2-#2b | Required | persistence-mongo 약 23k줄 플랫폼에 소비자 없음 | 완료 | 소유자 결정(계획 Wave 3 "분류 2는 완성해서 포장")으로 라이브러리 유지: `adapter/outbound/persistence-mongo/README.md:135` 라이브러리 API 표, 한 줄 조립 주석 `app-bootstrap/build.gradle:146`. main 23.2k→18.6k줄 | - | - | +| S2-#3a | Required | 두 번째 트랜잭션·재시도 엔진, 거짓 Javadoc | 해당 없음(코드 삭제) | 「제거된 코드」 "JPA 두 번째 트랜잭션·재시도 엔진 19종", `JpaTransactionAutoConfiguration`, retry 계열 행. `persistence/transaction/`에 `SpringTransactionPort` 하나, CLAUDE.md:91-92가 "retries nothing"으로 갱신 | - | - | +| S2-#3b | Required | SQLSTATE 표 두 벌 | 남음 | `failure/StandardSqlStateErrorMapping.java:17`·`postgresql/PostgreSqlSqlStateErrorMapping.java:15` vs `postgresql/error/PostgreSqlState.java:18,24`(`PostgreSqlFailureClassifier`·lock translator가 사용). 40001이 두 곳 | W3 | vendor당 SQLSTATE enum 하나(`PostgreSqlState`)로 두고 `SqlStateErrorMapping`이 그 enum을 참조 | +| S2-#4a | Required | JPA outbox V2·inbox·멱등성 v1 공존 | 해당 없음(코드 삭제) | 「제거된 코드」 JPA outbox V2 adapter·migration stream·통합 테스트, same-store inbox, JPA v1 멱등성 store 행 | - | - | +| S2-#5 | Required | Mongo reactive 쌍둥이 스택 (= F-3, F-7) | 해당 없음(코드 삭제) | 「제거된 코드」 Mongo reactive 경로·change stream 행. `mongo/reactive`·`changestream` 디렉터리 없음, main의 reactor 참조 0 | - | - | +| S2-#6a | Required | owner-lease claim 절차·`digestFields` 복사(inbox·polling) | 해당 없음(코드 삭제) | `PostgreSqlSameStoreInboxAdapter`·`PostgreSqlPollingDeliveryAdapter`·`PostgreSqlImmutableOutboxAppendAdapter` 삭제(「제거된 코드」 same-store inbox, JPA outbox V2 adapter 행). claim 절차는 멱등성 store에만 남음 | - | - | +| S2-#6c | Required | `capability_schema_registry` 확인 SQL 복사 | 남음 | `persistence-jpa/.../notification/NotificationSchemaActivation.java:33`, `postgresql/idempotency/PostgreSqlOwnerSafeIdempotencyStore.java:70`, `persistence-fileserver/.../FileserverSchemaActivation.java:30` (조건이 `>= 4`/`= 2`로 서로 다름) | W3 | persistence-jpa 안 2곳은 `CapabilitySchemaRequirement` record 하나로, fileserver는 jpa edge가 없어 자기 사본 유지(또는 support로) | +| S2-#7 | Required | JPA 플랫폼 라이브러리가 지원 표면 밖 | 완료 | 단일 구현 인터페이스 8개 grep 0(「제거된 코드」 work-claim·upsert 실행기, 단일 구현 인터페이스 행), 남은 라이브러리는 소유자 결정(Wave 3)대로 `adapter/outbound/persistence-jpa/README.md:61` 라이브러리 API 표에 명시. main 26.3k→20.0k줄 | - | - | +| S2-#8a | Consider | 조립 방식 3가지, 게이트 반복 | 남음 | `persistence-jpa/.../config/JpaAdapterComponentsConfig.java`(스캔 stereotype 16개), `notification/configuration/NotificationJpaPersistenceFacade.java`, `persistence-fileserver/.../FileserverJpaPersistenceConfig.java` + fileserver main `@ConditionalOnProperty` 10개, Mongo 6개 | W3 | feature config별 명시적 `@Bean` 한 방식으로, 클래스별 stereotype·조건 제거 | +| S2-#8b | Consider | "두 조립 루트가 `dev.caskeleton.adapter`를 스캔한다" 서술이 사실과 다름 | 남음 | `persistence-jpa/.../postgresql/idempotency/PostgreSqlOwnerSafeIdempotencyStore.java:53`, `src/test/.../CandidateAdapterCompositionTest.java:10-18`(현재 `CaSkeletonApplication`은 scan 제외식 없음, sample은 `SamplePortfolioApplication.java:31-40`처럼 좁게 스캔) | W5 | 잘못된 단락 삭제, 전제가 사라진 `CandidateAdapterCompositionTest` 삭제 또는 현재 조립 기준으로 재작성 | +| S2-#9a | Consider | 무관한 `inbox` 패키지 2개 | 해당 없음(코드 삭제) | `postgresql/inbox` 삭제(「제거된 코드」 same-store inbox 행) | - | - | +| S2-#9b | Consider | feature가 vendor별로 흩어짐 | 남음 | outbox: `outbox/`, `outbox/entity/`, `postgresql/PostgreSqlOutboxClaimRepository.java`, `h2/H2OutboxClaimRepository.java`; 멱등성: `idempotency/`, `postgresql/idempotency/`, migration `jpa/idempotency` + `postgresql/V1,V10` | W3 | feature 기준 패키지(`outbox/{jpa,postgresql,h2}`, `idempotency/{jpa,postgresql}`)로 이동만 | +| S2-#10 | Consider | promotion/benchmark gate가 production classpath에 | 해당 없음(코드 삭제) | 「제거된 코드」 `experimental/next/*`, `MongoAdvancedPromotionGate`·`Evidence`, search·vector(benchmark·readiness gate 포함) 행. grep 0 | - | - | +| S2-#12 | Consider | Javadoc이 이력을 서술 | 남음 | 재측정: "used to/until now/never was/no longer" 포함 파일 jpa 25·mongo 36·fileserver 6 | W5 | 불변 조건 1~2줄만 남기고 이력은 git/ADR로 | +| S2-#13a | Nit | `JpaTransactionAutoConfiguration` 팩토리 2회 생성, `new JpaTransactionSettings(null ×9)` | 해당 없음(코드 삭제) | 「제거된 코드」 두 번째 엔진(`JpaTransactionAutoConfiguration`)·`JpaTransactionSettings` 행 | - | - | +| S2-#13b | Nit | port 구현 이름 규칙 7가지 | 남음 | `OutboxStoreAdapter`, `CanonicalOutboxAppendAdapter`, `Jpa*Store`(notification), `JdbcReconciliationJobStore`, `PostgreSqlOwnerSafeIdempotencyStore`, `SpringTransactionPort`, `LockRegistryDistributedLockAdapter`, `persistence-fileserver/.../JpaFileQuotaService` | W3 | `` 규칙 하나로 개명(S1-#18b와 함께) | +| S2-#14a | Nit | jpa CLAUDE.md의 "NoSQL은 미래 모듈"·MapStruct 절이 현실과 다름 | 남음 | `adapter/outbound/persistence-jpa/CLAUDE.md:17-19,202-206`(Mongo leaf 이미 존재), `:309-330` MapStruct 절(의존성 없음) | W5 | NoSQL 문장을 현재 leaf 기준으로 고치고 MapStruct 절 삭제 | +| S2-#14b | Nit | jpa API surface 파일에 옮겨간 타입 | 남음 | `docs/architecture/jpa-adopter-api-surface.txt:11` `...persistence.fileserver.FileserverSchemaActivation`(지금은 persistence-fileserver leaf) | W5 | 해당 줄 삭제(필요하면 fileserver 쪽 surface로) | +| S2-#14c | Nit | Mongo CLAUDE.md `MongoAdvancedProperties` 오기 | 완료 | `6d27356e`: 해당 이름 없음, `adapter/outbound/persistence-mongo/CLAUDE.md:146`이 "flags have no configuration property"로 갱신(`MongoAdvancedSettings`도 삭제) | - | - | +| S2-#14d | Nit | `JpaAdapterComponentsConfig`가 classpath 밖 leaf로 `{@link}` | 완료 | `persistence-jpa/.../config/JpaAdapterComponentsConfig.java:36`이 `{@code FileserverJpaPersistenceConfig}`로 변경(`208077fd`에서는 `{@link`) | - | - | +| S2-lead-1 | 권고 | app-core 포트 버전이 #4의 원인 | 남음 | V2 포트는 삭제됐으나 `OutboxAppendPort`/`LegacyOutboxAppendPort` 2개 남음(S1-#2b 근거와 같음). 멱등성은 `IdempotencyStorePort` 하나 | W3 | 결정(2026-09-25): canonical 통일(S1-#2b와 같은 작업) | +| S2-lead-2 | 권고 | 멱등성 claim 판정표가 Redis·PG에 따로 (= X1-#3) | 남음 | Redis 판정은 Lua 안(`cache-redis/.../idempotency/IdempotencyScripts.java`) + 응답 매핑 `RedisIdempotencyStoreAdapter.java:135-157`, PG는 `postgresql/idempotency/IdempotencyClaimGateway.java`. 공통 계약 테스트 없음(`application-core/src/testFixtures/.../idempotency/testkit/`에 `InMemoryIdempotencyStore`만) | W4 | application-core testFixtures에 `IdempotencyStoreContract` 추가, InMemory·Redis·PG adapter가 모두 상속 | +| S2-lead-3 | 권고 | 서명 cursor codec 여러 벌 (= X2 P1-4) | 남음 | web `CursorCodec`·`HmacWebCursorCodec` 삭제(「제거된 코드」 서명 커서 코덱·2세대 페이지네이션 행). 남은 3벌: `persistence-jpa/.../api/query/SignedJsonCursorCodec.java`, `persistence-mongo/.../query/pagination/MongoKeysetCursorCodec.java`, `graphql/.../pagination/HmacGraphQlCursorCodec.java` | W3 | X2 P1-4대로 서명은 inbound 한 계층, persistence는 typed keyset만(jpa·mongo codec 삭제 또는 서명 제거) | +| S2-lead-4 | 권고 | persistence 실패 예외 계층 3벌 | 남음 | jpa `api/error/JpaPersistenceException.java:14`(RuntimeException 상속, 21개, 라이브러리 `PostgreSqlExceptionTranslator` 결과), mongo `api/error` 24개, shared `shared-contract/.../error/PersistenceFailureException.java`(web·grpc가 매핑) | W3 | `JpaPersistenceException`이 `PersistenceFailureException`을 상속해 inbound가 한 계층만 매핑(mongo는 edge 없어 유지) | +| S2-lead-5 | 권고 | sample이 `PostgreSqlPersistenceConfig`의 claim repository bean을 재선언 | 완료 | `sample-portfolio/.../bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java:28-48`은 sample Flyway 전략만 선언, claim repository bean 없음 | - | - | +| S2-lead-6 | 권고 | JPA 조립이 leaf와 bootstrap에 나뉨 | 완료 | 「제거된 코드」 `JpaPlatformAutoConfiguration`·`JpaPlatformRuntimeAutoConfiguration` 행, 조립은 `persistence-jpa/src/main/resources/META-INF/spring/...AutoConfiguration.imports`(3개)에만, `app-bootstrap/.../autoconfigure/`에 jpa 없음 | - | - | +| S3-#1 | Required | httpclient blocking/reactive 병렬 스택이 이미 갈라짐 (= H-5, H-7) | 남음 | D4는 inbound WebFlux만 삭제. httpclient `webclient/`·`reactor/`·`service/Reactive*` 그대로, `build.gradle:30-37` webflux·reactor 의존. 401 refresh는 blocking만(`restclient/DefaultGenericHttpGateway.java:212-225`), `webclient/ReactiveAttemptExecutor.java:155-172` `false` 고정, `ReactiveClientRuntime.java:39`가 `BlockingExecutionSupport` 사용 | W3 | 결정(2026-09-25): D4를 outbound에도 적용 — httpclient reactive(WebClient·Reactor Netty) 스택과 webflux·reactor 의존 삭제 | +| S3-#2a | Required | reactive streaming 요청이 admission·deadline·credential 없이 나감 | 남음 | `adapter/outbound/httpclient/.../webclient/ReactiveStreamingGateway.java:50-107`(prepared header만 전송, credential·admission·deadline 호출 없음) vs `restclient/BlockingStreamingGateway.java`(고쳐짐) | W2 | S3-#1에서 reactive를 지우면 함께 삭제, 유지하면 blocking과 같은 credential·admission·deadline 단계 적용 + 동작 테스트 | +| S3-#2b | Required | 진입점 6개가 호출 파이프라인을 각자 조립 | 남음 | `CallSetup` 등 공통 조립 없음(grep 0), `DefaultDynamicTargetGateway`·`DefaultReactiveSseGateway`·`BlockingStreamingGateway`·`ReactiveStreamingGateway`가 각자 조립 | W3 | `CallSetup.prepare(lease, operation)`이 metadata/prepared/deadline/admission/credentials 반환, 진입점은 전송만 다르게 | +| S3-#3a | Required | 118개 메서드 `RedisCommandGateway`, runtime이 SDK 개념에 역의존 (= G-7) | 남음 | `redis-runtime/.../lettuce/operations/RedisCommandGateway.java`(1,227줄, 메서드 118), `:1107-1134` `sendApprovedRaw/sendAdminDiagnostic/sendExtension`, `lettuce/connection/RedisConnectionKind.java:25-33` BLOCKING·TRANSACTION·PUBSUB lane, `:64` `forCommand(RedisCommandDescriptor)` | W3 | runtime 계약은 semantic adapter가 쓰는 8개(`SemanticRedisCommands`)로, 나머지는 redis-sdk 확장 인터페이스로 이동(redis-sdk 유지 결정 반영), lane은 REGULAR·SCRIPT만 | +| S3-#3b | Required | runtime이 `Sdk` 이름·`...redis.sdk` 패키지를 쓰고 redis-sdk와 split package | 남음 | `redis-runtime/.../sdk/config/RedisSdkSettings.java`(670줄), `RedisSdkAutoConfiguration.java`, redis-runtime·redis-sdk 공유 패키지 9개 | W3 | `RedisRuntimeSettings`로 개명, runtime 패키지를 `...redis.runtime.*`로, SDK 전용 설정 섹션은 redis-sdk로 | +| S3-#4a | Required | cache-redis에서 "안 보냄/보냈는지 모름" 구분을 rate-limit만 함 | 남음 | `ambiguousExecution()` 사용은 `cache-redis/.../ratelimit/RedisEdgeRateLimitAdapter.java:130`뿐, 멱등성·lease·cache는 lane 거절도 `Indeterminate`(계획 진행 기록 Wave 1 "남은 것"에도 기재) | W2 | 멱등성·lease·cache의 실패 분류에 `metadata().ambiguousExecution()`로 NOT_SENT/AMBIGUOUS 구분 추가 | +| S3-#4b | Required | "lease 빌림 → `.get(timeout)` → 예외 처리" 틀 복사, Lua 응답 디코더 3벌 | 남음 | `catch (InterruptedException` 16곳(멱등성 6·lease 4·cache 4·rate-limit 1·probe 1), 디코더 `idempotency/IdempotencyScripts.java:273`, `lease/LeaseScripts.java:162`, `ratelimit/RateLimitScripts.java:280` | W3 | `SemanticRedisCall.run(...)` 공통 틀 + 응답 디코딩을 등록 스크립트 쪽 한 곳으로 | +| S3-#5 | Consider | `RedisIdempotencyStoreAdapter.transition` 인자 14~15개, 상태 문자열 switch 반복 | 남음 | `cache-redis/.../idempotency/RedisIdempotencyStoreAdapter.java:164-180`(`transition` 호출 14개 인자), `:137-157` 등 문자열 switch | W3 | `IdempotencyScripts.Reply`에서 `enum ScriptStatus`로 한 번 파싱, 호출부는 `Map` | +| S3-#6 | Consider | 대체 불가능한 확장 지점(`HttpClientTagPolicy` bean) | 남음 | `httpclient/.../autoconfigure/HttpClientObservationAutoConfiguration.java:23-27` bean 소비처 0, `restclient/BlockingExecutionSupport.java:77`이 `HttpClientTagPolicy.standard()`를 다시 생성, `observation/HttpClientTagPolicy.java:32` private 생성자라 override 자체 불가 | W3 | bean 삭제, `BlockingExecutionSupport`는 `ExecutionSupport`로 개명 | +| S3-#7 | Consider | 구현 1개짜리 인터페이스 4개 | 남음 | `httpclient/.../resilience/RetryCoordinator`(구현 `BlockingRetryCoordinator`), `RetryEligibilityEngine`/`Default…`, `ExecutionEvidenceClassifier`/`Default…`, `BackoffStrategy`/`ExponentialFullJitterBackoff` | W3 | 인터페이스 삭제, 구현체를 인터페이스 이름으로 개명 | +| S3-#8a | Consider | `BoundedErrorBody`·`spring7/*`·`migration/*` 도달 불가 | 해당 없음(코드 삭제) | 「제거된 코드」 httpclient `BoundedErrorBody`, Spring 7 service group·`RestTemplate` 이행 패키지 행 | - | - | +| S3-#8b | Consider | `MultipartReplayability`·`SafeHttpLogEvent`는 테스트만 참조 | 남음 | `httpclient/.../webclient/MultipartReplayability.java`(참조 `FirstByteRetryBoundaryTest`뿐), `observation/SafeHttpLogEvent.java`(참조 `HttpClientTagPolicyTest`뿐) | W3 | 두 클래스와 전용 테스트 삭제(http3는 유지) | +| S3-#9 | Consider | `RedisTopologyClientFactory` 662줄 역할 과다 | 남음 | `redis-runtime/.../lettuce/connection/RedisTopologyClientFactory.java` 662줄(변화 없음) | W3 | `RuntimeClient` 구현 3개·`SharedClientResources`를 package-private top-level 클래스로 이동 | +| S3-#10 | Consider | settings → profile 필드 단위 복사, `valueOf(toUpperCase())` 반복 | 남음 | `httpclient/.../autoconfigure/HttpClientProfileFactory.java` 153줄, `toUpperCase` 8회 | W3 | settings 필드를 enum 타입으로 선언(binder가 대소문자 변환), 복사 구조는 유지 | +| S3-#11 | Nit | 이력 서술 주석·inline FQN | 남음 | 재측정 "used to/no longer": httpclient 27·redis-runtime 6·redis-sdk 9·cache-redis 7줄, `cache-redis/.../capability/RedisCapabilityConfig.java:30-32` "376 lines … (BOOT-007)", httpclient inline FQN 약 91줄 | W5 | 불변 조건만 남기고 이력은 git/ADR로, FQN은 import로(`HttpMethod`/`HttpStatus` 충돌만 예외) | +| S3-#12a | Nit | `CacheKeys`가 가변 generation 상태 보유, `KeyDigest`가 설정 패키지에 | 남음 | `cache-redis/.../cache/RedisCacheRegionAdapter.java:375,430`(`CacheKeys.observeGeneration`), `capability/RedisKeys.java:37` `KeyDigest` | W5 | `RegionGeneration` 분리, `KeyDigest`를 keyspace 패키지로 옮기고 `RedisNamespace.prefix()` 사용 | +| S3-#12b | Nit | cache-redis CLAUDE.md의 "legacy cache router"는 존재하지 않음 | 남음 | `adapter/outbound/cache-redis/CLAUDE.md:22` | W5 | 해당 줄 삭제 | +| S3-#13a | Nit | Jackson 2 사용 main 파일은 하나인데 주석은 "two files" | 남음 | `httpclient/build.gradle:67` vs Jackson 2 import는 `restclient/RemoteProblemDecoder.java`뿐 | W5 | `RemoteProblemDecoder`를 Jackson 3로 옮기고 `jackson-databind`(2) 의존 삭제 | +| S3-#13b | Nit | draining·retry 소진을 `HttpRateLimitRejectedException`으로 던짐(텔레메트리 카테고리 오기) | 남음 | `httpclient/.../restclient/DefaultGenericHttpGateway.java:182,280`, `webclient/DefaultReactiveHttpGateway.java:265,351` | W2 | draining·retry 소진 전용 예외(또는 카테고리)로 분리 | +| S3-#13c | Nit | Redis health indicator 둘이 DOWN 값만 다름 | 남음 | `redis-runtime/.../sdk/config/RedisSdkAutoConfiguration.java:257`(DEGRADED)·`:285`(DOWN) | W5 | 상태 값만 인자로 받는 indicator 하나로 | +| S3-lead-1 | 권고 | `RedisSecretSource` + `System.getenv` 기본값 vs `SecretSourcePort` (= X2 P1-1) | 완료 | 문제 아님: redis-runtime은 의존 edge가 없어 자체 SPI(`RedisSdkAutoConfiguration.java:168-171,334`)를 두고, cache-redis가 `SecretSourcePort`로 bridge(`cache-redis/.../capability/RedisCapabilityConfig.java:66`). X2 P1-1이 이 구조를 모범 사례로 판정 | - | - | +| S3-lead-2 | 권고 | `HttpClientEnvironmentKeys`(리플렉션 env 이름 역산) vs `StrictSettingsBinder` (= X2 P1-3) | 남음 | `httpclient/.../autoconfigure/HttpClientEnvironmentKeys.java`(179줄, `RecordComponent` 순회), `HttpClientPlatformSettingsBinder.java:27`만 사용. 다른 capability는 env 오타 검사 없음 | W3 | env 이름 역산 검사를 support `StrictSettingsBinder` 옵션으로 옮겨 모든 capability가 같은 방식으로 오타 env를 거부 | +| S3-lead-3 | 권고 | TLS material 로딩이 Redis와 httpclient에 따로 | 완료 | 문제 아님: Redis는 Lettuce `SslOptions`에 PEM 위치만 넘김(`RedisTopologyClientFactory.java:327-362`), httpclient는 JSSE `KeyStore`·`TrustManagerFactory` 구성(`security/TlsMaterialProvider.java`). 클라이언트 API가 달라 공유할 코드가 없고 redis-runtime은 의존 edge 0 | - | - | +| S3-lead-4 | 권고 | `ca-skeleton.capabilities.*` selector 문자열이 여러 leaf에 흩어짐 | 남음 | main 13파일(sample, app-bootstrap 3, web 1, persistence-jpa 3, redis-runtime `RedisCorrectnessRoles.java`, cache-redis 4), `...idempotency.provider` 30회 | W3 | 역할별 selector 키를 한 곳(멱등성은 S1-lead-3의 composition 모듈, Redis는 `RedisCorrectnessRoles`)에 상수로 두고 나머지는 그 상수/조건 클래스를 사용 | +| S3-lead-5 | 권고 | `secret:///` 파싱이 다른 leaf에도 | 남음 | 4곳: `httpclient/.../HttpClientAuthenticationAutoConfiguration.java:61-64`, `cache-redis/.../capability/RedisKeys.java:82-88`, `redis-runtime/.../RedisCredentialResolver.java:24`, `persistence-mongo/.../security/MongoCredentialReference.java:22` | W3 | application-core `SecretSourcePort` 옆에 `SecretReference.parse` 하나, httpclient·cache-redis가 사용(mongo·redis-runtime은 edge 없어 유지) | + +**조사 메모** + +- 겹침: S1-#2b = S2-#4b = S2-lead-1 = X1-#1 (결정 하나로 셋이 정리됨). S1-#1·S2-#4a = X1-#2. S1-lead-3는 1차 G-11과 같고 소유자 결정(`composition:*` 이동)이 남은 일. outbox relay 조립(`app-bootstrap/.../autoconfigure/outbox/OutboxConfig.java`)도 같은 결정 대상이지만 이 세 절에는 해당 Finding이 없음. S1-#18b와 S2-#13b는 한 번에 개명. S3-#2a는 S3-#1 결정을 따름. +- D4(WebFlux 삭제)는 inbound(web·web-fileserver·notification callback)만 지웠다. httpclient reactive 스택(`webclient/`, `reactor/`, spring-webflux 의존)은 그대로라 S3-#1을 `결정 필요`로 둠. +- 계획 Wave 4 표는 "notification persistence를 `persistence-notification` leaf로 추출(S2 #1)"이라고 적었지만 registry·코드에 없음(S2-#1b 남음). +- S2-#2b·S2-#7은 리뷰 권고(삭제/별도 라이브러리)가 아니라 소유자 결정(Wave 3 "완성해서 포장", README에 라이브러리 API 표)으로 닫혔다. 동작하지 않는 약속만 삭제됨. +- 리뷰가 틀렸거나 과했던 것: + - S2-lead-2: "claim 판정표를 application-core 순수 함수 하나로"는 불가. Redis 판정은 원자성 때문에 Lua 안에서 일어난다. 대신 공통 계약 테스트로 방향을 바꿈. + - S3-lead-1: 문제 아님(bridge 구조가 의도된 방식). S3-lead-3: 클라이언트 API가 달라 공유할 코드가 없음. + - S3-#6: `HttpClientTagPolicy`는 private 생성자라 bean을 바꿔 끼울 방법이 처음부터 없음. override가 안 되는 이유는 support 재생성만이 아님. + - S2-#6c: fileserver 사본은 jpa edge가 없는 leaf에 있어 리뷰의 `PostgreSqlStoreSupport` 하나로는 합칠 수 없음. + - S1-#11 권고 위치(application-core `Sha256.hex`)와 X2 P1-5 권고 위치(shared-contract `Sha256`)가 다름. 현재 `Sha256`은 application-core `messaging/contract`에 있음. + +## 2차 S4 Outbound capability · S5 Inbound HTTP/GraphQL + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| S4-#1 | Required | fileserver 루트 publication 제품군(R1+R2, 31파일 8.7k줄) 호출처 없음 (= X1-8) | 완료 | `src/adapter/outbound/fileserver/src/main/java/.../fileserver/` 아래 `platform/`만 남음(main 5,626줄). `FilePublicationPort`·`FileExportPort`·`FileserverActivationValidator`·`app.file-export.*` grep 0건. 「제거된 코드」 표 76–78행, 커밋 `6d27356e` | - | - | +| S4-#2 | Required | messaging R1 compiler/encoder 체인·realtime fanout 미연결 | 완료 | `src/adapter/outbound/messaging` main 13파일 765줄(`core`·`outbox`·`platformbridge`·`autoconfigure`만). NetworkNT는 `build.gradle`에 `testImplementation`만. `JsonSchemaIntegrationEventEncoder`·`CompiledMessagingDescriptor`·`MessagingDurableFanoutAdapter` grep 0건. 「제거된 코드」 표 119–122행과 `realtime/` 행, `6d27356e` | - | - | +| S4-#3a | Required | notification 미조립 provider 5종(APNs·FCM·Twilio·WebPush·Webhook) | 남음 | `notification/…/platform/provider/{apns,fcm,twilio,webpush,webhook}` 재측정 2,750줄(327+526+681+863+353). 자기 패키지 밖 main 참조 0건. assembler는 `SesProviderRuntimeAssembler.java:28`, `SmtpProviderRuntimeAssembler.java:48` 두 개뿐. `ProviderType.java:22-41`에 7종이 남아 있고, 켜면 `NotificationProviderAssembly.java:144`에서 기동 실패. 계획서 W4 표는 "미조립 provider 5종 삭제"라고 했지만 코드도 「제거된 코드」 표 행도 없음 | W3 | 5개 패키지 삭제. `ProviderType`에서 APNS·FCM·TWILIO·WEB_PUSH·WEBHOOK 제거. `docs/notification/configuration-reference.md:69,106-114` 표 정리. 「제거된 코드」 표에 행 추가 | +| S4-#3b | Required | SES callback은 조립되는데 projector 없음 → 모든 callback 이벤트가 `NO_PROJECTOR`로 실패 처리 | 남음 | main에 `ProviderEventProjector` bean이 0개임. `NotificationPlatformRegistriesConfig.java:36-40`는 빈 `List`로 registry를 만듦. `NotificationProviderAssembly.java:175`가 모은 `AssembledPlatform.projectors`를 읽는 곳 0건. 그래서 `ProviderEventProjectionService.java:80-82`가 `markFailed(…, "NO_PROJECTOR")` 처리. `SesDeliveryProjector`·`SesSuppressionUpdater` main 참조 0건인데 `SesProviderCallbackAssembler.java:13`은 조립됨 | W2 | SES callback assembler가 `SesDeliveryProjector`를 `AssembledProvider`에 싣고, registry는 `AssembledPlatform.projectors()`로 만든다. suppression을 적용하려면 `SesSuppressionUpdater`도 연결. SES callback이 bounce를 반영하는지 통합 테스트 1개 추가 | +| S4-#3c | Required | reconciliation 슬롯·자격증명 회전 경로에 production 입력 없음 | 남음 | `TwilioReconciliationCapability`·`ProviderRuntimeRotator` main 참조 0건. `RuntimeDrainCoordinator`·`CredentialProbe`는 `ProviderRuntimeRotator`만 참조하고 `CredentialProbe` 구현체는 0개. `NotificationPlatformProviderConfig.java:148`이 항상 빈 `reconciliations`로 gateway를 만듦. 두 assembler 모두 `AssembledProvider.dispatchOnly`(`SesProviderRuntimeAssembler.java:98`, `SmtpProviderRuntimeAssembler.java:112`) | W3 | `ProviderRuntimeRotator`·`RuntimeDrainCoordinator`·`CredentialProbe` 삭제. reconciliation 슬롯은 #3a와 함께 지우거나, 남길 경우 README에 "SES/SMTP는 reconciliation 없음" 한 줄 | +| S4-#4a | Required | SMTP capability 값이 두 곳에서 다름 | 남음 | `SmtpProviderRuntimeAssembler.java:126,138-152`: 자기 사본 `25L*1024*1024`(26,214,400), `Duration.ofHours(24)`. `SmtpNotificationProviderAdapter.java:75-76`: 25,000,000, `Duration.ofDays(1)`. SES는 `adapter.capabilities()`를 씀(`SesProviderRuntimeAssembler.java:95`) | W2 | assembler의 `capabilities()` 사본을 지우고 `adapter.capabilities()`를 쓴다. 값 하나로 확정 | +| S4-#4b | Required | `ProviderCapabilities` 위치 인자 11개를 8곳에서 `new` | 남음 | `application-notification/…/provider/ProviderCapabilities.java:12-23`(boolean 8개 + int·long·Duration). main에서 `new ProviderCapabilities(` 8곳(SMTP assembler, SMTP·SES·APNs·FCM·Twilio·WebPush·Webhook adapter). #3a를 하면 3곳이 남음 | W3 | #3a 이후 `ProviderCapabilities.dispatchOnly(maxPayloadBytes, maxTtl)` 같은 named factory 하나 추가 | +| S4-#5 | Required | `LocalPersistentControlPlane`(1,470줄)이 7가지 일을 함 | 해당 없음(코드 삭제) | S4-#1과 함께 삭제. `LocalPersistentControlPlane` grep 0건. 「제거된 코드」 표 76행 | - | - | +| S4-#6 | Required | "attested root 아래 private shard" 구현 3벌 | 해당 없음(코드 삭제) | `LocalPersistentControlPlane`·`LocalPersistentPayloadOperations`·`LocalPersistentRootAttestor`·`LocalPublicationJournal`·`LocalFilePublicationAdapter` 모두 grep 0건. 남은 `forceDirectory`는 `platform/local/ContentPublishVerification.java:106` 하나. 「제거된 코드」 표 76행 | - | - | +| S4-#7 | Required | 손으로 만든 flat JSON parser 2개 | 해당 없음(코드 삭제) | `FileserverControlRecordCodec`·`LocalPublicationJournalCodec` grep 0건. 「제거된 코드」 표 76행 | - | - | +| S4-#8 | Consider | 원시 String 검증 73곳을 Value Object로 | 해당 없음(코드 삭제) | 대상 `FileserverControlRecordCodec`·`FileserverR2Validation` 삭제. 남은 `requireText` 9곳은 모두 설정 검증(`FileserverPlatformSettings.java:54-313`) | - | - | +| S4-#9 | Consider | notification HTTP provider 공통 템플릿이 반만 있음 | 남음 | HTTP adapter 5개가 여전히 각자 send 템플릿을 구현(`Apns`/`Ses`/`TwilioSms`/`WebPush`/`WebhookNotificationProviderAdapter`). main `new ProviderFailure(` 25곳 | W3 | #3a를 하면 HTTP provider가 SES 하나만 남아 자동으로 해소됨. 그때 이 행을 닫는다(별도 helper 불필요) | +| S4-#10 | Consider | objectstorage legacy adoption은 켜면 기동 실패 | 완료 | `maintenance/`, `ObjectStorageLegacyMigrationConfig`, `LegacyObjectAdoptionSettings`, readiness Evidence/Card, `ObjectControlRecordEnvelope` grep 0건(`git diff 208077fd 6d27356e`에서 -860줄). 「제거된 코드」 표 84–86행 | - | - | +| S4-#11a | Consider | objectstorage legacy·신규 두 세대 공존 | 남음 | legacy: 루트 `ObjectStorageConfig.java`, `S3ObjectStorageAdapter.java:32-39`(동기 `S3Client`), `FilesystemObjectStorageAdapter.java:24`(`ObjectStoragePort`). sample이 legacy를 씀(`PosterImageApiConfig`, `UploadPosterImageUseCase`). 신규 `ManagedObjectPublicationPort`는 adapter 밖 소비자 0건. README `:68-78`은 legacy를 deprecated로 적음 | W3 | sample을 신규 포트로 옮긴 뒤 `ObjectStoragePort`·`StoredObject`·legacy 어댑터 2개·`ObjectStorageConfig`·`LegacyObjectStorageActivationGuard` 삭제 | +| S4-#11b | Consider | objectstorage 패키지 위치 불명확(port 구현이 `config/`에, managed publish가 router inline) (≈ D-7, D-8) | 남음 | `config/`에 `Routing{Mutation,Read,ScanMaintenance,DirectGrant}Adapter`. `RoutingObjectMutationAdapter.java` 523줄은 `208077fd` 이후 변경 없음. `RoutingObjectDirectGrantAdapter.java:7-9`는 private 생성자만 있는 빈 클래스 | W3 | `Routing*Adapter`를 `routing/`로 옮기고, managed publish 부분을 `kernel/`로 추출. 빈 `RoutingObjectDirectGrantAdapter` 삭제 | +| S4-#12 | Consider | `SelectedObjectStorageProviderFactory`가 type-unsafe service locator (≈ D-7) | 남음 | `config/SelectedObjectStorageProviderFactory.java:14-16`에 `Object` 슬롯 3개, `:20-53`에 생성자 4개, `:71-89`에 `Class.cast`. 슬롯 getter 호출은 test(`S3ProviderCompositionTest.java:132,140`)뿐. direct(1,735줄)·multipart(318줄) 패키지는 남아 있음 | W3 | direct/multipart 슬롯 제거 후 `record ProviderInstance(ObjectStorageProvider, ObjectControlStore, Runnable close)`로 교체. direct/multipart 삭제(1차 D-7)와 같이 진행 | +| S4-#13 | Consider | provider 1개인데 fileserver R2 routing 계층 | 해당 없음(코드 삭제) | `RoutingFilePublicationAdapter`·`FilePublicationProvider`·`LocalPersistentPublicationProvider` grep 0건. 「제거된 코드」 표 76행 | - | - | +| S4-#14a | Consider | `ProviderRuntime`의 무조건 덮어쓰기가 운영자 결정·인증 실패를 지움 | 남음 | `ProviderRuntime.java:127-132`의 `markAuthenticationFailed`가 무조건 `set`해서 DISABLED·DRAINING을 덮어씀. 반대로 `markDraining`·`markDisabled`(`:221-245`)는 AUTHENTICATION_FAILED를 덮어씀. 그래서 AUTH_FAILED→DISABLED→`resumeHealthy`(`:205`)→HEALTHY 순서로 "인증 실패는 resume 불가" 규칙이 우회됨 | W2 | 전이 규칙을 한 곳에 둔다. AUTH_FAILED는 rotation으로만 벗어나고, DISABLED/DRAINING은 인증 실패로 덮이지 않게. 두 순서에 대한 테스트 추가 | +| S4-#14b | Consider | 상태 전이 규칙이 7개 메서드에 흩어짐 | 남음 | `ProviderRuntime.java:127-245`에 `mark*`/`resumeHealthy` 7개가 각자 `updateAndGet` 조건을 가짐. `RegistryProviderRuntimeControl.java:30` switch | W3 | `EnumMap>` 전이표 + `transition(target, reason)` 하나로 (#14a와 같이) | +| S4-#15 | Consider | Settings가 모든 provider 필드를 한 record에 담음 | 남음 | `NotificationPlatformSettings.java:211-223`의 `Provider`가 `topic`·`vapidPublicKey`·`callbackSigningSecretRef`를 가짐(APNs·WebPush·Twilio 전용). `:288`은 `switch (resolved.name())` 문자열 분기. `:229-258`은 테스트 호환용 11-인자 오버로드 | W3 | #3a와 함께 미조립 provider 필드·분기 삭제, enum switch로 바꾸고 11-인자 오버로드 삭제 | +| S4-#16a | Nit | notification·fileserver 이력 서술 주석 | 남음 | 예: `ProviderType.java:10-15`, `:85`("used to bind successfully"), `NotificationProviderAssembly.java:30`, `MapProviderCallbackAdapterRegistry.java:10-11`(BOOT-017). grep 근사로 notification 37줄, fileserver 12줄 | W5 | 주석을 현재 동작만 설명하도록 줄이고, 이력은 commit/ADR로 | +| S4-#16b | Nit | objectstorage main의 inline FQN | 남음 | grep 근사 92줄. 예: `ObjectStorageConfig.java:30`, `control/CanonicalJsonObjectControlRecordCodec.java:649,847-862`, `s3/S3ClientPolicy.java:137` | W5 | import로 바꾼다(Spotless/Checkstyle 규칙으로 막을지는 선택) | +| S4-#17a | Nit | fileserver `*Config`/`*Configuration` 혼재, 클래스 이름의 버전 라벨 | 해당 없음(코드 삭제) | 루트 `*Config`(`FileserverR2Config` 등)와 `R2PublishedReferenceCodec` 삭제. 남은 fileserver 설정 8개는 모두 `*Configuration` | - | - | +| S4-#17b | Nit | notification `*ProviderProperties`는 `@ConfigurationProperties`가 아닌 파생 값 | 남음 | `Apns`/`Fcm`/`Ses`/`Smtp`/`Twilio`/`WebPushProviderProperties` 6개. 어느 것도 `@ConfigurationProperties`가 아님 | W5 | #3a 이후 남는 `Ses`·`SmtpProviderProperties`를 `*ProviderProfile`로 이름 변경 | +| S4-lead-1 | 권고 | 손으로 만든 canonical JSON codec이 3개 leaf에 있음 (= X1-8) | 해당 없음(코드 삭제) | fileserver 2벌·messaging `DeterministicEnvelopeWriter` 삭제. 남은 건 objectstorage `control/CanonicalJson{Reader,Writer}.java` 하나라 중복 아님 | - | - | +| S4-lead-2 | 권고 | 로컬 보안 파일시스템 primitive가 fileserver·objectstorage에 따로 있음 | 남음 | fileserver `platform/local/SafeFileChannelFactory.java:250`(`SecureDirectoryStream`)·`SecureDirectoryWalk.java`. objectstorage `filesystem/LocalObjectPathGuard.java:62-117`은 경로 검사 후 사용 방식(`rejectExistingLinks` → 생성). 방식과 검사가 다름. objectstorage는 `adapter-outbound-support` edge가 없음 | W3 | fileserver 쪽 primitive를 `adapter:outbound:support`로 올리고, objectstorage에 support edge를 추가해서 `LocalObjectPathGuard`가 그것을 쓴다(registry 수정 포함) | +| S4-lead-3 | 권고 | notification 자체 JDK HTTP gateway·SigV4 서명기 vs httpclient leaf·AWS SDK | 남음 | `provider/http/*` 464줄(`JdkNotificationHttpGateway` 외), `ses/AwsSignatureV4Signer.java` 147줄. notification `build.gradle`에는 AWS SDK·httpclient 의존 없음. objectstorage만 AWS SDK를 씀 | W3 | 결정(2026-09-25): AWS SDK(sesv2)로 교체, 자체 JDK gateway·SigV4 서명기 삭제 | +| S4-lead-4a | 권고 | adapter `LocalJsonSchemaRegistry` vs vendored `messaging-schema-json` | 해당 없음(코드 삭제) | `LocalJsonSchemaRegistry` grep 0건. 「제거된 코드」 표 123행 | - | - | +| S4-lead-4b | 권고 | `adapter:outbound:messaging-kafka`(R0 seam) vs vendored `messaging/messaging-kafka` | 남음 | `src/adapter/outbound/messaging-kafka` main 371줄(`LegacyKafkaMessagingRootAutoConfiguration`, `KafkaSender`, `KafkaMessageBroker`). legacy outbox가 `OutboxMessagePublishAdapter` → `MessageBroker`로 이 경로를 씀. `src/messaging/CLAUDE.md:75-78`에 MSG-015 cutover가 끝나지 않았다고 적혀 있음 | W3 | legacy `OutboxEvent`에 canonical metadata를 채우는 migration 후 relay를 bridge로 바꾸고 `adapter:outbound:messaging-kafka`와 `core/MessageBroker` 계열 삭제 | +| S4-lead-5 | 권고 | `ProviderCapabilities` 위치 인자 11개 → named factory | 남음 | S4-#4b와 같음 | W3 | S4-#4b 참조 | +| S5-#1a | Required | WebProblem 어휘(`ProblemCode`·`ProblemCatalog`·yaml·핸들러·writer) (= X2-P2-1) | 완료 | `ProblemCatalog`·`WebProblem`·`problem-catalog.yaml`·`ThrottleProblemWriter`·`WebMvcBudgetExceptionHandler` grep 0건. 「제거된 코드」 표 99·104·105행, `6d27356e` | - | - | +| S5-#1b | Required | 검증 규칙표 두 벌(`ClientSafeValidationDetails` vs `WebValidationIssueMapper`) | 완료 | `W/validation/` 삭제(표 103행). 남은 것은 `web/error/ClientSafeValidationDetails.java` 하나 | - | - | +| S5-#1c | Required | fileserver가 운영에서 problem+json을 보냄(Envelope와 다른 형식) (= X2-P2-3) | 남음 | `web-fileserver/…/problem/FileserverExceptionHandler.java:39-48`가 `APPLICATION_PROBLEM_JSON`과 `FileserverProblem`(필드 15개, `FileserverProblem.java:17-32`)을 보냄. `FileserverErrorCode`는 이미 `ApiErrorCode` 구현(`application-fileserver/…/FileserverErrorCode.java:24`). Retry-After 표도 web `observability/RetryAfterAdvisor.java:14`와 `FileserverProblemHeaders.java:30`에 따로 있음 | W3 | 소유자 결정대로 `ErrorResponseFactory` Envelope로 바꾸고 `FileserverProblem`·`FileserverProblemFactory`·`FileserverProblemTitles`를 삭제. 파일 식별 필드(fileId·uploadId·offset)는 Envelope `details`로. tus 헤더와 Retry-After·`Content-Range` 헤더는 유지(`FileserverProblemHeaders`) | +| S5-#1d | Required | Draft-12 offset mismatch problem 문서 | 남음 | `draft12/Draft12UploadController.java:136-142`가 드래프트가 정한 `Draft12OffsetProblem`을 problem+json으로 보냄. 소유자 결정("Envelope 하나, tus 헤더만 유지")에는 Draft-12 예외가 없음 | W3 | 결정(2026-09-25): 프로토콜 예외로 유지(X2-P2-3b와 같은 작업) | +| S5-#2 | Required | WebFlux 쌍둥이 코드는 어떤 조합에서도 안 켜짐 | 완료 | web·web-fileserver main에 `Type.REACTIVE`·`ServerWebExchange`·webflux 의존 0건. `webFluxContractTest`·`webFluxPerformanceTest` gradle 참조 0건. 「제거된 코드」 표 88–92행, `6d27356e` | - | - | +| S5-#3 | Required | `WebMvcPlatformAutoConfiguration` bean 14개 중 9개는 읽는 곳 없음, startup check는 실패 불가 | 완료 | `web/…/mvc/autoconfigure/WebMvcPlatformAutoConfiguration.java` 75줄, bean 3개(`globalExceptionHandler`, `webMvcRequestIdFilter`, `webMvcRequestContextConfigurer`). `WebMvcEvidenceFilter`·`WebMvcPlatformStartupCheck`·`WebPlatformSnapshot` grep 0건. 표 102행 | - | - | +| S5-#4a | Required | 조건부 요청 1·2세대 두 벌 (= I-8) | 완료 | `web/conditional/`에 `ETags`·`PreconditionFailedException`만 남음. `EntityTag` 등 grep 0건. 표 96행 | - | - | +| S5-#4b | Required | 페이지네이션 두 벌, cursor codec web 2벌 (= I-8, X2-P1-4) | 완료 | `web/pagination/`에 `PageParams`·`SortParam`·`PageValidationException`만 남음. `CursorCodec`·`HmacWebCursorCodec`·`WebCollectionRequestParser` 0건. 표 94·97행. graphql `pagination/HmacGraphQlCursorCodec.java`는 서비스가 직접 조립하는 라이브러리로 남김(표 "`backend.graphql.cursor.key-ids`" 행) | - | - | +| S5-#4c | Required | 헤더 상수 `ApiHeaders`·`WebHeaderName` 11개 겹침 (= I-8) | 완료 | `web/http/`에 `ApiHeaders.java`만 남음. 표 98행 | - | - | +| S5-#4d | Required | rate limit 두 벌 (= I-8, X1-5, X2-P2-7) | 완료 | `WebRateLimiter`·`WebMvcThrottleFilter`·`admission/*`·`advanced/ratelimit` 0건. 운영은 `web/ratelimit/RateLimitInterceptor.java`. 표 99–101행 | - | - | +| S5-#4e | Required | 로깅 `RequestLoggingFilter` vs `WebAccessLog*`/`WebAudit*` (= I-8) | 완료 | `web/observability/`에 `WebAccessLog*`·`WebAudit*` 없음. 표 95행 | - | - | +| S5-#4f | Required | 동시 실행 제한 semaphore 3벌 (= I-8) | 완료 | `SemaphoreAdmissionController`(admission)·`BlockingBridgeBudget` 삭제(표 101행, blocking bridge 행). 남은 건 opt-in `web-advanced/…/virtualthread/VirtualThreadAdmissionGuard.java` 하나 | - | - | +| S5-#5 | Required | Retry-After 초 계산 3벌, 결과가 다름 | 해당 없음(코드 삭제) | `ThrottleProblemWriter`·`OperationHttpController`·`ReactiveOperationHttpController` 삭제. Duration→초 계산은 `RateLimitInterceptor.java:107-111`(올림) 하나만 남음 | - | - | +| S5-#6a | Required | GraphQL 요청 단계 에러가 `GraphQlWireErrorMapper`를 거치지 않음 → adopter `ApiErrorCarrier`가 요청 단계에서 `INTERNAL_ERROR`로 바뀜 | 남음 | `graphql/…/runtime/GraphQlPlatformWebInterceptor.java:165`, `GraphQlPlatformInstrumentation.java:88`이 `GraphQlPlatformRejectionMapper.map`을 직접 호출. `GraphQlWireErrorMapper.java:23-28` Javadoc도 이 차이를 인정 | W2 | 두 호출부가 `GraphQlWireErrorMapper`의 `map(Throwable, ctx)` 하나(플랫폼 거부 → `ApiErrorCarrier` → application mapping 순서)를 쓰게 한다. principal resolver가 `ApiErrorCarrier`를 던지는 테스트 추가 | +| S5-#6b | Required | 호출처 0인 `mapRequestRejection`과 참조 0인 error 클래스 | 완료 | `mapRequestRejection`·`GraphQlRequestErrorMapper`·`GraphQlSubscriptionExceptionResolver`·`GraphQlNullabilityContract` grep 0건. 표 "`GraphQlWireErrorMapper.mapRequestRejection`" 행과 `error/` 행 | - | - | +| S5-#6c | Required | Category switch 3개와 client 문구 중복 | 남음 | `GraphQlWireErrorMapper.java:94`(category), `:104`(clientMessage), `GraphQlWireErrors.java:56`. "요청한 리소스를 찾을 수 없습니다." 3곳(`GraphQlWireErrorMapper.java:108`, `GraphQlPlatformRejectionMapper.java:69`, `security/GraphQlAuthorizationInterceptor.java:50`) | W3 | `EnumMap` 표 하나로 switch 3개를 대체하고 문구 상수를 한 곳에 둔다 | +| S5-#6d | Required | 플랫폼 예외 `instanceof` 사슬 9개, 실제 매퍼가 `runtime/`에 있음 | 남음 | `GraphQlPlatformRejectionMapper.java:55-114`에 instanceof 9개. `GraphQlWireErrorMapper`·`GraphQlPlatformRejectionMapper`·`GraphQlWireErrors`가 `runtime/`에 있음(`error/`에는 타입만) | W3 | 플랫폼 예외가 code·category·message 인터페이스를 구현하게 해 instanceof 사슬을 없애고, 매퍼 3개를 `error/`로 옮긴다 | +| S5-#7a | Consider | `GraphQlPlatformAutoConfiguration` 한 클래스에 bean 약 40개·10가지 기능 | 남음 | `graphql/…/autoconfigure/GraphQlPlatformAutoConfiguration.java` 656줄(706→656), `@Bean` 38개. FQN `@org.springframework.context.annotation.Configuration`(`:78`) | W3 | 기능별 `@Configuration`(검증·runtime 감지·body limit·chain·auth·cost·error·관측·cache·DataLoader)으로 나누고 `GraphQlRootAutoConfiguration`의 `@Import`에 나열 | +| S5-#7b | Consider | 부팅마다 reflection 아키텍처 검사(`architecture/` 969줄) | 완료 | `architecture/` 삭제, `graphQlControllerBoundaryCheck` bean 삭제(표 110·111행). 규칙 2개는 `graphql/src/test/…/GraphQlTransportBoundaryArchitectureTest.java`(ArchUnit)로 옮김 | - | - | +| S5-#7c | Consider | autoconfig Javadoc이 사실과 다름 | 남음 | `GraphQlPlatformAutoConfiguration.java:70-76`은 "A real @AutoConfiguration … ordered after Spring Boot's GraphQL auto-configuration"이라고 적었지만 클래스는 `@Configuration`이고, `GraphQlRootAutoConfiguration`에는 `after` 선언이 없음. `GraphQlRootAutoConfiguration.java:29-30` 주석은 이미 삭제된 "scan 제외 정규식"을 전제로 함 | W5 | Javadoc을 실제 구조(root `@AutoConfiguration`이 import)에 맞추고, 순서가 필요하면 root에 `afterName`을 추가. 낡은 scan 주석 삭제 | +| S5-#8 | Consider | web이 하위 leaf 패키지 구조를 앎(`moduleboundary`) (= X1-7) | 완료 | web·graphql `moduleboundary` 디렉터리, `WebStableModule`, `WebBuildModel` grep 0건. 표 93·113행 | - | - | +| S5-#9 | Consider | notification HTTP가 일반 web leaf에 있음 | 완료 | `adapter:inbound:web-notification` leaf(15파일, modules.json 등록). web `build.gradle`에 `application-notification` 의존 없음. web main에 `application.notification` import 0건. `6d27356e` | - | - | +| S5-#10 | Consider | 업로드 세션 정책(namespace, 만료 시각)이 transport마다 복사됨 | 남음 | reactive 삭제 후 3곳: `FileUploadController.java:185,191`, `tus/TusController.java:102,107`, `draft12/Draft12UploadController.java:87,93`. TTL 설정·검증 3벌: `FileserverWebProperties.java:16,24-26`, `TusProperties.java:15,22`, `Draft12Properties.java:13-21` | W3 | application-fileserver가 `UploadMode`별로 namespace·만료 시각을 계산하고, 컨트롤러는 mode만 넘긴다(HARD-STOP 4) | +| S5-#11 | Consider | `compat/GraphQlSchemaComparator` 등이 graphql-java `SchemaDiff`를 재구현 (= J-10 일부) | 완료 | `compat/` 11개 삭제(표 112행), `GraphQlSchemaComparator`·`GraphQlChangeKind` grep 0건 | - | - | +| S5-#12 | Nit | profile-name record 5개가 같은 정규식을 복사 | 남음 | `web-advanced/…/advanced/operation/{Admission,Authorization,Response}ProfileName.java:17`, `CachePolicyName.java:17`, `advanced/budget/WebBudgetProfileName.java:17` 모두 `[a-z][a-z0-9.-]{2,63}`, 합계 175줄. 값이 달랐던 `RateLimitProfileName`은 삭제 | W5 | `ProfileName` record 하나로 합친다 | +| S5-#13 | Nit | GraphQL `Unsupported` 플래그 6개는 켜면 부팅 실패만 함 | 완료 | `GraphQlPlatformSettings`·`GraphQlPlatformStartupValidator`에 `Unsupported` 0건. 표 "`backend.graphql.unsupported.*`" 행 | - | - | +| S5-#14a | Nit | web README 패키지 루트가 틀림 | 완료 | `web/README.md:3` → `dev.caskeleton.adapter.inbound.web` | - | - | +| S5-#14b | Nit | web 문서에 WebFlux·notification·problem catalog·advanced·operationasync 설명 없음 | 완료 | WebFlux·problem·operationasync 삭제, notification은 web-notification으로 이동. 라이브러리는 `web-advanced/README.md`(69줄)·`CLAUDE.md`에 적힘. web README는 기본 경로만 설명(`:3-6`) | - | - | +| S5-#14c | Nit | web-fileserver에 CLAUDE.md/README 없음 | 남음 | `src/adapter/inbound/web-fileserver/`에 `*.md` 0개. 새 leaf `web-notification`도 0개(composition 쪽 README만 있음) | W5 | 두 leaf에 README(제공 기능·조립 경로·설정 prefix)와 짧은 CLAUDE.md 추가 | +| S5-#14d | Nit | graphql 주석 과다·이력 서술·"design §"·inline FQN | 남음 | graphql main 12,435줄 중 주석 4,003줄(32%). "design §" 48(92→48), "Task N" 3(17→3), inline FQN 약 50줄(92→약 50, grep 근사). web은 주석 16%, FQN 7줄로 해소 | W5 | 이력·설계서 번호 주석을 줄이고 FQN을 import로 | +| S5-#14e | Nit | `GraphQlPlatformWebInterceptor` 생성자 인자 9개 | 남음 | `GraphQlPlatformWebInterceptor.java:66-75`. anonymous 관련 3개(`anonymousProfile`, `anonymousTenant`, `anonymousProfileProtected`) | W5 | anonymous 3값을 record 하나로 묶는다 | +| S5-lead-1 | 권고 | client 에러 문구 언어가 전송마다 다름(web 영어, graphql 한국어) (= X2-P2-1) | 남음 | web `error/ClientSafeErrorMessages.java:44-50` 영어, graphql `GraphQlWireErrorMapper.java:104-113` 한국어. gRPC `GrpcStatusMapper.java:33`은 status만 매핑(문구 없음). status/분류 매핑은 전송마다 달라서 공유할 수 없음 | W3 | 결정(2026-09-25): client 에러 문구는 한국어 — `Category`별 문구 표 하나를 shared-contract에 두고 모든 전송이 사용 | +| S5-lead-2 | 권고 | moduleboundary 세 번째 사본(websocket) | 해당 없음(코드 삭제) | `WebSocketStableModule`·`WebSocketBuildModel` 0건. 표 80행 | - | - | +| S5-lead-3 | 권고 | request/tenant context 타입이 전송마다 따로 있음 (= X2-P2-6) | 남음 | 이름이 같은 `TenantContext` 두 개의 모양·검증이 다름. web `core/TenantContext.java:17,20`은 `(String tenantId)`, `[A-Za-z0-9][A-Za-z0-9_.-]{0,63}`. graphql `context/TenantContext.java:15,17,30`은 `(value, source)`, 비어 있지 않고 128자 이하면 모두 허용. 같은 tenant가 한 전송은 통과하고 다른 전송은 거부됨 | W2 | tenant 값 타입 하나(검증 규칙 하나)를 application-core/shared-contract에 두고, 두 전송 context가 그것을 담게 한다 | +| S5-lead-4 | 권고 | release/promotion gate가 websocket/grpc에도 반복되는지 | 남음 | web·graphql·websocket gate는 삭제(표 80·114·115행, web Advanced release 행). grpc에 남음: `grpc/grpc-testkit/…/release/GrpcStableReleaseGate.java`, `grpc-advanced/grpc-advanced-bootstrap/…/release/GrpcAdvancedPromotionGate.java`. 둘 다 main 참조 0건(test만) | W3 | 두 gate와 테스트를 삭제하거나 test source set으로 옮긴다(S6/S7 grpc 항목과 같이) | +| S5-lead-5 | 권고 | bulkhead: graphql·fileserver·httpclient가 겹치는지 | 해당 없음(코드 삭제) | 겹치던 web `BlockingBridgeBudget`·`SemaphoreAdmissionController`는 삭제. 남은 3개는 방식이 다름: `GraphQlBlockingBridge.java:45-57`(bounded `ThreadPoolExecutor`+AbortPolicy), `BlockingTransferExecutor.java:26`(Spring `ThreadPoolTaskExecutor`), `BlockingAttemptBulkhead.java:39`(`Semaphore`). 각 100줄 이하 | - | - | + +**조사 메모** + +- **완료된 줄 알았던 D1 항목이 남아 있음:** notification provider 5종(S4-#3a, 2,750줄)과 objectstorage direct(1,735줄)·multipart(318줄, 1차 D-7)는 삭제되지 않았다. 「제거된 코드」 표에도 행이 없다. 계획서 W4 표에만 "미조립 provider 5종 삭제"가 적혀 있다. +- **리뷰가 틀린 것:** + - S4-#3 remedy "빈 projector 슬롯 제거"는 틀렸다. SES callback 수신은 조립돼 있어서, 슬롯을 지우면 안 되고 SES projector를 연결해야 한다(S4-#3b). 지금은 수신한 SES 이벤트가 전부 `NO_PROJECTOR`로 FAILED 처리된다. + - S5-#5 "운영 `RateLimitInterceptor`는 `"0"` 가능"은 틀렸다. `RateLimitDecision`(거부 시)과 `RateLimitOutcome.Unavailable`·`Indeterminate`가 retryAfter를 양수로 강제한다(`shared-contract/…/RateLimitDecision.java:31-33`, `RateLimitOutcome.java:24,34`). 그래서 올림 결과는 항상 1 이상이다(`208077fd`에서도 같음). +- **겹침:** S4-#4b = S4-lead-5. S4-#9와 S4-#15는 S4-#3a를 하면 대부분 해소된다. S4-#12는 1차 D-7(direct/multipart 삭제)과 같이 해야 한다. S5-lead-4의 grpc gate와 grpc `GrpcStableModuleCatalog`(계획 2-G 삭제 대상인데 남아 있음, main 참조 2)는 S6/S7 담당과 겹친다. +- **범위 밖이지만 발견한 것:** graphql에 reactive 잔재가 있다(`GraphQlPlatformAutoConfiguration.java:156-161` REACTIVE runtime 감지, `execution/GraphQlExecutionProfile.java:17` `REACTIVE_WEBFLUX`, `GraphQlPlatformStartupValidator.java:57,134`). D4(servlet 단일)와 맞지 않는다. + +## 2차 S6 Realtime/gRPC/composition/sample · S7 Vendored platforms + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| S6-#1a | Required | websocket STOMP 스택 2벌(`advanced/stomp/**`, `StompBrokerExclusivity`) | 해당 없음(코드 삭제) | `CS:79`. 현재 STOMP 조립은 `stomp/WebSocketConfig` 하나(`src/adapter/inbound/websocket/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:1`), `6d27356e` | - | - | +| S6-#1b | Required | websocket main의 gate·moduleboundary·evidence·release, 거짓 주석 `WebSocketAdvancedCapability` | 해당 없음(코드 삭제) | `CS:80`, `CS:185` | - | - | +| S6-#1c | Required | 조립되지 않는 websocket 플랫폼 라이브러리 약 9.7k줄 | 완료 | main 12,954 → 1,557줄(`stomp/` 491, `servlet`·`outbound`·`budget`·`core`·`protocol` 1,066). 나머지 패키지 삭제(`CS:185,187`). 남긴 라이브러리는 Wave 3 결정대로 README에 라이브러리 API로 명시(`src/adapter/inbound/websocket/README.md:6-13,56`), `6d27356e` | - | - | +| S6-#2a | Required | capability 의존 규칙이 6곳(CDV, DSR, `RedisActivationValidator`, ORBRV, `MasterSwitch`, endpoint)에 흩어짐 (= L-6) | 해당 없음(코드 삭제) | `CS:237`(DSR), `CS:241`(ORBRV), `CS:248`(`MasterSwitch`), `CS:249`(CDV·endpoint), `CS:252`(RAV). capability 의존은 build 줄로 표현(`src/app-bootstrap/build.gradle:139-153`) | - | - | +| S6-#2b | Required | `ca-skeleton.outbox.relay-enabled` 없을 때 기본값 해석이 여전히 갈림 | 남음 | 모듈 yml `false`(`src/adapter/outbound/persistence-jpa/src/main/resources/config/module-defaults/persistence-jpa.yml:189`) vs `matchIfMissing = true`(`BS/autoconfigure/outbox/OutboxConfig.java:69-72`) vs null이면 `true`(`BS/autoconfigure/outbox/OutboxSettings.java:34-36`). yml이 항상 먼저 채워 실제 동작은 false | W2 | relay 조립을 `composition:*` 모듈로 옮길 때(소유자 결정) 기본값을 `false` 하나로: `matchIfMissing` 삭제, `OutboxSettings` null 기본값을 `false`로 | +| S6-#2c | Required | Redis 역할 표 2벌, bootstrap이 Redis 역할별 prod secret 규칙을 앎 | 남음 | `RedisCorrectnessRoles.java:32-37`(redis-runtime) vs `BS/runtime/SecretSourceValidator.java:137-158`(prefix 분기) + 모듈 키 사본 `REDIS_ENABLED_PROPERTY`(`:31`), secret 목록 `:38-48` | W3 | Redis secret 요구 판정을 cache-redis 모듈로 옮기고 `RedisCorrectnessRoles` 표에서 파생; `SecretSourceValidator`는 모듈이 기여한 필요 secret 목록만 검사 | +| S6-#2d | Required | `capabilities.idempotency.provider` 기본값이 `disabled`/`jdbc`로 갈림 | 완료 | 모두 `disabled`: `BS/runtime/SecretSourceValidator.java:151`, `BS/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java:34`, `SP/bootstrap/idempotency/SampleIdempotencyConfig.java:34`; `jdbc` 값 main 0건, `6d27356e` | - | - | +| S6-#3a | Required | startup validator가 3 lifecycle·여러 패키지에 흩어짐, `StartupRule` 목록 없음 | 남음 | 19 → 16개: bootstrap 7(`BS/runtime/*Validator` 5, `OutboxCanonicalTransportRequirementValidator`, `TracingSamplingEnvironmentPostProcessor`), persistence-jpa 8(`JS/*Validator` 7, `JpaActivationEnvironmentPostProcessor`), cache-redis 1(`RedisReadinessGroupPostProcessor`). EPP 4, `InitializingBean` 1, `SmartInitializingSingleton` 11. `StartupRule` 타입 없음 | W3 | 모듈마다 `StartupRule { List violations(Environment) }` 목록 + runner 1개; bean이 필요한 검사만 bean으로 | +| S6-#3b | Required | OSIV 검사 2벌, 뒤 검사의 local 예외는 죽은 코드 | 남음 | `JS/OpenInViewSafetyValidator.java:26-38`(모든 profile 거부) vs `JS/JpaDangerousConfigurationGuard.java:51-52`(local-convenience 허용). 둘 다 무조건 등록(`JS/JpaStartupAutoConfiguration.java:71-74,117-127`) | W2 | 하나로: local 예외를 정책으로 쓸지 정해 `OpenInViewSafetyValidator`를 삭제하거나 guard의 OSIV 분기를 삭제 | +| S6-#3c | Required | ddl-auto 검사 2벌 | 남음 | `JS/JpaSchemaSafetyValidator.java:28-50`(prod) vs `JS/JpaDangerousConfigurationGuard.java:62-65`(non-local, prod 포함) | W3 | guard 한 곳으로 합치고 `JpaSchemaSafetyValidator` 삭제 | +| S6-#3d | Required | `isProdActive()` 5곳 복사 | 남음 | `JS/FlywayProdSafetyValidator.java:57`, `JS/JpaSchemaSafetyValidator.java:51`, `JS/PersistenceVendorProdSafetyValidator.java:81`, `JS/PostgreSqlTransportSecurityValidator.java:86`, `BS/runtime/SecretSourceValidator.java:175`. 본문은 모두 `RuntimeProfileSnapshot.isProduction()` 1줄 위임 | W3 | 1줄 wrapper 삭제하고 호출부에서 직접 호출(S6-#3a와 함께) | +| S6-#3e | Required | vocabulary 패키지 `runtime/startup/`에 guard 3개 | 완료 | bootstrap `BS/runtime/startup/`에는 `StartupFailureExceptionReporter`만. 어휘는 `SST/`, Flyway·RequiredEnvironment 검사는 `JS/`로 이동, `6d27356e` | - | - | +| S6-#3f | Required | CDV가 EPP와 `CapabilityDependencyStartupCheck`에서 두 번 실행 | 해당 없음(코드 삭제) | `CS:249` | - | - | +| S6-#4 | Required | root가 넓게 scan한 뒤 다른 leaf 패키지를 regex로 제외 | 완료 | `BS/CaSkeletonApplication.java` 전체가 `@SpringBootApplication` + bootstrap 패키지 5개 `@ConfigurationPropertiesScan`. regex 삭제(`CS:250`), web은 자기 imports로 공개(`src/adapter/inbound/web/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:1`), `6d27356e` | - | - | +| S6-#5 | Required | fileserver가 build에서 빠졌는데 스위치·설정이 root에 남음 | 완료 | `dependencyPolicy` 없음, 한 줄 선택(`src/app-bootstrap/build.gradle:152`), 설정은 모듈 소유(`CS:37`, `CS:234`), `MasterSwitch.FILESERVER*` 삭제(`CS:78`), composition 자체 imports(`src/composition/fileserver-platform/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`), `6d27356e` | - | - | +| S6-#6a | Required | 멱등성 설정 binder 3개·yml 2개, PG provider 하드코딩 (= X1-#2) | 완료 | settings record 하나 `IdempotencySettings`(`BS/autoconfigure/idempotency/IdempotencySettings.java:24-34`, prefix `ca-skeleton.capabilities.idempotency`), `config/idempotency.yml`·`IdempotencyProviderSettings`·`PostgreSqlIdempotencyProviderConfig` 삭제(`CS:228`), `APP_IDEMPOTENCY_TTL` 한 키(`src/app-bootstrap/src/main/resources/config/capabilities.yml:14`) | - | - | +| S6-#6b | Required | `APP_RATE_LIMIT_DEFAULT_POLICY_ID`가 두 키에 바인딩 | 남음 | `src/adapter/outbound/cache-redis/src/main/resources/config/module-defaults/cache-redis.yml:18`(`app.rate-limit.default-policy-id`)와 `:65`(`ca-skeleton.capabilities.rate-limit.default-policy-id`) | W2 | 읽는 쪽 하나만 남기고 다른 키 삭제(sample의 `ca-skeleton.rate-limit.*`는 1차 L-11) | +| S6-#7 | Required | sample이 bootstrap 인프라를 복사, 이미 갈라짐 | 남음 | `SP/bootstrap/{tracing,idempotency,settings,logging,metrics,context,management}` 525줄. `SampleTracingSampleRateResolver.java:23` `"staging" -> 0.10`, `SampleIdempotencyConfig.java:15` "stand-in", `SamplePseudonymizationConfig.java:12` "Sample-local copy" | W3 | 소유자 결정대로 멱등성 executor·outbox relay 조립을 `composition:*` 모듈로 옮겨 두 root가 함께 쓰고, tracing·logging·metrics·context·management는 공용 library leaf로(registry edge 추가), staging 분기 삭제 | +| S6-#8 | Required | sample root가 다른 leaf 패키지를 넓게 scan | 남음 | `SP/SamplePortfolioApplication.java:31-60`: `@ComponentScan`·`@ConfigurationPropertiesScan`에 `adapter.inbound.web`, `adapter.outbound.identifier`, `adapter.outbound.objectstorage`, `application`, `domain`, `shared`. JPA만 auto-config로 바뀜 | W3 | scan을 `dev.caskeleton.sample`로 좁히고 web·identifier·objectstorage는 각 leaf auto-config로 받기(보안 설정 2개는 exclude/property로 끔) | +| S6-#9 | Required | sample `application.yml` 중 읽는 코드 없는 블록 | 남음 | 326줄 중 약 101줄: `src/sample-portfolio/src/main/resources/application.yml:150-177`(capabilities.cache), `:180-181`(bootstrap), `:210-226`(logging), `:255-279`(app.cache.redis), `:280-283`(messaging), `:284-288`(notification), `:289-308`(outbound.http). sample classpath에 해당 binder 없음(`src/sample-portfolio/build.gradle:48-83`) | W5 | 해당 블록 삭제 | +| S6-#10a | Consider | sample 대표 예제가 poster-image에 묻힘, 패키지 종류별·기능별 혼재 | 남음 | poster 관련 main 약 5.9k줄 vs WorkLog 약 2.2k줄. `SP/application/`에 `command/query/event/port/exception`과 `poster/posterimage/worklog` 공존 | W3 | 기능별 패키지로 정리, poster-image는 objectstorage 검증용 별도 sample 모듈로 이동 | +| S6-#10b | Consider | poster-image legacy API 모드 | 남음 | `SP/adapter/inbound/web/controller/LegacyPosterImageController.java:23`(`mode=legacy`), `SP/domain/poster/LegacyPosterImageAttachment.java`, `SP/application/poster/UploadPosterImageUseCase.java` | W3 | legacy 모드와 전용 타입 삭제 | +| S6-#10c | Consider | 상태 머신이 application 계층, use case 생성자 14개 | 남음 | `SP/application/posterimage/PosterImageUploadIntent.java`(333줄), `SP/application/poster/PublishPosterImageUseCase.java:77-91`(인자 14개) | W3 | 상태 머신을 domain으로, 설정값 인자(TTL·lease·epoch·destination)를 record 하나로 | +| S6-#10d | Consider | `WorkLogSortField`(domain)가 HTTP 이름과 persistence 이름을 같이 앎 | 남음 | `SP/domain/worklog/WorkLogSortField.java:11-23`(`property` 하나로 `fromRequest` 매칭) | W3 | 요청 이름 매핑은 web mapper로, persistence 이름은 persistence mapper로; domain enum은 논리 필드만 | +| S6-#10e | Consider | sample `CLAUDE.md` 경로 틀림, WorkLog만 설명 | 남음 | `src/sample-portfolio/CLAUDE.md:17-22`: `adapter/web`, `adapter/persistence`, `adapter/identifier`(실제 `adapter/inbound/web`, `adapter/outbound/persistence`, `adapter/outbound/identifier`) | W5 | 경로 수정, poster-image 슬라이스 한 줄 추가 | +| S6-#11a | Consider | 컨트롤러 `toId()` 4벌, sort 파싱 2벌 | 남음 | `toId`: `WorkLogController.java:239`, `PosterController.java:161`, `LegacyPosterImageController.java:49`, `PosterImagePublicationController.java:110`; sort: `WorkLogController.java:99-113`, `PosterController.java:91-105` (모두 `SP/adapter/inbound/web/controller/`) | W3 | web 어댑터 helper 하나(id 파싱, `SortParam` + enum `fromRequest` 공통 처리) | +| S6-#11b | Consider | If-Match를 컨트롤러가 update 전에 get use case로 읽어 비교(트랜잭션 밖) | 남음 | `SP/adapter/inbound/web/controller/WorkLogController.java:162,209-218`; `SP/application/command/UpdateWorkLogCommand.java`에 `expectedVersion` 없음 | W2 | `UpdateWorkLogCommand.expectedVersion` 추가, 비교를 update use case 트랜잭션 안으로 | +| S6-#11c | Consider | sample 테스트가 `TransactionPort` fake를 각자 작성 (= X1-#3 일부) | 완료 | application-core testFixtures `DirectTransactionPort`(`src/application-core/src/testFixtures/java/dev/caskeleton/application/transaction/testkit/DirectTransactionPort.java`), sample 테스트의 인라인 fake 0건, `6d27356e` | - | - | +| S6-#12 | Consider | JPA 정책 클래스 겸용, 주입처 없는 bean, 테스트만 쓰는 플래그 | 완료 | `JpaPlatformAutoConfiguration` 삭제·`JpaStartupAutoConfiguration`으로 합침(`CS:238`), `app.jpa-platform.addons-enabled` 삭제(`CS:193`), `jpaDataSourceProfileValidator`가 `jpaResolvedDataSourceCheck`에 주입됨(`JS/JpaStartupAutoConfiguration.java:100,109-110`), `6d27356e` | - | - | +| S6-#13 | Consider | 역할 없는 startup 예외 subclass 4개 | 남음 | `SST/{MigrationFailed,ProfileMismatch,RequiredAdapterDisabled,StartupValidation}Exception.java` — bootstrap에서 support로 옮기기만 했고 본문은 `StartupErrorCode`를 부모에 넘기기만 | W3 | `StartupFailureException` 하나 + 테스트는 `errorCode()` 단언; 생성은 `StartupFailures` factory만 | +| S6-#14 | Consider | 스위치 prefix 3종, "capability" 뜻 여러 개 | 남음 | prefix: `ca-skeleton.*`(persistence-jpa, persistence-mongo, notification, outbox, grpc), `app.*`(messaging, redis, fileserver-platform, httpclient, object-storage, websocket), `backend.graphql`(`CS:30-45`). "capability": `@UseCaseCapability`, `capabilities.*` selector, `JpaCapability`, `MessagingCapabilities`. `MasterSwitch`·endpoint 미보고 부분은 삭제로 해당 없음 | W3 | 결정(2026-09-25): 설정 prefix를 `app.*`로 통일(`ca-skeleton.*`, `backend.graphql` → `app.*`), `APP_*` env 키 유지 | +| S6-#15 | Consider | bootstrap `:test`에 저장소 governance 테스트 | 남음 | `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/` 하위 45파일 7,302줄(`208077fd` 50파일), 이 중 34개가 저장소 파일·리소스를 직접 읽음 | W4 | `architectureTest`처럼 별도 strict lane으로 옮기고 읽는 파일을 `inputs`로 선언 | +| S6-#16a | Nit | 이력·리뷰 ID 주석 | 남음 | bootstrap main 이력/ID 줄 35개(105에서 감소, 주석 비율 19%), websocket 2개(해소 수준) | W5 | bootstrap 남은 35줄 삭제 | +| S6-#16b | Nit | `CapabilityDependencyEnvironmentValidator` 30줄 Javadoc | 해당 없음(코드 삭제) | `CS:249` | - | - | +| S6-#16c | Nit | hikari `connection-timeout` 이력 주석 "It shipped as 5s" | 남음 | `src/adapter/outbound/persistence-jpa/src/main/resources/config/module-defaults/persistence-jpa.yml:33`(bootstrap에서 이동) | W5 | 이력 문장 삭제, 현재 값 이유만 | +| S6-#16d | Nit | config yml마다 같은 3줄 헤더 | 남음 | `src/app-bootstrap/src/main/resources/config/*.yml` 5개(15개에서 감소)가 같은 "application.yml 이 spring.config.import 로 취합한다…" 3줄 | W5 | `application.yml`의 import 위치에 한 번만 | +| S6-#16e | Nit | `OpenInViewSafetyValidator` 예외 메시지에 "D2" | 남음 | `JS/OpenInViewSafetyValidator.java:33` "feature-persistence-failure-baseline D2" | W5 | 메시지에서 문서 ID 삭제 | +| S6-#16f | Nit | fileserver composition 주석 틀림, 쓰지 않는 registry edge | 남음 | `src/composition/fileserver-platform/src/main/java/dev/caskeleton/composition/fileserver/FileserverPlatformAutoConfiguration.java:37-41`("identifier generator"를 sibling adapter라 설명하지만 `RandomUploadIdentifierFactory`는 `adapter:outbound:fileserver` 소속); `MJ:267` `adapter-outbound-identifier` edge vs `src/composition/fileserver-platform/build.gradle:23-33`에 의존 없음 | W5 | 주석 수정, registry edge 삭제 | +| S6-#17 | Nit | `TracingSettings.sampleRate`가 String이라 3곳에서 파싱 | 남음 | `BS/autoconfigure/tracing/TracingSettings.java:14,56,61`, `BS/autoconfigure/tracing/TracingSampleRateResolver.java:18`; tracing 5클래스 377줄 그대로 | W5 | 범위 검증 붙은 `Double`(null = profile 기본값)로 바꾸고 파싱 1곳 | +| S6-G1 | 권고 | 활성화 지도가 한눈에 안 읽힘(스위치 SSOT·검증기·endpoint·dependencyPolicy·문서가 어긋남) | 완료 | 스위치·검증기·endpoint 삭제(`CS:248-252`); 선택은 `src/app-bootstrap/build.gradle:139-153` 주석 한 줄 목록 + `CS:24-45` 표; component scan은 bootstrap 패키지만, EPP 9개는 각 소유 모듈 `spring.factories`, `6d27356e` | - | - | +| S6-G3 | 권고 | capability 하나 켜는 표면이 큼(outbox 스위치 5개, yml 19개) | 완료 | bootstrap yml 19개 1,388줄 → 9개 655줄. Outbox+relay = build 줄 2개 + `APP_OUTBOX_ENABLED`·`APP_OUTBOX_RELAY_ENABLED`(`CS:35`), 검증 클래스 1개(`OutboxCanonicalTransportRequirementValidator`); Redis 연결 env는 `src/adapter/outbound/cache-redis/README.md:50`에 문서화 | - | - | +| S6-lead-1 | 권고 | gRPC 서버 스택 2개, 둘 다 조립 안 됨 (= X1-#10) | 완료 | `adapter:inbound:grpc`는 자기 imports(`GrpcServerConfig`)로 한 줄 선택(`CS:42`), 플랫폼 `grpc:*`는 별도 build `src/optional-platforms`(`CS:41`). 두 스택 공존은 X1-#10에서 의도로 수용 | - | - | +| S6-lead-2 | 권고 | 인라인 `TransactionPort` fake가 저장소 전체에 (= X1-#3) | 남음 | 인라인 fake 24 → 10개 파일: application-core 4(`TransactionPortTest` 포함), application-notification 4, `application-fileserver/.../testkit/DirectTransactions.java`, `composition/fileserver-platform/.../FileserverAssemblyFixture.java`. `DirectTransactionPort` 사용 12개 파일 | W4 | 계약 자체를 검증하는 `TransactionPortTest` 외 9개를 `DirectTransactionPort`로 교체 | +| S6-lead-3 | 권고 | 복사용 예제 `CreateWorkLogUseCase`가 `LegacyOutboxAppendPort` 사용 (= X1-#1 append 포트) | 남음 | `SP/application/worklog/CreateWorkLogUseCase.java:7`; canonical `OutboxAppendPort`(`src/application-core/src/main/java/dev/caskeleton/application/outbox/OutboxAppendPort.java:13`) 존재, legacy 포트 Javadoc은 "cutover 창 동안만"(`LegacyOutboxAppendPort.java:3-9`) | W2 | 예제를 `OutboxAppendPort` + `ValidatedIntegrationEvent`로 옮기고 MSG-015 cutover 후 legacy 포트 삭제 | +| S6-lead-4 | 권고 | `CS` WIRED=yes vs `dependencyPolicy` 모순, `MasterSwitch`가 없는 capability 나열 | 해당 없음(코드 삭제) | `dependencyPolicy`·`MasterSwitch` 삭제(`CS:248`), WIRED 정의를 "선택하면 조립됨"으로 재정의(`CS:11`, `CS:37`) | - | - | +| S6-lead-5 | 권고 | `DefaultUploadApplicationService` 생성자 14개 | 남음 | `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java` 생성자 인자 14개, 조립 `FileserverUploadServiceConfiguration.java:88` | W3 | 정책 3개(access·filename·upload)와 저장소 2개를 record로 묶거나 업로드 단계별 서비스로 분해 | +| S7-#1a | Required | 선택 불가·SDK 없는 messaging leaf(experimental 4, rabbit 2)와 Debezium | 해당 없음(코드 삭제) | `CS:124-130` | - | - | +| S7-#1b | Required | 쓰는 곳 없는 `schema-avro`·`schema-protobuf`·`cloudevents`·`claim-check`가 기본 build에 | 남음 | 4개 leaf 유지(`CS:133` "leaf는 유지"), main 345·199·228·418줄, main 참조 0, 각 leaf에 README 없음 | W5 | Wave 3 방침(이동 대신 라이브러리로 유지)대로 각 leaf README에 "라이브러리 API — 서비스 leaf가 `implementation`으로 받음"과 SDK 의존을 적음 | +| S7-#1c | Required | starter가 쓰지 않는 cloudevents·claim-check edge, 바인딩만 되는 `Experimental`·`Bridge` 설정 | 완료 | `CS:131`, `CS:133`; `src/messaging/messaging-spring-boot-starter/build.gradle:20-37`에 두 leaf 없음, `6d27356e` | - | - | +| S7-#2 | Required | consume 계약 3개, 조립 0 | 남음 | `MessageHandler.java:14`(main 참조 0), `DefaultDeliveryProcessor.java:40-47`(참조 0), `IdempotentMessageHandler.java:21`; `KafkaConsumerRegistrar`(645줄)·`KafkaBatchConsumerRegistrar`(146줄) main 참조 0, 자동 조립 transport는 발행 전용(`KafkaMessagingTransport.java:89` `KAFKA_CONSUMER_NOT_CONFIGURED`) | W3 | 결정(2026-09-25): Kafka 소비 지원 — `MessageHandler` 하나, starter-kafka가 handler bean이 있으면 consumer 조립, 실제 Kafka lane 테스트 | +| S7-#3 | Required | grpc 18 leaf를 9 leaf로 | 남음 | `MJ`에 grpc leaf 18개 그대로. io.grpc import main 파일은 `grpc-policy` 4 + `grpc-server` 1(+testkit 6); `src/grpc/grpc-client/build.gradle:12-13` io.grpc api인데 import 0; 미사용 edge `src/grpc/grpc-codegen/build.gradle:13`, `src/grpc-advanced/grpc-advanced-edition/build.gradle:9-11` | W3 | policy+server+client+discovery+admin → `grpc-runtime`, proto-contract+codegen → `grpc-contract`, advanced 5개 → `grpc-advanced`, 미사용 edge 삭제 | +| S7-#4 | Required | gate·guard·catalog 같은 governance를 운영 코드로 (≈ N-9) | 남음 | 전부 존재: `GrpcStableModuleCatalog.java`(79), `GrpcStableBuildInvariant.java`(53), 상수 반환 gate 7종(`GrpcKotlinCompatibilityGate`, `GrpcWebCompatibilityGate`, `GrpcServletStartupValidator`, `GrpcEdition2026Guard`, `GrpcEdition2024Gate`, `GrpcResolverSafetyPolicy`의 상수 메서드, `GrpcXdsStartupGuard`), `GrpcRawApiImportRule`(108)·`GrpcApplicationBoundaryRules`(92), `GrpcAdvancedInfrastructureTestkit`(87). `git diff 208077fd 6d27356e --stat -- src/grpc*`은 Wave 1 1-10 파일만 | W3 | 상수 gate·catalog·invariant·testkit 삭제, import 규칙은 ArchUnit 테스트로 | +| S7-#5a | Required | `messaging-outbox-jdbc-postgresql`의 Debezium 4개 | 해당 없음(코드 삭제) | `CS:130` | - | - | +| S7-#5b | Required | 한 leaf가 relay 로직·PG repository·admin journal을 함께 가짐 | 남음 | `src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/`: relay 7클래스 877줄, `JdbcOutboxRepository` 721줄, `JdbcAdminOperationJournal` 326줄; Spring JDBC import 파일 2개. inbox는 6개 중 5개가 stdlib | W3 | `messaging-reliability`(stdlib relay·inbox 로직) + `messaging-reliability-jdbc-postgresql`(Jdbc 3종)으로 재분할 | +| S7-#6a | Required | `PublishResult` 7인자 생성자 직접 호출 | 남음 | 11파일 28회 → 5파일 8회(`KafkaMessagingTransport` 1, `KafkaPublishFailureClassifier` 2, `KafkaPublishMapper` 1, `DefaultMessagePublisher` 2, `MS/PublishResults.java` 2). `PublishResult.java:30`에 정적 factory 없음 | W3 | `PublishResult.rejected/ambiguous/confirmed` 정적 factory 추가 후 8곳 교체 | +| S7-#6b | Required | `PublishEvidence.ambiguous()`를 두고 직접 생성 | 남음 | `MS/PublishResults.java:43-47,57-59` `new PublishEvidence(true, MAY_HAVE_BEEN_TRANSMITTED, false, NONE)` 2회 | W3 | `PublishEvidence.ambiguous()` 사용 | +| S7-#6c | Required | `rejectedLocally` 4벌, `PulsarPreSendRejection`·`NatsPreSendRejection` 중복 | 해당 없음(코드 삭제) | rabbit·pulsar·nats 삭제(`CS:124-129`), 남은 것은 `KafkaMessagingTransport.java:200` 1개 | - | - | +| S7-#7 | Required | envelope ↔ canonical header 변환 3벌 | 해당 없음(코드 삭제) | Rabbit mapper·Debezium router 삭제(`CS:128,130`). 남은 Kafka `KafkaHeaderMapper`(쓰기)·`KafkaDeliveryMapper`(읽기) 한 쌍, `RESERVED_HEADER_FORGED`는 `KafkaHeaderMapper.java:92` 한 곳 | - | - | +| S7-#8 | Consider | outbox port·repository 죽은 표면 | 남음 | `OutboxRepository.java:36` `leaseBatch`(main 호출 0), 4인자 `claimBatch`(`:47`)·3인자 `markAmbiguous`(`:69`)(relay는 `:58`·`:72` 오버로드만 사용), `JdbcOutboxRepository.java:426-455` `*Unfenced` 4개(호출 0), 손 JSON `:608-680` | W3 | 메서드 7개 삭제, header JSON은 Jackson 또는 `jsonb_each_text` (purge 오버로드는 1차 M-6) | +| S7-#9a | Consider | starter 550줄 god config | 남음 | `MS/MessagingCoreAutoConfiguration.java` 549줄, `@Bean` 28 | W3 | config/validation, publish pipeline, observability 세 configuration으로 분리 | +| S7-#9b | Consider | broker 중립 core starter에 broker 전용 필드 union | 남음 | Rabbit 필드는 삭제(`CS:235`), `MS/BrokerSettings.java:32-44`에 Kafka 전용 필드(`bootstrapServers`, `enableIdempotence`, `acks` 등) 남음 | W3 | Kafka 필드는 starter-kafka가 자기 settings record로 바인딩 | +| S7-#9c | Consider | 외부 사용 0인 Blocking/Reactive/Batch facade와 `reactor-core` api 노출 | 남음 | `MS/Default{Blocking,Reactive,Batch}MessagePublisher.java`, `MS/ReactiveMessagePublisher.java`(합계 398줄) starter 밖 main 참조 0; `src/messaging/messaging-spring-boot-starter/build.gradle:46` `api 'io.projectreactor:reactor-core'` | W3 | facade 삭제(또는 reactor `compileOnly`) | +| S7-#10 | Consider | 미사용 API 타입 (1차 M-9 목록 외) | 남음 | `MessagingException` 서브클래스 24개 중 13개 main 참조 0(Authentication, BrokerUnavailable, Consumer, DeadLetter, HandlerTimeout, HeaderRejected, PublishAmbiguous, PublishRejected, Redrive, RetryExhausted, Routing, Settlement, SettlementUnknown); `MessageHandler`·`KafkaTopologyInspector`·`ReliableMessagePublisher`·`InboxRecord` 참조 0. `RabbitRequestReply`만 삭제로 소멸 | W3 | 삭제(consumer 쪽 타입은 S7-#2 결정에 따름) | +| S7-#11 | Consider | `MessagingCapabilities` 위치 boolean 12개 | 남음 | record boolean 12개, `KafkaMessagingTransport.java:62-64` `new MessagingCapabilities(true, …, true)`; 생성 11곳 → 4곳 | W3 | `EnumSet`로, 읽지 않는 flag 삭제 | +| S7-#12 | Consider | messaging API leaf 병합(core-api+schema-api, admin-api+admin-runtime) | 남음 | 두 쌍 모두 별도 leaf(`MJ`). 기본 build messaging leaf 27 → 21(삭제분만) | W3 | 두 쌍 병합 | +| S7-#13 | Consider | `.proto` regex 파서·Buf 규칙 재구현 | 남음 | `GrpcProtoContractValidator.java` 447줄, `grpc-codegen` main 692줄, 근거 주석 `src/grpc/grpc-codegen/build.gradle:8-10`(설계 D5: CLI 없음) | W3 | 결정(2026-09-25): protobuf Gradle 플러그인(protoc) + Buf(CI)로 전환, 자체 `.proto` 파서·Buf 규칙 재구현 삭제 | +| S7-#14 | Consider | 패키지·leaf 이름 불일치, 등급 용어 4개 | 남음 | `src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/{resilience,streaming}`(leaf `grpc-advanced-resilience`/`-streaming`과 이름 겹침); `CapabilityTier`(messaging-policy), `CompatibilityMatrix`(messaging-testkit), `GrpcCapabilityGrade`(grpc-advanced-bootstrap), `GrpcEvidenceGrade`(grpc-testkit) | W3 | S7-#3 병합 때 패키지 = leaf 이름으로 맞추고 등급 용어 하나로 | +| S7-#15a | Consider | 리뷰 ID 주석 | 남음 | `MSG-INT-003` 9곳 그대로(예: `MS/MessagingCoreAutoConfiguration.java:370,442,480`, `DeclaredDestinationAccess.java:11`, `RegisteredMessageCodecs.java:12`) | W5 | ID 삭제, 이유만 남김 | +| S7-#15b | Consider | 이력 주석·inline FQN | 남음 | "used to/no longer" 58 → 52줄; inline FQN 약 218줄(`KafkaConsumerRegistrar` 34) | W5 | 이력 문장 삭제, OpenRewrite `ShortenFullyQualifiedTypeReferences` | +| S7-#16a | Nit | `dev.caskeleton.messaging.autoconfigure` 패키지가 여러 leaf에 걸침 | 남음 | 3 → 2개 leaf(starter 26파일, starter-kafka 1파일), 원인 package-private `StartupProfileValidation` | W5 | starter-kafka를 자기 패키지로, `StartupProfileValidation`은 public 호출 경로로 | +| S7-#16b | Nit | starter-kafka registry edge 10개 vs 실제 2개 | 남음 | `MJ:523` allowed 10개 vs `src/messaging/messaging-spring-boot-starter-kafka/build.gradle:9-10` 2개 | W5 | registry를 실제 edge 2개로 줄임 | +| S7-#16c | Nit | `KafkaConsumerRegistrar.dispatch` 긴 메서드 | 남음 | `KafkaConsumerRegistrar.java:264-354`(약 90줄) | W5 | S7-#2 결정 후: 유지면 분해, 삭제면 소멸 | +| S7-lead-1 | 권고 | outbox relay 3개 (= X1-#1) | 완료 | V2 relay 삭제(`CS:175`), 앱 relay는 `PublishPendingOutboxEventsUseCase` 하나(`BS/autoconfigure/outbox/OutboxConfig.java:86`). messaging `OutboxRelay`는 vendored 제품 기능으로 `@ConditionalOnBean(OutboxRepository)`(`MS/MessagingReliabilityAutoConfiguration.java:81`)이고 main에 `JdbcOutboxRepository` 생성 0이라 앱 조립에 들어오지 않음, `6d27356e` | - | - | +| S7-lead-2 | 권고 | 멱등성 저장소 3개(앱, grpc ledger, messaging inbox) (= X1-#2) | 남음 | 셋 다 존재. messaging inbox는 소비자 dedup이고 family 규칙상 앱 계약 사용 불가(`CLAUDE.md:65`); grpc ledger도 앱 edge 없음(`MJ:606`, allowed `grpc-core-api`만) → 분리는 구조상 의도. 그러나 root `CLAUDE.md:59-67` family 표에 `grpc:*`·`grpc-advanced:*` 행이 없어 이 예외가 문서에 없음 | W5 | family 표에 gRPC 플랫폼을 messaging과 같은 vendored 예외(자체 ledger, optional build)로 한 줄 추가 | +| S7-lead-3 | 권고 | Kafka producer 경로 2개 (= X1 표 Kafka producer) | 남음 | R0 `LegacyKafkaMessagingRootAutoConfiguration`·`KafkaSender`·`KafkaSenderAutoConfiguration`(`src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/`) vs 플랫폼 `KafkaMessagingTransport`; `CS:32` "legacy `KafkaSender` seam and the vendored platform" | W2 | MSG-015 cutover(S6-lead-3과 함께) 후 R0 `KafkaSender` 경로 삭제 | +| S7-lead-4 | 권고 | lease/claimBatch 구현 여러 벌 (= X1-#6) | 남음 | persistence-jpa 안에 owner+token lease 2벌: outbox(`OutboxStoreAdapter.java:79-90`, `OutboxEventJpaRepository.java:34,47`)와 알림(`RecipientDeliveryJpaRepository.java:85-175`, `JpaRecipientLeaseStore`). outbox는 계약 kit `OutboxLeaseFencingContract`(application-core testFixtures)가 있으나 `RecipientLeaseStorePort`는 PG 통합 테스트 1개뿐. messaging `OutboxRepository.claimBatch`는 vendored라 별개 | W4 | SQL은 테이블별 유지(X1-#6), application-notification testFixtures에 `RecipientLeaseFencingContract`를 만들어 fake와 JPA store가 함께 상속 | +| S7-lead-5 | 권고 | messaging 기본 off 처리 두 곳(sentinel vs starter switch) | 해당 없음(코드 삭제) | `DisabledMessagingSentinelAutoConfiguration` 삭제(`CS:240`), 끄는 키는 모듈 `app.messaging.enabled` 하나(`CS:32`) | - | - | + +**조사 메모** + +- 기준 HEAD `6d27356e`. 근거 열 경로 약어: `CS` = `docs/capability-status.md`, `MJ` = `src/config/architecture/modules.json`, `BS` = `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap`, `JS` = `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup`, `SP` = `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio`, `SST` = `src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/startup`, `MS` = `src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure`. +- 겹침: S6-#2 = 1차 L-6(Group L #6, 관계형 의존 목록 2곳). S6-#6a·S7-lead-2 = X1-#2. S6-#11c·S6-lead-2 = X1-#3. S6-lead-3 = X1-#1(append 포트), S7-lead-3 = X1 표 "Kafka producer"; 둘은 MSG-015 cutover 한 작업. S7-lead-1 = X1-#1. S7-lead-4 = X1-#6. S6-lead-1 = X1-#10. S7-#4 ≈ 1차 N-9. S7-#8의 purge 오버로드는 1차 M-6, S7-#10은 1차 M-9 목록 밖. S6-#6b의 sample `ca-skeleton.rate-limit.*`는 1차 L-11. +- S6 「그룹 질문」의 "sample이 복사할 만한가" 권고는 S6-#7~#11과 같아 별도 행을 두지 않았다. +- 계획서 Wave 2 표 2-G는 "grpc 상수 gate·`GrpcStableModuleCatalog`" 삭제를 적었지만 실행되지 않았다. `6d27356e`에서 `src/grpc*` 변경은 Wave 1 1-10(ledger 계약) 파일뿐이다(S7-#4). +- 리뷰 수치·표현 보정: S6-#3의 `isProdActive()` "5곳 복사"는 `208077fd`에서도 `RuntimeProfileSnapshot.isProduction()` 1줄 위임이었다(로직 복사 아님). S7-#16 `dispatch`는 지금 약 90줄(리뷰 75줄). S7-#10 서브클래스는 지금 24개 중 13개가 미사용(`MessageSettlementException` 포함). S7-#15의 "리뷰 ID `MSG-*`"는 실제로 `MSG-INT-003` 형태이며 인용 줄(370·442·480)은 지금도 그대로다. +- S6-lead-1은 X1-#10이 두 스택 공존을 이미 의도로 수용했다. S7-#3·#4·#13·#14는 gRPC 플랫폼을 유지한다는 전제의 작업이다. +- S6-#1c는 리뷰 권고(별도 build로 이동 또는 삭제)와 달리 남은 약 1.0k줄을 leaf 안 라이브러리로 두었는데, 이는 Wave 3 결정("옮기기 대신 완성해서 포장")을 따른 것이다. + +## 지난 세션 남은 문제 (NEW) + +| ID | 심각도 | 요약 | 상태 | 근거 | Wave | 수정 방향 | +|---|---|---|---|---|---|---| +| NEW-1a | Consider | compose smoke가 lane이 실제로 켠 기능·DB 벤더를 확인하지 않는다. `expectedSwitchesOn`·`expectedPersistenceVendor`를 읽는 코드가 없다(스크립트·정적 검사기 모두). | 남음 | `scripts/run-compose-runtime-smoke.sh:414-427`은 `/actuator/health`만 폴링한다. 예전 버전은 `/actuator/adapteractivation`의 `switches`·`persistenceVendor`를 비교했는데, 그 endpoint(`AdapterActivationEndpoint`·`AdapterActivationReport`·`MasterSwitchEnvironmentPostProcessor`)가 6d27356e에서 삭제됐다(`git diff 208077fd 6d27356e -- scripts/run-compose-runtime-smoke.sh`). `scripts/verify-compose-profile-contracts.sh:43-56`도 이 두 필드를 읽지 않는다. 필드 값은 아직 유효한 property 키다: `ca-skeleton.persistence-jpa.enabled`(`PersistenceJpaAutoConfiguration.java:17`), `app.messaging.enabled`(`MessagingPlatformRootAutoConfiguration.java:23`), `backend.graphql.enabled`(`GraphQlRootAutoConfiguration.java:12`) 등 8개 모두 main 코드에 있다. 하지만 이제 이 키를 "앱이 보고한 값"으로 노출하는 곳이 없어서 필드는 읽히지 않는 문서다. `src/config/runtime/compose-profile-contracts.json:741`의 `$activationComment`는 "Redis·fileserver·httpclient는 app-bootstrap에 포함"이라고 적혀 있는데, capability 포장 이후로는 틀린 설명이다. actuator 노출 목록은 `health,prometheus,info,loggers`다(`src/app-bootstrap/src/main/resources/config/observability.yml:34`). | W2 | 결정(2026-09-25): smoke가 lane이 켠 capability·DB 벤더를 health component(또는 info)로 확인, 계약 필드를 그 값에 맞춰 재정의 | +| NEW-1b | Required | 새 CI 잡이 GitHub에서 한 번도 돌지 않았다. 18개 lane을 실제로 돌린 증거가 없다. | 남음 | 브랜치에 upstream이 없고(`git status -sb` → `## refactor/review-followup`), `6d27356e`를 포함한 원격 브랜치도 없다(`git branch -r --contains` 결과 비어 있음). 새로 추가된 잡은 `.github/workflows/build-logic.yml:30-41`(included build 테스트), `.github/workflows/integration-main.yml:64`(`main-check`), `:85`(`configuration-cache`), `:130`(`jpa-candidate-evidence`)이다. compose 잡은 `integration-main.yml:374-387`에 있고 `push: main`·nightly·dispatch에서만 돈다(`:33-40`). 계약 lane은 18개다(`jq '.lanes\|length'`). lane은 `COMPOSITION=qualification` 이미지로 돈다(`run-compose-runtime-smoke.sh:34`, `src/Dockerfile:70-77`). | W4 | 로컬에서 돌리려면 docker, docker compose 2.24.4 이상(`compose-profile-contracts.json`의 `minimumComposeVersion`), jq, openssl(TLS lane의 인증서 생성, `:183-211`)이 필요하다. 명령은 `bash scripts/run-compose-runtime-smoke.sh --matrix src/config/runtime/compose-profile-contracts.json`이고, 이미지는 스크립트가 `docker compose build app`으로 만든다(`:366`). 스크립트의 도구 사전 검사(`:75-77`)에 `openssl`을 추가한다. 브랜치를 push해서 `workflow_dispatch`로 `integration-main`·`build-logic`을 한 번 돌리고 그 결과를 증거로 남긴다. | +| NEW-2a | Consider | outbox relay 조립이 app-bootstrap에 있다. | 남음 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfig.java:44-120`. 조건: `@AutoConfiguration(afterName=PersistenceJpaAutoConfiguration, MessagingBridgeRootAutoConfiguration)`, `@ConditionalOnProperty(ca-skeleton.outbox.enabled=true)`, `@ConditionalOnBean(OutboxStorePort)`, `@EnableScheduling`. 빈: `outboxCanonicalTransportRequirementValidator`, `outboxRelayScheduler`(`relay-enabled` 기본 true + `@ConditionalOnBean(OutboxMessagePublishPort)`), `outboxRandomGenerator`, `outboxLeaderElection`, `outboxMetrics`. 같은 패키지에 `OutboxSettings`·`OutboxMetrics`·`OutboxRelayScheduler`·`OutboxLeaderElectionToken`·`OutboxCanonicalTransportRequirementValidator`가 있다. 등록은 `src/app-bootstrap/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:2`. persistence-jpa로 옮기지 못하는 이유는 `AdapterBoundaryArchitectureTest.java:207-227` 때문이다. 이 규칙은 `adapter.outbound.persistence..` 패키지가 `*UseCase`를 참조하는 것을 막는데, `OutboxConfig`는 `PublishPendingOutboxEventsUseCase`를 직접 만든다(:85). | W3 | 새 leaf `:composition:outbox-relay`(패키지 `dev.caskeleton.composition.outbox`)를 만들고 위 6개 클래스와 테스트(`OutboxConfigTest`·`OutboxSettingsTest`·`OutboxRelaySchedulerLoggingTest`·`OutboxCanonicalTransport*Test`)를 옮긴다. 자세한 내용은 아래 메모. | +| NEW-2b | Consider | 멱등성 executor 조립이 app-bootstrap에 있고, sample이 검증 없는 복사본을 따로 가진다. | 남음 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java:28-56`: `@AutoConfiguration`, 빈은 `idempotencyExecutor` 하나다(`@ConditionalOnExpression(provider != disabled)`). store가 정확히 1개가 아니면 기동 실패한다(:39-47). 설정은 `IdempotencySettings.java:24-67`에 있고 lease·TTL 상한과 codec·revision을 검증한다. sample 복사본 `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/idempotency/SampleIdempotencyConfig.java:21-47`과의 차이는 셋이다. ① `Binder`로 직접 읽어서 상한·양수 검증이 없다(:38-45). ② store를 1개로 가정한다(`IdempotencyStorePort store` 직접 주입). ③ `Clock` 빈과 `@EnableScheduling`을 함께 들고 있다(:22,:27-30). | W3 | 새 leaf `:composition:idempotency`로 `IdempotencyProviderSelectionConfig`·`IdempotencySettings`와 테스트(`IdempotencyProviderCompositionTest`·`IdempotencySettingsTest`)를 옮긴다. sample은 `runtimeOnly project(':composition:idempotency')`를 쓰고 `SampleIdempotencyConfig`에서는 executor 빈을 지운다(Clock·scheduling만 남긴다). modules.json의 `sample-portfolio.allowed_dependencies`에 `composition-idempotency`를 추가한다. | +| NEW-3 | Required | fileserver 보상 트랜잭션의 30초 타임아웃이 사라졌다. 지금은 `inNew` 경로 전체에 타임아웃이 없다. | 남음 | 예전 코드는 `git show 208077fd:src/application-fileserver/.../upload/FileserverCompensationTransaction.java:16`에 `BUDGET = Duration.ofSeconds(30)`을 두고 `:27` `MAINTENANCE_NEW` 정책으로 `SpringPolicyTransactionPort`에 넘겼다. 그 포트가 `definition.setTimeout(...)`을 걸었다(208077fd `SpringPolicyTransactionPort.java:184`, 상한 `persistence.yml` `transaction-timeout: 30s`). 지금은 `src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java:155`와 `DefaultFinalizeUploadService.java:321`이 `transactions.inNew(...)`를 그대로 호출한다. `TransactionPort.java:23-78`에는 timeout 옵션이 없다. `SpringTransactionPort.java:83-93` `template()`은 `setTimeout`을 호출하지 않는다. `spring.transaction.default-timeout`도 어디에도 없다(grep 0건). | W2 | 가장 작은 변경은 `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java`의 `requiresNewTemplate`에 `setTimeout(30)`을 거는 것이다(상수 1개). 이러면 보상·outbox·audit용 REQUIRES_NEW의 옛 동작이 돌아온다. 전 트랜잭션에 상한을 원하면 대신 `persistence-jpa.yml` module-defaults에 `spring.transaction.default-timeout: 30s`를 둔다. 테스트는 `SpringTransactionPort` 단위 테스트에서 inNew template의 timeout 값을 단언한다. | +| NEW-4a | Required | Kafka legacy seam producer에 보안 설정이 전혀 없다(항상 PLAINTEXT). | 남음 | `src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java:62-80`: bootstrap·serializer·acks·timeout만 넣는다. `security.protocol`·SASL·SSL 키가 없다. messaging-kafka 모듈을 고르면 `LegacyKafkaMessagingRootAutoConfiguration`(imports 1행)로 항상 켜진다. 반면 platform producer는 `KafkaSecurityConfigurer`를 적용한다(`KafkaMessagingAutoConfiguration.java:234-235`). | W1 | seam producer도 같은 보안 profile을 쓰게 한다. `KafkaMessagingAutoConfiguration.producerSecurity(...)`를 재사용 가능한 static으로 빼거나 `KafkaSecurityConfigurer` 결과를 주입받아 `config.putAll(...)`한다. 보안 profile이 없고 broker가 TLS·auth를 요구하면 기동을 실패시킨다(platform 쪽 `:200-211`과 같은 규칙). 장기적으로는 seam을 platform transport로 합쳐 producer를 하나로 줄인다. | +| NEW-4b | Required | Kafka TLS 자료(truststore/keystore) 설정 키가 없다. `MUTUAL_TLS`를 설정 값으로는 받지만 실제로 동작하지 않는다. | 남음 | `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java:85-90`은 TLS일 때 `ssl.enabled.protocols`·`ssl.endpoint.identification.algorithm`만 넣는다. `:109` `MutualTls`는 `sasl.mechanism=NONE`만 넣고 `ssl.keystore.*`는 넣지 않는다. 그래서 `security.protocol=SSL`인데 client 인증서가 없는 상태가 되어 연결할 때 실패한다. `src/messaging` main에서 `truststore\|keystore` grep 결과는 0건이다. 설정 컴파일러는 `MUTUAL_TLS`를 받는다(`MessagingConfigurationCompiler.java:258`). 동작하지 않는 옵션을 받는 것은 완료 기준 3 위반이다. | W1 | `BrokerSettings`(messaging-spring-boot-starter)에 `trust-store-location/password/type`, `key-store-location/password/type`을 추가하거나 Spring Boot SSL bundle 이름(`ssl-bundle`)을 받는다. `KafkaSecurityConfigurer`가 `ssl.truststore.*`·`ssl.keystore.*`(또는 PEM `ssl.*.certificates`)를 채운다. keystore가 없는 `MUTUAL_TLS`는 컴파일 단계에서 거부한다. 구현하지 않을 거면 `MessagingConfigurationCompiler.java:258`에서 `MUTUAL_TLS`를 뺀다. | +| NEW-4c | Consider | platform producer가 broker 주소를 `spring.kafka.bootstrap-servers`에서만 읽고, 선언된 broker의 `bootstrap-servers`는 검증만 한 뒤 쓰지 않는다. | 남음 | `src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java:155-165`는 `environment.getProperty("spring.kafka.bootstrap-servers")`만 읽는다. `MessagingConfigurationCompiler.java:97-99`는 `app.messaging.brokers..bootstrap-servers`가 비어 있으면 거부하지만, producer는 그 값을 쓰지 않는다. 두 경로를 이어 주는 것은 module-defaults 한 줄뿐이다: `src/adapter/outbound/messaging-kafka/src/main/resources/config/module-defaults/messaging.yml:17,23`에서 둘 다 `${APP_MESSAGING_KAFKA_BROKERS:}`. | W2 | 주소 출처를 하나로 정한다. 추천은 compiled broker(`CompiledMessagingConfiguration`의 kafka broker `bootstrapServers()`)를 쓰고, 없을 때만 `spring.kafka.bootstrap-servers`로 fallback하는 것이다. 둘 다 있는데 값이 다르면 기동을 실패시킨다. 테스트는 `producerConfig(...)`에 두 값을 다르게 주고 결과를 단언한다. | +| NEW-4d | Required | credential rotation이 Kafka producer에 반영되지 않는다. | 남음 | `KafkaMessagingAutoConfiguration.java:140-146`: producer를 기동 때 한 번 만든다. `:234-235`: `Instant.now()` 시점의 credential로 JAAS 문자열을 고정한다. `:250`: transport generation이 `1L`로 고정이다. `KafkaSecurityConfigurer.java:17-21` Javadoc은 "rotation을 가능하게 한다"고 적혀 있지만, 회전 뒤 producer를 다시 만드는 코드가 없다(`messaging-kafka` main에서 rotate grep 0건). 회전 소스는 `MessagingCoreAutoConfiguration.java:184`(runtime registry)다. | W1 | Kafka 방식으로 해결한다. `sasl.client.callback.handler.class`에 `CredentialRuntimeRegistry`를 조회하는 handler를 넣고 JAAS에는 username만 둔다. 이러면 재인증(broker `connections.max.reauth.ms`) 때마다 새 비밀번호를 쓴다. 다른 방법은 registry의 generation 변화에 맞춰 producer를 교체하고 transport generation을 올리는 것이다. Javadoc(:17-21)은 실제 동작에 맞춘다. | +| NEW-5a | Required | Redis ACL 템플릿의 script 계정에 `TIME` 권한이 없다. rate-limit·멱등성 script가 NOPERM으로 실패한다(실제 lane 실패 4건의 주원인). | 남음 | `infra/redis-sdk/acl/application-advanced.acl:1`, `infra/redis-sdk/acl/all-accounts.acl:3`: `-@all` 뒤에 `+time`이 없다(`TIME`은 `@read`·`@write`에 속하지 않는다). script 안에서 `redis.call('TIME')`을 쓰는 곳은 `RateLimitScripts.java:48,76,108`, `IdempotencyScripts.java:41,127`이다. `infra/redis-sdk/acl/README.md`는 `all-accounts.acl`을 "deployment가 로드하는 파일"이라고 적고 있어서, 운영 템플릿도 같이 깨져 있다. 기동 probe도 이 문제를 잡지 못한다. `RedisSemanticScriptAclProbe.java:20`은 `return {1}`만 실행한다. | W1 | 두 ACL 파일의 advanced 계정에 `+time`을 추가한다. `admin-readonly.acl:1`에는 이미 `+time`이 있다. probe script를 `redis.call('TIME')`을 실제로 수행하는 스크립트로 바꿔서 권한이 없으면 기동 때 실패하게 한다. 검증은 `redis-sdk-topology.yml` standalone lane에서 `LiveRedisSemanticPortsTest`로 한다. | +| NEW-5b | Consider | `LiveRedisSemanticPortsTest`의 token-bucket 테스트가 +1h 시계 때문에 항상 거부 결과를 받는다(테스트 버그). | 남음 | `src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/LiveRedisSemanticPortsTest.java:230`: adapter 시계가 `Clock.offset(systemUTC, +1h)`다. `:252`: 요청 deadline은 `Instant.now().plusSeconds(5)`다. `RedisEdgeRateLimitAdapter.java:99-106`은 `callerDeadline`이 adapter 시각보다 앞이면 `Unavailable(ADMISSION_REJECTED)`를 돌려준다. 그런데 테스트는 `Evaluated`를 기대한다(:236-238). 원인 추정: "Redis TIME을 쓴다"를 보이려고 넣은 offset이 deadline 검사와 충돌했다. | W4 | `:230`을 `Clock.systemUTC()`로 되돌린다. skew 검증은 이미 `idempotencyLeaseExpiryUsesRedisTimeAcrossSkewedCallers`(:317-)가 한다. offset을 꼭 유지하려면 `request()`가 같은 clock으로 deadline을 만들게 한다. | +| NEW-5c | Required | 멱등성·lease adapter가 "보내기 전 거부"(script lane 없음, lane 포화)도 `Indeterminate`로 분류한다. | 남음 | `src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/idempotency/RedisIdempotencyStoreAdapter.java:109-131`, `lease/RedisDistributedLeaseAdapter.java:145-172`(acquire), `:197-227`(inspect), `:316-346`(renew), `:352-375`(release): `catch (Exception)` 하나로 모두 `Indeterminate`를 돌려준다. 거부는 `RedisRuntimeOwner.borrow`가 `RedisCommandRejectedException`(`RedisOperationException`의 하위 클래스)으로 던진다(`RedisRuntimeOwner.java:136-160`). rate-limit adapter는 이미 이 둘을 구분한다(`RedisEdgeRateLimitAdapter.java:123-132`, `metadata().ambiguousExecution()`). 포트에는 결정적 실패 variant가 있다: `IdempotencyClaimOutcome.Unavailable`(:71), `LeaseAcquireOutcome.Unavailable(LeaseUnavailableCategory.UNAVAILABLE_BEFORE_SEND)`(:34). | W2 | 두 adapter에 `catch (RedisOperationException failure)`를 `catch (Exception)` 앞에 추가한다. `!failure.metadata().ambiguousExecution()`이면 `Unavailable`(lease는 `UNAVAILABLE_BEFORE_SEND`)을 돌려주고, 나머지만 `Indeterminate`로 둔다. 모양은 rate-limit과 같다. 테스트는 script lane이 없는 `runtime(false)`로 claim/acquire를 호출하고 `Unavailable`을 단언한다. | +| NEW-6 | Nit | `S3AsyncResponseBodyBridgeTest`가 벽시계 예산 5초에 의존해 부하가 걸리면 실패할 수 있다. | 남음 | `src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3AsyncResponseBodyBridgeTest.java:45,101`: `CallBudget.fromNow(Duration.ofSeconds(5))`을 테스트 시작 시점에 만든다. `:80,119,127`: `result.get(5, SECONDS)`. bridge는 50ms마다 poll하면서 예산 만료를 `System.nanoTime()`으로 확인한다(`S3AsyncResponseBodyBridge.java:231,261-262`). 두 번째 테스트는 예산 하나(`read`)를 bridge 2개가 차례로 나눠 쓴다(:94-128). 큐 용량 2(chunk 1 + END)는 경합 원인이 아니다(`:164`). 미확인: 실패 로그가 없어서 실제 실패 지점은 확정하지 못했다. | W4 | 예산과 `get` timeout을 30초로 올린다(실패 경로 테스트는 즉시 끝나므로 느려지지 않는다). 두 번째 테스트는 bridge마다 새 `ReadOperation`(새 예산)을 만든다. | +| NEW-7a | Required | durable operation을 같은 operationId로 재시도하면 outbox append가 다시 실행된다. | 남음 | `src/application-core/src/main/java/dev/caskeleton/application/operation/SubmitDurableOperationUseCase.java:100`: `alreadyAccepted = !operation.operationId().equals(command.operationId())`. 같은 id로 재시도하면 store가 기존 행을 돌려주고(`DurableOperationStoreAdapter.java:49-` `submitIfAbsent` 후 조회), id가 같아서 `alreadyAccepted=false`가 되어 `:107` append가 다시 돈다. `eventId=operationId`이고 `outbox_event` PK가 `event_id`다(`V3__outbox_event.sql:14`). `OutboxStoreAdapter.java:71`은 `repository.save(entity)`인데 `OutboxEventEntity.java:20-22`에 `@Version`도 `Persistable`도 없다. 그래서 (추정, Spring Data `isNew` 기본 규칙) merge로 기존 행을 PENDING·attempt 0으로 덮어써서 다시 발행할 수 있다. 기존 테스트는 다른 id로 재제출하는 경우만 본다(`SubmitDurableOperationUseCaseTest.java:92-105`). | W2 | `DurableOperationJpaRepository.submitIfAbsent`(:51)의 반환형을 `int`(삽입 행 수)로 바꾼다. `DurableOperationStorePort.submit`은 `created` 여부를 돌려주게 하고(예: `DurableOperationSubmitResult(operation, created)`), use case는 `created`일 때만 append한다. `OutboxEventEntity`는 `Persistable`(`isNew=true`)을 구현해서 중복 append가 PK 위반으로 드러나게 한다. 테스트: 같은 id로 두 번 submit → `outbox.appended` 1건, `alreadyAccepted=true`. | +| NEW-7b | Consider | `Submit/Get/CancelDurableOperationUseCase`를 쓰는 HTTP 어댑터와 운영 조립이 없다. | 남음 | 이 use case들을 참조하는 main 코드는 `application-core` 자신뿐이다(grep: `new SubmitDurableOperationUseCase` 등 test 밖 0건). 저장소만 `@Repository`로 있다(`DurableOperationStoreAdapter.java:28`). 인바운드 어댑터와 bean 조립이 없다. | W2 | 결정(2026-09-25): HTTP 어댑터 추가 — `POST /operations`(202)·`GET`·`DELETE /operations/{id}`, JPA 조립에 use case bean | +| NEW-8a | Required | 알림 reconcile이 `Unsupported`면 attempt·수신자 상태를 바꾸지 않는다. 행이 영구히 남고 매 recovery 주기마다 다시 조회된다. | 남음 | `src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java:77-84`(gateway 미지원)과 `:126-129`(gateway가 Unsupported 반환)는 metric만 올린다. `:72-74`(snapshot 없음)도 같다. | W2 | `Unsupported`일 때 수신자를 운영자가 확인하는 종단 상태로 옮긴다. 예: `RECONCILIATION_REQUIRED`에 `nextCheckAt=null`, 또는 전용 `MANUAL_REVIEW` 상태. `ambiguousAttemptExists=true`를 유지하고 lease를 해제한다. 전이는 `recipients.transition(...)`을 `transactions.inWrite`로 감싸 `StillUnknown` 분기(:119-125)와 같은 모양으로 한다. | +| NEW-8b | Required | attempt가 모두 완료된 수신자가 `DISPATCHING`에 남는다(1차 리뷰 B-4). | 남음 | `DispatchOutcomeRecorder.java:118-121`: 모호하지 않은 결과면 수신자를 `DISPATCHING`으로 저장한다(callback 대기). `LeaseRecoveryService.java:113`: `expiredDispatching`로 다시 조회한다. `:123-138`: attempt가 모두 `completedAt` 있음이면 아무것도 하지 않는다. 결과적으로 같은 행이 매 batch를 차지해서 다른 행의 복구를 굶길 수 있다. | W2 | `LeaseRecoveryService.recoverOnce`에서 attempt가 모두 완료인 경우를 명시적으로 처리한다. callback 대기 기한(`staleAfter`)이 지났으면 마지막 attempt로 `reconciliation.reconcile(...)`을 호출하고, 그래도 확정이 안 되면 NEW-8a의 종단 상태로 전이한다. 테스트는 attempt가 모두 완료된 DISPATCHING 행 1개로 `recoverOnce`를 두 번 부르고 상태가 바뀌는지 단언한다. | +| NEW-9a | Required | GraphQL 요청 단계 에러가 `GraphQlWireErrorMapper`를 거치지 않는다. adopter의 `ApiErrorCarrier`가 요청 단계에서는 `INTERNAL_ERROR`로 나간다. | 남음 | `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlPlatformWebInterceptor.java:161-168`(`reject`, 호출은 `:95`)과 `GraphQlPlatformInstrumentation.java:81-88`이 `GraphQlPlatformRejectionMapper.map`(:41)을 직접 호출한다. 이 mapper는 platform 예외 9종만 instanceof로 매핑한다(:54-121). 필드 단계만 `GraphQlWireErrorMapper.mapFieldFailure`(:60)를 거친다(`GraphQlDataFetcherExceptionResolver.java:22-44`). 원 지적은 `docs/reviews/2026-09-24-src-maintainability-review.md:912-915`. | W2 | `GraphQlWireErrorMapper`에 `map(Throwable, GraphQlErrorContext)` 진입점 하나를 둔다. platform rejection을 먼저 보고, 그다음 application mapping(`ApiErrorCarrier`), 마지막에 internal로 처리한다. interceptor·instrumentation·field resolver 세 곳이 모두 이 mapper bean을 받는다(`GraphQlPlatformAutoConfiguration.java:388-396`에서 주입). category switch 3개(`GraphQlWireErrorMapper.java:94`, `GraphQlWireErrors.java:56`, `clientMessage`)는 `EnumMap` 표 하나로 합친다. | +| NEW-9b | Nit | `shared-contract`의 `OperationalRecordStorePort` 패키지는 사용처가 0이다. | 남음 | `src/shared-contract/src/main/java/dev/caskeleton/shared/opstore/`(3개 파일). 이 패키지 밖에서 `shared.opstore`를 참조하는 곳은 main·test 모두 0건이다. 유일한 소비자였던 graphql `advanced/**`는 삭제됐다(`docs/capability-status.md:211`). | W3 | `shared/opstore/` 3개 파일을 삭제한다. `src/shared-contract/CLAUDE.md` 책임 목록에 있으면 그 줄도 지운다. `docs/study/graphql-walkthrough.ko.md:125,2064,2133`의 언급은 NEW-14에서 함께 고친다. | +| NEW-10a | Consider | web 운영 경로에 JSON 중복 키 거부가 없다. | 남음 | `src/app-bootstrap/src/main/resources/application.yml:64-80`에는 `fail-on-unknown/null-for-primitives/ignored-properties`만 있다. 중복 키 감지는 web·bootstrap main 어디에도 없다(`STRICT_DUPLICATE_DETECTION` grep 0건). web-advanced에도 없다. JSON mapper factory(`WebObjectMapperFactory`·`BoundedJsonFactory`)는 web-advanced로 옮긴 뒤 삭제됐다(`docs/capability-status.md:208`). | W1 | `adapter:inbound:web`에 `JsonMapperBuilderCustomizer` 빈 하나를 두고 `StreamReadFeature.STRICT_DUPLICATE_DETECTION`을 켠다(Jackson 3, `tools.jackson.core`). 위치는 `WebAdapterAutoConfiguration` import 목록이다. contract test는 `{"a":1,"a":2}` → 400을 단언한다. | +| NEW-10b | Consider | CORS origin의 형식을 기동 때 검증하지 않는다(scheme/host/port 형태, path·trailing slash·`null` origin). | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/settings/CorsSettings.java:24-53`은 "enabled면 비어 있지 않음"과 "`*`+credentials 금지" 두 가지만 검사한다. 예전 `WebCorsPolicyValidator`는 web-advanced로 옮긴 뒤 삭제됐다(`docs/capability-status.md:206`). | W1 | `CorsSettings` compact constructor에 origin마다 `URI` 파싱을 추가한다. `http`·`https` scheme과 host가 있어야 하고, path·query·fragment·trailing `/`와 `"null"`은 금지한다. `*`는 credentials가 없을 때만 허용한다. 실패하면 env 키 이름을 담은 메시지로 기동을 실패시킨다(기존 메시지 형식을 따른다). | +| NEW-10c | Required | 신뢰하지 않는 forwarded 헤더를 거부하는 장치가 없다. rate-limit의 `FORWARDED_HEADERS_TRUSTED`는 XFF의 맨 왼쪽 값(클라이언트가 조작 가능)을 쓴다. | 남음 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/ratelimit/ForwardedHeaderClientIpResolver.java:10-17`은 `split(",")[0]`을 쓰고 remoteAddr가 proxy인지 확인하지 않는다. `server.forward-headers-strategy` 기본값은 `none`(`src/app-bootstrap/src/main/resources/config/server.yml:11`)이지만, `framework`로 바꾸면 모든 요청의 헤더를 신뢰한다. 예전 `ForwardedHeaderSanitizer`·`TrustedProxyPolicy`는 web-advanced로 옮긴 뒤 삭제됐다(`docs/capability-status.md:204`). | W1 | `EdgeRateLimitTransportSettings`에 `trusted-proxies`(CIDR 목록)를 추가한다. resolver는 remoteAddr가 trusted일 때만 XFF를 오른쪽에서부터 읽어 첫 번째 untrusted 주소를 쓰고, 아니면 remoteAddr를 쓴다. `FORWARDED_HEADERS_TRUSTED`인데 `trusted-proxies`가 비어 있으면 기동을 거부한다. `server.yml` 주석에는 `native` + `server.tomcat.remoteip.internal-proxies`를 명시하라고 적는다. | +| NEW-10d | Nit | web fixture 앱 2개와 sample이 `WebAdapterAutoConfiguration` 전체를 제외한다. sample webSystemTest 4곳은 문자열 이름으로 제외한다. | 남음 | 클래스로 제외: `src/adapter/inbound/web/src/testFixtures/java/dev/caskeleton/webtestkit/ContractFixtureApplication.java:38`, `PipelineOrderFixtureApplication.java:46`, `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java:30,49`. 문자열로 제외: `OpenApiDriftContractTest.java:172`, `OpenApiSnapshotTest.java:103`, `DateHeaderContractTest.java:69`, `VirtualThreadMdcE2ETest.java:152`(모두 `src/sample-portfolio/src/webSystemTest/...`). 제외하는 이유는 production security chain을 빼기 위해서다(`ContractFixtureApplication.java:27-30`). | W3 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebAdapterAutoConfiguration.java`의 `@Import` 목록을 `WebAdapterAutoConfiguration`(core)과 `WebSecurityAutoConfiguration`(`JwtDecoderConfig`·`SecurityConfig`·`MethodSecurityConfig`·`RedisSessionWebConfig`·`JwtToAuthenticatedPrincipalConverter`·`AuthorizationAdapter`)으로 나눈다. fixture·sample은 security root만 클래스로 제외하고, sample은 `dev.caskeleton.adapter.inbound.web` component scan(`SamplePortfolioApplication.java:31-40`)을 지운다. 문자열 제외는 클래스 참조로 바꾼다. | +| NEW-11 | Consider | fileserver를 JPA 줄 없이 고르면 Boot 관계형 자동 설정이 켜지고, 원인을 알기 어려운 오류로 기동에 실패한다. | 남음 | `src/adapter/outbound/persistence-fileserver/build.gradle`이 `implementation 'org.springframework.boot:spring-boot-starter-data-jpa'`를 가져서 runtime classpath에 Hibernate·Hikari가 들어온다. `src/composition/fileserver-platform/build.gradle`은 persistence-jpa를 의존하지 않는다. JPA를 끄는 쪽(`JpaActivationEnvironmentPostProcessor`)은 persistence-jpa에 있어서 이 경우 존재하지 않는다. 결과 추정: URL도 embedded DB도 없으면 `DataSourceAutoConfiguration`이 "Failed to configure a DataSource"로 실패한다. URL을 주면 `TransactionPort` 빈이 없어서 `FileserverUploadServiceConfiguration.java:86,116`·`FileserverMaintenanceServiceConfiguration.java:43`에서 NoSuchBean으로 실패한다. Flyway 핵심 stream과 `capability_schema_registry`도 없다(`FileserverSchemaActivation.java:22-30`). "JPA 필요"는 문서에만 있다(`src/README.md:270`, `src/composition/fileserver-platform/README.md:27`). notification도 같은 구조다(`docs/capability-status.md:36`). | W2 | 결정(2026-09-25): 한 줄 원칙 — fileserver·notification composition이 persistence-jpa를 `runtimeOnly`로 함께 가져옴 | +| NEW-12 | Nit | `bootstrap.autoconfigure` 패키지가 component scan 범위 안에 있다. | 남음 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java:19`: `@SpringBootApplication`이 `dev.caskeleton.bootstrap..` 전체를 scan한다. 지금 `autoconfigure/` 아래 4개 root는 imports에 있어서 Boot의 `AutoConfigurationExcludeFilter`가 걸러낸다. 그 외 stereotype은 `@ConfigurationProperties` record 3개뿐이다(grep: `@Configuration`·`@Component` 0건). 지금 당장 문제는 없고, 나중에 root가 아닌 `@Configuration`을 추가하면 조건 없이 등록되는 잠재 위험이다. | W3 | NEW-2 이동 뒤에 남는 `common`·`tracing` root를 scan 밖 패키지(예: `dev.caskeleton.autoconfigure.bootstrap`)로 옮긴다. 옮기지 않을 거면 architectureTest에 "`bootstrap.autoconfigure..`의 `@Configuration`은 `@AutoConfiguration`이어야 한다" 규칙을 추가한다. | +| NEW-13a | Consider | `verifyEnvKeys`는 bootstrap에 유지하기로 결정됐는데, 문서는 아직 "옮기지 않은 검사"라고 적고 있다. | 남음 | 태스크는 `src/app-bootstrap/build.gradle:5`(`ca.config-contract`), 루트 `src/build.gradle:78`(`configContractCheck`)에 있다. 구현은 `src/build-tools/src/main/java/dev/caskeleton/buildtools/config/`(6개 파일)에 있다. 문구는 `CLAUDE.md:32`, `AGENTS.md:68`에 있다. | W3 | JPA evidence를 삭제하면(NEW-13b) build-tools에는 `ca.config-contract` 하나만 남는다. 그 plugin을 `src/build-logic/`으로 옮기고 `src/settings.gradle:6` `includeBuild('build-tools')`와 `build-logic.yml`의 build-tools 단계를 지운다. `CLAUDE.md:32`·`AGENTS.md:68`은 "verifyEnvKeys = app-bootstrap 유지"로 고친다. | +| NEW-13b | Consider | JPA evidence manifest(`ca.jpa-evidence`, `ca.jpa-qualification`)를 폐기하고 leaf 테스트로 옮기기로 결정됐다. 아직 코드에 남아 있다. | 남음 | plugin: `src/build-tools/build.gradle:18-27`, 구현은 `src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/`(45개 파일, 2,701줄). 적용 위치: `src/build.gradle:20`, `src/adapter/outbound/persistence-jpa/build.gradle:5,141-178,216,261-264`. 입력: `src/config/jpa/readiness-cards.yaml`, `src/config/jpa/release-registry.json`. CI: `.github/workflows/jpa-r2-evidence.yml` 전체, `integration-main.yml:130-143`(`jpa-candidate-evidence`), `jpa-release.yml:121-122`. 다른 사용처: `MessagingCapabilityRegistryContractTest.java:128,140,225`가 `readiness-cards.yaml`을 읽고, `JpaReleaseManifest.java:46`(persistence-jpa testFixtures)가 `release-registry.json`을 읽는다. | W3 | build-tools의 `jpa/` 패키지와 두 plugin id를 삭제한다. evidence가 확인하던 사실(마이그레이션 순서, PG 버전 매트릭스, lane 존재)은 persistence-jpa `postgresqlIntegrationTest`의 JUnit 테스트로 옮긴다. yaml·json 입력과 `jpa-r2-evidence.yml`, integration-main의 `jpa-candidate-evidence` 잡, jpa-release의 두 태스크를 지운다. `MessagingCapabilityRegistryContractTest`에서 readiness-cards 의존을 뺀다. | +| NEW-13c | Nit | redis topology lane은 유지하기로 결정됐다. | 완료 | lane plugin은 build-logic `ca.redis-topology-lane`에 있고, `src/adapter/outbound/cache-redis/build.gradle:4,51-53`, `src/adapter/outbound/redis-sdk/build.gradle:3,19-21`, `src/adapter/outbound/redis-runtime/build.gradle:5`이 쓴다. CI는 `redis-sdk-topology.yml`이다. 코드는 옮길 필요가 없다. | W5 | 문서에 "유지"라고만 적는다(`docs/superpowers/plans/2026-09-25-capability-module-packaging.md` 진행 기록 Wave 5 "남은 설계 결정" 문장). | +| NEW-13d | Consider | API surface 검사가 `mainCheck`로 옮겨가서 PR에서 공개 타입 변경을 바로 잡지 못한다. | 남음 | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/apisurface/ApiSurfacePlugin.java:96-101`: `verify`를 `mainCheck`에만 연결한다. 루트 `ci`(`src/build.gradle:127-133`)는 leaf `check` + architecture + quality이고, `mainCheck`(:135-146)는 main push에서만 돈다. 적용 leaf는 graphql, httpclient, notification, persistence-jpa다. | W3 | 결정(2026-09-25): API surface 검사를 PR 단계(`check`)로 올림 | +| NEW-13e | Consider | 어떤 집계 태스크·CI에도 묶이지 않은 strict lane이 있다: `messagingSampleContractQualificationTest`, `posterImageMigrationTest`. | 남음 | 둘 다 `src/sample-portfolio/build.gradle:185-201`에 있다. category를 지정하지 않아 `TEST`로 분류되고(`StrictTestLaneSpec.java:21`), 루트는 `testLaneCheck`를 집계하지 않는다(`src/build.gradle:81-101`에는 integration/architecture/system만 있다). sample은 `leafPaths`에서도 빠진다(`src/build.gradle:65-67`). `.github` grep 결과 0건이다. CI는 `:sample-portfolio:integrationTest`(`integration-main.yml:309`)만 부르며, 이것은 strict(zero-skip)가 아니다. | W3 | `messagingSampleContractQualificationTest`는 루트 `verifyMessagingContracts`(`src/build.gradle:120-125`)의 dependsOn에 추가한다. `posterImageMigrationTest`는 lane에 `integration()`을 지정하고, 루트 `integrationCheck`에 `:sample-portfolio:integrationTestLaneCheck`를 추가하거나 `integration-main.yml:309`를 lane 이름으로 바꾼다. | +| NEW-14a | Consider | `docs/study/*.ko.md` 2개가 삭제된 코드를 설명한다. | 남음 | `docs/study/graphql-walkthrough.ko.md`(3,655줄): 208077fd에는 있고 HEAD에는 없는 클래스 216개를 언급하고, 해당 줄은 약 227줄이다. `docs/study/postgresql-jpa-walkthrough.ko.md`(3,574줄): 70개, 약 110줄. 측정 방법: 문서의 CamelCase 식별자 ∩ (208077fd `.java` − HEAD `.java`). | W5 | 아래 메모 참고. | +| NEW-14b | Consider | `docs/*-superpowers-package/` 3개가 삭제된 코드를 설명한다. | 남음 | graphql package(7개 파일, 9,229줄): 삭제 클래스 약 250개, 해당 줄 약 709줄. web package(8개, 9,812줄): 약 170개, 약 516줄. websocket package(8개, 10,764줄): 약 58개, 약 216줄. 문서마다 `MANIFEST.sha256`와 `validate_*_docs.py`가 있다(CI에서 부르지 않는다. `.github` grep 0건). `validate_graphql_docs.py`는 삭제된 클래스 20개를 하드코딩하고 있다. | W5 | 아래 메모 참고. | + +**조사 메모** + +**NEW-2 composition 모듈 설계** + +- 옮길 클래스는 두 묶음이다. + - `:composition:outbox-relay`(`dev.caskeleton.composition.outbox`): `OutboxConfig`, `OutboxSettings`, `OutboxMetrics`, `OutboxRelayScheduler`, `OutboxLeaderElectionToken`, `OutboxCanonicalTransportRequirementValidator`와 테스트 5개. + - `:composition:idempotency`(`dev.caskeleton.composition.idempotency`): `IdempotencyProviderSelectionConfig`, `IdempotencySettings`와 테스트 2개. + - 모듈 하나로 합쳐도 된다. 다만 sample은 멱등성만 필요하므로 둘로 나누는 편이 edge가 적다. +- 필요한 edge(modules.json `allowed_dependencies`)는 두 모듈 모두 `application-core`, `adapter-outbound-support`다(`StartupFailures`, `RuntimeWarnings`). 외부 라이브러리는 spring-boot-autoconfigure, spring-context, micrometer-core, slf4j, logstash-encoder(outbox의 `kv`)다. adapter edge는 필요 없다. `afterName`은 문자열이라 컴파일 의존이 생기지 않는다. `composition-notification-platform`의 edge 목록이 같은 모양의 예다. +- 누가 가져오는지: + - `app-bootstrap`에 `runtimeOnly` 두 줄을 둔다. store bean이나 provider가 없으면 조건 때문에 꺼지므로 기본 조립에 있어도 안전하다. + - `sample-portfolio`에는 `composition-idempotency` edge를 추가해서 `SampleIdempotencyConfig`의 executor 복사본을 지운다. + - `app-bootstrap`에서는 `AutoConfiguration.imports:2-3`의 두 줄을 지운다. +- `AutoConfiguration.imports` 조건은 지금 것을 그대로 옮긴다. + - outbox: `afterName = {PersistenceJpaAutoConfiguration, MessagingBridgeRootAutoConfiguration}`, `@ConditionalOnProperty(ca-skeleton.outbox.enabled=true)`, `@ConditionalOnBean(OutboxStorePort)`, scheduler에 `@ConditionalOnBean(OutboxMessagePublishPort)`. + - idempotency: `@ConditionalOnExpression(provider != disabled)`와 "store가 정확히 1개" 검사. store는 `ObjectProvider`로 늦게 조회하므로 `after`가 필요 없다. +- 완료 기준 4(`StrictSettingsBinder`로 바인딩)는 지금 두 설정 모두 `@ConfigurationProperties`라서 충족하지 않는다. 옮기면서 바꾼다. +- 함께 고칠 곳: + - `ScheduledJobOverlapPolicyTest`(app-bootstrap architectureTest)와 `BootstrapCapabilityAutoConfigurationReachabilityTest`가 클래스 이름을 참조한다. + - `OutboxReaper.java:28` 주석, `docs/capability-status.md:34-35`, 각 README를 고친다. + - ArchUnit `PERSISTENCE_DOES_NOT_DEPEND_ON_APPLICATION_SERVICES`는 `adapter.outbound.persistence..`만 대상으로 하므로 `composition..` 패키지는 걸리지 않는다. composition 전용 규칙은 없다. + +**NEW-14 문서 목록과 작업량** + +- 대상 파일은 모두 26개다. 줄 수와 삭제된 클래스 언급 수는 표와 같다. + - `docs/study/graphql-walkthrough.ko.md`: 가장 크다. graphql `advanced/**`(130개 클래스)와 `AdapterActivation*`를 설명한다. + - `docs/study/postgresql-jpa-walkthrough.ko.md`: `PolicyTransactionPort`·commit 모호성 계열을 설명한다. + - `docs/graphql-superpowers-package/docs/superpowers/plans/*.md` 2개, `docs/web-superpowers-package/docs/superpowers/plans/2026-08-13-web-inbound-http-api-execution-platform-implementation-plan.md`, `docs/websocket-superpowers-package/docs/superpowers/plans/2026-08-14-websocket-realtime-connection-platform-implementation-plan.md`: 이 4개에 삭제 언급의 약 80%가 몰려 있다. +- 작업량 추정: + - study 2개: 고칠 줄 약 340줄. 절(section) 단위로 다시 쓰면 문서당 반나절~1일이다. + - package 3개: 고칠 줄 약 1,440줄. 대부분 "구현 계획" 본문이다. 갱신하면 계획을 현재 구조로 다시 쓰는 일이 되어 package당 1~2일이다. 편집한 뒤에는 `MANIFEST.sha256`을 다시 계산하고 `validate_*_docs.py`의 하드코딩 목록을 고쳐야 한다. +- 측정의 한계: + - 208077fd와 HEAD 사이에 삭제된 클래스만 셌다. 그 전에 삭제됐거나 처음부터 구현되지 않은 이름은 세지 않았으므로 실제 불일치는 더 많다. + - 모듈 이름 언급은 세지 않았다. + diff --git a/docs/superpowers/plans/2026-09-25-review-followup.md b/docs/superpowers/plans/2026-09-25-review-followup.md new file mode 100644 index 00000000..5bc55bc3 --- /dev/null +++ b/docs/superpowers/plans/2026-09-25-review-followup.md @@ -0,0 +1,222 @@ +# 2026-09-24 리뷰 남은 항목 전부 반영 — 실행 계획 + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** `docs/reviews/2026-09-25-review-followup-status.md`의 `남음` 행(544행)을 전부 `완료` / `해당 없음` / `보류(사유·승인자)`로 닫는다. + +**Architecture:** 행 하나의 구체적 수정 방향은 현황표의 「수정 방향」 열이 정본이다(현재 `file:line` 포함). 이 계획은 그 행들을 소유 영역별 작업 묶음(package)으로 나누고, Wave 순서(보안·데이터 → 정합성 → 구조 → 테스트 → 문서)대로 실행·검증·커밋하는 방법을 정한다. 계획은 rolling-wave다: 전체 구조와 Wave 1–2 묶음은 지금 확정하고, Wave 3–5의 상세 Task는 그 Wave를 시작할 때 이 문서에 추가한다. + +**Tech Stack:** Java 21, Spring Boot 4.0.8, Gradle 멀티모듈(registry `src/config/architecture/modules.json`), JUnit 5 + AssertJ + ArchUnit, Testcontainers(PostgreSQL·Redis·Kafka·Mongo·MinIO), Flyway. + +**Spec:** 입력 리뷰 `docs/reviews/2026-09-24-src-module-code-review.md`(1차), `docs/reviews/2026-09-24-src-maintainability-review.md`(2차), 실행 지시 `docs/reviews/2026-09-25-review-followup-prompt.md`, 소유자 결정은 현황표 「소유자 결정」 절. + +## Global Constraints + +- HARD-STOP 7개(`AGENTS.md`)는 모든 Wave에서 유지한다. 모든 project 의존성은 `modules.json`의 `allowed_dependencies` 안에 있어야 한다. 새 edge가 필요하면 registry에 먼저 추가하고 이유를 커밋 메시지에 적는다. +- 커밋: 브랜치 `refactor/review-followup`에 Wave마다 커밋(소유자 결정 1). `main` 병합·push는 사용자 확인 후. +- 이미 적용됐을 수 있는 Flyway versioned migration은 바이트를 바꾸지 않는다. 새 버전을 추가하고 `src/adapter/outbound/persistence-jpa/src/test/resources/db/applied-migrations.sha256`에 한 줄 추가한다(`AppliedMigrationImmutabilityTest`). +- 결함 수정은 재현 테스트를 먼저 쓰고 FAIL을 확인한 뒤 고친다. fake가 결함을 숨긴 포트는 추상 계약 테스트(`XxxContract`)로 fake와 어댑터를 함께 돌린다. +- 새로 쓰거나 고치는 테스트는 `AGENTS.md` 테스트 작성 규칙 6개를 따른다. 단 `@DisplayName` 언어는 **한국어**(소유자 결정 5, AGENTS.md 규칙 2는 Wave 4에서 문구 수정). +- capability 규칙: "있으면 켜짐, `enabled=false`면 완전히 꺼짐", 설정 prefix 하나, `StrictSettingsBinder` + compact constructor 검증, 동작하지 않는 옵션은 키를 두지 않는다. +- 지운 코드는 `docs/capability-status.md` 「제거된 코드」 표에 `| 대상 | 경로 | 마지막으로 존재한 커밋 | 이유 |`로 한 행씩 남긴다(마지막 커밋은 `6d27356e`). +- 재생성 태스크: lockfile `./gradlew :resolveAndLockAll --write-locks`, API surface `update*ApiSurface -Papprove*`(notification은 `-PapproveNotificationApiSurfaceChange`), 확인 `verifyDependencyLocks`. lockfile은 손으로 합치지 않고 재생성한다. +- Gradle은 한 작업 트리에서 동시에 하나만. 긴 실행에는 `timeout`을 건다. 파일은 파일 쓰기 도구로 쓴다(셸 heredoc 금지). +- 문서에 leaf 개수를 적지 않는다(registry가 SSOT). + +## Review Focus + +사용자가 가장 먼저 부딪힐 입력·조건과 기대 동작. 각 줄의 테스트는 해당 묶음에 넣는다. + +1. **fileserver에서 같은 역할 등급의 다른 사용자가 남의 fileId로 조회·다운로드·삭제** → 403(또는 404)이어야 한다. (P4 C-8a: 소유자 검사 계약 테스트) +2. **외부 API 호출 중 cross-origin redirect** → `Authorization`·API-key·`traceparent`가 다음 host로 가지 않아야 한다. (P11 H-2·H-3c·H-4a) +3. **`X-Forwarded-For`를 위조한 비인증 요청으로 rate-limit 우회** → trusted proxy가 아니면 XFF를 무시해야 한다. (P10 I-5a·NEW-10c) +4. **Mongo 검색 API에 `{"$ne": null}` 같은 operator 객체가 값으로 들어옴** → 거부해야 한다. (P12 F-1a·F-1b) +5. **Kafka broker가 사설 CA·SASL을 요구** → 설정한 truststore·credential로 연결되고, 설정이 없으면 기동이 실패해야 한다(평문 fallback 금지). (P1 M-2e·NEW-4b) + +--- + +## 실행 방식 + +### 작업 단위와 병렬 + +- 묶음(package) 하나 = 구현 subagent 하나. subagent는 `isolation: worktree`로 자기 git worktree에서 일한다(같은 작업 트리에서 Gradle 동시 실행 금지 규칙을 worktree 분리로 지킨다). +- 동시에 도는 묶음은 **최대 3개**(이 머신의 여유 메모리 약 5GB). Gradle은 `--max-workers=2`로 돌린다. +- subagent는 자기 worktree에서 커밋한다. 커밋은 묶음 안에서 `D`(결정된 삭제) → `W1` → `W2` 순서로 나눈다. 메시지 형식: `review-followup : <요약>`. +- 통합은 오케스트레이터가 한다: Wave 1은 모든 묶음의 `D`·`W1` 커밋을 `git cherry-pick -n`으로 모아 검증 후 한 커밋, Wave 2는 `W2` 커밋을 같은 방식으로. cherry-pick 충돌·실패는 멈추고 해결한다(조용히 넘기지 않는다). 적용 뒤 worktree 파일과 main 파일을 `git diff -- `로 대조한다. +- 여러 묶음이 함께 고치는 파일(`docs/capability-status.md`, `docs/registries/env-keys.yaml`, `src/.env.example`, `app-bootstrap/build.gradle`, lockfile)은 충돌을 예상한다. `docs/capability-status.md`와 현황표는 subagent가 고치지 않고 결과 파일에 적는다(아래). lockfile은 통합 뒤 재생성한다. + +### subagent 결과 파일 + +각 묶음은 `/results/.md`에 아래 세 절을 쓴다. 오케스트레이터가 이것으로 현황표와 「제거된 코드」 표를 갱신한다. + +```markdown +## 행 결과 +| ID | 결과 | 근거 | +|---|---|---| +| C-2a | 완료 | `FileVerdictServiceTest.quarantineKeepsStagedBytes` FAIL→PASS, `path/File.java:88` | +| H-5a | 해당 없음(코드 삭제) | P11 D 커밋에서 reactive 스택 삭제 | +| X-1 | 보류 | 사유: … / 승인자: 저장소 소유자 결정 필요 | +| Y-2 | 남음 | 이유: … (다음 Wave로) | + +## 제거된 코드 +| 대상 | 경로 | 마지막으로 존재한 커밋 | 이유 | + +## 새로 발견한 결함 +(현황표에 없는 결함. ID는 `-new-1`…) +``` + +### Wave 종료 검증 (결과 수치를 「진행 기록」에 남긴다) + +```bash +cd src +./gradlew check --continue +./gradlew ci verifyDependencyLocks --warning-mode=fail +./gradlew mainCheck --continue +./gradlew architectureCheck verifyPublicPathSnapshot :app-bootstrap:verifyEnvKeys configContractCheck +./gradlew :app-bootstrap:integrationTest :sample-portfolio:integrationTest :sample-portfolio:systemTest +./gradlew -p build-logic test && ./gradlew -p build-tools test && ./gradlew -p optional-platforms ci +./gradlew :app-bootstrap:qualificationBootJar +# 건드린 영역의 실제 벤더 lane (Docker): persistence-jpa jpaPlatform*Test / postgresql*IntegrationTest, +# persistence-mongo mongo*Test, messaging starter integrationTest, redisTopologyTest, objectstorage MinIO lane +``` + +Wave마다 Slack `#clean-architecture-전체`에 템플릿 1로 브리핑한다. + +## Wave 개요 + +| Wave | 내용 | 대상 행 | 완료 기준 | +|---|---|---|---| +| 1 | 결정된 삭제(`D`) + 보안·데이터 손실(`W1`) | `W1` 55행 + 결정된 삭제 | 삭제 대상 main 참조 0, W1 행마다 재현 테스트 FAIL→PASS, Wave 종료 검증 통과 | +| 2 | 정합성(`W2`) | 139행 | 행마다 재현 테스트(또는 결정된 기능 추가의 계약 테스트), Wave 종료 검증 통과 | +| 3 | 구조(`W3`) — 공통 작업(에러 어휘·prefix·outbox·composition·공통 유틸) 먼저 순차, 그다음 영역별 | 196행 | 결정 7–20 반영, capability 완료 기준 7 충족, Wave 종료 검증 통과 | +| 4 | 테스트 규칙(`W4`) — 포트 계약 테스트, 약한 단언, 계층별 모범 모듈, AGENTS.md DisplayName 규칙 | 56행 | 포트마다 fake·어댑터 공통 계약, Wave 종료 검증 통과 | +| 5 | 문서 drift·Nit(`W5`) + 학습 문서 현재 코드 기준 갱신(결정 6) | 98행 | 문서가 가리키는 타입·경로가 전부 존재, 현황표 전 행 종료 | + +**결정된 삭제를 Wave 1 앞에 두는 이유:** httpclient reactive(결정 9), 알림 provider 5종, object storage direct·multipart, gRPC 상수 gate는 지울 코드다. 그 코드의 W1·W2 결함을 먼저 고치면 버릴 작업이 된다. 삭제로 사라진 행은 `해당 없음(코드 삭제)`로 닫는다. + +**legacy Kafka seam(`X1-지도-Kafka producer`, `X1-#1f`, `NEW-4a`):** 결정 7(outbox canonical 통일)로 경로 자체가 삭제된다. Wave 3 공통 작업 3-C에서 닫는다. Wave 1에서는 손대지 않는다. + +--- + +## Wave 1–2 묶음 + +각 묶음의 subagent는 Wave 1 행(`W1`)을 먼저 끝내고 커밋한 뒤 Wave 2 행(`W2`)으로 넘어간다. 행별 수정 방향은 현황표의 「수정 방향」 열을 따르고, 코드를 읽어 보니 방향이 틀렸으면 더 작은 올바른 수정을 하고 결과 파일 근거에 이유를 적는다. + +### P1: messaging (vendored `messaging:*`, `adapter:outbound:messaging`, `adapter:outbound:messaging-kafka`) + +- W1: `M-2c`, `M-2d`, `M-2e`, `M-2f`, `NEW-4b`, `NEW-4d` (legacy seam 3행은 Wave 3) +- W2: `M-2b`, `M-3`, `M-4a`, `M-4b`, `M-4c`, `M-5a`, `M-5b`, `M-6`, `M-7`, `M-11`, `S6-#2b`, `S6-lead-3`, `S7-lead-3`, `NEW-4c` +- 검증: 소유 leaf `check`, messaging starter integrationTest(Kafka Testcontainers), `architectureCheck` + +### P2: object storage (`application-objectstorage`, `adapter:outbound:objectstorage`) + +- D: `D-7a`, `D-7b`, `D-7c` — direct·multipart 조립 안 된 코드 삭제(현황표 「소유자 결정」 끝 문단) +- W1: `D-1a`, `D-1b`, `D-1c`, `D-6a`, `D-6b`, `X2-P1-1a` +- W2: `D-2a`, `D-2b`, `D-2c`, `D-3a`, `D-3b`, `D-3c`, `D-3d`, `D-5 / X1-#8b`, `D-9`, `D-10`, `NEW-6`(`S3AsyncResponseBodyBridgeTest` 간헐 실패) +- 검증: 소유 leaf `check`, MinIO lane, sample-portfolio `check`(poster image 경로가 object storage를 씀) + +### P3: notification (`application-notification`, `adapter:outbound:notification`, `adapter:inbound:web-notification`, `composition:notification-platform`) + +- D: `S4-#3a` — 미조립 provider 5종(APNs·FCM·Twilio·WebPush·Webhook)과 참조 0인 `SesSuppressionUpdater` 삭제, `ProviderType`에서 5종 제거 +- W1: `B-2e`, `B-6`, `B-7a`, `B-7b`, `X2-P2-7b` +- W2: `B-3`, `B-4a`, `B-4b`, `B-5a`, `B-5b`, `B-7c`, `B-9a`, `B-9b`, `X1-#6e`, `S4-#3b`, `NEW-8a`, `NEW-8b` +- 검증: 소유 leaf `check`, notification PG lane, `:adapter:outbound:notification` API surface 재승인 + +### P4: file server (`application-fileserver`, `adapter:outbound:persistence-fileserver`, `adapter:outbound:fileserver`, `adapter:inbound:web-fileserver`, `composition:fileserver-platform`) + +- W1: `C-2a`, `C-2b`, `C-5a`, `C-5c`, `C-8a`(결정 14 — `ownerPrincipalId` 새 migration, 기본 정책이 소유자·tenant 검사), `C-8b`, `C-8c` +- W2: `C-3a`, `C-3b`, `C-3c`, `C-3d`, `C-4a`, `C-4b`, `C-5b`, `C-6`, `C-7a`, `C-7b`, `C-9a`, `C-9b`, `C-11`, `S1-#5`, `S1-lead-6`, `NEW-3`(보상 트랜잭션 30초 timeout 복원), `NEW-11`(composition이 persistence-jpa를 `runtimeOnly`로) +- 검증: 소유 leaf `check`, fileserver PG lane, `architectureCheck` + +### P5: realtime + gRPC (`adapter:inbound:websocket`, `adapter:inbound:grpc`, `src/grpc*` — optional-platforms 별도 build) + +- D: `S7-#4` — gRPC 상수 gate·guard·`GrpcStableModuleCatalog`(이전 계획 Wave 2 표 2-G) 삭제 +- W1: `K-11a`, `N-3`, `N-4` +- W2: `K-6`, `K-10b`, `N-2`, `N-5a`, `N-5b`, `N-5c`, `N-5d`, `N-5e`, `N-6a`, `N-6b`, `N-6c`, `N-7`, `N-8a`, `N-8b`, `N-8c`, `N-11a`, `N-11b`, `X1-지도-Admission / in-flight`, `X1-#10a`, `X2-P1-3b` +- 검증: websocket·grpc adapter `check`, `./gradlew -p optional-platforms ci`, gRPC ledger PG lane + +### P6: Redis (`adapter:outbound:redis-runtime`, `adapter:outbound:redis-sdk`, `adapter:outbound:cache-redis`) + +- W1: `NEW-5a` (ACL `+time` + 실제로 `TIME`을 부르는 probe) +- W2: `G-1b`, `G-1c`, `G-2a`, `G-3a`, `G-3b`, `G-9a`, `G-9b`, `G-10a`, `G-10b`, `S3-#4a`, `S6-#6b`, `NEW-5c`, 그리고 `NEW-5b`(테스트 시계 +1h 버그) +- 검증: 소유 leaf `check`, `redisTopologyTest`, `LiveRedisSemanticPortsTest` 4건 통과 + +### P7: core + bootstrap/sample (`domain-core`, `shared-contract`, `application-core`, `adapter:outbound:support`, `adapter:outbound:identifier`, `app-bootstrap`, `sample-portfolio`) + +- W1: `A-1a`, `TEST-F-2c`(PII 테스트를 실제로 실패할 수 있게 — `A-1b`와 함께) +- W2: `A-7a`, `A-7b`, `A-8b`, `X1-#1d`, `S4-#4a`, `S4-#14a`, `L-7a`, `L-8a`, `L-8b` +- 검증: 소유 leaf `check`, `:app-bootstrap:integrationTest`, `:sample-portfolio:systemTest` + +### P8: GraphQL (`adapter:inbound:graphql`) + +- W1: `J-8` +- W2: `J-2`, `J-3a`, `J-4a`, `J-4b`, `J-9a`, `J-12 / X2-P2-6b`, `S5-#6a`, `S5-lead-3`, `NEW-9a` +- 검증: graphql `check`, graphql 실제 lane + +### P9: JPA / PostgreSQL + durable operation (`adapter:outbound:persistence-jpa`, `application-core` operation 패키지, `adapter:inbound:web` operation 엔드포인트) + +- W1: `E-10a`, `E-10c` +- W2: `E-2b`, `E-3a`, `E-4a`, `E-4b`, `E-5a`, `E-5b`, `E-7`, `E-8a`, `E-8b`, `S6-#3b`, `NEW-7a`, `NEW-7b`(결정 15 — `POST /operations`(202)·`GET`·`DELETE /operations/{id}`) +- 검증: persistence-jpa `check`, `jpaPlatform*Test`·`postgresql*IntegrationTest`, web `check`, `verifyPublicPathSnapshot`(새 경로 승인) + +### P10: web (`adapter:inbound:web`, `adapter:inbound:web-advanced`) + +- W1: `I-2a`, `I-2b`, `I-5a`, `I-8b`, `NEW-10a`, `NEW-10b`, `NEW-10c` +- W2: `I-3b`, `I-4a`, `I-4b`, `I-6a`(결정 13 — category 필수, 판정은 유스케이스), `S6-#11b` +- 검증: web·web-advanced·web-notification `check`, `verifyPublicPathSnapshot` + +### P11: HTTP client (`adapter:outbound:httpclient`) + +- D: `S3-#1` — reactive(WebClient·Reactor Netty) 스택과 webflux·reactor 의존 삭제(결정 9). `H-5a`–`H-5c`, `H-7b`, `S3-#2a`는 이 삭제로 닫힌다(남은 blocking 경로에 같은 결함이 없는지 확인 후). +- W1: `H-2`, `H-3a`, `H-3b`, `H-3c`, `H-4a` +- W2: `H-6a`, `H-6b`, `H-8`, `H-9`, `S3-#13b` +- 검증: httpclient `check`, lockfile 재생성, `verifyDependencyLocks` + +### P12: MongoDB (`adapter:outbound:persistence-mongo`) + +- W1: `F-1a`, `F-1b`, `F-5a`, `F-5b`, `F-5c`, `X2-P1-1b`(registry edge 추가 필요 — 이유를 커밋에) +- W2: `F-2a`, `F-2b`, `F-4a`, `F-4b`, `F-8` +- 검증: persistence-mongo `check`, `mongo*Test` 실제 lane + +### P13: build / CI (`src/build-logic`, `src/build-tools`, root Gradle, `.github/workflows`, `scripts/`) + +- W1: `O-5b` +- W2: `O-3a`, `O-3b`, `O-3c`, `NEW-1a`(compose smoke가 켜진 capability·DB 벤더를 health component·info로 확인). `NEW-1b`(18 lane 실제 실행)는 Wave 4에서. +- 검증: `./gradlew -p build-logic test`, `./gradlew -p build-tools test`, `ci`, 로컬에서 compose smoke 1개 lane 이상 실제 실행 + +### 실행 순서 + +동시 3개. 삭제가 있는 묶음을 먼저 돌린다: P11 · P3 · P2 → P1 · P4 · P10 → P5 · P6 · P9 → P7 · P8 · P12 · P13. 앞 묶음이 끝나면 다음 묶음을 바로 넣는다. + +- [ ] Wave 1–2 묶음 13개 실행, 결과 파일 13개 수집 +- [ ] `D`·`W1` 커밋 통합 → Wave 종료 검증 → 현황표·「제거된 코드」 갱신 → 커밋 `review-followup Wave 1` → Slack 브리핑 +- [ ] `W2` 커밋 통합 → Wave 종료 검증 → 현황표 갱신 → 커밋 `review-followup Wave 2` → Slack 브리핑 + +--- + +## Wave 3 — 구조 (시작할 때 상세 Task 추가) + +공통 작업(여러 leaf를 한 번에 바꿔서 순차로 한다): + +- 3-A 에러 어휘: Envelope 하나(결정 2), `ApiErrorCode` 하나, shared 예외에 `ApiErrorCarrier`, `Category`별 한국어 문구 표(결정 11), IAE는 모든 전송 400, Draft-12 offset 문서만 예외(결정 12). X2 P2-1~P2-3, S5 관련 행. +- 3-B 설정 prefix `app.*` 통일(결정 16). +- 3-C outbox canonical 통일(결정 7) + outbox relay·멱등성 executor 조립을 `composition:*` 모듈로(결정 3, `NEW-2`) + legacy Kafka seam 삭제(`X1-#1f`, `NEW-4a`) + sample `SampleIdempotencyConfig` 복사본 제거. +- 3-D 공통 유틸: `Sha256`, `Backoff`, traceparent 파싱, tenant 값 타입, caller 트랜잭션 guard, 서명 헬퍼. + +그다음 영역별: Kafka 소비(결정 10), SES → AWS SDK(결정 17), gRPC protobuf 플러그인 + Buf(결정 18), `persistence-notification` leaf 추출, SRP 분해, 구현 1개 인터페이스 정리, 이름 규칙, 빌드 게이트 이동(결정 4, API surface → `check` 결정 20). + +## Wave 4 — 테스트 규칙 (시작할 때 상세 Task 추가) + +`AGENTS.md` 규칙 2를 한국어로 수정, 포트별 추상 계약 테스트(lock·lease 포함, 결정 8), 약한 단언 정리, 계층별 모범 모듈. + +## Wave 5 — 문서 (시작할 때 상세 Task 추가) + +W5 행 전부, `docs/study/*.ko.md`·`docs/*-superpowers-package/`를 현재 코드 기준으로 갱신(결정 6), 현황표 마감. + +--- + +## 진행 기록 + +| Wave | 상태 | 검증 | 커밋 | 비고 | +|---|---|---|---|---| +| 준비 | 완료 (2026-09-25) | 기준 `./gradlew check --continue` 통과(481 task) | - | 현황표 812행(완료 161 / 해당 없음 106 / 남음 544 / 보류 1), 소유자 결정 20건 |