The plan declares seven JVM test suites (`test`, `integrationTest`, `contractTest`,
`migrationTest`, `failureTest`, `performanceTest`, `compatibilityTest`). This leaf already owns a
Docker-backed `postgresqlIntegrationTest` source set and its readiness Gradle tasks are registered
in a fail-closed contract (`verifyJpaReadinessRegistry` in `src/build.gradle`).
as strict lanes in this leaf's `build.gradle`; `JpaReadinessRegistryTest` holds the readiness cards
to those lanes (it replaced the build-tools `verifyJpaReadinessRegistry`).
| Plan suite | Repository lane |
|---|---|
@@ -101,7 +102,7 @@ Docker-dependent lanes fail closed rather than skipping, matching the existing
| `settings.gradle.kts` module registration | Fail-closed 19-leaf registry | No registry change: leaf identity, Gradle path, allowed dependencies, and runtime memberships are unchanged. |
| `infra/jpa/{postgres,roles,toxiproxy}` | Repository already owns `infra/` | Created at the same repository-relative paths. |
| `docs/jpa/**`, `docs/adr/ADR-JPA-*`, `.github/workflows/jpa-*.yml` | Repository already owns `docs/` and `.github/workflows/` | Created at the same repository-relative paths. |
| release blocking aggregate | `.github/workflows/jpa-release.yml` | CI names the blocking JPA lanes directly; Gradle only defines how each lane runs. |
| release blocking aggregate | `jpaReleaseQualification` (persistence-jpa `build.gradle`) over `config/jpa/release-registry.json`, run per PostgreSQL major by the `jpa-release-gate` job in `.github/workflows/release.yml` | The registry names the blocking lanes; Gradle defines how each lane runs; CI only schedules the matrix. | |
| Per-task `git add` + `git commit` | `AGENTS.md`: commit policy is `human-only`; agents do not stage, commit, amend, or push | Implementation is delivered unstaged. This is the only plan step intentionally not executed, and it is recorded here. |
| Querydsl as an optional module dependency | Querydsl is not part of this repository's dependency set | `querydsl` is implemented against the plan's contracts with the Querydsl types kept behind `compileOnly`, so the Stable runtime classpath never carries Querydsl and a deployment opting in adds the artifact itself. |
| Hibernate Envers as a module dependency | Envers is not part of this repository's dependency set | Same treatment as Querydsl: `compileOnly` + explicit opt-in, matching the plan's "Envers is opt-in and never enabled by a global base class". |
`eaf1af1c`(레인 단계 정리·integrationCheck 로컬 통과), `6d3050d4`(release workflow 통합·releaseCheck tag 전용·build-logic 정리),
`7fe5d754`(spotlessApply), 그리고 이 결과 파일 커밋.
## 행 결과
| ID | 결과 | 근거 |
|---|---|---|
| O-4c | 완료 | `JavaConventionsPlugin`에 runtime classpath `metaInf` 정규화(`Implementation-Version`·`Build-Revision` 무시), `src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java`. 재현: `GIT_SHA`만 바꿔 `:application-core:test` 두 번 실행 — 정규화 없이 재실행됨(FAIL, cache miss) → 정규화 후 `UP-TO-DATE`(PASS). 추가로 leaf version에서 revision을 뺐다(BUILD-O3-5) |
| O-8 / BUILD-중복-2 / BUILD-바로할것-6 | 완료 | build-tools `junit` 패키지(`JUnitEvidenceReader`)를 JPA evidence와 함께 삭제(`de075afe`). 남은 "지정 테스트 실행·skip 없음" 구현은 `StrictLaneExecutionTracker`(정본)와 `RedisTopologyExecutionTracker`(소유자 결정 4로 유지) 둘 |
| BUILD-결론-1 | 남음 | build-logic+build-tools Java 10,504줄 → build-logic 6,185줄(main 4,184 + test 2,001; build-tools 0). 목표 3.5–4k에는 BUILD-O3-5 나머지(auxiliary → jvm-test-suite, release-provenance 제거)가 필요 |
| BUILD-결론-2 | 완료 | 기능별 evidence 검사 중 JPA(`jpa/` 2,701+706줄, `junit/` 138+76줄) 삭제. 남은 E는 redis topology(소유자 결정 4로 유지) |
| BUILD-중복-8 | 완료 | `src/app-bootstrap/build.gradle``architectureTestRuntimeOnly project(':sample-portfolio')` + optional-platforms는 Gradle 방향 게이트로 충분하다는 주석. sample을 넣자 `ForbiddenApiArchitectureTest.NO_UUID_RANDOM_IN_CONTROLLER` FAIL(`PublishPosterImageUseCase.handle`의 `UUID.randomUUID()`) → id 포트(`ids.allocate()`)로 고쳐 PASS(`:app-bootstrap:architectureTest` 180/180). app-bootstrap lockfile 재생성(+1줄) |
| BUILD-계획-B2 | 완료 | `jpa-release.yml`·`fileserver-certification.yml`의 job을 `release.yml`로 옮기고 두 파일 삭제, `app-image-release`가 `jpa-release-promotion`·`jpa-registry-and-docs`·fileserver 4 job을 `needs`. `JpaReleaseRenderingTest`는 `release.yml`을 읽고, `FileserverDocumentationCoverageTest`는 `fileserver-*.yml` + `release.yml`의 job id를 읽음(둘 다 PASS) |
| BUILD-계획-B3 | 보류 | 구현한 부분: `object-storage-qualification.yml` PR 트리거에 경로 필터, MinIO 두 레인을 objectstorage `check`에서 `mainCheck`로(`src/adapter/outbound/objectstorage/build.gradle`). 남은 "PR `ci`를 변경 모듈만 실행"은 영향 모듈 계산 방식(Gradle 의존 그래프 역추적·경로 매핑)과 누락 위험 수용 범위를 정해야 하고 로컬에서 검증할 수 없음. 승인자: 저장소 소유자 결정 필요 |
| BUILD-계획-B4-17 | 완료 | 결정 20: API surface는 PR(`check`)에서 돈다(NEW-13d). notification-platform.yml PR job의 별도 `verifyNotificationApiSurface` step은 같은 job의 `:adapter:outbound:notification:check -x test`가 이미 돌리므로 삭제("PR에서 main으로" 방향은 결정 20에 따라 닫음) |
| BUILD-계획-B4-30 | 완료 | `MongoTestLaneContractTest`에 태그, 레인 `mongoDocumentContractTest`(`src/adapter/outbound/persistence-mongo/build.gradle`). `mainCheck` 실행에서 세 레인 모두 실행 확인 |
| BUILD-계획-C | 보류 | 서명 대상(GHCR push)과 keyless OIDC 토큰은 tag 실행에서만 있어 로컬 검증 불가. 이 workflow는 제3자 action 대신 체크섬 고정 바이너리를 설치하는 정책인데, 이 환경에서 cosign 릴리스 체크섬을 확인할 수 없어 확인하지 않은 체크섬·action SHA를 넣지 않음. 결정할 것: cosign 버전·설치 방식(체크섬 고정 vs `sigstore/cosign-installer` SHA 고정), image job에 `id-token: write` 부여. 승인자: 저장소 소유자 결정 필요 |
| BUILD-O3-2 | 완료 | build-tools `jpa/`·`junit/`, `ca.jpa-evidence`·`ca.jpa-qualification` 삭제. readiness 카드 검사 → `JpaReadinessRegistryTest`(persistence-jpa `test`, 입력 `readiness-cards.yaml`·`src/postgresqlIntegrationTest/java` 선언). `everyImplementedCardNamesTasksThisLeafDeclares` FAIL(삭제된 `verifyJpaPrimaryFoundationEvidence`를 가리키던 카드, AssertionError at :106) → 카드를 `integrationTestLaneCheck`로 고쳐 PASS. 카드가 인용한 scenario는 readiness 레인의 `requires` + `rejectSkipped`로(manifest가 JUnit XML로 확인하던 것). `jpaReleaseQualification`은 leaf 집계 태스크(registry의 blocking gate를 dependsOn). workflow: `jpa-r2-evidence.yml`, integration-main `jpa-candidate-evidence` 삭제 |
| BUILD-O3-5 | 남음 | 완료: public-path → app-bootstrap `PublicPathSnapshotTest`(main 단계 레인 `publicPathSnapshotTest`, 루트 별칭 `verifyPublicPathSnapshot`, 승인 `-PapprovePublicPathChange`; 기준선은 헤더의 명령만 바뀜), developer-bootstrap → `scripts/bootstrap-local.sh`, leaf version에서 revision 제거 후 archive-hygiene 삭제, app-bootstrap `springBoot.buildInfo`(`build.revision`, `time` 제외). 남음: (1) `ca.release-provenance` 플러그인 제거 — `src/optional-platforms/build.gradle`이 적용하고 있어 이번 Wave에서 건드리지 않기로 한 gRPC build 파일 수정이 필요, (2) auxiliary → `jvm-test-suite` — grpc·messaging 포함 14개 leaf build 파일을 바꾸는 작업이라 동시 묶음과 충돌. 둘 다 다음 순차 작업으로 |
| BUILD-바로할것-7 | 완료 | BUILD-중복-3과 같음. adopter 목록 파일(`docs/architecture/jpa-adopter-api-surface.txt`)은 따로 두되 구현은 `ca.api-surface` 하나(surface 기준선은 렌더링이 재생성하므로 표시를 섞지 않음). persistence-fileserver 타입 `FileserverSchemaActivation` 항목은 JPA surface가 아니어서 제거 |
| BUILD-바로할것-12d | 완료 | api-surface 부분은 결정 20에 따라 PR `check`로(반대 방향 행을 결정 20으로 닫음). notification evidence·env registry·mongo lane contract는 B4-27·28·30의 main 단계 레인 |
| X1-지도-readiness / evidence / API-surface / moduleboundary | 보류 | 완료: JPA readiness·evidence → persistence-jpa 테스트(manifest 폐기), API surface 구현 하나. 남은 "messaging 카드 검증은 messaging leaf로": `MessagingCapabilityRegistryContractTest`는 `config/messaging/*.yaml`을 snakeyaml로 읽는데 `adapter:outbound:messaging`은 모든 configuration(테스트 포함)에서 YAML·Jackson 2를 exclude+reject한다("Jackson 3 only and YAML-free"). 옮기려면 카드 파일을 JSON으로 바꾸거나 test 설정만 예외로 둘지 정해야 함. 승인자: 저장소 소유자 결정 필요 |
| X1-#7a | 보류 | 위 행과 같은 작업. JPA 검증기는 leaf 테스트로 옮김, messaging 검증기 이동은 같은 사유로 결정 필요. 승인자: 저장소 소유자 결정 필요 |
| S1-#16 | 완료 | `src/application-core/build.gradle``implementation project(':domain-core')` 복원(registry 허용 edge). `architectureCheck` PASS. 같은 행의 `NotificationIdGeneratorPort`·`UploadIdentifierFactory` → `IdFactory` 정리는 application-notification/fileserver·persistence-jpa·composition을 바꾸는 작업이라 하지 않음(P16-new-5) |
| S5-lead-4 | 완료 | `grpc/grpc-testkit/.../release/`(4 main + 1 test), `grpc-advanced/grpc-advanced-bootstrap/.../release/`(4 main + 1 test) 삭제, 문서 4곳 정정. `-p optional-platforms ci` PASS. build 파일은 건드리지 않음 |
| NEW-16 | 완료 | `strictTestLanes`에 `explicitOnly(reason)`(모든 집계에서 빠지고 집계가 돌 때 이유 출력) — `StrictTestLaneConventionTest.anExplicitOnlyLaneStaysOutOfEveryAggregate` FAIL→PASS. Redis topology는 `-Predis.topology.mode`가 없으면 explicit-only(`RedisTopologyLanePluginFunctionalTest.withoutADeclaredModeTheLaneStaysOutOfTheIntegrationAggregate`·`aDeclaredModePutsTheLaneInTheIntegrationAggregate` FAIL→PASS), AWS lane은 `OBJECT_STORAGE_AWS_QUALIFICATION_ENABLED=true`가 없으면 explicit-only, httpclient `disabledProxyFailsBeforeARequestCanBeSent`는 Docker userland proxy와 무관한 loopback 닫힌 포트 시나리오 `refusedConnectionFailsBeforeARequestCanBeSent`로 교체(P11-new-3도 해소). `./gradlew integrationCheck --continue` BUILD SUCCESSFUL(14m), 기존 실패 3종 없음, 빠진 lane 4개는 이유 출력 |
## 제거된 코드
| 대상 | 경로 | 마지막으로 존재한 커밋 | 이유 |
|---|---|---|---|
| build-tools included build 전체(`ca.jpa-evidence`, `ca.jpa-qualification`, `jpa/` 45파일, `junit/` 2파일과 테스트) | `src/build-tools/` | `016597ac` | 소유자 결정 4(JPA evidence manifest 폐기). `config/`는 build-logic으로 이동 |
-`./gradlew ci verifyDependencyLocks --continue --max-workers=2`: 1차 실패 = 새 테스트 4파일 Spotless(수정 `7fe5d754`) + `S3AsyncResponseBodyBridgeTest.oversizedSdkChunkFailsClosed` 1건(P16-new-4, 재실행 PASS). 2차 BUILD SUCCESSFUL(685 tasks).
-`./gradlew mainCheck --continue` BUILD SUCCESSFUL(새 main 단계 레인·MinIO 레인·publicPathSnapshotTest 실행 확인).
-`./gradlew integrationCheck --continue` BUILD SUCCESSFUL(14m). Redis topology 3개·AWS lane은 이유를 출력하고 빠짐, httpclient fault lane 2/2 PASS, sample `posterImageMigrationTest` 실행.
-`GIT_SHA=… ./gradlew releaseCheck` PASS, `./gradlew -p optional-platforms ci` PASS, `:app-bootstrap:verifyEnvKeys` PASS, `ci`/`mainCheck`/`integrationCheck`/`releaseCheck``--dry-run --configuration-cache --configuration-cache-problems=fail` 모두 저장 가능, `:app-bootstrap:architectureTest`(sample 포함) 180/180.
## 새로 발견한 결함
-`P16-new-1` — fileserver workflow가 P4 이동 전 위치를 가리킴: `fileserver-certification.yml``:app-bootstrap:test --tests '*FileserverDocumentationCoverageTest'`(지금 `composition:fileserver-platform`), `:application-core:test --tests '*FileserverObservabilityTest'`(지금 `application-fileserver`), full-verification이 `application-core`/`adapter:inbound:web` check, `fileserver-pr.yml``:adapter:inbound:web:test --tests '*FileserverHardeningContractTest'`(지금 `web-fileserver`)와 경로 필터, `fileserver-nightly.yml`의 `application-core` 두 호출. **고침**(release.yml·fileserver-pr.yml·fileserver-nightly.yml).
-`P16-new-4` — `S3AsyncResponseBodyBridgeTest.oversizedSdkChunkFailsClosed` 간헐 실패(`expected "S3 response chunk exceeds the bounded bridge size" but was "S3 consumer did not read the exact response range"`) — 소비 스레드와 chunk 크기 검사 순서 경합으로 보임. 재실행 PASS. 고치지 않음(objectstorage 소유).
-`P16-new-5` — S1-#16 나머지: `NotificationIdGeneratorPort`·`UploadIdentifierFactory`를 domain `IdFactory` 기반으로 정리하는 작업은 남음(여러 leaf 변경).
-`P16-new-6` — persistence-fileserver의 공개 타입을 다른 leaf가 import하는 것은 이제 어떤 adopter 검사도 보지 않음(예전 정규식 테스트는 `…outbound.persistence.` 접두어 전체를 봤음). persistence-fileserver에 `ca.api-surface`를 붙일지 결정 필요.
-`P16-new-7` — `docs/study/postgresql-jpa-walkthrough.ko.md` §15.6 등이 삭제된 JPA evidence manifest·`verifyJpa*Evidence`를 설명함(결정 6, Wave 5 문서 갱신 대상). 고치지 않음.
| 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-4c | Required | CI에서 커밋마다 jar manifest version이 바뀌어 test·SpotBugs cache가 항상 miss | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `JavaConventionsPlugin`에 runtime classpath `metaInf` 정규화(`Implementation-Version`·`Build-Revision` 무시), `src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java`. 재현: `GIT_SHA`만 바꿔 `:application-core:test` 두 번 실행 — 정규화 없이 재실행됨(FAIL, cache miss) → 정규화 후 `UP-TO-DATE`(PASS). 추가로 leaf version에서 revision을 뺐다(BUILD-O3-5) | - | 입력 선언이 끝났으므로(O-4a/b) `JavaConventionsPlugin`에 `normalization.runtimeClasspath.metaInf.ignoreAttribute("Implementation-Version")` 추가 |
| 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-중복-6 | 권고 | CI가 아키텍처 게이트를 여러 번 반복 실행 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `releaseCheck`에서`ci` 의존 제거(`src/build.gradle` releaseCheck = `verifyReleaseProvenance` + `verifyPublicPathSnapshot`), `fileserver-pr.yml`의 `:app-bootstrap:architectureTest --tests '*Fileserver*'` 삭제. `DeveloperExperienceContractTest.architectureWorkflowSelectorsUseTheArchitectureSourceSetTask`를 새 계약(PR `:ci`에서 한 번)으로 수정 | - | `releaseCheck`에서 `ci` 의존을 빼고 tag 전용 검사만 남긴다. fileserver-pr의 architectureTest 호출은 삭제한다 |
| BUILD-중복-7 | 권고 | 기능 전용 플러그인 5개가 root에 적용됨 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 루트 `id 'ca.jpa-qualification'` 삭제(`de075afe`). 루트에 남은 플러그인은 `ca.release-provenance`, `ca.architecture` | - | JPA evidence를 폐기할 때 root 적용도 제거(BUILD-O3-2) |
| BUILD-중복-8 | 권고 | ArchUnit이 모든 leaf를 보지 않음 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `src/app-bootstrap/build.gradle``architectureTestRuntimeOnly project(':sample-portfolio')` + optional-platforms는 Gradle 방향 게이트로 충분하다는 주석. sample을 넣자 `ForbiddenApiArchitectureTest.NO_UUID_RANDOM_IN_CONTROLLER` FAIL(`PublishPosterImageUseCase.handle`의 `UUID.randomUUID()`) → id 포트(`ids.allocate()`)로 고쳐 PASS(`:app-bootstrap:architectureTest` 180/180). app-bootstrap lockfile 재생성(+1줄) | - | 결정(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-계획-B2 | 권고 | release workflow를 1개로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `jpa-release.yml`·`fileserver-certification.yml`의 job을 `release.yml`로 옮기고 두 파일 삭제, `app-image-release`가 `jpa-release-promotion`·`jpa-registry-and-docs`·fileserver 4 job을 `needs`. `JpaReleaseRenderingTest`는 `release.yml`을 읽고, `FileserverDocumentationCoverageTest`는 `fileserver-*.yml` + `release.yml`의 job id를 읽음(둘 다 PASS) | - | jpa·fileserver의 tag job을 release.yml의 job으로 옮기고, 두 파일의 tag 트리거를 삭제 |
| BUILD-계획-B3 | 권고 | PR에서는 변경된 모듈만 실행 | 보류 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 구현한 부분: `object-storage-qualification.yml` PR 트리거에 경로 필터, MinIO 두 레인을 objectstorage `check`에서 `mainCheck`로(`src/adapter/outbound/objectstorage/build.gradle`). 남은 "PR `ci`를 변경 모듈만 실행"은 영향 모듈 계산 방식(Gradle 의존 그래프 역추적·경로 매핑)과 누락 위험 수용 범위를 정해야 하고 로컬에서 검증할 수 없음. 승인자: 저장소 소유자 결정 필요 | W3 | object-storage-qualification에 경로 필터를 달거나 PR 트리거 제거. MinIO 레인은 objectstorage `check`에서 떼어 main 단계로. `ci`의 변경 모듈 한정은 따로 설계 |
| BUILD-계획-C | 권고 | 컨테이너 이미지 서명 | 보류 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 서명 대상(GHCR push)과 keyless OIDC 토큰은 tag 실행에서만 있어 로컬 검증 불가. 이 workflow는 제3자 action 대신 체크섬 고정 바이너리를 설치하는 정책인데, 이 환경에서 cosign 릴리스 체크섬을 확인할 수 없어 확인하지 않은 체크섬·action SHA를 넣지 않음. 결정할 것: cosign 버전·설치 방식(체크섬 고정 vs `sigstore/cosign-installer` SHA 고정), image job에 `id-token: write` 부여. 승인자: 저장소 소유자 결정 필요 | 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-바로할것-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-바로할것-12d | 권고 | notification·jpa·mongo·api-surface 검사를 leaf `check`에서 `mainCheck`로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): api-surface 부분은 결정 20에 따라 PR `check`로(반대 방향 행을 결정 20으로 닫음). notification evidence·env registry·mongo lane contract는 B4-27·28·30의 main 단계 레인 | - | B4-27과 같은 방식 |
| BUILD-순수성-이름 | Nit | 순수성 task·클래스 이름이 아직 application-core만 가리킴 | 남음 | `ArchitecturePlugin.java:62``verifyApplicationCoreDependencyPurity`, `:177``VerifyApplicationCoreDependencyPurityTask`, `:181` 설명 "this application module" | W5 | `verifyPureModuleDependencies` 같은 이름으로 바꾸고 문서의 명령도 함께 수정 |
@@ -683,7 +683,7 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| X1-지도-Admission / in-flight | 권고 | 유지하되 gRPC check-then-increment는 `Semaphore`로 (= N-5) | 완료 | Wave 1–2 P5 (fcddab7e·Wave 2 커밋): N-5a와 같은 수정. `Semaphore` 대신 한 락: in-flight와 queued 두 카운터를 한 결정에서 함께 봐야 해서 semaphore 두 개로는 원자적으로 안 된다. `GrpcAdmissionController.java:52`, `GrpcAdmissionControllerTest` | - | 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-지도-readiness / evidence / API-surface / moduleboundary | 권고 | 카드 스키마·검증기·API-surface gate·moduleboundary 여러 벌 → 하나로 | 보류 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 완료: JPA readiness·evidence → persistence-jpa 테스트(manifest 폐기), API surface 구현 하나. 남은 "messaging 카드 검증은 messaging leaf로": `MessagingCapabilityRegistryContractTest`는 `config/messaging/*.yaml`을 snakeyaml로 읽는데 `adapter:outbound:messaging`은 모든 configuration(테스트 포함)에서 YAML·Jackson 2를 exclude+reject한다("Jackson 3 only and YAML-free"). 옮기려면 카드 파일을 JSON으로 바꾸거나 test 설정만 예외로 둘지 정해야 함. 승인자: 저장소 소유자 결정 필요 | 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-#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와 같은 작업) |
@@ -709,7 +709,7 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| 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) | 완료 | Wave 1–2 P3 (fcddab7e·Wave 2 커밋): B-5a·B-5b와 같은 결함. 같은 수정·테스트(`DispatchOutcomeRecorder.java:122,153`) | - | 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` 제거 표에 한 줄 |
| 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-#16 | Consider | 문서가 말하는 `application-core → domain-core` 의존이 빌드에 없음 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `src/application-core/build.gradle``implementation project(':domain-core')`복원(registry 허용 edge). `architectureCheck` PASS. 같은 행의 `NotificationIdGeneratorPort`·`UploadIdentifierFactory` → `IdFactory` 정리는 application-notification/fileserver·persistence-jpa·composition을 바꾸는 작업이라 하지 않음(P16-new-5) | - | `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` 재정의로, 가드는 하나로 |
@@ -933,7 +933,7 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| S5-lead-1 | 권고 | client 에러 문구 언어가 전송마다 다름(web 영어, graphql 한국어) (= X2-P2-1) | 완료 | Wave 3 W3-P15 (Wave 3 라운드 1 커밋): 결정 11: `ClientErrorMessages`(한국어, Category별) 하나를 web·fileserver·GraphQL·gRPC(status description) 모두 사용. gRPC `GrpcExceptionHandlingInterceptorTest.theStatusDescriptionIsTheSharedClientMessageOfTheCategory` FAIL(`expected: "요청한 리소스를 찾을 수 없습니다." but was: "ROUTE_NOT_FOUND"`)→PASS, `GrpcP1BoundaryWireTest` 기대값 갱신 PASS. STOMP `message` 헤더는 X2-P2-9b 지시대로 고정값 유지 | - | 결정(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가 한 전송은 통과하고 다른 전송은 거부됨<br>Wave 1–2 P8: 미완 — 이유: 공통 tenant 값 타입(shared-contract/application-core)을 만들고 web·graphql(그리고 messaging·persistence·notification의 tenant 타입)이 담게 하는 일은 계획서 Wave 3 3-D 「tenant 값 타입」 공통 작업이고 web은 P10 범위. 이번에는 증상만 막음: GraphQL `TenantContext` 검증을 web과 같은 문법 `[A-Za-z0-9][A-Za-z0-9_.-]{0,63}`으로 맞춰 "한 전송만 통과하는 tenant"를 없앰. `context/GraphQlRequestContextTest.aTenantTheWebTransportRefusesIsRefusedHereToo`(4건) FAIL(`Expecting actual not to be null`) → PASS. `.../context/TenantContext.java:38`. 커밋 `aa5f4d90` | 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-4 | 권고 | release/promotion gate가 websocket/grpc에도 반복되는지 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `grpc/grpc-testkit/.../release/`(4 main + 1 test), `grpc-advanced/grpc-advanced-bootstrap/.../release/`(4 main + 1 test) 삭제, 문서 4곳 정정. `-p optional-platforms ci` PASS. build 파일은 건드리지 않음 | - | 두 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줄 이하 | - | - |
**조사 메모**
@@ -1066,11 +1066,11 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| 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 관계형 자동 설정이 켜지고, 원인을 알기 어려운 오류로 기동에 실패한다. | 완료 | Wave 1–2 P4 (fcddab7e·Wave 2 커밋): `src/composition/fileserver-platform/build.gradle`에 `runtimeOnly project(':adapter:outbound:persistence-jpa')`, `src/config/architecture/modules.json` edge 추가, README 갱신(`src/composition/fileserver-platform/README.md` 저장소 줄, `src/README.md:270` 표). `architectureCheck`·`verifyDependencyLocks` 통과. JPA 줄 없이 fileserver만 고른 조립의 기동 테스트는 추가하지 않았다: 모든 테스트 classpath(app-bootstrap integrationTest 포함)에 persistence-jpa가 이미 있어 "없는 조립"을 만들 수 없다. 대신 조립 lane `:app-bootstrap:integrationTest`(fileserver PG 왕복 포함 4건) 통과 | - | 결정(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-13a | Consider | `verifyEnvKeys`는 bootstrap에 유지하기로 결정됐는데, 문서는 아직 "옮기지 않은 검사"라고 적고 있다. | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `CLAUDE.md`·`AGENTS.md`·`src/README.md`·build-logic README를 "verifyEnvKeys = app-bootstrap 유지(결정 4), 구현은 build-logic `ca.config-contract`, build-tools 삭제"로 수정 | - | 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 테스트로 옮기기로 결정됐다. 아직 코드에 남아 있다. | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): O3-2와 같음. 수정 방향과 다른 점: `readiness-cards.yaml`·`release-registry.json`은 지우지 않음 — 결정 4·X1 결정은 "leaf 테스트로 옮김"이고, `release-registry.json`은 persistence-jpa testFixtures `JpaReleaseManifest`·`JpaReleaseRenderingTest`·`jpaReleaseQualification`의 SSOT, 카드 파일은 `JpaReadinessRegistryTest`와 readiness 레인 `requires`의 입력. `MessagingCapabilityRegistryContractTest`는 JPA 카드를 읽지 않음(`config/messaging`만 읽음, 현황표 근거가 틀림) | - | 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-13d | Consider | API surface 검사가 `mainCheck`로 옮겨가서 PR에서 공개 타입 변경을 바로 잡지 못한다. | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `ApiSurfacePlugin`이 verify를 leaf `check`에 연결. `ApiSurfaceConventionTest.theLeafCheckRunsTheSurfaceVerification` FAIL→PASS, `./gradlew check --dry-run`에 graphql·notification·jpa·mongo `verify*ApiSurface` 포함 | - | 결정(2026-09-25): API surface 검사를 PR 단계(`check`)로 올림 |
| 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 | 아래 메모 참고. |
@@ -1161,7 +1161,7 @@ Wave 1–2 구현 묶음(`P1`–`P13`)이 작업 중 찾은 결함과 통합 검
| P13-new-1 | 발견 | included build lock은 build-logic·build-tools 자신의 configuration(compile/test)만 잠근다. main build가 plugin을 쓸 때의 settings·root buildscript classpath는 main build에서 따로 해석되고 잠기지 않는다. 증거: `./gradlew buildEnvironment`에서 `project :build-tool… | 보류 | 사유: 잠그면 Spring Boot plugin을 올릴 때마다 lock 갱신 필요, included build 자체는 잠갔다. 승인자: 저장소 소유자(2026-09-28, 결정 27) | - | - |
| P13-new-2 | 발견 | `local-redis` lane은 기동 로그 무음 검사(스크립트 3c)를 통과할 수 없다. lane 자신이 주는 `APP_REDIS_AUTHENTICATION_ANONYMOUS_ACCESS_ACCEPTED=true`와 advanced credential 미설정 때문에 `RedisSdkAutoConfiguration`이 기동 중 WARN 2줄(`Redis is running without credentials… | 남음 | 결과 파일 `docs/reviews/2026-09-25-review-followup-results/P13.md` | W4 | `local-redis` lane 설정 또는 smoke 무음 검사 기준 정리(NEW-1b와 함께) |
| NEW-15 | 발견 | gRPC proto 조직 이름이 템플릿 이름이 아니라 `hyeonworks`로 고정 — `GrpcProtoStyleManifest.caSkeleton()``organization`, 기본 proto 패키지 `hyeonworks.grpc.common.v1`, `GrpcCodegenManifest`, 테스트 38개 파일. 재사용 체크리스트에도 없음 | 완료 | Wave 3 W3-P17 (Wave 3 라운드 1 커밋): `e2397d2f`. `hyeonworks` → `caskeleton`: proto 디렉터리 `src/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/`, `package caskeleton.grpc.common.v1`, `java_package caskeleton.grpc.common.v1.generated`, Edition fixture, 테스트 문자열 전부(기계적 치환). `GrpcProtoStyleManifest`·`GrpcCodegenManifest`는 S7-#13으로 삭제돼 organization 필드 자체가 없다. `AGENTS.md` 「템플릿 재사용 체크리스트」 2번에 proto 조직 이름 한 줄. `src/grpc/**`·`src/grpc-advanced/**`에 `hyeonworks` 0건. 과거 리뷰·계획 문서(`docs/reviews/**`, `docs/*-superpowers-package/**`, 7월 계획)의 언급은 이력이라 두었다 | - | 결정 18(protobuf 플러그인 전환)과 함께 `caskeleton`으로 바꾸고 `AGENTS.md` 재사용 체크리스트에 한 줄 |
| NEW-16 | 발견 | `integrationCheck`가 로컬에서 통과할 수 없는 lane을 묶음 — Redis topology 3개는 `-Predis.topology.mode` 없이 fail-closed, AWS 보호 lane은 보호 자격 증명 env가 없으면 실패. 그래서 집계 태스크가 항상 실패 | 남음 | Wave 1·2 검증 로그: `redisTopologyTest was selected with redis.topology.mode='unset'`, `AwsS3QualificationPreconditionsTest` | W3 | 매개변수·자격 증명이 필요한 lane은 `integrationCheck`에서 빼고 전용 워크플로에서만(또는 입력이 있을 때만 포함) |
| NEW-16 | 발견 | `integrationCheck`가 로컬에서 통과할 수 없는 lane을 묶음 — Redis topology 3개는 `-Predis.topology.mode` 없이 fail-closed, AWS 보호 lane은 보호 자격 증명 env가 없으면 실패. 그래서 집계 태스크가 항상 실패 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `strictTestLanes`에 `explicitOnly(reason)`(모든 집계에서 빠지고 집계가 돌 때 이유 출력) — `StrictTestLaneConventionTest.anExplicitOnlyLaneStaysOutOfEveryAggregate` FAIL→PASS. Redis topology는 `-Predis.topology.mode`가 없으면 explicit-only(`RedisTopologyLanePluginFunctionalTest.withoutADeclaredModeTheLaneStaysOutOfTheIntegrationAggregate`·`aDeclaredModePutsTheLaneInTheIntegrationAggregate` FAIL→PASS), AWS lane은 `OBJECT_STORAGE_AWS_QUALIFICATION_ENABLED=true`가 없으면 explicit-only, httpclient `disabledProxyFailsBeforeARequestCanBeSent`는 Docker userland proxy와 무관한 loopback 닫힌 포트 시나리오 `refusedConnectionFailsBeforeARequestCanBeSent`로 교체(P11-new-3도 해소). `./gradlew integrationCheck --continue` BUILD SUCCESSFUL(14m), 기존 실패 3종 없음, 빠진 lane 4개는 이유 출력 | - | 매개변수·자격 증명이 필요한 lane은 `integrationCheck`에서 빼고 전용 워크플로에서만(또는 입력이 있을 때만 포함) |
| P14-new-1 | 발견 | operator force-delete(`application-fileserver/.../admin/DefaultFileserverAdminService.java:167`)가 P4-new-4와 같은 결함 — 진행 중 upload를 지우면 세션이 ACTIVE로 남고 staging 정리가 예약되지 않는다. | 남음 | Wave 2.5 P14 결과 파일 | W2 | lifecycle delete와 같은 `unfinishedUpload` 처리를 admin 경로에도(생성자에 `StagingUploadLocator`). 라운드 2 P24 |
| P14-new-2 | 발견 | `S3AsyncResponseBodyBridgeTest.deliversAnExactBoundedBodyOnTheWorkerAndInvalidatesTheSource`가 전체 `check` 부하에서 간헐 실패(`Expecting code to raise a throwable`), 단독 통과. | 남음 | Wave 2.5 P14 결과 파일 | W4 | 타이밍 의존 제거(결정적 executor/latch) |
| P14-new-3 | 발견 | main에 `ReconcilePosterImageUploadUseCase`를 부르는 worker가 없다(`claimPending` 호출자 0). 게시가 이긴 ABORT_AUTHORIZED intent는 reconcile 명령이 와야 붙는다. | 남음 | Wave 2.5 P14 결과 파일 | W3 | sample에 reconcile worker(PENDING·ABORT_AUTHORIZED 모두)를 두거나 수동 명령임을 문서화. 라운드 2 P25 |
@@ -1178,3 +1178,10 @@ Wave 1–2 구현 묶음(`P1`–`P13`)이 작업 중 찾은 결함과 통합 검
| P26-new-1 | 발견 | Dynamic Target 호출이 deadline 검사와 admission permit을 거치지 않았다(만료 deadline에도 hop 전송). | 완료 | Wave 3 P26: `CallSetup` 공유, 재현 테스트 FAIL→PASS | - | - |
| P26-new-2 | 발견 | prod의 schema 변경 `ddl-auto` 거부가 문서의 `PROFILE_MISMATCH`가 아니라 `IllegalStateException`이었다. | 완료 | Wave 3 P26: 검사 하나로 합치며 수정 | - | - |
| P16-new-1 | 발견 | fileserver workflow가 P4 이동 전 leaf의 테스트를 가리킴(`FileserverDocumentationCoverageTest` 등). | 완료 | Wave 3 P16: release.yml·fileserver-pr.yml·fileserver-nightly.yml | - | - |
| P16-new-2 | 발견 | `FileserverDocumentationCoverageTest`가 읽는 문서·workflow·소스가 test inputs에 없음. | 완료 | Wave 3 P16: `src/composition/fileserver-platform/build.gradle` | - | - |
| P16-new-3 | 발견 | sample `PublishPosterImageUseCase.handle`이 `UUID.randomUUID()`로 attempt id 생성(ArchUnit 밖이라 안 보였음). | 완료 | Wave 3 P16: `ids.allocate()`, sample을 ArchUnit 대상에 포함 | - | - |
| P16-new-4 | 발견 | `S3AsyncResponseBodyBridgeTest.oversizedSdkChunkFailsClosed` 간헐 실패(소비 스레드와 chunk 크기 검사 경합). | 남음 | Wave 3 P16 결과 파일 | W4 | P14-new-2와 함께 결정적 테스트로 |
| P16-new-5 | 발견 | S1-#16 나머지: `NotificationIdGeneratorPort`·`UploadIdentifierFactory`를 domain `IdFactory` 기반으로. | 남음 | Wave 3 P16 결과 파일 | W3 | 3-D(P19) |
| P16-new-6 | 발견 | persistence-fileserver 공개 타입의 adopter import를 보는 검사가 없어짐(예전 정규식 테스트가 접두어 전체를 봤음). | 남음 | Wave 3 P16 결과 파일 | W3 | persistence-fileserver에 `ca.api-surface` 적용 — 빌드 잔여 묶음 |
| P16-new-7 | 발견 | `docs/study/postgresql-jpa-walkthrough.ko.md` §15.6 등이 삭제된 JPA evidence manifest를 설명. | 남음 | Wave 3 P16 결과 파일 | W5 | 결정 6: 현재 코드 기준으로 갱신 |
- [x] 라운드 1: P14 · P15 · P16 · P17 → 통합·검증·커밋 (2026-09-28, `9fdb0af4`·`c4a066df`·라운드 1 마무리 커밋)
- [ ] 라운드 2: P18 · P24 · P25 · P26 → 통합·검증·커밋
- [ ] 라운드 3: P19 · P21 · P22 · P23 → 통합·검증·커밋
- [ ] 라운드 4: P20 → 통합 → Wave 종료 검증 → 현황표·「제거된 코드」 갱신 → 커밋 `review-followup Wave 3`
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.