review-followup Wave 3 라운드 1(P16): 빌드 게이트 정리 — JPA evidence manifest 폐기, build-tools 제거, API surface를 leaf check로

- 결정 4: JPA evidence·qualification manifest 폐기 → persistence-jpa 테스트, build-tools included build 비움(verifyEnvKeys는
  app-bootstrap 태스크, 구현은 build-logic `ca.config-contract`), gRPC release gate 삭제
- 결정 20: API surface 검사를 leaf `check`로, JPA adopter 검사를 `ca.api-surface`로 합침(구현 하나)
- 레인 단계 정리(문서 대조 레인은 `mainStage()`), integrationCheck가 입력 없는 레인을 이름과 함께 제외 → 로컬 통과(NEW-16)
- release workflow 통합, releaseCheck는 tag 전용, build-logic 비핵심 플러그인 정리, sample을 ArchUnit 대상에
- 보류 4행(B3 변경 모듈만 실행, C 이미지 서명, messaging 카드 검증 이동 2행 — 결정 필요), 남음 2행(O3-5 나머지)
- 통합: P17이 옮긴 gRPC release gate 사본 삭제, `grpc-proto-buf`를 release-gate needs에(P17-new-3)

검증: ./gradlew ci verifyDependencyLocks --warning-mode=fail 통과(685 task), mainCheck 통과(268 task),
-p optional-platforms ci 통과, -p build-logic test 78건 통과(손상된 TestKit 캐시 삭제 후)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
donghyeon-ka
2026-09-28 16:44:17 +09:00
co-authored by Claude Opus 5.5
parent 4fb7943b85
commit 0ed7bc8df7
166 changed files with 1666 additions and 6571 deletions
@@ -29,7 +29,9 @@ production unapproved — because the remedy differs in each case.
**Promotion evidence is per capability.** `GrpcAdvancedPromotionEvidence` is one record per
capability, so no promotion can drag another along;
`GrpcAdvancedPromotionGate.capabilitiesDraggedAlong` returns an empty list, and that is a tested
property rather than a claim. Two thresholds: seven days of soak plus complete evidence for
property rather than a claim. (2026-09-28: the gate classes were removed because nothing outside
their own tests called them — review 2026-09-24 S5-lead-4. The per-capability rule stands as a
review rule in `docs/runbooks/grpc-advanced-capabilities.md`.) Two thresholds: seven days of soak plus complete evidence for
`ADVANCED_STABLE`, thirty for a Stable default, because the second means every deployment gets the
capability's dependencies and its failure modes.
@@ -1,6 +1,8 @@
# Supported production adopter surface for the JPA persistence leaf.
# Language-level public implementation types are not compatibility promises.
# Adding an import outside this list requires an explicit review of the adopter contract.
# Checked by verifyJpaApiSurface (ca.api-surface adopterBaseline); every entry must be in
# jpa-api-surface.txt. persistence-fileserver types are that leaf's own surface, not listed here.
dev.caskeleton.adapter.outbound.persistence.api.capability.CapabilitySupport
dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability
dev.caskeleton.adapter.outbound.persistence.audit.AuditContextPort
@@ -8,7 +10,6 @@ dev.caskeleton.adapter.outbound.persistence.audit.AuditableEntity
dev.caskeleton.adapter.outbound.persistence.config.PersistenceJpaConfig
dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings
dev.caskeleton.adapter.outbound.persistence.failure.SqlStateErrorMapping
dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverSchemaActivation
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy
dev.caskeleton.adapter.outbound.persistence.migration.FlywaySchemaPolicy
dev.caskeleton.adapter.outbound.persistence.outbox.OutboxClaimRepository
+24
View File
@@ -378,3 +378,27 @@ web 경로의 `W/`는 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adap
| `JpaSchemaSafetyValidator`, `JpaSchemaSafetyValidatorTest` | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaSchemaSafetyValidator.java` | `93251e76` | S6-#3c. guard와 중복, guard보다 늦게 돌아 발동한 적 없음 |
| `isProdActive()` wrapper 4개 | `persistence-jpa/.../startup/{FlywayProdSafetyValidator,PersistenceVendorProdSafetyValidator,PostgreSqlTransportSecurityValidator}.java`, `app-bootstrap/.../runtime/SecretSourceValidator.java` | `93251e76` | S6-#3d. `RuntimeProfileSnapshot.isProduction()` 1줄 위임 |
| `DurableOperationJpaRepository`의 `JpaRepository` 상속(findAll/deleteAll 등) | `persistence-jpa/.../operation/DurableOperationJpaRepository.java` | `93251e76` | E-6b. tenant 범위 없는 bulk 메서드 노출 |
| 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으로 이동 |
| `jpa-r2-evidence.yml`, integration-main `jpa-candidate-evidence` job | `.github/workflows/` | `016597ac` | JPA evidence manifest 폐기 |
| `JpaAdopterApiSurfaceTest` | `src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/` | `016597ac` | `ca.api-surface` `adopterBaseline`으로 통합(BUILD-중복-3) |
| `GrpcStableReleaseGate`·`GrpcCompatibilityMatrix`·`GrpcReleaseDecision`·`GrpcReleaseEvidence`(+Test) | `src/grpc/grpc-testkit/src/{main,test}/java/dev/caskeleton/grpc/release/` | `016597ac` | 호출처가 자기 테스트뿐(S5-lead-4) |
| `GrpcAdvancedPromotionGate`·`…Decision`·`…Evidence`·`GrpcAdvancedSupportMatrix`(+Test) | `src/grpc-advanced/grpc-advanced-bootstrap/src/{main,test}/java/dev/caskeleton/grpc/advanced/release/` | `016597ac` | 같음 |
| `ca.public-path-snapshot`(publicpath 5파일 + renderer test) | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/publicpath/` | `016597ac` | app-bootstrap `PublicPathSnapshotTest`로(BUILD-O3-5) |
| `ca.archive-hygiene`(archive 5파일 + test) | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/archive/` | `016597ac` | leaf version에서 revision 제거로 stale jar가 생기지 않음 |
| `ca.developer-bootstrap`(`DeveloperBootstrapPlugin`, `BootstrapSmokeTask` + functional test) | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/bootstrap/` | `016597ac` | `scripts/bootstrap-local.sh`로 |
| `BuildVerificationPurityContractTest`(archive·public-path TestKit 10개) | `src/build-logic/src/test/java/dev/caskeleton/bootstrap/contract/` | `016597ac` | 대상 플러그인 삭제; public-path 케이스는 `PublicPathSnapshotTest`로 |
| `jpa-release.yml`, `fileserver-certification.yml` | `.github/workflows/` | `016597ac` | job을 `release.yml`로 이동(B2) |
| 삭제·이동한 검사 | 지금 도는 곳 | 게이트 |
| `verifyJpaReadinessRegistry`(카드 구조·선행·task 존재·migration stream) | persistence-jpa `JpaReadinessRegistryTest` | `ci`(leaf `test`) |
| `verifyJpaCandidateEvidence`/`verifyJpaPrimaryFoundationEvidence`(JUnit XML selector·no-skip) | readiness 레인 `requires`(카드 인용 scenario 전부) + `rejectSkipped` | `integrationCheck`, `release.yml` `jpa-release-gate` |
| `verifyJpaReleaseGateTasks`(gate task 존재) | `jpaReleaseQualification` dependsOn(없는 task면 그래프 생성 실패) + `JpaReleaseRenderingTest` | release, `ci` |
| `jpaReleaseQualification`(루트) | persistence-jpa 같은 이름 태스크 | `release.yml` `jpa-release-gate` |
| `JpaAdopterApiSurfaceTest` | `:adapter:outbound:persistence-jpa:verifyJpaApiSurface` adopter 검사 | `ci`(leaf `check`) |
| `verifyEnvKeys`(build-tools) | build-logic `ca.config-contract`, 태스크 동일 | `mainCheck`(`configContractCheck`) |
| `verifyPublicPathSnapshot`/`updatePublicPathSnapshot`(플러그인) | `:app-bootstrap:publicPathSnapshotTest`(루트 별칭 `verifyPublicPathSnapshot`) + 렌더링 단위 테스트 3개(`test`) | `mainCheck`, `releaseCheck`, `ci`(단위) |
| `verifyNoStaleTraceableJars` | 해당 없음 — leaf jar 이름에 revision이 없어 stale jar가 생기지 않음 | — |
| `GrpcStableReleaseGate`/`GrpcAdvancedPromotionGate` | 게이트에 연결된 적 없음(자기 테스트만). release `grpc-stable-release-gate` job은 그대로 | — |
| notification evidence·env registry·mongo lane 계약(`test`) | `notificationDocumentContractTest`·`notificationEnvironmentContractTest`·`mongoDocumentContractTest` | `mainCheck` |
| objectstorage MinIO 레인(`check`) | objectstorage `mainCheck` + `integrationCheck` + object-storage-qualification.yml(경로 필터) | `mainCheck` |
| `releaseCheck`의 `ci` | ci-quality-gates.yml `:ci`(PR·main push) | PR |
| fileserver-pr `architectureTest --tests '*Fileserver*'` | `:ci`의 `architectureCheck`(전체 ArchUnit) | PR |
+4 -3
View File
@@ -60,11 +60,12 @@ GitHub Actions 워크플로는 `kubectl apply`, `helm upgrade`, `argocd app sync
| Argo CD Application 정의 | **없음.** GitOps 저장소에 둘 예정 |
| CI에서의 클러스터 접근 | 없음 — 유일했던 `kubectl apply`는 제거됨 |
`fileserver-certification.yml`은 예외처럼 보이지만 아니다. PVC 매니페스트가 여전히 ReadWriteOnce를
`release.yml`의 fileserver certification 잡(`fileserver-pvc-certification` 등, 예전
`fileserver-certification.yml`)은 예외처럼 보이지만 아니다. PVC 매니페스트가 여전히 ReadWriteOnce를
선언하는지 **파일만** 확인하고, 클러스터에는 아무것도 적용하지 않는다. 실제 클러스터에서의 인증은
운영자가 `infra/fileserver/kubernetes/pvc-certification-job.yaml`을 직접 실행하고
`docs/fileserver/storage-certification.md`에 기록한다. 이름을 `fileserver-release.yml`에서 바꾼 이유가
이것이다 — 이 워크플로는 릴리스하지 않는다.
`docs/fileserver/storage-certification.md`에 기록한다. 잡 이름이 "release"가 아니라 "certification"인
이유가 이것이다 — 이 잡은 릴리스하지 않는다.
## 규칙
+4 -2
View File
@@ -4,8 +4,10 @@ What the Stable gRPC platform (`:grpc:*`) is certified against, what it is only
what is merely watched. The distinction is the point: "works with Spring Boot" is not a statement
anyone can act on.
`GrpcCompatibilityMatrix.caSkeleton()` is the machine-readable form of this table, and
`GrpcStableReleaseGate` blocks a release when a certified lane has no result or a failing one.
The release gate is the `grpc-stable-release-gate` job in `.github/workflows/release.yml`: each
certified lane is a strict test lane that fails when it runs nothing. The in-code
`GrpcCompatibilityMatrix`/`GrpcStableReleaseGate` pair was removed (review 2026-09-24 S5-lead-4):
no production or build code called it, so it gated nothing.
## Lanes
+3 -2
View File
@@ -79,7 +79,8 @@ existing name.
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". |
+5 -4
View File
@@ -12,9 +12,10 @@ evidence, and this document describes what the registry says.
Being a rendering used to be a claim rather than a mechanism: the tables below were still typed by
hand, so a major demoted in the registry stayed Stable here and kept its full release job.
`JpaReleaseRenderingTest` now compares the database table, the gate table and `jpa-release.yml`'s
matrix and promotion lists to the registry, and `verifyJpaReleaseGateTasks` resolves every gate's
task against the real Gradle task graph. Edit the registry; these tables follow, or the build fails.
`JpaReleaseRenderingTest` now compares the database table, the gate table and `release.yml`'s JPA
matrix and promotion lists to the registry, and the `jpaReleaseQualification` aggregate depends on
every blocking gate's task, so a gate naming a task that does not exist fails when the task graph is
built. Edit the registry; these tables follow, or the build fails.
Two renderings stayed outside that comparison until they were added to it. `jpa-nightly.yml` runs
its own matrix and nothing checked it, so a demotion corrected the release lane and left the nightly
@@ -38,7 +39,7 @@ Each major gets its **own release job**, because for a while it did not. The rel
`-Pjpa.matrix.versions=16,17,18` to a `JpaPlatformContractSupport.start()` that used
`selectedVersions().get(0)`, so the whole integration suite ran against PostgreSQL 16 and this table
recorded 17 and 18 as fully covered on the strength of a three-assertion smoke test. `start()` now
refuses a multi-version selection outright, `jpa-release.yml` fans out to one job per major, and a
refuses a multi-version selection outright, the `jpa-release-gate` job in `release.yml` fans out to one job per major, and a
promotion job requires all three majors' evidence to carry the same commit SHA — so a removed major
removes the release, not the evidence for it.
@@ -0,0 +1,90 @@
# W3-P16 — Wave 3 빌드 게이트
worktree `.claude/worktrees/agent-ac6714988540478ba`, 브랜치 `worktree-agent-ac6714988540478ba`.
커밋: `de075afe`(JPA evidence 폐기·build-tools 비움·gRPC gate 삭제), `6107ca80`(API surface → check, adopter 검사 통합),
`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-결론-4 | 완료 | 하위 행으로 추적: B2·B4-17·B4-27·B4-28·B4-30·중복-6 완료, B3의 "변경 모듈만 실행"과 C는 보류(각 행) |
| BUILD-중복-3 | 완료 | `ca.api-surface`에 `adopterBaseline`/`adopterSources` 추가(javac로 import 파싱, adopter 목록 ⊆ 공개 surface 확인): `ApiSurfacePlugin`, `VerifyApiSurfaceTask`, `ApiSurfacePolicy.verifyAdopters`, `JavaPublicTypes.imports`. `ApiSurfaceConventionTest.anAdopterImportOutsideTheAdopterBaselineFailsTheVerification`·`anAdopterImportTheAdopterBaselineListsPasses`·`anAdopterBaselineEntryTheSurfaceNoLongerHasFailsTheVerification` FAIL(fixture가 없는 `adopterBaseline` 속성을 씀)→PASS. `JpaAdopterApiSurfaceTest` 삭제, persistence-jpa `apiSurface { adopterBaseline … }` |
| BUILD-중복-6 | 완료 | `releaseCheck`에서 `ci` 의존 제거(`src/build.gradle` releaseCheck = `verifyReleaseProvenance` + `verifyPublicPathSnapshot`), `fileserver-pr.yml`의 `:app-bootstrap:architectureTest --tests '*Fileserver*'` 삭제. `DeveloperExperienceContractTest.architectureWorkflowSelectorsUseTheArchitectureSourceSetTask`를 새 계약(PR `:ci`에서 한 번)으로 수정 |
| BUILD-중복-7 | 완료 | 루트 `id 'ca.jpa-qualification'` 삭제(`de075afe`). 루트에 남은 플러그인은 `ca.release-provenance`, `ca.architecture` |
| 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-27 | 완료 | `NotificationEvidenceVerifierTest.repositorySupportMatrixClaimsNoMoreThanTheManifestProves`에 `@Tag("document-contract")`, 레인 `notificationDocumentContractTest`(`mainStage()`, `rejectSkipped`) → leaf `mainCheck`. fixture 케이스는 `test`에 남음. `test` inputs 선언 제거(레인은 항상 실행). `StrictTestLaneConventionTest.aMainStageLaneLeavesTheLeafTestTaskAndJoinsMainCheck` FAIL→PASS |
| BUILD-계획-B4-28 | 완료 | `NotificationEnvironmentRegistryTest`에 태그, 레인 `notificationEnvironmentContractTest`(`src/composition/notification-platform/build.gradle`) |
| 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-O3-6 | 완료 | `config` 패키지를 `dev.caskeleton.buildlogic.config`로 이동(테스트 2개 포함), `includeBuild('build-tools')`·Dockerfile `COPY build-tools/`·build-logic.yml step 삭제, `src/build-tools` 삭제. 태스크는 `:app-bootstrap:verifyEnvKeys` 그대로(PASS) |
| 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-13a | 완료 | `CLAUDE.md`·`AGENTS.md`·`src/README.md`·build-logic README를 "verifyEnvKeys = app-bootstrap 유지(결정 4), 구현은 build-logic `ca.config-contract`, build-tools 삭제"로 수정 |
| NEW-13b | 완료 | 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`만 읽음, 현황표 근거가 틀림) |
| NEW-13d | 완료 | `ApiSurfacePlugin`이 verify를 leaf `check`에 연결. `ApiSurfaceConventionTest.theLeafCheckRunsTheSurfaceVerification` FAIL→PASS, `./gradlew check --dry-run`에 graphql·notification·jpa·mongo `verify*ApiSurface` 포함 |
| NEW-13e | 완료 | `posterImageMigrationTest`에 `integration()`, 루트 `integrationCheck`에 `:sample-portfolio:integrationTestLaneCheck`, `verifyMessagingContracts`에 `:sample-portfolio:messagingSampleContractQualificationTest`, integration-main.yml 호출을 `:sample-portfolio:integrationTestLaneCheck`로 |
| 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으로 이동 |
| `jpa-r2-evidence.yml`, integration-main `jpa-candidate-evidence` job | `.github/workflows/` | `016597ac` | JPA evidence manifest 폐기 |
| `JpaAdopterApiSurfaceTest` | `src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/` | `016597ac` | `ca.api-surface` `adopterBaseline`으로 통합(BUILD-중복-3) |
| `GrpcStableReleaseGate`·`GrpcCompatibilityMatrix`·`GrpcReleaseDecision`·`GrpcReleaseEvidence`(+Test) | `src/grpc/grpc-testkit/src/{main,test}/java/dev/caskeleton/grpc/release/` | `016597ac` | 호출처가 자기 테스트뿐(S5-lead-4) |
| `GrpcAdvancedPromotionGate`·`…Decision`·`…Evidence`·`GrpcAdvancedSupportMatrix`(+Test) | `src/grpc-advanced/grpc-advanced-bootstrap/src/{main,test}/java/dev/caskeleton/grpc/advanced/release/` | `016597ac` | 같음 |
| `ca.public-path-snapshot`(publicpath 5파일 + renderer test) | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/publicpath/` | `016597ac` | app-bootstrap `PublicPathSnapshotTest`로(BUILD-O3-5) |
| `ca.archive-hygiene`(archive 5파일 + test) | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/archive/` | `016597ac` | leaf version에서 revision 제거로 stale jar가 생기지 않음 |
| `ca.developer-bootstrap`(`DeveloperBootstrapPlugin`, `BootstrapSmokeTask` + functional test) | `src/build-logic/src/main/java/dev/caskeleton/buildlogic/bootstrap/` | `016597ac` | `scripts/bootstrap-local.sh`로 |
| `BuildVerificationPurityContractTest`(archive·public-path TestKit 10개) | `src/build-logic/src/test/java/dev/caskeleton/bootstrap/contract/` | `016597ac` | 대상 플러그인 삭제; public-path 케이스는 `PublicPathSnapshotTest`로 |
| `jpa-release.yml`, `fileserver-certification.yml` | `.github/workflows/` | `016597ac` | job을 `release.yml`로 이동(B2) |
(마지막으로 존재한 커밋은 이 묶음의 기준 HEAD `016597ac`. `6d27356e`에도 모두 존재한다.)
### 게이트에서 빠진 검사가 없는지
| 삭제·이동한 검사 | 지금 도는 곳 | 게이트 |
|---|---|---|
| `verifyJpaReadinessRegistry`(카드 구조·선행·task 존재·migration stream) | persistence-jpa `JpaReadinessRegistryTest` | `ci`(leaf `test`) |
| `verifyJpaCandidateEvidence`/`verifyJpaPrimaryFoundationEvidence`(JUnit XML selector·no-skip) | readiness 레인 `requires`(카드 인용 scenario 전부) + `rejectSkipped` | `integrationCheck`, `release.yml` `jpa-release-gate` |
| `verifyJpaReleaseGateTasks`(gate task 존재) | `jpaReleaseQualification` dependsOn(없는 task면 그래프 생성 실패) + `JpaReleaseRenderingTest` | release, `ci` |
| `jpaReleaseQualification`(루트) | persistence-jpa 같은 이름 태스크 | `release.yml` `jpa-release-gate` |
| `JpaAdopterApiSurfaceTest` | `:adapter:outbound:persistence-jpa:verifyJpaApiSurface` adopter 검사 | `ci`(leaf `check`) |
| `verifyEnvKeys`(build-tools) | build-logic `ca.config-contract`, 태스크 동일 | `mainCheck`(`configContractCheck`) |
| `verifyPublicPathSnapshot`/`updatePublicPathSnapshot`(플러그인) | `:app-bootstrap:publicPathSnapshotTest`(루트 별칭 `verifyPublicPathSnapshot`) + 렌더링 단위 테스트 3개(`test`) | `mainCheck`, `releaseCheck`, `ci`(단위) |
| `verifyNoStaleTraceableJars` | 해당 없음 — leaf jar 이름에 revision이 없어 stale jar가 생기지 않음 | — |
| `GrpcStableReleaseGate`/`GrpcAdvancedPromotionGate` | 게이트에 연결된 적 없음(자기 테스트만). release `grpc-stable-release-gate` job은 그대로 | — |
| notification evidence·env registry·mongo lane 계약(`test`) | `notificationDocumentContractTest`·`notificationEnvironmentContractTest`·`mongoDocumentContractTest` | `mainCheck` |
| objectstorage MinIO 레인(`check`) | objectstorage `mainCheck` + `integrationCheck` + object-storage-qualification.yml(경로 필터) | `mainCheck` |
| `releaseCheck`의 `ci` | ci-quality-gates.yml `:ci`(PR·main push) | PR |
| fileserver-pr `architectureTest --tests '*Fileserver*'` | `:ci`의 `architectureCheck`(전체 ArchUnit) | PR |
### 실행한 검증
- `./gradlew -p build-logic test` PASS(78 tests, skip 0). build-tools는 삭제되어 없음.
- `./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-2` — `FileserverDocumentationCoverageTest`가 `docs/fileserver/`·`.github/workflows/`·web-fileserver 소스를 읽는데 `composition/fileserver-platform` `test` inputs에 선언이 없어 문서만 바꾸면 up-to-date로 건너뜀. **고침**(`src/composition/fileserver-platform/build.gradle`).
- `P16-new-3` — sample `PublishPosterImageUseCase.handle`이 `UUID.randomUUID()`로 멱등성 attempt id를 만듦(`NO_UUID_RANDOM_IN_CONTROLLER` 위반, sample이 ArchUnit 밖이라 안 보였음). **고침**(`ids.allocate()`).
- `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 문서 갱신 대상). 고치지 않음.
@@ -540,12 +540,12 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| 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-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")` 추가 |
| 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`에서 받아짐 | 완료 | Wave 1–2 P13 (fcddab7e·Wave 2 커밋): W1 `50cb2d9e`. `src/build-logic/build.gradle:9-12`, `src/build-tools/build.gradle:10-13`에 `dependencyLocking { lockAllConfigurations(); lockMode = STRICT }`. lockfile 커밋: `src/build-logic/gradle.lockfile`, `src/build-tools/gradle.lockfile`(+ `--write-locks`가 만든 `settings-gradle.lockfile` 2개, main build와 같은 형태). 재생성: `./gradlew -p build-logic dependencies --write-locks`(build-tools도 같음). 재현(FAIL): lockfile의 `spotless-plugin-gradle:8.6.0`을 `8.5.0`으로 바꾸고 `./gradlew -p build-logic compileJava` → `:compileJava FAILED ... Dependency version enforced by Dependency Locking`. 복원 후 `-p build-logic test` 80/80, `-p build-tools test` 35/35 통과. 범위 한계는 P13-new-1 참고. | - | `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`<br>BUILD-중복-1: `ca.runtime-membership` id·코드 grep 0건(`src/build-logic/build.gradle`), 삭제 표 `src/build-logic/README.md:41`. 컴파일러·방향 task·ArchUnit은 리뷰대로 유지<br>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`뿐)<br>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건<br>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/` 패키지를 함께 삭제<br>BUILD-중복-2: JPA evidence를 폐기할 때 `junit` 패키지(138+76줄)도 같이 삭제<br>BUILD-바로할것-6: BUILD-O3-2와 같이 삭제 |
| O-8 / BUILD-중복-2 / BUILD-바로할것-6 | Consider | "지정 테스트가 실행됐고 skip 없음" 검사 구현이 5개 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): build-tools `junit` 패키지(`JUnitEvidenceReader`)를 JPA evidence와 함께 삭제(`de075afe`). 남은 "지정 테스트 실행·skip 없음" 구현은 `StrictLaneExecutionTracker`(정본)와 `RedisTopologyExecutionTracker`(소유자 결정 4로 유지) 둘 | - | 소유자 결정대로 JPA evidence manifest(`ca.jpa-evidence`, `ca.jpa-qualification`)를 leaf 테스트로 옮길 때 `buildtools/junit/` 패키지를 함께 삭제<br>BUILD-중복-2: JPA evidence를 폐기할 때 `junit` 패키지(138+76줄)도 같이 삭제<br>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`<br>BUILD-계획-B6: quarantine grep 0건. jmh는 `me.champeau.jmh`로 3개 leaf에 적용, 수동 실행 전용(`src/build.gradle:11-12` "never part of a gate")<br>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 줄 삭제 |
@@ -570,42 +570,42 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| 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-결론-1 | 권고 | 빌드 코드가 목적에 비해 너무 큼(16,768줄 중 아키텍처 검사 13%) | 남음 | 현재 Java(main+test) build-logic 6,184 + build-tools 4,320 = 10,504줄. O3 목표는 3.5–4k줄<br>Wave 3 W3-P16: 미완 — 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 제거)가 필요 | W3 | BUILD-O3-2·5·6 진행으로 줄인다 |
| BUILD-결론-2 | 권고 | 기능별 증거 검사(E)가 46%로 가장 큰 덩어리 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 기능별 evidence 검사 중 JPA(`jpa/` 2,701+706줄, `junit/` 138+76줄) 삭제. 남은 E는 redis topology(소유자 결정 4로 유지) | - | 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 | 권고 | 09-16 단계 분리 계획이 절반만 이행됨(2단계 게이트가 PR에서 돎) | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 하위 행으로 추적: B2·B4-17·B4-27·B4-28·B4-30·중복-6 완료, B3의 "변경 모듈만 실행"과 C는 보류(각 행) | - | 해당 행 참고 |
| BUILD-중복-3 | 권고 | API surface 검사 구현이 3개 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `ca.api-surface`에 `adopterBaseline`/`adopterSources` 추가(javac로 import 파싱, adopter 목록 ⊆ 공개 surface 확인): `ApiSurfacePlugin`, `VerifyApiSurfaceTask`, `ApiSurfacePolicy.verifyAdopters`, `JavaPublicTypes.imports`. `ApiSurfaceConventionTest.anAdopterImportOutsideTheAdopterBaselineFailsTheVerification`·`anAdopterImportTheAdopterBaselineListsPasses`·`anAdopterBaselineEntryTheSurfaceNoLongerHasFailsTheVerification` FAIL(fixture가 없는 `adopterBaseline` 속성을 씀)→PASS. `JpaAdopterApiSurfaceTest` 삭제, persistence-jpa `apiSurface { adopterBaseline … }` | - | 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-중복-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-계획-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-17 | 권고 | API surface를 PR에서 main으로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 결정 20: API surface는 PR(`check`)에서 돈다(NEW-13d). notification-platform.yml PR job의 별도 `verifyNotificationApiSurface` step은 같은 job의 `:adapter:outbound:notification:check -x test`가 이미 돌리므로 삭제("PR에서 main으로" 방향은 결정 20에 따라 닫음) | - | 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-27 | 권고 | notification API surface·evidence를 PR에서 main으로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `NotificationEvidenceVerifierTest.repositorySupportMatrixClaimsNoMoreThanTheManifestProves`에 `@Tag("document-contract")`, 레인 `notificationDocumentContractTest`(`mainStage()`, `rejectSkipped`) → leaf `mainCheck`. fixture 케이스는 `test`에 남음. `test` inputs 선언 제거(레인은 항상 실행). `StrictTestLaneConventionTest.aMainStageLaneLeavesTheLeafTestTaskAndJoinsMainCheck` FAIL→PASS | - | 문서 대조 테스트에 태그를 달아 `test`에서 빼고, `strictTestLanes` 레인(rejectSkipped)으로 만들어 leaf `mainCheck`에 연결 |
| BUILD-계획-B4-28 | 권고 | notification-configuration을 PR에서 main으로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `NotificationEnvironmentRegistryTest`에 태그, 레인 `notificationEnvironmentContractTest`(`src/composition/notification-platform/build.gradle`) | - | B4-27과 같은 방식으로 main 레인에 둠 |
| BUILD-계획-B4-30 | 권고 | mongo-verification을 PR에서 main으로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `MongoTestLaneContractTest`에 태그, 레인 `mongoDocumentContractTest`(`src/adapter/outbound/persistence-mongo/build.gradle`). `mainCheck` 실행에서 세 레인 모두 실행 확인 | - | 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-계획-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-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-2 | 권고 | O3: JPA evidence manifest(`ca.jpa-evidence`, `ca.jpa-qualification`) 폐기, leaf 테스트로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 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` 삭제 | - | 두 플러그인과 `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-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`)<br>Wave 3 W3-P16: 미완 — 완료: 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 파일을 바꾸는 작업이라 동시 묶음과 충돌. 둘 다 다음 순차 작업으로 | 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를 비움 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `config` 패키지를 `dev.caskeleton.buildlogic.config`로 이동(테스트 2개 포함), `includeBuild('build-tools')`·Dockerfile `COPY build-tools/`·build-logic.yml step 삭제, `src/build-tools` 삭제. 태스크는 `:app-bootstrap:verifyEnvKeys` 그대로(PASS) | - | 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-바로할것-7 | 권고 | API surface 구현을 하나로 | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): BUILD-중복-3과 같음. adopter 목록 파일(`docs/architecture/jpa-adopter-api-surface.txt`)은 따로 두되 구현은 `ca.api-surface` 하나(surface 기준선은 렌더링이 재생성하므로 표시를 섞지 않음). persistence-fileserver 타입 `FileserverSchemaActivation` 항목은 JPA surface가 아니어서 제거 | - | 리뷰 권고대로 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 | - | - |
@@ -613,7 +613,7 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| 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-바로할것-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-바로할것-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` 같은 이름으로 바꾸고 문서의 명령도 함께 수정 |
@@ -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-#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와 같은 작업) |
@@ -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` 제거 표에 한 줄 |
| 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-#7a | Required | readiness 카드 스키마 3개·검증기 3개, family별 evidence plugin | 보류 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): 위 행과 같은 작업. JPA 검증기는 leaf 테스트로 옮김, messaging 검증기 이동은 같은 사유로 결정 필요. 승인자: 저장소 소유자 결정 필요 | 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` | - | - |
@@ -784,7 +784,7 @@ Wave 1–2 구현 중 나온 질문에 대해 받은 7건(2026-09-28):
| 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-#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` 재정의로, 가드는 하나로 |
| 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` 하나뿐 | - | - |
@@ -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-13e | Consider | 어떤 집계 태스크·CI에도 묶이지 않은 strict lane이 있다: `messagingSampleContractQualificationTest`, `posterImageMigrationTest`. | 완료 | Wave 3 W3-P16 (Wave 3 라운드 1 커밋): `posterImageMigrationTest`에 `integration()`, 루트 `integrationCheck`에 `:sample-portfolio:integrationTestLaneCheck`, `verifyMessagingContracts`에 `:sample-portfolio:messagingSampleContractQualificationTest`, integration-main.yml 호출을 `:sample-portfolio:integrationTestLaneCheck`로 | - | `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 | 아래 메모 참고. |
@@ -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: 검사 하나로 합치며 수정 | - | - |
| P26-new-3 | 발견 | cache-redis가 `secret://src/`(빈 이름)를 `SecretSourcePort.resolve("")`로 넘겼다. | 완료 | Wave 3 P26: `SecretReference.parse`가 거부 | - | - |
| 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: 현재 코드 기준으로 갱신 |
+5 -6
View File
@@ -84,12 +84,11 @@ rather than retrying a failure.
## Promoting a capability
`GrpcAdvancedPromotionGate.evaluate` names every missing item. Promotion to `ADVANCED_STABLE` needs
compatibility evidence, a security review, fault evidence, performance evidence, an ADR, a runbook, a
real-environment test and seven days of soak. A Stable default needs thirty.
Promotions are independent: promoting one capability changes no other's grade, and
`GrpcAdvancedSupportMatrix.apply` refuses a decision made against a different matrix state.
Promotion to `ADVANCED_STABLE` needs compatibility evidence, a security review, fault evidence,
performance evidence, an ADR, a runbook, a real-environment test and seven days of soak. A Stable
default needs thirty. Promotions are independent: promoting one capability changes no other's
grade. This is a review checklist; the in-code `GrpcAdvancedPromotionGate` that restated it was
removed (review 2026-09-24 S5-lead-4) because nothing but its own test called it.
Before citing a suite as evidence, check that it ran against the real infrastructure it needs (proxy,
container, control plane or toolchain). A suite that ran without it passed and established nothing.
+4 -4
View File
@@ -60,11 +60,11 @@ status: active
4. Change the marker to `ACTIVE` only after the compatible application revision is deployed and its
readiness check succeeds. Disabling or rolling back application code changes the marker to
`INSTALLED_INACTIVE`; it does not drop history or owned data.
5. Re-run the candidate evidence task before promoting:
5. Re-run the readiness lanes before promoting (every card's scenarios, no skips):
```bash
cd src
./gradlew :adapter:outbound:persistence-jpa:verifyJpaCandidateEvidence --console=plain
./gradlew :adapter:outbound:persistence-jpa:integrationTestLaneCheck --console=plain
```
6. Record the failed revision, stream/history table, root cause, recovery migration, elapsed time
@@ -92,5 +92,5 @@ result is unknown.
---
This runbook is forward-only. The reviewed migration artifact and the per-card evidence manifest
are the audit sources.
This runbook is forward-only. The reviewed migration artifact and the readiness lanes' JUnit
results from CI are the audit sources.
+1 -1
View File
@@ -2,5 +2,5 @@
# SSOT: ca-skeleton.security.public-paths default in app-bootstrap/src/main/resources/config/security.yml
# -> SecurityConfig permitAll(); anyRequest authenticated. An operator's own SECURITY_PUBLIC_PATHS
# overrides it at run time and is outside this snapshot.
# Update only after review with: ./gradlew updatePublicPathSnapshot -PapprovePublicPathChange
# Update only after review with: ./gradlew verifyPublicPathSnapshot -PapprovePublicPathChange
/v1/healthcheck
@@ -229,7 +229,7 @@ W1·W2 잔여 21행(Wave 2.5)은 P14로 1라운드에서 함께 처리한다. W1
| P23 | 3 | notification: SES → sesv2(결정 17), `persistence-notification` 추출, SRP | `S1-#4` `S1-#9` `S1-#10b` `S2-#1b` `S2-#6c` `S2-#8a` `S2-#13b` `S4-#3c` `S4-#4b` `S4-#9` `S4-#14b` `S4-#15` `S4-lead-3` `S4-lead-5` |
| P20 | 4 | 3-B 설정 prefix `app.*`(결정 16), strict 바인딩 | `X2-P1-3c` `S3-lead-2` `S3-lead-4` `S6-#14` `P11-new-1` |
- [ ] 라운드 1: P14 · P15 · P16 · P17 → 통합·검증·커밋
- [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`