From ab5982e955e57e3f3687d0a03b154b55cb53d66e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 12:21:03 +0900 Subject: [PATCH 1/8] =?UTF-8?q?refactor(repo)!:=20=EC=83=98=ED=94=8C=20?= =?UTF-8?q?=EB=AA=A8=EB=93=88=EA=B3=BC=20=EA=B7=B8=20=EC=B0=B8=EC=A1=B0?= =?UTF-8?q?=EB=A5=BC=20=EC=A7=80=EC=9A=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: src/sample-portfolio(311파일)와 src/Dockerfile.sample이 빌드 8곳, registry, PR job, spotbugs 제외, 매뉴얼·leaf 문서 수십 곳에 얽혀 있다. 매뉴얼과 생성 명령이 예시를 맡게 된 뒤로 샘플은 유지 비용만 남았고, 문서 일부는 이미 없는 태스크(sampleOffTest)와 ArchUnit 규칙을 가리킨다. 고른 방법: 소유자 결정(2026-11-07)대로 샘플을 폴더째 지우고 역할은 옮기지 않는다. 샘플을 가리키던 것도 같은 변경에서 지운다. - 빌드: registry 행, 루트 build.gradle의 샘플 태스크·의존·단계 (sampleWebContractCheck, :sample-portfolio:*, strict lane 단계), app-bootstrap architectureTestRuntimeOnly, spotbugs 제외 3곳 - CI: ci-quality-gates.yml의 sample-portfolio job과 release-gate 칸 - 테스트: SampleRuntimeDefaultsContractTest, Dockerfile.sample 비교 테스트, ArchUnit 규칙의 죽은 sample 패키지 제외. build-logic 테스트와 application-core 테스트의 가짜 이름은 example-app으로 바꾼다 - 문서: 매뉴얼 예시를 실제 코드(durable operation, identifier, ErrorCodeRegistryMappingTest)로 바꾸고, 템플릿에 예가 없는 기법 (유일 제약 → 같은 409)은 규칙과 확인 방법만 적는다. 결정 색인의 샘플 전용 행은 "샘플과 함께 사라짐"으로 표시한다 버린 대안: 설계서 권장안(OpenAPI 스냅숏·웹 계약을 옮긴 뒤 삭제)은 소유자가 고르지 않았다. 위험·한계: - 샘플 안에만 있던 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC 전파, 요청당 SQL 수 단언)가 함께 사라진다. 소유자가 남기라 하면 총괄이 따로 맡긴다. - APP_CACHE_REDIS_ENABLED는 샘플이 읽지 않는 키라(설계서 가정과 다름) 지우지 않고 src/README.md 문장만 고쳤다. 제거 기한 2026-11-30은 그대로. - docs/capability-status.md 「제거된 코드」 표와 docs/work/evidence.md의 샘플 경로는 이력이라 두었다. 검증(desktop, 트리 0525e14e, ~/t1-layout-logs/): - ./gradlew :ci --warning-mode=fail rc=0 (502 executed, 83 from cache) - :verifyStrictLaneStages --dry-run rc=0 - :app-bootstrap:documentContractTest rc=0 - -p build-logic check rc=0 - :verifyDependencyLocks rc=0 - python3 scripts/check-work-docs.py, 상대 링크 검사 rc=0 Refs: design-docs repo-structure/README.md 3.1, repo-structure/01-backend-layout.md 6.2 BREAKING CHANGE: src/sample-portfolio, src/Dockerfile.sample, 샘플 태스크와 job이 없어진다. 샘플을 고쳐 쓰던 파생 서비스는 병합 때 수정 대 삭제 충돌이 난다. docs/upgrade/2026-11-maturity-review.md B-49. --- .github/workflows/ci-quality-gates.yml | 17 - .github/workflows/integration-main.yml | 2 +- AGENTS.md | 13 +- CLAUDE.md | 2 +- README.md | 19 +- docs/capability-status.md | 4 +- docs/ci-cd/template-vs-consumer.md | 7 +- docs/fileserver/design-deviations.md | 5 +- docs/jpa/entity-mapping-guide.md | 4 +- docs/jpa/migration-guide.md | 7 +- docs/jpa/support-matrix.md | 4 +- docs/manual/02-new-feature.md | 2 +- docs/manual/03-placement.md | 35 +- docs/manual/04-persistence.md | 31 +- docs/manual/05-idempotency.md | 5 +- docs/manual/06-errors.md | 8 +- docs/manual/07-authorization.md | 4 +- docs/manual/08-testing.md | 2 +- docs/manual/09-outbox-events.md | 12 +- docs/manual/README.md | 10 +- docs/registries/env-keys.yaml | 4 +- docs/runbooks/outbox-dead-letter.md | 4 +- docs/upgrade/2026-11-maturity-review.md | 25 +- docs/web/advanced-capabilities.md | 2 +- docs/web/repository-adaptation.md | 5 +- docs/work/delegate.md | 2 +- docs/work/new-feature.md | 6 +- docs/work/reference/decisions.md | 11 +- docs/work/reference/defect-patterns.md | 10 +- docs/work/reference/gates.md | 5 +- docs/work/reference/review-criteria.md | 10 +- .../Uuid__Feature__IdFactory.java.tmpl | 2 +- src/Dockerfile.sample | 159 ---- src/README.md | 13 +- src/adapter/inbound/graphql/CLAUDE.md | 4 +- src/adapter/inbound/graphql/README.md | 8 +- src/adapter/inbound/grpc/CLAUDE.md | 2 +- .../inbound/grpc/ApiErrorException.java | 2 +- src/adapter/inbound/web-advanced/CLAUDE.md | 4 +- src/adapter/inbound/web-advanced/README.md | 2 +- src/adapter/inbound/web/CLAUDE.md | 12 +- src/adapter/inbound/web/README.md | 23 +- .../WebSecurityAutoConfiguration.java | 14 +- src/adapter/inbound/websocket/CLAUDE.md | 2 +- src/adapter/outbound/fileserver/CLAUDE.md | 2 +- src/adapter/outbound/identifier/CLAUDE.md | 5 +- src/adapter/outbound/identifier/README.md | 4 +- src/adapter/outbound/identifier/build.gradle | 2 +- .../UuidV7DurableOperationIdFactory.java | 6 +- src/adapter/outbound/messaging/README.md | 2 +- .../outbound/notification/build.gradle | 2 +- .../platform/dispatch/UuidV7Generator.java | 4 +- src/adapter/outbound/objectstorage/CLAUDE.md | 3 +- .../outbound/persistence-jpa/CLAUDE.md | 6 +- .../outbound/persistence-jpa/README.md | 11 +- .../config/PersistenceJpaConfig.java | 2 +- .../outbox/jpa/JpaOutboxStore.java | 2 +- .../startup/JpaStartupAutoConfiguration.java | 2 +- .../CandidateAdapterCompositionTest.java | 11 +- .../outbound/persistence-mongo/CLAUDE.md | 5 +- src/app-bootstrap/CLAUDE.md | 8 +- src/app-bootstrap/README.md | 6 +- src/app-bootstrap/build.gradle | 12 +- .../RuntimeProfileAccessArchitectureTest.java | 2 +- .../src/main/resources/config/security.yml | 3 +- .../DeveloperExperienceContractTest.java | 24 - .../SampleRuntimeDefaultsContractTest.java | 214 ----- src/application-core/CLAUDE.md | 9 +- src/application-core/README.md | 7 +- ...egrationEventContractContributionTest.java | 6 +- .../buildlogic/ModuleRegistryTest.java | 14 +- ...ectureResolvedClasspathFunctionalTest.java | 16 +- ...NoIgnoredSourcePackagesFunctionalTest.java | 8 +- .../WorkflowGradleInvocationsTest.java | 4 +- src/build.gradle | 41 +- src/composition/idempotency/README.md | 4 +- src/composition/idempotency/build.gradle | 2 +- src/composition/service-runtime/README.md | 11 +- src/composition/service-runtime/build.gradle | 4 - src/config/architecture/modules.json | 18 - src/config/spotbugs/exclude-test.xml | 9 - src/config/spotbugs/exclude.xml | 25 +- src/domain-core/README.md | 13 +- src/gradle/libs.versions.toml | 4 +- src/sample-portfolio/.jqwik-database | Bin 4 -> 0 bytes src/sample-portfolio/CLAUDE.md | 72 -- src/sample-portfolio/README.md | 571 ------------- src/sample-portfolio/build.gradle | 255 ------ src/sample-portfolio/gradle.lockfile | 351 -------- ...UploadIntentRepositoryIntegrationTest.java | 150 ---- .../PosterRepositoryAdapterContractTest.java | 71 -- ...osterRepositoryAdapterIntegrationTest.java | 309 -------- .../WorkLogRepositoryAdapterContractTest.java | 78 -- ...rkLogRepositoryAdapterIntegrationTest.java | 122 --- ...reatePosterConcurrencyIntegrationTest.java | 187 ----- ...ampleIdempotencyReplayIntegrationTest.java | 122 --- .../SampleMigrationStreamIsolationTest.java | 89 --- ...eIdempotencyRotationQualificationTest.java | 55 -- ...osterImageRetirementQualificationTest.java | 134 ---- ...sterImageV8MigrationQualificationTest.java | 236 ------ ...TitleUniqueMigrationQualificationTest.java | 113 --- .../portfolio/SamplePortfolioApplication.java | 40 - .../web/controller/OperationsController.java | 44 -- .../web/controller/PosterController.java | 151 ---- .../PosterImagePublicationController.java | 109 --- .../web/controller/WebRequestParams.java | 91 --- .../web/controller/WorkLogController.java | 243 ------ .../web/dto/request/CreatePosterRequest.java | 11 - .../web/dto/request/CreateWorkLogRequest.java | 32 - .../dto/request/SamplePolymorphicRequest.java | 23 - .../web/dto/request/UpdatePosterRequest.java | 27 - .../web/dto/request/UpdateWorkLogRequest.java | 40 - .../dto/request/WorkLogValidationGroups.java | 10 - .../PosterImagePublicationResponse.java | 4 - .../PosterImagePublicationStatusResponse.java | 10 - .../web/dto/response/PosterResponse.java | 11 - .../web/dto/response/RepoStatsResponse.java | 3 - .../web/dto/response/WorkLogResponse.java | 19 - .../dto/response/WorkLogSummaryResponse.java | 14 - .../web/error/DomainExceptionHandler.java | 91 --- .../inbound/web/error/PortfolioErrorCode.java | 51 -- .../inbound/web/json/PosterIdSerializer.java | 23 - .../inbound/web/json/WorkLogIdSerializer.java | 23 - .../PosterImagePublicationWebMapper.java | 33 - .../inbound/web/mapper/PosterWebMapper.java | 35 - .../inbound/web/mapper/WorkLogWebMapper.java | 91 --- .../MultipartObjectContentProducer.java | 63 -- .../inbound/web/operation/Operation.java | 40 - .../web/operation/OperationStatus.java | 16 - .../SampleOperationNotFoundException.java | 23 - .../web/operation/SampleOperationStore.java | 35 - .../web/operation/WorkLogExportResult.java | 7 - ...acPosterImageIdempotencyScopeDigester.java | 120 --- .../identifier/UuidOutboxEventIdFactory.java | 19 - .../identifier/UuidPosterIdFactory.java | 21 - .../UuidPosterImageOperationIdFactory.java | 18 - .../identifier/UuidWorkLogIdFactory.java | 21 - .../persistence/config/JpaConfig.java | 17 - .../persistence/entity/PosterEntity.java | 86 -- .../PosterImageIdempotencyKeyEpochEntity.java | 58 -- .../PosterImageRetirementIntentEntity.java | 198 ----- .../entity/PosterImageUploadIntentEntity.java | 311 -------- .../persistence/entity/WorkLogEntity.java | 208 ----- ...mageRetirementIntentPersistenceMapper.java | 54 -- ...terImageUploadIntentPersistenceMapper.java | 110 --- .../mapper/PosterPersistenceMapper.java | 44 -- .../mapper/WorkLogPersistenceMapper.java | 77 -- .../PosterImageAttachmentCasRepository.java | 76 -- ...ImageIdempotencyKeyEpochJpaRepository.java | 20 - ...eIdempotencyKeyEpochRepositoryAdapter.java | 48 -- ...terImageRetirementIntentJpaRepository.java | 40 - ...mageRetirementIntentRepositoryAdapter.java | 95 --- .../PosterImageUploadIntentJpaRepository.java | 41 - ...terImageUploadIntentRepositoryAdapter.java | 119 --- .../repository/PosterJpaRepository.java | 16 - .../repository/PosterRepositoryAdapter.java | 130 --- .../repository/WorkLogJpaRepository.java | 37 - .../repository/WorkLogRepositoryAdapter.java | 88 --- .../WorkLogSummaryQueryAdapter.java | 72 -- .../repository/WorkLogSummaryRow.java | 20 - .../repostats/RawRepoStatsResponse.java | 4 - .../repostats/RepoStatsAclMapper.java | 21 - .../repostats/RepoStatsPortClient.java | 33 - .../event/OutboxEventIdFactory.java | 17 - .../event/PortfolioEventContract.java | 80 -- .../event/PortfolioEventOutbox.java | 90 --- .../poster/ArchivePosterCommand.java | 12 - .../poster/ArchivePosterUseCase.java | 49 -- .../poster/CreatePosterCommand.java | 15 - .../poster/CreatePosterUseCase.java | 63 -- .../poster/DeletePosterCommand.java | 12 - .../poster/DeletePosterUseCase.java | 83 -- .../application/poster/GetPosterQuery.java | 12 - .../application/poster/GetPosterUseCase.java | 31 - .../application/poster/ListPostersQuery.java | 14 - .../poster/ListPostersUseCase.java | 31 - .../poster/PosterCreatedPayload.java | 11 - .../poster/PosterEventContracts.java | 45 -- .../poster/PosterEventPublisher.java | 51 -- .../application/poster/PosterIdPayload.java | 12 - .../poster/PosterNotFoundException.java | 13 - .../poster/PublishPosterCommand.java | 12 - .../poster/PublishPosterUseCase.java | 50 -- .../poster/UpdatePosterCommand.java | 21 - .../poster/UpdatePosterUseCase.java | 58 -- .../AbortPosterImageUploadCommand.java | 21 - .../AbortPosterImageUploadUseCase.java | 119 --- .../GetPosterImagePublicationStatusQuery.java | 15 - ...etPosterImagePublicationStatusUseCase.java | 53 -- .../PosterImageAlreadyPublishedException.java | 14 - ...osterImageAttachmentCompareAndSetPort.java | 21 - .../PosterImageAttachmentPrepared.java | 13 - .../PosterImageAttachmentPreparedPayload.java | 16 - .../PosterImageAttachmentReadyPayload.java | 18 - .../PosterImageAttachmentReadyV2.java | 15 - .../PosterImageEventContracts.java | 31 - .../PosterImageIdempotencyKeyEpochPort.java | 9 - .../PosterImageIdempotencyScopeDigest.java | 28 - ...sterImageIdempotencyScopeDigesterPort.java | 16 - .../PosterImageOperationIdFactory.java | 19 - .../PosterImagePublicationEventPublisher.java | 51 -- .../PosterImagePublicationFingerprint.java | 44 -- .../PosterImagePublicationParameters.java | 36 - .../PosterImagePublicationPolicy.java | 34 - .../PosterImagePublicationReservation.java | 14 - ...osterImagePublicationReservationCodec.java | 28 - .../PosterImagePublicationStatus.java | 38 - .../PosterImageRetirementIntent.java | 213 ----- .../PosterImageRetirementIntentState.java | 14 - .../PosterImageRetirementIntentStorePort.java | 20 - .../PosterImageRetirementResult.java | 25 - ...ageSanitizedIdempotencyContextFactory.java | 58 -- .../posterimage/PosterImageUploadIntent.java | 348 -------- .../PosterImageUploadIntentClaim.java | 14 - ...terImageUploadIntentConflictException.java | 11 - .../PosterImageUploadIntentState.java | 16 - .../PosterImageUploadIntentStorePort.java | 31 - .../PublishPosterImageCommand.java | 39 - .../PublishPosterImageUseCase.java | 254 ------ ...ReconcilePosterImageRetirementCommand.java | 31 - ...ReconcilePosterImageRetirementUseCase.java | 112 --- .../ReconcilePosterImageUploadCommand.java | 21 - .../ReconcilePosterImageUploadUseCase.java | 227 ------ .../posterimage/RetirePosterImageCommand.java | 24 - .../posterimage/RetirePosterImageUseCase.java | 84 -- .../worklog/BatchCreateWorkLogsCommand.java | 15 - .../worklog/BatchCreateWorkLogsUseCase.java | 64 -- .../worklog/CreateWorkLogCommand.java | 31 - .../worklog/CreateWorkLogUseCase.java | 85 -- .../worklog/DeleteWorkLogCommand.java | 13 - .../worklog/DeleteWorkLogUseCase.java | 40 - .../worklog/GetRepoStatsQuery.java | 12 - .../worklog/GetRepoStatsUseCase.java | 27 - .../application/worklog/GetWorkLogQuery.java | 13 - .../worklog/GetWorkLogUseCase.java | 31 - .../ListRecentWorkLogSummariesQuery.java | 11 - .../ListRecentWorkLogSummariesUseCase.java | 36 - .../worklog/ListWorkLogsQuery.java | 13 - .../worklog/ListWorkLogsUseCase.java | 33 - .../application/worklog/RepoStatsPort.java | 8 - .../worklog/UpdateWorkLogCommand.java | 42 - .../worklog/UpdateWorkLogUseCase.java | 90 --- .../worklog/WorkLogNotFoundException.java | 12 - .../worklog/WorkLogNotOwnedException.java | 17 - .../WorkLogReservedContractContribution.java | 69 -- .../worklog/WorkLogReservedPayload.java | 20 - .../application/worklog/WorkLogSummary.java | 20 - .../worklog/WorkLogSummaryPage.java | 14 - .../worklog/WorkLogSummaryQueryPort.java | 29 - .../WorkLogVersionMismatchException.java | 13 - .../SampleApplicationUseCaseConfig.java | 213 ----- .../SampleManagementSecurityConfig.java | 39 - .../objectstorage/PosterImageApiConfig.java | 9 - .../objectstorage/PosterImageApiSettings.java | 17 - .../PosterImageIdempotencyConfig.java | 110 --- ...PosterImageIdempotencyKeyRingSettings.java | 20 - .../PosterImageObjectStorageConfig.java | 158 ---- .../PosterImagePublicationSettings.java | 36 - .../PosterImageRetirementConfig.java | 23 - .../PosterImageRetirementJob.java | 42 - .../PosterImageRetirementSettings.java | 49 -- .../SamplePostgreSqlPersistenceConfig.java | 53 -- .../runtime/SampleSchedulingConfig.java | 24 - .../security/SampleDemoAccounts.java | 53 -- .../SampleDemoAccountsProductionGuard.java | 72 -- .../security/SampleDemoSecurityConfig.java | 95 --- .../portfolio/domain/poster/Poster.java | 155 ---- .../domain/poster/PosterArchived.java | 13 - .../domain/poster/PosterCreated.java | 18 - .../domain/poster/PosterDeleted.java | 13 - .../portfolio/domain/poster/PosterId.java | 29 - .../domain/poster/PosterIdFactory.java | 9 - .../domain/poster/PosterImageAttachment.java | 7 - .../domain/poster/PosterImageReference.java | 37 - .../poster/PosterInvariantException.java | 29 - .../portfolio/domain/poster/PosterPage.java | 15 - .../domain/poster/PosterPublished.java | 13 - .../domain/poster/PosterRepository.java | 41 - .../domain/poster/PosterSortField.java | 10 - .../portfolio/domain/poster/PosterStatus.java | 24 - .../PosterTitleAlreadyExistsException.java | 20 - .../PublishedPosterImageAttachment.java | 17 - .../portfolio/domain/worklog/Period.java | 21 - .../portfolio/domain/worklog/RepoStats.java | 4 - .../domain/worklog/WorkCategory.java | 9 - .../portfolio/domain/worklog/WorkLog.java | 248 ------ .../portfolio/domain/worklog/WorkLogId.java | 29 - .../domain/worklog/WorkLogIdFactory.java | 9 - .../worklog/WorkLogInvariantException.java | 29 - .../domain/worklog/WorkLogOwner.java | 16 - .../domain/worklog/WorkLogRepository.java | 25 - .../domain/worklog/WorkLogReserved.java | 20 - .../domain/worklog/WorkLogSortField.java | 12 - .../domain/worklog/WorkLogStatus.java | 7 - .../sample/portfolio/package-info.java | 2 - .../src/main/resources/application.yml | 234 ------ .../portfolio.worklog.reserved/v1.schema.json | 18 - .../v1.schema.sha256 | 1 - .../messaging/poster.archived/v1.schema.json | 18 - .../messaging/poster.created/v1.schema.json | 23 - .../messaging/poster.deleted/v1.schema.json | 18 - .../v1.schema.json | 33 - .../v2.schema.json | 38 - .../messaging/poster.published/v1.schema.json | 18 - .../db/sample-migration/V2__work_log.sql | 65 -- .../db/sample-migration/V7__poster.sql | 31 - .../V8_1__poster_title_unique.sql | 43 - .../V8__poster_image_publication.sql | 128 --- .../SampleApplicationContextTest.java | 96 --- .../inbound/web/SampleApiDocsSystemTest.java | 57 -- .../persistence/InsertRoundTripCounter.java | 119 --- .../RecordingStatementInspector.java | 36 - .../WorkLogStatementCostSystemTest.java | 200 ----- .../SampleDemoProfilesStartupSystemTest.java | 65 -- .../SampleWorkLogAuthorizationSystemTest.java | 247 ------ .../systemTest/resources/application-test.yml | 189 ----- .../OperationsControllerWireTest.java | 98 --- .../controller/PosterControllerWireTest.java | 344 -------- ...terImagePublicationControllerWireTest.java | 163 ---- .../web/controller/WebRequestParamsTest.java | 51 -- .../controller/WorkLogControllerWireTest.java | 747 ------------------ ...PolymorphicTypeValidatorAllowlistTest.java | 149 ---- .../request/SamplePolymorphicRequestTest.java | 93 --- .../web/dto/response/BulkEnvelopeTest.java | 86 -- .../web/error/DomainExceptionHandlerTest.java | 158 ---- ...PortfolioErrorCodeRegistryMappingTest.java | 103 --- .../web/error/PortfolioErrorCodeTest.java | 19 - .../VirtualThreadMdcPropagationTest.java | 92 --- .../web/json/WorkLogIdSerializerTest.java | 23 - .../MultipartObjectContentProducerTest.java | 109 --- .../inbound/web/operation/OperationTest.java | 47 -- .../web/versioning/VersioningPrefixTest.java | 66 -- ...sterImageIdempotencyScopeDigesterTest.java | 91 --- .../identifier/UuidWorkLogIdFactoryTest.java | 48 -- .../persistence/entity/WorkLogEntityTest.java | 47 -- .../mapper/WorkLogPersistenceMapperTest.java | 66 -- .../WorkLogRepositoryAdapterTest.java | 197 ----- .../WorkLogSummaryQueryAdapterTest.java | 133 ---- .../repostats/RepoStatsAclMapperTest.java | 64 -- .../CommandSelfValidationTest.java | 95 --- .../event/PortfolioEventContractsTest.java | 58 -- .../event/PortfolioEventOutboxTest.java | 129 --- .../event/SamplePayloadSchemaReleaseTest.java | 18 - .../DeletePosterImageRetirementTest.java | 108 --- .../poster/PosterEventPublisherTest.java | 83 -- .../PosterImageAbortReconcileRaceTest.java | 315 -------- ...terImagePublicationEventPublisherTest.java | 16 - .../PosterImagePublicationWorkflowTest.java | 307 ------- .../PosterImageRetirementCrashMatrixTest.java | 188 ----- ...anitizedIdempotencyContextFactoryTest.java | 38 - .../worklog/CreateWorkLogOutboxTest.java | 121 --- .../worklog/GetRepoStatsUseCaseTest.java | 37 - ...ListRecentWorkLogSummariesUseCaseTest.java | 85 -- ...LogReservedConsumerDedupeContractTest.java | 107 --- ...rkLogReservedContractContributionTest.java | 309 -------- .../worklog/WorkLogUseCasesTest.java | 391 --------- .../architecture/SampleArchitectureTest.java | 98 --- .../WorkLogAuthorizationContractTest.java | 267 ------- .../authz/WorkLogAuthorizationE2ETest.java | 196 ----- .../SampleActuatorLoggersAccessTest.java | 31 - .../PosterImageIdempotencyConfigTest.java | 84 -- .../PosterImageRetirementConfigTest.java | 64 -- .../SampleMigrationLockWaitTest.java | 51 -- ...SamplePostgreSqlPersistenceConfigTest.java | 35 - .../SampleSchemaOwnershipDefaultsTest.java | 36 - ...SampleDemoAccountsProductionGuardTest.java | 95 --- .../SampleDemoSecurityConfigTest.java | 201 ----- .../portfolio/domain/poster/PosterIdTest.java | 31 - .../poster/PosterImageReferenceTest.java | 25 - .../portfolio/domain/poster/PosterTest.java | 142 ---- .../InMemoryPosterRepositoryContractTest.java | 19 - .../portfolio/domain/worklog/PeriodTest.java | 47 -- .../domain/worklog/WorkLogIdPropertyTest.java | 79 -- .../domain/worklog/WorkLogIdTest.java | 40 - .../domain/worklog/WorkLogInvariantTest.java | 77 -- .../portfolio/domain/worklog/WorkLogTest.java | 153 ---- ...InMemoryWorkLogRepositoryContractTest.java | 27 - .../fixtures/SamplePortfolioFixture.java | 18 - .../v1.invalid-unknown-field.json | 1 - .../portfolio.worklog.reserved/v1.valid.json | 1 - .../contracts/released-payload-schemas.sha256 | 10 - .../SamplePortfolioTestApplication.java | 18 - ...emoryPosterImageRetirementIntentStore.java | 98 --- .../InMemoryPosterImageUploadIntentStore.java | 77 -- .../testkit/InMemoryWorkLogSummaryQuery.java | 72 -- .../testkit/InMemoryPosterRepository.java | 114 --- .../testkit/PosterRepositoryContract.java | 119 --- .../testkit/InMemoryWorkLogRepository.java | 75 -- .../testkit/WorkLogRepositoryContract.java | 333 -------- .../testinfra/PostgreSqlTestContainer.java | 18 - .../contract/OpenApiDriftContractTest.java | 185 ----- .../web/date/DateHeaderContractTest.java | 90 --- .../web/filter/VirtualThreadMdcE2ETest.java | 197 ----- .../web/openapi/OpenApiSnapshotTest.java | 116 --- .../openapi/worklogs-openapi-snapshot.json | 507 ------------ src/shared-contract/README.md | 4 +- 396 files changed, 262 insertions(+), 23901 deletions(-) delete mode 100644 src/Dockerfile.sample delete mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java delete mode 100644 src/sample-portfolio/.jqwik-database delete mode 100644 src/sample-portfolio/CLAUDE.md delete mode 100644 src/sample-portfolio/README.md delete mode 100644 src/sample-portfolio/build.gradle delete mode 100644 src/sample-portfolio/gradle.lockfile delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterContractTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterContractTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterConcurrencyIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/idempotency/SampleIdempotencyReplayIntegrationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationStreamIsolationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java delete mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterTitleUniqueMigrationQualificationTest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/OperationsController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterImagePublicationController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WebRequestParams.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogController.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/CreatePosterRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/CreateWorkLogRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/SamplePolymorphicRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/UpdatePosterRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/UpdateWorkLogRequest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/WorkLogValidationGroups.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/PosterImagePublicationResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/PosterImagePublicationStatusResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/PosterResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/RepoStatsResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/WorkLogResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/WorkLogSummaryResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/DomainExceptionHandler.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCode.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/json/PosterIdSerializer.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/json/WorkLogIdSerializer.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/PosterImagePublicationWebMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/PosterWebMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/mapper/WorkLogWebMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/objectstorage/MultipartObjectContentProducer.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/Operation.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/OperationStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/SampleOperationNotFoundException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/SampleOperationStore.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/WorkLogExportResult.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/HmacPosterImageIdempotencyScopeDigester.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidOutboxEventIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidPosterIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidPosterImageOperationIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidWorkLogIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/config/JpaConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterImageIdempotencyKeyEpochEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterImageRetirementIntentEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/PosterImageUploadIntentEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/WorkLogEntity.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/PosterImageRetirementIntentPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/PosterImageUploadIntentPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/PosterPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/WorkLogPersistenceMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageAttachmentCasRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageIdempotencyKeyEpochJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageIdempotencyKeyEpochRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageRetirementIntentJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageRetirementIntentRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogJpaRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogSummaryQueryAdapter.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogSummaryRow.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RawRepoStatsResponse.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RepoStatsAclMapper.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RepoStatsPortClient.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/OutboxEventIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventContract.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventOutbox.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/GetPosterQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/GetPosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ListPostersQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ListPostersUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterCreatedPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterEventContracts.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterEventPublisher.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterIdPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PosterNotFoundException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PublishPosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/PublishPosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/UpdatePosterCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/UpdatePosterUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/AbortPosterImageUploadCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/AbortPosterImageUploadUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/GetPosterImagePublicationStatusQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/GetPosterImagePublicationStatusUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAlreadyPublishedException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentCompareAndSetPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentPrepared.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentPreparedPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentReadyPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAttachmentReadyV2.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageEventContracts.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageIdempotencyKeyEpochPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageIdempotencyScopeDigest.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageIdempotencyScopeDigesterPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageOperationIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationEventPublisher.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationFingerprint.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationParameters.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationPolicy.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationReservation.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationReservationCodec.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementIntent.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementIntentState.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementIntentStorePort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementResult.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageSanitizedIdempotencyContextFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntent.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentClaim.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentConflictException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentState.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageUploadIntentStorePort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PublishPosterImageCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/PublishPosterImageUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageRetirementCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageRetirementUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageUploadCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/ReconcilePosterImageUploadUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/RetirePosterImageCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/posterimage/RetirePosterImageUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/BatchCreateWorkLogsCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/BatchCreateWorkLogsUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/CreateWorkLogCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/CreateWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/DeleteWorkLogCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/DeleteWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetRepoStatsQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetRepoStatsUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetWorkLogQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/GetWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListRecentWorkLogSummariesQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListRecentWorkLogSummariesUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListWorkLogsQuery.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/ListWorkLogsUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/RepoStatsPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/UpdateWorkLogCommand.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/UpdateWorkLogUseCase.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogNotFoundException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogNotOwnedException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedContractContribution.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedPayload.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogSummary.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogSummaryPage.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogSummaryQueryPort.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogVersionMismatchException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/application/SampleApplicationUseCaseConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/management/SampleManagementSecurityConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageApiConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageApiSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageIdempotencyConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageIdempotencyKeyRingSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageObjectStorageConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImagePublicationSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementJob.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementSettings.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/runtime/SampleSchedulingConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoAccounts.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoAccountsProductionGuard.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoSecurityConfig.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/Poster.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterArchived.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterCreated.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterDeleted.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterId.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterImageAttachment.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterImageReference.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterInvariantException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterPage.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterPublished.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterSortField.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PosterTitleAlreadyExistsException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/poster/PublishedPosterImageAttachment.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/Period.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/RepoStats.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkCategory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLog.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogId.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogIdFactory.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogInvariantException.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogOwner.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogRepository.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogReserved.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogSortField.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogStatus.java delete mode 100644 src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/package-info.java delete mode 100644 src/sample-portfolio/src/main/resources/application.yml delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/portfolio.worklog.reserved/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/portfolio.worklog.reserved/v1.schema.sha256 delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.archived/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.created/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.deleted/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.image-attachment-prepared/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.image-attachment-ready/v2.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/contracts/messaging/poster.published/v1.schema.json delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V2__work_log.sql delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V7__poster.sql delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V8_1__poster_title_unique.sql delete mode 100644 src/sample-portfolio/src/main/resources/db/sample-migration/V8__poster_image_publication.sql delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/SampleApiDocsSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/InsertRoundTripCounter.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/RecordingStatementInspector.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/WorkLogStatementCostSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoProfilesStartupSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleWorkLogAuthorizationSystemTest.java delete mode 100644 src/sample-portfolio/src/systemTest/resources/application-test.yml delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/OperationsControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/PosterImagePublicationControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WebRequestParamsTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogControllerWireTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/BasicPolymorphicTypeValidatorAllowlistTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/SamplePolymorphicRequestTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/BulkEnvelopeTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/DomainExceptionHandlerTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCodeRegistryMappingTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCodeTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcPropagationTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/json/WorkLogIdSerializerTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/objectstorage/MultipartObjectContentProducerTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/operation/OperationTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/versioning/VersioningPrefixTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/HmacPosterImageIdempotencyScopeDigesterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidWorkLogIdFactoryTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/entity/WorkLogEntityTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/mapper/WorkLogPersistenceMapperTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogSummaryQueryAdapterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/repostats/RepoStatsAclMapperTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/CommandSelfValidationTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventContractsTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/event/PortfolioEventOutboxTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/event/SamplePayloadSchemaReleaseTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterImageRetirementTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/poster/PosterEventPublisherTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageAbortReconcileRaceTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationEventPublisherTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImagePublicationWorkflowTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageRetirementCrashMatrixTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/posterimage/PosterImageSanitizedIdempotencyContextFactoryTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/CreateWorkLogOutboxTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/GetRepoStatsUseCaseTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/ListRecentWorkLogSummariesUseCaseTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedConsumerDedupeContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedContractContributionTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogUseCasesTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/authz/WorkLogAuthorizationContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/authz/WorkLogAuthorizationE2ETest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/management/SampleActuatorLoggersAccessTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageIdempotencyConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/objectstorage/PosterImageRetirementConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationLockWaitTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleSchemaOwnershipDefaultsTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoAccountsProductionGuardTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SampleDemoSecurityConfigTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/PosterIdTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/PosterImageReferenceTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/PosterTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/poster/testkit/InMemoryPosterRepositoryContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/PeriodTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogIdPropertyTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogIdTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogInvariantTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/WorkLogTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/InMemoryWorkLogRepositoryContractTest.java delete mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/fixtures/SamplePortfolioFixture.java delete mode 100644 src/sample-portfolio/src/test/resources/contracts/messaging/portfolio.worklog.reserved/v1.invalid-unknown-field.json delete mode 100644 src/sample-portfolio/src/test/resources/contracts/messaging/portfolio.worklog.reserved/v1.valid.json delete mode 100644 src/sample-portfolio/src/test/resources/contracts/released-payload-schemas.sha256 delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/application/posterimage/testkit/InMemoryPosterImageRetirementIntentStore.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/application/posterimage/testkit/InMemoryPosterImageUploadIntentStore.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/application/worklog/testkit/InMemoryWorkLogSummaryQuery.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/poster/testkit/InMemoryPosterRepository.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/poster/testkit/PosterRepositoryContract.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/InMemoryWorkLogRepository.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/domain/worklog/testkit/WorkLogRepositoryContract.java delete mode 100644 src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java delete mode 100644 src/sample-portfolio/src/webSystemTest/resources/openapi/worklogs-openapi-snapshot.json diff --git a/.github/workflows/ci-quality-gates.yml b/.github/workflows/ci-quality-gates.yml index 83986f9e..78568530 100644 --- a/.github/workflows/ci-quality-gates.yml +++ b/.github/workflows/ci-quality-gates.yml @@ -58,20 +58,6 @@ jobs: - name: Verify Compose profile contracts render exactly as declared run: bash scripts/verify-compose-profile-contracts.sh - sample-portfolio: - # The sample is excluded from production architecture/runtime membership policy, but it is still - # the reference implementation adopters copy. Compile/test/OpenAPI drift must therefore block PRs. - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 - - uses: ./.github/actions/setup-gradle-java - # `qualityCheck` too: the root one covers the production leaves only, so the sample — the code - # adopters copy first — was analysed by no stage, and its SpotBugs exclusions matched nothing - # (review 2026-11-03 RR-06-05). - - name: Verify the standalone sample application - working-directory: src - run: ./gradlew :sample-portfolio:check :sample-portfolio:qualityCheck --stacktrace - optional-platforms: runs-on: ubuntu-latest steps: @@ -123,7 +109,6 @@ jobs: release-gate: needs: - quality-gates - - sample-portfolio - optional-platforms - grpc-proto-buf if: always() @@ -134,14 +119,12 @@ jobs: - name: Require every current blocking job to succeed env: QUALITY_RESULT: ${{ needs.quality-gates.result }} - SAMPLE_RESULT: ${{ needs.sample-portfolio.result }} OPTIONAL_PLATFORMS_RESULT: ${{ needs.optional-platforms.result }} GRPC_PROTO_BUF_RESULT: ${{ needs.grpc-proto-buf.result }} run: | set -euo pipefail for result in \ "${QUALITY_RESULT}" \ - "${SAMPLE_RESULT}" \ "${OPTIONAL_PLATFORMS_RESULT}" \ "${GRPC_PROTO_BUF_RESULT}"; do if [[ "${result}" != "success" ]]; then diff --git a/.github/workflows/integration-main.yml b/.github/workflows/integration-main.yml index 2fdf8b10..8c86e828 100644 --- a/.github/workflows/integration-main.yml +++ b/.github/workflows/integration-main.yml @@ -60,7 +60,7 @@ concurrency: jobs: # The main-branch stage of the Gradle gates (`:mainCheck`): the environment contract, full-boot - # qualification, the sample web contract, the public-path baseline, the conditional transport + # qualification, the public-path baseline, the conditional transport # lanes, the messaging contract lanes and each leaf's document-contract lanes. API surfaces are # in the pull-request `check` (owner decision 20). The rest left the pull-request gate (review # 2026-09-24 BUILD, item 12); none of them is deleted. diff --git a/AGENTS.md b/AGENTS.md index 26d2371b..064de985 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ 이 저장소는 단순한 예제 블로그 애플리케이션이 아니라, Java 21 + 버전 카탈로그에 고정된 Spring Boot 4.x + Gradle 멀티모듈 기반의 Clean Architecture 템플릿이다. -기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 엔지니어링 작업 기록 게시판)에 격리한다. 새 프로젝트를 시작할 때는 도메인 이름, 패키지, 엔티티, 유스케이스를 교체할 수 있지만, 모듈 경계와 의존성 방향은 유지해야 한다. +기본 패키지는 `dev.caskeleton`이다. 업무 기능의 예시는 `scripts/new-feature.sh`의 출력과 `docs/manual/`이다. 새 프로젝트를 시작할 때는 도메인 이름, 패키지, 엔티티, 유스케이스를 교체할 수 있지만, 모듈 경계와 의존성 방향은 유지해야 한다. ## Prime Directive @@ -85,7 +85,7 @@ root `CLAUDE.md`는 작업을 시작할 때 읽는 지도이고, 이 목록을 - `src/build.gradle`: 루트 라이프사이클(`ci`, `mainCheck`, `integrationCheck`, `performanceCheck`, `releaseCheck`, `qualityCheck`, `configContractCheck`)과 버전/리비전. `verifyStrictLaneStages --dry-run`(PR 게이트)은 그 빌드에서 `explicitOnly`가 아닌 strict lane이 workflow가 실제로 실행하는 - 단계(main 빌드: `ci`·`sample-portfolio:check`·`mainCheck`·`integrationCheck`·`performanceCheck`· + 단계(main 빌드: `ci`·`mainCheck`·`integrationCheck`·`performanceCheck`· `releaseCheck`, optional-platforms 빌드: `-p optional-platforms`로 부르는 `ci`·`integrationCheck`· `performanceCheck`·`releaseCheck`) 중 하나에 들어 있는지, 그리고 workflow의 접힌(`>`) run 블록이 빈 줄 때문에 옵션을 별개 명령으로 떼어 내지 않는지 검사한다. 두 빌드가 각자 검사를 돌린다. `-x`로 뺀 @@ -148,7 +148,6 @@ commit 정책은 모든 플랫폼에서 `human-only`이며 agent는 stage/commit file server, HTTP client, identifier 능력을 port 뒤에서 구현한다. adapter 간 허용 edge는 registry만 따른다. - `shared-contract`: skeleton-wide 운영 계약. business/domain 개념 저장 금지. -- `sample-portfolio`: 샘플/fixture consumer. production leaf가 의존하면 안 된다. - `app-bootstrap`: Spring Boot entrypoint와 composition root. 비즈니스 유스케이스 금지. ## 의존성 방향 @@ -159,7 +158,6 @@ family 수준 기본 방향: app-bootstrap -> adapter:inbound:* -> application-core -> domain-core app-bootstrap -> adapter:outbound:* -> application-core -> domain-core runtime modules -> shared-contract -sample-portfolio -> registered runtime leaves (fixture consumer only) ``` 개별 edge는 `src/config/architecture/modules.json`의 `allowed_dependencies`가 유일한 목록이다. @@ -181,8 +179,7 @@ Gradle 의존성 검증도 같은 registry를 읽는다. root 문서나 기억 10. focused test를 먼저 돌리고, 가능한 경우 전체 Gradle test를 돌린다. 단계별 판단 지점(배치·저장 포트·트랜잭션·멱등성·오류·권한)은 `docs/manual/`, 뼈대는 -`scripts/new-feature.sh `이 계층 leaf에 만든다. `sample-portfolio`는 모든 계층을 한 leaf에 -두는 지울 수 있는 샘플이라 배치 예시가 아니다. 실제 기능은 계층 leaf별로 나눈다. +`scripts/new-feature.sh `이 계층 leaf에 만든다. 실제 기능은 계층 leaf별로 나눈다. ## 테스트 전략 @@ -232,7 +229,7 @@ cd src ./gradlew qualityCheck # SpotBugs + FindSecBugs (leaf check에는 없다) ./gradlew testQualityCheck # 같은 분석을 테스트 source set에(config/spotbugs/exclude-test.xml, main 단계·optional 빌드는 ci) ./gradlew ci # PR 게이트 = leaf check + architecture + quality -./gradlew mainCheck # main 단계 = env 계약·전체 기동(샘플 포함)·public path·전송/메시징 레인·leaf 문서 대조 레인·기능 생성 왕복(verifyFeatureScaffold)·테스트 코드 정적 분석(testQualityCheck) +./gradlew mainCheck # main 단계 = env 계약·전체 기동·public path·전송/메시징 레인·leaf 문서 대조 레인·기능 생성 왕복(verifyFeatureScaffold)·테스트 코드 정적 분석(testQualityCheck) ./gradlew integrationCheck # 실제 컨테이너 integration 레인 전체(main·nightly, Docker 필요) ./gradlew performanceCheck # 부하·종료·자원 한계 레인(main·nightly). 상한은 항상 단언, 끄면 실패 ./gradlew verifyStrictLaneStages --dry-run # 이 빌드의 strict lane이 workflow가 실행하는 단계에 속하는지(optional 빌드는 -p optional-platforms로 따로) @@ -307,7 +304,7 @@ Docker/runtime 규칙: gRPC 플랫폼을 쓰면 proto 조직 이름 `caskeleton`(`src/grpc/grpc-contract/src/main/proto/caskeleton/`의 디렉터리, 각 `.proto`의 `package`·`java_package`)도 함께 바꾸고 `buf lint`로 확인한다. 3. `CaSkeletonApplication` 이름을 새 애플리케이션 이름으로 바꾼다. -4. production 모듈에는 목표 도메인의 entity, repository port, use case, adapter만 추가하고, 예시 코드는 `sample-portfolio`에 격리한다. +4. production 모듈에는 목표 도메인의 entity, repository port, use case, adapter만 추가한다. 5. 모듈 이름과 경계는 유지한다. 6. Docker image/application 이름을 새 프로젝트 기준으로 수정한다. 7. `.env`, `.env.local`, `application.yml`의 예시 값을 새 런타임 요구사항에 맞춘다. diff --git a/CLAUDE.md b/CLAUDE.md index 86356844..97838d8e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -59,7 +59,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이 - **`composition:*` leaf는 조립만 한다.** outbox relay, 멱등성 executor, durable operation처럼 bootstrap에서 떼어 낸 조립이다. 각각 `runtimeOnly` 한 줄로 고른다. - **capability는 한 줄로 켜고 끈다.** 기본 조립은 web inbound, 운영 관측, core들, support·identifier뿐이다. JPA도 `src/app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄로 켠다. 규칙은 `AGENTS.md` 「부가 기능(capability) 모듈 규칙」이다. - **gRPC 플랫폼 라이브러리는 다른 빌드다.** `src/grpc/*`·`src/grpc-advanced/*`(registry의 `"build": "optional-grpc"`)는 `-p optional-platforms`로 돈다. `adapter:inbound:grpc`는 애플리케이션 adapter라 주 빌드에 있다. -- **`src/sample-portfolio`는 지울 수 있는 샘플이다.** 한 leaf에 모든 계층을 둔 모양이라 배치를 따라 하지 않는다. 새 기능의 예시는 `scripts/new-feature.sh`의 출력이다. +- **새 기능의 예시는 `scripts/new-feature.sh`의 출력이다.** 샘플 모듈은 2026-11-07에 지웠다. 기법 예시는 `docs/manual/`이 실제 코드(fileserver, durable operation)를 가리킨다. - **성능 lane에는 단언을 끄는 스위치가 없다.** convention이 상한을 매번 단언하고, `performance.assertions.enabled`에 `true` 아닌 값이 들어오거나 skip이 있으면 테스트 전에 실패한다. 손으로 돌리든 workflow든 같다(`AGENTS.md` 「Gradle 정책 권위」). - **저장소 파일을 읽는 테스트는 태그가 있다.** 문서와 대조하는 테스트는 `document-contract`(main 단계 `mainCheck`), 빌드 스크립트·workflow를 읽는 테스트는 `repository-contract`(PR)다. 문서를 고치면 그 문서를 읽는 테스트를 찾는다. - **커밋 정책은 `human-only`다.** brief가 허용한 것만 자기 브랜치에 한다. 커밋과 push는 따로 허용된다. 자세한 것은 [docs/work/README.md](docs/work/README.md) 4절이다. diff --git a/README.md b/README.md index 3d6b69a0..ed140e9c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # ca-skeleton — Clean Architecture Spring Boot 템플릿 -ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Gradle 멀티모듈 기반의 Clean Architecture 백엔드 템플릿입니다. fork해서 도메인·패키지·엔티티·유스케이스만 교체하면 새 서비스를 시작할 수 있고, 모듈 경계와 의존 방향은 그대로 유지합니다. 기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 작업 기록 게시판)에 격리합니다. +ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Gradle 멀티모듈 기반의 Clean Architecture 백엔드 템플릿입니다. fork해서 도메인·패키지·엔티티·유스케이스만 교체하면 새 서비스를 시작할 수 있고, 모듈 경계와 의존 방향은 그대로 유지합니다. 기본 패키지는 `dev.caskeleton`입니다. 업무 기능의 예시는 생성 명령 `scripts/new-feature.sh`의 출력과 [docs/manual/](docs/manual/README.md)입니다. 이 문서는 전체 구조와 첫 실행만 다룹니다. 모듈별 상세 규칙과 설계 근거는 각 모듈의 README와 `CLAUDE.md`가, 빌드·환경 변수 상세는 [src/README.md](src/README.md)가 소유합니다. @@ -12,7 +12,6 @@ ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Grad app-bootstrap -> adapter:inbound:* -> application-core -> domain-core app-bootstrap -> adapter:outbound:* -> application-core -> domain-core 모든 런타임 모듈 -> shared-contract -sample-portfolio -> 등록된 런타임 리프 (fixture 소비자 전용) ``` family 수준의 책임은 다음과 같습니다. @@ -26,7 +25,6 @@ family 수준의 책임은 다음과 같습니다. | `adapter:outbound:*` | support(공유 베이스)·messaging·cache·notification·object storage·file·HTTP client·identifier 능력을 port 뒤에서 구현. 기본 조립에는 support·identifier만 들어 있고, 나머지는 `app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄로 고릅니다 | | `shared-contract` | skeleton 전역 운영 계약. business/domain 개념 저장 금지 | | `app-bootstrap` | Spring Boot entrypoint와 composition root | -| `sample-portfolio` | WorkLog 예시 도메인(fixture/reference). production이 의존하지 않음 | 등록된 leaf 목록과 각 leaf의 Gradle path·소스 경로·허용 production 의존 edge는 [src/config/architecture/modules.json](src/config/architecture/modules.json)이 SSOT입니다. focused @@ -91,10 +89,10 @@ H2 실행은 wiring과 애플리케이션 동작만 검증하고, migration과 v 애플리케이션 이름 등 나머지 rename 단계는 위 체크리스트를 따릅니다. -3. `CaSkeletonApplication`을 새 애플리케이션 이름으로 바꾸고, 목표 도메인의 엔티티·repository port·유스케이스·adapter를 production 모듈에 추가합니다. 예시 코드는 `sample-portfolio`에만 둡니다. +3. `CaSkeletonApplication`을 새 애플리케이션 이름으로 바꾸고, 목표 도메인의 엔티티·repository port·유스케이스·adapter를 production 모듈에 추가합니다. 새 업무 기능은 `scripts/new-feature.sh `으로 만듭니다. 4. 모듈 이름과 경계는 그대로 유지합니다. -검증은 먼저 composition root의 빠른 테스트와 sample-off 계약을 확인합니다. 루트에서 +검증은 먼저 composition root의 빠른 테스트와 아키텍처 검사를 확인합니다. 루트에서 `./gradlew test`를 호출하면 등록된 모든 하위 프로젝트의 `test`를 실행하므로 일상적인 로컬 피드백 명령으로 사용하지 않습니다. 저장소 전체 qualification은 CI 또는 명시적인 `ci` task가 담당합니다. @@ -102,14 +100,11 @@ H2 실행은 wiring과 애플리케이션 동작만 검증하고, migration과 v ```bash cd src ./gradlew :app-bootstrap:test -./gradlew :sample-portfolio:check ./gradlew architectureCheck ``` 병합 전 저장소 전체 검증이 필요하면 `./gradlew ci`를 실행합니다. -`sample-portfolio`는 템플릿이 유지하는 fixture/reference 모듈이라 production 모듈이 의존하지 않고, runtime에 sample bean이나 endpoint를 넣지 않습니다. 다운스트림 fork에서 fixture가 더 필요 없을 때만 sample-off 테스트를 통과시킨 뒤 정리합니다. - ## 아키텍처 규칙과 검증 애플리케이션이 동작하더라도 아래를 어기면 병합하지 않습니다. HARD-STOP 7개 조건의 정본 로컬 @@ -135,8 +130,7 @@ cd src ## 수동 전용 Gradle 태스크 -아래 세 태스크는 **어떤 워크플로도 실행하지 않으며, 그게 의도다.** 자동 실행이 틀린 이유를 각각 -적어 둔다. +아래 태스크는 **어떤 워크플로도 실행하지 않으며, 그게 의도다.** 자동 실행이 틀린 이유를 적어 둔다. 여기 적힌 태스크 이름이 실재하는지 검사하던 `verifyReadmeCommands`는 삭제했다. 그건 이 문서의 ```bash 블록을 직접 파싱해 `./gradlew`·`docker compose`·`make` 토큰을 실제 태스크 그래프와 대조하는 @@ -146,16 +140,11 @@ Markdown 명령 파서였고, 그 결과 "README에 무엇을 쓸 수 있는가" ```bash cd src ./gradlew :grpc:grpc-testkit:grpcPerformanceTest -./gradlew :sample-portfolio:openapiCheckSnapshot -PapproveOpenApiChange ``` - `grpcPerformanceTest` — latency percentile·saturation·drain budget을 **측정**한다. 공유 CI runner의 측정값은 흔들리고, 흔들리는 게이트는 결국 꺼진다. leaf `build.gradle`이 이 태스크의 태그를 `test`에서 제외하는 이유도 같다. 성능 회귀가 의심될 때 사람이 이름으로 부른다. -- `openapiCheckSnapshot` — 드리프트 검사 자체는 이미 자동으로 돈다. 이 태스크가 감싸는 - `OpenApiDriftContractTest`는 `:sample-portfolio:test`의 일부이고, 그건 `check` 안이며 stage 1에서 - 실행된다. 이 태스크의 고유한 역할은 `-PapproveOpenApiChange`로 **커밋된 스냅샷을 다시 만드는 것** - — 의도된 API 변경을 사람이 승인하는 지점이다. 자동으로 돌리면 승인이 승인이 아니게 된다. ## 더 알아보기 diff --git a/docs/capability-status.md b/docs/capability-status.md index b70e0120..d8d41b98 100644 --- a/docs/capability-status.md +++ b/docs/capability-status.md @@ -27,11 +27,11 @@ lanes and CI; it is not a deployment artifact. | Capability | Enabled key (property / env, default) | IMPLEMENTED | WIRED | QUALIFIED | Evidence | | --- | --- | --- | --- | --- | --- | -| Relational persistence (JPA/PostgreSQL) | `ca-skeleton.persistence-jpa.enabled` / `APP_PERSISTENCE_JPA_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:persistence-jpa')`) | yes | Not in the default composition. The one line brings everything — its own `AutoConfiguration.imports` (`PersistenceJpaAutoConfiguration`, `PersistenceJpaRuntimeConfig`, `JpaStartupAutoConfiguration`), its environment handling (`JpaActivationEnvironmentPostProcessor`, `spring.factories`: readiness `db` while on; with `false` it also excludes Boot's JDBC, Hibernate, Spring Data JPA and Flyway auto-configuration, so no DataSource is bound), the startup guards (Flyway strategy, datasource/OSIV/DDL/pool/TLS/vendor checks, exit codes unchanged) and its settings (`config/module-defaults/persistence-jpa.yml`). `persistence-jpa:PersistenceJpaCapabilityAssemblyTest` proves the module assembles on its own; the `postgresql*IntegrationTest` readiness lanes, run by `integration-main.yml` → `integration-check` (`:integrationCheck`), qualify it against PostgreSQL. `sample-portfolio` selects it by its build dependency and the module's auto-configuration (no broad scan of the persistence package). `bootRunH2` adds the module to its own classpath only. | +| Relational persistence (JPA/PostgreSQL) | `ca-skeleton.persistence-jpa.enabled` / `APP_PERSISTENCE_JPA_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:persistence-jpa')`) | yes | Not in the default composition. The one line brings everything — its own `AutoConfiguration.imports` (`PersistenceJpaAutoConfiguration`, `PersistenceJpaRuntimeConfig`, `JpaStartupAutoConfiguration`), its environment handling (`JpaActivationEnvironmentPostProcessor`, `spring.factories`: readiness `db` while on; with `false` it also excludes Boot's JDBC, Hibernate, Spring Data JPA and Flyway auto-configuration, so no DataSource is bound), the startup guards (Flyway strategy, datasource/OSIV/DDL/pool/TLS/vendor checks, exit codes unchanged) and its settings (`config/module-defaults/persistence-jpa.yml`). `persistence-jpa:PersistenceJpaCapabilityAssemblyTest` proves the module assembles on its own; the `postgresql*IntegrationTest` readiness lanes, run by `integration-main.yml` → `integration-check` (`:integrationCheck`), qualify it against PostgreSQL. `bootRunH2` adds the module to its own classpath only. | | Document persistence (MongoDB) | `ca-skeleton.persistence-mongo.enabled` / `APP_PERSISTENCE_MONGO_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:persistence-mongo')`) | yes | On when present; `false` also excludes Boot's Mongo auto-configuration (`MongoCapabilityActivationTest`). The connection-source rule (`SPRING_MONGODB_URI` or the selected profile's `uri-secret`) is checked by the module's own `MongoDefaultsEnvironmentPostProcessor`. Six container lanes (`mongoReplicaSetTest`, `mongoFailoverTest`, …), run by `integration-main.yml` → `integration-check` (`:integrationCheck`) | | Messaging (Kafka) | `app.messaging.enabled` / `APP_MESSAGING_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:messaging-kafka')`, which brings the application bridge, the legacy `KafkaSender` seam and the vendored platform with its Kafka transport) | Kafka only | On when present (`KafkaCapabilityActivationTest`). `messaging-kafka:messagingCertificationTest` behind `verifyMessagingCertificationEvidence`, run by `messaging-certification.yml`; the starter's `integrationTest` is the live Kafka round trip. Kafka is the only registered broker; the RabbitMQ broker keys were removed (no transport). | | Redis capabilities (cache / rate-limit / lease / idempotency) | `app.redis.enabled` / `APP_REDIS_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':adapter:outbound:cache-redis')`, which brings `redis-runtime`) | yes | `cache-redis:redisContainerContractTest` (Testcontainers Redis, `integrationCheck`); `cache-redis:redisTopologyTest`, run by `redis-sdk-topology.yml`. Not in the default composition. On when present; `false` contributes no Redis bean — no settings, client, connection, thread or health contributor. The module owns its readiness contribution (`RedisReadinessGroupPostProcessor`, `spring.factories`) and its settings (`config/module-defaults/cache-redis.yml`: `app.redis.enabled`, `app.rate-limit.*`, the Redis `ca-skeleton.capabilities.*`). No `app-bootstrap` main source names a Redis type. | -| Request idempotency | `APP_IDEMPOTENCY_PROVIDER` (`disabled` \| `redis` \| `postgresql`; a selector, not an on/off key) | yes | yes | Redis and PostgreSQL | One generation: the application `IdempotencyExecutor`, built once by `composition:idempotency` (`IdempotencyAutoConfiguration`) over the one store the selected provider contributes (`cache-redis` or `persistence-jpa`); startup is refused unless exactly one store exists. `app-bootstrap` and `sample-portfolio` both take that module with one `runtimeOnly` line, so there is no second assembly. Redis is covered by the row above. PostgreSQL has `persistence-jpa:postgresqlIdempotencyIntegrationTest`, run by `integration-main.yml` → `integration-check` (`:integrationCheck`). The `postgresql` provider refuses a non-PostgreSQL data source, so `bootRunH2` uses `disabled` or `redis`. Each store comes with its module: `postgresql` needs the persistence-jpa line, `redis` the cache-redis one. | +| Request idempotency | `APP_IDEMPOTENCY_PROVIDER` (`disabled` \| `redis` \| `postgresql`; a selector, not an on/off key) | yes | yes | Redis and PostgreSQL | One generation: the application `IdempotencyExecutor`, built once by `composition:idempotency` (`IdempotencyAutoConfiguration`) over the one store the selected provider contributes (`cache-redis` or `persistence-jpa`); startup is refused unless exactly one store exists. `app-bootstrap`이 그 모듈을 `runtimeOnly` 한 줄로 받고, 다른 조립은 없다. Redis is covered by the row above. PostgreSQL has `persistence-jpa:postgresqlIdempotencyIntegrationTest`, run by `integration-main.yml` → `integration-check` (`:integrationCheck`). The `postgresql` provider refuses a non-PostgreSQL data source, so `bootRunH2` uses `disabled` or `redis`. Each store comes with its module: `postgresql` needs the persistence-jpa line, `redis` the cache-redis one. | | Transactional outbox relay | `ca-skeleton.outbox.enabled` / `APP_OUTBOX_ENABLED`, `false` (+ `APP_OUTBOX_RELAY_ENABLED`, `false`; persistence-jpa settings) | yes | yes (with the persistence-jpa line; the scheduler also needs the messaging-kafka line) | yes | The store and its settings are persistence-jpa's; the relay (`OutboxConfig`) is application composition in `app-bootstrap` because a driven adapter must not build or call a use case. It turns on only when an `OutboxStorePort` bean exists, and the scheduler only when an `OutboxMessagePublishPort` does (the messaging bridge), each ordered after its contributor by `afterName` — so an environment with no publisher keeps its PENDING rows. The bridge registers no stand-in publisher: a present-and-enabled bridge with a blank broker and no canonical transport is refused at startup. `postgresqlLegacyOutboxConcurrentRelayIntegrationTest` qualifies claim/fencing against PostgreSQL. | | Notification platform | `ca-skeleton.notification.platform.enabled` / `APP_NOTIFICATION_PLATFORM_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':composition:notification-platform')`, plus the persistence-jpa line) | claim-scoped | Not in the default composition. The one line brings the use-case assembly, `adapter:outbound:notification`, the HTTP surface `adapter:inbound:web-notification` and its own settings (`config/module-defaults/notification.yml`), each registered through the module's own `AutoConfiguration.imports`; `adapter:inbound:web` no longer depends on `application-notification`. `verifyNotificationEvidence` refuses a grade in `docs/notification/support-matrix.md` that no proven claim backs; run by `notification-platform.yml`. There is no real-SMTP lane, and the matrix says so rather than implying one. | | File server platform | `app.fileserver-platform.enabled` / `APP_FILESERVER_PLATFORM_ENABLED`, `true` | yes | yes (one line: `runtimeOnly project(':composition:fileserver-platform')`, plus the persistence-jpa line) | yes | On when present; module-owned `config/module-defaults/fileserver.yml` also carries the servlet multipart ceiling. `app-bootstrap:integrationTest` → `FileserverCompositionIntegrationTest` (required by the strict lane), run by `integration-main.yml` → `integration-check` (`:integrationCheck`) | diff --git a/docs/ci-cd/template-vs-consumer.md b/docs/ci-cd/template-vs-consumer.md index 964e2552..76303394 100644 --- a/docs/ci-cd/template-vs-consumer.md +++ b/docs/ci-cd/template-vs-consumer.md @@ -4,8 +4,8 @@ 이 저장소에는 성격이 다른 두 종류의 검증이 섞여 있다. -1. **스켈레톤을 만드는 사람**에게 필요한 검증 — sample 모듈이 정말 제거 가능한가, optional 모듈 - 조합이 모두 빌드되는가, 레지스트리가 확장 가능한가. +1. **스켈레톤을 만드는 사람**에게 필요한 검증 — optional 모듈 조합이 모두 빌드되는가, 레지스트리가 + 확장 가능한가. 2. **스켈레톤을 가져다 서비스를 만드는 사람**에게 필요한 검증 — 내 애플리케이션의 테스트, 아키텍처 방향, 보안, 릴리스. @@ -16,9 +16,6 @@ | 대상 | 무엇을 지키는가 | | --- | --- | -| `:app-bootstrap:sampleOffTest`, `ci-quality-gates.yml`의 `sample-off` job | sample 픽스처를 지워도 애플리케이션이 빌드·부팅되는가 | -| `sample-portfolio` leaf 전체 | 참조 구현 | -| `Dockerfile.sample`, `docker-compose.*` 중 sample 관련 | 위와 동일 | | `docs/superpowers/**` | 이 템플릿을 만든 과정의 설계/계획 기록 | | `gradle/qualification/**` | 이 템플릿이 벤더링한 플랫폼(JPA, messaging)의 인증 체계 | | `*-certification.yml`, `*-qualification.yml`, `jpa-next-*.yml` | 템플릿이 광고하는 지원 매트릭스의 근거 | diff --git a/docs/fileserver/design-deviations.md b/docs/fileserver/design-deviations.md index 0bf0a744..0273e4a9 100644 --- a/docs/fileserver/design-deviations.md +++ b/docs/fileserver/design-deviations.md @@ -113,9 +113,8 @@ The metadata store, session store, quota service, queues, ledger, and staging lo `@ConditionalOnProperty(app.fileserver-platform.enabled)` even though the rest of `adapter:outbound:persistence-jpa` is unconditional. -Without the gate, every composition root that includes the persistence module built these beans — -including `sample-portfolio`, which has no Fileserver — and each of them needs collaborators only -the Fileserver configuration provides. That is the same rule the design states for the transport +게이트가 없으면 persistence 모듈을 포함한 조립 루트는 Fileserver를 쓰지 않아도 이 bean들을 만들고, 그 bean마다 +Fileserver 설정만 주는 협력 객체가 필요하다. That is the same rule the design states for the transport surface, applied to persistence: no surface appears merely because the dependency is present. `FileStateMachine` is bound alongside them, in `FileserverStorageConfiguration`. It had no diff --git a/docs/jpa/entity-mapping-guide.md b/docs/jpa/entity-mapping-guide.md index 2a09c7d5..aae8772c 100644 --- a/docs/jpa/entity-mapping-guide.md +++ b/docs/jpa/entity-mapping-guide.md @@ -96,8 +96,8 @@ second `UPDATE`, and the entity graph is a cycle. Keep the association on one si an ID or a query (re-review round 2, RR-02-15). A class that links to itself is a pair only when a second member points back the other way (`@ManyToOne parent` with `@OneToMany children`); two `@ManyToOne` links of a class to itself (a manager and a mentor) pass, because both keys point into -the one table and there are no two tables to order. `JpaProductionArchitectureTest` (app-bootstrap -`architectureTest`) runs it over the production graph and `SampleArchitectureTest` over the sample. +the one table and there are no two tables to order. 이 규칙은 `JpaProductionArchitectureTest`(app-bootstrap +`architectureTest`)가 운영 그래프 전체에 건다. The failure message names the fields and these alternatives. Chosen and rejected: diff --git a/docs/jpa/migration-guide.md b/docs/jpa/migration-guide.md index c8a85f1a..0a6b3e61 100644 --- a/docs/jpa/migration-guide.md +++ b/docs/jpa/migration-guide.md @@ -103,10 +103,9 @@ from its list that lock an existing table with no bound in force: `ALTER TABLE`, FULL`; `REFERENCES` on the table it references, in a new table as much as in an `ALTER TABLE` (a foreign key locks its parent against writes while it is added); `CREATE TRIGGER` and `DROP TRIGGER` on their table; `UPDATE` and `DELETE`. It reads text, so a statement outside the list is not -checked. `MigrationLockWaitTest` runs it over every tree this leaf's database runs, -`SampleMigrationLockWaitTest` over the sample's stream; a service stream copies the latter with its -own directory. Both find the migrations the way Flyway does, decimal versions (`V22_1__`) included -(`VersionedMigrationFiles`, testkit). The migrations released before the rule wait unbounded and +checked. `MigrationLockWaitTest`는 이 leaf의 데이터베이스가 돌리는 모든 트리에 이 검사를 건다. 서비스 +스트림은 이 테스트를 복사해 자기 폴더를 넣는다. 이 테스트는 Flyway와 같은 방식으로 마이그레이션을 찾고, 소수 +버전(`V22_1__`)도 포함한다(`VersionedMigrationFiles`, testkit). The migrations released before the rule wait unbounded and stay that way (they are applied, and applied files are never edited); the test lists them and refuses any new one. `PostgreSqlMigrationLockWaitIntegrationTest` (`postgresqlMigrationLockWaitIntegrationTest`) shows on real PostgreSQL that a bounded migration diff --git a/docs/jpa/support-matrix.md b/docs/jpa/support-matrix.md index 1de1114b..793821bf 100644 --- a/docs/jpa/support-matrix.md +++ b/docs/jpa/support-matrix.md @@ -118,8 +118,8 @@ Each row is a way the platform could pass its tests and still be wrong in produc ### The audit mechanism `audit/AuditableEntity` is the only one: `created_*`/`updated_*`, a 256-character actor, stamped -explicitly by the repository adapter. It is what the sample entities extend and what the migrations -were written for. A second, Spring Data listener-based mechanism (`auditing/AuditMetadata`) was never +explicitly by the repository adapter. 서비스의 엔티티는 이것을 상속하고, 마이그레이션도 이 열에 +맞춰 썼다. A second, Spring Data listener-based mechanism (`auditing/AuditMetadata`) was never composed and has been removed; `JpaAuditMechanismRule.entitiesUseExactlyOneAuditMechanism` keeps it from coming back on an entity. diff --git a/docs/manual/02-new-feature.md b/docs/manual/02-new-feature.md index d4902048..0f36708c 100644 --- a/docs/manual/02-new-feature.md +++ b/docs/manual/02-new-feature.md @@ -35,7 +35,7 @@ - **기본값**: 서버가 만든다. domain `XIdFactory extends IdFactory` + `adapter:outbound:identifier` 구현. 문법은 id 값 객체 생성자에서 검사한다. - **예외**: 클라이언트가 자연 키(주문번호 등)를 주는 기능은 그 키를 id로 쓴다. 이때 중복은 DB 유일성 - 제약이 막는다(04장). UUIDv7이 필요하면 `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/identifier/UuidWorkLogIdFactory.java`처럼 바꾼다. + 제약이 막는다(04장). UUIDv7이 필요하면 `src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java`처럼 바꾼다. ### 판단: 불변식을 어디 두나 diff --git a/docs/manual/03-placement.md b/docs/manual/03-placement.md index 3344a841..395780c9 100644 --- a/docs/manual/03-placement.md +++ b/docs/manual/03-placement.md @@ -2,9 +2,9 @@ ## 핵심 -새 기능을 두는 모양은 셋이다. **업무 기능의 기본은 ① 계층 leaf 안 `` 패키지**다. -선택해서 켜고 끄는 플랫폼 기능만 ② 별도 `application-*` leaf로 만든다. ③ 한 leaf 수직 슬라이스는 -지울 수 있는 샘플 전용이다. 생성 명령은 ①만 만든다. +새 기능을 두는 모양은 둘이다. **업무 기능의 기본은 ① 계층 leaf 안 `` 패키지**다. +선택해서 켜고 끄는 플랫폼 기능만 ② 별도 `application-*` leaf로 만든다. 한 leaf에 모든 계층을 두는 +수직 슬라이스는 쓰지 않는다. 생성 명령은 ①만 만든다. ```text ① 계층 leaf 안 패키지 (기본) @@ -13,21 +13,18 @@ ② 기능 전용 leaf (capability) application- -> persistence-, adapter:outbound:, adapter:inbound:web- -> composition:-platform app-bootstrap/build.gradle 에 runtimeOnly 한 줄 - -③ 한 leaf 수직 슬라이스 (샘플 전용) - sample-portfolio = domain + application + adapter + bootstrap 패키지 ``` ## 기준표 -| 질문 | ① 계층 leaf 패키지 | ② 기능 leaf | ③ 수직 슬라이스 | -| --- | --- | --- | --- | -| 서비스마다 켜고 끌 수 있어야 하나 | 아니오 | **예** | — | -| 다른 서비스가 같은 기능을 라이브러리로 받나 | 아니오 | **예** | 아니오 | -| 한 줄 지워 기능을 통째로 빼야 하나 | 아니오(패키지 삭제) | **예**(`runtimeOnly` 한 줄) | 예(leaf 삭제) | -| leaf 단위 의존 방향 검사가 기능 안에도 걸리나 | 예(계층이 leaf) | 예 | **아니오**(ArchUnit 패키지 규칙에만 기댐) | -| 고칠 공용 파일 | 없음(+ imports 한 줄) | `modules.json`, `settings.gradle` 매핑, `app-bootstrap/build.gradle`, lockfile | `modules.json` | -| 예시 | 생성 명령 출력, `application-core/.../operation` | `application-notification`, `application-fileserver`, `application-objectstorage` | `sample-portfolio` | +| 질문 | ① 계층 leaf 패키지 | ② 기능 leaf | +| --- | --- | --- | +| 서비스마다 켜고 끌 수 있어야 하나 | 아니오 | **예** | +| 다른 서비스가 같은 기능을 라이브러리로 받나 | 아니오 | **예** | +| 한 줄 지워 기능을 통째로 빼야 하나 | 아니오(패키지 삭제) | **예**(`runtimeOnly` 한 줄) | +| leaf 단위 의존 방향 검사가 기능 안에도 걸리나 | 예(계층이 leaf) | 예 | +| 고칠 공용 파일 | 없음(+ imports 한 줄) | `modules.json`, `settings.gradle` 매핑, `app-bootstrap/build.gradle`, lockfile | +| 예시 | 생성 명령 출력, `application-core/.../operation` | `application-notification`, `application-fileserver`, `application-objectstorage` | ### 판단: ①과 ② 중 무엇인가 @@ -39,19 +36,18 @@ - **다시 볼 조건**: 파생 서비스가 둘 이상 생겨 같은 업무 기능을 공유하거나, application-core 컴파일·테스트 시간이 문제가 되면 ①을 ②로 옮긴다. -### 판단: ③을 써도 되나 +### 판단: 한 leaf 수직 슬라이스를 써도 되나 -- **기본값**: 쓰지 않는다. ③은 leaf 하나가 모든 계층에 의존해서 leaf 단위 방향 검사가 기능 안에서는 +- **기본값**: 쓰지 않는다. leaf 하나가 모든 계층에 의존해서 leaf 단위 방향 검사가 기능 안에서는 아무것도 막지 못한다. -- **예외**: 통째로 지울 수 있어야 하는 샘플·데모. `sample-portfolio`가 그 예다. 샘플을 계층 leaf로 쪼개지 - 않는 이유는 "leaf 하나 지우면 끝"이라는 성질을 지키려는 것이다. +- **예외**: 없다. 이 모양이던 샘플 모듈은 매뉴얼과 생성 명령이 예시를 맡아 2026-11-07에 지웠다. ## ① 안의 패키지 규칙 | 계층 | 패키지 | 하위 패키지 | | --- | --- | --- | | domain | `dev.caskeleton.domain.` | fake·계약은 testFixtures `dev.caskeleton.domain..testkit` | -| application | `dev.caskeleton.application.` | 종류별 하위 패키지(`command`, `usecase`, `port`)를 만들지 않는다. 기능별 한 패키지(`sample-portfolio`도 2026-09-29에 이 배치로 옮겼다) | +| application | `dev.caskeleton.application.` | 종류별 하위 패키지(`command`, `usecase`, `port`)를 만들지 않는다. 기능별 한 패키지 | | outbound | `dev.caskeleton.adapter.outbound..` | | | inbound | `dev.caskeleton.adapter.inbound.web.` | | | bootstrap | `dev.caskeleton.bootstrap.autoconfigure.` | `@AutoConfiguration`만(`BOOTSTRAP_AUTOCONFIGURE_STEREOTYPES_ARE_AUTO_CONFIGURATIONS`) | @@ -73,4 +69,3 @@ - 업무 기능 = ① 계층 leaf 패키지. 생성 명령이 이 모양을 만든다. - 켜고 끄는 플랫폼 기능 = ② 별도 leaf, capability 기준 7개. -- sample-portfolio는 기법 참고용이지 배치 예시가 아니다. diff --git a/docs/manual/04-persistence.md b/docs/manual/04-persistence.md index 70195ca0..cf10e492 100644 --- a/docs/manual/04-persistence.md +++ b/docs/manual/04-persistence.md @@ -31,7 +31,7 @@ use case ── tx.inWrite ──▶ XRepository (domain 포트) adapter는 호출자 트랜잭션 밖의 호출을 거부하므로(아래 「트랜잭션 안에서만 쓴다」), 계약의 `inTransaction(Supplier)`을 재정의해 거기서 트랜잭션을 열고 커밋한다. 계약은 모든 저장소 호출을 그 hook으로 부른다. fake는 기본값(그냥 실행)을 쓴다. - 예: `src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterContractTest.java`. + 예: `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/operation/JpaDurableOperationStoreContractTest.java`. 5. adapter를 bean으로 등록하는 자동 설정을 쓰고, 기능의 `XConfig`에 `afterName`으로 그 순서를 적는다. ## 판단: 저장 adapter를 둘 leaf @@ -44,7 +44,6 @@ use case ── tx.inWrite ──▶ XRepository (domain 포트) ("모듈을 아는 곳은 모듈 자신뿐")을 어기고, ② 그 leaf의 공개 API 기준선 (`docs/architecture/jpa-api-surface.txt`)과 엔티티 scan 목록(`PersistenceJpaConfig`, `PersistenceEntityScanCoverageTest`)을 고쳐야 하며, ③ upstream 병합 충돌 면이 넓어진다. - sample은 자기 leaf 안에 adapter를 둔다(③ 수직 슬라이스라서). - 새 leaf는 `modules.json` 등록, lockfile 생성, `app-bootstrap/build.gradle` 한 줄이 필요하다(10장). ## 엔티티 매핑 @@ -80,22 +79,22 @@ store는 자기 트랜잭션을 열지 않는다. 유스케이스가 연 트랜 - 중복 금지 → 유일성 제약/인덱스. 유스케이스의 사전 조회(`existsBy…`)는 빠른 거절일 뿐이다. READ COMMITTED에서 두 요청이 모두 "없음"을 보고 둘 다 insert한다. - adapter가 그 **이름 붙은 제약**의 위반만 잡아 기능 예외로 바꾼다. 다른 제약 위반은 그대로 둔다. - 예: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapter.java` - (`DataIntegrityViolationException` → 제약 이름 확인 → `PosterTitleAlreadyExistsException` 409), - 제약은 `src/sample-portfolio/src/main/resources/db/sample-migration/V8_1__poster_title_unique.sql`. + 순서는 `DataIntegrityViolationException`을 잡는다 → 원인의 제약 이름이 그 제약인지 본다 → 맞으면 + 기능 예외(예: `TitleAlreadyExistsException`, 409)를 던지고, 아니면 다시 던진다. 템플릿 코드에는 이 + 모양의 예가 없다. 확인은 아래 공유 계약 테스트와 동시성 테스트로 한다. - **충돌을 바꾸는 곳은 하나다.** 업무 규칙 충돌(같은 제목)은 포트 옆 domain 패키지의 예외 타입이고, 포트가 `@throws`로 선언하고 adapter가 던진다. 유스케이스의 사전 조회도 같은 타입을 던져 두 경로가 같은 409가 된다. application 예외를 domain 포트가 Javadoc으로만 가리키면 fake·mock은 그 약속을 지킬 수 없다. 기술 충돌(버전 불일치·교착)은 adapter가 프레임워크 예외 그대로 두고 아래 `PersistenceExceptionTranslator`가 - `DB_*` 코드로 바꾼다(WorkLog의 `ObjectOptimisticLockingFailureException` → `DB_OPTIMISTIC_CONFLICT`). + `DB_*` 코드로 바꾼다(`ObjectOptimisticLockingFailureException` → `DB_OPTIMISTIC_CONFLICT`). - 그 약속은 포트 소유자 testFixtures의 공유 계약 테스트로 고정한다. fake와 adapter가 같은 계약을 상속한다. - 예: `PosterRepositoryContract`(`InMemoryPosterRepository`, `PosterRepositoryAdapterContractTest`). + 예: `DurableOperationStoreContract`(`InMemoryDurableOperationStore`, `JpaDurableOperationStoreContractTest`). - 여러 인스턴스가 집는 작업 → `FOR UPDATE SKIP LOCKED`는 **트랜잭션 안에서**, 그리고 lease(만료 시각)와 fence 값을 함께 저장한다. 예: `ReconciliationJobStorePort.claimDue`(application-notification), gRPC operation ledger의 claim. - - 수정 충돌 → 버전 열(낙관적 잠금). 예: `UpdateWorkLogUseCase`의 version 비교와 `@Version`. + - 수정 충돌 → 버전 열(낙관적 잠금). 예: `DurableOperationEntity`(persistence-jpa)의 `@Version` 열 `row_version`. - **예외**: DB가 볼 수 없는 규칙(외부 시스템 상태)은 분산 락(`DistributedLockPort`)이나 멱등성 키(05장). -- 동시성 테스트는 실 DB lane에서 동시 요청 N개 → 행 1개를 단언한다(sample `integrationTest` 참고). +- 동시성 테스트는 실 DB lane에서 동시 요청 N개 → 행 1개를 단언한다. ## 기술 실패는 공통 코드로 나간다 @@ -110,14 +109,11 @@ SQLState 표를 복사하지 않는다. ```text 템플릿 운영 스트림 classpath:db/migration/postgresql V1 … V19 … (upstream이 계속 늘린다) capability 스트림 db/migration/jpa/ 각자 history table -샘플 스트림 db/sample-migration flyway_sample_schema_history 서비스 스트림(권장) db/migration/ flyway__schema_history ``` - **고르는 기준**: upstream 템플릿을 계속 받을 것인가. - **기본값**: 서비스 마이그레이션은 **자기 위치 + 자기 history table** 스트림에 둔다. 모양은 - `SamplePostgreSqlPersistenceConfig.sampleMigrationStrategy` - (`src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java`)와 `NotificationSchemaStream`(persistence-notification). 그러면 번호가 템플릿 스트림과 독립이라 V1부터 쓴다. 자기 스트림의 Flyway는 `Flyway.configure()`가 아니라 `FlywaySchemaPolicy.configure()`(persistence-jpa)로 만든다. Flyway의 PostgreSQL 잠금을 세션에 두어야 `CREATE INDEX CONCURRENTLY` 마이그레이션이 끝난다. @@ -128,21 +124,20 @@ capability 스트림 db/migration/jpa/ 각자 histor 겹친다. 어쩔 수 없으면 upstream이 쓰지 않을 큰 번호대를 정해 문서에 적는다. - 이미 적용된 파일은 고치지 않는다. 고치면 체크섬 불일치로 기동이 멈추고, `repair`는 쓰지 않는다 (`docs/jpa/migration-guide.md`). -- 같은 스트림 안에서 기존 두 버전 사이에 끼워야 하면 소수 버전(`V8_1`)을 쓴다. 샘플 테스트 일부가 운영 - 스트림과 샘플 스트림을 한 목록으로 합치는데, 정수 V9 이상은 운영이 이미 쓰고 있어서 2026-11-01 샘플에 - 포스터 제목 유일 제약을 더할 때 `V8_1`을 골랐다. -- 기존 데이터가 새 제약을 어기면 마이그레이션이 이유를 남기고 멈추게 쓴다(`V8_1`의 `DO $$` 블록). 조용히 +- 같은 스트림 안에서 기존 두 버전 사이에 끼워야 하면 소수 버전(`V8_1`)을 쓴다. 두 스트림을 한 목록으로 + 합쳐 검사하는 테스트가 있으면, 다른 스트림이 이미 쓴 정수 번호를 피하려고 이렇게 끼운다. +- 기존 데이터가 새 제약을 어기면 마이그레이션이 이유를 남기고 멈추게 쓴다(`DO $$` 블록의 `RAISE EXCEPTION`). 조용히 지우지 않는다. - 운영 중인 테이블을 잠그는 문장(`ALTER TABLE`, `CONCURRENTLY` 없는 `CREATE INDEX`, `UPDATE`·`DELETE`, 기존 테이블을 가리키는 `REFERENCES`, trigger 만들기·지우기 등 — 전체 목록은 `docs/jpa/migration-guide.md`)이 있으면 - 그 앞에 `SET LOCAL lock_timeout = '5s';`를 둔다(`V8_1`, `V22`). 값은 0이 아니어야 하고, + 그 앞에 `SET LOCAL lock_timeout = '5s';`를 둔다(`V22`). 값은 0이 아니어야 하고, `executeInTransaction=false` 마이그레이션에서는 `SET LOCAL`이 효과가 없으니 잠그는 문장을 거기 두지 않는다. Flyway가 스스로 트랜잭션 밖에서 돌리는 문장(`VACUUM`, `CREATE INDEX CONCURRENTLY` 등 — 목록은 같은 가이드)이 하나라도 있는 파일도 트랜잭션 밖에서 돌므로, 그런 문장은 따로 한 파일에 둔다. `VACUUM FULL`처럼 트랜잭션 안에서 돌 수 없는 잠금 문장은 상한을 걸 수 없으니 마이그레이션에 두지 않고 운영 절차로 돌린다. 상한이 없으면 그 테이블을 건드린 열린 트랜잭션 하나(`ALTER TABLE`이면 읽기만 한 것도) 뒤에서 마이그레이션이 끝없이 기다리고, 그동안 뒤에 온 그 테이블의 쓰기(`ALTER TABLE`이면 읽기까지)가 모두 마이그레이션 뒤에 줄을 선다. 상한이 있으면 5초 뒤 실패·롤백되고 새 버전이 뜨지 않을 뿐이다. 자기 스트림에도 - `SampleMigrationLockWaitTest`처럼 `LockWaitMigrationInspector`(persistence-jpa testkit) 검사를 둔다 + `MigrationLockWaitTest`(persistence-jpa)처럼 `LockWaitMigrationInspector`(persistence-jpa testkit) 검사를 둔다 (`docs/jpa/migration-guide.md` "Bound the lock wait"). ## 지금 이해하면 되는 것 diff --git a/docs/manual/05-idempotency.md b/docs/manual/05-idempotency.md index 45b62dd5..25280c6c 100644 --- a/docs/manual/05-idempotency.md +++ b/docs/manual/05-idempotency.md @@ -40,8 +40,9 @@ DB 커밋 중 연결 끊김 ───────────────── 5. 저장소 provider를 고른다: `app.capabilities.idempotency.provider` = `postgresql` 또는 `redis` (기본 `disabled`). 운영에서 in-memory 금지. -예: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/` 의 -`PosterImagePublicationController`(키 헤더 검증), 유스케이스 쪽은 sample `application/posterimage`. +예: 키 헤더 검증은 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/http/IdempotencyKeyHeader.java`, +executor 조립과 실제 PostgreSQL 저장소 왕복은 `PostgreSqlIdempotencyProviderIntegrationTest`(app-bootstrap +`integrationTest`)다. KEYED 유스케이스를 HTTP부터 끝까지 이은 업무 기능 예는 템플릿에 없다. ## 클라이언트에게 무엇을 약속하나 diff --git a/docs/manual/06-errors.md b/docs/manual/06-errors.md index 20a36e35..5f59d9f5 100644 --- a/docs/manual/06-errors.md +++ b/docs/manual/06-errors.md @@ -26,9 +26,7 @@ gRPC/GraphQL/WebSocket: 같은 ApiErrorCarrier를 자기 status 모양으로 - **기본값**: application 기능 패키지의 `XErrorCode implements ApiErrorCode` enum + 예외가 `ApiErrorCarrier` 구현. 전송마다 핸들러를 만들 필요가 없다. 생성 명령 출력이 이 모양이다 (`ErrorCode`, `NotFoundException`, `RejectedException`). -- **예외**: 한 전송에서만 의미가 있는 실패(HTTP 헤더 형식 등)는 그 전송 adapter에 둔다. sample은 기능 - 코드를 web 패키지(`PortfolioErrorCode`, `DomainExceptionHandler`)에 두는데, 한 leaf 수직 샘플이라 - 가능한 모양이다. 따라 하지 않는다. +- **예외**: 한 전송에서만 의미가 있는 실패(HTTP 헤더 형식 등)는 그 전송 adapter에 둔다. ## 판단: 어떤 예외 타입으로 던지나 @@ -58,8 +56,8 @@ gRPC/GraphQL/WebSocket: 같은 ApiErrorCarrier를 자기 status 모양으로 - 템플릿 운영 코드: `OperationalError` + `docs/registries/error-codes.yaml`을 같은 변경에서 고친다. `ErrorCodeRegistryMappingTest`(app-bootstrap)가 status 일치를 검사한다. - 서비스 기능 코드: 그 registry에 넣지 않는다(registry 머리말 "Product/fork ApiErrorCode enums own local - registries"). 서비스 자기 registry를 만들고 같은 모양의 대조 테스트를 둔다. 예: - `src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/error/PortfolioErrorCodeRegistryMappingTest.java`. + registries"). 서비스 자기 registry를 만들고 같은 모양의 대조 테스트를 둔다. 모양은 위 + `ErrorCodeRegistryMappingTest`(`src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java`)다. ## 지금 이해하면 되는 것 diff --git a/docs/manual/07-authorization.md b/docs/manual/07-authorization.md index 0dc62084..4f56ff53 100644 --- a/docs/manual/07-authorization.md +++ b/docs/manual/07-authorization.md @@ -25,8 +25,8 @@ | 프록시 가능 | `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/authz/RequiresPermissionProxyabilityTest.java` | 검사 자동 설정은 인증 체인(`WebSecurityAutoConfiguration`)과 **분리**되어 있다. 서비스가 자기 인증 -방식으로 인증 체인을 바꿔도 권한 검사는 꺼지지 않는다(2026-11-01부터. 전에는 샘플이 인증 체인 자동 설정을 -빼자 권한 검사도 함께 빠졌다). +방식으로 인증 체인을 바꿔도 권한 검사는 꺼지지 않는다(2026-11-01부터. 전에는 인증 체인 자동 설정을 빼면 +권한 검사도 함께 빠졌다). ### 지켜야 할 것 셋 diff --git a/docs/manual/08-testing.md b/docs/manual/08-testing.md index 738ae979..ae0560a5 100644 --- a/docs/manual/08-testing.md +++ b/docs/manual/08-testing.md @@ -62,7 +62,7 @@ lane으로 선언하고 단계를 지정한다. 선언은 `ca.strict-test-lane`( | 성능·부하 | performance 범주 | `performanceCheck` | | 외부 입력 필요(자격증명 등) | `explicitOnly(reason)` | 어떤 집계에도 안 들어가고 이유가 출력된다 | -예: `src/sample-portfolio/build.gradle`의 `strictTestLanes { lane('integrationTest') { integration() … } }`, +예: `src/app-bootstrap/build.gradle`의 `strictTestLanes { lane('integrationTest') { integration() … } }`, `src/app-bootstrap/build.gradle`의 `publicPathSnapshotTest`(`mainStage()`). ### 판단: 새 테스트를 어느 lane에 diff --git a/docs/manual/09-outbox-events.md b/docs/manual/09-outbox-events.md index 2a208669..68affbe9 100644 --- a/docs/manual/09-outbox-events.md +++ b/docs/manual/09-outbox-events.md @@ -23,15 +23,15 @@ DB 저장과 broker 발행을 따로 하면(dual write) 둘 중 하나만 성공 ## 순서 1. 계약을 정한다: 계약 id(`..`), 버전, payload record, JSON schema 파일과 해시. - 예: `src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/worklog/WorkLogReservedContractContribution.java`, - `src/sample-portfolio/src/main/resources/contracts/messaging/portfolio.worklog.reserved/v1.schema.json`(+ `.sha256`). + 예: `src/application-core/src/main/java/dev/caskeleton/application/operation/DurableOperationSubmittedContract.java`, + `src/application-core/src/main/resources/contracts/messaging/durable-operation.submitted/v1.schema.json`(해시는 계약 클래스 안). 2. payload record(`IntegrationPayload`)를 만든다. 3. 유스케이스의 `tx.inWrite` 안에서 저장 뒤 draft → encode → append. 예: - `CreateWorkLogUseCase`(sample)와 그 헬퍼 `PortfolioEventOutbox`. + `SubmitDurableOperationUseCase`(application-core `operation`). 4. 계약 contribution을 조립에서 `@Bean`으로 등록한다. encoder는 컨텍스트의 계약 bean으로 만들어진다. 등록을 빠뜨리면 append 때 실패한다. 예: `DurableOperationAutoConfiguration.durableOperationSubmittedContract()`. 5. 테스트: 계약 contribution 테스트(해시 고정), 유스케이스가 append했는지(`InMemoryOutboxStore`), - 소비자 중복 제거 계약(sample `WorkLogReservedConsumerDedupeContractTest`). + 소비자가 있으면 같은 event id를 두 번 받아도 효과가 한 번인지 보는 중복 제거 계약. 6. schema를 출시한다: `src/test/resources/contracts/released-payload-schemas.sha256`에 새 version 파일의 해시를 한 줄 더한다. 출시한 version 파일은 고치지 않는다 — 바뀌면 `ReleasedPayloadSchemaContract` 테스트가 실패한다. 필드를 바꾸는 변경은 새 version으로 낸다. 절차: `src/application-core/README.md` @@ -44,7 +44,7 @@ DB 저장과 broker 발행을 따로 하면(dual write) 둘 중 하나만 성공 - **고르는 기준**: 같은 서비스 안에서 이 사실에 반응하는 코드가 있는가. - **기본값**: 통합 이벤트만. 유스케이스가 저장 뒤 바로 payload를 만든다. - **예외**: aggregate 안에서 일어난 사실을 여러 유스케이스가 같은 방식으로 내보내면 domain - `@DomainEvent` record를 두고 유스케이스가 그것을 payload로 옮긴다(sample `WorkLogReserved`). + `@DomainEvent` record를 두고 유스케이스가 그것을 payload로 옮긴다. ### payload에 무엇을 넣나 @@ -57,7 +57,7 @@ draft는 `IntegrationEventDrafts.draft(contract, eventId, aggregate, order, occu 만든다(`src/application-core/src/main/java/dev/caskeleton/application/messaging/event/IntegrationEventDrafts.java`). 계약 id·payload 버전·목적지는 계약에서 오고, 기능이 정하는 것은 aggregate·순서·payload뿐이다. `new IntegrationEventDraft<>(…)`를 직접 쓰면 빌드가 막는다(`INTEGRATION_EVENT_DRAFTS_ARE_BUILT_BY_THE_SHARED_HELPER`). -예: sample `PortfolioEventOutbox`, `SubmitDurableOperationUseCase`. +예: `SubmitDurableOperationUseCase`. - event id: 정규 소문자 UUIDv7, 소비자 중복 제거 키. draft(`IntegrationEventDraft`)가 다른 값(대문자, v4, `event-1` 같은 문자열)을 거부하므로 업무 쓰기에서 바로 실패한다 — 커밋된 뒤 relay에서 DEAD가 되지 diff --git a/docs/manual/README.md b/docs/manual/README.md index ea2ce530..47d7cc38 100644 --- a/docs/manual/README.md +++ b/docs/manual/README.md @@ -55,13 +55,13 @@ ## 따라 할 예시는 하나 -예시가 셋(sample-portfolio 수직, onboarding fixture, durable operation)이라 어느 것을 베끼느냐에 따라 -배치가 달라졌다(2026-11-01 성숙도 리뷰). 이제 **새 업무 기능의 예시는 생성 명령의 출력 하나**다. +예시가 셋(한 leaf에 모든 계층을 둔 샘플 모듈, onboarding fixture, durable operation)이라 어느 것을 베끼느냐에 따라 +배치가 달라졌다(2026-11-01 성숙도 리뷰). 이제 **새 업무 기능의 예시는 생성 명령의 출력 하나**다. 샘플 모듈은 +2026-11-07에 지웠다. | 코드 | 역할 | 따라 하나 | | --- | --- | --- | | `scripts/new-feature.sh` 출력 | 계층 leaf에 나눈 업무 기능 | **이것을 따른다** | -| `src/sample-portfolio` | 한 leaf에 모든 계층을 둔 지울 수 있는 샘플. 개별 기법(조건부 PATCH, 페이지, outbox, DB 유일성 제약)의 참고 | 기법만 본다. 배치는 따르지 않는다 | | `src/app-bootstrap/src/test/java/dev/caskeleton/onboarding/**` | ArchUnit 규칙이 새 기능 모양에 적용되는지 확인하는 테스트 fixture | 따르지 않는다 | | `application-core/.../operation` + `DurableOperationAutoConfiguration`(composition:durable-operation) | 템플릿 플랫폼 기능 | 조립 모양(`@ConditionalOnBean` + 유스케이스 `@Bean`)만 본다 | @@ -74,12 +74,12 @@ | Envelope는 null 필드를 내보내지 않는다 | `docs/web/http-contract.md` 1절 | 06 | | 처리 중 409 `IDEMPOTENT_IN_FLIGHT`는 `retryable=true` + `Retry-After: 2`, 같은 키로 재전송 | `docs/web/http-contract.md` 2절 | 05 | | 커밋 중 연결이 끊기면 재시도 가능이 아니라 결과 불명(`DB_COMPLETION_UNKNOWN`, 500) | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/failure/PersistenceExceptionTranslator.java`, `docs/adr/ADR-JPA-003-completion-unknown.md` | 05 | -| 중복 규칙은 조회 후 insert가 아니라 DB 유일성 제약, 위반은 같은 409로 변환 | `src/sample-portfolio/src/main/resources/db/sample-migration/V8_1__poster_title_unique.sql`, `PosterRepositoryAdapter` | 04 | +| 중복 규칙은 조회 후 insert가 아니라 DB 유일성 제약, 위반은 같은 409로 변환 | 04장 「중복·경쟁은 DB가 막는다」(템플릿 코드에 예 없음) | 04 | | 여러 인스턴스가 집는 작업은 lease 있는 claim | `ReconciliationJobStorePort.claimDue`(application-notification) | 04 | | 양방향 연관관계 금지를 ArchUnit으로 | `JpaArchitectureRules.associationsAreMappedFromOneSideOnly()` | 04 | | store는 호출자 트랜잭션을 요구한다 | `src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/CallerTransaction.java` | 04 | | `@RequiresPermission` 검사는 인증 체인과 분리된 자동 설정 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebMethodSecurityAutoConfiguration.java` | 07 | | JWT audience 필수, 자기 client role만 | `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/auth/JwtDecoderConfig.java`, `docs/runbooks/auth-audience-mismatch.md` | 07 | | strict lane은 반드시 어떤 단계에 속한다 | `verifyStrictLaneStages`(`src/build.gradle` `strictLaneStages`) | 08 | -| 샘플 마이그레이션은 별도 history table, 번호는 운영과 겹치지 않게 | `SamplePostgreSqlPersistenceConfig`, `V8_1__…` | 04 | +| 서비스 마이그레이션은 별도 history table, 번호는 운영과 겹치지 않게 | `NotificationSchemaStream`(persistence-notification) | 04 | | 재시도 가능한 broker 거부는 DEAD가 아니라 재시도 | `docs/runbooks/outbox-dead-letter.md` | 09 | diff --git a/docs/registries/env-keys.yaml b/docs/registries/env-keys.yaml index 954205da..3c5e8954 100644 --- a/docs/registries/env-keys.yaml +++ b/docs/registries/env-keys.yaml @@ -2631,8 +2631,8 @@ env_keys: required_test: cache-contract:redis-soft-hard-ttl-order - name: APP_CACHE_REDIS_TTL_JITTER - # DEPRECATED 2026-11-02: no settings class binds it. Its only reader was a block in - # sample-portfolio's application.yml that nothing bound either (07-10), removed with it. + # DEPRECATED 2026-11-02: no settings class binds it. Its only reader was a block in the + # sample module's application.yml that nothing bound either (07-10), removed with it. # Kept so a deployment still setting it is told it does nothing. deprecated_orphaned: true removal_deadline: 2027-02-28 diff --git a/docs/runbooks/outbox-dead-letter.md b/docs/runbooks/outbox-dead-letter.md index 0e6b4375..4799c29c 100644 --- a/docs/runbooks/outbox-dead-letter.md +++ b/docs/runbooks/outbox-dead-letter.md @@ -152,7 +152,7 @@ rolling 중 옛 버전이 방금 쓴 번호(floor보다 초당 10⁶씩 큰 벽 소비자는 그 사이 새 이벤트를 버린다. 그래서 **tenant scope를 바꾸는 배포는 rolling으로 하지 않는다**: 옛 버전 인스턴스를 모두 멈춘 뒤(옛·새 버전이 함께 쓰는 구간 없이) 새 버전을 띄운다. -tenant scope를 바꾼 서비스(샘플은 `portfolio` → 단일 scope)는 배포 전에 옛 scope의 미발행 행이 +tenant scope를 바꾼 서비스(예: 기능별 scope → 단일 scope)는 배포 전에 옛 scope의 미발행 행이 없는지 확인한다. 옛 scope 행과 새 scope 행은 서로 다른 aggregate로 보여 claim gate가 서로를 막지 않고, partition key도 달라 다른 partition으로 간다. @@ -252,7 +252,7 @@ COMMIT; ``` Step 1을 다시 돌려 0행이면 배포한다. 정리와 배포 사이에 옛 버전이 새 중복을 만들 수 있다(벽시계로 -순서 번호를 만든 샘플 코드가 그 원인이었다). 그래도 V21은 실패하고 롤백될 뿐이니 Step 1부터 다시 한다. +순서 번호를 만든 옛 코드가 그 원인이었다). 그래도 V21은 실패하고 롤백될 뿐이니 Step 1부터 다시 한다. `outbox_event_v21_duplicates`는 확인이 끝나면 지운다. 확인 쿼리, 정리 SQL, Step 0의 인덱스 SQL은 이 문서에서 그대로 읽어 실제 PostgreSQL에서 실행하는 diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index b0398c6c..79dd2d15 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -4,7 +4,7 @@ - 커밋: `34565130` High·P1 19건 · `1400dc15` 남은 발견·매뉴얼·생성 명령 · `5786126c` 남은 항목과 합친 뒤 결함 · `7ef8d0b4` 재리뷰 기록 · `bbe944bd` 재리뷰 결함 · `ecc74b7d` 2차 재리뷰 기록·이 안내 · `1885bf8d` 2차 재리뷰 결함 · `339cf8fd` 3차 확인 리뷰 기록 · `f40c03c6` 3차 확인 리뷰 Minor · `c2e55510` 마지막 확인 리뷰 기록 · - `2678955c` 테스트 코드 정적 분석(B-40) · `70fb80bf` 소유자가 다시 정한 기본값 3가지(늦은 멱등 완료 기록, `failure-retention` 기동 검사, workflow `cd`) · B4 성능 lane 단언 상시화(2026-11-06, B-43) · `paths` 필터 trigger를 단계 실행으로 세지 않음(2026-11-06 소유자 결정, B-36) · r8-f1 전송 오류 처리(2026-11-07, B-45~B-48) · r9-g1 GraphQL 판정 순서와 인자 변환 단계(2026-11-07 소유자 결정, B-45·B-46) · 태그 push·`release` workflow는 `releaseCheck`에만 셈(2026-11-07 소유자 결정, B-36) · 실패한 동시 인덱스 drop의 복구 절차(2026-11-07, 재리뷰 RR8-03-01, 5절) · STOMP channel interceptor를 사용자 전송으로 셈(2026-11-07, B-16) · 멱등 저장소의 markFailed 재전송 인자와 renew 뒤 start(2026-11-07 소유자 결정, 5절) — `docs(...)` 커밋은 문서만 바꾼다 + `2678955c` 테스트 코드 정적 분석(B-40) · `70fb80bf` 소유자가 다시 정한 기본값 3가지(늦은 멱등 완료 기록, `failure-retention` 기동 검사, workflow `cd`) · B4 성능 lane 단언 상시화(2026-11-06, B-43) · `paths` 필터 trigger를 단계 실행으로 세지 않음(2026-11-06 소유자 결정, B-36) · r8-f1 전송 오류 처리(2026-11-07, B-45~B-48) · r9-g1 GraphQL 판정 순서와 인자 변환 단계(2026-11-07 소유자 결정, B-45·B-46) · 태그 push·`release` workflow는 `releaseCheck`에만 셈(2026-11-07 소유자 결정, B-36) · 실패한 동시 인덱스 drop의 복구 절차(2026-11-07, 재리뷰 RR8-03-01, 5절) · STOMP channel interceptor를 사용자 전송으로 셈(2026-11-07, B-16) · 멱등 저장소의 markFailed 재전송 인자와 renew 뒤 start(2026-11-07 소유자 결정, 5절) · 저장소 구조 정리(2026-11-07 소유자 결정, 3.6절 B-49~) — `docs(...)` 커밋은 문서만 바꾼다 - 근거 문서: `docs/reviews/2026-11-01-maturity-review/README.md` 13~16절, `docs/reviews/2026-11-03-rereview/README.md` 4·6·8~13절, 각 커밋의 `BREAKING CHANGE:` 꼬리말 - 아래 표의 각 줄은 위 범위의 diff와 코드로 확인했다. 확인하지 못한 것은 그 자리에 "확인 못 함"으로 적었고 9절에 @@ -60,7 +60,7 @@ | B-05 | 알림: `ReconciliationJobStorePort.claimDue(int, Instant)` → `claimDue(int limit, Instant now, Duration lease)`. `ReconciliationJob`에 `long claimFence` 필드 추가. `reschedule`·`complete`는 fence가 다르면 아무것도 안 바꾼다 | 직접 구현한 store·job 생성 코드 컴파일 오류 | lease 인자를 받고, claim마다 fence를 올리고, 쓰기에 fence 조건을 건다. 계약은 `application-notification` testFixtures의 공유 계약 테스트로 확인 | `34565130`, `bbe944bd` · `src/application-notification/.../dispatch/ReconciliationJobStorePort.java` | | B-06 | 파일 서버: `CleanupQueuePort.claimDue(Instant, int)` → `claimDue(Instant, int, Duration lease)`, `markAbandoned(CleanupItem, String reasonCode)` 추가. `CleanupItem`에 `UUID claimToken` 필드 추가. `FileQuotaPort.usedBytes(QuotaScope)` 추가. `UploadContentPort.releaseLease(UploadSession, RequestContext)` 삭제 | 직접 구현한 포트·`CleanupItem` 생성 코드 컴파일 오류 | 새 메서드 구현, `releaseLease` 호출 제거 | `1400dc15`(cleanup), `5786126c`(quota·upload) · `src/application-fileserver/.../cleanup/CleanupQueuePort.java`, `.../api/metadata/FileQuotaPort.java`, `.../upload/UploadContentPort.java` | | B-07 | 패키지 이동: `dev.caskeleton.application.outbound.SecretSourcePort`·`SecretReference` → `dev.caskeleton.application.secret.*`. `dev.caskeleton.application.outbound.CallBudget` → `dev.caskeleton.application.objectstorage.content.CallBudget`(leaf `application-objectstorage`). `application.outbound` 패키지 삭제 | `package dev.caskeleton.application.outbound does not exist` | import를 바꾼다. `CallBudget`을 쓰는 leaf가 `application-objectstorage`에 의존해도 되는지 `modules.json` 간선을 확인 | `5786126c` · `src/application-core/.../secret/`, `src/application-objectstorage/.../content/CallBudget.java` | -| B-08 | `shared-contract`에서 `dev.caskeleton.shared.operation.Operation`·`OperationStatus` 삭제. sample-portfolio(`...sample.portfolio.adapter.inbound.web.operation`)로 옮겨졌다 | import 실패 | 쓰고 있었다면 자기 inbound adapter로 복사한다 | `1400dc15` · `src/shared-contract/src/main/java/dev/caskeleton/shared/operation/`(삭제) | +| B-08 | `shared-contract`에서 `dev.caskeleton.shared.operation.Operation`·`OperationStatus` 삭제. 샘플 모듈로 옮겼다가 샘플과 함께 지웠다(B-49) | import 실패 | 쓰고 있었다면 자기 inbound adapter로 복사한다 | `1400dc15` · `src/shared-contract/src/main/java/dev/caskeleton/shared/operation/`(삭제) | | B-09 | `SecuritySettings`(adapter:inbound:web): `audience`가 `String` → `List`. `@ConfigurationProperties` 제거, `SecuritySettings.bind(Environment)`로 strict 바인딩. 생성자 `(String, String, List)` → `(String, List, List)`. `bootstrap.security.AuthenticationModeSettings` 삭제 | `audience()`를 문자열로 쓰는 코드, 직접 생성하는 테스트 컴파일 오류 | `List`으로 바꾼다. 인증 모드는 `SecuritySettings.authMode()`에서 읽는다 | `34565130`(List), `5786126c`(strict·삭제) · `src/adapter/inbound/web/.../settings/SecuritySettings.java` | | B-10 | adapter 공개 타입 삭제·이동: graphql `execution.GraphQlTimeoutPolicy`·`dataloader.GraphQlDataLoaderRequestRegistry` 삭제(`runtime.GraphQlDeadlineInstrumentation`·`GraphQlPerParentFetchInstrumentation` 추가). jpa `experimental.tenant.TenantId` 삭제 → `dev.caskeleton.application.tenant.TenantId`. persistence-notification의 엔티티는 `...platform.entity`, 저장소는 `...platform.repository`로 이동, `inbox` 하위 클래스는 `platform`으로 올라옴, `PreferenceJpaRepository`·`SuppressionJpaRepository` 삭제, `JpaNotificationSideEffect` → application-notification `dispatch.SuppressionSideEffect`. graphql `GraphQlClientPolicy.effectivePageSize(Integer, Integer)` 삭제 → `pagination.GraphQlConnectionPolicy.effectivePageSize`(상한 검사 포함, 재리뷰 RR-01-14). grpc(optional-platforms) `GrpcOperationLedger.release(identity)` → `boolean release(identity, GrpcClaimToken)`: 진행 중이고 그 token이 가진 claim만 지운다(RR-01-15) | import 실패, 호출부·직접 구현한 ledger 컴파일 오류. leaf `check`의 API surface 비교가 스냅샷과 달라 실패(자기 공개 타입을 더했다면 merge 충돌) | import를 바꾼다. 스냅샷 파일은 upstream 것을 받고 자기 추가분을 다시 승인한다 | `1400dc15`·`5786126c` · `docs/architecture/graphql-api-surface.txt`, `docs/architecture/jpa-api-surface.txt`(166→165), `docs/notification/api-surface-snapshot.txt`(362→364) | | B-11 | 조립·지원 타입: `bootstrap.autoconfigure.operation.DurableOperationConfig` → `composition:durable-operation`의 `composition.operation.DurableOperationAutoConfiguration`. `bootstrap.settings.LoggingSettings` 삭제. `composition.outbox.OutboxLeaderElectionToken` 삭제. `TracingSamplingEnvironmentPostProcessor` → `TracingEnvironmentPostProcessor`, `StartupOrder.TRACING_SAMPLING` → `TRACING_PROPERTIES`. `StartupRuleRunner(Environment, List)` → `StartupRuleRunner(Environment)`. `SecretSourceValidator(ConfigurableEnvironment, SecretSourcePort, List)` → `SecretSourceValidator(Supplier>)` | 이 타입을 참조하는 코드·테스트 컴파일 오류 | 새 이름으로 바꾼다 | `1400dc15`, `34565130`, `bbe944bd` · `src/composition/durable-operation/`, `src/adapter/outbound/support/.../startup/` | @@ -86,7 +86,7 @@ | B-24 | `APP_IDEMPOTENCY_PROCESSING_LEASE`는 2초(`IdempotencyExecutor.IN_FLIGHT_RETRY_AFTER`)보다 길어야 한다. `APP_IDEMPOTENCY_TTL`(replay TTL)은 그 lease보다 짧으면 안 된다(재리뷰 RR-03-11). `APP_IDEMPOTENCY_FAILURE_RETENTION`은 replay TTL보다 짧으면 안 된다(RR3-03-02) | 2초 이하면, replay TTL < lease면, 또는 failure retention < replay TTL이면 기동 실패(exit 78). 마지막은 메시지에 `failure-retention`·`replay-ttl` 두 키와 값이 나온다 | lease를 2초보다 길게(기본 30s), replay TTL을 lease 이상으로(기본 24h), failure retention을 replay TTL 이상으로(기본 24h — 기본값끼리는 그대로 뜬다) | `5786126c`, `bbe944bd`, 3차 수정, `70fb80bf`(2026-11-04 소유자 결정) · `src/composition/idempotency/.../IdempotencySettings.java` | | B-25 | 알림 콜백 본문 상한 65508 → 65251(바인딩에서 상한 검사) | `.env`에 옛 예제 값 `APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES=65508`이 있으면 기동 실패 `max-body-bytes must be 1..65251` | 값을 지우거나 65251 이하로 | `5786126c` · `src/adapter/outbound/notification/.../autoconfigure/NotificationPlatformSettings.java` | | B-26 | `config/module-defaults/`에 같은 이름 파일이 둘이거나, 두 파일이 같은 키를 실으면 기동 실패 | 기동 실패 `two capability modules ship config/module-defaults/` 또는 `... both ship `(exit 78) | 자기 leaf의 module-defaults 파일 이름·키가 템플릿 모듈과 겹치지 않게 한다 | `1400dc15` · `src/adapter/outbound/support/.../startup/ModuleDefaultsEnvironmentPostProcessor.java` | -| B-27 | (sample-portfolio를 남겨 둔 경우) 데모 계정은 활성 프로필이 모두 `local`·`test`·`demo` 중 하나일 때만. 프로필이 없어도 거부 | 기동 실패 `the sample's demo accounts authenticate only under the local, test or demo profile` | `SPRING_PROFILES_ACTIVE=demo`(이미지·jar), `local`(bootRun)로 띄우거나 sample 보안 설정을 지운다. 세 프로필 모두 sample `application.yml`이 object storage를 끈다(RR2-04-02) | `5786126c`, `bbe944bd` · `src/sample-portfolio/.../security/SampleDemoAccountsProductionGuard.java` | +| B-27 | **샘플 삭제(B-49)로 템플릿에서 사라졌다. 받을 변경이 없다.** (sample-portfolio를 남겨 둔 경우) 데모 계정은 활성 프로필이 모두 `local`·`test`·`demo` 중 하나일 때만. 프로필이 없어도 거부 | 기동 실패 `the sample's demo accounts authenticate only under the local, test or demo profile` | `SPRING_PROFILES_ACTIVE=demo`(이미지·jar), `local`(bootRun)로 띄우거나 sample 보안 설정을 지운다. 세 프로필 모두 sample `application.yml`이 object storage를 끈다(RR2-04-02) | `5786126c`, `bbe944bd` · `src/sample-portfolio/.../security/SampleDemoAccountsProductionGuard.java` | ### 3.3 HTTP wire — 응답이 달라진다 @@ -111,7 +111,7 @@ |---|---|---|---|---| | B-34 | 템플릿 패키지 규칙(ArchUnit): `FEATURE_PACKAGES_DO_NOT_REUSE_TEMPLATE_PACKAGE_NAMES`, `TEMPLATE_PACKAGES_DO_NOT_DEPEND_ON_FEATURE_PACKAGES`. 템플릿 이름: application `usecase command query capability transaction security tenant observability secret messaging outbox idempotency operation lease lock cache realtime notification fileserver objectstorage`, domain `identifier stereotype` | 기능 패키지 이름이 이 목록과 겹치거나(예: `domain.lock`), 업무 코드를 템플릿 패키지(예: `application.usecase.*`)에 두고 기능 패키지를 import하면 `:app-bootstrap:architectureTest` 실패 | 기능 패키지 이름을 바꾸고, 업무 코드를 `dev.caskeleton.application.`로 옮긴다. 규칙 정본은 `src/application-core/CLAUDE.md` "Package ownership" | `5786126c`, r9 · `src/app-bootstrap/src/test/.../TemplatePackageOwnership.java`(표와 대조: `TemplatePackageOwnershipDocumentTest`) | | B-35 | JPA 규칙: 양방향 연관은 한쪽에서만 매핑(`mappedBy`), notification·fileserver 저장소 엔티티는 그 leaf 안에서만, `@Version` 엔티티의 bulk update는 version을 올려야 함 | 위반 엔티티·쿼리가 있으면 architectureTest 실패 | 매핑·쿼리를 고친다 | `34565130`, `1400dc15`, `bbe944bd` · `src/app-bootstrap/src/architectureTest/.../JpaProductionArchitectureTest.java` | -| B-36 | 빌드 검사 강화: `modules.json`에 없는 `build.gradle`이 있으면 `verifyCleanArchitectureDependencies` 실패. `verifyStrictLaneStages --dry-run`은 모든 strict lane이 workflow가 실행하는 단계(`:ci` `:sample-portfolio:check` `:mainCheck` `:integrationCheck` `:performanceCheck` `:releaseCheck`)에 속해야 하고 `.github/workflows`를 읽는다. 명령의 빌드는 `working-directory`(단계·job·workflow `defaults`)에서 시작해 같은 `run:` 셸이 그 앞에서 실행한 `cd <상대 경로>`(`cd src && ./gradlew …`, `cd src; ./gradlew …`, 앞 줄의 `cd src`)를 따라간 뒤 `-p`를 붙인 디렉터리로 정하고(`70fb80bf`(2026-11-04 소유자 결정)), `workflow_dispatch`로만 시작하는 workflow의 명령은 세지 않으며, 축약한 `-x`도 Gradle처럼 맞춰 본다(RR2-04-04). 붙여 쓴 `-x`·`-p`도 Gradle처럼 읽는다(RR3-04-02). `run:` 스크립트를 bash 문법으로 읽고(heredoc·여러 줄 문자열·함수 본문 안의 `cd`는 따라가지 않음), 세지 않는 명령은 이유를 셋으로 나눠 적는다(r10). (1) 실패해도 단계가 실패하지 않을 수 있음: `\|\| exit <0 아닌 값>` 밖의 `\|\|`(`\|\| true` 등), pipefail 없는 파이프 왼쪽, `!`, `&`, `if`·`while` 조건, 스크립트 마지막이 아닌 `&&` 목록의 앞쪽, `set +e` 뒤, `exit 0` 하는 `EXIT`·`ERR` trap 뒤. (2) 돌지 않을 수 있음: `\|\|` 뒤, 마지막이 아닌 `&&` 목록의 뒤쪽, `if`·`while`·`for`·`case`·함수 본문 안, 최상위 `exit`·`exec <명령>`·`set -n` 뒤, 조건부이거나 부른 함수 안의 `exit 0`·인자 없는 `exit`·값을 모르는 `exit`·`exec`·`set -n` 뒤, 요청으로만 시작하는 workflow(`workflow_dispatch`·`repository_dispatch`·`issue_comment`·`types: [labeled]`인 `pull_request`·`workflow_run` 등; `push`·`pull_request`·`pull_request_target`·`merge_group`·`schedule`·`release`는 센다), change trigger가 모두 `paths`·`paths-ignore` 필터를 단 workflow(그 경로 밖 변경에는 돌지 않는다, 2026-11-06 소유자 결정), `releaseCheck` 밖의 단계에서는 태그 push(`branches` 없는 `tags`·`tags-ignore`)나 `release`로만 시작하는 workflow(2026-11-07 소유자 결정), 세는 job이 `uses: ./.github/workflows/<파일>`로 부르지 않는 `workflow_call` 재사용 workflow, 조건부이거나 `continue-on-error`인 job을 `needs`로 기다리는 job(자기 `if:`가 `always()`·`!cancelled()`면 센다). (3) 실패하면 단계도 실패하지만 검사가 읽지 않음: `\|\| exit 1`·`\|\| { …; exit 1; }`, `{ }`·`( )`·`$( )`·`bash -c` 안, 다른 명령의 인자인 `gradlew`(`timeout 60 ./gradlew`), `bash`·`sh`가 아닌 `shell:`, `shell:` 없이 Windows일 수 있는 runner(Windows 라벨, `${{ matrix.os }}` 같은 식, `linux`·`macos` 라벨 없는 self-hosted)에서 도는 단계 — 기본 셸이 `pwsh`다(Linux·macOS runner의 기본은 `bash -e`, `container:` job은 `sh -e`이고 둘은 같게 읽는다). Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-m`·`-v`·`--version`·`-h`·`-?`·`--help`·`--status`·`--stop`·`--foreground`, 묶음 `-qm`·`-qv` 포함)과 Gradle이 거부하는 짧은 옵션 묶음(`-mx`)·값을 받지 않는 옵션에 붙인 값(`-m=yes`)도 세지 않는다. 판독기의 Gradle 옵션 표는 `GradleCommandLineTest`가 build-logic을 돌리는 Gradle의 `--help`와 대조하므로, Gradle을 올려 옵션이 늘면(9.2의 `--task-graph`) 그 테스트가 실패한다. 단계를 부르지만 세지 않은 명령은 다른 빌드로 읽힌 것까지 실패 메시지에 이유와 함께 적는다(r9). `verifyEnvKeys`: lane 계약 json의 `APP_` 밖 키는 `SPRING_`·`MANAGEMENT_`·`SERVER_`이거나 `secret://…/`가 가리키는 변수여야 하고, 레지스트리 `property:` 행은 그 property가 설정 metadata에 있어야 읽히는 것으로 친다(`@ConditionalOnProperty`로만 읽는 스위치는 `META-INF/additional-spring-configuration-metadata.json`에 선언, RR2-04-05). SpotBugs 신뢰도 HIGH → MEDIUM | 등록 안 한 leaf, 단계에 안 걸린 자기 lane, 자기 코드의 MEDIUM 발견이 `ci`·`qualityCheck`를 막는다. `working-directory: src`도 `cd src`도 없이 `./gradlew`를 부르는 자기 workflow 단계는 실행으로 세지 않는다. 확실히 따라갈 수 없는 디렉터리 이동(`cd "$VAR"`, `cd -`, `cd ~`, 절대 경로, `pushd`, `if`/`for`/`case`·`{ }`·서브셸 안의 `cd`, `||`·`|`로 이은 `cd`, 다른 명령과 `&&`로 묶인 `cd` 다음 줄) 뒤의 명령도 세지 않고, 실패 메시지에 그 명령과 이유를 적는다. 단계를 `./gradlew ci \| tee log`(기본 셸), `./gradlew ci \|\| true`, `./gradlew ci \|\| exit 1`, `if ./gradlew ci; then` 같은 모양으로만 부르거나, 조건부 `exit 0` 뒤, `-v`·`--help`를 붙여, 요청형 trigger·`paths` 필터 trigger로만 시작하는 workflow·`releaseCheck`가 아닌 단계를 태그 push·`release`로만 시작하는 workflow·호출되지 않는 `workflow_call` workflow·조건부 job을 `needs`로 기다리는 job·`shell:` 없는 Windows runner에서만 부르는 자기 workflow도 실패한다 | leaf를 등록하거나 지운다. 자기 lane은 단계에 건다. 단계를 부르는 workflow 명령에 `working-directory`를 두거나 같은 셸에서 `cd <상대 경로>`로 옮긴 뒤 부른다. 단계 명령은 혼자 한 줄로 두고, 로그를 파이프로 남기려면 `shell: bash`나 앞 줄 `set -o pipefail`을 둔다. Windows runner에서는 `shell: bash`를 둔다. 단계는 매 push·pull request·schedule에 도는(`paths`·`paths-ignore` 필터 없는) workflow와 job에서(`releaseCheck`만 태그 push·`release` workflow에서), 재사용 workflow라면 그런 job이 조건 없이 부르게 한다. Gradle을 올려 `GradleCommandLineTest`가 실패하면 새 옵션을 값 옵션·플래그·작업 없이 끝나는 옵션 중 하나로 판독기 표에 넣는다. SpotBugs 발견은 고치거나 이유를 단 제외로 | `1400dc15`, `34565130`, `bbe944bd`, `5786126c`, `70fb80bf`(2026-11-04 소유자 결정), r9, r10(RR6-04-01~06), RR7-05-01(2026-11-06 소유자 결정), 태그·릴리스 workflow(2026-11-07 소유자 결정) · `src/build-logic/.../ModuleRegistry.java`, `.../strictlane/StrictLaneStagesPlugin.java`, `.../strictlane/WorkflowGradleInvocations.java`, `.../strictlane/ShellScript.java`, `.../strictlane/GradleCommandLineTest.java`(test), `.../quality/QualityConventionsPlugin.java`, `src/build.gradle` | +| B-36 | 빌드 검사 강화: `modules.json`에 없는 `build.gradle`이 있으면 `verifyCleanArchitectureDependencies` 실패. `verifyStrictLaneStages --dry-run`은 모든 strict lane이 workflow가 실행하는 단계(`:ci` `:mainCheck` `:integrationCheck` `:performanceCheck` `:releaseCheck`)에 속해야 하고 `.github/workflows`를 읽는다. 명령의 빌드는 `working-directory`(단계·job·workflow `defaults`)에서 시작해 같은 `run:` 셸이 그 앞에서 실행한 `cd <상대 경로>`(`cd src && ./gradlew …`, `cd src; ./gradlew …`, 앞 줄의 `cd src`)를 따라간 뒤 `-p`를 붙인 디렉터리로 정하고(`70fb80bf`(2026-11-04 소유자 결정)), `workflow_dispatch`로만 시작하는 workflow의 명령은 세지 않으며, 축약한 `-x`도 Gradle처럼 맞춰 본다(RR2-04-04). 붙여 쓴 `-x`·`-p`도 Gradle처럼 읽는다(RR3-04-02). `run:` 스크립트를 bash 문법으로 읽고(heredoc·여러 줄 문자열·함수 본문 안의 `cd`는 따라가지 않음), 세지 않는 명령은 이유를 셋으로 나눠 적는다(r10). (1) 실패해도 단계가 실패하지 않을 수 있음: `\|\| exit <0 아닌 값>` 밖의 `\|\|`(`\|\| true` 등), pipefail 없는 파이프 왼쪽, `!`, `&`, `if`·`while` 조건, 스크립트 마지막이 아닌 `&&` 목록의 앞쪽, `set +e` 뒤, `exit 0` 하는 `EXIT`·`ERR` trap 뒤. (2) 돌지 않을 수 있음: `\|\|` 뒤, 마지막이 아닌 `&&` 목록의 뒤쪽, `if`·`while`·`for`·`case`·함수 본문 안, 최상위 `exit`·`exec <명령>`·`set -n` 뒤, 조건부이거나 부른 함수 안의 `exit 0`·인자 없는 `exit`·값을 모르는 `exit`·`exec`·`set -n` 뒤, 요청으로만 시작하는 workflow(`workflow_dispatch`·`repository_dispatch`·`issue_comment`·`types: [labeled]`인 `pull_request`·`workflow_run` 등; `push`·`pull_request`·`pull_request_target`·`merge_group`·`schedule`·`release`는 센다), change trigger가 모두 `paths`·`paths-ignore` 필터를 단 workflow(그 경로 밖 변경에는 돌지 않는다, 2026-11-06 소유자 결정), `releaseCheck` 밖의 단계에서는 태그 push(`branches` 없는 `tags`·`tags-ignore`)나 `release`로만 시작하는 workflow(2026-11-07 소유자 결정), 세는 job이 `uses: ./.github/workflows/<파일>`로 부르지 않는 `workflow_call` 재사용 workflow, 조건부이거나 `continue-on-error`인 job을 `needs`로 기다리는 job(자기 `if:`가 `always()`·`!cancelled()`면 센다). (3) 실패하면 단계도 실패하지만 검사가 읽지 않음: `\|\| exit 1`·`\|\| { …; exit 1; }`, `{ }`·`( )`·`$( )`·`bash -c` 안, 다른 명령의 인자인 `gradlew`(`timeout 60 ./gradlew`), `bash`·`sh`가 아닌 `shell:`, `shell:` 없이 Windows일 수 있는 runner(Windows 라벨, `${{ matrix.os }}` 같은 식, `linux`·`macos` 라벨 없는 self-hosted)에서 도는 단계 — 기본 셸이 `pwsh`다(Linux·macOS runner의 기본은 `bash -e`, `container:` job은 `sh -e`이고 둘은 같게 읽는다). Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-m`·`-v`·`--version`·`-h`·`-?`·`--help`·`--status`·`--stop`·`--foreground`, 묶음 `-qm`·`-qv` 포함)과 Gradle이 거부하는 짧은 옵션 묶음(`-mx`)·값을 받지 않는 옵션에 붙인 값(`-m=yes`)도 세지 않는다. 판독기의 Gradle 옵션 표는 `GradleCommandLineTest`가 build-logic을 돌리는 Gradle의 `--help`와 대조하므로, Gradle을 올려 옵션이 늘면(9.2의 `--task-graph`) 그 테스트가 실패한다. 단계를 부르지만 세지 않은 명령은 다른 빌드로 읽힌 것까지 실패 메시지에 이유와 함께 적는다(r9). `verifyEnvKeys`: lane 계약 json의 `APP_` 밖 키는 `SPRING_`·`MANAGEMENT_`·`SERVER_`이거나 `secret://…/`가 가리키는 변수여야 하고, 레지스트리 `property:` 행은 그 property가 설정 metadata에 있어야 읽히는 것으로 친다(`@ConditionalOnProperty`로만 읽는 스위치는 `META-INF/additional-spring-configuration-metadata.json`에 선언, RR2-04-05). SpotBugs 신뢰도 HIGH → MEDIUM | 등록 안 한 leaf, 단계에 안 걸린 자기 lane, 자기 코드의 MEDIUM 발견이 `ci`·`qualityCheck`를 막는다. `working-directory: src`도 `cd src`도 없이 `./gradlew`를 부르는 자기 workflow 단계는 실행으로 세지 않는다. 확실히 따라갈 수 없는 디렉터리 이동(`cd "$VAR"`, `cd -`, `cd ~`, 절대 경로, `pushd`, `if`/`for`/`case`·`{ }`·서브셸 안의 `cd`, `||`·`|`로 이은 `cd`, 다른 명령과 `&&`로 묶인 `cd` 다음 줄) 뒤의 명령도 세지 않고, 실패 메시지에 그 명령과 이유를 적는다. 단계를 `./gradlew ci \| tee log`(기본 셸), `./gradlew ci \|\| true`, `./gradlew ci \|\| exit 1`, `if ./gradlew ci; then` 같은 모양으로만 부르거나, 조건부 `exit 0` 뒤, `-v`·`--help`를 붙여, 요청형 trigger·`paths` 필터 trigger로만 시작하는 workflow·`releaseCheck`가 아닌 단계를 태그 push·`release`로만 시작하는 workflow·호출되지 않는 `workflow_call` workflow·조건부 job을 `needs`로 기다리는 job·`shell:` 없는 Windows runner에서만 부르는 자기 workflow도 실패한다 | leaf를 등록하거나 지운다. 자기 lane은 단계에 건다. 단계를 부르는 workflow 명령에 `working-directory`를 두거나 같은 셸에서 `cd <상대 경로>`로 옮긴 뒤 부른다. 단계 명령은 혼자 한 줄로 두고, 로그를 파이프로 남기려면 `shell: bash`나 앞 줄 `set -o pipefail`을 둔다. Windows runner에서는 `shell: bash`를 둔다. 단계는 매 push·pull request·schedule에 도는(`paths`·`paths-ignore` 필터 없는) workflow와 job에서(`releaseCheck`만 태그 push·`release` workflow에서), 재사용 workflow라면 그런 job이 조건 없이 부르게 한다. Gradle을 올려 `GradleCommandLineTest`가 실패하면 새 옵션을 값 옵션·플래그·작업 없이 끝나는 옵션 중 하나로 판독기 표에 넣는다. SpotBugs 발견은 고치거나 이유를 단 제외로 | `1400dc15`, `34565130`, `bbe944bd`, `5786126c`, `70fb80bf`(2026-11-04 소유자 결정), r9, r10(RR6-04-01~06), RR7-05-01(2026-11-06 소유자 결정), 태그·릴리스 workflow(2026-11-07 소유자 결정) · `src/build-logic/.../ModuleRegistry.java`, `.../strictlane/StrictLaneStagesPlugin.java`, `.../strictlane/WorkflowGradleInvocations.java`, `.../strictlane/ShellScript.java`, `.../strictlane/GradleCommandLineTest.java`(test), `.../quality/QualityConventionsPlugin.java`, `src/build.gradle` | | B-37 | app-bootstrap 테스트 lane 분리: 저장소 파일을 읽는 테스트는 태그 `document-contract`(main 단계) 또는 `repository-contract`(`check`)여야 하고, 일반 `test` lane에는 `ca.repository.root`가 없다 | app-bootstrap에 둔 자기 테스트가 저장소 파일을 읽으면 `test`에서 실패 | 태그를 단다 | `1400dc15` · `src/app-bootstrap/build.gradle` | | B-40 | 테스트 코드 정적 분석 `testQualityCheck`: SpotBugs·FindSecBugs를 main 밖 모든 source set(test, testFixtures, integrationTest, systemTest 등)에 돌린다. 테스트용 제외 목록은 `config/spotbugs/exclude-test.xml`(보안 범주·내부 상태 노출·생성자 예외·반환값 null 역참조·아키텍처 위반 fixture). 분석 classpath가 그 source set의 runtime classpath로 넓어졌고, 분석이 불완전하면(빠진 클래스) 실패한다. main 빌드는 `mainCheck`(`qualificationCheck`), optional 빌드는 `ci` | 자기 테스트 코드의 SpotBugs 발견(예: `CountDownLatch.await` 반환값 무시, 공유 변수 비원자 쓰기, 닫지 않은 `Statement`)이 main 단계를 막는다. 테스트 classpath에 없는 타입을 참조하면 `SpotBugs analysis incomplete` | 고치거나, 클래스·메서드로 좁힌 Match를 이유와 함께 `exclude-test.xml`에 더한다. 빠진 타입은 그 테스트 suite 의존성에 넣는다 | `2678955c` · `src/build-logic/.../quality/QualityConventionsPlugin.java`, `src/config/spotbugs/exclude-test.xml`, `src/build.gradle` | | B-42 | shared-contract 패키지 규칙 `SHARED_CONTRACT_CONTAINS_ONLY_OPERATIONAL_CONTRACT_PACKAGES`가 실제로 검사한다. 대상은 `dev.caskeleton.shared..`뿐이고, 허용은 목록의 패키지(`concurrency digest error metrics observability ratelimit request response retry runtime security tracing`)와 그 아래, 뿌리 패키지에는 `package-info`만이다. 전에는 뿌리를 허용 목록에 넣고 접두어로 비교해서 모듈 안은 아무것도 잡지 못했고, 다른 leaf의 `..shared..` 패키지를 잡았다 | `dev.caskeleton.shared`에 목록에 없는 패키지나 뿌리 클래스를 둔 파생 서비스는 architectureTest 실패. 다른 leaf의 `shared` 패키지는 더는 걸리지 않는다 | 업무 개념이면 그것을 소유하는 모듈로 옮긴다. 운영 계약이면 `ForbiddenApiArchitectureTest.SHARED_CONTRACT_PACKAGES`와 shared-contract CLAUDE.md 「Responsibility」에 함께 더한다 | r10 · `src/app-bootstrap/src/architectureTest/.../ForbiddenApiArchitectureTest.java`, `SharedContractPackageRuleTest.java` | @@ -124,6 +124,15 @@ |---|---|---|---|---| | B-38 | 새 leaf: `adapter-inbound-messaging`(`:adapter:inbound:messaging`, 이벤트 소비+inbox, 기본 조립에 없음), `composition-durable-operation`(`:composition:durable-operation`, `/operations`). 새 간선: `application-objectstorage`·`adapter-outbound-persistence-mongo`·`adapter-outbound-identifier`·`adapter-outbound-redis-sdk` → `shared-contract`, `adapter-inbound-web` → `adapter-outbound-support`, `sample-portfolio` → `adapter-outbound-support`, `app-bootstrap` → 두 새 leaf. 지운 간선: `composition-fileserver-platform` → `adapter-outbound-identifier`. `app-bootstrap/build.gradle`에 `runtimeOnly project(':composition:durable-operation')` 추가 | 자기 leaf를 더한 서비스는 `modules.json`·`app-bootstrap/build.gradle`에서 merge 충돌. 충돌을 풀다 durable-operation 줄을 빠뜨리면 `/operations` 조립이 없다(`DurableOperationConfig`가 app-bootstrap에서 빠졌기 때문) | 두 파일을 손으로 합친다. 합친 뒤 `architectureCheck`로 간선을 확인 | `1400dc15`, `5786126c` · `src/config/architecture/modules.json`, `src/app-bootstrap/build.gradle` | +### 3.6 저장소 배치 — 폴더·파일이 지워지거나 옮겨졌다 + +소유자 결정(2026-11-07, design-docs `repo-structure/README.md` 3.1절)으로 저장소 배치를 정리했다. 파생 서비스가 +고치지 않은 파일이면 병합이 그대로 지우거나 옮긴다. 고친 파일이면 "수정 대 삭제"나 이름 바뀜 충돌이 난다. + +| # | 무엇이 바뀌었나 | 파생 서비스 증상 | 할 일 | 근거 | +|---|---|---|---|---| +| B-49 | 샘플 모듈 삭제: `src/sample-portfolio`, `src/Dockerfile.sample`, registry `sample-portfolio` 행, 루트 `build.gradle`의 샘플 태스크·단계(`sampleWebContractCheck`, `:sample-portfolio:*` 의존, strict lane 단계 `:sample-portfolio:check`), `ci-quality-gates.yml`의 `sample-portfolio` job, `SampleRuntimeDefaultsContractTest`, spotbugs 제외의 샘플 클래스. 샘플에만 있던 검사(OpenAPI 스냅숏 `openapiCheckSnapshot`, Date 헤더, 가상 스레드 MDC 전파)도 함께 없어졌다 | 샘플을 고쳐 쓰던 서비스: 병합 때 "수정 대 삭제" 충돌. 샘플을 이미 지운 서비스: 충돌 없음 | 샘플을 이미 지웠으면 할 일 없음. 고쳐 쓰고 있으면 자기 leaf로 옮기고 registry 행·빌드 줄을 자기 것으로 둔다. 위 검사가 필요하면 자기 기능 leaf에 둔다 | 커밋 「샘플 모듈을 지운다」 | + ## 4. DB 마이그레이션 ### 4.1 새 버전과 영향 @@ -136,7 +145,7 @@ | notification (`flyway_jpa_notification_history`, notification-platform 선택 시) | V11 | `notification_reconciliation_job.claimed_until timestamptz`, `claim_fence bigint NOT NULL DEFAULT 0` + CHECK | 기존 job은 fence 0, lease 없음 | 그 표를 건드린 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V10에 남음(exit 70) | `34565130`, 3차 수정(RR-02-09) | | 〃 | V12 | `notification_suppression`의 `(tenant_id, normalized_target_hmac, reason)` 중복 행을 **삭제**(만료 없는 것 > 늦은 만료 > 이른 `effective_at` > 이른 `created_at` > 작은 id 순으로 하나 남김) 후 UNIQUE `uk_notification_suppression_target` | 지운 행의 `SuppressionId`는 더 이상 조회되지 않는다. 되돌리려면 백업 필요 | 그 표를 건드린 트랜잭션이 열려 있어 5초 안에 잠금(행 잠금 포함)을 못 잡으면 실패·롤백(삭제도 롤백), V11에 남음(exit 70) | `1400dc15`, 3차 수정(RR-02-09) | | 〃 | V13 | `notification_request.acceptance varchar(40) NOT NULL DEFAULT 'ACCEPTED'` + CHECK(`ACCEPTED`, `DROPPED_AS_DUPLICATE`) | 기존 요청은 모두 `ACCEPTED` | 그 표를 건드린 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V12에 남음(exit 70) | `5786126c`, 3차 수정(RR-02-09) | -| sample (`flyway_sample_schema_history`, sample-portfolio를 남긴 경우) | V8_1 | 유일 인덱스 `uq_poster_title_ci ON poster (upper(title))` | 없음 | 대소문자만 다른 제목이 있으면 `poster has titles that differ only by case or repeat: ...`로 실패. `poster`에 쓴 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V8에 남음 | `34565130`, 3차 수정(RR-02-09) | +| sample (`flyway_sample_schema_history`, sample-portfolio를 남긴 경우. **샘플 삭제(B-49)로 템플릿에서 사라졌다**) | V8_1 | 유일 인덱스 `uq_poster_title_ci ON poster (upper(title))` | 없음 | 대소문자만 다른 제목이 있으면 `poster has titles that differ only by case or repeat: ...`로 실패. `poster`에 쓴 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V8에 남음 | `34565130`, 3차 수정(RR-02-09) | | grpc-ledger (optional-platforms, history 표 확인 못 함) | V002 | 부분 인덱스 `ix_grpc_operation_ledger_finished_completed_at` (일반 `CREATE INDEX`) | 없음 | 큰 ledger면 만드는 동안 쓰기가 멈춘다. 파일 주석은 손으로 `CONCURRENTLY`를 먼저 돌리라고 한다. ledger에 쓴 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V001에 남음 | `1400dc15`, 3차 수정(RR-02-09) | | 〃 | V003 | `grpc_operation_ledger.claim_attempt BIGINT NOT NULL DEFAULT 1` + CHECK > 0 | 기존 행은 첫 시도(1) | ledger를 건드린 트랜잭션이 열려 있어 5초 안에 잠금을 못 잡으면 실패·롤백, V002에 남음 | `bbe944bd`, 3차 수정(RR-02-09) | @@ -162,7 +171,7 @@ 재리뷰 round7(RR7-03-05) 수정부터는 `.sql.conf`가 `executeInTransaction=true`를 정한 파일의 `VACUUM FULL`·비동시 `REINDEX SCHEMA|DATABASE|SYSTEM`도 앞의 `SET LOCAL`과 상관없이 같은 이유로 거부한다. 그런 파일은 PostgreSQL이 배포 때 `25001`로 거부하므로 배포된 적이 없다. 새로 걸리면 그 문장을 마이그레이션에서 빼 운영 절차로 옮긴다. -- **번호 충돌**: 템플릿이 이제 postgresql V20~V22, notification V11~V13, sample V8_1, grpc V002·V003을 쓴다. 파생 서비스가 같은 +- **번호 충돌**: 템플릿이 이제 postgresql V20~V22, notification V11~V13, grpc V002·V003을 쓴다(sample V8_1은 샘플과 함께 사라졌다, B-49). 파생 서비스가 같은 위치에 같은 번호를 두었다면 Flyway가 같은 버전 두 개로 실패한다. 자기 마이그레이션은 템플릿과 떨어진 번호대로 옮긴다 (이미 적용된 파일 이름을 바꾸면 checksum·history가 어긋나므로 운영 DB에 적용된 것이면 DB 담당과 정한다). - **migration-on-startup=false로 운영하는 서비스**: `infra/postgres/apply-capability-streams.sh`가 바뀌었다(stream을 @@ -252,7 +261,7 @@ V21 실패의 분류는 `docs/runbooks/migration-failed.md` "Classify the failur | 빌드 단계(HTTP client) | `httpClientFailureInjectionTest`(Toxiproxy 장애 주입)가 `mainCheck`에서 빠졌다. `integrationCheck`에만 있고, main push·nightly의 `integration-main.yml` `integration-check` job이 돌린다 | main push마다 같은 lane이 `main-check`·`integration-check` 두 job에서 두 번 돌던 것이 한 번이 된다. 로컬에서 `mainCheck`만 돌리면 이 lane은 돌지 않는다(`integrationCheck`로 돌린다) | r9 · `src/adapter/outbound/httpclient/build.gradle` | | 서버 로그(GraphQL·gRPC·STOMP) | carrier로 답한 실패를 web과 같은 줄(shared-contract `ServerFailureLog`)로 ERROR에 남긴다: persistence 실패는 분류만, 5xx carrier는 예외와 함께, 4xx carrier는 남기지 않는다. gRPC는 ` (method=…)`, GraphQL은 ` (executionId=…)`를 붙인다. gRPC는 인식 못 한 실패(`INTERNAL_ERROR`)도 `unhandled failure on …`로 남긴다. 클라이언트가 취소한 호출은 남기지 않고, 서비스가 `CANCELLED` status로 끝낸 살아 있는 호출은 남긴다. raw status는 넘겼든 던졌든 설명을 남기지 않는다(원인 예외가 있으면 그것만 붙인다). `IllegalArgumentException`(`BAD_PARAMETER`)은 web과 같은 WARN 한 줄 `request refused as BAD_PARAMETER by <예외 타입>`(메시지 없음)으로 남긴다. STOMP `@MessageMapping` 실패는 Spring의 `Unhandled exception from message handler method`(예외 전체) 대신 같은 줄로 남는다 | ERROR 로그가 늘어난다(전에는 gRPC가 아무것도 남기지 않았다). GraphQL·gRPC·STOMP는 잘못된 입력마다 WARN 한 줄이 생긴다. STOMP에서 Spring 문구로 경보를 걸었다면 고친다. `IDEMPOTENCY_RECOVERY_REQUIRED`의 scope digest를 모든 전송에서 찾을 수 있다(`docs/runbooks/idempotency-unavailable.md`) | r9 · `src/shared-contract/.../error/ServerFailureLog.java`, `GrpcExceptionHandlingInterceptor.java`, `GraphQlWireErrorMapper.java`, `StompHandlerFailureLog.java` | | 서버 로그(STOMP 거부·감싼 carrier, 2026-11-07) | `@MessageMapping` 앞에서 Spring이 거부한 메시지를 WARN 한 줄 `request refused as by <예외 타입>`으로 남긴다: 읽지 못한 payload(`MessageConversionException`)·비었거나 검증에 걸린 payload(`MethodArgumentNotValidException`)는 `VALIDATION_FAILED`, 변환되지 않는 `@DestinationVariable`·`@Header`(`ConversionFailedException`)는 `BAD_PARAMETER`. 전에는 ERROR에 예외 메시지(받은 JSON 조각·값)까지 남겼다. 응답을 쓰지 못한 변환 실패는 그대로 ERROR. 네 전송 모두 감싼 carrier를 그 carrier 줄로 남긴다(감싼 persistence 실패는 분류만, SQL 원인 없음) | ERROR 경보가 클라이언트의 잘못된 메시지에 울리지 않는다. 그 실패를 찾던 로그 검색은 WARN으로 바꾼다 | r8-f1(재리뷰 RR7-01-06·RR7-01-05) · `src/adapter/inbound/websocket/.../stomp/StompHandlerFailureLog.java`, `src/shared-contract/.../error/ServerFailureLog.java` `refused` | -| sample-portfolio | 익명 쓰기 401, 포스터 제목 대소문자 무시 유일(409 `POSTER_ALREADY_EXISTS`), 관리자도 남의 work log 수정 불가, 샘플 이벤트 tenant `global` | sample을 남긴 서비스만 | `34565130`, `1400dc15` | +| sample-portfolio | **샘플 삭제(B-49)로 템플릿에서 사라졌다.** 익명 쓰기 401, 포스터 제목 대소문자 무시 유일(409 `POSTER_ALREADY_EXISTS`), 관리자도 남의 work log 수정 불가, 샘플 이벤트 tenant `global` | sample을 남긴 서비스만 | `34565130`, `1400dc15` | | Flyway 잠금 | Flyway의 PostgreSQL 마이그레이션 잠금을 트랜잭션 대신 세션에 둔다. Spring Boot의 Flyway는 module-defaults `spring.flyway.postgresql.transactional-lock: false`, 템플릿이 직접 만드는 Flyway(멱등성·알림·sample stream, schema-per-tenant, testkit `MigrationContractRunner`)는 `FlywaySchemaPolicy.configure()`, messaging inbox stream은 같은 값을 직접 넣는다. 운영 코드의 `Flyway.configure()` 직접 호출과 설정 객체 직접 생성(`new FluentConfiguration()`·`new ClassicConfiguration()`·그 하위 클래스, round7 RR7-03-06)은 `JpaProductionArchitectureTest`가 거부한다 | Flyway 기본값에서는 동시 인덱스 마이그레이션이 Flyway 자신의 열린 트랜잭션을 기다려 끝나지 않았다. 이제 끝난다. 마이그레이션은 잠금을 잡은 연결 하나로 돈다. transaction 모드 PgBouncer 뒤에서는 잠금 해제가 다른 서버 연결로 가 다음 배포가 기다릴 수 있으니 마이그레이션은 직접 연결이나 session 모드 pool로 돌린다. 배포 도구는 이 repo 밖이라 2절 15번으로 맞춘다 | 재리뷰 round6 RR6-03-01 · `persistence-jpa.yml`, `.../migration/FlywaySchemaPolicy.java`, `docs/jpa/migration-guide.md` "Who may change the schema"·"Concurrent index builds" | | 실패한 동시 인덱스 마이그레이션 복구 | `docs/runbooks/migration-failed.md`에 「Recover a failed concurrent index migration」을 더했다: 진행 중인 빌드가 없는지 보고, 원인(중복 행, 문장을 붙잡던 열린 트랜잭션)을 정리하고, 실패한 빌드·재빌드가 남긴 무효 인덱스를 `DROP INDEX CONCURRENTLY`로 지우고, 그 버전의 실패 이력 행(`success = false`)만 지운 뒤 다시 배포한다. 실패한 문장이 `DROP INDEX CONCURRENTLY`면 남은 무효 인덱스는 지우지 않는다. 그 마이그레이션이 지우려던 인덱스라 다시 배포한 같은 문장이 지운다. 「Do not」의 이력 수정 금지에 이 한 가지 예외를 적었다. `flyway repair`는 계속 쓰지 않는다 | 전에는 안내가 "`DROP INDEX` 하나"였고, 그대로 하면 남은 실패 이력 때문에 다음 배포가 validate에서 다시 멈췄다. 실패한 drop의 인덱스를 손으로 지우면 다시 배포한 문장이 `42704`(없는 인덱스)로 또 실패한다. 동시 인덱스 마이그레이션을 쓰는 서비스의 운영자는 이 절차로 복구한다 | 재리뷰 round7 RR7-03-03, round8 RR8-03-01, 소유자 결정 2026-11-06 · `docs/jpa/migration-guide.md` "Concurrent index builds", `PostgreSqlConcurrentIndexMigrationIntegrationTest` | | 성능 lane(HTTP client·Mongo) | httpclient `LargeBodyResourceTest`의 힙 상한(32 MiB 스트리밍 중 힙 증가 16 MiB 미만)을 매번 단언한다. 전에는 `-Pperformance.assertions.enabled=true`일 때만 단언하고 아니면 건너뛴다는 줄만 찍었다. Mongo `MongoResourceBudgetLaneTest`는 표준 gate 전체(p99 500ms, pool 대기 250ms, 힙 512 MiB, examined/returned 10, spill 금지)를 Gradle 밖 실행에서도 단언한다(B-43) | 손으로 돌린 `performanceCheck`가 상한을 실제로 재므로, 전에는 통과하던 느린 기계에서 실패할 수 있다 | B4(2026-11-06) · `LargeBodyResourceTest`, `MongoResourceBudgetLaneTest` | @@ -264,7 +273,7 @@ V21 실패의 분류는 `docs/runbooks/migration-failed.md` "Classify the failur | 단계 | 할 일 | 게이트 | |---|---|---| -| 0. 준비 | 운영·스테이징 DB 백업. 작업 브랜치를 따로 만든다. 자기 마이그레이션 번호가 4.1절 번호와 겹치는지 본다. 운영 DB 사본에 4.3절 Step 1 쿼리(필요하면 V8_1 중복 제목 확인)를 돌려 둔다 | — | +| 0. 준비 | 운영·스테이징 DB 백업. 작업 브랜치를 따로 만든다. 자기 마이그레이션 번호가 4.1절 번호와 겹치는지 본다. 운영 DB 사본에 4.3절 Step 1 쿼리를 돌려 둔다 | — | | 1. merge·의존성 | `git fetch upstream` 후 merge. 충돌 예상 파일: `config/architecture/modules.json`, `app-bootstrap/build.gradle`, `docs/registries/env-keys.yaml`, `.env.example`, `application*.yml`, API surface 스냅샷, `gradle.lockfile`. 자기 의존성을 바꿨으면 `./gradlew ::resolveAndLockAll --write-locks` | `./gradlew verifyDependencyLocks` | | 2. 컴파일·아키텍처 | 3.1절(B-01~B-11) 고치기. 3.4절 규칙 위반 고치기 | `./gradlew architectureCheck`, `./gradlew :app-bootstrap:architectureTest`, 고친 leaf마다 `./gradlew :check` | | 3. PR 게이트 전체 | 자기 strict lane을 단계에 건다. SpotBugs MEDIUM 발견 처리 | `./gradlew ci`, `./gradlew verifyStrictLaneStages --dry-run` | diff --git a/docs/web/advanced-capabilities.md b/docs/web/advanced-capabilities.md index 96da4536..da72f415 100644 --- a/docs/web/advanced-capabilities.md +++ b/docs/web/advanced-capabilities.md @@ -2,7 +2,7 @@ The Advanced capabilities live in their own leaf, `adapter:inbound:web-advanced` (`src/adapter/inbound/web-advanced`, package `dev.caskeleton.adapter.inbound.web.advanced`). No -default composition carries it: `app-bootstrap` and `sample-portfolio` do not depend on it. A +default composition carries it: `app-bootstrap`은 이 leaf에 의존하지 않는다. A service that wants one of these capabilities adds the leaf as `implementation` in its own adapter leaf and calls the types directly. diff --git a/docs/web/repository-adaptation.md b/docs/web/repository-adaptation.md index c3b43f84..18458797 100644 --- a/docs/web/repository-adaptation.md +++ b/docs/web/repository-adaptation.md @@ -69,8 +69,9 @@ than silently absorbed. ## 5. Sample application -The design's `examples/web-platform-sample` is the existing `sample-portfolio` leaf, which already -carries the OpenAPI drift gate and the contract lanes the design's sample is specified to provide. +설계의 `examples/web-platform-sample`에 해당하는 모듈은 없다. 그 역할을 하던 샘플 leaf는 2026-11-07에 +지웠고, 그 안의 OpenAPI 드리프트 검사와 실서버 계약 lane도 함께 사라졌다. 예시는 `docs/manual/`과 +`scripts/new-feature.sh` 출력이 맡는다. ## 6. Idempotency: the design's store SPI is already owned by `application-core` diff --git a/docs/work/delegate.md b/docs/work/delegate.md index 045ec260..4a83e6ca 100644 --- a/docs/work/delegate.md +++ b/docs/work/delegate.md @@ -55,7 +55,7 @@ design-docs `conventions/delegation-loop.md` 3절 순서대로 한다: 크기 | messaging | `src/messaging/*`, `src/adapter/outbound/messaging` | | bootstrap·build·CI | `src/app-bootstrap`, `src/composition/*`, `src/build-logic`, `src/build.gradle`, `.github/` | | 보안(영역을 가로질러) | 인증·인가 체인, 비밀, 공개 경로 | -| 샘플·문서 | `src/sample-portfolio`, `docs/` | +| 문서 | `docs/` | 두 세션이 동시에 만지면 손으로 풀어야 하는 파일이다. 한 세션만 맡기거나, 총괄이 합칠 때 직접 고친다. diff --git a/docs/work/new-feature.md b/docs/work/new-feature.md index 73007fff..de926738 100644 --- a/docs/work/new-feature.md +++ b/docs/work/new-feature.md @@ -23,7 +23,7 @@ - 업무 기능 하나는 보통 중간이다: 계층 leaf 여러 곳에 파일이 생기지만 판단은 매뉴얼이 정해 둔 범위 안이다. - 큼: 새 capability 모듈, 새 leaf, 새 공개 계약, 파생 서비스가 따라 고쳐야 하는 변경. 큰 일은 설계와 소유자 검토가 먼저다([research-design.md](research-design.md)). -- 선행 사례는 생성 명령의 출력 하나다. `src/sample-portfolio`는 개별 기법(조건부 PATCH, 페이지, outbox, DB 유일 제약)의 참고일 뿐 배치를 따라 하지 않는다. +- 선행 사례는 생성 명령의 출력 하나다. 개별 기법의 예시는 `docs/manual/`이 실제 코드(fileserver, durable operation)로 가리킨다. - 스킬: 설계가 바뀌면 `superpowers:brainstorming`, 여러 단계면 `superpowers:writing-plans`, 구현은 `superpowers:test-driven-development`. ## 4. 절차 @@ -51,7 +51,7 @@ ## 6. 하지 말 것 - `AGENTS.md` HARD-STOP을 어기지 않는다. 특히 controller가 repository를 부르거나, inbound DTO가 application으로 들어가거나, 업무 규칙이 mapper·filter·설정에 들어가는 것. -- `src/sample-portfolio`의 배치(한 leaf에 모든 계층)를 따라 하지 않는다. onboarding 테스트 fixture도 따라 하지 않는다. +- 한 leaf에 모든 계층을 두지 않는다. onboarding 테스트 fixture도 따라 하지 않는다. - 업무 코드를 템플릿 패키지에 넣지 않는다. - 저장 adapter를 `persistence-jpa` leaf 안에 만들지 않는다. 서비스 전용 persistence leaf에 둔다. - 한 단계가 다른 leaf나 계층을 고쳐야 하면 범위를 조용히 넓히지 않는다. 거기서 멈추고 설계를 다시 본다(7절). @@ -74,6 +74,6 @@ ## 9. 자주 하는 실수 -- 샘플을 베껴 한 leaf에 모든 계층을 둔다. 생성 명령의 출력을 따른다. +- 한 leaf에 모든 계층을 둔다. 생성 명령의 출력을 따른다. - 생성 명령을 노트북에서 기본 옵션으로 돌려 Gradle이 노트북에서 돈다. `--no-format`을 쓴다. - 역할 → 권한 매핑을 빠뜨려 쓰기 API가 모든 요청에 403이다. `docs/manual/07-authorization.md`를 본다. diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index 76ae945c..1eb07b45 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -74,6 +74,7 @@ | 생성 명령 | JPA adapter를 만들지 않음(서비스 전용 persistence leaf가 기본), 생성된 쓰기 API는 역할 매핑 전 403 | 위임 | `1101` 15절(r2-10) | | `@SystemInvoked` | bean으로 등록돼 있으면 기동 실패, inbound adapter가 직접 부르지 못하게 ArchUnit | 위임 | `1103` 4절(RR-01-02) | | 시스템 호출 경로 | 사용자가 닿는 전송(web·GraphQL·gRPC·WebSocket)만 `@SystemInvoked`에 닿지 못한다. 메시지 소비자·스케줄러는 `@SystemCaller(reason)` 표시로 허용 | 위임 | `1103` 9.1절(RR-01-12), 10절 r5-b | +| 샘플 모듈 | `src/sample-portfolio`와 `src/Dockerfile.sample`을 폴더째 지운다. 역할은 옮기지 않는다. 샘플 안에만 있던 템플릿 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC)도 함께 지운다. 예시는 매뉴얼과 생성 명령 출력이 맡는다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.2절 | ### 2.3 계약·오류 @@ -126,7 +127,7 @@ | --- | --- | --- | --- | | JPA 기본값 | 트랜잭션 제한 30초, JDBC batch 50, H2 운영 jar 제거, 격리 수준 Hikari 고정, upsert `DO NOTHING` 후 갱신 | 위임 | `1101` 15절(04) | | 포트 시그니처 | claim에 lease·`claimFence`, fileserver `claimDue`·`markAbandoned`·`claimToken` | 위임 | `1101` 15절 | -| 마이그레이션 번호 | 스트림별 순번. 샘플은 운영 스트림과 합쳐 도는 테스트가 있어 `V8_1`. notification은 `V13` | 위임 | `1101` 15절 | +| 마이그레이션 번호 | 스트림별 순번. ~~샘플은 운영 스트림과 합쳐 도는 테스트가 있어 `V8_1`.~~(샘플과 함께 사라짐, 2026-11-07) notification은 `V13` | 위임 | `1101` 15절 | | V21 유일 인덱스 | 기존 중복이 있으면 마이그레이션 실패. runbook에 확인 쿼리 | 위임 | `1101` 15절 | | 순서 번호 seed | counter가 없으면 전역 floor부터 | 위임 | `1103` 4절(RR-03-02) | | 마이그레이션 잠금 | 강한 잠금을 거는 마이그레이션은 `SET LOCAL lock_timeout`, 같은 모양의 lane 테스트 | 위임 | `1103` 9.1절(RR-02-09) | @@ -139,9 +140,9 @@ | 주제 | 결정 | 누가 | 출처 | | --- | --- | --- | --- | -| 포스터 업로드 abort·reconcile 경합 | 먼저 끝난 쪽이 이김(이미 게시됐으면 abort는 409) | 소유자 | 결정 22 | -| work log 권한·batch | 관리자도 남의 work log 수정 불가, `batchCreate` 상한 1000·한 트랜잭션 | 위임 | `1101` 15절(09) | -| 이벤트 tenant·오류 코드 | 이벤트 tenant 범위 `global`, `WORKLOG_INVALID`·`OPERATION_NOT_FOUND` | 위임 | `1101` 15절(01) | +| 포스터 업로드 abort·reconcile 경합 | ~~먼저 끝난 쪽이 이김(이미 게시됐으면 abort는 409)~~ 샘플과 함께 사라짐(2026-11-07) | 소유자 | 결정 22 | +| work log 권한·batch | ~~관리자도 남의 work log 수정 불가, `batchCreate` 상한 1000·한 트랜잭션~~ 샘플과 함께 사라짐(2026-11-07) | 위임 | `1101` 15절(09) | +| 이벤트 tenant·오류 코드 | ~~이벤트 tenant 범위 `global`, `WORKLOG_INVALID`~~ 샘플과 함께 사라짐(2026-11-07). `OPERATION_NOT_FOUND`는 남는다 | 위임 | `1101` 15절(01) | | outbox append 모델 | canonical(`OutboxAppendPort`)로 통일, legacy 포트·legacy Kafka 발행 경로 삭제 | 소유자 | 결정 7 | | Kafka 소비 | 지원. `MessageHandler` 하나 + starter-kafka가 consumer 조립 | 소유자 | 결정 10 | | decode 타입 등록 | handler bean이 선언한 타입으로 decode 목록을 만든다 | 위임 | `1101` 15절(06-08 후속) | @@ -149,7 +150,7 @@ | 끝나지 않는 재시도 | bridge가 원인 코드를 행에 남기고, 오래 재시도 중인 행 수·나이를 지표로, runbook에 park·재개 절차와 테스트된 SQL | 위임 | `1103` 4절(RR-05-03) | | 카드 검증기 YAML | messaging leaf 테스트에서만 snakeyaml(main 금지) | 소유자 | 결정 29 | | JWT audience·role | audience 필수, 자기 client role만(기존 배포는 env 하나를 채움) | 소유자 | `1101` 5절(02-03), 15절 | -| 데모 계정 | `local`·`test`·`demo` 프로필이 명시적으로 켜졌을 때만(허용 목록). 각 프로필은 sample이 실제로 뜨는 프로필 | 위임 | `1103` 4절(RR-07-02), 9.1절(RR2-04-02) | +| 데모 계정 | ~~`local`·`test`·`demo` 프로필이 명시적으로 켜졌을 때만(허용 목록). 각 프로필은 sample이 실제로 뜨는 프로필~~ 샘플과 함께 사라짐(2026-11-07) | 위임 | `1103` 4절(RR-07-02), 9.1절(RR2-04-02) | | `fixture-` 값 거부 | 비밀로 분류된 키(`docs/registries/secrets-classification.yaml`)만 검사 | 위임 | `1103` 9.1절(RR2-04-01) | | 파일 서버 인가 | 역할 검사(`file:*` 권한)와 소유자·tenant 검사(`ownerPrincipalId`)를 둘 다 | 소유자 | 결정 14, 결정 32 | | cross-origin redirect | 호출자 헤더 전부 제거, 안전한 헤더만 유지 | 소유자 | 결정 23 | diff --git a/docs/work/reference/defect-patterns.md b/docs/work/reference/defect-patterns.md index e559218b..1382c2d2 100644 --- a/docs/work/reference/defect-patterns.md +++ b/docs/work/reference/defect-patterns.md @@ -39,7 +39,7 @@ - **모양**: 조회 후 insert, 찾고 없으면 넣기, 트랜잭션 없는 `SKIP LOCKED`, lease 없는 claim, 프로세스 메모리에 둔 소유권. - **막는 기준**: 유일성은 DB 유일 제약이 막고, adapter는 그 제약 위반만 기능 예외로 바꾼다. 여러 인스턴스가 집는 작업은 트랜잭션 안의 claim + lease로 소유권을 정한다. - **볼 것**: 존재 확인 뒤 쓰기, 트랜잭션 밖 잠금, 메모리 안 소유권. -- **장치**: `CallerTransaction`(store는 호출자 트랜잭션을 요구), 동시 요청 통합 테스트(`CreatePosterConcurrencyIntegrationTest`). 정본: `docs/manual/04-persistence.md`. +- **장치**: `CallerTransaction`(store는 호출자 트랜잭션을 요구), 동시 요청 통합 테스트(실 DB lane에서 동시 요청 N개 → 행 1개). 정본: `docs/manual/04-persistence.md`. ### A6. 주장하는 것을 보지 않는 테스트 @@ -76,10 +76,10 @@ ### A11. 샘플·fixture가 운영과 다르게 조립된다 -- **모양**: 샘플이 자동 설정을 빼거나 런타임 기본값이 다르다. "따라 할 모양"으로 둔 fixture가 기동하지 않는다. -- **막는 기준**: 샘플은 운영과 같은 자동 설정과 런타임 기본값을 쓴다. 무엇을 빼면 이유와 대체 장치를 같은 곳에 적는다. 새 기능의 모양으로 둔 fixture는 실제로 기동되는 모양이어야 한다. -- **볼 것**: 샘플 `@SpringBootApplication(exclude=…)`, 샘플 `application.yml`과 기본 조합의 차이. -- **장치**: 샘플 전체 기동 lane(`:sample-portfolio:systemTest`, `mainCheck`), 샘플 실서버 계약(`sampleWebContractCheck`). +- **모양**: 따로 조립한 앱(fixture·데모)이 자동 설정을 빼거나 런타임 기본값이 다르다. "따라 할 모양"으로 둔 fixture가 기동하지 않는다. +- **막는 기준**: 따로 조립한 앱은 운영과 같은 자동 설정과 런타임 기본값을 쓴다. 무엇을 빼면 이유와 대체 장치를 같은 곳에 적는다. 새 기능의 모양으로 둔 fixture는 실제로 기동되는 모양이어야 한다. +- **볼 것**: 그 앱의 `@SpringBootApplication(exclude=…)`, 그 앱의 `application.yml`과 기본 조합의 차이. +- **장치**: 기본 조합 전체 기동 lane(app-bootstrap `systemTest`, PR `check`). 이 모양이 처음 나온 샘플 모듈은 2026-11-07에 지웠다. ### A12. 수정이 새 결함을 만든다 diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index c1367595..151dadcc 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -21,10 +21,9 @@ | `testQualityCheck` | 같은 분석을 모든 테스트 source set에(`config/spotbugs/exclude-test.xml` 기준) | main(`mainCheck` 안), optional 빌드는 `ci` | `src/build.gradle` | | `ci` | leaf `check`(API surface 포함) + `architectureCheck` + `qualityCheck` | PR | `ci-quality-gates.yml`: `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` | | `verifyStrictLaneStages --dry-run` | `explicitOnly`가 아닌 strict lane이 workflow가 실행하는 단계에 속하는가 | PR(두 빌드 각각) | `ci-quality-gates.yml`, optional 빌드는 `-p optional-platforms` | -| `:sample-portfolio:check :sample-portfolio:qualityCheck` | 샘플(`ci` 밖) | PR | `ci-quality-gates.yml` | | `-p optional-platforms ci` | gRPC 플랫폼 빌드 | PR | `ci-quality-gates.yml` | | `bash scripts/verify-compose-profile-contracts.sh` | compose lane이 선언대로 렌더링되는가(저장소 루트에서) | PR | `ci-quality-gates.yml` | -| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 샘플 실서버 계약 + 샘플 전체 기동(`:sample-portfolio:systemTest`) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `integration-main.yml`: `./gradlew :mainCheck --continue --warning-mode=fail` | +| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `integration-main.yml`: `./gradlew :mainCheck --continue --warning-mode=fail` | | `integrationCheck` | 선언된 strict integration lane 전체(실 컨테이너). 입력이 없는 lane은 빼고 이름을 댄다 | main·nightly | `integration-main.yml`, optional 빌드도 | | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | main·nightly | `integration-main.yml`, optional 빌드도. 5절 | | `releaseCheck -PgitRevision=` | 릴리스 provenance + 공개 경로 스냅숏. sha 없이 돌리면 설계대로 실패한다 | 태그 | `release.yml` | @@ -99,7 +98,6 @@ cd src # PR: ci-quality-gates.yml ./gradlew :ci :verifyDependencyLocks --warning-mode=fail --no-build-cache --console=plain ./gradlew :verifyStrictLaneStages --dry-run --console=plain -./gradlew :sample-portfolio:check :sample-portfolio:qualityCheck --no-build-cache --console=plain ./gradlew -p optional-platforms ci --no-build-cache --console=plain ./gradlew -p optional-platforms :verifyStrictLaneStages --dry-run --console=plain # main push: integration-main.yml @@ -184,7 +182,6 @@ for k in tests skipped failures errors; do cat $(find "$x" -name 'TEST-*.xml') | | 장치 | 고정하는 것 | 단계 | | --- | --- | --- | -| 요청당 SQL 수 단언(`WorkLogStatementCostSystemTest`) | 목록 20건과 100건의 문장 수가 같음, 제목만 바꾸는 PATCH가 컬렉션 행을 건드리지 않음, batch 생성이 JDBC batch로 감 | sample `systemTest`(`mainCheck`) | | 자원 한계 lane | Tomcat·Jetty 부하·느린 클라이언트·종료, HTTP client 풀·스트리밍·재시도, Hikari 풀 | `performanceCheck` | | JMH 벤치마크 | `src/messaging/messaging-kafka/src/jmh`, `src/messaging/messaging-testkit/src/jmh`, `src/adapter/outbound/httpclient/src/jmh` | 명시 실행 | diff --git a/docs/work/reference/review-criteria.md b/docs/work/reference/review-criteria.md index 495d3089..2d9af720 100644 --- a/docs/work/reference/review-criteria.md +++ b/docs/work/reference/review-criteria.md @@ -126,22 +126,22 @@ | 24 | 네이밍·의미 | `src/application-core/CLAUDE.md` 「Naming convention」, `NamingConventionTest` | 이름과 내용이 다름 | | 25 | 조직 확장성 | 파생 서비스가 upstream을 받을 때 겹치는 곳 | 기능 패키지가 템플릿 패키지와 섞임 | | 26 | Ownership | leaf마다 가까운 `CLAUDE.md`·README | 안내 문서 없음, 패키지가 평평해 소유가 안 보임 | -| 27 | 삭제 가능성 | capability `runtimeOnly` 한 줄 제거, sample 제거 | 한 줄 지워도 흔적이 남음, bootstrap이 capability 이름을 앎 | +| 27 | 삭제 가능성 | capability `runtimeOnly` 한 줄 제거 | 한 줄 지워도 흔적이 남음, bootstrap이 capability 이름을 앎 | | 28 | 회복 가능성 | runbook SQL, DEAD·park, ledger 회수 | 영구히 막히는 key, 복구가 행마다 수작업 | **따라갈 시나리오** (가이드 31절). 전체 리뷰는 시나리오마다 요청 하나를 끝까지 따라가며 입력 신뢰 수준, 권한 판단 위치, 규칙 소유자, 트랜잭션 시작과 끝, 외부 부작용, 오류 변환을 적는다. 해당 기능이 없으면 적용 제외 사유를 한 줄 적는다. | 시나리오 | 따라갈 경로 | | --- | --- | -| 정상 쓰기 요청 | sample `POST /api/worklogs`, 생성 명령으로 만든 기능 | -| 중복·동시 요청 | 같은 제목 동시 `POST /api/posters`, 멱등 키(`docs/manual/05-idempotency.md`) | +| 정상 쓰기 요청 | 생성 명령으로 만든 기능, durable operation `POST /operations` | +| 중복·동시 요청 | 같은 호출자가 같은 작업을 동시에 `POST /operations`(payload fingerprint로 하나만 받는다), 멱등 키(`docs/manual/05-idempotency.md`) | | 외부 응답 지연·유실 | httpclient 시간 예산·breaker, 알림 발송 attempt | | DB 오류·경쟁 | `PersistenceExceptionTranslator`, `@Version`, 트랜잭션 마감 | | 메시지 중복·역순 | outbox relay, inbox 재전달, aggregate 순서 번호 | | 신·구 버전 공존 | 마이그레이션 잠금, 배포 중 섞인 인스턴스 | | 여러 서버의 작업 실행 | 알림 정산 job claim, gRPC ledger claim | -| 다른 사용자 리소스 접근 | 파일 서버 소유자 검사, sample 소유자 검사 | -| 큰 입력·목록 조회 | `GET /api/worklogs?size=100`, GraphQL 복잡도, JSON 아닌 본문 | +| 다른 사용자 리소스 접근 | 파일 서버 소유자 검사, durable operation 소유자·tenant 검사 | +| 큰 입력·목록 조회 | 파일 서버 업로드 크기 한도, GraphQL 복잡도, JSON 아닌 본문 | | 종료·재시작 | relay·platform 종료 순서, 종료 시간 예산 | | 선택 어댑터 제거 | `src/app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄 제거 | diff --git a/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl b/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl index e19f4f53..42f383ed 100644 --- a/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl +++ b/scripts/feature-scaffold/templates/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/__feature__/Uuid__Feature__IdFactory.java.tmpl @@ -8,7 +8,7 @@ import java.util.UUID; * Mints {@link __Feature__Id}s as random (version 4) UUIDs from the JDK's secure generator. * *

Random UUIDs scatter inserts across a B-tree primary key. When __Feature__ rows are written - * often, switch to a time-ordered UUIDv7 as the sample's {@code UuidWorkLogIdFactory} does; the + * often, switch to a time-ordered UUIDv7 as {@code UuidV7DurableOperationIdFactory} does; the * domain contract (canonical UUID text) does not change. */ public final class Uuid__Feature__IdFactory implements __Feature__IdFactory { diff --git a/src/Dockerfile.sample b/src/Dockerfile.sample deleted file mode 100644 index 064714f5..00000000 --- a/src/Dockerfile.sample +++ /dev/null @@ -1,159 +0,0 @@ -# syntax=docker/dockerfile:1.7-labs@sha256:b99fecfe00268a8b556fad7d9c37ee25d716ae08a5d7320e6d51c4dd83246894 -# ============================================================================= -# sample-portfolio standalone demo image — twin of src/Dockerfile. -# -# Builds and runs the REFERENCE app (SamplePortfolioApplication), not the -# production composition root (CaSkeletonApplication) that src/Dockerfile builds. -# The sample is the demo-friendly entrypoint: its application.yml self-provides -# defaults for every env placeholder, so what it needs to boot is a demo profile -# and a reachable PostgreSQL (datasource + Flyway sample migrations). -# -# The profile is not baked in. The demo accounts (a published admin password) start only under an -# explicitly active `demo`, `local` or `test` profile (SampleDemoAccountsProductionGuard), and an -# image that defaulted to one would carry them into any deployment that ran it as is. Without -# SPRING_PROFILES_ACTIVE the container stops with exit code 71 and says so. -# -# Build (no build-args required — this is a disposable demo, not a release artifact): -# docker build -f src/Dockerfile.sample src/ -t ca-sample:local -# -# Run (point APP_DATASOURCE_URL at a reachable Postgres; localhost default shown): -# docker run --rm -p 8080:8080 -p 9001:9001 \ -# -e SPRING_PROFILES_ACTIVE=demo \ -# -e APP_DATASOURCE_URL=jdbc:postgresql://host.docker.internal:5432/ca_skeleton \ -# ca-sample:local -# -# The multi-stage build, --parents descriptor glob, STRICT lock verification, -# non-root user, read-only-root-fs writable mounts, and JVM container ergonomics -# are all identical to src/Dockerfile — only the bootJar target differs. -# -# Two files rather than one with a COMPOSITION=sample argument: the release image refuses to build -# without version and source metadata, and folding a zero-argument demo into it would make that -# refusal conditional. The part that must not drift — the dependency stage's COPY lines — is held -# equal by DeveloperExperienceContractTest. -# ============================================================================= - -# Demo defaults so the image builds with zero build-args. Two format constraints from the root -# build.gradle configuration guard (feature-build-release-supply-chain-contract D1/D9): -# - RELEASE_VERSION must be bare MAJOR.MINOR.PATCH — no pre-release/build suffix (build.gradle L21). -# The "-sample" marker therefore lives only on BUILD_VERSION, which is a label, not a gradle prop. -# - GIT_SHA must be 7-40 hex chars (build.gradle L35); 0000000 is the placeholder. -ARG RELEASE_VERSION=0.0.0 -ARG BUILD_VERSION=0.0.0-sample -ARG GIT_SHA=0000000 -ARG SOURCE_URL=https://example.invalid/ca-tmpl-sample - -# ---- Stage 1: builder ------------------------------------------------------- -# Uses the full JDK only in the build stage, never in the final image. -FROM eclipse-temurin:21-jdk-jammy@sha256:801b7e1a9c4befaf82bf9a2a58025ef43a7694bbc84779187ad0524d84742772 AS builder - -ARG RELEASE_VERSION -ARG GIT_SHA - -WORKDIR /build/src - -# Copy the Gradle wrapper and every module's build descriptor + dependency lockfile FIRST, -# so the expensive dependency-resolution layer is cached and only re-runs when a build.gradle -# or gradle.lockfile changes (D8). `--parents` preserves each file's directory structure, so a -# single structure-preserving glob replaces a per-module COPY list: new modules are picked up -# automatically and this stage never drifts out of sync with settings.gradle. -# (Requires the labs Dockerfile frontend — see the `# syntax` directive at the top of this file.) -COPY gradlew ./ -COPY gradle/ gradle/ -COPY gradle.properties ./ -COPY config/ ./config/ -COPY --parents settings.gradle build.gradle **/build.gradle **/gradle.lockfile ./ -# The convention plugins, whole — see src/Dockerfile. Without them settings.gradle's -# includeBuild('build-logic') has no version catalog and no plugins, and this stage failed before -# resolving anything (07-04). DeveloperExperienceContractTest holds these COPY lines equal to the -# release image's. -COPY build-logic/ ./build-logic/ - -# Resolve every module configuration in STRICT mode (no --write-locks in a demo build either). -RUN test -n "${RELEASE_VERSION}" \ - && test -n "${GIT_SHA}" \ - && ./gradlew verifyDependencyLocks --no-daemon --quiet \ - -PreleaseVersion="${RELEASE_VERSION}" -PgitRevision="${GIT_SHA}" - -# Copy full source and stage the executable sample JAR at Gradle's declared Docker output path. -COPY . . -RUN ./gradlew :sample-portfolio:stageDockerJar --no-daemon -x test \ - -PreleaseVersion="${RELEASE_VERSION}" -PgitRevision="${GIT_SHA}" - -# ---- Layer extraction ------------------------------------------------------- -# Identical to src/Dockerfile — see the long note there. Kept in sync because the header of this -# file says the builder stages are, and a demo image whose layout has drifted from the release image -# stops being a demo of the release image. Absolute paths for the same contract-test reason. -RUN java -Djarmode=tools \ - -jar /build/src/sample-portfolio/build/docker/application.jar \ - extract --layers --destination /build/src/sample-portfolio/build/docker/extracted - -# ---- Stage 2: runtime image ------------------------------------------------- -# JRE-only slim image (no full JDK in the demo image either). -FROM eclipse-temurin:21-jre-jammy@sha256:199aebeb3adcde4910695cdebfe782ada38dadb6cc8013159b58d3724451befd AS runtime - -ARG BUILD_VERSION -ARG GIT_SHA -ARG SOURCE_URL - -# OCI image labels. Unlike the release image (src/Dockerfile), the demo image does NOT hard-fail -# on missing metadata — the ARG defaults above keep it buildable with no build-args. -LABEL org.opencontainers.image.title="caskeleton-sample" \ - org.opencontainers.image.description="ca-tmpl sample-portfolio reference/demo application" \ - org.opencontainers.image.source="${SOURCE_URL}" \ - org.opencontainers.image.revision="${GIT_SHA}" \ - org.opencontainers.image.version="${BUILD_VERSION}" - -# ---- Locale / timezone ------------------------------------------------------ -ENV TZ=UTC \ - LANG=C.UTF-8 \ - LC_ALL=C.UTF-8 - -# ---- Writable HOME under read-only root fs ---------------------------------- -ENV HOME=/tmp - -# ---- JVM ergonomics --------------------------------------------------------- -# Identical to src/Dockerfile: container-aware heap, fail-fast on OOM, heap dump to a -# writable mount, and Tomcat temp redirected to /tmp for a read-only root filesystem. -ENV JAVA_TOOL_OPTIONS="\ - -XX:MaxRAMPercentage=75 \ - -XX:+UseContainerSupport \ - -XX:+ExitOnOutOfMemoryError \ - -XX:+HeapDumpOnOutOfMemoryError \ - -XX:HeapDumpPath=/var/tmp/heap \ - -Dserver.tomcat.basedir=/tmp" - -# ---- Filesystem layout (read-only root filesystem) -------------------------- -# At runtime /var/tmp/heap and /tmp MUST be writable mounts (tmpfs/emptyDir). -RUN mkdir -p /var/tmp/heap && chmod 1777 /var/tmp/heap - -# ---- Non-root user ---------------------------------------------------------- -RUN groupadd --system --gid 1000 app \ - && useradd --system --uid 1000 --gid app --no-create-home --shell /usr/sbin/nologin app - -WORKDIR /app - -# ---- Application layers ----------------------------------------------------- -# One COPY per Spring Boot layer, least- to most-frequently-changed, matching src/Dockerfile. -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/dependencies/ ./ -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/spring-boot-loader/ ./ -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/snapshot-dependencies/ ./ -COPY --from=builder --chown=app:app /build/src/sample-portfolio/build/docker/extracted/application/ ./ - -USER app - -# ---- Ports ------------------------------------------------------------------ -# 8080 — application HTTP port -# 9001 — management / actuator port -EXPOSE 8080 9001 - -# ---- Health check ----------------------------------------------------------- -# Actuator readiness probe on the management port (9001). Ignored by Kubernetes, -# which uses its own probes — kept for docker/compose parity with src/Dockerfile. -HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \ - CMD wget --no-verbose --tries=1 --spider \ - http://localhost:9001/actuator/health/readiness || exit 1 - -# ---- Entrypoint ------------------------------------------------------------- -# mainClass (SamplePortfolioApplication) is baked into the bootJar manifest and survives the -# extraction into the thin application.jar. -ENTRYPOINT ["java", "-jar", "application.jar"] diff --git a/src/README.md b/src/README.md index 77e93d41..8d063639 100644 --- a/src/README.md +++ b/src/README.md @@ -26,11 +26,11 @@ Checkstyle은 **포매터가 표현할 수 없는 것만** — 네이밍과 몇 | `qualityCheck` | 모든 leaf의 SpotBugs + FindSecBugs를 실행 | | `configContractCheck` | `:app-bootstrap:verifyEnvKeys`로 환경 설정 계약을 검사 | | `qualificationCheck` | 전체 기동(system) 레인과 보조 source set Checkstyle을 실행 | -| `integrationCheck` | 선언된 strict integration lane(sample 포함)을 실행. 대부분 container runtime이 필요. 입력이 필요한 lane(Redis topology: `-Predis.topology.mode`, AWS: 보호 자격 증명 env)은 입력이 없으면 빠지고 집계가 그 이유를 출력 | +| `integrationCheck` | 선언된 strict integration lane을 실행. 대부분 container runtime이 필요. 입력이 필요한 lane(Redis topology: `-Predis.topology.mode`, AWS: 보호 자격 증명 env)은 입력이 없으면 빠지고 집계가 그 이유를 출력 | | `performanceCheck` | 선언된 strict performance lane(부하·종료·pool·자원 상한)을 실행. 실서버·container가 필요. 상한은 매번 단언하고 끄는 속성이 없다(`-Pperformance.assertions.enabled`가 `true`가 아니면 실패, skip된 테스트가 있어도 실패). `integration-main.yml` `performance-check`가 main·nightly에 같은 명령으로 돌림 | -| `verifyStrictLaneStages` | `--dry-run` 전용. `explicitOnly`가 아닌 strict lane이 workflow가 실제 실행하는 단계(`ci`·`:sample-portfolio:check`·`mainCheck`·`integrationCheck`·`performanceCheck`·`releaseCheck`) 중 하나의 계획에 있는지, 각 단계를 workflow가 `--dry-run` 없이 실행하는지 검사. Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-v`·`--help` 등)과, 실패해도 단계가 실패하지 않을 수 있거나(`\|\| true`, pipefail 없는 파이프, `if` 조건 등) 돌지 않을 수 있거나(조건부 `exit 0` 뒤, 요청으로만 시작하는 workflow, `paths` 필터로만 시작하는 workflow, `releaseCheck` 밖의 단계를 태그 push·`release`로만 시작하는 workflow 등) 검사가 읽지 않는(`\|\| exit 1`, `{ }` 안 등) 명령은 실행으로 세지 않는다. 자세한 목록은 `build-logic/README.md`. PR 게이트가 돌림 | +| `verifyStrictLaneStages` | `--dry-run` 전용. `explicitOnly`가 아닌 strict lane이 workflow가 실제 실행하는 단계(`ci`·`mainCheck`·`integrationCheck`·`performanceCheck`·`releaseCheck`) 중 하나의 계획에 있는지, 각 단계를 workflow가 `--dry-run` 없이 실행하는지 검사. Gradle이 작업을 돌리지 않는 명령(`--dry-run`·`-v`·`--help` 등)과, 실패해도 단계가 실패하지 않을 수 있거나(`\|\| true`, pipefail 없는 파이프, `if` 조건 등) 돌지 않을 수 있거나(조건부 `exit 0` 뒤, 요청으로만 시작하는 workflow, `paths` 필터로만 시작하는 workflow, `releaseCheck` 밖의 단계를 태그 push·`release`로만 시작하는 workflow 등) 검사가 읽지 않는(`\|\| exit 1`, `{ }` 안 등) 명령은 실행으로 세지 않는다. 자세한 목록은 `build-logic/README.md`. PR 게이트가 돌림 | | `ci` | PR 게이트: 모든 leaf `check`(API surface 검사 포함, 소유자 결정 20) + `architectureCheck` + `qualityCheck` | -| `mainCheck` | main 단계: `configContractCheck` + `qualificationCheck` + sample web 계약 + sample 전체 기동(`:sample-portfolio:systemTest`) + `verifyPublicPathSnapshot` + 전송·메시징 qualification 레인 + 각 leaf의 `mainCheck`(문서 대조 레인 `*DocumentContractTest`, objectstorage MinIO 레인) | +| `mainCheck` | main 단계: `configContractCheck` + `qualificationCheck` + `verifyPublicPathSnapshot` + 전송·메시징 qualification 레인 + 각 leaf의 `mainCheck`(문서 대조 레인 `*DocumentContractTest`, objectstorage MinIO 레인) | | `releaseCheck` | tag 전용 검사: `verifyReleaseProvenance` + `verifyPublicPathSnapshot`(`ci`를 다시 돌리지 않음) | 따라서 로컬에서 한 모듈만 수정했다면 `./gradlew :domain-core:check`처럼 focused task를 @@ -317,7 +317,7 @@ Kafka 없이 기동합니다. 나머지 기능은 `app-bootstrap/build.gradle` Kafka·Redis는 위 "기능 추가 = 한 줄 + env" 표의 한 줄로 고릅니다. 모듈이 있으면 켜지고, 없으면 그 포트를 구현하는 bean이 아예 없습니다. 아래는 모듈을 고른 뒤 동작을 고르는 키입니다. -- **`APP_CACHE_REDIS_ENABLED`** — deprecated(2026-11-30 제거 예정). 읽는 곳은 `sample-portfolio`뿐이고, +- **`APP_CACHE_REDIS_ENABLED`** — deprecated(2026-11-30 제거 예정). 읽는 곳이 없고, 기본 조립에서 Redis를 켜고 끄는 것은 `APP_REDIS_ENABLED`입니다. - **`APP_CACHE_CANONICAL_DEFAULT_PROVIDER`** — canonical default semantic region 선택. `disabled`(기본) | `redis`. `redis`는 canonical Redis CACHE role binding을 함께 요구합니다. @@ -359,10 +359,7 @@ app: - 기존 `APP_OUTBOUND_HTTP_*`와 `app.outbound.http.*`는 canonical 설정이 아닙니다. 루트 `src/.env`, `app-bootstrap`의 application YAML, env-key registry에서 제거됐으며 canonical composition에 입력하면 상태와 무관하게 기동을 거부합니다. -- 다만 `sample-portfolio`의 application YAML에는 legacy facade를 시연하기 위해 15개 키가 남아 - 있습니다. 이 모듈은 fixture/reference consumer이고 production 의존성이 아니며, 그 YAML은 - `:app-bootstrap:verifyEnvKeys`가 검사하는 세 파일에 포함되지 않습니다. "제거됐다"는 문장이 저장소 전체를 - 가리킨다고 읽히지 않도록 범위를 명시합니다. +- 그 키를 시연하던 샘플 모듈의 YAML은 2026-11-07 샘플과 함께 지웠습니다. 이제 저장소 어디에도 남아 있지 않습니다. - legacy JDK facade가 필요한 fork만 canonical composition 밖에서 `OutboundHttpSettings.bindLegacy(Binder)`와 legacy configuration을 명시적으로 import합니다. timeout/retry/CB/response-size 설정은 그 migration API 내부 계약일 뿐 canonical provider diff --git a/src/adapter/inbound/graphql/CLAUDE.md b/src/adapter/inbound/graphql/CLAUDE.md index 069ebbf2..89dd89bf 100644 --- a/src/adapter/inbound/graphql/CLAUDE.md +++ b/src/adapter/inbound/graphql/CLAUDE.md @@ -114,7 +114,7 @@ application/platform namespace split. `INBOUND_ADAPTERS_DO_NOT_DEPEND_ON_OUTBOUND_ADAPTERS`, 일반 `..adapter.inbound..` 규칙이 이 모듈을 자동 커버 — per-module 규칙 추가 불필요). - 프로덕션 feature 쿼리/뮤테이션을 스켈레톤에 두는 것 — health 표면만 (web 의 - `HealthcheckController` 와 동일 원칙). feature 스키마/컨트롤러/매퍼는 sample 모듈이 소유한다. + `HealthcheckController` 와 동일 원칙). feature 스키마/컨트롤러/매퍼는 그 기능을 가진 서비스가 소유한다. - 모듈별 `yml` — 설정은 프레임워크 `spring.graphql.*` 로 composition-root `application.yml` 에 산다. ## Error mapping (`Category → ErrorType`) @@ -139,7 +139,7 @@ DataLoader 키 실패는 등록된 `ApiErrorCode` 만 싣는다(`GraphQlBatchLoa - **도메인 예외 매핑**: adopter 는 자신의 `DataFetcherExceptionResolver` 를 추가하거나 `ApiErrorCarrier` 를 사용해 안정적 코드로 매핑할 수 있다. -현재 sample 에 feature GraphQL schema/controller/resolver 가 있다고 가정하지 않는다. 이 leaf 는 +템플릿에는 feature GraphQL schema/controller/resolver 가 없다. 이 leaf 는 health 스키마만 소유한다. ## 구현된 플랫폼 범위 — 등급으로 말한다 diff --git a/src/adapter/inbound/graphql/README.md b/src/adapter/inbound/graphql/README.md index 5462d7aa..ff9c7c63 100644 --- a/src/adapter/inbound/graphql/README.md +++ b/src/adapter/inbound/graphql/README.md @@ -22,8 +22,8 @@ Spring for GraphQL 은 schema-first 다. 빈 스키마로는 부팅이 실패하 스켈레톤은 **WorkLog 를 이름으로 알지 못한다.** 향후 composition root 가 이 모듈을 classpath 에 명시적으로 채택하고 feature 를 추가하면 Spring for GraphQL 이 다음 두 축으로 합성할 수 있다: -- **스키마**: `classpath:graphql/**/*.graphqls` 를 전부 병합한다. sample 모듈의 - 향후 `worklog.graphqls` 같은 feature 스키마는 스켈레톤의 `skeleton.graphqls` 와 합쳐진다. +- **스키마**: `classpath:graphql/**/*.graphqls` 를 전부 병합한다. 서비스가 더하는 + `order.graphqls` 같은 feature 스키마는 스켈레톤의 `skeleton.graphqls` 와 합쳐진다. - **resolver(핸들러)**: 컨텍스트의 모든 `@Controller` 의 `@QueryMapping`/`@MutationMapping` 메서드를 바인딩한다. 향후 feature 의 GraphQL controller 는 스켈레톤을 수정하지 않고 등록할 수 있다. @@ -48,7 +48,7 @@ Spring for GraphQL 은 schema-first 다. 빈 스키마로는 부팅이 실패하 맞는 값: local→`LOCAL`, dev→`DEV`, prod→`PRODUCTION_INTERNAL`|`PRODUCTION_PUBLIC`). production mode는 `GraphQlAuthorizationPolicy` bean도 필요하다. 나머지 `APP_GRAPHQL_*`는 기본값으로 동작한다. -`sample-portfolio` 에 feature GraphQL 스키마/controller 가 있다는 뜻은 아니며, leaf 자체는 최소 +템플릿에 feature GraphQL 스키마/controller 가 있다는 뜻은 아니며, leaf 자체는 최소 health 스키마로 독립 기동할 수 있다. ## 에러 매핑 — web `GlobalExceptionHandler` / gRPC 인터셉터의 GraphQL 형제 @@ -303,7 +303,7 @@ trivial fetcher 는 세지 않는다. 기본 10 은 기본 page 크기 20 보다 `ObservationRegistry` 로 나가며(Actuator 가 있으면 timer 로 집계), 없으면 WARN 만 남는다. 버린 대안: 카탈로그에 등록되지 않은 list 자식 필드를 기동 때 경고 — 모든 list 필드를 adopter 가 -카탈로그에 등록해야 의미가 생겨 비용에 비해 효과가 작다. 재검토 조건: sample 에 GraphQL feature 가 +카탈로그에 등록해야 의미가 생겨 비용에 비해 효과가 작다. 재검토 조건: 템플릿에 GraphQL feature 가 들어오면 그 코드가 위 예시를 대신한다. ## 요청 deadline — 무엇이 끊기고 무엇이 안 끊기나 diff --git a/src/adapter/inbound/grpc/CLAUDE.md b/src/adapter/inbound/grpc/CLAUDE.md index 4f431f17..5c4dff1a 100644 --- a/src/adapter/inbound/grpc/CLAUDE.md +++ b/src/adapter/inbound/grpc/CLAUDE.md @@ -90,7 +90,7 @@ credential path and a separately qualified non-loopback bind. ## Feature 기여 방법 -현재 저장소에는 production feature RPC나 sample gRPC service가 없다. 향후 feature를 도입할 +현재 저장소에는 feature RPC가 없다. 향후 feature를 도입할 때는 `.proto`/generated stub/`BindableService`를 해당 feature가 소유하고, 서비스 빈과 정확히 한 개의 caller-supplied `GrpcAuthenticationPolicy` 빈을 함께 제공한다. 정책이 없거나 여러 개면 listener 시작이 실패한다. 정책은 `Optional authenticate(Metadata)`이고, 돌려준 diff --git a/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java b/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java index e808c723..cb926654 100644 --- a/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java +++ b/src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/ApiErrorException.java @@ -6,7 +6,7 @@ import dev.caskeleton.shared.error.ApiErrorCode; /** * Adapter-level throwable a feature gRPC service throws after mapping a domain exception to a * stable {@link ApiErrorCode} (typically a feature code such as {@code - * PortfolioErrorCode.WORKLOG_NOT_FOUND} or a skeleton {@code OperationalError}). It implements the + * OrderErrorCode.ORDER_NOT_FOUND} or a skeleton {@code OperationalError}). It implements the * shared-contract {@link ApiErrorCarrier} hook so the {@link GrpcExceptionHandlingInterceptor} * translates it to the matching gRPC {@code Status} plus {@code code} / {@code category} trailers * through the same single carrier branch that handles the shared-contract infra exceptions. diff --git a/src/adapter/inbound/web-advanced/CLAUDE.md b/src/adapter/inbound/web-advanced/CLAUDE.md index 538dfff0..18d3212d 100644 --- a/src/adapter/inbound/web-advanced/CLAUDE.md +++ b/src/adapter/inbound/web-advanced/CLAUDE.md @@ -21,11 +21,11 @@ service adds and the settings are in [README.md](README.md). ## Rules -- Not in any default composition. `app-bootstrap` and `sample-portfolio` main must not depend on it; +- Not in any default composition. `app-bootstrap` main은 이 leaf에 의존하지 않는다; `app-bootstrap` takes it `testRuntimeOnly` so the whole-repository ArchUnit import reads it. - It depends on `adapter:inbound:web` (the `core` vocabulary), never the reverse. - No component-scannable stereotype. A consuming application may scan the adapter packages - (`sample-portfolio` scans `dev.caskeleton.adapter.inbound.web`), so a + (서비스가 `dev.caskeleton.adapter.inbound.web`을 scan할 수 있다), so a `@Configuration`/`@Component` here would be created whatever its switch says. Switched wiring is `@AutoConfiguration` + an imports line; imported helpers carry no stereotype (`MvcStreamingSupportConfiguration`). diff --git a/src/adapter/inbound/web-advanced/README.md b/src/adapter/inbound/web-advanced/README.md index 56e396a5..e7d8efac 100644 --- a/src/adapter/inbound/web-advanced/README.md +++ b/src/adapter/inbound/web-advanced/README.md @@ -3,7 +3,7 @@ **라이브러리 API — 서비스의 어댑터 leaf에서 `implementation`으로 받아 직접 호출; 기본 조립에 없음.** `adapter:inbound:web` 에 있던 코드 중 servlet 운영 경로가 닿지 않는 것만 모은 opt-in leaf 다. -`app-bootstrap`·`sample-portfolio` 는 이 leaf 에 의존하지 않는다. 패키지 루트는 +`app-bootstrap` 은 이 leaf 에 의존하지 않는다. 패키지 루트는 `dev.caskeleton.adapter.inbound.web.advanced` (web 과 겹치는 패키지 없음). ## 추가할 한 줄 diff --git a/src/adapter/inbound/web/CLAUDE.md b/src/adapter/inbound/web/CLAUDE.md index c3013563..35c66ca8 100644 --- a/src/adapter/inbound/web/CLAUDE.md +++ b/src/adapter/inbound/web/CLAUDE.md @@ -28,7 +28,7 @@ health and rate-limit beans; `WebSecurityAutoConfiguration` imports the JWT chai with its own posture excludes only that root; `WebMethodSecurityAutoConfiguration` imports method security and the permission port and stays when the chain is replaced; nobody scans this leaf), and the types -`app-bootstrap`, `sample-portfolio`, `web-fileserver` and `composition:fileserver-platform` name — +`app-bootstrap`, `web-fileserver` and `composition:fileserver-platform` name — plus their transitive references. Library code that no production path reaches (streaming, virtual threads, patch, codecs, OpenAPI 3.2, URI/method policy, versioning, operation, budget, contract, security-context bridge, `JsonIdempotentResponseCodec`, route inventory) lives in the opt-in leaf @@ -76,8 +76,7 @@ also drives the runtime patterns reference implementations must follow. `Optional` wrappers on request records. - **B3 — Mapper-internal failures.** Map record canonical-constructor `IllegalArgumentException`, MapStruct generated NPE, ACL normalization - failures, etc. by throwing `MappingException` (sample implementation in - `sample-portfolio`); the global handler routes it to `MAPPING_FAILED` (HTTP 400), + failures, etc. by throwing `MappingException`; the global handler routes it to `MAPPING_FAILED` (HTTP 400), never to `BAD_PARAMETER` or `INTERNAL_ERROR`. Plain `IllegalArgumentException` remains `BAD_PARAMETER` for non-mapper callers. - **B4 — Validation layering.** Class-level Bean Validation constraints belong @@ -111,16 +110,13 @@ Domain `@RestControllerAdvice` in a consuming module must be annotated `@Order(Ordered.HIGHEST_PRECEDENCE)` (or otherwise ordered ahead of this module's base `GlobalExceptionHandler`), because the base handler's catch-all `@ExceptionHandler(Exception.class)` would otherwise resolve domain exceptions -to `INTERNAL_ERROR`. See `sample-portfolio`'s `DomainExceptionHandler` for the -pattern. +to `INTERNAL_ERROR`. The base operational handler (`error/GlobalExceptionHandler`), the error-code contract (`dev.caskeleton.shared.error.ApiErrorCode` + `OperationalError`), the `error/ErrorResponseFactory`, and the `envelope/EnvelopeBodyAdvice` now live in production modules (`adapter:inbound:web` / `shared-contract`), so the running application -provides them without depending on `sample-portfolio`. Domain-specific exception -handlers and error codes live in the consuming module (see sample's -`DomainExceptionHandler` / `PortfolioErrorCode`). +provides them. 기능 전용 예외 handler와 오류 코드는 그 기능을 가진 모듈에 둔다(`docs/manual/06-errors.md`). ## Schema / serialization contract diff --git a/src/adapter/inbound/web/README.md b/src/adapter/inbound/web/README.md index b09e83d4..2fdd88d3 100644 --- a/src/adapter/inbound/web/README.md +++ b/src/adapter/inbound/web/README.md @@ -143,7 +143,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML `WebSecurityAutoConfiguration`(JWT/session 체인)이 아니라 이 auto-configuration이 들여온다. - 이유: 인증 방식(체인)을 바꾸는 애플리케이션은 `WebSecurityAutoConfiguration`만 뺀다. 둘이 한 root에 있을 때는 체인을 빼면 advisor도 같이 빠져서, 그 애플리케이션의 `@RequiresPermission`이 아무 경고 없이 - 주석이 됐다(샘플이 그랬다 — 익명 삭제 가능). 이제 체인을 바꿔도 권한 검사는 남는다. + 주석이 됐다(지운 샘플 모듈이 그랬다 — 익명 삭제 가능). 이제 체인을 바꿔도 권한 검사는 남는다. - 메서드 보안까지 끄려면 이 클래스를 따로 exclude 해야 한다. 그 결정은 exclude 목록에 이름으로 드러난다. ### MethodSecurityConfig @@ -229,8 +229,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - **등록은 한 곳이다.** `WebMvcPlatformAutoConfiguration` 의 `@ConditionalOnMissingBean` bean 하나뿐이다. `app.web.mvc.enabled=false` 면 이 핸들러·요청 id 필터·JSON 본문 상한·중복 키 거부가 함께 빠지고, 서비스가 셋을 직접 준다. 같은 타입 bean 을 주면 그것만 쓰인다(리뷰 02-10, `WebMvcPlatformAutoConfigurationTest`). -- `adapter-web` 에 위치하는 이유: 실행 앱이 어떤 sample 모듈에도 의존하지 않고 envelope 형식 에러 응답을 - 제공하도록. +- `adapter-web` 에 위치하는 이유: 실행 앱이 기능 모듈 없이도 envelope 형식 에러 응답을 제공하도록. - **`spanErrorRecorder`.** 프로덕션 코드를 특정 트레이서 라이브러리에 결합하지 않고 span 에러를 기록하기 위한 이음새. 기본값 `SpanErrorRecorder.NOOP`. `@Autowired` 생성자가 `ObjectProvider` 로 self-default 하므로 전체 컨텍스트 / `@WebMvcTest` 슬라이스 / 순수 단위 테스트 @@ -292,7 +291,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - **이미 직렬화된 `byte[]` 본문은 감싸지 않는다.** 그 본문을 쓰는 converter 는 받은 값을 그대로 복사하므로 envelope 객체를 받으면 500 으로 끝난다. springdoc 이 OpenAPI 문서를 `byte[]` 로 돌려주어, 감싸던 시절에는 실행 중인 앱의 `/api/v3/api-docs` 가 항상 500 이었다(리뷰 09-04). `String` 반환은 감싸되 JSON 문자열로 - 직렬화해 넘긴다(리뷰 02-06). 단언은 `EnvelopeBodyAdviceTest`, 샘플 전체 조합의 `SampleApiDocsSystemTest`. + 직렬화해 넘긴다(리뷰 02-06). 단언은 `EnvelopeBodyAdviceTest`. - **`String` 반환도 JSON 클라이언트에게는 Envelope 다.** `String` 은 `StringHttpMessageConverter` 가 Jackson 보다 먼저 고른다. 예전에는 그 컨버터에 `Envelope` 객체를 넘겨 `Accept: application/json` 이면 `ClassCastException` 500, `*/*` 면 200 text 였다(리뷰 02-06). 지금은 String 컨버터가 JSON 을 쓰게 될 때 @@ -301,8 +300,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML 용도를 막고, 규칙을 돌리지 않는 서비스에는 함정이 그대로 남는다. - **4xx·5xx 본문은 감싸지 않는다.** `success` 는 클라이언트가 가르는 판별자라, 오류 status 본문을 `success:true` 로 감싸면 성공으로 읽힌다. Boot `/error` 의 map 이 그렇게 나갔다(재리뷰 RR-02-02). -- 위치: sample 모듈이 아니라 adapter-web. 실행 앱은 adapter-web 에 의존하지만 sample-portfolio 에는 의존하지 - 않으므로, 응답 래핑이 실제로 동작하려면 여기 있어야 한다. +- 위치: adapter-web. 실행 앱이 늘 싣는 leaf 라, 응답 래핑이 실제로 동작하려면 여기 있어야 한다. ### EnvelopeErrorController - 컨트롤러에 닿기 전에 생긴 오류(보안 방화벽의 `RequestRejectedException`, 필터의 `sendError`, 필터가 @@ -323,7 +321,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - `SecurityConfig` 는 오류 **디스패치**만 허용한다(`DispatcherType.ERROR`). 예전에는 `/error` 가 공개 경로가 아니라서 익명 요청의 400 이 401 로 바뀌었다. `/error` 를 직접 부른 요청은 여전히 인증이 필요하다. 단언은 실제 Tomcat 의 `TomcatWebContractIT`(공유 `WebContractAssertions`)와 `JwtChainErrorDispatchIT`. -- 앱이 보안 체인을 직접 정의하면(예: sample 의 데모 체인) 같은 한 줄 +- 앱이 보안 체인을 직접 정의하면(예: 데모용 체인) 같은 한 줄 (`dispatcherTypeMatchers(DispatcherType.ERROR).permitAll()`)을 그 체인에도 둬야 원래 status 가 나간다. ### CacheControlFilter @@ -474,7 +472,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML ### JacksonNullableConfig - `JsonNullableModule` 을 Spring 관리 `ObjectMapper` 에 등록. 없으면 PATCH 요청 DTO 의 `JsonNullable`(B2)를 Jackson 이 역직렬화하지 못해 absent / explicit-null 구분이 조용히 붕괴된다. -- 스켈레톤 전역 web 관심사(공유 `Patch` 타입과 짝)라 도메인 샘플 모듈이 아니라 adapter-web 에 위치. +- 스켈레톤 전역 web 관심사(공유 `Patch` 타입과 짝)라 기능 모듈이 아니라 adapter-web 에 위치. ### IdempotencyKeyHeader - KEYED 엔드포인트가 헤더를 키로 바꾸는 유일한 지점(리뷰 02-12). 문법: 보이는 ASCII(`0x21`–`0x7E`) @@ -508,7 +506,7 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML ### MdcCorrelationIdPortAdapter - `WebMvcRequestIdFilter`가 무해화하고 MDC `correlation_id`에 넣은 값을 application-core의 `CorrelationIdPort`로 투영한다. -- absent/blank는 `Optional.empty()`로 반환한다. application/sample 계층은 SLF4J/MDC를 직접 +- absent/blank는 `Optional.empty()`로 반환한다. application 계층은 SLF4J/MDC를 직접 참조하지 않고 event-id fallback 정책만 소유한다. ### HeaderSanitizer @@ -587,11 +585,10 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML - web leaf에는 별도 DB replay 엔진을 두지 않는다. 같은 요청 의미를 web/application 두 계층이 서로 다른 fingerprint로 판정하면 동일 key의 의미가 endpoint마다 달라지기 때문이다. - 헤더 → 키 변환은 `IdempotencyKeyHeader` 하나로 한다(위 settings / config / http 절). -- production 예시는 sample의 poster image publication 경로다. controller는 key를 받기만 하고, - `PublishPosterImageUseCase`가 application `IdempotencyExecutor`를 사용한다. +- controller는 key를 받기만 하고, 유스케이스가 application `IdempotencyExecutor`를 쓴다. 템플릿에는 이 + 경로를 HTTP부터 끝까지 이은 업무 기능 예가 없다(`docs/manual/05-idempotency.md`). - response-loss system fixture도 동일한 application executor를 사용해, 연결이 끊긴 뒤 같은 key 재시도에서 첫 committed 결과가 복구되고 side effect가 한 번만 실행되는지 검증한다. ### JsonIdempotentResponseCodec -- `adapter:inbound:web-advanced` 로 옮겼다(운영 경로 호출자 0). sample 은 자기 codec - (`PosterImagePublicationReservationCodec`)을 쓰고, response-loss fixture 는 fixture 안의 익명 codec 을 쓴다. +- `adapter:inbound:web-advanced` 로 옮겼다(운영 경로 호출자 0). response-loss fixture 는 fixture 안의 익명 codec 을 쓴다. diff --git a/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java b/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java index 34decefd..9c9ff482 100644 --- a/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java +++ b/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebSecurityAutoConfiguration.java @@ -17,13 +17,13 @@ import org.springframework.core.Ordered; * envelope entry point and access-denied handler, CORS and their settings. * *

Separate from {@link WebAdapterAutoConfiguration} so an application that brings its own - * posture — the demo sample, a contract fixture — excludes exactly this class and still gets the - * error envelope, filters, health endpoint and rate limiting from the web root. Excluding it does - * not switch off {@code @RequiresPermission}: that is {@link WebMethodSecurityAutoConfiguration}, - * which an application keeps while it replaces the chain. Before this root was split from the web - * root, the only way to drop the security chain was to drop the whole root and component-scan the - * leaf back in minus two classes, and every new controller in the leaf then arrived in that scan - * whether it was meant to or not. + * posture — a demo, a contract fixture — excludes exactly this class and still gets the error + * envelope, filters, health endpoint and rate limiting from the web root. Excluding it does not + * switch off {@code @RequiresPermission}: that is {@link WebMethodSecurityAutoConfiguration}, which + * an application keeps while it replaces the chain. Before this root was split from the web root, + * the only way to drop the security chain was to drop the whole root and component-scan the leaf + * back in minus two classes, and every new controller in the leaf then arrived in that scan whether + * it was meant to or not. * *

First among auto-configurations for the same reason as the web root: the filter chain and the * JWT decoder have to exist before Spring Boot's own security auto-configurations decide whether to diff --git a/src/adapter/inbound/websocket/CLAUDE.md b/src/adapter/inbound/websocket/CLAUDE.md index 93d1bd06..4b54b060 100644 --- a/src/adapter/inbound/websocket/CLAUDE.md +++ b/src/adapter/inbound/websocket/CLAUDE.md @@ -111,7 +111,7 @@ envelope contains only `type`, bounded string `fields`, and `occurredAt`. The br own bounded executor, so the simple broker's fan-out to subscribers never runs on the thread that published the domain event; a full broker queue drops the event (best-effort, R1). -No current `sample-portfolio` feature publishes a WebSocket event or contributes a projector. +템플릿에는 WebSocket 이벤트를 발행하거나 projector를 기여하는 기능이 없다. ## Evidence and limits diff --git a/src/adapter/outbound/fileserver/CLAUDE.md b/src/adapter/outbound/fileserver/CLAUDE.md index 996be8b8..2f89dd43 100644 --- a/src/adapter/outbound/fileserver/CLAUDE.md +++ b/src/adapter/outbound/fileserver/CLAUDE.md @@ -30,7 +30,7 @@ verification, identifiers, audit, metrics). Design rationale lives in [README.md ## Forbidden -- Inbound adapters, persistence, `app-bootstrap`, `sample-portfolio` (ArchUnit +- Inbound adapters, persistence, `app-bootstrap` (ArchUnit `OUTBOUND_ADAPTERS_*` family rules). - Leaking filesystem, stream, framework, or provider types across the application ports. - Advertising a platform feature as implemented unless `docs/fileserver/support-matrix.md` lists it. diff --git a/src/adapter/outbound/identifier/CLAUDE.md b/src/adapter/outbound/identifier/CLAUDE.md index 12ee7c98..bd2ac640 100644 --- a/src/adapter/outbound/identifier/CLAUDE.md +++ b/src/adapter/outbound/identifier/CLAUDE.md @@ -35,15 +35,14 @@ Declared in [build.gradle](build.gradle); the registry entry is the SSOT. - `:domain-core` — a feature's server-assigned id adapter implements its domain `*IdFactory` port here (registry edge `adapter:outbound:identifier -> domain-core`; `docs/manual/02-new-feature.md`). - `com.github.f4b6a3:uuid-creator` (`libs.uuid.creator`) — UUIDv7 for - `UuidV7DurableOperationIdFactory`, the generator the sample's id adapters use. + `UuidV7DurableOperationIdFactory`. ## Forbidden - Persistence or web technology (JPA/Hibernate/Spring Data/Spring Web) — ArchUnit `identifier_adapter_does_not_depend_on_other_adapters_or_bootstrap`; `.claude/hooks/ca_import_gate.py` G4 가 쓰기 시점에 차단. -- inbound adapters, persistence adapters, other outbound leaves, `app-bootstrap`, - `sample-portfolio`. +- inbound adapters, persistence adapters, other outbound leaves, `app-bootstrap`. - External IO (HTTP / messaging / cache / DB) — that belongs in `adapter-outbound`. ## Test diff --git a/src/adapter/outbound/identifier/README.md b/src/adapter/outbound/identifier/README.md index f740eb57..95acbb3d 100644 --- a/src/adapter/outbound/identifier/README.md +++ b/src/adapter/outbound/identifier/README.md @@ -11,7 +11,7 @@ leaf 이름은 `identifier`지만 범용 식별자 생성기·clock·random 소스는 여기 없다. 식별자 생성은 durable operation id(UUIDv7) 하나뿐이고(아래), 기능이 서버에서 id를 정하면 그 기능의 domain `*IdFactory` 구현도 여기 둔다(`:domain-core` 의존이 그 때문이다). 예전 문서가 범용 생성기 계획을 현재 내용처럼 적었다. 이름은 바꾸지 않았다: Gradle 경로·registry id·소비자 -(`composition:service-runtime`, `app-bootstrap`, `sample-portfolio`)의 의존 선언이 모두 이 이름을 +(`composition:service-runtime`, `app-bootstrap`)의 의존 선언이 모두 이 이름을 쓰고, 바꿔서 얻는 것은 이름 하나뿐이다. 외부 연동이 없는 crypto 능력을 새로 둘 곳이 필요하면 이 leaf에 둔다. 그때 이 절을 고친다. @@ -34,7 +34,7 @@ leaf에 둔다. 그때 이 절을 고친다. ## UuidV7DurableOperationIdFactory `DurableOperationIdFactory`(application-core) 구현. `UuidCreator.getTimeOrderedEpochPlus1()`로 UUIDv7을 -만든다(샘플 id adapter와 같은 방식). operation id는 제출 이벤트의 event id가 되고, messaging platform +만든다. operation id는 제출 이벤트의 event id가 되고, messaging platform `MessageId`는 UUIDv7만 받는다. 예전에는 web controller가 `UUID.randomUUID()`(v4)로 만들어 모든 제출 이벤트가 발행 시점에 거부되어 DEAD가 됐다(리뷰 2026-11-01 06-06, Kafka relay lane이 발견). `composition:durable-operation`이 bean으로 조립한다. diff --git a/src/adapter/outbound/identifier/build.gradle b/src/adapter/outbound/identifier/build.gradle index 577351c6..d037ecb0 100644 --- a/src/adapter/outbound/identifier/build.gradle +++ b/src/adapter/outbound/identifier/build.gradle @@ -12,6 +12,6 @@ dependencies { // A feature's server-assigned id adapter implements its domain `*IdFactory` port here // (registry edge `adapter:outbound:identifier -> domain-core`); docs/manual/02-new-feature.md. implementation project(':domain-core') - // UUIDv7 ids (UuidV7DurableOperationIdFactory), the generator the sample's id adapters use. + // UUIDv7 ids (UuidV7DurableOperationIdFactory). implementation libs.uuid.creator } diff --git a/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java b/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java index 7e317892..472cbb94 100644 --- a/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java +++ b/src/adapter/outbound/identifier/src/main/java/dev/caskeleton/adapter/outbound/identifier/UuidV7DurableOperationIdFactory.java @@ -5,9 +5,9 @@ import dev.caskeleton.application.operation.DurableOperationId; import dev.caskeleton.application.operation.DurableOperationIdFactory; /** - * {@link DurableOperationIdFactory} minting time-ordered UUIDv7 ids, the same mechanism ({@code - * UuidCreator.getTimeOrderedEpochPlus1()}) the sample's identifier adapters use. The id is also the - * submission event's id, and the messaging platform's message id accepts only UUIDv7. + * {@link DurableOperationIdFactory} minting time-ordered UUIDv7 ids ({@code + * UuidCreator.getTimeOrderedEpochPlus1()}). The id is also the submission event's id, and the + * messaging platform's message id accepts only UUIDv7. */ public final class UuidV7DurableOperationIdFactory implements DurableOperationIdFactory { diff --git a/src/adapter/outbound/messaging/README.md b/src/adapter/outbound/messaging/README.md index 10323d26..433775e0 100644 --- a/src/adapter/outbound/messaging/README.md +++ b/src/adapter/outbound/messaging/README.md @@ -107,7 +107,7 @@ payload/envelope/exception-derived field는 받거나 렌더링하지 않는다. 있다. integration event 계약 검증은 루트 `verifyMessagingContracts`(`src/build.gradle`)가 한다. application-core· -shared-contract·sample-portfolio의 qualification lane 셋을 묶은 task다. 이 leaf는 그 검증에 관여하지 않는다. +shared-contract의 qualification lane 둘을 묶은 task다. 이 leaf는 그 검증에 관여하지 않는다. canonical path는 platform `PublishResult`의 confirmation/transmission evidence를 application `OutboxPublishOutcome`으로 명시적으로 변환하고, 실패 code를 `OutboxPublishAttempt`에 함께 싣는다. diff --git a/src/adapter/outbound/notification/build.gradle b/src/adapter/outbound/notification/build.gradle index 0d21c40b..b252150f 100644 --- a/src/adapter/outbound/notification/build.gradle +++ b/src/adapter/outbound/notification/build.gradle @@ -10,7 +10,7 @@ dependencies { implementation project(':application-notification') implementation project(':shared-contract') implementation project(':adapter:outbound:support') - // UUIDv7 for notification ids: the generator the sample's identifier adapters already use. + // UUIDv7 for notification ids: the generator adapter:outbound:identifier already uses. implementation libs.uuid.creator implementation 'org.springframework.boot:spring-boot-autoconfigure' diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java index 5ae5747c..24afb2bd 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/UuidV7Generator.java @@ -7,8 +7,8 @@ import java.util.Objects; import java.util.UUID; /** - * RFC 9562 UUIDv7, minted by uuid-creator — the same generator the sample's identifier adapters use - * (review S1-lead-2), rather than a second hand-written bit layout. + * RFC 9562 UUIDv7, minted by uuid-creator — the same generator the identifier adapter uses (review + * S1-lead-2), rather than a second hand-written bit layout. * *

Time-ordered rather than random because these identifiers are primary keys: a random UUID * scatters inserts across the whole index, and a notification table takes the highest insert rate diff --git a/src/adapter/outbound/objectstorage/CLAUDE.md b/src/adapter/outbound/objectstorage/CLAUDE.md index 973d3a8f..f7306d2f 100644 --- a/src/adapter/outbound/objectstorage/CLAUDE.md +++ b/src/adapter/outbound/objectstorage/CLAUDE.md @@ -36,8 +36,7 @@ readiness live in [README.md](README.md) and ## Forbidden -- Inbound adapters, sibling outbound adapters, persistence, app-bootstrap, or sample-portfolio - dependencies. +- Inbound adapters, sibling outbound adapters, persistence, or app-bootstrap dependencies. - Provider keys, paths, locators, SDK types, Spring types, or control-record types leaking into application-core. - A default provider/destination/namespace, local-dev in production, or startup mutation when the diff --git a/src/adapter/outbound/persistence-jpa/CLAUDE.md b/src/adapter/outbound/persistence-jpa/CLAUDE.md index 7aebdf5d..2508abee 100644 --- a/src/adapter/outbound/persistence-jpa/CLAUDE.md +++ b/src/adapter/outbound/persistence-jpa/CLAUDE.md @@ -192,8 +192,8 @@ module. The `fileserver` package is the current case: every `Jpa*` adapter there `@ConditionalOnProperty(prefix = "app.fileserver-platform", name = "enabled", havingValue = "true")`. Without the gate a composition root that merely includes this module builds those beans, and each of -them needs collaborators only the Fileserver configuration supplies — which is how `sample-portfolio` -came to fail on a Fileserver collaborator it has no use for. A store for a capability nobody enabled +them needs collaborators only the Fileserver configuration supplies. 지운 샘플 모듈이 쓰지도 않는 +Fileserver 협력 객체 때문에 기동에 실패한 일이 그 예다. A store for a capability nobody enabled should not exist. ## Allowed @@ -340,7 +340,7 @@ PostgreSQL `57P01`, `57P02`) or a transport break with no SQLState becomes Audit metadata (`created_at` / `updated_at` / `created_by` / `updated_by`) is an infrastructure concern that must never reach `domain-core`. It lives only on the `audit/AuditableEntity` `@MappedSuperclass`; a domain aggregate persistence entity opts in -by extending it (e.g. the sample `WorkLogEntity`). The domain aggregate itself carries +by extending it (생성 명령이 만드는 서비스 persistence leaf의 엔티티가 그렇게 한다). The domain aggregate itself carries zero audit fields, enforced by ArchUnit `domain_is_pure` (no `jakarta.persistence..`) plus `domain_entities_do_not_carry_audit_fields` (no `createdAt`/`updatedAt`/`createdBy`/`updatedBy` fields under `..domain..`). diff --git a/src/adapter/outbound/persistence-jpa/README.md b/src/adapter/outbound/persistence-jpa/README.md index 065b17a0..fcc260cf 100644 --- a/src/adapter/outbound/persistence-jpa/README.md +++ b/src/adapter/outbound/persistence-jpa/README.md @@ -50,8 +50,7 @@ durable operation HTTP 엔드포인트(`POST /operations`·`GET`·`DELETE /opera append 포트(`APP_OUTBOX_ENABLED=true`)가 모두 있을 때만 켜진다. submit·cancel에는 `operation-submit` 역할(`operation:submit`, `operation:cancel`)이 필요하다. -애플리케이션이 제공해야 하는 bean: `Clock`, `DomainContextPropagator`(app-bootstrap과 -sample-portfolio가 제공). +애플리케이션이 제공해야 하는 bean: `Clock`, `DomainContextPropagator`(app-bootstrap이 제공). **필요한 env 키** (`src/.env.example`, 레지스트리 `docs/registries/env-keys.yaml`) @@ -173,10 +172,10 @@ Spring Boot 메인 클래스는 `dev.caskeleton.bootstrap` 에 있어서, `@Auto 소유한 모듈에 둬서 와이어링을 그 자리에 유지한다. ### 왜 이름이 `JpaConfig` 가 아닌가 -sample 모듈에 이미 `...sample.portfolio.adapter.persistence.config.JpaConfig` 가 있다. IDE 의 -"Run main class" 가 테스트 스코프 sample 모듈을 클래스패스에 올리면, simple name `JpaConfig` 를 +서비스가 자기 설정 클래스에 `JpaConfig` 라는 이름을 쓰기 쉽다. 그러면 simple name `JpaConfig` 를 공유하는 두 `@Configuration` 이 기본 빈 이름 `jpaConfig` 에서 충돌한다 -(`ConflictingBeanDefinitionException`). 다른 simple name 으로 이를 피한다. +(`ConflictingBeanDefinitionException`). 다른 simple name 으로 이를 피한다. 처음 충돌한 곳은 지운 +샘플 모듈의 `JpaConfig` 였다. ## failure — 퍼시스턴스 실패 변환 SPI @@ -589,7 +588,7 @@ holder 가 락을 잡을 수 있다. 아래)이 아래 가드를 등록한다. 전부 `adapter:outbound:support`의 `StartupFailures`로 실패하므로 exit 코드(78/70/71)와 구조화 로그 필드(`startup.phase`/`error.code`/`error.category`)는 옮기기 전과 같다. `migrationStartupRunner`는 `@ConditionalOnMissingBean(FlywayMigrationStrategy)`라, 자기 전략을 둔 -애플리케이션(sample-portfolio의 두 번째 마이그레이션 스트림)에는 끼어들지 않는다. +애플리케이션(예: 두 번째 마이그레이션 스트림을 돌리는 서비스)에는 끼어들지 않는다. ### FlywayProdSafetyValidator - **`prod` 프로파일에서 Flyway 안전장치가 꺼지지 못하도록 런타임에서 강제한다.** Flyway 옵션은 diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java index b26c8b41..a40f9cd4 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceJpaConfig.java @@ -8,7 +8,7 @@ import org.springframework.data.jpa.repository.config.EnableJpaRepositories; * Registers this module's always-installed JPA entities and Spring Data repositories. * *

The explicit scans are required because the Boot main class lives in another package; the - * simple name avoids {@code JpaConfig} to dodge a bean-name collision with the sample module. See + * simple name avoids {@code JpaConfig}, a name a service's own configuration is likely to take. See * README "config". * *

The package list is enumerated rather than given as the persistence root. {@code diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java index 3a933778..e23e34ca 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/jpa/JpaOutboxStore.java @@ -125,7 +125,7 @@ public class JpaOutboxStore * and increments the committed counter instead (review RR-03-01). * *

Statements rather than one {@code INSERT … ON CONFLICT DO UPDATE … RETURNING} like {@code - * JpaLiveEventReplay}'s position allocator: the sample appends events on the H2 developer run + * JpaLiveEventReplay}'s position allocator: a service appends events on the H2 developer run * ({@code bootRunH2}), and H2 accepts {@code ON CONFLICT DO NOTHING} but not {@code DO UPDATE}. * The common case — the counter exists — is still one {@code UPDATE} and one read. */ diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java index 64816cff..d77279fd 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/startup/JpaStartupAutoConfiguration.java @@ -60,7 +60,7 @@ class JpaStartupAutoConfiguration { * Runs Flyway during refresh, before readiness, and turns a failure into exit 70. * *

The bean name is what Flyway auto-configuration looks up. An application that supplies its - * own strategy — the sample runs a second migration stream — keeps it. + * own strategy — to run a second migration stream, say — keeps it. */ @Bean @ConditionalOnMissingBean(FlywayMigrationStrategy.class) diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java index 57e0d4a6..fad7c2cd 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/CandidateAdapterCompositionTest.java @@ -10,12 +10,11 @@ import org.springframework.stereotype.Repository; * A candidate implementation nobody selected must not be composed. * *

{@code CaSkeletonApplication} excludes {@code dev.caskeleton.adapter.outbound.persistence..*} - * from its component scan, but {@code SamplePortfolioApplication} scans all of {@code - * dev.caskeleton}. So a {@code @Repository} on a PostgreSQL-only adapter becomes a bean there — - * including under H2, which has no migration tree at all, and in a database that never applied the - * optional stream the adapter reads. The bean exists and its tables do not: the failure surfaces as - * vendor-specific SQL against a missing relation, or as a boot failure under {@code - * ddl-auto=validate}. + * from its component scan, but a service application may scan all of {@code dev.caskeleton}. So a + * {@code @Repository} on a PostgreSQL-only adapter becomes a bean there — including under H2, which + * has no migration tree at all, and in a database that never applied the optional stream the + * adapter reads. The bean exists and its tables do not: the failure surfaces as vendor-specific SQL + * against a missing relation, or as a boot failure under {@code ddl-auto=validate}. */ class CandidateAdapterCompositionTest { diff --git a/src/adapter/outbound/persistence-mongo/CLAUDE.md b/src/adapter/outbound/persistence-mongo/CLAUDE.md index 78581cee..71ce0ab9 100644 --- a/src/adapter/outbound/persistence-mongo/CLAUDE.md +++ b/src/adapter/outbound/persistence-mongo/CLAUDE.md @@ -64,15 +64,14 @@ design package's assumed module layout onto this leaf lives in carry it. The leaf is imperative only: the reactive twin (`reactive/**`, reactive transactions/sessions), the change-stream consumer and the change-stream-to-messaging bridge were removed on 2026-09-25 (see `docs/capability-status.md`), so the leaf carries neither the reactive - starter nor the reactive-streams driver (`MongoReactiveDriverAbsenceTest`). `sample-portfolio` - does not carry it. + starter nor the reactive-streams driver (`MongoReactiveDriverAbsenceTest`). - External includes the (sync) Mongo starter, spring-boot-autoconfigure, spring-boot-health, micrometer-core, slf4j-api, and the configuration processor. Jackson annotations are compile-only because Boot Health carries Jackson annotations while runtime JSON serialization remains application-owned. Versions come from the shared Spring Boot BOM; never pin the driver directly. - Test-only: ArchUnit, Testcontainers (`mongodb`, `toxiproxy`). ## Forbidden -- Inbound adapters, sibling outbound adapters, `app-bootstrap`, `sample-portfolio` (ArchUnit +- Inbound adapters, sibling outbound adapters, `app-bootstrap` (ArchUnit `OUTBOUND_ADAPTERS_*` family rules). - Shipping placeholder `Example*` document, repository, record, or adapter types in production. - Adding idempotency/outbox/lock on Mongo without a separately approved contract. diff --git a/src/app-bootstrap/CLAUDE.md b/src/app-bootstrap/CLAUDE.md index 4b669b38..e12f76f1 100644 --- a/src/app-bootstrap/CLAUDE.md +++ b/src/app-bootstrap/CLAUDE.md @@ -65,12 +65,10 @@ configurations, Redis as one 376-line class. composition every application needs: `common` (the clock). The outbox relay, the idempotency executor and the durable operations (use cases and `/operations` endpoints, 07-08) are `composition:outbox-relay`, `composition:idempotency` and `composition:durable-operation`, selected - by one `runtimeOnly` line each and building nothing until their ports exist (the sample takes the - idempotency one too). A capability's role→permission mapping ships in its own - `config/module-defaults` file, not in `config/security.yml`. The runtime wiring both composition roots need — + by one `runtimeOnly` line each and building nothing until their ports exist. A capability's role→permission mapping ships in its own + `config/module-defaults` file, not in `config/security.yml`. The runtime wiring every composition root needs — tracing, the metrics contract filters, domain-context propagation, user-principal pseudonymization - (`PrivacySettings`) and the actuator chain — is `composition:service-runtime`, which the sample - takes by the same line instead of carrying copies. + (`PrivacySettings`) and the actuator chain — is `composition:service-runtime`. - **`Settings` lives beside its capability**, not in `settings/`. The `settings/` package holds only settings that belong to no capability — `BootstrapSettings`, `RuntimeSafetySettings` — bound strictly with `StrictSettingsBinder`, never scanned. Logging has no settings record: diff --git a/src/app-bootstrap/README.md b/src/app-bootstrap/README.md index 91b2b7ee..1be5fd00 100644 --- a/src/app-bootstrap/README.md +++ b/src/app-bootstrap/README.md @@ -302,8 +302,7 @@ DB 연결이 꼭 필요한 persistence-jpa의 datasource 버전 검사는 bean executor 조립(`IdempotencyAutoConfiguration`)과 수명 정책(`IdempotencySettings`, strict 바인딩), 설정 기본값(`config/module-defaults/idempotency.yml`, 예전 `config/capabilities.yml`)은 -`composition:idempotency`로 옮겼다(소유자 결정 3). 이 leaf는 `runtimeOnly` 한 줄로 받고, -sample-portfolio도 같은 줄을 쓴다. 근거는 [그 모듈의 README](../composition/idempotency/README.md). +`composition:idempotency`로 옮겼다(소유자 결정 3). 이 leaf는 `runtimeOnly` 한 줄로 받는다. 근거는 [그 모듈의 README](../composition/idempotency/README.md). ## outbox — 트랜잭셔널 아웃박스 릴레이 (composition:outbox-relay로 이동) @@ -509,9 +508,6 @@ ArchUnit 규칙이 **금지**하는 타입을 fixture 가 일부러 import 해 - `spring-cloud-context` — `@RefreshScope` 금지(no-refresh-scope) fixture 용. Spring Cloud 는 production 에 없고 규칙은 애너테이션을 FQN 문자열로 참조한다. BOM 이 spring-cloud 좌표를 관리하지 않아 버전을 명시 고정한다. -- **`testImplementation project(':sample-portfolio')`** — ArchUnit 이 템플릿 reference 구현을 분석하려고 - test 경로에만 둔다. **production 은 절대 sample-portfolio 에 의존 금지** — - `production_code_does_not_depend_on_sample_portfolio` 규칙이 강제한다. ### 빌드 설정 - **test JVM UTC 고정(`-Duser.timezone=UTC`)** — `RuntimeHealthLifecycleContractTest`가 diff --git a/src/app-bootstrap/build.gradle b/src/app-bootstrap/build.gradle index 6aea0486..e98e280c 100644 --- a/src/app-bootstrap/build.gradle +++ b/src/app-bootstrap/build.gradle @@ -124,7 +124,7 @@ sourceSets { // Every capability a service can select — the commented runtimeOnly lines below — listed once. // Three consumers read it — the environment contract's metadata classpath (verifyEnvKeys, below) // and these two: the whole-repository ArchUnit import (spec §7: the architecture suite sees -// every module of this build and the sample, the shipped runtime only the selected ones; the +// every module of this build, the shipped runtime only the selected ones; the // optional-platforms build is held by its own Gradle direction gate instead) and the qualification artifact the // Compose lanes boot (qualificationBootJar, below). None of them reaches `bootJar`, `test` or // `systemTest`, because a capability on a classpath is switched on there by its mere presence. @@ -169,26 +169,22 @@ dependencies { // runtimeOnly project(':composition:notification-platform') // 알림 (persistence-jpa·persistence-notification을 함께 가져온다) // 기본 조립에 있는 application composition. 셋 다 포트만 보고, 필요한 것(outbox store, 멱등성 - // provider)이 없으면 아무것도 만들지 않는다. sample-portfolio도 같은 멱등성 모듈을 쓴다. + // provider)이 없으면 아무것도 만들지 않는다. runtimeOnly project(':composition:outbox-relay') // outbox relay (store·발행 포트가 있을 때만) runtimeOnly project(':composition:idempotency') // 요청 멱등성 executor (provider≠disabled) runtimeOnly project(':composition:durable-operation') // /operations (operation store·outbox가 있을 때만) // 모든 서비스가 받는 runtime 배선: tracing, metrics 계약 filter, domain context, user principal - // 가명화, actuator 보안 chain. sample-portfolio도 같은 줄을 쓴다. + // 가명화, actuator 보안 chain. runtimeOnly project(':composition:service-runtime') // Contract tests pin those pieces by type (tracing gauge, metrics filters, actuator chain). testImplementation project(':composition:service-runtime') integrationTestImplementation project(':composition:service-runtime') capabilityProjects.each { architectureTestRuntimeOnly project(it) } - // The sample is the reference adopters copy, so the whole-repository rules read it too (review - // BUILD-중복-8). Architecture-test runtime only: no production configuration reaches it. - // // What this import does NOT see: the optional-platforms build (`grpc:*`, `grpc-advanced:*`). // It is a separate Gradle build, so its classes cannot be on this classpath; its registered // leaves are held by the Gradle direction gate (`-p optional-platforms ci` runs // verifyCleanArchitectureDependencies), which is the whole of what the owner decided it needs. - architectureTestRuntimeOnly project(':sample-portfolio') // The capability integration lane selects Fileserver and object storage together, as a service // would, and turns off whichever one a test is not about. @@ -351,8 +347,6 @@ def repositoryContractInputs = files( }, fileTree(rootProject.projectDir) { include 'config/**', '**/*.gradle', 'gradle/*.toml', 'Dockerfile*', '.env*', '**/src/main/**' - // SampleRuntimeDefaultsContractTest compares the sample's runtime defaults with these. - include 'sample-portfolio/src/main/resources/application.yml' exclude '**/*.md' exclude repositoryContractExcludes }) diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java index f32f513e..f47f24c6 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java @@ -46,7 +46,7 @@ class RuntimeProfileAccessArchitectureTest { .that() .resideInAPackage("dev.caskeleton..") .and() - .resideOutsideOfPackages("dev.caskeleton.messaging..", "dev.caskeleton.sample..") + .resideOutsideOfPackage("dev.caskeleton.messaging..") .and(DescribedPredicate.not(A_NAMED_PROFILE_READER)) .should() .callMethod(Environment.class, "getActiveProfiles") diff --git a/src/app-bootstrap/src/main/resources/config/security.yml b/src/app-bootstrap/src/main/resources/config/security.yml index 4ed3b8a6..5037d38a 100644 --- a/src/app-bootstrap/src/main/resources/config/security.yml +++ b/src/app-bootstrap/src/main/resources/config/security.yml @@ -35,8 +35,7 @@ app: # wildcards — least-privilege, OWASP-AUTHZ-C4). A capability's own permissions arrive with it, in # that module's config/module-defaults file (notification, fileserver, durable-operation), and # leave with its build line (07-08). Map entries from every source merge, so a deployment adds its - # own roles in its profile file or environment beside them. Sample-domain permissions live in - # sample-portfolio. + # own roles in its profile file or environment beside them. cors: # true | false enabled: ${APP_SECURITY_CORS_ENABLED:false} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java index 546ec57d..1d1fa39d 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java @@ -383,25 +383,6 @@ class DeveloperExperienceContractTest { .contains("./gradlew -p optional-platforms integrationCheck"); } - @Test - @Tag("repository-contract") - @DisplayName("샘플 이미지의 의존성 단계는 릴리스 이미지와 같은 파일을 같은 순서로 복사한다") - void theSampleImageDependencyStageCopiesWhatTheReleaseImageCopies() throws IOException { - // given - String release = read("src/Dockerfile"); - String sample = read("src/Dockerfile.sample"); - - // when - List releaseCopies = dependencyStageCopies(release); - List sampleCopies = dependencyStageCopies(sample); - - // then - // The sample's copy of this stage once missed gradle.properties and build-logic/, so settings - // could not resolve the convention plugins and the image did not build at all (07-04). - assertThat(sampleCopies).isNotEmpty().isEqualTo(releaseCopies); - assertDockerDependencyCacheContract("src/Dockerfile.sample", sample); - } - @Test @Tag("repository-contract") @DisplayName("compose 종료 유예 시간은 웹 drain, async 대기, preStop, 여유를 모두 더한 값 이상이다") @@ -491,11 +472,6 @@ class DeveloperExperienceContractTest { return mappings; } - private static List dependencyStageCopies(String dockerfile) { - String prefix = dockerfile.substring(0, dockerfile.indexOf("./gradlew")); - return prefix.lines().filter(line -> line.startsWith("COPY ")).toList(); - } - @Test @Tag("repository-contract") void dockerBuildConsumesOnlyTheGradleStagedExecutableJar() throws IOException { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java deleted file mode 100644 index 805a300f..00000000 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SampleRuntimeDefaultsContractTest.java +++ /dev/null @@ -1,214 +0,0 @@ -package dev.caskeleton.bootstrap.contract; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.bootstrap.contract.support.RepositoryContractResources; -import java.io.IOException; -import java.io.UncheckedIOException; -import java.nio.file.Files; -import java.nio.file.Path; -import java.util.ArrayDeque; -import java.util.ArrayList; -import java.util.Deque; -import java.util.LinkedHashMap; -import java.util.LinkedHashSet; -import java.util.List; -import java.util.Map; -import java.util.Set; -import java.util.TreeSet; -import java.util.regex.Matcher; -import java.util.regex.Pattern; -import java.util.stream.Stream; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Tag; -import org.junit.jupiter.api.Test; -import org.yaml.snakeyaml.LoaderOptions; -import org.yaml.snakeyaml.Yaml; -import org.yaml.snakeyaml.constructor.SafeConstructor; - -/** - * The sample keeps the default composition's runtime defaults, so a number measured on the sample — - * thread count, pool wait — says something about the composition a service ships (09-08), and it - * carries only settings something on its classpath reads. It reads configuration files, build - * scripts and production sources, so it runs in the pull-request {@code repository-contract} lane - * (08-03). - */ -@Tag("repository-contract") -class SampleRuntimeDefaultsContractTest { - - private static final Path REPOSITORY_ROOT = repositoryRoot(); - private static final Pattern DEFAULT = Pattern.compile("^\\$\\{[A-Z0-9_]+:(.*)}$"); - - @Test - @DisplayName("샘플은 가상 스레드와 앱 로그 레벨 기본값을 기본 조합과 같게 둔다") - void theSampleKeepsTheDefaultCompositionRuntimeDefaults() throws IOException { - // given - Map bootstrap = new LinkedHashMap<>(); - flatten("", load("src/app-bootstrap/src/main/resources/application.yml"), bootstrap); - flatten("", load("src/app-bootstrap/src/main/resources/config/observability.yml"), bootstrap); - Map sample = new LinkedHashMap<>(); - flatten("", load("src/sample-portfolio/src/main/resources/application.yml"), sample); - - // when - Map differing = new LinkedHashMap<>(); - for (String key : - new String[] {"spring.threads.virtual.enabled", "logging.level.dev.caskeleton"}) { - String expected = defaultOf(bootstrap.get(key)); - String actual = defaultOf(sample.get(key)); - if (actual != null && !actual.equals(expected)) { - differing.put(key, actual + " (default composition: " + expected + ")"); - } - } - - // then - assertThat(differing).isEmpty(); - } - - @Test - @DisplayName("샘플은 persistence-jpa 모듈의 풀 대기 시간 기본값을 덮어쓰지 않는다") - void theSampleDoesNotOverrideTheModulePoolWait() throws IOException { - // given - Map sample = new LinkedHashMap<>(); - flatten("", load("src/sample-portfolio/src/main/resources/application.yml"), sample); - - // when - Object connectionTimeout = sample.get("spring.datasource.hikari.connection-timeout"); - - // then - // The module's 5000 ms is a fail-fast decision; the sample's 30000 made a dry pool wait six - // times longer there than in the default composition. - assertThat(connectionTimeout).isNull(); - } - - @Test - @DisplayName("샘플 application.yml의 app.* 설정 묶음은 샘플 classpath에 있는 모듈 코드가 읽는다") - void everySampleAppSettingGroupIsReadByAModuleOnTheSampleClasspath() throws IOException { - // given - Set groups = new TreeSet<>(); - for (Object document : loadAll("src/sample-portfolio/src/main/resources/application.yml")) { - if (document instanceof Map map && map.get("app") instanceof Map app) { - app.keySet().forEach(key -> groups.add(String.valueOf(key))); - } - } - Set classpath = sampleRuntimeModules(); - - // when - Set unread = new TreeSet<>(); - for (String group : groups) { - Pattern reader = Pattern.compile("app\\." + Pattern.quote(group) + "[\".}]"); - if (classpath.stream().noneMatch(module -> anyMainSourceMatches(module, reader))) { - unread.add("app." + group); - } - } - - // then - // The sample is copied first. A block nothing on its classpath reads — the HTTP client's - // timeouts with no HTTP client module, a messaging broker with no messaging module — is a - // setting the copier believes is in force and is not (review 2026-11-03 RR-06-06, 09-08). - assertThat(unread) - .as("app.* groups in the sample's application.yml that nothing reads") - .isEmpty(); - } - - /** The source directories of the sample and every project its production configurations reach. */ - private static Set sampleRuntimeModules() throws IOException { - String registry = - Files.readString(REPOSITORY_ROOT.resolve("src/config/architecture/modules.json")); - Map sourceOf = new LinkedHashMap<>(); - Matcher module = - Pattern.compile("\"gradle_path\":\\s*\"([^\"]+)\",\\s*\"source_path\":\\s*\"([^\"]+)\"") - .matcher(registry); - while (module.find()) { - sourceOf.put(module.group(1), module.group(2)); - } - sourceOf.put(":sample-portfolio", "src/sample-portfolio"); - Pattern edge = - Pattern.compile( - "(?m)^\\s*(?:api|implementation|runtimeOnly)\\s*\\(?\\s*project\\(\\s*['\"](:[^'\"]+)['\"]"); - Set reached = new LinkedHashSet<>(); - Deque pending = new ArrayDeque<>(List.of(":sample-portfolio")); - Set seen = new LinkedHashSet<>(); - while (!pending.isEmpty()) { - String path = pending.pop(); - String source = sourceOf.get(path); - if (!seen.add(path) || source == null) { - continue; - } - Path directory = REPOSITORY_ROOT.resolve(source); - reached.add(directory); - Matcher dependency = edge.matcher(Files.readString(directory.resolve("build.gradle"))); - while (dependency.find()) { - pending.add(dependency.group(1)); - } - } - return reached; - } - - private static boolean anyMainSourceMatches(Path module, Pattern reader) { - Path sources = module.resolve("src/main/java"); - if (!Files.isDirectory(sources)) { - return false; - } - try (Stream files = Files.walk(sources)) { - return files - .filter(file -> file.toString().endsWith(".java")) - .anyMatch( - file -> { - try { - return reader.matcher(Files.readString(file)).find(); - } catch (IOException failure) { - throw new UncheckedIOException(failure); - } - }); - } catch (IOException failure) { - throw new UncheckedIOException(failure); - } - } - - private static List loadAll(String relative) throws IOException { - LoaderOptions options = new LoaderOptions(); - options.setMaxAliasesForCollections(0); - List documents = new ArrayList<>(); - new Yaml(new SafeConstructor(options)) - .loadAll(Files.readString(REPOSITORY_ROOT.resolve(relative))) - .forEach(documents::add); - return documents; - } - - private static String defaultOf(Object value) { - if (value == null) { - return null; - } - String text = String.valueOf(value).trim(); - Matcher matcher = DEFAULT.matcher(text); - return matcher.matches() ? matcher.group(1) : text; - } - - private static Map load(String relative) throws IOException { - LoaderOptions options = new LoaderOptions(); - options.setMaxAliasesForCollections(0); - Object first = - new Yaml(new SafeConstructor(options)) - .loadAll(Files.readString(REPOSITORY_ROOT.resolve(relative))) - .iterator() - .next(); - assertThat(first).as(relative).isInstanceOf(Map.class); - return (Map) first; - } - - private static void flatten(String prefix, Map map, Map into) { - map.forEach( - (key, value) -> { - String name = prefix.isEmpty() ? String.valueOf(key) : prefix + "." + key; - if (value instanceof Map child) { - flatten(name, child, into); - } else { - into.put(name, value); - } - }); - } - - private static Path repositoryRoot() { - return RepositoryContractResources.fromSystemProperty().repositoryRoot(); - } -} diff --git a/src/application-core/CLAUDE.md b/src/application-core/CLAUDE.md index 64110b78..0d8b3171 100644 --- a/src/application-core/CLAUDE.md +++ b/src/application-core/CLAUDE.md @@ -274,7 +274,7 @@ generation; the V1 `IdempotencyScope`/`tryBegin` API is gone. - **Executor**: built once by `composition:idempotency` `IdempotencyAutoConfiguration` from `IdempotencySettings` (processing lease 30s, replay TTL `APP_IDEMPOTENCY_TTL` 24h ≤72h and not shorter than the lease, failure retention 24h and not shorter than the replay TTL). Do not - construct it in a use case or a sample config. + construct it in a use case or a service's own config. - The action returns `IdempotentAction.Outcome` (`Success` / `RetryableNoEffect` / `EffectUnknown`); a thrown exception counts as effect-unknown. In progress → 409 `IDEMPOTENT_IN_FLIGHT`, fingerprint mismatch (SHA-256) → 422 `IDEMPOTENT_REQUEST_MISMATCH`; @@ -310,15 +310,14 @@ The read side has two equally-valid shapes; pick per read, do not force one: | Shape | Returns | When | How | |---|---|---|---| -| **Through-aggregate** (default for simple reads) | domain aggregate via a `*Repository` port | read shape == write aggregate **and** the aggregate is the minimal invariant boundary (no lazy collections needed) | `QueryUseCase` → repository port → `WorkLog` | -| **Projection (CQRS-lite)** | application-layer projection DTO via a `*QueryPort` | read shape ≠ write, or to skip aggregate hydration / lazy-collection joins | `QueryUseCase` → `*QueryPort` → `WorkLogSummary` (record); query via JPQL `SELECT new` / JdbcTemplate | +| **Through-aggregate** (default for simple reads) | domain aggregate via a `*Repository` port | read shape == write aggregate **and** the aggregate is the minimal invariant boundary (no lazy collections needed) | `QueryUseCase` → repository port → `Order` | +| **Projection (CQRS-lite)** | application-layer projection DTO via a `*QueryPort` | read shape ≠ write, or to skip aggregate hydration / lazy-collection joins | `QueryUseCase` → `*QueryPort` → `OrderSummary` (record); query via JPQL `SELECT new` / JdbcTemplate | - **Purity guardrail (core, machine-enforced):** a read port whose simple name ends with `QueryPort` MUST return application-layer projection DTOs only — never a domain aggregate, JPA entity, or web type, **including through generic type arguments** (`List`). Enforced by ArchUnit `query_ports_do_not_leak_domain_jpa_or_web_types`. - Projection usage itself is **opt-in**, not a forced default; the demo lives in - `sample-portfolio` (`WorkLogSummaryQueryPort` / `WorkLogSummary`). + Projection usage itself is **opt-in**, not a forced default. - **Strict ceremony:** every read goes through a `QueryUseCase` bean. There is no thin web→read-port path — that would bypass the mandatory `@UseCaseCapability` fitness function. - **Transaction:** reads default to `TransactionPort.inRead`. A no-tx (autocommit) read diff --git a/src/application-core/README.md b/src/application-core/README.md index 639d067f..cce525f4 100644 --- a/src/application-core/README.md +++ b/src/application-core/README.md @@ -286,7 +286,7 @@ application 계층이 claim·replay·복구 **정책** 을 소유하고, 저장 실행 중이면 주인은 여전히 `complete`·`markFailed` 할 수 있다(RR5-01-02). - 생성은 app-bootstrap `IdempotencyProviderSelectionConfig` 가 한 번 한다(`IdempotencySettings`: processing lease 30s, replay TTL 24h(최대 72h), failure retention 24h(replay TTL 이상), codec id `json-v2`, - policy revision 2). 유스케이스나 샘플 설정이 직접 만들지 않는다. + policy revision 2). 유스케이스나 서비스 설정이 직접 만들지 않는다. - 이 계약은 요청 재생(replay) 근거를 남길 뿐이다. store 와 비즈니스 DB 사이의 exactly-once 를 보장하지 않는다. @@ -307,8 +307,7 @@ application 계층이 claim·replay·복구 **정책** 을 소유하고, 저장 HMAC-SHA-256 으로 digest** 한 값이다(`digest`, `keyDigestVersion`, `operationCode`). - raw 클라이언트 key 와 principal 은 executor·store·로그·메트릭 어디에도 닿지 않는다. 예외 메시지의 진단 문자열도 이 digest 로만 만든다. -- digest 를 만드는 쪽(키 링, 버전 교체)은 adapter 나 유스케이스 소유다. 예: sample 의 - `HmacPosterImageIdempotencyScopeDigester`. +- digest 를 만드는 쪽(키 링, 버전 교체)은 adapter 나 유스케이스 소유다. ### RequestFingerprint @@ -607,7 +606,7 @@ leaf의 코드 Javadoc과 `docs/notification/`이 정본이다. R1 오케스트 ### CorrelationIdPort - 현재 application invocation의 correlation id를 `Optional`으로 읽는 framework-free - 경계다. application/sample use case는 MDC나 SLF4J를 직접 알지 않는다. + 경계다. application use case는 MDC나 SLF4J를 직접 알지 않는다. - inbound web adapter가 sanitized `correlation_id` MDC 슬롯을 구현 세부로 읽는다. - 값이 없거나 blank이면 event publisher는 생성한 event id를 correlation id로 재사용해 기존 self-correlation 동작을 유지한다. diff --git a/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java b/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java index 24f219ab..80fe518e 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/messaging/contract/IntegrationEventContractContributionTest.java @@ -133,7 +133,7 @@ class IntegrationEventContractContributionTest { void descriptorContainsOnlyBoundedProviderNeutralContractMetadata() { ContractDescriptor descriptor = descriptor(); - assertThat(descriptor.ownerModule()).isEqualTo("sample-portfolio"); + assertThat(descriptor.ownerModule()).isEqualTo("example-feature"); assertThat(descriptor.logicalDestination()) .isEqualTo(new LogicalDestinationId("portfolio-domain-events")); assertThat(descriptor.maximumPayloadBytes()).isEqualTo(64 * 1024); @@ -152,7 +152,7 @@ class IntegrationEventContractContributionTest { assertThatThrownBy( () -> new ContractDescriptor( - "sample-portfolio", + "example-feature", new LogicalDestinationId("portfolio-domain-events"), "json-envelope-v1", true, @@ -165,7 +165,7 @@ class IntegrationEventContractContributionTest { private static ContractDescriptor descriptor() { return new ContractDescriptor( - "sample-portfolio", + "example-feature", new LogicalDestinationId("portfolio-domain-events"), "json-envelope-v1", true, diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java index 6a135273..a91b3602 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ModuleRegistryTest.java @@ -38,7 +38,7 @@ class ModuleRegistryTest { read( registry( entry("app-bootstrap", ":app-bootstrap", "src/alpha"), - entry("sample-portfolio", ":sample-portfolio", "src/beta"), + entry("example-app", ":example-app", "src/beta"), entry("app-bootstrap", ":other", "src/alpha")))); assertTrue(failure.getMessage().contains("duplicate module id"), failure.getMessage()); } @@ -52,7 +52,7 @@ class ModuleRegistryTest { read( registry( entry("app-bootstrap", ":app-bootstrap", "src/alpha"), - entry("sample-portfolio", ":sample-portfolio", "src/beta"), + entry("example-app", ":example-app", "src/beta"), entry("aliased", ":aliased", "src/beta/../alpha")))); assertTrue(failure.getMessage().contains("duplicate or aliased"), failure.getMessage()); } @@ -66,10 +66,10 @@ class ModuleRegistryTest { "app-bootstrap", ":app-bootstrap", "src/alpha", - "[\"sample-portfolio\",\"unknown\",\"app-bootstrap\"]"), - entry("sample-portfolio", ":sample-portfolio", "src/beta"))); + "[\"example-app\",\"unknown\",\"app-bootstrap\"]"), + entry("example-app", ":example-app", "src/beta"))); assertEquals( - List.of("sample-portfolio", "unknown", "app-bootstrap"), + List.of("example-app", "unknown", "app-bootstrap"), parsed.byId("app-bootstrap").allowedDependencies()); } @@ -81,7 +81,7 @@ class ModuleRegistryTest { {"id":"app-bootstrap","gradle_path":":app-bootstrap","source_path":"src/alpha"}, %s]} """ - .formatted(entry("sample-portfolio", ":sample-portfolio", "src/beta")); + .formatted(entry("example-app", ":example-app", "src/beta")); IllegalStateException failure = assertThrows(IllegalStateException.class, () -> read(json)); assertTrue(failure.getMessage().contains("allowed_dependencies"), failure.getMessage()); } @@ -158,7 +158,7 @@ class ModuleRegistryTest { private String valid() { return registry( entry("app-bootstrap", ":app-bootstrap", "src/alpha"), - entry("sample-portfolio", ":sample-portfolio", "src/beta")); + entry("example-app", ":example-app", "src/beta")); } private static String entry(String id, String path, String source) { diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java index 6936c661..2543a1ac 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java @@ -28,19 +28,19 @@ class CleanArchitectureResolvedClasspathFunctionalTest { } @Test - void samplePortfolioCompositionRootIsGovernedByTheSameDependencyPolicy( + void aSecondCompositionRootIsGovernedByTheSameDependencyPolicy( @TempDir Path temporaryRoot) throws IOException { Path repository = temporaryRoot.resolve("repository"); Path project = repository.resolve("src"); Files.createDirectories(project.resolve("config/architecture")); Files.createDirectories(project.resolve("a")); - Files.createDirectories(project.resolve("sample-portfolio")); + Files.createDirectories(project.resolve("example-app")); Files.writeString( project.resolve("settings.gradle"), """ rootProject.name = 'main' - include 'a', 'sample-portfolio' + include 'a', 'example-app' """, UTF_8); Files.writeString( @@ -48,7 +48,7 @@ class CleanArchitectureResolvedClasspathFunctionalTest { """ plugins { id 'ca.architecture' } subprojects { apply plugin: 'java-library' } - project(':sample-portfolio') { + project(':example-app') { dependencies { implementation project(':a') } } """, @@ -65,9 +65,9 @@ class CleanArchitectureResolvedClasspathFunctionalTest { "allowed_dependencies": [] }, { - "id": "sample-portfolio", - "gradle_path": ":sample-portfolio", - "source_path": "src/sample-portfolio", + "id": "example-app", + "gradle_path": ":example-app", + "source_path": "src/example-app", "allowed_dependencies": [] } ] @@ -78,7 +78,7 @@ class CleanArchitectureResolvedClasspathFunctionalTest { BuildResult result = runner(project, "verifyCleanArchitectureDependencies").buildAndFail(); assertThat(result.getOutput()) - .contains("Module ':sample-portfolio' has forbidden project dependencies [a]"); + .contains("Module ':example-app' has forbidden project dependencies [a]"); } @Test diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java index c81c00bd..3d974e64 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/VerifyNoIgnoredSourcePackagesFunctionalTest.java @@ -30,12 +30,12 @@ class VerifyNoIgnoredSourcePackagesFunctionalTest { } @Test - void sourceInAnIgnoredPackageOfTheSamplePortfolioFailsTheGate(@TempDir Path temporaryRoot) + void sourceInAnIgnoredPackageOfAnyLeafFailsTheGate(@TempDir Path temporaryRoot) throws IOException { // given - Path project = fixture(temporaryRoot, "sample-portfolio"); - source(project, "sample-portfolio/src/main/java/example/Ok.java"); - source(project, "sample-portfolio/src/main/java/example/build/Ignored.java"); + Path project = fixture(temporaryRoot, "example-app"); + source(project, "example-app/src/main/java/example/Ok.java"); + source(project, "example-app/src/main/java/example/build/Ignored.java"); // when BuildResult result = runner(project).buildAndFail(); diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java index ff933dcb..ab24e44b 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java @@ -134,7 +134,7 @@ class WorkflowGradleInvocationsTest { // given String workflow = """ - - run: ./gradlew integrationCheck sample-portfolio:check --tests '*Contract*' + - run: ./gradlew integrationCheck example-app:check --tests '*Contract*' """; // when @@ -144,7 +144,7 @@ class WorkflowGradleInvocationsTest { assertThat(invocations).singleElement().satisfies( invocation -> { assertThat(invocation.executes(":integrationCheck", ".")).isTrue(); - assertThat(invocation.executes(":sample-portfolio:check", ".")).isTrue(); + assertThat(invocation.executes(":example-app:check", ".")).isTrue(); assertThat(invocation.tasks()).doesNotContain("*Contract*"); }); } diff --git a/src/build.gradle b/src/build.gradle index 06cc4633..8e15f199 100644 --- a/src/build.gradle +++ b/src/build.gradle @@ -1,6 +1,6 @@ plugins { - // Spring Boot stays on the root build script classpath because two leaves apply it by id - // (`app-bootstrap`, `sample-portfolio`) and a leaf resolves plugin classes from the root. + // Spring Boot stays on the root build script classpath because a leaf applies it by id + // (`app-bootstrap`) and a leaf resolves plugin classes from the root. // // Spotless, SpotBugs, Error Prone and Spring's dependency-management are NOT here any more. They // were declared `apply false` for a `configure(subprojects)` block that applied them to every @@ -52,9 +52,7 @@ tasks.register('resolveAndLockAll') { tasks.register('verifyDependencyLocks') { group = 'verification' description = 'Verifies strict dependency lock state for production CI subprojects.' - dependsOn subprojects.findAll { - it.childProjects.isEmpty() && it.path != ':sample-portfolio' - }.collect { "${it.path}:verifyDependencyLocks" } + dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:verifyDependencyLocks" } } // feature-developer-experience-contract D3 — the ordered local bootstrap lifecycle is @@ -69,9 +67,9 @@ tasks.register('verifyDependencyLocks') { // qualityCheck SpotBugs + FindSecBugs across every leaf (ca.quality-conventions) // ci the pull-request gate: leaf checks + architectureCheck + qualityCheck // mainCheck the main-branch stage: environment contract, full-boot qualification, -// sample web contract, public-path baseline, transport and messaging -// qualification lanes, each leaf's document-contract lanes, and the -// feature generator round trip (verifyFeatureScaffold) +// public-path baseline, transport and messaging qualification lanes, each +// leaf's document-contract lanes, and the feature generator round trip +// (verifyFeatureScaffold) // integrationCheck the declared strict integration lanes (several need a container runtime) // performanceCheck the declared strict performance lanes (load, shutdown, pool and resource // bounds; real servers and containers) @@ -82,9 +80,7 @@ tasks.register('verifyDependencyLocks') { // Task PATHS, not TaskProviders: a leaf's tasks are created by convention plugins after the root is // evaluated, and a path is resolved when the task graph is built. // --------------------------------------------------------------------------------------------- -List leafPaths = subprojects.findAll { - it.childProjects.isEmpty() && it.path != ':sample-portfolio' -}.collect { it.path }.toSorted() +List leafPaths = subprojects.findAll { it.childProjects.isEmpty() }.collect { it.path }.toSorted() tasks.register('qualityCheck') { group = 'verification' @@ -100,13 +96,11 @@ tasks.register('configContractCheck') { // A lane that needs an input this build was not given (the Redis topology coordinates, the protected // AWS sandbox authority) is explicit-only: the aggregate leaves it out and names it when it runs -// (review NEW-16). The sample's integration lanes are here although the sample is not a production -// leaf, because nothing else ran its strict PostgreSQL lanes (review NEW-13e). +// (review NEW-16). tasks.register('integrationCheck') { group = 'verification' - description = "Runs every production CI leaf's and the sample's integration-category test lanes. Several need a container runtime." + description = "Runs every production CI leaf's integration-category test lanes. Several need a container runtime." dependsOn leafPaths.collect { "${it}:integrationTestLaneCheck" } - dependsOn ':sample-portfolio:integrationTestLaneCheck' } // Performance lanes are not the pull request's or the main stage's: their bounds need a machine that @@ -145,13 +139,6 @@ tasks.register('testQualityCheck') { group = 'verification' description = 'Runs SpotBugs and FindSecBugs over every leaf\'s test source sets.' dependsOn leafPaths.collect { "${it}:testQualityCheck" } - dependsOn ':sample-portfolio:testQualityCheck' -} - -tasks.register('sampleWebContractCheck') { - group = 'verification' - description = 'Runs the real-server sample HTTP/OpenAPI contract source set without pulling every sample lane into CI.' - dependsOn ':sample-portfolio:webSystemTest' } // The feature generator's round trip (review 2026-11-01 개선 순서 4): scripts/new-feature.sh writes @@ -179,8 +166,7 @@ tasks.register('verifyMessagingContracts') { group = 'verification' description = 'Qualifies the application integration-event contract and the shared envelope schema.' dependsOn ':application-core:messagingApplicationContractQualificationTest', - ':shared-contract:messagingSharedSchemaQualificationTest', - ':sample-portfolio:messagingSampleContractQualificationTest' + ':shared-contract:messagingSharedSchemaQualificationTest' } tasks.register('ci') { @@ -197,10 +183,6 @@ tasks.register('mainCheck') { dependsOn leafPaths.collect { "${it}:mainCheck" } dependsOn tasks.named('configContractCheck') dependsOn tasks.named('qualificationCheck') - dependsOn tasks.named('sampleWebContractCheck') - // The standalone sample booted whole against real PostgreSQL. The sample is outside `leafPaths`, - // so systemTestCheck does not reach it, and no stage ran it (review 2026-11-01 08-01). - dependsOn ':sample-portfolio:systemTest' dependsOn tasks.named('verifyPublicPathSnapshot') dependsOn tasks.named('conditionalTransportQualification') dependsOn tasks.named('verifyMessagingContracts') @@ -214,8 +196,7 @@ tasks.register('mainCheck') { // one failed closed (review 2026-11-01 08-01). A new lane joins a stage through its category // aggregate; no workflow line names it. strictLaneStages { - stage ':ci', ':sample-portfolio:check', ':mainCheck', ':integrationCheck', ':performanceCheck', - ':releaseCheck' + stage ':ci', ':mainCheck', ':integrationCheck', ':performanceCheck', ':releaseCheck' workflowDirectory = layout.projectDirectory.dir('../.github/workflows') } diff --git a/src/composition/idempotency/README.md b/src/composition/idempotency/README.md index 547cac62..379b0459 100644 --- a/src/composition/idempotency/README.md +++ b/src/composition/idempotency/README.md @@ -25,13 +25,13 @@ composition:idempotency - 설정 바인딩은 `StrictSettingsBinder`다. 같은 prefix 아래 Redis 저장소가 자기 키(`key-version`, `command-timeout`)를 두므로 그 두 키만 빼고 엄격하게 본다. 수명 정책 키를 잘못 쓰면 기본값이 조용히 쓰이는 대신 기동이 실패한다. -- app-bootstrap과 sample-portfolio가 같은 한 줄을 쓴다. 예전의 sample 복사본 +- app-bootstrap이 이 한 줄을 쓴다. 예전의 샘플 모듈 복사본 (`SampleIdempotencyConfig`, 상한 검증 없이 `Binder`로 읽고 저장소를 하나로 가정)은 삭제했다. ## 추가할 한 줄 ```groovy -// app-bootstrap/build.gradle (sample-portfolio/build.gradle 도 같다) +// app-bootstrap/build.gradle runtimeOnly project(':composition:idempotency') // 요청 멱등성 executor ``` diff --git a/src/composition/idempotency/build.gradle b/src/composition/idempotency/build.gradle index 17053ed3..69730efb 100644 --- a/src/composition/idempotency/build.gradle +++ b/src/composition/idempotency/build.gradle @@ -10,7 +10,7 @@ plugins { // It builds the one IdempotencyExecutor over whichever IdempotencyStorePort the selected provider // contributes (Redis from cache-redis, PostgreSQL from persistence-jpa), and ships the lifecycle // settings (config/module-defaults/idempotency.yml). It names no provider module: the store is a -// port. app-bootstrap and sample-portfolio take the same line, so the executor is built one way. +// port. // // Not a composition root: it composes one capability and does not run. Same shape as // :composition:notification-platform. diff --git a/src/composition/service-runtime/README.md b/src/composition/service-runtime/README.md index d6ae10d0..0fcd9479 100644 --- a/src/composition/service-runtime/README.md +++ b/src/composition/service-runtime/README.md @@ -7,8 +7,8 @@ ## 제공하는 것 -capability와 무관하게 서비스 구성 루트 둘(app-bootstrap, sample-portfolio)이 모두 필요로 하는 -runtime 배선이다. 예전에는 app-bootstrap에 있었고 sample이 그 복사본을 들고 있었다. +capability와 무관하게 서비스 구성 루트가 필요로 하는 runtime 배선이다. 예전에는 app-bootstrap에 +있었고, 지금은 지운 샘플 모듈이 그 복사본을 들고 있었다. ``` composition:service-runtime @@ -43,16 +43,15 @@ composition:service-runtime `app.tracing.*` 값을 Boot 키로 옮기고 끄는 스위치만 둔다(아래 "tracing" 절). - 설정 키는 옮기지 않았다: `app.tracing.*`, `app.privacy.*`. 값은 각 구성 루트의 `application.yml`/`config/observability.yml`에 있다. - actuator chain은 servlet 웹 애플리케이션에서만 만들어지고, 구성 루트가 같은 이름 - `actuatorSecurityFilterChain`의 bean을 두면 물러난다. sample-portfolio는 공개 데모라 그렇게 - 모든 요청을 허용하는 자기 chain을 둔다. -- sample 복사본과의 차이 중 원본을 따른 것: 샘플 레이트는 `RuntimeEnvironment` 어휘(prod 0.01, + `actuatorSecurityFilterChain`의 bean을 두면 물러난다. +- 옛 샘플 복사본과의 차이 중 원본을 따른 것: 샘플 레이트는 `RuntimeEnvironment` 어휘(prod 0.01, 그 밖 1.0)이고 `staging=0.10` 분기는 없다. 설정 검증 실패는 `IllegalStateException`이 아니라 `StartupFailures.envValidation`이다. ## 추가할 한 줄 ```groovy -// app-bootstrap/build.gradle (sample-portfolio/build.gradle 도 같다) +// app-bootstrap/build.gradle runtimeOnly project(':composition:service-runtime') ``` diff --git a/src/composition/service-runtime/build.gradle b/src/composition/service-runtime/build.gradle index cacd1ff2..f6bdb43e 100644 --- a/src/composition/service-runtime/build.gradle +++ b/src/composition/service-runtime/build.gradle @@ -9,10 +9,6 @@ plugins { // // runtimeOnly project(':composition:service-runtime') // -// app-bootstrap and sample-portfolio take the same line. Before this module the sample carried a -// copy of each piece, and the copies had already drifted (a `staging` sampling rate the runtime -// vocabulary does not have, IllegalStateException where the original raised typed startup failures). -// // Not a composition root: it assembles shared runtime infrastructure and does not run. dependencies { implementation project(':application-core') diff --git a/src/config/architecture/modules.json b/src/config/architecture/modules.json index e26259d2..9c284f5b 100644 --- a/src/config/architecture/modules.json +++ b/src/config/architecture/modules.json @@ -383,24 +383,6 @@ "composition-durable-operation" ] }, - { - "id": "sample-portfolio", - "gradle_path": ":sample-portfolio", - "source_path": "src/sample-portfolio", - "allowed_dependencies": [ - "domain-core", - "application-core", - "adapter-outbound-persistence-jpa", - "adapter-outbound-identifier", - "adapter-outbound-objectstorage", - "adapter-outbound-support", - "adapter-inbound-web", - "shared-contract", - "application-objectstorage", - "composition-idempotency", - "composition-service-runtime" - ] - }, { "id": "messaging-core-api", "gradle_path": ":messaging:messaging-core-api", diff --git a/src/config/spotbugs/exclude-test.xml b/src/config/spotbugs/exclude-test.xml index 0e823942..cd9764ff 100644 --- a/src/config/spotbugs/exclude-test.xml +++ b/src/config/spotbugs/exclude-test.xml @@ -143,15 +143,6 @@ - - - - - - - diff --git a/src/config/spotbugs/exclude.xml b/src/config/spotbugs/exclude.xml index d1a4707a..23795b3b 100644 --- a/src/config/spotbugs/exclude.xml +++ b/src/config/spotbugs/exclude.xml @@ -20,9 +20,9 @@ and the actuator chain authenticate a stateless JWT bearer token (no session cookies, no ambient credential a browser would attach), so CSRF protection has nothing to protect. FindSecBugs flags it for classic cookie-session web apps; it is a false positive here. - Named classes, not `~.*SecurityConfig`: that pattern also matched the sample's HTTP Basic - chain, for which this reason is false — a browser re-sends Basic credentials on its own — - and would have hidden a copied Basic chain's CSRF exposure (review 2026-11-03 RR-07-05). --> + Named classes, not `~.*SecurityConfig`: that pattern would also match an HTTP Basic chain, + for which this reason is false — a browser re-sends Basic credentials on its own — and would + hide a Basic chain's CSRF exposure (review 2026-11-03 RR-07-05). --> @@ -31,24 +31,6 @@ - - - - - - - - - - - - diff --git a/docs/runbooks/job-timeout.md b/docs/runbooks/job-timeout.md index 4c239492..30947cd7 100644 --- a/docs/runbooks/job-timeout.md +++ b/docs/runbooks/job-timeout.md @@ -50,7 +50,7 @@ status: stub - 의존성 지연이 근본 원인이면 해당 의존성 오너에게 escalate - 종료 예산은 차례로 더한 값이다: 웹 drain(`APP_SERVER_SHUTDOWN_TIMEOUT`, 기본 30s)이 끝난 뒤 async 대기 19s, 합계 49s에 preStop(5s)과 여유를 더한다. k8s `terminationGracePeriodSeconds`가 이보다 작으면(예: 기본 30s) - async 대기 중 SIGKILL이다. compose는 60s(`docker-compose.yml` `stop_grace_period`, 합계는 + async 대기 중 SIGKILL이다. compose는 60s(`compose.yaml` `stop_grace_period`, 합계는 `DeveloperExperienceContractTest`가 검사). 정합 이슈면 플랫폼/런타임 오너에게 escalate ## 6. Recovery / Verification diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index 0c6a5b62..431c7a86 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -73,7 +73,7 @@ |---|---|---|---|---| | B-12 | JWT 모드에서 `APP_SECURITY_JWT_AUDIENCE` 필수(빈 값 거부, `${...}`가 안 풀린 값도 없는 값으로 봄). 토큰 `aud`가 목록 중 하나를 담아야 통과. `resource_access` role은 audience에 적은 client 것만 읽는다(realm role은 그대로) | 기동 실패 `APP_SECURITY_JWT_AUDIENCE (app.security.audience) is required`(exit 코드 확인 못 함). `.env.example`이 `APP_SECURITY_JWT_AUDIENCE=`(빈 값)를 싣고 있다. 다른 client의 role에 기대던 권한이 사라짐 | client id를 쉼표로 넣는다. 다른 client role로 권한을 받던 사용자가 있는지 IdP에서 확인 | `34565130`(필수·role), `1400dc15`(안 풀린 `${...}`) · `src/adapter/inbound/web/.../auth/JwtDecoderConfig.java`, `.../JwtToAuthenticatedPrincipalConverter.java`, `.../settings/SecuritySettings.java` | | B-13 | `app.security.*` strict 바인딩: 접두어 아래 오타 키, 또는 설정·placeholder 어디에도 쓰이지 않는 `APP_SECURITY_*` 환경 변수가 기동을 막는다 | 기동 실패(메시지는 `StrictSettingsBinder`가 키 이름을 담아 냄, 정확한 문구 확인 못 함) | 쓰지 않는 `APP_SECURITY_*` 변수를 지운다 | `5786126c` · `SecuritySettings.bind`, `src/adapter/outbound/support/.../StrictSettingsBinder.java` | -| B-14 | prod 프로필에서 `fixture-`로 시작하는 비밀값을 거부(레지스트리 `secret` 행, 모듈이 기여한 비밀, `secret://…/` 참조 대상. `HOSTNAME`·앱 이름 같은 비밀 아닌 값은 보지 않는다 — RR2-04-01). Redis ACL fixture 파일 이름 변경: `infra/redis-sdk/acl/all-accounts.acl` → `lane-fixture-accounts.acl` | prod 기동 실패, 요약 `prod secret/config-source contract is invalid`(exit 78). 옛 ACL 경로를 mount하던 compose는 파일 없음 | prod 값을 진짜 비밀로 바꾼다. compose의 ACL 경로를 새 이름으로. Redis SDK admin 계정(`RedisAccountContribution`)을 조립했다면 그 변수를 `static` `RequiredProductionSecrets` bean으로도 낸다(코드에 든 참조는 검사가 보지 않는다, RR3-04-03, `src/adapter/outbound/redis-sdk/README.md`) | `bbe944bd` · `src/app-bootstrap/.../runtime/SecretSourceValidator.java`, `docs/registries/secrets-classification.yaml` | +| B-14 | prod 프로필에서 `fixture-`로 시작하는 비밀값을 거부(레지스트리 `secret` 행, 모듈이 기여한 비밀, `secret://…/` 참조 대상. `HOSTNAME`·앱 이름 같은 비밀 아닌 값은 보지 않는다 — RR2-04-01). Redis ACL fixture 파일 이름 변경: `infra/redis-sdk/acl/all-accounts.acl` → `lane-fixture-accounts.acl`(폴더는 지금 `compose/redis/acl/`, B-51) | prod 기동 실패, 요약 `prod secret/config-source contract is invalid`(exit 78). 옛 ACL 경로를 mount하던 compose는 파일 없음 | prod 값을 진짜 비밀로 바꾼다. compose의 ACL 경로를 새 이름으로. Redis SDK admin 계정(`RedisAccountContribution`)을 조립했다면 그 변수를 `static` `RequiredProductionSecrets` bean으로도 낸다(코드에 든 참조는 검사가 보지 않는다, RR3-04-03, `src/adapter/outbound/redis-sdk/README.md`) | `bbe944bd` · `src/app-bootstrap/.../runtime/SecretSourceValidator.java`, `docs/registries/secrets-classification.yaml` | | B-15 | 기동 rule이 모든 singleton보다 먼저 돈다(`StartupRuleRunner`가 `BeanFactoryPostProcessor`). `StartupRule`과 `RequiredProductionSecrets` bean은 `static @Bean`이고 `Environment`, bean factory, static 무인자 `RequiredProductionSecrets`의 `ObjectProvider`만 받아야 한다. 두 타입의 클래스는 `@Value`·`@Autowired`·`@Inject`·`@Resource` 멤버, `@PostConstruct`·`@PreDestroy`, `@ConfigurationProperties`를 가질 수 없다(post-processor보다 먼저 만들어져 비어 있게 된다, RR2-04-03) | non-static `@Bean`이거나 다른 bean을 받으면 기동 실패 `startup rule or secret list '<이름>' created [] while creating it ... Declare the rule with a static @Bean method ...`, 위 멤버가 있으면 `'<이름>' (...) is a StartupRule or RequiredProductionSecrets ... but it needs one: [...]`(둘 다 exit 78, 둘 다 모든 프로필. runner가 rule과 비밀 목록을 프로필과 무관하게 먼저 만들어, 인터페이스 타입 `@Bean`이 돌려준 실제 클래스까지 본다, RR3-04-01) | rule 선언을 `static`으로, 인자를 위 셋으로 줄인다. 값은 `violations(Environment)`가 받는 `Environment`에서 읽는다. 다른 bean이 필요한 검사는 rule이 아니라 일반 bean으로 둔다 | `34565130`, `bbe944bd` · `src/adapter/outbound/support/.../startup/StartupRule.java`, `StartupRuleRunner.java` | | B-16 | 권한 가드(새 `PermissionEnforcementGuard`): `@SystemInvoked` 유스케이스가 bean이면 기동 실패. `@RequiresPermission`을 단 bean에 적용되는 advisor가 없어도 기동 실패. ArchUnit `SYSTEM_INVOKED_USE_CASES_DECLARE_NO_PERMISSION`, `ONLY_SYSTEM_CALLERS_REACH_SYSTEM_INVOKED_USE_CASES`, `SYSTEM_CALLERS_ARE_SYSTEM_DRIVEN_INBOUND_ADAPTERS`, `USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS`, `SYSTEM_CALLERS_HAVE_ONLY_PROJECT_SUPERTYPES` 추가, 새 표시 `@SystemCaller` | 기동 실패 `@SystemInvoked use cases are registered as beans ...` 또는 `beans declare @RequiresPermission but no advisor enforces it ...`(exit 72). `@SystemCaller`가 아닌 inbound adapter가 그 유스케이스를 부르거나, 사용자 전송(controller 등)이 `@SystemCaller` bean을 직접·중간 클래스를 거쳐·그 작업이 구현하는 프로젝트 인터페이스로 부르면 architectureTest 실패. `@SystemCaller` 클래스가 `Runnable`·`ApplicationRunner` 같은 프로젝트 밖 타입을 구현·상속해도 실패. 설정(`@Configuration`)은 웹 bean(`WebMvcConfigurer`·CORS 설정·controller bean)과 handler bean을 함께 등록해도 사용자 전송으로 세지 않지만, 요청 처리기 타입(함수형 route·data fetcher·interceptor)에 의존하면 사용자 전송으로 센다. 처리 코드를 설정에 직접 쓰든, 다른 클래스의 메서드를 참조해 등록만 하든 같다. 설정 안에 중첩된 클래스는 설정용 타입(configurer·registry·CORS 설정·`RequestMethod`)에만 의존할 때를 빼고 다른 클래스처럼 사용자 전송 타입으로 판정한다(중첩된 JAX-RS 자원·`@ServerEndpoint`도 잡힌다). STOMP inbound channel interceptor(`ChannelInterceptor`·`ExecutorChannelInterceptor`)도 사용자 전송 타입이자 요청 처리기 타입이다. 사용자 전송 패키지 밖에 둔 interceptor, 설정에 중첩한 interceptor(익명 클래스 포함), interceptor를 구현한 설정이 `@SystemCaller`에 닿거나, interceptor를 `@Bean`으로 내놓는 설정이 `@SystemCaller` bean도 만들면 실패한다(2026-11-07 전에는 STOMP 헤더 타입을 읽는 interceptor만 잡혔다). record·enum이 언어로 받는 상위 타입(`Record`·`Enum` 등)과 예외 클래스는 프로젝트 밖 상위 타입으로 세지 않는다 | 시스템만 부르는 쓰기 유스케이스는 composition에서 `new`로 만들어 스케줄러에 넘기거나, 메시지 handler·예약 작업이면 그 클래스에 `@SystemCaller`를 달고 생성자에서 `new`로 만든다. 예약 작업은 서비스 leaf의 `..adapter.inbound.scheduler..` 패키지에 둔다. 세 경로와 두는 곳은 매뉴얼 07장 「시스템이 부르는 쓰기」(handler 작업 순서는 09장 「소비」 4단계). "지금 실행" endpoint가 필요하면 `@RequiresPermission` 유스케이스를 따로 만든다. 작업을 task scheduler에 직접 등록하던 코드는 작업이 `Runnable`을 구현하는 대신 등록하는 곳에서 `job::run`을 넘긴다. route·data fetcher·interceptor 등록은 handler bean을 만드는 설정과 다른 설정에 둔다. STOMP channel interceptor 등록도 같다. `@RequiresPermission`을 쓰면 web adapter(`MethodSecurityConfig`)가 조립돼 있어야 한다 | `1400dc15`, `bbe944bd`, r9 · `src/composition/service-runtime/.../authorization/PermissionEnforcementGuard.java`, `src/application-core/.../security/SystemInvoked.java`, `SystemCaller.java` | | B-17 | `IntegrationEventDraft`: `eventId`·`causationId`는 소문자 UUIDv7만. ArchUnit `INTEGRATION_EVENT_DRAFTS_ARE_BUILT_BY_THE_SHARED_HELPER`: `new IntegrationEventDraft<>(...)` 금지, `IntegrationEventDrafts.draft(...)`만 | 이벤트를 만드는 쓰기 요청이 `IllegalArgumentException: eventId must be a canonical lower-case UUIDv7...`로 실패. architectureTest 실패 | event id를 UUIDv7로 만든다(예: sample `UuidOutboxEventIdFactory`가 `UuidCreator.getTimeOrderedEpochPlus1()`). draft는 헬퍼로 만든다. tenant가 없는 이벤트는 `IntegrationEventDrafts.SINGLE_TENANT_SCOPE`(`global`) | `1400dc15`, `bbe944bd` · `src/application-core/.../messaging/event/IntegrationEventDraft.java`, `IntegrationEventDrafts.java` | @@ -133,6 +133,7 @@ |---|---|---|---|---| | B-49 | 샘플 모듈 삭제: `src/sample-portfolio`, `src/Dockerfile.sample`, registry `sample-portfolio` 행, 루트 `build.gradle`의 샘플 태스크·단계(`sampleWebContractCheck`, `:sample-portfolio:*` 의존, strict lane 단계 `:sample-portfolio:check`), `ci-quality-gates.yml`의 `sample-portfolio` job, `SampleRuntimeDefaultsContractTest`, spotbugs 제외의 샘플 클래스. 샘플에만 있던 검사(OpenAPI 스냅숏 `openapiCheckSnapshot`, Date 헤더, 가상 스레드 MDC 전파)도 함께 없어졌다 | 샘플을 고쳐 쓰던 서비스: 병합 때 "수정 대 삭제" 충돌. 샘플을 이미 지운 서비스: 충돌 없음 | 샘플을 이미 지웠으면 할 일 없음. 고쳐 쓰고 있으면 자기 leaf로 옮기고 registry 행·빌드 줄을 자기 것으로 둔다. 위 검사가 필요하면 자기 기능 leaf에 둔다 | `ab5982e9` | | B-50 | `infra/`에서 15개 삭제. 쓰는 곳이 없던 12개(`infra/httpclient/**`, `infra/jpa/postgres/README.md`, `infra/jpa/toxiproxy/`, `infra/messaging/{kafka,postgres,toxiproxy,tls}/`, `infra/notification/toxiproxy/`)와 운영 인프라 셋(`infra/fileserver/nginx/nginx.conf`, `infra/fileserver/kubernetes/pvc-certification-job.yaml`, `infra/jpa/roles/runtime-roles.sql`). `release.yml`의 `fileserver-pvc-certification` job도 지웠고, fileserver 지원 표에서 "Kubernetes ReadWriteOnce PVC — Limited" 주장을 「주장하지 않음」으로 옮겼다 | 그 파일을 배포에 쓰던 서비스: 병합이 파일을 지운다. 고쳐 쓰던 서비스: "수정 대 삭제" 충돌 | 그 파일은 자기 인프라 repo로 옮긴다. 지켜야 할 조건은 `docs/fileserver/operations.md` 「운영 환경이 지켜야 할 조건」, `docs/fileserver/storage-certification.md`, `docs/jpa/security.md` 「역할과 권한」·「서버 설정」에 있다 | 커밋 「쓰지 않는 파일과 운영 인프라 파일을 지운다」 | +| B-51 | compose 정리. 루트 `docker-compose.yml`·`docker-compose.local.yml`·`docker-compose.infra.yml`을 개발 환경 `compose.yaml` 하나로 합쳤다(app은 `local` 런타임, 뒷단 서비스는 capability profile `jpa`·`redis`·`kafka`·`mongo`·`objectstorage`·`auth`·`mail`). 보조 파일은 `compose/`(keycloak realm·entrypoint, minio init, Redis ACL, mailpit 인증서 폴더). 테스트 lane fixture는 그 lane을 가진 leaf로 옮겼다: `docker-compose.dev.yml`·`docker-compose.prod-smoke.yml`·`docker-compose.tls.yml`·fileserver overlay·smoke 스크립트·스키마 적용 스크립트·lane 계약 JSON(`src/config/runtime/compose-profile-contracts.json`) → `src/app-bootstrap/compose-lanes/`, Redis topology compose → `src/adapter/outbound/redis-sdk/compose/`, NFS compose → `src/adapter/outbound/fileserver/compose/nfs/`. `infra/`는 없어졌다. lane 계약의 `composeProfile`(문자열)은 `composeProfiles`(목록)로 바뀌었고 `appMemoryLimit`이 생겼다. smoke는 lane 중 컨테이너가 재시작하거나 메모리로 죽으면 실패한다. `scripts/bootstrap-local.sh`는 인자를 받지 않는다 | `docker compose -f docker-compose.yml -f docker-compose.local.yml …`을 쓰던 스크립트·문서가 "no such file"로 실패. 옛 compose 파일에 서비스를 더했으면 수정 대 삭제 충돌. lane 계약을 고쳐 쓰던 서비스는 `composeProfile` 키를 smoke 스크립트가 읽지 않는다 | 명령을 `docker compose …`(루트 `compose.yaml`)와 profile로 바꾼다. 더한 서비스는 `compose.yaml`에 capability profile을 달아 옮기고, lane 전용이면 `src/app-bootstrap/compose-lanes/lane-services.yaml`에 둔다. 경로를 적은 workflow·문서를 위 새 경로로 고친다 | 커밋 「compose 파일을 개발 환경 하나와 lane fixture로 나눈다」 | ## 4. DB 마이그레이션 @@ -175,7 +176,7 @@ - **번호 충돌**: 템플릿이 이제 postgresql V20~V22, notification V11~V13, grpc V002·V003을 쓴다(sample V8_1은 샘플과 함께 사라졌다, B-49). 파생 서비스가 같은 위치에 같은 번호를 두었다면 Flyway가 같은 버전 두 개로 실패한다. 자기 마이그레이션은 템플릿과 떨어진 번호대로 옮긴다 (이미 적용된 파일 이름을 바꾸면 checksum·history가 어긋나므로 운영 DB에 적용된 것이면 DB 담당과 정한다). -- **migration-on-startup=false로 운영하는 서비스**: `infra/postgres/apply-capability-streams.sh`가 바뀌었다(stream을 +- **migration-on-startup=false로 운영하는 서비스**: `infra/postgres/apply-capability-streams.sh`(지금 `src/app-bootstrap/compose-lanes/postgres/apply-capability-streams.sh`, B-51)가 바뀌었다(stream을 `/flyway/streams/`에서 먼저 찾음). 운영자가 직접 적용한다. ### 4.2 이 브랜치의 이전 V21(과 3차 수정 전 V20·V22·V11~V13·V8_1·V002·V003)을 적용한 DB diff --git a/docs/work/operate.md b/docs/work/operate.md index 6c66c723..9487fe83 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -59,7 +59,7 @@ git worktree remove ~/workspace/<작업 이름> - 로그는 desktop `~/<작업 이름>-logs/`에 남기고, 보고에 그 desktop 경로와 rc를 쓴다. 같은 worktree의 다음 실행이 결과 XML을 덮어쓰니, 명령이 끝날 때마다 그 태스크의 `build/test-results/<태스크>/`를 로그 폴더로 복사한다(세는 법은 [reference/gates.md](reference/gates.md) 4절). - RED 확인용 임시 worktree도 같은 방법으로 만들고 끝나면 지운다. - workflow job이 도구를 내려받아 설치하는 단계(`curl … | sh`, setup action)는 desktop에서 따라 하지 않는다. 소유자 기계를 바꾸는 일이다. 이미 설치된 도구로만 돌리고, 없으면 못 돌림으로 적는다. -- compose를 띄웠으면 지우기 전에 `docker compose … down`을 한다. bind mount 폴더(`docker-compose.dev.yml`의 `tmp/heap-dumps`)는 Docker가 root로 만들어 `git worktree remove`가 Permission denied로 실패한다. compose가 이미 받은 이미지(`docker-compose.infra.yml`의 `redis:7.4`)로 폴더를 지운 뒤 다시 지운다: `docker run --rm --pull=never -v "$PWD/tmp:/t" redis:7.4 rm -rf /t/heap-dumps`. +- compose를 띄웠으면 지우기 전에 `docker compose … down`을 한다. bind mount 폴더(dev lane overlay `src/app-bootstrap/compose-lanes/dev.yaml`의 `tmp/heap-dumps`)는 Docker가 root로 만들어 `git worktree remove`가 Permission denied로 실패한다. compose가 이미 받은 이미지(`compose.yaml`의 `redis:7.4`)로 폴더를 지운 뒤 다시 지운다: `docker run --rm --pull=never -v "$PWD/tmp:/t" redis:7.4 rm -rf /t/heap-dumps`. - Python 검사 스크립트는 노트북에서 돌려도 된다. 보고 증거로 쓸 때는 desktop worktree에서 한 번 더 돌린다. **push 전에 검증하기.** push한 커밋은 고쳐 쓰지 않는다. 그래서 커밋 본문에 desktop 결과를 쓰거나 push가 허용되지 않았으면, 커밋 전에 바꾼 것을 패치로 보내 같은 트리에서 돌린다. diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index 87ed1dd4..2872e0dd 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -74,6 +74,7 @@ | 생성 명령 | JPA adapter를 만들지 않음(서비스 전용 persistence leaf가 기본), 생성된 쓰기 API는 역할 매핑 전 403 | 위임 | `1101` 15절(r2-10) | | `@SystemInvoked` | bean으로 등록돼 있으면 기동 실패, inbound adapter가 직접 부르지 못하게 ArchUnit | 위임 | `1103` 4절(RR-01-02) | | 시스템 호출 경로 | 사용자가 닿는 전송(web·GraphQL·gRPC·WebSocket)만 `@SystemInvoked`에 닿지 못한다. 메시지 소비자·스케줄러는 `@SystemCaller(reason)` 표시로 허용 | 위임 | `1103` 9.1절(RR-01-12), 10절 r5-b | +| 개발 compose 파일 | 저장소 루트에 `compose.yaml` 하나. 뒷단 서비스는 capability 이름 profile로 고르고, 마운트하는 보조 파일은 `compose/`에 둔다. 테스트 lane fixture는 그 lane을 가진 leaf로 보낸다(compose lane → app-bootstrap `compose-lanes/`, Redis topology → redis-sdk, NFS → fileserver). `docker-compose.dev.yml`은 `dev` 배포 프로필이 뜨는지 보는 lane fixture로 app-bootstrap에 둔다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 | | 인프라 실행 파일 | nginx 설정, Kubernetes PVC job, DB 역할 SQL은 이 repo에서 지우고, 기능이 운영 환경에 요구하는 조건만 그 기능 문서에 적는다. 아무도 쓰지 않는 `infra/` 파일도 지운다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 | | 샘플 모듈 | `src/sample-portfolio`와 `src/Dockerfile.sample`을 폴더째 지운다. 역할은 옮기지 않는다. 샘플 안에만 있던 템플릿 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC)도 함께 지운다. 예시는 매뉴얼과 생성 명령 출력이 맡는다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.2절 | diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 151dadcc..61f740c3 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -112,7 +112,7 @@ cd src ./gradlew -p optional-platforms releaseCheck -PgitRevision="$(git rev-parse HEAD)" --no-build-cache --console=plain cd .. bash scripts/verify-compose-profile-contracts.sh -bash scripts/run-compose-runtime-smoke.sh --matrix src/config/runtime/compose-profile-contracts.json +bash scripts/run-compose-runtime-smoke.sh --matrix src/app-bootstrap/compose-lanes/compose-profile-contracts.json ``` - 여러 명령으로 된 main job 둘은 그 job의 `run` 줄을 차례로 그대로 돌린다: `integration-main.yml`의 `configuration-cache`(로그에 "Reusing configuration cache."가 있어야 한다), `notification-platform.yml`의 `pr`(main push마다 경로와 상관없이 돈다). diff --git a/scripts/bootstrap-local.sh b/scripts/bootstrap-local.sh index 139b27c8..674f39fa 100755 --- a/scripts/bootstrap-local.sh +++ b/scripts/bootstrap-local.sh @@ -1,31 +1,33 @@ #!/usr/bin/env bash # The ordered local start-up: compile, Docker preflight, dependency wait, migrate-and-start, smoke. # -# scripts/bootstrap-local.sh # the `local` overlay (docker-compose.local.yml) -# scripts/bootstrap-local.sh # docker-compose..yml merged onto docker-compose.yml +# scripts/bootstrap-local.sh +# +# It runs the development stack, compose.yaml at the repository root: the application container in +# the `local` runtime and the PostgreSQL service of the `jpa` profile. Naming a service on the +# command line switches its profile on, so no --profile is needed here. # # This was the build-logic `ca.developer-bootstrap` plugin (`./gradlew bootstrap`). Starting # containers and probing an HTTP endpoint is not a build rule, so it is a script now (review # 2026-09-24 BUILD-O3-5). The four stages and their order are unchanged: the next stage starts only # when the previous one succeeded, and the app stage waits for startup Flyway through the compose # healthcheck before the smoke probe runs. +# +# Until 2026-11-07 it merged docker-compose.yml with docker-compose.local.yml and asked for a `db` +# service neither file had defined since the database moved to a third file, so the documented +# first run stopped at stage 2. set -euo pipefail readonly repository_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" -readonly profile="${1:-local}" -readonly base_compose="${repository_dir}/docker-compose.yml" -readonly overlay="${repository_dir}/docker-compose.${profile}.yml" readonly health_endpoint="${BOOTSTRAP_HEALTH_ENDPOINT:-http://localhost:8080/api/healthcheck}" readonly smoke_timeout_seconds="${BOOTSTRAP_SMOKE_TIMEOUT_SECONDS:-60}" -if [[ ! -f "${overlay}" ]]; then - available="$(cd "${repository_dir}" && ls docker-compose.*.yml 2>/dev/null \ - | sed -e 's/^docker-compose\.//' -e 's/\.yml$//' | tr '\n' ' ')" - echo "bootstrap: '${profile}' names no overlay; expected $(basename "${overlay}") beside" \ - "docker-compose.yml. Available: ${available:-none}" >&2 +if [[ $# -gt 0 ]]; then + echo "bootstrap: takes no arguments; the stack is compose.yaml. Backing services by profile:" \ + "docker compose --profile up -d --wait (see the head of compose.yaml)" >&2 exit 64 fi -compose=(docker compose -f "${base_compose}" -f "${overlay}") +compose=(docker compose -f "${repository_dir}/compose.yaml") echo "bootstrap 1/4: compiling the default application composition" (cd "${repository_dir}/src" && ./gradlew :app-bootstrap:compileTestJava --console=plain) @@ -35,7 +37,7 @@ if ! docker info >/dev/null 2>&1; then exit 69 fi -echo "bootstrap 2/4: starting the ${profile} PostgreSQL dependency and waiting for readiness" +echo "bootstrap 2/4: starting the PostgreSQL dependency and waiting for readiness" "${compose[@]}" up -d --wait db echo "bootstrap 3/4: building and starting the app; startup Flyway finishes before health is ready" diff --git a/scripts/run-compose-runtime-smoke.sh b/scripts/run-compose-runtime-smoke.sh index 770b7a97..9d854e30 100755 --- a/scripts/run-compose-runtime-smoke.sh +++ b/scripts/run-compose-runtime-smoke.sh @@ -13,6 +13,8 @@ # compared with the lane's expectedCapabilitiesOn and expectedPersistenceVendor; # 4. every one-shot the lane declares, each of which must exit zero — a missing or skipped # required client is a lane failure, not a lane that had nothing to check; +# 4a. no container of the lane restarted or was killed for memory — a container that died and came +# back between the checks above would otherwise leave every one of them green; # 5. sanitized evidence; # 6. teardown scoped to this project alone, on success and failure alike, after the logs are # collected rather than before. @@ -22,7 +24,7 @@ set -euo pipefail REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" -CONTRACTS="${REPO_ROOT}/src/config/runtime/compose-profile-contracts.json" +CONTRACTS="${REPO_ROOT}/src/app-bootstrap/compose-lanes/compose-profile-contracts.json" EVIDENCE_ROOT="${REPO_ROOT}/src/app-bootstrap/build/evidence/runtime-smoke" RUN_ID="$(date -u +%Y%m%dT%H%M%SZ)-$$" # Compose project names accept lowercase alphanumerics, hyphens and underscores only, so the run id @@ -32,7 +34,7 @@ PROJECT_RUN_ID="$(tr '[:upper:]' '[:lower:]' <<<"${RUN_ID}")" # The lanes boot the qualification image: the application with every capability module on the # classpath (src/Dockerfile COMPOSITION, app-bootstrap qualificationBootJar). The default image is # the composition a service ships and carries none of them, so a lane that switches JPA or Kafka on -# would have nothing to switch. docker-compose.yml passes this to the build and puts it in the tag. +# would have nothing to switch. compose.yaml passes this to the build and puts it in the tag. export COMPOSITION=qualification # Every capability is on while its module is present, so each lane starts from all of them off and @@ -79,6 +81,9 @@ for tool in jq docker; do done [[ -r "${CONTRACTS}" ]] || { echo "missing ${CONTRACTS}" >&2; exit 78; } +# The lane-only TLS overlay's keypair directory (src/app-bootstrap/compose-lanes/tls.yaml). +LANE_POSTGRES_TLS="${REPO_ROOT}/src/app-bootstrap/compose-lanes/postgres/tls" + # ---- per-lane state, cleaned up by the trap --------------------------------- PROJECT="" LANE_TMP="" @@ -109,14 +114,14 @@ cleanup_lane() { fi [[ -n "${LANE_TMP}" && -d "${LANE_TMP}" ]] && rm -rf "${LANE_TMP}" # .env.lane is gone — the lane's values live in the generated overlay now — but a file left by an - # older revision of this script would still be read by the local overlay's env_file list. - rm -f "${REPO_ROOT}/src/.env.lane" "${REPO_ROOT}/infra/keycloak/secrets/graphql-smoke-client-secret" + # older revision of this script would still be read by an env_file list of an older stack. + rm -f "${REPO_ROOT}/src/.env.lane" "${REPO_ROOT}/compose/keycloak/secrets/graphql-smoke-client-secret" # The lane keypair, including the CA's private half. A certificate that outlives the run it was # made for is a credential nobody is tracking. - rm -f "${REPO_ROOT}"/infra/postgres/tls/ca.key "${REPO_ROOT}"/infra/postgres/tls/ca.crt \ - "${REPO_ROOT}"/infra/postgres/tls/ca.srl "${REPO_ROOT}"/infra/postgres/tls/server.key \ - "${REPO_ROOT}"/infra/postgres/tls/server.crt "${REPO_ROOT}"/infra/postgres/tls/server.csr \ - "${REPO_ROOT}"/infra/mailpit/tls/server.key "${REPO_ROOT}"/infra/mailpit/tls/server.crt + rm -f "${LANE_POSTGRES_TLS}"/ca.key "${LANE_POSTGRES_TLS}"/ca.crt \ + "${LANE_POSTGRES_TLS}"/ca.srl "${LANE_POSTGRES_TLS}"/server.key \ + "${LANE_POSTGRES_TLS}"/server.crt "${LANE_POSTGRES_TLS}"/server.csr \ + "${REPO_ROOT}"/compose/mailpit/tls/server.key "${REPO_ROOT}"/compose/mailpit/tls/server.crt return "${status}" } @@ -140,9 +145,8 @@ random_key() { head -c 32 /dev/urandom | base64 | tr -d '\n'; } run_lane() { local lane_json="$1" - local id profile runtime + local id runtime profile id="$(jq -r '.id' <<<"${lane_json}")" - profile="$(jq -r '.composeProfile // empty' <<<"${lane_json}")" runtime="$(jq -r '.springRuntime' <<<"${lane_json}")" PROJECT="casmoke-${id}-${PROJECT_RUN_ID}" @@ -161,10 +165,14 @@ run_lane() { file="$(jq -r --arg k "${key}" '.composeFiles[$k]' "${CONTRACTS}")" LANE_ARGS+=(-f "${REPO_ROOT}/${file}") done < <(jq -r '.files[]' <<<"${lane_json}") - [[ -n "${profile}" ]] && LANE_ARGS+=(--profile "${profile}") + # The development stack's backing services carry capability profiles and the lane-only services + # their own, so a lane enables several. The list is the lane's, never a guess from its name. + while read -r profile; do + [[ -n "${profile}" ]] && LANE_ARGS+=(--profile "${profile}") + done < <(jq -r '.composeProfiles[]' <<<"${lane_json}") # A fresh client secret per run, mode 0600, removed on teardown. The realm references it by name. - local secret_dir="${REPO_ROOT}/infra/keycloak/secrets" + local secret_dir="${REPO_ROOT}/compose/keycloak/secrets" local secret_file="${secret_dir}/graphql-smoke-client-secret" mkdir -p "${secret_dir}" local client_secret; client_secret="$(random_secret)" @@ -177,7 +185,7 @@ run_lane() { # a private key in Git. The host name matters — the prod runtime connects with sslmode=verify-full, # which checks the certificate against the name it dialled, so a certificate for anything but `db` # fails exactly as a redirected connection would. That is the check, working. - local tls_dir="${REPO_ROOT}/infra/postgres/tls" + local tls_dir="${LANE_POSTGRES_TLS}" if jq -e '.files | index("tls")' <<<"${lane_json}" >/dev/null; then mkdir -p "${tls_dir}" ( @@ -205,7 +213,7 @@ run_lane() { # Same rule as the PostgreSQL one above and for the same reason: the notification platform's # transport type has no plaintext member, so a relay without a certificate is one the platform # cannot be configured to talk to. Generated per run, removed on teardown. - local mail_tls="${REPO_ROOT}/infra/mailpit/tls" + local mail_tls="${REPO_ROOT}/compose/mailpit/tls" if jq -e '.services | index("mailpit")' <<<"${lane_json}" >/dev/null; then mkdir -p "${mail_tls}" ( @@ -232,7 +240,7 @@ run_lane() { # interpolation reads the process environment and the project .env file, never a service's # env_file. So the application got the generated password and the database got the literal # default, and no lane whose overlay did not happen to restate the value could ever authenticate. - # shared-infra-local passed only because the local overlay restates it, which made the dev lane's + # shared-infra-local passed only because the local overlay (now compose.yaml) restated it, which made the dev lane's # failure look like a dev-specific problem rather than the general one it is. export POSTGRES_DB=ca_skeleton export APP_DATASOURCE_USERNAME=ca_skeleton @@ -323,7 +331,7 @@ run_lane() { # The lane's own settings go into a generated overlay rather than into that file. # # env_file lists merge across overlays and the later file wins, so the developer's optional - # src/.env — declared by the local overlay, after the base — silently overrode the lane's values. + # src/.env — declared by the local overlay (now compose.yaml) — silently overrode the lane's values. # local-messaging started Kafka, set APP_MESSAGING_BROKER=kafka, and was refused by the dependency # validator for a broker it had supplied, because an empty value from a file nobody mentioned won # the merge. An `environment:` block beats every env_file regardless of order, so the lane's @@ -333,6 +341,10 @@ run_lane() { # Written as a function, because a handoff lane rewrites it between phases: the same project and # the same database, with the application recreated under a different activation environment. local lane_overlay="${LANE_TMP}/lane-overrides.yml" + # The application's memory limit, when the lane needs more than the development stack's 512m. + # Only the lane that boots every capability at once does (the contract's appMemoryLimit says why). + local memory_limit + memory_limit="$(jq -r '.appMemoryLimit // empty' <<<"${lane_json}")" write_lane_overlay() { local phase_override="${1:-{\}}" ( @@ -340,6 +352,10 @@ run_lane() { { echo "services:" echo " app:" + if [[ -n "${memory_limit}" ]]; then + echo " mem_limit: ${memory_limit}" + echo " memswap_limit: ${memory_limit}" + fi echo " environment:" local entry for entry in "${lane_environment[@]}"; do @@ -550,13 +566,38 @@ run_lane() { return 1 fi + # 4a. No container of the lane restarted and none was killed for memory. + # + # The application runs with `restart: unless-stopped`, so a container the kernel killed for + # exceeding its memory limit came back on its own. all-adapters did exactly that for a long time + # and failed only when the kill happened to land on a smoke request; every other run reported + # green over a container that had died and restarted under it (integration-r9, 2026-11-07). The + # checks above all ask the application a question, and a restarted application answers them, so + # the restart itself has to be the failure. The peak memory is recorded beside it, so a lane that + # is close to its limit is visible before it crosses it. + local container restarted="" + docker compose -p "${PROJECT}" "${LANE_ARGS[@]}" exec -T app cat /sys/fs/cgroup/memory.peak \ + >"${LANE_EVIDENCE}/app-memory-peak-bytes.txt" 2>/dev/null || true + while read -r container; do + [[ -z "${container}" ]] && continue + docker inspect --format '{{.Name}} restarts={{.RestartCount}} oomKilled={{.State.OOMKilled}}' \ + "${container}" >>"${LANE_EVIDENCE}/restarts.txt" + done < <(docker compose -p "${PROJECT}" "${LANE_ARGS[@]}" ps -a -q) + restarted="$(grep -v ' restarts=0 oomKilled=false$' "${LANE_EVIDENCE}/restarts.txt" || true)" + if [[ -n "${restarted}" ]]; then + echo "${id}: a container restarted or was killed for memory during the lane:" >&2 + echo "${restarted}" >&2 + return 1 + fi + # 5. the manifest ties the evidence to the exact stack that produced it jq -n \ --arg lane "${id}" --arg run "${RUN_ID}" --arg project "${PROJECT}" \ - --arg runtime "${runtime}" --arg profile "${profile}" \ + --arg runtime "${runtime}" \ + --argjson profiles "$(jq '.composeProfiles' <<<"${lane_json}")" \ --argjson services "$(jq '.services' <<<"${lane_json}")" \ '{lane:$lane, runId:$run, project:$project, springRuntime:$runtime, - composeProfile:(if $profile=="" then null else $profile end), services:$services}' \ + composeProfiles:$profiles, services:$services}' \ >"${LANE_EVIDENCE}/manifest.json" echo "== ${id}: passed" diff --git a/scripts/verify-compose-profile-contracts.sh b/scripts/verify-compose-profile-contracts.sh index c12bb386..28b86573 100755 --- a/scripts/verify-compose-profile-contracts.sh +++ b/scripts/verify-compose-profile-contracts.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # The static half of the Compose contract: every lane renders, and renders exactly what it claims. # -# Seven things are checked, and each exists because assuming it cost something: +# Nine things are checked, and each exists because assuming it cost something: # # 1. the Compose version, because `!override` is what stops the dev overlay's tmpfs merging with # the base's and colliding with a bind mount, and it needs 2.24.4; @@ -22,12 +22,15 @@ # lanes ran Redis open and the application anonymous, and the two startup warnings that trade # prints failed the "startup is silent" check of every such lane (r3-J). Lowering that warning # would hide the same trade in production; the lane has to look like a deployment instead. +# 8. a lane's appMemoryLimit, when it has one, is a Compose memory size, because the smoke wrapper +# writes it into the application's mem_limit and a malformed one fails only at `up`. +# 9. the Keycloak realm artifact carries no key Keycloak refuses (below the lane loop). # # Static only. Nothing starts here; scripts/run-compose-runtime-smoke.sh owns that. set -euo pipefail REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" -CONTRACTS="${REPO_ROOT}/src/config/runtime/compose-profile-contracts.json" +CONTRACTS="${REPO_ROOT}/src/app-bootstrap/compose-lanes/compose-profile-contracts.json" FAILURES=0 fail() { echo " FAIL: $*" >&2; FAILURES=$((FAILURES + 1)); } @@ -118,7 +121,6 @@ lane_count="$(jq '.lanes | length' "${CONTRACTS}")" for index in $(seq 0 $((lane_count - 1))); do lane="$(jq -c ".lanes[${index}]" "${CONTRACTS}")" id="$(jq -r '.id' <<<"${lane}")" - profile="$(jq -r '.composeProfile // empty' <<<"${lane}")" runtime="$(jq -r '.springRuntime' <<<"${lane}")" expected="$(jq -r '.services | sort | join(",")' <<<"${lane}")" @@ -130,7 +132,9 @@ for index in $(seq 0 $((lane_count - 1))); do done < <(jq -r '.files[]' <<<"${lane}") profile_args=() - [[ -n "${profile}" ]] && profile_args=(--profile "${profile}") + while read -r profile; do + [[ -n "${profile}" ]] && profile_args+=(--profile "${profile}") + done < <(jq -r '.composeProfiles[]' <<<"${lane}") # 2. exact service set # stderr goes to a file rather than into the list. It used to be merged with `2>&1`, so Compose's @@ -223,20 +227,26 @@ for index in $(seq 0 $((lane_count - 1))); do done < <(redis_authentication_problems "${lane}" "${model}") fi + # 8. the lane's own memory limit, when it sets one. + memory_limit="$(jq -r '.appMemoryLimit // empty' <<<"${lane}")" + if [[ -n "${memory_limit}" && ! "${memory_limit}" =~ ^[1-9][0-9]*[kmg]$ ]]; then + fail "${id}: appMemoryLimit '${memory_limit}' is not a Compose memory size such as 1g" + fi + [[ ${FAILURES} -eq 0 ]] && echo "${id}: ${expected} @ ${runtime}" done -# 8. the Keycloak realm artifact deserializes into Keycloak's own representation. +# 9. the Keycloak realm artifact deserializes into Keycloak's own representation. # # Keycloak rejects unknown fields rather than ignoring them, so one annotation key anywhere in the # tree fails the whole import, the container exits 1, and every lane that needs an identity provider # fails on Keycloak instead of on what it was testing. This cost two lane runs to find, once for # `_comment` on the realm and once for `_flowComment` on a client, because the second was invisible -# until the first was fixed. Rationale for that artifact lives in infra/keycloak/README.md. -realm="${REPO_ROOT}/infra/keycloak/realms/ca-skeleton-realm.json" +# until the first was fixed. Rationale for that artifact lives in compose/keycloak/README.md. +realm="${REPO_ROOT}/compose/keycloak/realms/ca-skeleton-realm.json" if [[ -f "${realm}" ]]; then if ! jq empty "${realm}" >/dev/null 2>&1; then - fail "infra/keycloak/realms/ca-skeleton-realm.json is not valid JSON" + fail "compose/keycloak/realms/ca-skeleton-realm.json is not valid JSON" else annotations="$(jq -r '[paths(scalars, objects, arrays) | .[-1] | select(type == "string") | select(startswith("_"))] | unique | join(", ")' "${realm}")" if [[ -n "${annotations}" ]]; then @@ -249,4 +259,4 @@ if [[ ${FAILURES} -gt 0 ]]; then echo "verify-compose-profile-contracts: ${FAILURES} lane(s) do not match the contract" >&2 exit 1 fi -echo "verify-compose-profile-contracts: all ${lane_count} lanes match src/config/runtime/compose-profile-contracts.json" +echo "verify-compose-profile-contracts: all ${lane_count} lanes match src/app-bootstrap/compose-lanes/compose-profile-contracts.json" diff --git a/src/.env.example b/src/.env.example index 9ba52278..5b3cae28 100644 --- a/src/.env.example +++ b/src/.env.example @@ -155,8 +155,8 @@ APP_REDIS_TIMEOUT_SCRIPT=1s # reads the password from and authenticates as . With the application # reference empty and anonymous access not accepted, the application refuses to start while Redis # is on; with the advanced one empty, scripts run as the application account and startup warns. The -# Compose Redis lanes connect as the fixture accounts of infra/redis-sdk/acl/lane-fixture-accounts.acl (the -# Redis comment in src/config/runtime/compose-profile-contracts.json). +# Compose Redis lanes connect as the fixture accounts of compose/redis/acl/lane-fixture-accounts.acl (the +# Redis comment in src/app-bootstrap/compose-lanes/compose-profile-contracts.json). APP_REDIS_AUTHENTICATION_ADVANCED_CREDENTIAL_REFERENCE= APP_REDIS_AUTHENTICATION_ANONYMOUS_ACCESS_ACCEPTED=false APP_REDIS_AUTHENTICATION_CREDENTIAL_REFERENCE= diff --git a/src/README.md b/src/README.md index 8d063639..4e35f4f9 100644 --- a/src/README.md +++ b/src/README.md @@ -46,10 +46,10 @@ Checkstyle은 **포매터가 표현할 수 없는 것만** — 네이밍과 몇 ### Local bootstrap -`scripts/bootstrap-local.sh [profile]`(저장소 루트)은 compile → Docker 확인 → DB 기동 대기 → +`scripts/bootstrap-local.sh`(저장소 루트)은 compile → Docker 확인 → DB 기동 대기 → app 기동(Flyway 포함) → health smoke를 순서대로 실행합니다(예전 `./gradlew bootstrap`, 리뷰 BUILD-O3-5로 build-logic 플러그인에서 스크립트로 옮김). -DB와 app lifecycle은 저장소 루트의 base/local Compose 조합이 소유하며, app startup Flyway가 +DB와 app lifecycle은 저장소 루트의 개발 compose 파일 `compose.yaml`(`db`는 `jpa` profile)이 소유하며, app startup Flyway가 끝나 public health endpoint가 준비되어야 다음 단계로 넘어갑니다. `src/.env.example`은 커밋된 env 계약이고 `src/.env`는 로컬 실행 입력입니다. `verifyEnvKeys`는 example/registry/shipped YAML을 함께 검사합니다. @@ -296,8 +296,9 @@ Kafka 없이 기동합니다. 나머지 기능은 `app-bootstrap/build.gradle` ### Compose와 런타임 스모크 -- **Docker Compose 최소 버전 `2.24.4`.** SSOT는 `src/config/runtime/compose-profile-contracts.json` - 이고, 정본 스크립트가 검증합니다. +- **Docker Compose 최소 버전 `2.24.4`.** SSOT는 `src/app-bootstrap/compose-lanes/compose-profile-contracts.json` + 이고, 정본 스크립트가 검증합니다. lane은 저장소 루트 `compose.yaml`(개발 환경)을 바탕으로 쓰고, lane에만 + 필요한 overlay·smoke client·스키마 적용은 `src/app-bootstrap/compose-lanes/`에 있습니다. - 진입점은 둘뿐이고, 그 둘만이 증거입니다. 워크플로에 명령 일부를 인라인하면 one-shot 없이 도는 레인이 초록으로 보고됩니다. @@ -305,9 +306,9 @@ Kafka 없이 기동합니다. 나머지 기능은 `app-bootstrap/build.gradle` # 정적: profile별 정확한 service set, 병합된 모델 전체, mount target 유일성 ./scripts/verify-compose-profile-contracts.sh -# 동적: 15개 blocking 레인을 zero-skip으로. create → up --wait → 필수 one-shot → -# sanitized evidence → 고유 project teardown -./scripts/run-compose-runtime-smoke.sh --matrix src/config/runtime/compose-profile-contracts.json +# 동적: 계약의 blocking 레인을 zero-skip으로. create → up --wait → 필수 one-shot → +# 컨테이너 재시작·OOM 0 확인 → sanitized evidence → 고유 project teardown +./scripts/run-compose-runtime-smoke.sh --matrix src/app-bootstrap/compose-lanes/compose-profile-contracts.json ``` `--lane `는 실패 재현용이고, 레인 하나가 초록인 것은 matrix가 통과했다는 증거가 아닙니다. @@ -532,11 +533,11 @@ migration/vendor 계약의 증거로 사용하지 않습니다. 멱등성 provid `disabled`(기본)나 `redis`로 둡니다. `postgresql`은 H2 data source에서 기동을 거부합니다. `dev` 를 호스트에서 띄우려면(`SPRING_PROFILES_ACTIVE=dev`) PostgreSQL 이 필요합니다. -`docker-compose.local.yml` 의 `db` 서비스가 루프백(`127.0.0.1:5433`)에만 게시하며, 이 주소가 +`compose.yaml` 의 `db` 서비스(`jpa` profile)가 루프백(`127.0.0.1:5433`)에만 게시하며, 이 주소가 아래 `APP_DATASOURCE_URL` 의 커밋된 기본값입니다. 저장소 루트에서 실행합니다. ```bash -docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --wait db +docker compose up -d --wait db ``` 컨테이너로 띄우는 `scripts/bootstrap-local.sh` 경로는 이 호스트 포트를 쓰지 않습니다. compose 가 app diff --git a/src/adapter/outbound/cache-redis/CLAUDE.md b/src/adapter/outbound/cache-redis/CLAUDE.md index f8094a64..9f56d803 100644 --- a/src/adapter/outbound/cache-redis/CLAUDE.md +++ b/src/adapter/outbound/cache-redis/CLAUDE.md @@ -130,7 +130,7 @@ be silently skipped when selected. Two real-server lanes. `redisContainerContractTest` (integration category, in `integrationCheck` only — not in this leaf's `mainCheck` too, which ran it twice per push to main) starts its own Redis with Testcontainers — the `redis` image of -`config/testing/container-images.properties`, loading `infra/redis-sdk/acl/lane-fixture-accounts.acl` — and +`config/testing/container-images.properties`, loading `compose/redis/acl/lane-fixture-accounts.acl` — and runs `LiveRedisCacheRegionContractTest`, `LiveRedisDistributedLeaseContractTest` and `LiveRedisIdempotencyStoreContractTest` (the `application-core` port contracts the in-memory fakes also pass), `LiveRedisSemanticPortsTest` and `LiveRedisSemanticScriptAclProbeTest`; a skip fails it diff --git a/src/adapter/outbound/cache-redis/build.gradle b/src/adapter/outbound/cache-redis/build.gradle index f9909060..d0f217cb 100644 --- a/src/adapter/outbound/cache-redis/build.gradle +++ b/src/adapter/outbound/cache-redis/build.gradle @@ -69,14 +69,15 @@ redisTopologyLane { // needs coordinates of a topology someone else started — so until this lane existed the Redis // adapters' port contracts reached a real server in no stage, and the fake and the adapter could hide // the same defect (05-02, 05-03). The image is config/testing/container-images.properties' `redis`, -// and the ACL file is infra/redis-sdk's own, so the accounts and their rights are the standalone +// and the ACL file is the one the development stack and the redis-sdk topologies share +// (compose/redis/acl), so the accounts and their rights are the standalone // topology's. Integration category, so integrationCheck runs it — integration-main.yml's // `integration-check` job, on every push to main and nightly. It is deliberately not in this leaf's // mainCheck as well: `main-check` and `integration-check` are two jobs of the same workflow run, so a // lane in both started a second Redis container and ran every live contract twice per push without // covering anything the first run did not (found while fixing review 2026-11-03). Sentinel, cluster // and TLS remain the topology lane's. -def redisAclDirectory = rootProject.projectDir.parentFile.toPath().resolve('infra/redis-sdk/acl').toFile() +def redisAclDirectory = rootProject.projectDir.parentFile.toPath().resolve('compose/redis/acl').toFile() strictTestLanes { lane('redisContainerContractTest') { integration() diff --git a/src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/RedisTestContainer.java b/src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/RedisTestContainer.java index 65ef2da7..43287b02 100644 --- a/src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/RedisTestContainer.java +++ b/src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/RedisTestContainer.java @@ -12,7 +12,7 @@ import org.testcontainers.utility.MountableFile; * One Redis server for the container lane ({@code redisContainerContractTest}), so the live * contracts run against a real server without an external topology (review 2026-11-01 05-16). * - *

The server is the standalone topology of {@code infra/redis-sdk}: the image is the {@code + *

The server is the standalone topology of {@code redis-sdk/compose}: the image is the {@code * redis} entry of {@code config/testing/container-images.properties} (handed to every test JVM as * {@code ca.test.image.redis}), and the ACL file is the one that topology loads, so the default * user is off and the application and advanced accounts carry the same rights they carry there. A diff --git a/infra/fileserver/nfs/compose.yml b/src/adapter/outbound/fileserver/compose/nfs/compose.yml similarity index 88% rename from infra/fileserver/nfs/compose.yml rename to src/adapter/outbound/fileserver/compose/nfs/compose.yml index e029819c..b34eba6f 100644 --- a/infra/fileserver/nfs/compose.yml +++ b/src/adapter/outbound/fileserver/compose/nfs/compose.yml @@ -7,11 +7,11 @@ # # Opt in with FILESERVER_NFS_TESTS=true; the default test run does not start this. # -# docker compose -f infra/fileserver/nfs/compose.yml up -d +# docker compose -f src/adapter/outbound/fileserver/compose/nfs/compose.yml up -d # FILESERVER_NFS_TESTS=true ./gradlew :adapter:outbound:fileserver:test # # To exercise the ambiguity paths: -# docker compose -f infra/fileserver/nfs/compose.yml restart nfs-server # stale handles +# docker compose -f src/adapter/outbound/fileserver/compose/nfs/compose.yml restart nfs-server # stale handles # docker network disconnect fileserver-nfs # lost responses services: @@ -49,7 +49,7 @@ services: mount -t nfs4 -o hard,timeo=50,retrans=2 nfs-server:/ /mnt/fileserver && tail -f /dev/null" volumes: - - ../../..:/workspace:ro + - ../../../../../..:/workspace:ro networks: - fileserver-nfs diff --git a/src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/testkit/NfsAmbiguityIntegrationTest.java b/src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/testkit/NfsAmbiguityIntegrationTest.java index 31f303c6..5ccc7844 100644 --- a/src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/testkit/NfsAmbiguityIntegrationTest.java +++ b/src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/testkit/NfsAmbiguityIntegrationTest.java @@ -14,7 +14,7 @@ import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; * *

These scenarios cannot be reproduced on a local filesystem, so they are gated rather than * quietly skipped: a green default run must never be mistaken for network-filesystem certification. - * The environment is defined in {@code infra/fileserver/nfs/compose.yml}. + * The environment is defined in {@code src/adapter/outbound/fileserver/compose/nfs/compose.yml}. */ @EnabledIfEnvironmentVariable(named = NfsTestEnvironment.ENABLE_FLAG, matches = "true") class NfsAmbiguityIntegrationTest { diff --git a/src/adapter/outbound/objectstorage/README.md b/src/adapter/outbound/objectstorage/README.md index ed713659..24602ad6 100644 --- a/src/adapter/outbound/objectstorage/README.md +++ b/src/adapter/outbound/objectstorage/README.md @@ -120,7 +120,7 @@ release the `status`, `excludedProfiles` and `limitations` beside it were measur `-PobjectStorageMinioImage=/@sha256:`. A value that does not end in the evidence digest is refused: a different build is a new measurement, made by re-running the lanes and rewriting the evidence file (image and findings together). -- The local compose runtime (`docker-compose.infra.yml`, `LOCAL_MINIO_IMAGE`) uses the same digest. +- The local compose runtime (`compose.yaml`, and the compose lanes' smoke client in `src/app-bootstrap/compose-lanes/lane-services.yaml`; `LOCAL_MINIO_IMAGE`) uses the same digest. `ComposeMinioImageMatchesEvidenceTest` (leaf `test`) fails when the compose default and the evidence disagree; change both together. - The contract lane also runs `MinioS3ManagedObjectProviderContractTest`: the S3 adapter itself under diff --git a/src/adapter/outbound/objectstorage/build.gradle b/src/adapter/outbound/objectstorage/build.gradle index ee772b62..15612ce7 100644 --- a/src/adapter/outbound/objectstorage/build.gradle +++ b/src/adapter/outbound/objectstorage/build.gradle @@ -96,16 +96,21 @@ dependencies { def objectStorageReadinessRegistry = rootProject.projectDir.parentFile.toPath() .resolve('docs/registries/object-storage-readiness.yaml').toFile() // The local compose MinIO must be the image the evidence measured (review 05-09); -// ComposeMinioImageMatchesEvidenceTest compares the two. -def localComposeFile = rootProject.projectDir.parentFile.toPath() - .resolve('docker-compose.infra.yml').toFile() +// ComposeMinioImageMatchesEvidenceTest compares the two. The development stack runs the server and +// the compose lanes' smoke client runs the same image; YAML anchors do not cross files, so each file +// carries its own default and both are compared. +def repositoryRootForCompose = rootProject.projectDir.parentFile.toPath() +def localComposeFiles = [ + repositoryRootForCompose.resolve('compose.yaml').toFile(), + repositoryRootForCompose.resolve('src/app-bootstrap/compose-lanes/lane-services.yaml').toFile(), +] tasks.named('test') { inputs.file(objectStorageReadinessRegistry) .withPathSensitivity(PathSensitivity.RELATIVE) systemProperty 'objectstorage.readiness.registry', objectStorageReadinessRegistry.absolutePath - inputs.file(localComposeFile) + inputs.files(localComposeFiles) .withPathSensitivity(PathSensitivity.RELATIVE) - systemProperty 'objectstorage.compose.file', localComposeFile.absolutePath + systemProperty 'objectstorage.compose.files', localComposeFiles*.absolutePath.join(File.pathSeparator) } // A mirror of the measured MinIO digest, for when the origin registry stops serving it (review diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/ComposeMinioImageMatchesEvidenceTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/ComposeMinioImageMatchesEvidenceTest.java index 91f91394..13cf4384 100644 --- a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/ComposeMinioImageMatchesEvidenceTest.java +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/ComposeMinioImageMatchesEvidenceTest.java @@ -2,9 +2,11 @@ package dev.caskeleton.adapter.outbound.objectstorage.qualification; import static org.assertj.core.api.Assertions.assertThat; +import java.io.File; import java.io.IOException; import java.nio.file.Files; import java.nio.file.Path; +import java.util.List; import java.util.Optional; import java.util.regex.Matcher; import java.util.regex.Pattern; @@ -13,12 +15,14 @@ import org.junit.jupiter.api.Test; /** * The local compose MinIO is the image the lanes measured. Compose cannot read the evidence JSON, - * so this is the one check that keeps the two references from drifting apart again (review 05-09: - * four copies, two of them disagreeing). The build declares the compose file as this task's input. + * so this is the one check that keeps the references from drifting apart again (review 05-09: four + * copies, two of them disagreeing). Two Compose files carry the default — the development stack's + * server and the compose lanes' smoke client, because a YAML anchor does not cross files — and the + * build declares both as this task's input. */ class ComposeMinioImageMatchesEvidenceTest { - static final String COMPOSE_FILE_PROPERTY = "objectstorage.compose.file"; + static final String COMPOSE_FILES_PROPERTY = "objectstorage.compose.files"; private static final Pattern LOCAL_MINIO_DEFAULT = Pattern.compile( "x-local-minio-image:\\s*&local-minio-image\\s*\"\\$\\{LOCAL_MINIO_IMAGE:-([^}]+)}\""); @@ -27,14 +31,21 @@ class ComposeMinioImageMatchesEvidenceTest { @DisplayName("compose의 기본 MinIO 이미지는 evidence가 측정한 이미지와 같은 digest다") void theComposeDefaultMinioImageIsTheMeasuredEvidenceImage() throws IOException { // given - String compose = Files.readString(Path.of(System.getProperty(COMPOSE_FILE_PROPERTY))); - Matcher defaultImage = LOCAL_MINIO_DEFAULT.matcher(compose); + List composeFiles = + Pattern.compile(Pattern.quote(File.pathSeparator)) + .splitAsStream(System.getProperty(COMPOSE_FILES_PROPERTY)) + .map(Path::of) + .toList(); // when String measured = MinioQualificationImage.load(Optional.empty()).minio(); // then - assertThat(defaultImage.find()).as("x-local-minio-image default in the compose file").isTrue(); - assertThat(defaultImage.group(1)).isEqualTo(measured); + assertThat(composeFiles).hasSize(2); + for (Path composeFile : composeFiles) { + Matcher defaultImage = LOCAL_MINIO_DEFAULT.matcher(Files.readString(composeFile)); + assertThat(defaultImage.find()).as("x-local-minio-image default in %s", composeFile).isTrue(); + assertThat(defaultImage.group(1)).as("%s", composeFile).isEqualTo(measured); + } } } diff --git a/src/adapter/outbound/redis-runtime/src/testFixtures/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/RedisTopologyEndpoint.java b/src/adapter/outbound/redis-runtime/src/testFixtures/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/RedisTopologyEndpoint.java index 00307b0f..7a387951 100644 --- a/src/adapter/outbound/redis-runtime/src/testFixtures/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/RedisTopologyEndpoint.java +++ b/src/adapter/outbound/redis-runtime/src/testFixtures/java/dev/caskeleton/adapter/outbound/cache/redis/runtime/RedisTopologyEndpoint.java @@ -165,7 +165,7 @@ public record RedisTopologyEndpoint( * *

Deliberately credential-free, and that is not an oversight. A sentinel is a different * process with its own ACL: it does not load the data nodes' {@code aclfile}, so the accounts in - * {@code infra/redis-sdk/acl} do not exist there and presenting one gets {@code WRONGPASS}. The + * {@code compose/redis/acl} do not exist there and presenting one gets {@code WRONGPASS}. The * {@code sentinel auth-user} / {@code auth-pass} directives in the lane are about how the * sentinel authenticates to the monitored primary, which is a different direction * entirely. Securing the sentinels themselves would mean giving them their own ACL file, and the diff --git a/src/adapter/outbound/redis-sdk/README.md b/src/adapter/outbound/redis-sdk/README.md index b591af57..cf641d16 100644 --- a/src/adapter/outbound/redis-sdk/README.md +++ b/src/adapter/outbound/redis-sdk/README.md @@ -47,7 +47,7 @@ service contributes them to the runtime as beans, one per lane it uses, through — and builds `LettuceRedisCommandGateway.over(lease.driver())` over a borrowed lease. The last bean matters only with an admin account: under `prod`, `SecretSourceValidator` refuses a secret that holds -a lane fixture password (`fixture-admin` is in `infra/redis-sdk/acl`), but it learns which variables +a lane fixture password (`fixture-admin` is in `compose/redis/acl`), but it learns which variables are secrets from the registry, from `secret://` references in the environment and from `RequiredProductionSecrets` beans — not from a reference held in code. Without the bean the admin account could run in production on the public lane password (review 2026-11-04 RR3-04-03). The SDK @@ -107,5 +107,5 @@ The SDK reads none itself. It runs on `redis-runtime`, whose rows in Contract tests run the operations against this leaf's own in-memory gateway (`InMemoryRedisCommandGateway`, test sources); the topology endpoint helper comes from `testFixtures(project(':adapter:outbound:redis-runtime'))`. The real-server lane is -`redisTopologyTest` (see `infra/redis-sdk/README.md`); this leaf declares `standalone`, `sentinel` +`redisTopologyTest` (see [compose/README.md](compose/README.md)); this leaf declares `standalone`, `sentinel` and `cluster` in `build.gradle`. `tls` is qualified by `redis-runtime`. diff --git a/infra/redis-sdk/README.md b/src/adapter/outbound/redis-sdk/compose/README.md similarity index 93% rename from infra/redis-sdk/README.md rename to src/adapter/outbound/redis-sdk/compose/README.md index 832c5860..291b8572 100644 --- a/infra/redis-sdk/README.md +++ b/src/adapter/outbound/redis-sdk/compose/README.md @@ -25,9 +25,9 @@ in the repository is a private key in the repository, however the file is named day, so a stale lane fails visibly instead of drifting. ```bash -REDIS_VERSION=7.4 docker compose -f infra/redis-sdk/tls/compose.yml up -d --wait +REDIS_VERSION=7.4 docker compose -f src/adapter/outbound/redis-sdk/compose/tls/compose.yml up -d --wait # The client needs the generated CA; copy it out of the volume first. -docker compose -f infra/redis-sdk/tls/compose.yml cp redis:/tls/ca.crt /tmp/redis-lane-ca.pem +docker compose -f src/adapter/outbound/redis-sdk/compose/tls/compose.yml cp redis:/tls/ca.crt /tmp/redis-lane-ca.pem cd src && ./gradlew :adapter:outbound:redis-runtime:redisTopologyTest \ -Predis.topology.host=127.0.0.1 -Predis.topology.port=6390 \ -Predis.topology.mode=tls -Predis.topology.trust-material=/tmp/redis-lane-ca.pem @@ -73,12 +73,12 @@ rest of the topology is discovered. ```bash # Standalone -REDIS_VERSION=7.4 docker compose -f infra/redis-sdk/standalone/compose.yml up -d --wait +REDIS_VERSION=7.4 docker compose -f src/adapter/outbound/redis-sdk/compose/standalone/compose.yml up -d --wait cd src && ./gradlew :adapter:outbound:redis-runtime:redisTopologyTest :adapter:outbound:redis-sdk:redisTopologyTest :adapter:outbound:cache-redis:redisTopologyTest \ -Predis.topology.host=localhost -Predis.topology.port=6379 -Predis.topology.mode=standalone # Sentinel — the port is a sentinel, and the monitored primary has to be named -REDIS_VERSION=7.4 docker compose -f infra/redis-sdk/sentinel/compose.yml up -d --wait +REDIS_VERSION=7.4 docker compose -f src/adapter/outbound/redis-sdk/compose/sentinel/compose.yml up -d --wait cd src && ./gradlew :adapter:outbound:redis-runtime:redisTopologyTest :adapter:outbound:redis-sdk:redisTopologyTest \ -Predis.topology.host=localhost -Predis.topology.port=27010 \ -Predis.topology.mode=sentinel -Predis.topology.master=skeleton @@ -86,7 +86,7 @@ cd src && ./gradlew :adapter:outbound:redis-runtime:redisTopologyTest :adapter:o # Cluster — `up --wait` waits for the `ready` gate, not just for six servers that answer PING. # Slot assignment finishes after the nodes are healthy, and a client that connects in between sees # CLUSTERDOWN for reasons that have nothing to do with the SDK. -REDIS_VERSION=7.4 docker compose -f infra/redis-sdk/cluster/compose.yml up -d --wait +REDIS_VERSION=7.4 docker compose -f src/adapter/outbound/redis-sdk/compose/cluster/compose.yml up -d --wait cd src && ./gradlew :adapter:outbound:redis-runtime:redisTopologyTest :adapter:outbound:redis-sdk:redisTopologyTest :adapter:outbound:cache-redis:redisTopologyTest \ -Predis.topology.host=localhost -Predis.topology.port=7100 -Predis.topology.mode=cluster ``` @@ -102,7 +102,7 @@ declare fails instead of running nothing, so run only the leaves listed for the | cluster | `LiveRedisCompositionTest` | `LiveRedisClusterTest`, `LiveRedisClusterTransactionTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest` | | tls | `LiveRedisTlsTest` | — | — | -Tear a lane down with `docker compose -f infra/redis-sdk//compose.yml down -v`. +Tear a lane down with `docker compose -f src/adapter/outbound/redis-sdk/compose//compose.yml down -v`. | Lane | Ports | Notes | | --- | --- | --- | diff --git a/infra/redis-sdk/cluster/compose.yml b/src/adapter/outbound/redis-sdk/compose/cluster/compose.yml similarity index 98% rename from infra/redis-sdk/cluster/compose.yml rename to src/adapter/outbound/redis-sdk/compose/cluster/compose.yml index aefe63ff..3439d338 100644 --- a/infra/redis-sdk/cluster/compose.yml +++ b/src/adapter/outbound/redis-sdk/compose/cluster/compose.yml @@ -25,7 +25,7 @@ x-node: &node image: "redis:${REDIS_VERSION:-7.4}" network_mode: host volumes: - - ../acl:/etc/redis/acl:ro + - ../../../../../../compose/redis/acl:/etc/redis/acl:ro entrypoint: - /bin/sh - -c diff --git a/infra/redis-sdk/sentinel/compose.yml b/src/adapter/outbound/redis-sdk/compose/sentinel/compose.yml similarity index 98% rename from infra/redis-sdk/sentinel/compose.yml rename to src/adapter/outbound/redis-sdk/compose/sentinel/compose.yml index 9aab8f37..db059a38 100644 --- a/infra/redis-sdk/sentinel/compose.yml +++ b/src/adapter/outbound/redis-sdk/compose/sentinel/compose.yml @@ -29,7 +29,7 @@ x-data-node: &data-node image: "redis:${REDIS_VERSION:-7.4}" network_mode: host volumes: - - ../acl:/etc/redis/acl:ro + - ../../../../../../compose/redis/acl:/etc/redis/acl:ro entrypoint: - /bin/sh - -c diff --git a/infra/redis-sdk/standalone/compose.yml b/src/adapter/outbound/redis-sdk/compose/standalone/compose.yml similarity index 93% rename from infra/redis-sdk/standalone/compose.yml rename to src/adapter/outbound/redis-sdk/compose/standalone/compose.yml index ea8f4be0..5d983bbc 100644 --- a/infra/redis-sdk/standalone/compose.yml +++ b/src/adapter/outbound/redis-sdk/compose/standalone/compose.yml @@ -16,7 +16,7 @@ services: - --aclfile - /etc/redis/acl/lane-fixture-accounts.acl volumes: - - ../acl:/etc/redis/acl:ro + - ../../../../../../compose/redis/acl:/etc/redis/acl:ro ports: - "${REDIS_PORT:-6379}:6379" healthcheck: diff --git a/infra/redis-sdk/tls/compose.yml b/src/adapter/outbound/redis-sdk/compose/tls/compose.yml similarity index 97% rename from infra/redis-sdk/tls/compose.yml rename to src/adapter/outbound/redis-sdk/compose/tls/compose.yml index 218adb92..a679849f 100644 --- a/infra/redis-sdk/tls/compose.yml +++ b/src/adapter/outbound/redis-sdk/compose/tls/compose.yml @@ -38,7 +38,7 @@ services: certs: condition: service_completed_successfully volumes: - - ../acl:/etc/redis/acl:ro + - ../../../../../../compose/redis/acl:/etc/redis/acl:ro - tls:/tls:ro command: - redis-server diff --git a/src/adapter/outbound/redis-sdk/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/RedisTopologyContractTest.java b/src/adapter/outbound/redis-sdk/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/RedisTopologyContractTest.java index 67ee210b..26832b4c 100644 --- a/src/adapter/outbound/redis-sdk/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/RedisTopologyContractTest.java +++ b/src/adapter/outbound/redis-sdk/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/RedisTopologyContractTest.java @@ -29,11 +29,11 @@ import org.junit.jupiter.api.Test; * so selecting it without an endpoint is an error rather than a skip. * *

What lives here is what the in-memory gateway is honest about not proving. The ACL assertions - * below are the first of those: the accounts in {@code infra/redis-sdk/acl} are the last - * enforcement boundary, and whether they actually grant what the command policy catalog says each - * access level may issue is a question only the server answers. Writing this test already found one - * defect — the advanced account granted {@code SMEMBERS} and {@code SORT}, which are {@code - * RAW_ONLY} and belong to the raw gateway account alone. + * below are the first of those: the accounts in {@code compose/redis/acl} are the last enforcement + * boundary, and whether they actually grant what the command policy catalog says each access level + * may issue is a question only the server answers. Writing this test already found one defect — the + * advanced account granted {@code SMEMBERS} and {@code SORT}, which are {@code RAW_ONLY} and belong + * to the raw gateway account alone. */ @Tag("redis-topology") @Tag("lane-standalone") diff --git a/src/app-bootstrap/README.md b/src/app-bootstrap/README.md index 1be5fd00..05ae2ff4 100644 --- a/src/app-bootstrap/README.md +++ b/src/app-bootstrap/README.md @@ -130,7 +130,7 @@ README의 "startup" 절에 있다. - **prod 에서 깨지면 부팅 자체를 거부하는 fail-fast 가드다.** 두 가지 prod 불변식을 context refresh 완료 전에 강제한다. (1) `__LOCAL_DEV_` 접두사를 가진 dev/local 가짜 자격증명 값이 prod 프로파일에 도달하는 것은 잘못 로드된 사고이므로 부팅을 중단시킨다. 비밀값이 `fixture-`로 시작해도 같다. 이 저장소가 - lane용으로 적어 둔 공개 비밀번호(`infra/redis-sdk/acl`의 Redis ACL fixture, compose lane의 + lane용으로 적어 둔 공개 비밀번호(`compose/redis/acl`의 Redis ACL fixture, compose lane의 `REDIS_LANE_*`)라서, lane 환경이나 lane ACL 파일을 베낀 배포가 그대로 운영에 뜨는 것을 막는다 (review 2026-11-03 RR-07-04). 이 검사는 비밀값만 본다 — 레지스트리의 `secret` 행 (`CLASSIFIED_SECRETS`), 모듈이 기여한 비밀, 환경 값에 든 `secret://…/` 참조가 가리키는 변수 diff --git a/src/app-bootstrap/build.gradle b/src/app-bootstrap/build.gradle index e98e280c..6be01ae9 100644 --- a/src/app-bootstrap/build.gradle +++ b/src/app-bootstrap/build.gradle @@ -341,12 +341,14 @@ def repositoryRootForContractTests = rootProject.projectDir.parentFile def repositoryContractExcludes = ['**/build/**', '**/.gradle/**', '**/node_modules/**'] def repositoryContractInputs = files( fileTree(repositoryRootForContractTests) { - include '.github/**', 'infra/**', 'scripts/**', '*.yml', '*.example', '.tool-versions' + include '.github/**', 'compose/**', 'scripts/**', '*.yml', '*.yaml', '*.example', '.tool-versions' exclude '**/*.md' exclude repositoryContractExcludes }, fileTree(rootProject.projectDir) { include 'config/**', '**/*.gradle', 'gradle/*.toml', 'Dockerfile*', '.env*', '**/src/main/**' + // The compose lane fixtures this leaf owns (the lane contract, overlays, smoke clients). + include 'app-bootstrap/compose-lanes/**' exclude '**/*.md' exclude repositoryContractExcludes }) @@ -405,7 +407,7 @@ tasks.named('conditionalTransportBuildContractTest', Test) { } tasks.named('integrationTest', Test) { inputs.files(fileTree(repositoryRootForContractTests) { - include '*.yml', 'infra/**' + include 'compose.yaml', 'compose/**', 'scripts/*compose*.sh', 'src/app-bootstrap/compose-lanes/**' exclude repositoryContractExcludes }).withPathSensitivity(PathSensitivity.RELATIVE).withPropertyName('composeFiles') } @@ -475,7 +477,7 @@ def compositionRuntimeClasspath = { String name -> } // The qualification artifact: this composition with every capability on the classpath. It is what -// the Compose lanes (config/runtime/compose-profile-contracts.json) boot, because a lane that turns +// the Compose lanes (compose-lanes/compose-profile-contracts.json) boot, because a lane that turns // JPA or Kafka on needs the module in the image, and `bootJar` — the default composition a service // ships — carries none of them. It is never released: `release.yml` builds `stageDockerJar`. // Each capability is on while present, so a lane switches off what it is not about. diff --git a/src/config/runtime/compose-profile-contracts.json b/src/app-bootstrap/compose-lanes/compose-profile-contracts.json similarity index 83% rename from src/config/runtime/compose-profile-contracts.json rename to src/app-bootstrap/compose-lanes/compose-profile-contracts.json index a5a000ab..927caecb 100644 --- a/src/config/runtime/compose-profile-contracts.json +++ b/src/app-bootstrap/compose-lanes/compose-profile-contracts.json @@ -1,14 +1,13 @@ { - "$comment": "The lane SSOT. Each row fixes a Compose profile, a file stack, an explicit Spring runtime and the exact set of services that stack must render — exact, not a superset, because a lane that quietly gains a service is a lane whose evidence describes something else. A Compose profile selects services and never implies a Spring profile; the wrapper injects the runtime named here.", + "$comment": "The lane SSOT. Each row fixes the Compose profiles it enables, a file stack, an explicit Spring runtime and the exact set of services that stack must render — exact, not a superset, because a lane that quietly gains a service is a lane whose evidence describes something else. A Compose profile selects services and never implies a Spring profile; the wrapper injects the runtime named here. The base file is the development stack (compose.yaml), whose backing services carry capability profiles (jpa, redis, kafka, mongo, objectstorage, auth, mail); the lane-only services in lane-services.yaml carry their own (schema-streams, smoke-*).", "minimumComposeVersion": "2.24.4", "composeFiles": { - "base": "docker-compose.yml", - "infra": "docker-compose.infra.yml", - "local": "docker-compose.local.yml", - "dev": "docker-compose.dev.yml", - "prod-smoke": "docker-compose.prod-smoke.yml", - "tls": "docker-compose.tls.yml", - "fileserver": "infra/fileserver/compose/docker-compose.fileserver.yml" + "base": "compose.yaml", + "lane": "src/app-bootstrap/compose-lanes/lane-services.yaml", + "dev": "src/app-bootstrap/compose-lanes/dev.yaml", + "prod-smoke": "src/app-bootstrap/compose-lanes/prod-smoke.yaml", + "tls": "src/app-bootstrap/compose-lanes/tls.yaml", + "fileserver": "src/app-bootstrap/compose-lanes/fileserver.yaml" }, "$serviceRoles": "Every service a lane renders plays exactly one of three roles, and the wrapper treats them differently: longRunningServices are the only `up --wait` targets, preStartServices run with `run --rm` before the application starts because it depends on what they do, and oneShotServices run with `run --rm` after it is healthy because they exercise it. The two catalogues below name every service that is not a --wait target anywhere; a one-shot passed to `up --wait` waits forever for a container built to exit.", "preStartServices": [ @@ -27,10 +26,9 @@ "lanes": [ { "id": "off-local", - "composeProfile": null, + "composeProfiles": [], "files": [ - "base", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -47,7 +45,7 @@ }, { "id": "off-dev", - "composeProfile": null, + "composeProfiles": [], "files": [ "base", "dev" @@ -67,7 +65,7 @@ }, { "id": "off-prod", - "composeProfile": null, + "composeProfiles": [], "files": [ "base", "prod-smoke" @@ -87,11 +85,11 @@ }, { "id": "local-jpa", - "composeProfile": "local-jpa", + "composeProfiles": [ + "jpa" + ], "files": [ - "base", - "infra", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -118,11 +116,11 @@ }, { "id": "local-mongo", - "composeProfile": "local-mongo", + "composeProfiles": [ + "mongo" + ], "files": [ - "base", - "infra", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -151,11 +149,11 @@ }, { "id": "local-messaging", - "composeProfile": "local-messaging", + "composeProfiles": [ + "kafka" + ], "files": [ - "base", - "infra", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -181,11 +179,12 @@ }, { "id": "local-messaging-outbox", - "composeProfile": "local-messaging-outbox", + "composeProfiles": [ + "jpa", + "kafka" + ], "files": [ - "base", - "infra", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -221,11 +220,15 @@ }, { "id": "local-notification-ingest", - "composeProfile": "local-notification-ingest", + "composeProfiles": [ + "jpa", + "auth", + "schema-streams", + "smoke-notification" + ], "files": [ "base", - "infra", - "local" + "lane" ], "springRuntime": "local", "services": [ @@ -270,11 +273,16 @@ }, { "id": "local-notification-serving", - "composeProfile": "local-notification-serving", + "composeProfiles": [ + "jpa", + "auth", + "mail", + "schema-streams", + "smoke-notification" + ], "files": [ "base", - "infra", - "local" + "lane" ], "springRuntime": "local", "services": [ @@ -331,11 +339,16 @@ }, { "id": "local-notification-handoff", - "composeProfile": "local-notification-handoff", + "composeProfiles": [ + "jpa", + "auth", + "mail", + "schema-streams", + "smoke-notification" + ], "files": [ "base", - "infra", - "local" + "lane" ], "springRuntime": "local", "services": [ @@ -400,11 +413,14 @@ }, { "id": "local-graphql", - "composeProfile": "local-graphql", + "composeProfiles": [ + "auth", + "smoke-auth", + "smoke-graphql" + ], "files": [ "base", - "infra", - "local" + "lane" ], "springRuntime": "local", "services": [ @@ -433,11 +449,11 @@ }, { "id": "local-redis", - "composeProfile": "local-redis", + "composeProfiles": [ + "redis" + ], "files": [ - "base", - "infra", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -467,11 +483,13 @@ { "id": "local-fileserver", "$comment": "The Fileserver keeps its metadata in PostgreSQL through JPA (FileserverJpaPersistenceConfig needs the entityManagerFactory), so the lane without a database could never start: the application refused at startup and the lane reported an unhealthy container. PostgreSQL, the JPA module, and the fileserver schema stream installed and promoted before the application starts, the way the notification lanes get theirs.", - "composeProfile": "local-fileserver", + "composeProfiles": [ + "jpa", + "schema-streams" + ], "files": [ "base", - "infra", - "local", + "lane", "fileserver" ], "springRuntime": "local", @@ -515,10 +533,9 @@ }, { "id": "local-httpclient", - "composeProfile": "local-httpclient", + "composeProfiles": [], "files": [ - "base", - "local" + "base" ], "springRuntime": "local", "services": [ @@ -546,11 +563,16 @@ }, { "id": "shared-infra-local", - "composeProfile": "shared-infra", + "composeProfiles": [ + "jpa", + "auth", + "objectstorage", + "smoke-auth", + "smoke-objectstorage" + ], "files": [ "base", - "infra", - "local" + "lane" ], "springRuntime": "local", "services": [ @@ -588,10 +610,16 @@ }, { "id": "shared-infra-dev", - "composeProfile": "shared-infra", + "composeProfiles": [ + "jpa", + "auth", + "objectstorage", + "smoke-auth", + "smoke-objectstorage" + ], "files": [ "base", - "infra", + "lane", "dev" ], "springRuntime": "dev", @@ -630,10 +658,16 @@ }, { "id": "prod-smoke", - "composeProfile": "prod-smoke", + "composeProfiles": [ + "jpa", + "auth", + "objectstorage", + "smoke-auth", + "smoke-objectstorage" + ], "files": [ "base", - "infra", + "lane", "prod-smoke", "tls" ], @@ -673,14 +707,26 @@ }, { "id": "all-adapters", - "composeProfile": "all-adapters", + "composeProfiles": [ + "jpa", + "mongo", + "kafka", + "redis", + "auth", + "mail", + "schema-streams", + "smoke-auth", + "smoke-graphql", + "smoke-notification" + ], "files": [ "base", - "infra", - "local", + "lane", "fileserver" ], "springRuntime": "local", + "$memoryComment": "Every capability on at once does not fit the 512m the development stack gives the application: the JVM sized its heap to 75% of the limit and the rest (metaspace for every module, code cache, threads) took the container past it, so the kernel killed it and restart: unless-stopped hid the kill whenever it missed the smoke requests (integration-r9, 2026-11-07). The lane raises the limit for itself; the wrapper writes it into the generated overlay and fails a lane whose containers restarted.", + "appMemoryLimit": "1g", "services": [ "app", "auth-smoke", @@ -795,6 +841,6 @@ "redis" ], "$vendorComment": "expectedPersistenceVendor is the vendor the application must report, not the one the lane started: info.capabilities.persistence-jpa.vendor while JPA is on, none while it is off. A reported postgresql is the database the queries go to, because the JPA module refuses to start when the selected vendor is postgresql and the datasource it reaches is not PostgreSQL (JpaDataSourceProfileValidator). local-jpa passed for a while against H2 while a PostgreSQL container it never touched sat beside it, because application-local.yml pins an in-memory URL that outranks the lane's environment.", - "$redisComment": "The lanes that switch Redis on authenticate the way a deployment does. Their Redis loads infra/redis-sdk/acl/lane-fixture-accounts.acl, which turns the passwordless default user off, and the application connects as the two named accounts that file provisions: ca-skeleton-application for ordinary commands and ca-skeleton-application-advanced for registered scripts. Both references use the secret://@environment/ form; without the account part the client authenticates as the disabled default user. The two REDIS_LANE_* values are that file's fixture passwords (infra/redis-sdk/acl/README.md), not deployment credentials, and deliberately carry no APP_ prefix: they are not application settings, only what these references point at. APP_REDIS_NAMESPACE_ENVIRONMENT is prod because the fixture accounts are fenced to ~prod:*, the namespace every other test against that file uses; under the default local namespace the first key a capability wrote would be refused with NOPERM after startup had reported healthy. Before this the lanes declared anonymous-access-accepted against an open Redis, and the two startup warnings that trade prints (no credential, no advanced account) failed their startup-is-silent check — which is right, because in production both are risks. scripts/verify-compose-profile-contracts.sh check 7 holds a Redis lane's references, passwords and namespace to the account lines of the file its Redis actually mounts.", + "$redisComment": "The lanes that switch Redis on authenticate the way a deployment does. Their Redis loads compose/redis/acl/lane-fixture-accounts.acl, which turns the passwordless default user off, and the application connects as the two named accounts that file provisions: ca-skeleton-application for ordinary commands and ca-skeleton-application-advanced for registered scripts. Both references use the secret://@environment/ form; without the account part the client authenticates as the disabled default user. The two REDIS_LANE_* values are that file's fixture passwords (compose/redis/acl/README.md), not deployment credentials, and deliberately carry no APP_ prefix: they are not application settings, only what these references point at. APP_REDIS_NAMESPACE_ENVIRONMENT is prod because the fixture accounts are fenced to ~prod:*, the namespace every other test against that file uses; under the default local namespace the first key a capability wrote would be refused with NOPERM after startup had reported healthy. Before this the lanes declared anonymous-access-accepted against an open Redis, and the two startup warnings that trade prints (no credential, no advanced account) failed their startup-is-silent check — which is right, because in production both are risks. scripts/verify-compose-profile-contracts.sh check 7 holds a Redis lane's references, passwords and namespace to the account lines of the file its Redis actually mounts.", "$flywayComment": "SPRING_FLYWAY_LOCATIONS is deliberately absent. Seven lanes listed every capability stream there, and it could never have worked: the db/migration/jpa/* streams each declare a V1, so one Flyway instance over all of them fails with 'Found more than one migration with version 1'. Each stream is its own stream with its own history table by design. The setting was inert until Wave 2 stopped PostgreSqlPersistenceConfig from overriding spring.flyway.locations, and the lanes passed while their own configuration was being discarded. Applying a capability stream needs a Flyway execution per stream — the operator sequence PostgreSqlNotificationPersistenceUnitIntegrationTest and FileserverRoundTripContractTest both perform in their fixtures — and that is what the notification lanes still need." } diff --git a/docker-compose.dev.yml b/src/app-bootstrap/compose-lanes/dev.yaml similarity index 90% rename from docker-compose.dev.yml rename to src/app-bootstrap/compose-lanes/dev.yaml index b81721bb..38456b5c 100644 --- a/docker-compose.dev.yml +++ b/src/app-bootstrap/compose-lanes/dev.yaml @@ -1,8 +1,11 @@ # ============================================================================= # feature-container-runtime-contract — dev environment override # -# Merge with base: -# docker compose -f docker-compose.yml -f docker-compose.dev.yml up +# The off-dev and shared-infra-dev compose lanes merge it onto the development stack: +# docker compose -f compose.yaml -f src/app-bootstrap/compose-lanes/dev.yaml up +# +# It checks that the `dev` deployment profile boots; it is not the development environment, which +# is compose.yaml alone. # # Dev intent: # - Relaxes read-only filesystem (writable, no tmpfs constraint) so developers @@ -35,7 +38,7 @@ services: # environment the application believes it is in, and the two drifting is how a dev stack ends # up running local's settings. SPRING_PROFILES_ACTIVE: "dev" - # The datasource address, owned here like the local and prod-smoke overlays own theirs. It was + # The datasource address, owned here like compose.yaml and the prod-smoke overlay own theirs. It was # the only one of the three missing, and the gap was invisible while the qualification wrapper # supplied a URL to every lane: the dev stack ran on a value that came from the test harness # rather than from the file that describes the dev environment. With the wrapper no longer @@ -86,7 +89,7 @@ services: target: /var/tmp/heap bind: create_host_path: true - # The same network the shared infrastructure lives on. The local overlay joins it and the dev + # The same network the shared infrastructure lives on. The local stack (now compose.yaml) joins it and the dev # overlay did not, so a dev lane that started PostgreSQL beside the application put the two on # different networks: `UnknownHostException: db`, from a container that was running and healthy # a metre away. Compose puts a service with no `networks:` on `default`, which is a network of @@ -96,6 +99,6 @@ services: - caskeleton-infra networks: - # Defined in docker-compose.infra.yml, where the services that share it live. + # Defined in compose.yaml, where the services that share it live. caskeleton-infra: external: false diff --git a/infra/fileserver/compose/docker-compose.fileserver.yml b/src/app-bootstrap/compose-lanes/fileserver.yaml similarity index 86% rename from infra/fileserver/compose/docker-compose.fileserver.yml rename to src/app-bootstrap/compose-lanes/fileserver.yaml index 6018ad74..650b6708 100644 --- a/infra/fileserver/compose/docker-compose.fileserver.yml +++ b/src/app-bootstrap/compose-lanes/fileserver.yaml @@ -3,14 +3,13 @@ # # Usage, on top of a stack whose image carries the fileserver module (a service that selected # `:composition:fileserver-platform`, or COMPOSITION=qualification): -# docker compose -f docker-compose.yml -f docker-compose.local.yml \ -# -f infra/fileserver/compose/docker-compose.fileserver.yml up +# docker compose -f compose.yaml -f src/app-bootstrap/compose-lanes/fileserver.yaml up # # Why a file of its own (review 2026-11-01 07-08, capability criterion 7): the default image and -# docker-compose.yml carry no fileserver, so they no longer carry its volume either. Before, every +# compose.yaml carry no fileserver, so they no longer carry its volume either. Before, every # container — default composition included — mounted a volume for a module it did not have, and the -# image declared it a VOLUME. It sits with the rest of the capability's infrastructure -# (infra/fileserver), so removing the capability removes it with that directory. +# image declared it a VOLUME. It is a compose lane fixture (the lanes local-fileserver and +# all-adapters add it); a service that selects the capability adds the same volume to its own stack. # # The volume is a named volume, not a tmpfs and not the read-only root: published content must # outlive the container that wrote it. Back it with real storage in any deployment that keeps files. diff --git a/src/app-bootstrap/compose-lanes/lane-services.yaml b/src/app-bootstrap/compose-lanes/lane-services.yaml new file mode 100644 index 00000000..1c4ba2e2 --- /dev/null +++ b/src/app-bootstrap/compose-lanes/lane-services.yaml @@ -0,0 +1,245 @@ +# ============================================================================= +# compose lane 전용 서비스 — 개발 환경(저장소 루트 compose.yaml)에는 없다. +# +# 스키마 적용 one-shot 둘과 smoke client 넷이다. 모두 profile이 있어서 lane이 그 profile을 댈 때만 뜬다. +# 어느 lane이 무엇을 쓰는지는 compose-profile-contracts.json이 정한다. 이 파일은 compose.yaml 뒤에 +# -f로 합쳐지므로 경로는 저장소 루트 기준이다. +# +# profile 서비스 +# schema-streams db-migrate-capabilities, db-promote-capabilities +# smoke-auth auth-smoke +# smoke-graphql graphql-smoke +# smoke-objectstorage object-storage-smoke +# smoke-notification notification-smoke +# ============================================================================= + +# The object storage smoke client runs the MinIO server image (see below). YAML anchors do not cross +# files, so this is a second copy of compose.yaml's default; ComposeMinioImageMatchesEvidenceTest +# holds both to the measured evidence digest. +x-local-minio-image: &local-minio-image "${LOCAL_MINIO_IMAGE:-pgsty/minio@sha256:b6bfe7239bfc83fb90d31612d9704d86039dd714f7904b3f1ad68f211e602372}" + +services: + # ---- Capability schema streams ------------------------------------------------ + # Two pre-start one-shots, in this order, because a capability stream is an operator sequence + # rather than a property. + # + # Install: each stream under db/migration/jpa keeps its own Flyway history table — they all declare + # a V1, so one Flyway pointed at all of them fails outright — and each registers itself + # INSTALLED_INACTIVE. + # + # Promote: an operator sanctions the installed schema, and the application refuses to start until + # that has happened. That is the fail-closed half of the same design, so it cannot be folded into + # the install step without making "the tables exist" and "this is sanctioned" the same event. + # + # They are also two images because they must be: flyway/flyway ships no psql, so the promotion + # could not have run in the migration container at all. + # + # Both run before `up`, not with the smoke clients after it — the application is what they are a + # precondition for. The lane contract's preStartServices carries that ordering. + db-migrate-capabilities: + profiles: + - schema-streams + image: flyway/flyway:11.1.0 + depends_on: + db: + condition: service_healthy + entrypoint: ["/bin/sh", "/opt/capability-streams/apply-capability-streams.sh"] + environment: + PGHOST: "db" + PGUSER: "${APP_DATASOURCE_USERNAME:-ca_skeleton}" + PGPASSWORD: "${APP_DATASOURCE_PASSWORD:-ca_skeleton}" + PGDATABASE: "${POSTGRES_DB:-ca_skeleton}" + CAPABILITY_STREAMS: "${CAPABILITY_STREAMS:-}" + volumes: + - type: bind + source: ./src/app-bootstrap/compose-lanes/postgres/apply-capability-streams.sh + target: /opt/capability-streams/apply-capability-streams.sh + read_only: true + - type: bind + source: ./src/adapter/outbound/persistence-jpa/src/main/resources/db/migration + target: /flyway/sql + read_only: true + - type: bind + source: ./src/adapter/outbound/persistence-notification/src/main/resources/db/migration/jpa/notification-platform + target: /flyway/streams/notification-platform + read_only: true + - type: bind + source: ./src/adapter/outbound/persistence-fileserver/src/main/resources/db/migration/jpa/fileserver + target: /flyway/streams/fileserver + read_only: true + networks: + - caskeleton-infra + restart: "no" + + db-promote-capabilities: + profiles: + - schema-streams + image: postgres:16-alpine + depends_on: + db: + condition: service_healthy + entrypoint: ["/bin/sh", "/opt/capability-streams/promote-capability-streams.sh"] + environment: + PGHOST: "db" + PGUSER: "${APP_DATASOURCE_USERNAME:-ca_skeleton}" + PGPASSWORD: "${APP_DATASOURCE_PASSWORD:-ca_skeleton}" + PGDATABASE: "${POSTGRES_DB:-ca_skeleton}" + CAPABILITY_STREAMS: "${CAPABILITY_STREAMS:-}" + volumes: + - type: bind + source: ./src/app-bootstrap/compose-lanes/postgres/promote-capability-streams.sh + target: /opt/capability-streams/promote-capability-streams.sh + read_only: true + networks: + - caskeleton-infra + restart: "no" + + # ---- One-shot smoke clients -------------------------------------------------- + # Never `up --wait` targets. Each is run with `run --rm` and must exit zero; a missing, skipped or + # non-zero one fails its lane rather than being treated as "not applicable". + graphql-smoke: + profiles: + - smoke-graphql + image: curlimages/curl:8.10.1 + depends_on: + keycloak: + condition: service_healthy + # uid 0 for the mounted 0600 client secret, same as auth-smoke. + user: "0:0" + entrypoint: ["/bin/sh", "/opt/smoke/graphql-smoke.sh"] + environment: + APP_BASE_URL: "http://app:8080" + KEYCLOAK_ISSUER: "http://keycloak:8080/realms/ca-skeleton" + KEYCLOAK_CLIENT_ID: "ca-skeleton-api" + # Spring for GraphQL serves its own endpoint through a router function rather than an + # annotated controller, so the presentation base-path prefix does not apply to it. + GRAPHQL_PATH: "${GRAPHQL_PATH:-/graphql}" + volumes: + - type: bind + source: ./src/app-bootstrap/compose-lanes/smoke + target: /opt/smoke + read_only: true + secrets: + - keycloak-graphql-smoke-client-secret + networks: + - caskeleton-infra + restart: "no" + + auth-smoke: + profiles: + - smoke-auth + image: curlimages/curl:8.10.1 + depends_on: + keycloak: + condition: service_healthy + # The client secret is written on the host at mode 0600 by the qualification wrapper and mounted + # in. The Keycloak image happens to run as the same uid the wrapper writes as; this image runs as + # uid 100, so it read "Permission denied" and the lane failed on the smoke client rather than on + # anything it was checking. Compose ignores the secret's uid/gid/mode options outside swarm, so + # the container reads it as root instead. The two alternatives are both worse: loosening the host + # file to world-readable leaves a credential readable by every process on the machine, and passing + # the value as an environment variable puts it in `docker compose config` output and in ps. + user: "0:0" + entrypoint: ["/bin/sh", "/opt/smoke/auth-smoke.sh"] + environment: + # The same issuer URL the application is given. A token obtained from one URL and validated + # against another proves nothing, and localhost means a different host inside each container. + KEYCLOAK_ISSUER: "http://keycloak:8080/realms/ca-skeleton" + KEYCLOAK_CLIENT_ID: "ca-skeleton-api" + APP_BASE_URL: "http://app:8080" + # Supplied per runtime, because the same endpoint has two addresses: application-local.yml + # pins presentation.api-base-path to /api and the shipped default is /v1. The qualification + # wrapper exports the value that matches the lane's Spring runtime. + APP_HEALTH_PATH: "${APP_HEALTH_PATH:-/v1/healthcheck}" + volumes: + - type: bind + source: ./src/app-bootstrap/compose-lanes/smoke + target: /opt/smoke + read_only: true + secrets: + - keycloak-graphql-smoke-client-secret + networks: + - caskeleton-infra + restart: "no" + + # The server image, not the mc client image: the mc image ships no sed, grep or cmp, and the round-trip + # client needs a digest tool. See smoke/object-storage-smoke.sh for how that went unnoticed. The + # lane already pulls this image for the server itself. + object-storage-smoke: + profiles: + - smoke-objectstorage + image: *local-minio-image + depends_on: + minio-init: + condition: service_completed_successfully + entrypoint: ["/bin/sh", "/opt/smoke/object-storage-smoke.sh"] + environment: + MINIO_ENDPOINT: "http://minio:9000" + MINIO_ROOT_USER: "${MINIO_ROOT_USER:-caskeleton}" + MINIO_ROOT_PASSWORD: "${MINIO_ROOT_PASSWORD:-caskeleton-local}" + MINIO_BUCKET: "${MINIO_BUCKET:-ca-skeleton-objects}" + volumes: + - type: bind + source: ./src/app-bootstrap/compose-lanes/smoke + target: /opt/smoke + read_only: true + networks: + - caskeleton-infra + restart: "no" + + notification-smoke: + profiles: + - smoke-notification + image: curlimages/curl:8.10.1 + depends_on: + keycloak: + condition: service_healthy + # uid 0 for the same reason auth-smoke uses it: the mounted client secret is mode 0600 on the + # host and this image otherwise runs as uid 100, which reads "Permission denied". The lane then + # fails on the smoke client rather than on anything it was checking. + user: "0:0" + entrypoint: ["/bin/sh", "/opt/smoke/notification-smoke.sh"] + environment: + APP_BASE_URL: "http://app:8080" + MAILPIT_BASE_URL: "http://mailpit:8025" + # ingest | serving | handoff-verify — which phase of the lane this invocation is. + # + # No default, deliberately. It defaulted to `ingest`, and local-notification-serving therefore + # ran the ingest assertions — "accepted, and nothing was delivered" — against an application in + # SERVING mode. The lane passed while testing the opposite of what it is named for, and would + # have kept passing for as long as the check happened to run before the dispatch worker. An + # unset value now renders empty and the client refuses it. + # `:-` and not a value: an explicit empty default keeps Compose from warning about an unset + # variable on every lane that never runs this client, while still rendering empty so the + # client refuses it. + NOTIFICATION_SMOKE_PHASE: "${NOTIFICATION_SMOKE_PHASE:-}" + APP_BASE_PATH: "${APP_BASE_PATH:-/api}" + # Submission and template publication are authenticated like every other non-public path, so + # this client obtains a token the same way auth-smoke does — client credentials against the + # same issuer URL the application validates against. + KEYCLOAK_ISSUER: "http://keycloak:8080/realms/ca-skeleton" + KEYCLOAK_CLIENT_ID: "ca-skeleton-api" + volumes: + - type: bind + source: ./src/app-bootstrap/compose-lanes/smoke + target: /opt/smoke + read_only: true + # The handoff lane runs this client twice in one project and the second run needs the request + # id the first accepted, so the state lives in a named volume that outlives a `run --rm` + # container and is removed with the project by the teardown's --volumes. + # + # Its own path, not a subdirectory of the script mount above: a volume nested inside a + # read-only bind cannot be created, because the runtime has to mkdir the mountpoint in a + # filesystem it was just told is read-only. + - type: volume + source: caskeleton-notification-smoke-state + target: /opt/notification-smoke-state + secrets: + - keycloak-graphql-smoke-client-secret + networks: + - caskeleton-infra + restart: "no" + +volumes: + caskeleton-notification-smoke-state: + driver: local diff --git a/infra/postgres/apply-capability-streams.sh b/src/app-bootstrap/compose-lanes/postgres/apply-capability-streams.sh similarity index 97% rename from infra/postgres/apply-capability-streams.sh rename to src/app-bootstrap/compose-lanes/postgres/apply-capability-streams.sh index 79acdbdc..675977d2 100755 --- a/infra/postgres/apply-capability-streams.sh +++ b/src/app-bootstrap/compose-lanes/postgres/apply-capability-streams.sh @@ -22,7 +22,7 @@ # # Each stream registers itself INSTALLED_INACTIVE. Nothing here promotes anything — a table existing # is not the same as a capability being sanctioned to use it, and this image has no psql to blur the -# two with even if that were wanted. infra/postgres/promote-capability-streams.sh is the operator +# two with even if that were wanted. promote-capability-streams.sh is the operator # half, and NotificationSchemaActivation refusing startup until it has run is the fail-closed third. # # CAPABILITY_STREAMS is a space-separated list of stream names (the directory names under diff --git a/infra/postgres/entrypoint.sh b/src/app-bootstrap/compose-lanes/postgres/entrypoint.sh similarity index 100% rename from infra/postgres/entrypoint.sh rename to src/app-bootstrap/compose-lanes/postgres/entrypoint.sh diff --git a/infra/postgres/promote-capability-streams.sh b/src/app-bootstrap/compose-lanes/postgres/promote-capability-streams.sh similarity index 100% rename from infra/postgres/promote-capability-streams.sh rename to src/app-bootstrap/compose-lanes/postgres/promote-capability-streams.sh diff --git a/infra/postgres/tls/.gitignore b/src/app-bootstrap/compose-lanes/postgres/tls/.gitignore similarity index 100% rename from infra/postgres/tls/.gitignore rename to src/app-bootstrap/compose-lanes/postgres/tls/.gitignore diff --git a/docker-compose.prod-smoke.yml b/src/app-bootstrap/compose-lanes/prod-smoke.yaml similarity index 100% rename from docker-compose.prod-smoke.yml rename to src/app-bootstrap/compose-lanes/prod-smoke.yaml diff --git a/infra/keycloak/smoke/auth-smoke.sh b/src/app-bootstrap/compose-lanes/smoke/auth-smoke.sh similarity index 100% rename from infra/keycloak/smoke/auth-smoke.sh rename to src/app-bootstrap/compose-lanes/smoke/auth-smoke.sh diff --git a/infra/graphql/smoke/graphql-smoke.sh b/src/app-bootstrap/compose-lanes/smoke/graphql-smoke.sh similarity index 100% rename from infra/graphql/smoke/graphql-smoke.sh rename to src/app-bootstrap/compose-lanes/smoke/graphql-smoke.sh diff --git a/infra/notification/smoke/notification-smoke.sh b/src/app-bootstrap/compose-lanes/smoke/notification-smoke.sh similarity index 100% rename from infra/notification/smoke/notification-smoke.sh rename to src/app-bootstrap/compose-lanes/smoke/notification-smoke.sh diff --git a/infra/minio/smoke/object-storage-smoke.sh b/src/app-bootstrap/compose-lanes/smoke/object-storage-smoke.sh similarity index 100% rename from infra/minio/smoke/object-storage-smoke.sh rename to src/app-bootstrap/compose-lanes/smoke/object-storage-smoke.sh diff --git a/docker-compose.tls.yml b/src/app-bootstrap/compose-lanes/tls.yaml similarity index 85% rename from docker-compose.tls.yml rename to src/app-bootstrap/compose-lanes/tls.yaml index 0868be92..de7879c9 100644 --- a/docker-compose.tls.yml +++ b/src/app-bootstrap/compose-lanes/tls.yaml @@ -8,7 +8,7 @@ # # So the lane brings a real certificate instead. The qualification wrapper generates a CA and a # server certificate for the host name `db` per run, at mode 0600, and removes both on teardown; the -# realm-secret pattern, applied to a keypair. Nothing here is committed: infra/postgres/tls holds +# realm-secret pattern, applied to a keypair. Nothing here is committed: compose-lanes/postgres/tls holds # only a .gitignore. # # `verify-full` is deliberate rather than `verify-ca`. `verify-ca` proves the certificate was issued @@ -19,7 +19,7 @@ services: db: # Runs as root just long enough to install the key where postgres can read it, then hands over - # to the official entrypoint. See infra/postgres/entrypoint.sh for why a bind mount cannot do it. + # to the official entrypoint. See compose-lanes/postgres/entrypoint.sh for why a bind mount cannot do it. entrypoint: ["/bin/sh", "/opt/postgres-entrypoint/entrypoint.sh"] command: - "postgres" @@ -31,11 +31,11 @@ services: - "ssl_key_file=/etc/postgresql-tls/server.key" volumes: - type: bind - source: ./infra/postgres/entrypoint.sh + source: ./src/app-bootstrap/compose-lanes/postgres/entrypoint.sh target: /opt/postgres-entrypoint/entrypoint.sh read_only: true - type: bind - source: ./infra/postgres/tls + source: ./src/app-bootstrap/compose-lanes/postgres/tls target: /opt/postgres-tls read_only: true @@ -47,4 +47,4 @@ services: secrets: postgres-ca: - file: ./infra/postgres/tls/ca.crt + file: ./src/app-bootstrap/compose-lanes/postgres/tls/ca.crt diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/compose/ComposeMergeCharacterizationTest.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/compose/ComposeMergeCharacterizationTest.java index 59751f90..2091cfa5 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/compose/ComposeMergeCharacterizationTest.java +++ b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/compose/ComposeMergeCharacterizationTest.java @@ -27,21 +27,15 @@ class ComposeMergeCharacterizationTest { private static final Path REPOSITORY_ROOT = repositoryRoot(); @Test - @DisplayName("the base stack renders") - void baseStackRenders() { - assertStackRenders("docker-compose.yml"); + @DisplayName("the development stack renders") + void developmentStackRenders() { + assertStackRenders("compose.yaml"); } @Test - @DisplayName("the local stack renders") - void localStackRenders() { - assertStackRenders("docker-compose.yml", "docker-compose.local.yml"); - } - - @Test - @DisplayName("the dev stack renders") + @DisplayName("the dev lane stack renders") void devStackRenders() { - assertStackRenders("docker-compose.yml", "docker-compose.dev.yml"); + assertStackRenders("compose.yaml", "src/app-bootstrap/compose-lanes/dev.yaml"); } /** @@ -112,7 +106,7 @@ class ComposeMergeCharacterizationTest { private static Path repositoryRoot() { Path candidate = Path.of("").toAbsolutePath(); - while (candidate != null && !Files.isRegularFile(candidate.resolve("docker-compose.yml"))) { + while (candidate != null && !Files.isRegularFile(candidate.resolve("compose.yaml"))) { candidate = candidate.getParent(); } if (candidate == null) { diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/async/AsyncExecutorConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/async/AsyncExecutorConfig.java index cfe6ec07..3c725869 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/async/AsyncExecutorConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/async/AsyncExecutorConfig.java @@ -27,8 +27,8 @@ public class AsyncExecutorConfig { * How long close waits for queued async work. It is spent after the web server's graceful drain * ({@code spring.lifecycle.timeout-per-shutdown-phase}, 30s) has finished, because Spring stops * lifecycle beans before it destroys this executor — so the two add up. The container grace in - * the root {@code docker-compose.yml} is sized to that sum; {@code - * DeveloperExperienceContractTest} fails when it is not (07-07). + * the root {@code compose.yaml} is sized to that sum; {@code DeveloperExperienceContractTest} + * fails when it is not (07-07). */ public static final int AWAIT_TERMINATION_SECONDS = 19; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidator.java index b7303d11..e51191f1 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidator.java @@ -36,13 +36,13 @@ public final class SecretSourceValidator implements StartupRule { /** * Prefix of the passwords this repository writes down for its lanes: the Redis ACL fixtures in - * {@code infra/redis-sdk/acl} and the Compose lanes' {@code REDIS_LANE_*} values that connect - * with them. They are public — anyone who can read the repository has them — so under {@code - * prod} a secret holding one is refused (review 2026-11-03 RR-07-04). A deployment that copied a - * lane's environment — which is also what an application needs to authenticate against a Redis - * that loaded the lane ACL file — would start with credentials it does not own. It cannot see a - * Redis server that loaded that file while the application uses real passwords; the ACL README - * says why no deployment loads it. + * {@code compose/redis/acl} and the Compose lanes' {@code REDIS_LANE_*} values that connect with + * them. They are public — anyone who can read the repository has them — so under {@code prod} a + * secret holding one is refused (review 2026-11-03 RR-07-04). A deployment that copied a lane's + * environment — which is also what an application needs to authenticate against a Redis that + * loaded the lane ACL file — would start with credentials it does not own. It cannot see a Redis + * server that loaded that file while the application uses real passwords; the ACL README says why + * no deployment loads it. * *

Only secrets are read for it (review 2026-11-04 RR2-04-01, owner decision): {@code fixture-} * is an ordinary word before it is this repository's password prefix, and a pod named after a @@ -202,7 +202,7 @@ public final class SecretSourceValidator implements StartupRule { + secret + " holds a lane fixture password ('" + REPOSITORY_FIXTURE_PREFIX - + "…', public in infra/redis-sdk/acl)")); + + "…', public in compose/redis/acl)")); } } diff --git a/src/app-bootstrap/src/main/resources/config/observability.yml b/src/app-bootstrap/src/main/resources/config/observability.yml index 6aedc565..06babdfb 100644 --- a/src/app-bootstrap/src/main/resources/config/observability.yml +++ b/src/app-bootstrap/src/main/resources/config/observability.yml @@ -92,7 +92,7 @@ management: enabled: true # The `info.*` tree only, not the environment: each capability module ships an # info.capabilities. entry beside its switch, and the Compose smoke lanes read it to check - # which capabilities the application actually turned on (compose-profile-contracts.json). + # which capabilities the application actually turned on (compose-lanes/compose-profile-contracts.json). env: enabled: true diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/CapabilityStorageOverlayContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/CapabilityStorageOverlayContractTest.java index 62d45bdd..6ed29094 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/CapabilityStorageOverlayContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/CapabilityStorageOverlayContractTest.java @@ -24,14 +24,13 @@ import org.yaml.snakeyaml.constructor.SafeConstructor; * criterion 7: the only place that knows a module is the module). * *

The default image used to create the fileserver storage directory and declare it a {@code - * VOLUME}, and {@code docker-compose.yml} mounted a {@code fileserver-data} volume into every - * container — in a composition that has no fileserver module at all. A reader took the volume as a - * sign the capability was on, and every plain {@code docker run} created an anonymous volume nobody - * wrote to. The volume now lives in {@code infra/fileserver/compose/docker-compose.fileserver.yml}, - * beside the rest of the capability's infrastructure, which a lane or a developer adds with the - * capability. Its ownership is set by a one-shot that runs as root in the application's own image, - * so a fresh volume, a reused one and a bind mount all end up owned by the account the application - * runs as. + * VOLUME}, and the root Compose file mounted a {@code fileserver-data} volume into every container + * — in a composition that has no fileserver module at all. A reader took the volume as a sign the + * capability was on, and every plain {@code docker run} created an anonymous volume nobody wrote + * to. The volume now lives in {@code src/app-bootstrap/compose-lanes/fileserver.yaml}, an overlay a + * lane (or a service that selects the capability) adds with the capability. Its ownership is set by + * a one-shot that runs as root in the application's own image, so a fresh volume, a reused one and + * a bind mount all end up owned by the account the application runs as. */ @Tag("repository-contract") class CapabilityStorageOverlayContractTest { @@ -39,7 +38,9 @@ class CapabilityStorageOverlayContractTest { private static final Path REPOSITORY_ROOT = RepositoryContractResources.fromSystemProperty().repositoryRoot(); - private static final String OVERLAY = "infra/fileserver/compose/docker-compose.fileserver.yml"; + private static final String OVERLAY = "src/app-bootstrap/compose-lanes/fileserver.yaml"; + private static final String CONTRACTS = + "src/app-bootstrap/compose-lanes/compose-profile-contracts.json"; private static final String OVERLAY_KEY = "fileserver"; private static final String STORAGE_INIT = "fileserver-storage-init"; private static final String STORAGE_ROOT = "/var/lib/backend/files"; @@ -53,7 +54,7 @@ class CapabilityStorageOverlayContractTest { @DisplayName("기본 Dockerfile과 기본 compose는 선택 capability 이름을 담지 않는다") void theDefaultImageAndComposeNameNoOptionalCapability() throws IOException { // given - List defaultContainerFiles = List.of("src/Dockerfile", "docker-compose.yml"); + List defaultContainerFiles = List.of("src/Dockerfile", "compose.yaml"); // when List mentions = new ArrayList<>(); @@ -116,7 +117,7 @@ class CapabilityStorageOverlayContractTest { void theFileserverVolumeIsHandedToTheApplicationAccountBeforeTheApplicationStarts() throws IOException { // given - Map base = yaml(read("docker-compose.yml")); + Map base = yaml(read("compose.yaml")); Map overlay = yaml(read(OVERLAY)); // when @@ -144,7 +145,7 @@ class CapabilityStorageOverlayContractTest { @DisplayName("fileserver를 켜는 lane만, 그리고 모두 fileserver overlay와 소유권 one-shot을 쓴다") void exactlyTheLanesThatSwitchTheFileserverOnBringItsOverlay() throws IOException { // given - Map contracts = yaml(read("src/config/runtime/compose-profile-contracts.json")); + Map contracts = yaml(read(CONTRACTS)); // when List mismatched = new ArrayList<>(); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java index 1d1fa39d..02a31d7d 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java @@ -72,14 +72,18 @@ class DeveloperExperienceContractTest { @Test @Tag("repository-contract") void localComposeSupportsDatabaseMigrationAndPublicHealthSmoke() throws IOException { - String base = read("docker-compose.yml"); - String local = read("docker-compose.local.yml"); + String compose = read("compose.yaml"); - assertThat(base).contains("RELEASE_VERSION:").contains("GIT_SHA:").contains("SOURCE_URL:"); - assertThat(local) + assertThat(compose) + .contains("RELEASE_VERSION:") + .contains("GIT_SHA:") + .contains("SOURCE_URL:") .contains("env_file:") .contains("./src/.env") .doesNotContain("5432:5432") + .contains("http://localhost:9001/actuator/health/readiness"); + assertThat(read("scripts/bootstrap-local.sh")) + .contains("compose.yaml") .contains("http://localhost:8080/api/healthcheck"); } @@ -88,10 +92,9 @@ class DeveloperExperienceContractTest { * database the compose stack keeps on its internal network only is unreachable from there, and * every host-side run dies in the startup migration phase with a connection refusal. * - *

The service moved to docker-compose.infra.yml when infrastructure stopped being spread - * across environment overlays, and it now carries Compose profiles — so starting it means naming - * one (`--profile local-jpa`) rather than getting it for free with the local overlay. The port - * contract this asserts is unchanged; only the file that owns it is. + *

The service lives in the development stack, compose.yaml, under the capability profile + * {@code jpa}: starting it means naming the profile or the service. The port contract this + * asserts is unchanged; only the file that owns it is. */ @Test @Tag("repository-contract") @@ -108,16 +111,16 @@ class DeveloperExperienceContractTest { .as("the committed datasource default is host-side, so it must resolve to the loopback") .isIn("localhost", "127.0.0.1"); - Map infra = parseYamlMap(read("docker-compose.infra.yml")); - Map database = requireMap(requireMap(infra, "services"), "db"); + Map compose = parseYamlMap(read("compose.yaml")); + Map database = requireMap(requireMap(compose, "services"), "db"); assertThat(requireStringList(database, "ports")) .as("a host-side run cannot reach a database the compose stack never publishes") .contains("127.0.0.1:" + hostPort + ":5432"); assertThat(requireStringList(database, "profiles")) .as( - "the service is profiled, so a developer starts it by naming a lane; without this the " - + "port assertion above would pass for a service no lane ever brings up") - .contains("local-jpa"); + "the service is profiled, so a developer starts it by naming the profile; without this " + + "the port assertion above would pass for a service nothing ever brings up") + .contains("jpa"); } @Test @@ -388,8 +391,7 @@ class DeveloperExperienceContractTest { @DisplayName("compose 종료 유예 시간은 웹 drain, async 대기, preStop, 여유를 모두 더한 값 이상이다") void theComposeStopGraceCoversEveryShutdownWaitInSequence() throws IOException { // given - Map app = - requireMap(requireMap(parseYamlMap(read("docker-compose.yml")), "services"), "app"); + Map app = requireMap(requireMap(parseYamlMap(read("compose.yaml")), "services"), "app"); // The web drain is the value this service runs with — APP_SERVER_SHUTDOWN_TIMEOUT's fallback in // the same Compose service — not a number copied here, so a changed default changes the sum // (review 2026-11-03 RR-06-08). @@ -420,7 +422,10 @@ class DeveloperExperienceContractTest { void composePublishesTheManagementPortOnLoopbackOnly() throws IOException { // given List composeFiles = - List.of("docker-compose.yml", "docker-compose.dev.yml", "docker-compose.local.yml"); + List.of( + "compose.yaml", + "src/app-bootstrap/compose-lanes/dev.yaml", + "src/app-bootstrap/compose-lanes/prod-smoke.yaml"); // when List exposed = diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/graphql/GraphQlResolverReachabilityTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/graphql/GraphQlResolverReachabilityTest.java index d1f2468c..3b4b7159 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/graphql/GraphQlResolverReachabilityTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/graphql/GraphQlResolverReachabilityTest.java @@ -54,7 +54,7 @@ class GraphQlResolverReachabilityTest { @Test @DisplayName("the lane sends an authenticated query and inspects the body, not the status") void theLaneProvesTheRequestPath() { - Path smoke = repositoryRoot().resolve("infra/graphql/smoke/graphql-smoke.sh"); + Path smoke = repositoryRoot().resolve("src/app-bootstrap/compose-lanes/smoke/graphql-smoke.sh"); assertThat(Files.exists(smoke)) .as("without a request against /graphql, the resolver gap is invisible to every gate") diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidatorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidatorTest.java index db81d0a3..0e6bd225 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidatorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceValidatorTest.java @@ -116,7 +116,7 @@ class SecretSourceValidatorTest { .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) .withPropertyValues(allRequiredSecretsPresent()) // The Compose Redis lanes' shape: a credential reference, and the variable it names - // holding a public password from infra/redis-sdk/acl. A deployment that copied the + // holding a public password from compose/redis/acl. A deployment that copied the // lane's environment would carry both into production. .withPropertyValues( "APP_REDIS_AUTHENTICATION_CREDENTIAL_REFERENCE=" diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/config/ConfigContractPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/config/ConfigContractPlugin.java index bf045466..62b0d5fe 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/config/ConfigContractPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/config/ConfigContractPlugin.java @@ -42,7 +42,8 @@ public final class ConfigContractPlugin implements Plugin { tree.exclude("app-bootstrap/**"); tree.exclude("**/build/**"); })); - // What an operator edits or runs: the root Compose files, the Logback + // What an operator edits or runs: the development Compose file and the lane + // overlays that run the application, the Logback // configuration, and the Compose lane contract with the smoke wrapper that drives it // (each lane's activationEnv, the wrapper's CAPABILITIES_OFF). Their APP_ names must // be registered and read (07-10, RR-06-07), and a lane's other variables must be read @@ -51,16 +52,17 @@ public final class ConfigContractPlugin implements Plugin { // by hand. task.getOperatorFiles() .from( + root.file("../compose.yaml"), root.fileTree( - root.file(".."), + root.file("app-bootstrap/compose-lanes"), tree -> { - tree.include("docker-compose*.yml"); - // The infrastructure stack: its APP_* variables belong to smoke-test - // clients and other services, not to this application. - tree.exclude("docker-compose.infra.yml"); + tree.include("*.yaml"); + // The lane-only services: their APP_* variables belong to the smoke + // clients, not to this application. + tree.exclude("lane-services.yaml"); }), root.file("app-bootstrap/src/main/resources/logback-spring.xml"), - root.file("config/runtime/compose-profile-contracts.json"), + root.file("app-bootstrap/compose-lanes/compose-profile-contracts.json"), root.file("../scripts/run-compose-runtime-smoke.sh")); task.getRegistryFile().fileValue(root.file("../docs/registries/env-keys.yaml")); // No module path here: the typed properties come from the configuration metadata on diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyContract.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyContract.java index 66862553..631748fe 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyContract.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyContract.java @@ -59,7 +59,7 @@ public final class RedisTopologyContract { throw new IllegalStateException( "redisTopologyTest was selected without " + String.join(", ", missing) - + "; start a lane from infra/redis-sdk and pass -P=."); + + "; start a lane from src/adapter/outbound/redis-sdk/compose and pass -P=."); } } diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyLanePlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyLanePlugin.java index 78010885..33ba01e0 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyLanePlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyLanePlugin.java @@ -60,16 +60,16 @@ public final class RedisTopologyLanePlugin implements Plugin { lane -> { lane.integration(); if ("unset".equals(declaredMode)) { - // The lane needs a running topology from infra/redis-sdk and its coordinates; without + // The lane needs a running topology from redis-sdk/compose and its coordinates; without // them it can only fail, so the repository's integrationCheck leaves it out and says // so rather than failing on an input it was never given (review NEW-16). lane.explicitOnly( "it needs -Predis.topology.mode= and the topology" - + " coordinates from infra/redis-sdk (redis-sdk-topology.yml passes them)"); + + " coordinates from redis-sdk/compose (redis-sdk-topology.yml passes them)"); } lane.setTag("redis-topology & lane-" + declaredMode); lane.setDescription( - "Runs this leaf's Redis contracts against a real topology declared in infra/redis-sdk."); + "Runs this leaf's Redis contracts against a real topology declared in redis-sdk/compose."); lane.customize( test -> configureTopologyTask(test, declaredMode, propertyValues, extension)); }); diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/config/EnvContractVerifierTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/config/EnvContractVerifierTest.java index d482e37a..63042580 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/config/EnvContractVerifierTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/config/EnvContractVerifierTest.java @@ -204,7 +204,7 @@ class EnvContractVerifierTest { fixture.registry(), Files.readString(fixture.registry()) + "- name: APP_LOG_JSON_ENABLED\n type: boolean\n default: true\n"); - Path compose = fixture.repositoryRoot().resolve("docker-compose.yml"); + Path compose = fixture.repositoryRoot().resolve("compose.yaml"); Files.writeString(compose, "services:\n app:\n environment:\n APP_LOG_JSON_ENABLED: \"true\"\n"); // when @@ -231,7 +231,7 @@ class EnvContractVerifierTest { void anOperatorFileKeyMissingFromTheRegistryFails(@TempDir Path temp) throws Exception { // given Fixture fixture = fixture(temp); - Path compose = fixture.repositoryRoot().resolve("docker-compose.yml"); + Path compose = fixture.repositoryRoot().resolve("compose.yaml"); Files.writeString(compose, "services:\n app:\n environment:\n APP_UNREGISTERED: x\n"); // when @@ -257,7 +257,7 @@ class EnvContractVerifierTest { void anOperatorFileKeyTheConfigurationReadsPasses(@TempDir Path temp) throws Exception { // given Fixture fixture = fixture(temp); - Path compose = fixture.repositoryRoot().resolve("docker-compose.yml"); + Path compose = fixture.repositoryRoot().resolve("compose.yaml"); Files.writeString(compose, "services:\n app:\n environment:\n APP_REQUIRED: x\n"); // when @@ -357,7 +357,7 @@ class EnvContractVerifierTest { fixture.registry(), Files.readString(fixture.registry()) + "- name: APP_GHOST_ENABLED\n property: app.ghost.enabled\n type: boolean\n"); - Path compose = fixture.repositoryRoot().resolve("docker-compose.yml"); + Path compose = fixture.repositoryRoot().resolve("compose.yaml"); Files.writeString( compose, "services:\n app:\n environment:\n APP_GHOST_ENABLED: \"true\"\n"); @@ -387,7 +387,7 @@ class EnvContractVerifierTest { Files.writeString( ghostClasses.resolve(ConfigurationMetadataClasspath.METADATA), "{\"properties\":[{\"name\":\"app.ghost.enabled\"}]}"); - Path compose = fixture.repositoryRoot().resolve("docker-compose.yml"); + Path compose = fixture.repositoryRoot().resolve("compose.yaml"); Files.writeString( compose, "services:\n app:\n environment:\n APP_GHOST_ENABLED: \"true\"\n"); diff --git a/src/composition/fileserver-platform/README.md b/src/composition/fileserver-platform/README.md index 68f771be..3affcc56 100644 --- a/src/composition/fileserver-platform/README.md +++ b/src/composition/fileserver-platform/README.md @@ -53,12 +53,12 @@ SSOT다. 설명은 `docs/fileserver/configuration.md`. ## 필요한 마운트 저장 루트(`/var/lib/backend/files`)는 쓰기 가능한 전용 volume이어야 한다. 기본 이미지와 기본 -`docker-compose.yml`은 이 모듈이 없으므로 volume도 갖지 않는다(리뷰 07-08). 이 모듈을 고른 서비스가 +`compose.yaml`은 이 모듈이 없으므로 volume도 갖지 않는다(리뷰 07-08). 이 모듈을 고른 서비스가 volume을 붙인다. | 실행 환경 | 붙이는 방법 | | --- | --- | -| Compose | `-f infra/fileserver/compose/docker-compose.fileserver.yml`을 더한다. `fileserver-data` named volume을 마운트하고, 앱보다 먼저 `fileserver-storage-init`이 앱 이미지 안에서 root로 한 번 돌아 volume 소유자를 이미지의 `app` 계정으로 바꾼다(0750). 새 volume, 재사용한 volume, bind mount 모두 같다 | +| Compose | `-f src/app-bootstrap/compose-lanes/fileserver.yaml`을 더한다(compose lane fixture다. 서비스는 같은 volume 정의를 자기 compose에 둔다). `fileserver-data` named volume을 마운트하고, 앱보다 먼저 `fileserver-storage-init`이 앱 이미지 안에서 root로 한 번 돌아 volume 소유자를 이미지의 `app` 계정으로 바꾼다(0750). 새 volume, 재사용한 volume, bind mount 모두 같다 | | Kubernetes | PersistentVolumeClaim을 같은 경로에 마운트하고 pod `securityContext.fsGroup`을 앱 그룹으로 둔다(조건: `docs/fileserver/operations.md` 「운영 환경이 지켜야 할 조건」) | | `docker run` | `-v :/var/lib/backend/files`. volume 소유자를 이미지의 `app` 계정으로 먼저 맞춘다 | diff --git a/src/config/testing/container-images.properties b/src/config/testing/container-images.properties index f07b29ed..0ae00a05 100644 --- a/src/config/testing/container-images.properties +++ b/src/config/testing/container-images.properties @@ -34,7 +34,7 @@ mongo-8=mongo@sha256:4b58ebcb1dc7a7b4e84cd8ce9098d48764ae4478876898ff9551acf2ac4 mongo-7=mongo@sha256:4510cf3d7050003e958745adb25d2deb3fb907430716162d9cc1a92eda2a6047 # apache/kafka:4.1.0 kafka=apache/kafka@sha256:bff074a5d0051dbc0bbbcd25b045bb1fe84833ec0d3c7c965d1797dd289ec88f -# redis:7.4 — the cache-redis container lane; the ACL it loads is infra/redis-sdk/acl. +# redis:7.4 — the cache-redis container lane; the ACL it loads is compose/redis/acl. redis=redis@sha256:b6b6e3dc0c0952737748e55d5d885272840c7e42ba41ab1d5489f693419882f5 # ghcr.io/shopify/toxiproxy:2.12.0 toxiproxy=ghcr.io/shopify/toxiproxy@sha256:9378ed52a28bc50edc1350f936f518f31fa95f0d15917d6eb40b8e376d1a214e From 8d69e599a376e4db29fdf7b96e06fa457ba6ace1 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 13:04:54 +0900 Subject: [PATCH 4/8] =?UTF-8?q?refactor(repo)!:=20=EB=93=A4=EC=97=AC?= =?UTF-8?q?=EC=98=A8=20=ED=94=8C=EB=9E=AB=ED=8F=BC=EC=9D=84=20src/platform?= =?UTF-8?q?s=20=EC=95=84=EB=9E=98=EB=A1=9C=20=EB=AC=B6=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: src/ 최상위에 계층 폴더와 들여온 제품 폴더(messaging, grpc, grpc-advanced)와 optional 빌드 폴더(optional-platforms)가 같은 높이로 놓여, 무엇이 이 애플리케이션의 계층인지 폴더만으로 안 보인다. src/config/에는 빌드 전체 설정과 기능 하나가 주인인 데이터(jpa, messaging, mongodb)가 섞여 있다. 고른 방법(소유자 결정 2026-11-07, 설계 가-1): - git mv로 src/platforms/{messaging,grpc,grpc-advanced,optional-build}. registry source_path 28행만 바꾸고 Gradle 경로(:messaging:*, :grpc:*)는 그대로다. optional 빌드의 이름(optional-platforms)도 그대로다. - optional 빌드가 한 단계 깊어져, build-logic이 "optional 빌드의 부모 = 주 빌드"로 가정한 네 곳(registry settings, ArchitecturePlugin, 테스트 이미지 catalog, checkstyle·spotbugs 설정)을 MainBuild(위로 올라가며 registry·설정 파일을 찾음)로 바꾼다. - settings.gradle·build.gradle의 상대 경로, workflow의 -p 값과 경로, buf 작업 폴더를 고친다. buf breaking은 이동 전 baseline에서도 옛 경로로 비교해 이동 PR에서 건너뛰지 않는다. - config/jpa, config/messaging, config/mongodb의 데이터를 주인 leaf의 release/로 옮기고 읽는 빌드 줄·테스트·스크립트·문서를 고친다. - 루트 CLAUDE.md 5절에 최상위 폴더 지도를 한 줄로 적는다. 버린 대안: Gradle 루트를 저장소 루트로(가-3, CI 재편 때 다시 봄), application-* 묶기(가-2, 파생 서비스 충돌이 큼). 위험·한계: Gradle 문서의 "이름 = 위치" 권고와 한 단계 어긋난다 (:messaging:x가 platforms/messaging/x). 옮긴 폴더를 고쳐 쓰던 파생 서비스는 이름 바뀜 충돌이 날 수 있다(B-52). docs/capability-status.md 「제거된 코드」 표와 docs/work/evidence.md의 옛 경로는 이력이라 두었다. 검증(desktop, 트리 2b3354a4, ~/t1-layout-logs/): - ./gradlew :ci :verifyDependencyLocks --warning-mode=fail --continue 첫 실행 rc=1: MessagingAuthorityContractTest가 src/messaging을 찾아 실패 → 경로를 고침. 두 번째 rc=1: messaging-policy MessagingAdmissionControllerTest.aWaitingCallerIsAdmittedOnceAPermitIsReturned (2초 대기 경쟁, 부하 7.3에서 한 번 실패, 코드 변경 없는 leaf) → --rerun 3회 모두 통과. 세 번째 rc=0 - -p platforms/optional-build ci rc=0, 두 빌드의 verifyStrictLaneStages --dry-run rc=0, -p build-logic check rc=0 - :app-bootstrap:documentContractTest :adapter:outbound:persistence-mongo:mongoDocumentContractTest rc=0 - ./gradlew projects(주 빌드)와 optional 빌드 projects의 프로젝트 목록이 이동 전 트리와 같다(Gradle 경로 불변) - check-work-docs.py, 상대 링크 검사 rc=0 Refs: design-docs repo-structure/README.md 3.1, repo-structure/01-backend-layout.md 6.1 BREAKING CHANGE: src/messaging·src/grpc·src/grpc-advanced·src/optional-platforms가 src/platforms/ 아래로, src/config/{jpa,messaging,mongodb}가 주인 leaf의 release/로 옮겨졌다. optional 빌드는 -p platforms/optional-build로 부른다. docs/upgrade/2026-11-maturity-review.md B-52. --- .github/workflows/ci-quality-gates.yml | 31 ++++--- .github/workflows/integration-main.yml | 8 +- .github/workflows/messaging-certification.yml | 4 +- .github/workflows/release.yml | 10 +-- AGENTS.md | 6 +- CLAUDE.md | 5 +- docs/jpa/repository-adaptation.md | 2 +- docs/jpa/support-matrix.md | 2 +- docs/messaging/support-matrix.md | 2 +- docs/mongodb/advanced/sharding.md | 2 +- docs/roadmap/messaging-r2.md | 4 +- docs/runbooks/migration-failed.md | 2 +- docs/upgrade/2026-11-maturity-review.md | 5 +- docs/work/delegate.md | 4 +- docs/work/reference/decisions.md | 1 + docs/work/reference/defect-patterns.md | 2 +- docs/work/reference/gates.md | 16 ++-- scripts/verify-mongodb-advanced.sh | 4 +- scripts/verify-mongodb-platform.sh | 4 +- .../outbound/messaging-kafka/CLAUDE.md | 2 +- src/adapter/outbound/messaging/CLAUDE.md | 2 +- src/adapter/outbound/messaging/build.gradle | 6 +- .../build-evidence-manifest-v1.schema.json | 0 .../release}/profile-compatibility.yaml | 0 .../messaging/release}/readiness-cards.yaml | 0 .../release}/release-profile-assertions.yaml | 0 ...ssagingCapabilityRegistryContractTest.java | 8 +- .../MessagingEvidenceSchemaValidatorTest.java | 6 +- .../outbound/persistence-fileserver/CLAUDE.md | 2 +- .../persistence-fileserver/build.gradle | 2 +- .../outbound/persistence-jpa/README.md | 2 +- .../outbound/persistence-jpa/build.gradle | 24 +++--- .../release}/readiness-cards.yaml | 0 .../release}/release-registry.json | 0 .../persistence/migration/MigrationTrees.java | 2 +- .../testkit/JpaReadinessRegistryTest.java | 5 +- .../testkit/release/JpaReleaseManifest.java | 3 +- .../outbound/persistence-mongo/CLAUDE.md | 2 +- .../outbound/persistence-mongo/build.gradle | 2 +- .../release}/release-contracts.json | 0 .../MongoTestLaneContractTest.java | 3 +- src/app-bootstrap/README.md | 4 +- src/app-bootstrap/build.gradle | 4 +- .../DeveloperExperienceContractTest.java | 6 +- .../MessagingAuthorityContractTest.java | 2 +- .../MessagingPublicSurfaceContractTest.java | 6 +- .../ReleaseManifestTaskExistenceTest.java | 3 +- .../dev/caskeleton/buildlogic/MainBuild.java | 78 ++++++++++++++++++ .../architecture/ArchitecturePlugin.java | 15 +--- .../java/JavaConventionsPlugin.java | 10 ++- .../quality/QualityConventionsPlugin.java | 14 ++-- ...nalArchitectureRegistrySettingsPlugin.java | 16 ++-- .../strictlane/StrictLaneStagesExtension.java | 2 +- .../strictlane/StrictLaneStagesPlugin.java | 2 +- src/config/architecture/modules.json | 56 ++++++------- src/{ => platforms}/grpc-advanced/CLAUDE.md | 0 .../grpc-advanced-compat/build.gradle | 0 .../grpc-advanced-compat/gradle.lockfile | 0 .../GrpcIntegrationBridgePolicy.java | 0 .../GrpcIntegrationInboundGateway.java | 0 .../GrpcIntegrationOutboundGateway.java | 0 .../kotlin/GrpcCoroutineContextBridge.java | 0 .../GrpcReactorCancellationBridge.java | 0 .../reactor/GrpcReactorContextBridge.java | 0 .../advanced/reactor/ReactiveGrpcClient.java | 0 .../reactor/ReactiveGrpcServerAdapter.java | 0 .../grpc/advanced/web/GrpcWebProfile.java | 0 .../advanced/web/GrpcWebProxyContract.java | 0 .../grpc/advanced/web/GrpcWebRpcSupport.java | 0 .../GrpcCoroutineContextBridgeTest.java | 0 .../GrpcIntegrationBridgePolicyTest.java | 0 .../compat/GrpcReactorContextBridgeTest.java | 0 .../compat/GrpcWebCompatibilityTest.java | 0 .../src/test/resources/envoy/envoy.yaml | 0 .../grpc-advanced/grpc-advanced/build.gradle | 0 .../grpc-advanced/gradle.lockfile | 0 .../bootstrap/GrpcAdvancedCapability.java | 0 ...pcAdvancedCapabilityDisabledException.java | 0 .../bootstrap/GrpcAdvancedFeatureFlags.java | 0 .../bootstrap/GrpcAdvancedModuleGuard.java | 0 .../bootstrap/GrpcCapabilityGrade.java | 0 .../GrpcChannelDiagnosticsPolicy.java | 0 .../GrpcChannelDiagnosticsSnapshot.java | 0 .../diagnostics/GrpcDiagnosticsRedactor.java | 0 .../discovery/GrpcCustomResolver.java | 0 .../discovery/GrpcEndpointCandidate.java | 0 .../discovery/GrpcEndpointSnapshot.java | 0 .../discovery/GrpcLoadBalancerDecision.java | 0 .../discovery/GrpcLoadBalancerPicker.java | 0 .../GrpcLoadBalancerSafetyPolicy.java | 0 .../discovery/GrpcResolverSafetyPolicy.java | 0 .../discovery/GrpcResolverUpdate.java | 0 .../edition/GrpcEdition2024Policy.java | 0 .../edition/GrpcEdition2026Status.java | 0 .../edition/GrpcEdition2026WatchReport.java | 0 .../GrpcEditionCompatibilityReport.java | 0 .../resilience/GrpcHedgingBudget.java | 0 .../resilience/GrpcHedgingEligibility.java | 0 .../resilience/GrpcHedgingPolicy.java | 0 .../resilience/GrpcHedgingResult.java | 0 .../streaming/GrpcBidiDirectionState.java | 0 .../streaming/GrpcBidiResumeState.java | 0 .../streaming/GrpcBidiSequenceTracker.java | 0 .../advanced/streaming/GrpcBidiSession.java | 0 .../GrpcClientMessageDeduplicator.java | 0 .../streaming/GrpcClientStreamCheckpoint.java | 0 .../streaming/GrpcClientStreamMessage.java | 0 .../streaming/GrpcClientStreamPolicy.java | 0 .../GrpcClientStreamResumeDecision.java | 0 .../streaming/GrpcClientStreamSessionId.java | 0 .../streaming/GrpcClientStreamState.java | 0 .../streaming/GrpcDemandController.java | 0 .../streaming/GrpcDemandDecision.java | 0 .../GrpcManualFlowControlPolicy.java | 0 .../advanced/xds/GrpcXdsFailurePolicy.java | 0 .../grpc/advanced/xds/GrpcXdsProfile.java | 0 .../advanced/xds/GrpcXdsResourceSnapshot.java | 0 .../GrpcAdvancedModuleGuardTest.java | 0 .../GrpcChannelDiagnosticsPolicyTest.java | 0 ...rpcDiagnosticsRedactorIdempotenceTest.java | 0 .../edition/GrpcEdition2024PolicyTest.java | 0 .../GrpcEdition2026WatchReportTest.java | 0 .../GrpcHedgingEligibilityTest.java | 0 .../GrpcLoadBalancerSafetyPolicyTest.java | 0 .../GrpcResolverSafetyPolicyTest.java | 0 .../resilience/GrpcXdsProfileTest.java | 0 .../GrpcBidiSequenceTrackerTest.java | 0 .../GrpcClientMessageDeduplicatorTest.java | 0 .../streaming/GrpcClientStreamPolicyTest.java | 0 .../streaming/GrpcDemandControllerTest.java | 0 .../proto/edition2024/compatibility.proto | 0 .../resources/xds/control-plane-snapshot.json | 0 src/{ => platforms}/grpc/CLAUDE.md | 16 ++-- .../grpc/grpc-contract/buf.yaml | 4 +- .../grpc/grpc-contract/build.gradle | 0 .../grpc/grpc-contract/gradle.lockfile | 0 .../caskeleton/grpc/common/v1/error.proto | 0 .../caskeleton/grpc/common/v1/stream.proto | 0 .../GrpcContractGeneratedCodeTest.java | 0 .../grpc/grpc-core-api/build.gradle | 0 .../grpc/grpc-core-api/gradle.lockfile | 0 .../grpc/api/context/GrpcClientIdentity.java | 0 .../grpc/api/context/GrpcMetadataBudget.java | 0 .../grpc/api/context/GrpcMetadataKey.java | 0 .../grpc/api/context/GrpcRequestContext.java | 0 .../api/deadline/GrpcCancellationToken.java | 0 .../grpc/api/deadline/GrpcDeadlineBudget.java | 0 .../GrpcDeadlineExceededException.java | 0 .../api/deadline/GrpcDeadlineProfile.java | 0 .../grpc/api/error/GrpcCompletionOutcome.java | 0 .../grpc/api/error/GrpcFailureCategory.java | 0 .../grpc/api/error/GrpcFailureContext.java | 0 .../grpc/api/error/GrpcPlatformException.java | 0 .../grpc/api/ledger/GrpcClaimToken.java | 0 .../api/ledger/GrpcOperationIdentity.java | 0 .../grpc/api/ledger/GrpcOperationLedger.java | 0 .../api/ledger/GrpcOperationLedgerRecord.java | 0 .../api/ledger/GrpcOperationLedgerState.java | 0 .../grpc/api/policy/GrpcMethodPolicy.java | 0 .../api/policy/GrpcMethodPolicyCatalog.java | 0 .../grpc/api/policy/GrpcTransportLimits.java | 0 .../api/policy/RpcIdempotencyProfile.java | 0 .../grpc/api/policy/WaitForReadyPolicy.java | 0 .../grpc/core/GrpcChannelProfileName.java | 0 .../caskeleton/grpc/core/GrpcIdentifiers.java | 0 .../caskeleton/grpc/core/GrpcMethodName.java | 0 .../caskeleton/grpc/core/GrpcServiceName.java | 0 .../caskeleton/grpc/core/GrpcStatusCode.java | 0 .../dev/caskeleton/grpc/core/RpcType.java | 0 .../grpc/evidence/GrpcBusinessEvidence.java | 0 .../grpc/evidence/GrpcExecutionEvidence.java | 0 .../grpc/evidence/GrpcStreamEvidence.java | 0 .../grpc/evidence/GrpcTransportEvidence.java | 0 .../api/context/GrpcMetadataBudgetTest.java | 0 .../api/deadline/GrpcDeadlineBudgetTest.java | 0 .../api/error/GrpcFailureContextTest.java | 0 .../api/ledger/GrpcOperationIdentityTest.java | 0 .../InMemoryOperationLedgerContractTest.java | 0 .../policy/GrpcMethodPolicyCatalogTest.java | 0 .../grpc/core/GrpcCoreIdentifiersTest.java | 0 .../evidence/GrpcExecutionEvidenceTest.java | 0 .../ledger/GrpcOperationLedgerContract.java | 0 .../api/ledger/InMemoryOperationLedger.java | 0 .../grpc/grpc-observability/build.gradle | 0 .../grpc/grpc-observability/gradle.lockfile | 0 .../GrpcMetricCardinalityPolicy.java | 0 .../GrpcObservationConvention.java | 0 .../observability/GrpcRpcObservation.java | 0 .../observability/GrpcStreamObservation.java | 0 .../GrpcMetricCardinalityPolicyTest.java | 0 .../grpc-operation-ledger-jpa/build.gradle | 2 +- .../grpc-operation-ledger-jpa/gradle.lockfile | 0 ...rpcOperationLedgerMigrationLockWaitIT.java | 0 .../ledger/GrpcOperationLedgerMigrations.java | 0 .../ledger/GrpcOperationLedgerPostgresIT.java | 0 .../JpaGrpcOperationLedgerContractIT.java | 0 .../ledger/GrpcOperationLedgerEntity.java | 0 .../ledger/GrpcOperationLedgerRepository.java | 0 .../grpc/ledger/JpaGrpcOperationLedger.java | 0 .../V001__create_grpc_operation_ledger.sql | 0 ...ex_grpc_operation_ledger_finished_rows.sql | 0 ...dd_grpc_operation_ledger_claim_attempt.sql | 0 .../GrpcOperationLedgerRepositoryTest.java | 0 .../grpc/grpc-runtime/build.gradle | 0 .../grpc/grpc-runtime/gradle.lockfile | 0 .../grpc/admin/GrpcAdminExposurePolicy.java | 0 .../grpc/admin/GrpcDrainCoordinator.java | 0 .../caskeleton/grpc/admin/GrpcDrainPhase.java | 0 .../grpc/admin/GrpcDrainPolicy.java | 0 .../grpc/admin/GrpcDrainResult.java | 0 .../grpc/admin/GrpcHealthPolicy.java | 0 .../grpc/admin/GrpcHealthState.java | 0 .../grpc/admin/GrpcPlatformSnapshot.java | 0 .../admin/GrpcPlatformSnapshotService.java | 0 .../admin/GrpcReflectionAccessDecision.java | 0 .../grpc/admin/GrpcReflectionMode.java | 0 .../grpc/admin/GrpcReflectionPolicy.java | 0 .../grpc/admin/GrpcServiceHealthRegistry.java | 0 .../client/GrpcCallCredentialProvider.java | 0 .../grpc/client/GrpcChannelDrainPolicy.java | 0 .../grpc/client/GrpcChannelGeneration.java | 0 .../client/GrpcChannelProfileValidator.java | 0 .../grpc/client/GrpcChannelRuntime.java | 0 .../client/GrpcChannelRuntimeRegistry.java | 0 .../grpc/client/GrpcClientCallContext.java | 0 .../grpc/client/GrpcClientMetadataPolicy.java | 0 .../grpc/client/GrpcLoadBalancingPolicy.java | 0 .../grpc/client/GrpcNamedChannelProfile.java | 0 .../grpc/client/GrpcStubDescriptor.java | 0 .../grpc/client/GrpcStubPolicyApplier.java | 0 .../grpc/client/GrpcTypedStubFactory.java | 0 .../grpc/context/GrpcContextBinder.java | 0 .../context/GrpcContextPropagationPolicy.java | 0 .../grpc/context/GrpcContextSnapshot.java | 0 .../deadline/GrpcCancellableOperation.java | 0 .../deadline/GrpcCancellationCoordinator.java | 0 .../grpc/deadline/GrpcCancellationReason.java | 0 .../grpc/deadline/GrpcDeadlineCalculator.java | 0 .../deadline/GrpcDeadlinePolicyValidator.java | 0 .../grpc/deadline/GrpcDependencyBudget.java | 0 .../GrpcDiscoveryPolicyValidator.java | 0 .../grpc/discovery/GrpcKubernetesProfile.java | 0 .../GrpcKubernetesProfileValidator.java | 0 .../discovery/GrpcKubernetesRoutingMode.java | 0 .../grpc/discovery/GrpcResolverProfile.java | 0 .../grpc/discovery/GrpcResolverType.java | 0 .../discovery/GrpcStableLoadBalancer.java | 0 .../grpc/error/GrpcErrorExposurePolicy.java | 0 .../grpc/error/GrpcErrorMapper.java | 0 .../grpc/error/GrpcRichErrorDetail.java | 0 .../grpc/error/GrpcStatusMapping.java | 0 .../idempotency/GrpcCompletionReconciler.java | 0 .../idempotency/GrpcCompletionResolution.java | 0 .../idempotency/GrpcIdempotencyDecision.java | 0 .../GrpcIdempotencyInterceptor.java | 0 .../GrpcOperationLedgerRetention.java | 0 .../grpc/idempotency/GrpcOperationStatus.java | 0 .../idempotency/GrpcOperationStatusQuery.java | 0 .../grpc/idempotency/GrpcOutcomeReplay.java | 0 .../idempotency/GrpcRequestFingerprint.java | 0 .../grpc/policy/GrpcCompressionProfile.java | 0 .../grpc/policy/GrpcMessageSizeProfile.java | 0 .../policy/GrpcPayloadBoundaryPolicy.java | 0 .../grpc/policy/GrpcSizeViolation.java | 0 .../resilience/GrpcMethodRetryConfig.java | 0 .../grpc/resilience/GrpcRetryBudget.java | 0 .../grpc/resilience/GrpcRetryCoordinator.java | 0 .../grpc/resilience/GrpcRetryDecision.java | 0 .../grpc/resilience/GrpcRetryEligibility.java | 0 .../grpc/resilience/GrpcRetryOwner.java | 0 .../GrpcRetryOwnershipValidator.java | 0 .../resilience/GrpcServiceConfigPolicy.java | 0 .../resilience/GrpcWaitForReadyDecision.java | 0 .../resilience/GrpcWaitForReadyProfile.java | 0 .../resilience/GrpcWaitForReadyValidator.java | 0 .../security/GrpcAuthenticationProfile.java | 0 .../security/GrpcCredentialGeneration.java | 0 .../GrpcCredentialRotationManager.java | 0 .../grpc/security/GrpcTlsProfile.java | 0 .../grpc/server/GrpcAdmissionController.java | 0 .../server/GrpcApplicationInvocation.java | 0 .../grpc/server/GrpcExecutorProfile.java | 0 .../grpc/server/GrpcNettyParityContract.java | 0 .../grpc/server/GrpcNettyVariant.java | 0 .../grpc/server/GrpcNettyVariantSelector.java | 0 .../grpc/server/GrpcResponseMapper.java | 0 .../server/GrpcServerInterceptorChain.java | 0 .../server/GrpcServerInterceptorOrder.java | 0 .../server/GrpcServerInterceptorStage.java | 0 .../grpc/server/GrpcServerProfile.java | 0 .../grpc/server/GrpcServerTransport.java | 0 .../grpc/server/GrpcServiceAdapter.java | 0 .../server/GrpcServiceAdapterDescriptor.java | 0 .../streaming/GrpcFlowControlDecision.java | 0 .../grpc/streaming/GrpcFlowControlPolicy.java | 0 .../grpc/streaming/GrpcResumeDecision.java | 0 .../grpc/streaming/GrpcResumeToken.java | 0 .../grpc/streaming/GrpcResumeTokenCodec.java | 0 .../streaming/GrpcSerializedStreamWriter.java | 0 .../streaming/GrpcSlowConsumerPolicy.java | 0 .../grpc/streaming/GrpcStreamAdmission.java | 0 .../grpc/streaming/GrpcStreamEnvelope.java | 0 .../grpc/streaming/GrpcStreamGapDetector.java | 0 .../grpc/streaming/GrpcStreamHeartbeat.java | 0 .../grpc/streaming/GrpcStreamId.java | 0 .../GrpcStreamLifecycleCoordinator.java | 0 .../streaming/GrpcStreamLifetimePolicy.java | 0 .../grpc/streaming/GrpcStreamSequence.java | 0 .../GrpcStreamTerminationReason.java | 0 .../grpc/streaming/GrpcStreamWriteResult.java | 0 .../grpc/streaming/GrpcStreamWriterState.java | 0 .../validation/GrpcTransportValidator.java | 0 .../validation/GrpcValidationInterceptor.java | 0 .../validation/GrpcValidationViolation.java | 0 .../grpc/admin/GrpcDrainCoordinatorTest.java | 0 .../GrpcPlatformSnapshotServiceTest.java | 0 .../grpc/admin/GrpcReflectionPolicyTest.java | 0 .../admin/GrpcServiceHealthRegistryTest.java | 0 .../GrpcChannelRuntimeRegistryTest.java | 0 .../client/GrpcClientMetadataPolicyTest.java | 0 .../client/GrpcNamedChannelProfileTest.java | 0 .../grpc/client/GrpcTypedStubFactoryTest.java | 0 .../grpc/context/GrpcContextBinderTest.java | 0 .../GrpcCancellationCoordinatorTest.java | 0 .../deadline/GrpcDeadlineCalculatorTest.java | 0 .../GrpcDiscoveryPolicyValidatorTest.java | 0 .../discovery/GrpcKubernetesProfileTest.java | 0 .../grpc/error/GrpcErrorMapperTest.java | 0 .../GrpcCompletionReconcilerTest.java | 0 .../GrpcIdempotencyInterceptorTest.java | 0 .../GrpcOperationLedgerRetentionTest.java | 0 .../GrpcOutcomeReplayBoundTest.java | 0 .../policy/GrpcPayloadBoundaryPolicyTest.java | 0 .../resilience/GrpcRetryEligibilityTest.java | 0 .../GrpcRetryOwnershipValidatorTest.java | 0 .../GrpcWaitForReadyValidatorTest.java | 0 .../GrpcCredentialRotationManagerTest.java | 0 .../grpc/security/GrpcTlsProfileTest.java | 0 .../server/GrpcAdmissionControllerTest.java | 0 .../server/GrpcNettyVariantSelectorTest.java | 0 .../GrpcServerInterceptorOrderTest.java | 0 .../grpc/server/GrpcServerProfileTest.java | 0 .../grpc/server/GrpcServiceAdapterTest.java | 0 .../streaming/GrpcFlowControlPolicyTest.java | 0 .../streaming/GrpcResumeTokenCodecTest.java | 0 .../GrpcSerializedStreamWriterTest.java | 0 .../GrpcStreamAdmissionConcurrencyTest.java | 0 .../streaming/GrpcStreamEnvelopeTest.java | 0 .../GrpcStreamLifetimePolicyTest.java | 0 .../GrpcValidationInterceptorTest.java | 0 .../grpc-spring-boot-starter/build.gradle | 0 .../grpc-spring-boot-starter/gradle.lockfile | 0 .../boot/GrpcPlatformAutoConfiguration.java | 0 .../GrpcPlatformConfigurationException.java | 0 .../grpc/boot/GrpcPlatformProperties.java | 0 .../boot/GrpcPlatformStartupValidator.java | 0 ...ot.autoconfigure.AutoConfiguration.imports | 0 ...cPlatformAutoConfigurationContextTest.java | 0 .../GrpcPlatformStartupValidatorTest.java | 0 .../grpc/grpc-testkit/build.gradle | 0 .../grpc/grpc-testkit/gradle.lockfile | 0 .../performance/GrpcPerformanceBudget.java | 0 .../grpc/performance/GrpcPerformanceGate.java | 0 .../performance/GrpcPerformanceResult.java | 0 .../grpc/testkit/GrpcEvidenceGrade.java | 0 .../testkit/GrpcServerStreamingContract.java | 0 .../testkit/GrpcStreamingContractResult.java | 0 .../grpc/testkit/GrpcStreamingScenario.java | 0 .../grpc/testkit/GrpcTextCodec.java | 0 .../grpc/testkit/GrpcUnaryContractResult.java | 0 .../testkit/GrpcUnaryReliabilityContract.java | 0 .../grpc/testkit/GrpcUnaryScenario.java | 0 .../grpc/testkit/fault/GrpcFaultPoint.java | 0 .../grpc/testkit/fault/GrpcFaultResult.java | 0 .../grpc/testkit/fault/GrpcFaultScenario.java | 0 .../GrpcTransportEvidenceClassifier.java | 0 .../GrpcInProcessContractFixture.java | 0 .../inprocess/GrpcInProcessTestClient.java | 0 .../inprocess/GrpcInProcessTestServer.java | 0 .../netty/GrpcNettyContractProfile.java | 0 .../testkit/netty/GrpcNettyTestClient.java | 0 .../testkit/netty/GrpcNettyTestServer.java | 0 .../testkit/netty/GrpcTlsTestMaterial.java | 0 .../performance/GrpcPerformanceGateTest.java | 0 .../performance/GrpcPerformanceLaneTest.java | 0 .../GrpcInProcessContractFixtureTest.java | 0 .../testkit/GrpcNettyContractProfileTest.java | 0 .../testkit/GrpcPackageOwnershipTest.java | 2 +- .../GrpcServerStreamingContractTest.java | 0 .../GrpcTransportEvidenceClassifierTest.java | 0 .../GrpcUnaryReliabilityContractTest.java | 0 src/{ => platforms}/messaging/CLAUDE.md | 0 .../messaging/messaging-admin/build.gradle | 0 .../messaging/messaging-admin/gradle.lockfile | 0 .../messaging/admin/AdminApproval.java | 0 .../admin/AdminOperationJournal.java | 0 .../messaging/admin/AdminOperationLease.java | 0 .../messaging/admin/AdminOperationRecord.java | 0 .../messaging/admin/AdminOperationState.java | 0 .../messaging/admin/ApprovalGrant.java | 0 .../messaging/admin/ApprovalVerifier.java | 0 .../messaging/admin/ApprovedRedrivePlan.java | 0 .../messaging/admin/ApprovedReplayPlan.java | 0 .../messaging/admin/DestinationTopology.java | 0 .../messaging/admin/DestructiveOperation.java | 0 .../admin/DestructiveOperationGuard.java | 0 .../messaging/admin/HmacApprovalVerifier.java | 0 .../messaging/admin/PlanDigest.java | 0 .../messaging/admin/RedrivePlan.java | 0 .../messaging/admin/RedriveRequest.java | 0 .../messaging/admin/RedriveResult.java | 0 .../messaging/admin/ReplayPlan.java | 0 .../messaging/admin/ReplayRequest.java | 0 .../messaging/admin/ReplayResult.java | 0 .../messaging/admin/TopologyIssue.java | 0 .../admin/TopologyManagementMode.java | 0 .../messaging/admin/TopologyManifest.java | 0 .../admin/TopologyValidationReport.java | 0 .../messaging/admin/VerifiedApproval.java | 0 .../runtime/BrokerTopologyInspector.java | 0 .../runtime/CompositeTopologyValidator.java | 0 .../runtime/DefaultMessagingAdminService.java | 0 .../runtime/DestructiveMessagingAdmin.java | 0 .../InMemoryAdminOperationJournal.java | 0 .../admin/runtime/MessagingAdminService.java | 0 .../admin/runtime/RedriveReport.java | 0 .../admin/runtime/RedriveService.java | 0 .../messaging/admin/runtime/ReplayReport.java | 0 .../admin/runtime/ReplayService.java | 0 .../runtime/TopologyValidationRuntime.java | 0 .../admin/runtime/TopologyValidator.java | 0 .../admin/DestructiveOperationGuardTest.java | 0 .../runtime/AdminOperationJournalTest.java | 0 .../admin/runtime/ApprovalForgeryTest.java | 0 .../runtime/ApprovedPlanExecutionTest.java | 0 .../admin/runtime/RedriveResumptionTest.java | 0 .../admin/runtime/ReplayServiceTest.java | 0 .../TopologyValidationRuntimeTest.java | 0 .../admin/runtime/TopologyValidatorTest.java | 0 .../messaging-claim-check/build.gradle | 0 .../messaging-claim-check/gradle.lockfile | 0 .../ClaimCheckIntegrityException.java | 0 .../claimcheck/ClaimCheckIntegrityGuard.java | 0 .../claimcheck/ClaimCheckPolicy.java | 0 .../claimcheck/ClaimCheckPublisher.java | 0 .../claimcheck/ClaimCheckResolver.java | 0 .../messaging/claimcheck/ClaimCheckStore.java | 0 .../ClaimCheckIntegrityGuardTest.java | 0 .../claimcheck/ClaimCheckResolverTest.java | 0 .../ClaimCheckRetentionValidatorTest.java | 0 .../messaging-cloudevents/build.gradle | 0 .../messaging-cloudevents/gradle.lockfile | 0 .../cloudevents/CloudEventExtensions.java | 0 .../cloudevents/CloudEventMapper.java | 0 .../cloudevents/DefaultCloudEventMapper.java | 0 .../cloudevents/CloudEventMappingTest.java | 0 .../messaging/messaging-core-api/build.gradle | 0 .../messaging-core-api/gradle.lockfile | 0 .../caskeleton/messaging/api/CausationId.java | 0 .../caskeleton/messaging/api/ContentType.java | 0 .../messaging/api/CorrelationId.java | 0 .../messaging/api/MessageEnvelope.java | 0 .../caskeleton/messaging/api/MessageId.java | 0 .../caskeleton/messaging/api/MessageType.java | 0 .../caskeleton/messaging/api/ProducerId.java | 0 .../messaging/api/SchemaVersion.java | 0 .../messaging/api/TenantContext.java | 0 .../messaging/api/TraceContext.java | 0 .../dev/caskeleton/messaging/api/UuidV7.java | 0 .../messaging/api/WireSafeText.java | 0 .../api/delivery/DeliveryContext.java | 0 .../api/delivery/DeliveryGuarantee.java | 0 .../api/delivery/DeliveryMetadata.java | 0 .../delivery/ExternalSideEffectGuarantee.java | 0 .../messaging/api/delivery/HandleResult.java | 0 .../api/delivery/MessageDelivery.java | 0 .../api/delivery/MessageHandler.java | 0 .../messaging/api/delivery/OrderingScope.java | 0 .../destination/ConfirmationRequirement.java | 0 .../destination/DestinationCapabilities.java | 0 .../api/destination/DestinationKind.java | 0 .../api/destination/DestinationName.java | 0 .../api/destination/MessageDestination.java | 0 .../destination/MessagingCapabilities.java | 0 .../messaging/api/error/FailureCategory.java | 0 .../api/error/FailureDescriptor.java | 0 .../error/MessageAuthorizationException.java | 0 .../error/MessageBackpressureException.java | 0 .../error/MessagePublishTimeoutException.java | 0 .../MessageSchemaIncompatibleException.java | 0 .../error/MessageSerializationException.java | 0 .../api/error/MessageTooLargeException.java | 0 .../api/error/MessageTopologyException.java | 0 .../api/error/MessageValidationException.java | 0 ...ssagingCapabilityUnavailableException.java | 0 .../MessagingConfigurationException.java | 0 .../api/error/MessagingException.java | 0 .../api/header/CanonicalEnvelopeHeaders.java | 0 .../messaging/api/header/HeaderName.java | 0 .../messaging/api/header/HeaderValue.java | 0 .../messaging/api/header/MessageHeaders.java | 0 .../messaging/api/header/ReservedHeaders.java | 0 .../messaging/api/publish/BrokerPosition.java | 0 .../api/publish/ConfirmationLevel.java | 0 .../api/publish/MessagePublisher.java | 0 .../api/publish/PublishCompletion.java | 0 .../api/publish/PublishDeduplication.java | 0 .../api/publish/PublishEvidence.java | 0 .../messaging/api/publish/PublishOptions.java | 0 .../messaging/api/publish/PublishRequest.java | 0 .../messaging/api/publish/PublishResult.java | 0 .../messaging/api/publish/RoutingOutcome.java | 0 .../api/publish/TransmissionEvidence.java | 0 .../api/settlement/SettlementCompletion.java | 0 .../api/settlement/SettlementEvidence.java | 0 .../api/settlement/SettlementResult.java | 0 .../messaging/schema/BoundedByteSink.java | 0 .../messaging/schema/EncodedMessage.java | 0 .../schema/EncodedMessagePublisher.java | 0 .../messaging/schema/MessageCodec.java | 0 .../schema/MessageCodecRegistry.java | 0 .../messaging/schema/MessageContractKey.java | 0 .../schema/RawBytesMessageCodec.java | 0 .../messaging/schema/SchemaCompatibility.java | 0 .../schema/SchemaCompatibilityValidator.java | 0 .../messaging/schema/SchemaReference.java | 0 .../messaging/schema/SchemaRegistry.java | 0 .../messaging/api/CoreValueTypesTest.java | 0 .../messaging/api/MessageEnvelopeTest.java | 0 .../messaging/api/ModuleSmokeTest.java | 0 .../api/WireBoundaryRejectionTest.java | 0 .../api/WireSafeValueObjectTest.java | Bin .../api/delivery/ConsumerContractTest.java | 0 .../DestinationCapabilityTest.java | 0 .../api/publish/PublishResultTest.java | 0 .../messaging/schema/BoundedByteSinkTest.java | 0 .../schema/RawBytesMessageCodecTest.java | 0 .../SchemaCompatibilityValidatorTest.java | 0 .../messaging/messaging-kafka/build.gradle | 2 +- .../messaging/messaging-kafka/gradle.lockfile | 0 .../kafka/KafkaAmbiguityChaosIT.java | 0 .../kafka/KafkaBrokerCertificationIT.java | 0 .../messaging/kafka/KafkaBrokerIT.java | 0 .../kafka/KafkaConsumerSettlementIT.java | 0 .../kafka/KafkaContainerFixture.java | 0 .../kafka/KafkaContainerSmokeTest.java | 0 .../messaging/kafka/KafkaReadCommittedIT.java | 0 .../kafka/KafkaTopologyValidationIT.java | 0 .../kafka/KafkaTransactionFencingIT.java | 0 .../kafka/KafkaTransactionFixtures.java | 0 .../messaging/kafka/KafkaTransactionIT.java | 0 .../kafka/KafkaPublishBenchmark.java | 0 .../ContiguousPartitionOffsetTracker.java | 0 .../messaging/kafka/KafkaBrokerProfile.java | 0 .../kafka/KafkaConsumerRegistrar.java | 0 .../kafka/KafkaCredentialCallbackHandler.java | 0 .../kafka/KafkaDeadLetterPublisher.java | 0 .../messaging/kafka/KafkaDeliveryMapper.java | 0 .../messaging/kafka/KafkaHeaderMapper.java | 0 .../kafka/KafkaMessagingTransport.java | 0 .../kafka/KafkaOffsetResetExecutor.java | 0 .../kafka/KafkaPartitionRetryScheduler.java | 0 .../messaging/kafka/KafkaPosition.java | 0 .../kafka/KafkaProfileValidator.java | 0 .../kafka/KafkaPublishFailureClassifier.java | 4 +- .../messaging/kafka/KafkaPublishMapper.java | 0 .../kafka/KafkaQuarantinePublisher.java | 0 .../kafka/KafkaReplayCapability.java | 0 .../messaging/kafka/KafkaReplayPlan.java | 0 .../messaging/kafka/KafkaReplayPlanner.java | 0 .../messaging/kafka/KafkaRetryExecutor.java | 0 .../kafka/KafkaRetryMetadataMapper.java | 0 .../messaging/kafka/KafkaRetryOutcome.java | 0 .../kafka/KafkaRetryTopicPublisher.java | 0 .../kafka/KafkaSecurityConfigurer.java | 0 .../kafka/KafkaSettlementCommand.java | 0 .../messaging/kafka/KafkaSettlementQueue.java | 0 .../KafkaTransactionProfileValidator.java | 0 .../kafka/KafkaTransactionalDelivery.java | 0 .../kafka/KafkaTransactionalOutput.java | 0 .../kafka/KafkaTransactionalProcessor.java | 0 .../kafka/KafkaTransactionalPublisher.java | 0 .../kafka/PartitionOffsetTracker.java | 0 .../kafka/PartitionWorkCoordinator.java | 0 .../SpringKafkaTransactionalProcessor.java | 0 .../ContiguousPartitionOffsetTrackerTest.java | 0 .../kafka/KafkaConsumerRegistrarTest.java | 0 .../kafka/KafkaEnvelopeRoundTripTest.java | 0 .../kafka/KafkaHeaderMapperTest.java | 0 .../kafka/KafkaMessagingTransportTest.java | 0 .../kafka/KafkaProducerContractTest.java | 0 .../kafka/KafkaProfileValidatorTest.java | 0 .../KafkaPublishFailureClassifierTest.java | 0 .../kafka/KafkaReplayPlannerTest.java | 0 .../kafka/KafkaSecurityConfigurerTest.java | 0 .../kafka/KafkaTransactionOrderingTest.java | 0 .../kafka/PartitionWorkCoordinatorTest.java | 0 .../kafka/ReservedHeaderForgeryTest.java | 0 .../messaging/kafka/KafkaContractHarness.java | 0 .../messaging/kafka/KafkaFixtureProfiles.java | 0 .../messaging-observability/build.gradle | 0 .../messaging-observability/gradle.lockfile | 0 .../observation/CardinalityGuard.java | 0 ...DefaultMessagingObservationConvention.java | 0 .../observation/MessagingAuditEvent.java | 0 .../observation/MessagingAuditSink.java | 0 .../observation/MessagingMetrics.java | 0 .../observation/MessagingObservation.java | 0 .../observation/MessagingRedactor.java | 0 .../messaging/observation/MessagingTags.java | 0 .../observation/MessagingTracer.java | 0 .../MessagingMetricCardinalityTest.java | 0 .../observation/MessagingRedactorTest.java | 0 .../observation/MessagingSecretLeakTest.java | 0 .../observation/MessagingTraceLinkTest.java | 0 ...SecretLeakScannerCharacterizationTest.java | 0 .../observation/SecretLeakStaticScanTest.java | 0 .../messaging/messaging-policy/build.gradle | 0 .../messaging-policy/gradle.lockfile | 0 .../caskeleton/messaging/policy/ApiTier.java | 0 .../messaging/policy/BackoffCalculator.java | 0 .../messaging/policy/ConsumerPolicy.java | 0 .../policy/DeadLetterEnvelopeFactory.java | 0 .../messaging/policy/DeadLetterMetadata.java | 0 .../policy/DeadLetterOrchestrator.java | 0 .../messaging/policy/DeadLetterPolicy.java | 0 .../messaging/policy/DeadLetterResult.java | 0 .../policy/DefaultRetryDecisionEngine.java | 0 .../messaging/policy/DestinationProfile.java | 0 .../policy/DestinationProfileValidator.java | 0 .../policy/FailureDescriptorDefaults.java | 0 .../messaging/policy/InFlightLimiter.java | 0 .../policy/MessagingAdmissionController.java | 0 .../messaging/policy/OrderingImpact.java | 0 .../messaging/policy/PayloadLimitGuard.java | 0 .../messaging/policy/PayloadPolicy.java | 0 .../messaging/policy/PhysicalDestination.java | 0 .../messaging/policy/ProducerPolicy.java | 0 .../messaging/policy/RetryContext.java | 0 .../messaging/policy/RetryDecision.java | 0 .../messaging/policy/RetryDecisionEngine.java | 0 .../messaging/policy/RetryMode.java | 0 .../messaging/policy/RetryPolicy.java | 0 .../messaging/policy/SchemaPolicy.java | 0 .../messaging/policy/SourceSettlement.java | 0 .../policy/DeadLetterOrchestratorTest.java | 0 .../DestinationProfileValidatorTest.java | 0 .../MessagingAdmissionControllerTest.java | 0 .../policy/RetryDecisionEngineTest.java | 0 .../messaging-reliability-api/build.gradle | 0 .../messaging-reliability-api/gradle.lockfile | 0 .../reliability/ClaimCheckReference.java | 0 .../reliability/InboxRepository.java | 0 .../reliability/OutboxCanonicalMetadata.java | 0 .../messaging/reliability/OutboxLease.java | 0 .../messaging/reliability/OutboxRecord.java | 0 .../reliability/OutboxRepository.java | 0 .../messaging/reliability/OutboxStatus.java | 0 .../reliability/OutboxTransitionResult.java | 0 .../OutboxRepositoryApiSafetyTest.java | 0 .../build.gradle | 0 .../gradle.lockfile | 0 .../messaging/inbox/InboxPostgresIT.java | 0 .../AdminOperationJournalPostgresIT.java | 0 .../messaging/outbox/OutboxPostgresIT.java | 0 .../messaging/inbox/JdbcInboxRepository.java | 0 .../outbox/JdbcAdminOperationJournal.java | 0 .../outbox/JdbcOutboxRepository.java | 0 .../messaging/V1001__messaging_outbox.sql | 0 .../V1002__messaging_outbox_lease_fencing.sql | 0 ...003__messaging_admin_operation_journal.sql | 0 ...4__messaging_outbox_canonical_metadata.sql | 0 ...5__messaging_outbox_ordering_key_index.sql | 0 .../messaging/V1101__messaging_inbox.sql | 0 .../JdbcInboxTransactionRequirementTest.java | 0 .../JdbcOutboxTransactionRequirementTest.java | 0 .../messaging-reliability/build.gradle | 0 .../messaging-reliability/gradle.lockfile | 0 .../messaging/inbox/IdempotentConsumer.java | 0 .../messaging/inbox/InboxCleanupJob.java | 0 .../messaging/inbox/InboxMessageHandler.java | 0 .../messaging/inbox/InboxOutcome.java | 0 .../messaging/inbox/InboxRetentionPolicy.java | 0 .../messaging/outbox/OutboxCleanupJob.java | 0 .../outbox/OutboxEnvelopeFactory.java | 0 .../messaging/outbox/OutboxProperties.java | 0 .../messaging/outbox/OutboxRelay.java | 0 .../messaging/outbox/OutboxRelayReport.java | 0 .../messaging/outbox/OutboxRelayWorker.java | 0 .../outbox/OutboxRetryScheduler.java | 0 .../inbox/IdempotentConsumerTest.java | 0 .../inbox/InboxMessageHandlerTest.java | 0 .../messaging/inbox/InboxOperationsTest.java | 0 .../outbox/OutboxEnvelopeFactoryTest.java | 0 .../outbox/OutboxOperationsTest.java | 0 .../messaging/outbox/OutboxRelayTest.java | 0 .../outbox/OutboxRelayWorkerTest.java | 0 .../messaging-runtime-core/build.gradle | 0 .../messaging-runtime-core/gradle.lockfile | 0 .../runtime/DeclaredDestinationAccess.java | 0 .../runtime/DefaultDeliveryProcessor.java | 0 .../runtime/DefaultMessagePublisher.java | 0 .../runtime/DestinationProfileRegistry.java | 0 .../runtime/RegisteredMessageCodecs.java | 0 .../runtime/TransportMessagingRuntime.java | 0 .../runtime/DefaultDeliveryProcessorTest.java | 0 .../runtime/DefaultMessagePublisherTest.java | 0 .../runtime/RegisteredMessageCodecsTest.java | 0 .../messaging/runtime/RuntimeFixtures.java | 0 .../messaging-schema-avro/build.gradle | 0 .../messaging-schema-avro/gradle.lockfile | 0 .../schema/avro/AvroCompatibilityGate.java | 0 .../schema/avro/AvroMessageCodec.java | 0 .../schema/avro/AvroCompatibilityTest.java | 0 .../schema/avro/AvroHostileInputTest.java | 0 .../schema/avro/AvroRegistryBoundsTest.java | 0 .../resources/schemas/order.created/v1.avsc | 0 .../messaging-schema-json/build.gradle | 0 .../messaging-schema-json/gradle.lockfile | 0 .../schema/json/JacksonMessageCodec.java | 0 .../schema/json/JacksonMessageCodecTest.java | 0 .../schema/json/JsonContractRegistryTest.java | 0 .../json/PlatformOverheadPerformanceTest.java | 0 .../messaging-schema-protobuf/build.gradle | 0 .../messaging-schema-protobuf/gradle.lockfile | 0 .../schema/protobuf/ProtobufMessageCodec.java | 0 .../protobuf/ProtobufMessageContract.java | 0 .../protobuf/ProtobufCompatibilityTest.java | 0 .../src/test/proto/order_created_v1.proto | 0 .../messaging/messaging-security/build.gradle | 0 .../messaging-security/gradle.lockfile | 0 .../messaging/security/BrokerAclManifest.java | 0 .../security/BrokerCredentialProfile.java | 0 .../security/BrokerSecurityProfile.java | 0 .../messaging/security/BrokerTlsPolicy.java | 0 .../messaging/security/BrokerTrustStore.java | 0 .../messaging/security/CredentialIds.java | 0 .../security/CredentialProvider.java | 0 .../security/CredentialRotationPlan.java | 0 .../messaging/security/CredentialRuntime.java | 0 .../security/CredentialRuntimeRegistry.java | 0 .../security/DestinationAccessPolicy.java | 0 .../security/DestinationAccessValidator.java | 0 .../security/MessageSecurityValidator.java | 0 .../CredentialRotationContractTest.java | 0 .../CredentialRuntimeRegistryTest.java | 0 .../MessageSecurityValidatorTest.java | 0 .../build.gradle | 0 .../gradle.lockfile | 0 .../autoconfigure/KafkaBrokerCatalog.java | 0 .../autoconfigure/KafkaBrokerSettings.java | 0 .../KafkaConsumerConfiguration.java | 0 .../autoconfigure/KafkaConsumerLifecycle.java | 0 .../KafkaDeadLetterQuarantine.java | 0 .../KafkaMessagingAutoConfiguration.java | 0 .../KafkaPolledRegistration.java | 0 .../KafkaDeadLetterQuarantineTest.java | 0 .../messaging-spring-boot-starter/README.md | 0 .../build.gradle | 0 .../gradle.lockfile | 0 ...essagingKafkaConsumeQualificationTest.java | 0 ...ssagingLiveRoundTripQualificationTest.java | 0 ...ssagingSecuredBrokerQualificationTest.java | 0 .../autoconfigure/BrokerSecuritySettings.java | 0 .../autoconfigure/BrokerSettings.java | 0 .../CompiledMessagingConfiguration.java | 0 .../autoconfigure/DestinationSettings.java | 0 .../autoconfigure/MessageConsumers.java | 0 .../autoconfigure/MessageContracts.java | 0 .../MessagingAdminAutoConfiguration.java | 0 .../MessagingAdminDurabilityValidator.java | 0 .../MessagingConfigurationCompiler.java | 0 .../MessagingConfigurationKeyValidator.java | 0 .../MessagingConsumeConfiguration.java | 0 .../MessagingCoreAutoConfiguration.java | 0 ...ssagingCredentialRequirementValidator.java | 0 .../autoconfigure/MessagingEndpoint.java | 0 .../MessagingObservabilityConfiguration.java | 0 .../MessagingOutboxRelayLifecycle.java | 0 ...essagingPlatformRootAutoConfiguration.java | 0 .../MessagingPrefixMigrationValidator.java | 0 .../MessagingProviderSelection.java | 0 .../MessagingPublishConfiguration.java | 0 ...MessagingReliabilityAutoConfiguration.java | 0 .../autoconfigure/MessagingSettings.java | 0 .../MessagingShutdownLifecycle.java | 0 .../MessagingValidationConfiguration.java | 0 .../StartupProfileValidation.java | 0 .../ValidatedDestinationRegistry.java | 0 ...ot.autoconfigure.AutoConfiguration.imports | 0 .../autoconfigure/BrokerAccessListTest.java | 0 .../KafkaProducerConfigTest.java | 0 .../KafkaProducerSecurityTest.java | 0 .../MessagingAutoConfigurationTest.java | 0 .../MessagingConfigurationBindingTest.java | 0 .../MessagingConsumeConfigurationTest.java | 0 .../autoconfigure/MessagingEndpointTest.java | 0 .../MessagingInboxAssemblyTest.java | 0 .../MessagingMigrationNamespaceTest.java | 0 .../MessagingOutboxRelayLifecycleTest.java | 0 ...formAutoConfigurationRegistrationTest.java | 0 .../MessagingShutdownLifecycleTest.java | 0 .../MessagingStarterOffContractTest.java | 0 .../application-invalid-ordering.yml | 0 .../src/test/resources/application-valid.yml | 0 .../messaging/messaging-testkit/build.gradle | 0 .../messaging-testkit/gradle.lockfile | 0 .../testkit/EnvelopeCodecBenchmark.java | 0 .../testkit/BrokerCertificationEvidence.java | 0 .../testkit/BrokerFailureMatrix.java | 0 .../messaging/testkit/CertifiedEvidence.java | 0 .../testkit/CompatibilityMatrix.java | 0 .../messaging/testkit/ContractAssertions.java | 0 .../messaging/testkit/ContractMessage.java | 0 .../messaging/testkit/DockerAvailability.java | 0 .../messaging/testkit/FaultController.java | 0 .../messaging/testkit/HandleOutcome.java | 0 .../testkit/MessagingAdapterContract.java | 0 .../testkit/MessagingAdapterHarness.java | 0 .../testkit/NetworkFaultScenario.java | 0 .../messaging/testkit/ObservedDelivery.java | 0 .../broker-certification-evidence.jsonl | 0 .../testkit/CertifiedEvidenceTest.java | 0 .../testkit/CompatibilityMatrixTest.java | 0 .../testkit/CrossBrokerContractSuite.java | 0 .../testkit/InMemoryHarnessContractTest.java | 0 .../testkit/InMemoryMessagingHarness.java | 0 .../MessagingDocumentationContractTest.java | 0 .../messaging-transport-spi/build.gradle | 0 .../messaging-transport-spi/gradle.lockfile | 0 .../DefaultMessagingRuntimeRegistry.java | 0 .../GracefulShutdownCoordinator.java | 0 .../messaging/transport/MessagingRuntime.java | 0 .../transport/MessagingRuntimeLease.java | 0 .../transport/MessagingRuntimeRegistry.java | 0 .../transport/MessagingTransport.java | 0 .../TransportConsumerRegistration.java | 0 .../transport/TransportConsumerSpec.java | 0 .../transport/TransportDelivery.java | 0 .../transport/TransportPublishRequest.java | 0 .../transport/TransportPublishResult.java | 0 .../transport/TransportSettlement.java | 0 .../transport/GracefulShutdownTest.java | 0 .../MessagingRuntimeRegistryTest.java | 0 .../transport/ResourceLeakGateTest.java | 0 .../optional-build}/README.md | 4 +- .../optional-build}/build.gradle | 4 +- .../optional-build}/gradle.properties | 2 +- .../optional-build}/settings-gradle.lockfile | 0 .../optional-build}/settings.gradle | 8 +- 850 files changed, 271 insertions(+), 180 deletions(-) rename src/{config/messaging => adapter/outbound/messaging/release}/evidence/build-evidence-manifest-v1.schema.json (100%) rename src/{config/messaging => adapter/outbound/messaging/release}/profile-compatibility.yaml (100%) rename src/{config/messaging => adapter/outbound/messaging/release}/readiness-cards.yaml (100%) rename src/{config/messaging => adapter/outbound/messaging/release}/release-profile-assertions.yaml (100%) rename src/{config/jpa => adapter/outbound/persistence-jpa/release}/readiness-cards.yaml (100%) rename src/{config/jpa => adapter/outbound/persistence-jpa/release}/release-registry.json (100%) rename src/{config/mongodb => adapter/outbound/persistence-mongo/release}/release-contracts.json (100%) create mode 100644 src/build-logic/src/main/java/dev/caskeleton/buildlogic/MainBuild.java rename src/{ => platforms}/grpc-advanced/CLAUDE.md (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/build.gradle (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/gradle.lockfile (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/kotlin/GrpcCoroutineContextBridge.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorCancellationBridge.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorContextBridge.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcClient.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProfile.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProxyContract.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebRpcSupport.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcCoroutineContextBridgeTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcWebCompatibilityTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced-compat/src/test/resources/envoy/envoy.yaml (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/build.gradle (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/gradle.lockfile (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapabilityDisabledException.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedFeatureFlags.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuard.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcCapabilityGrade.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsSnapshot.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcCustomResolver.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointCandidate.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointSnapshot.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerDecision.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerPicker.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerSafetyPolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverSafetyPolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverUpdate.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024Policy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026Status.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReport.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEditionCompatibilityReport.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingBudget.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingPolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingResult.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiDirectionState.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiResumeState.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTracker.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSession.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicator.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamCheckpoint.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamMessage.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamResumeDecision.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamSessionId.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamState.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandController.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandDecision.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcManualFlowControlPolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsFailurePolicy.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsProfile.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsResourceSnapshot.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactorIdempotenceTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024PolicyTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReportTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcLoadBalancerSafetyPolicyTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcResolverSafetyPolicyTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcXdsProfileTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTrackerTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicatorTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicyTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandControllerTest.java (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/resources/proto/edition2024/compatibility.proto (100%) rename src/{ => platforms}/grpc-advanced/grpc-advanced/src/test/resources/xds/control-plane-snapshot.json (100%) rename src/{ => platforms}/grpc/CLAUDE.md (94%) rename src/{ => platforms}/grpc/grpc-contract/buf.yaml (85%) rename src/{ => platforms}/grpc/grpc-contract/build.gradle (100%) rename src/{ => platforms}/grpc/grpc-contract/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/error.proto (100%) rename src/{ => platforms}/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/stream.proto (100%) rename src/{ => platforms}/grpc/grpc-contract/src/test/java/dev/caskeleton/grpc/contract/GrpcContractGeneratedCodeTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/build.gradle (100%) rename src/{ => platforms}/grpc/grpc-core-api/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcClaimToken.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcTransportLimits.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcChannelProfileName.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcIdentifiers.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcMethodName.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcServiceName.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcStatusCode.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/RpcType.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcBusinessEvidence.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidence.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcStreamEvidence.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcTransportEvidence.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentityTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedgerContractTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcCoreIdentifiersTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidenceTest.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java (100%) rename src/{ => platforms}/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedger.java (100%) rename src/{ => platforms}/grpc/grpc-observability/build.gradle (100%) rename src/{ => platforms}/grpc/grpc-observability/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcObservationConvention.java (100%) rename src/{ => platforms}/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java (100%) rename src/{ => platforms}/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcStreamObservation.java (100%) rename src/{ => platforms}/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/build.gradle (97%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrations.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedgerContractIT.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V001__create_grpc_operation_ledger.sql (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V002__index_grpc_operation_ledger_finished_rows.sql (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V003__add_grpc_operation_ledger_claim_attempt.sql (100%) rename src/{ => platforms}/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/build.gradle (100%) rename src/{ => platforms}/grpc/grpc-runtime/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcAdminExposurePolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPhase.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainResult.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthState.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshot.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotService.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionAccessDecision.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionMode.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistry.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcCallCredentialProvider.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelDrainPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelGeneration.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelProfileValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntime.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcLoadBalancingPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubDescriptor.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcTypedStubFactory.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextBinder.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextPropagationPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellableOperation.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationReason.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDependencyBudget.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesRoutingMode.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverType.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcStableLoadBalancer.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorExposurePolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcRichErrorDetail.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconciler.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionResolution.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyDecision.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetention.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatus.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcRequestFingerprint.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcCompressionProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcMessageSizeProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcSizeViolation.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcMethodRetryConfig.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryBudget.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryDecision.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyDecision.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcAuthenticationProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialGeneration.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManager.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcTlsProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcAdmissionController.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcExecutorProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyParityContract.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariant.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelector.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcResponseMapper.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorChain.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrder.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorStage.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerProfile.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerTransport.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapterDescriptor.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlDecision.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeDecision.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeToken.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodec.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSlowConsumerPolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelope.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamGapDetector.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamHeartbeat.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamId.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifecycleCoordinator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicy.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamSequence.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamTerminationReason.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriteResult.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriterState.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcTransportValidator.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationViolation.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotServiceTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicyTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistryTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistryTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfileTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetentionTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicyTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManagerTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcTlsProfileTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcAdmissionControllerTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelectorTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrderTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerProfileTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicyTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodecTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelopeTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicyTest.java (100%) rename src/{ => platforms}/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/build.gradle (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformConfigurationException.java (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java (100%) rename src/{ => platforms}/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/build.gradle (100%) rename src/{ => platforms}/grpc/grpc-testkit/gradle.lockfile (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceBudget.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceGate.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceResult.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcEvidenceGrade.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContract.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingContractResult.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingScenario.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcTextCodec.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultPoint.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessContractFixture.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestClient.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestServer.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyContractProfile.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestClient.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestServer.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceGateTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceLaneTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcInProcessContractFixtureTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcNettyContractProfileTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java (95%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContractTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java (100%) rename src/{ => platforms}/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java (100%) rename src/{ => platforms}/messaging/CLAUDE.md (100%) rename src/{ => platforms}/messaging/messaging-admin/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-admin/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminApproval.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationJournal.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationLease.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationRecord.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationState.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalGrant.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalVerifier.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedRedrivePlan.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedReplayPlan.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestinationTopology.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperation.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperationGuard.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/HmacApprovalVerifier.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/PlanDigest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedrivePlan.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveRequest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveResult.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayPlan.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayRequest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayResult.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyIssue.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManagementMode.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManifest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyValidationReport.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/VerifiedApproval.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/BrokerTopologyInspector.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/CompositeTopologyValidator.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DefaultMessagingAdminService.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/InMemoryAdminOperationJournal.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/MessagingAdminService.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveReport.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveService.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayReport.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntime.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidator.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/DestructiveOperationGuardTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/AdminOperationJournalTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovedPlanExecutionTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/RedriveResumptionTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntimeTest.java (100%) rename src/{ => platforms}/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-claim-check/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityException.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuard.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPublisher.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolver.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckStore.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuardTest.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolverTest.java (100%) rename src/{ => platforms}/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckRetentionValidatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-cloudevents/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-cloudevents/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventExtensions.java (100%) rename src/{ => platforms}/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventMapper.java (100%) rename src/{ => platforms}/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/DefaultCloudEventMapper.java (100%) rename src/{ => platforms}/messaging/messaging-cloudevents/src/test/java/dev/caskeleton/messaging/cloudevents/CloudEventMappingTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-core-api/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CausationId.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ContentType.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CorrelationId.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageEnvelope.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageId.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageType.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ProducerId.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/SchemaVersion.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TenantContext.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TraceContext.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/UuidV7.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/WireSafeText.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryContext.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryGuarantee.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryMetadata.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/ExternalSideEffectGuarantee.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/HandleResult.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageDelivery.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageHandler.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/OrderingScope.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/ConfirmationRequirement.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationCapabilities.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationKind.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationName.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessageDestination.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessagingCapabilities.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureCategory.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureDescriptor.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageAuthorizationException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageBackpressureException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagePublishTimeoutException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSchemaIncompatibleException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSerializationException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTooLargeException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTopologyException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageValidationException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingCapabilityUnavailableException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingConfigurationException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingException.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/CanonicalEnvelopeHeaders.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderName.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderValue.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/MessageHeaders.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/ReservedHeaders.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/BrokerPosition.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/ConfirmationLevel.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/MessagePublisher.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishCompletion.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishDeduplication.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishEvidence.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishOptions.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishRequest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishResult.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/RoutingOutcome.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/TransmissionEvidence.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementCompletion.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementEvidence.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementResult.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/BoundedByteSink.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessage.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessagePublisher.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodec.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodecRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageContractKey.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/RawBytesMessageCodec.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibility.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidator.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaReference.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/CoreValueTypesTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/MessageEnvelopeTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/ModuleSmokeTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireBoundaryRejectionTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireSafeValueObjectTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/delivery/ConsumerContractTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/destination/DestinationCapabilityTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/publish/PublishResultTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/BoundedByteSinkTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/RawBytesMessageCodecTest.java (100%) rename src/{ => platforms}/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/build.gradle (97%) rename src/{ => platforms}/messaging/messaging-kafka/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/jmh/java/dev/caskeleton/messaging/kafka/KafkaPublishBenchmark.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTracker.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaBrokerProfile.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaCredentialCallbackHandler.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeadLetterPublisher.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeliveryMapper.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapper.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransport.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaOffsetResetExecutor.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPartitionRetryScheduler.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPosition.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaProfileValidator.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java (97%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishMapper.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayCapability.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlan.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlanner.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryExecutor.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryMetadataMapper.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryOutcome.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryTopicPublisher.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementCommand.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementQueue.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionProfileValidator.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalDelivery.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalOutput.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalProcessor.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalPublisher.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionOffsetTracker.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinator.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/SpringKafkaTransactionalProcessor.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTrackerTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaEnvelopeRoundTripTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapperTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransportTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProducerContractTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProfileValidatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifierTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReplayPlannerTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurerTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionOrderingTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ReservedHeaderForgeryTest.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java (100%) rename src/{ => platforms}/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java (100%) rename src/{ => platforms}/messaging/messaging-observability/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-observability/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/CardinalityGuard.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/DefaultMessagingObservationConvention.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditEvent.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditSink.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingMetrics.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingObservation.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingRedactor.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTags.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTracer.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingMetricCardinalityTest.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingRedactorTest.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingSecretLeakTest.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingTraceLinkTest.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakScannerCharacterizationTest.java (100%) rename src/{ => platforms}/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakStaticScanTest.java (100%) rename src/{ => platforms}/messaging/messaging-policy/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-policy/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ApiTier.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/BackoffCalculator.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ConsumerPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterEnvelopeFactory.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterMetadata.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterOrchestrator.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterResult.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DefaultRetryDecisionEngine.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfile.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/FailureDescriptorDefaults.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/InFlightLimiter.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/OrderingImpact.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadLimitGuard.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PhysicalDestination.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ProducerPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryContext.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecision.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecisionEngine.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryMode.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SchemaPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SourceSettlement.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DeadLetterOrchestratorTest.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/MessagingAdmissionControllerTest.java (100%) rename src/{ => platforms}/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/RetryDecisionEngineTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/ClaimCheckReference.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/InboxRepository.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxCanonicalMetadata.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxLease.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRecord.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxStatus.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxTransitionResult.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/inbox/JdbcInboxRepository.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcAdminOperationJournal.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1005__messaging_outbox_ordering_key_index.sql (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/JdbcInboxTransactionRequirementTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/JdbcOutboxTransactionRequirementTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-reliability/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/IdempotentConsumer.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxCleanupJob.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxMessageHandler.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxOutcome.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxRetentionPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxCleanupJob.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactory.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxProperties.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelay.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayReport.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayWorker.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRetryScheduler.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/IdempotentConsumerTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxMessageHandlerTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxOperationsTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactoryTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java (100%) rename src/{ => platforms}/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayWorkerTest.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DeclaredDestinationAccess.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessor.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DestinationProfileRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecs.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/TransportMessagingRuntime.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessorTest.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisherTest.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecsTest.java (100%) rename src/{ => platforms}/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RuntimeFixtures.java (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityGate.java (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroMessageCodec.java (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroHostileInputTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroRegistryBoundsTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-avro/src/test/resources/schemas/order.created/v1.avsc (100%) rename src/{ => platforms}/messaging/messaging-schema-json/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-schema-json/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-schema-json/src/main/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodec.java (100%) rename src/{ => platforms}/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodecTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JsonContractRegistryTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/PlatformOverheadPerformanceTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-protobuf/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-schema-protobuf/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageCodec.java (100%) rename src/{ => platforms}/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageContract.java (100%) rename src/{ => platforms}/messaging/messaging-schema-protobuf/src/test/java/dev/caskeleton/messaging/schema/protobuf/ProtobufCompatibilityTest.java (100%) rename src/{ => platforms}/messaging/messaging-schema-protobuf/src/test/proto/order_created_v1.proto (100%) rename src/{ => platforms}/messaging/messaging-security/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-security/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerAclManifest.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerCredentialProfile.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerSecurityProfile.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTlsPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTrustStore.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialIds.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialProvider.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRotationPlan.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntime.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessPolicy.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessValidator.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/MessageSecurityValidator.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRotationContractTest.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistryTest.java (100%) rename src/{ => platforms}/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/MessageSecurityValidatorTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerCatalog.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerSettings.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerLifecycle.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantine.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaPolledRegistration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter-kafka/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantineTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/README.md (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingKafkaConsumeQualificationTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingSecuredBrokerQualificationTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSecuritySettings.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSettings.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DestinationSettings.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageConsumers.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageContracts.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminDurabilityValidator.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCredentialRequirementValidator.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpoint.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingObservabilityConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycle.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPrefixMigrationValidator.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPublishConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingReliabilityAutoConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingSettings.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycle.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingValidationConfiguration.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/StartupProfileValidation.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/ValidatedDestinationRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BrokerAccessListTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerConfigTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerSecurityTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfigurationTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpointTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingInboxAssemblyTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformAutoConfigurationRegistrationTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycleTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/resources/application-invalid-ordering.yml (100%) rename src/{ => platforms}/messaging/messaging-spring-boot-starter/src/test/resources/application-valid.yml (100%) rename src/{ => platforms}/messaging/messaging-testkit/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-testkit/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/jmh/java/dev/caskeleton/messaging/testkit/EnvelopeCodecBenchmark.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractAssertions.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractMessage.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/DockerAvailability.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/FaultController.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/HandleOutcome.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterContract.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterHarness.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/NetworkFaultScenario.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ObservedDelivery.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CertifiedEvidenceTest.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CrossBrokerContractSuite.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryHarnessContractTest.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryMessagingHarness.java (100%) rename src/{ => platforms}/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/MessagingDocumentationContractTest.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/build.gradle (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/gradle.lockfile (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/DefaultMessagingRuntimeRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/GracefulShutdownCoordinator.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntime.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeLease.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistry.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingTransport.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerRegistration.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerSpec.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportDelivery.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishRequest.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishResult.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportSettlement.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/GracefulShutdownTest.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistryTest.java (100%) rename src/{ => platforms}/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/ResourceLeakGateTest.java (100%) rename src/{optional-platforms => platforms/optional-build}/README.md (81%) rename src/{optional-platforms => platforms/optional-build}/build.gradle (96%) rename src/{optional-platforms => platforms/optional-build}/gradle.properties (82%) rename src/{optional-platforms => platforms/optional-build}/settings-gradle.lockfile (100%) rename src/{optional-platforms => platforms/optional-build}/settings.gradle (80%) diff --git a/.github/workflows/ci-quality-gates.yml b/.github/workflows/ci-quality-gates.yml index 78568530..6d13fd90 100644 --- a/.github/workflows/ci-quality-gates.yml +++ b/.github/workflows/ci-quality-gates.yml @@ -65,15 +65,15 @@ jobs: - uses: ./.github/actions/setup-gradle-java - name: Verify the optional gRPC platform build working-directory: src - run: ./gradlew -p optional-platforms ci --stacktrace + run: ./gradlew -p platforms/optional-build ci --stacktrace # The optional build's own lane-reachability check: the main build's cannot see these lanes # (review 2026-11-03 RR-06-03). - name: Require every optional-platform strict lane to be in an executed stage working-directory: src - run: ./gradlew -p optional-platforms :verifyStrictLaneStages --dry-run --stacktrace + run: ./gradlew -p platforms/optional-build :verifyStrictLaneStages --dry-run --stacktrace - # gRPC schema policy (owner decision 18). protoc compiles src/grpc/grpc-contract inside the - # optional-platforms build above; lint and breaking-change policy belong to Buf, configured by + # gRPC schema policy (owner decision 18). protoc compiles src/platforms/grpc/grpc-contract inside + # the optional-platforms build above; lint and breaking-change policy belong to Buf, configured by # buf.yaml next to the schema. Buf is a native binary rather than a Maven artifact, so it runs here # and not inside Gradle — and nothing in the repository re-implements its rules. grpc-proto-buf: @@ -88,23 +88,34 @@ jobs: version: 1.73.0 setup_only: true - name: Lint the gRPC schema - working-directory: src/grpc/grpc-contract + working-directory: src/platforms/grpc/grpc-contract run: buf lint - name: Refuse a breaking change to the gRPC schema - working-directory: src/grpc/grpc-contract + working-directory: src/platforms/grpc/grpc-contract env: # Pull request: the target branch. Push: the commit this push replaced. BASELINE: ${{ github.event_name == 'pull_request' && format('origin/{0}', github.base_ref) || github.event.before }} run: | set -euo pipefail baseline_commit="$(git rev-parse --verify --quiet "${BASELINE}^{commit}" || true)" - if [[ -z "${baseline_commit}" ]] \ - || ! git cat-file -e "${baseline_commit}:src/grpc/grpc-contract/buf.yaml" 2>/dev/null; then + # The module moved from src/grpc to src/platforms/grpc on 2026-11-07. A baseline from + # before the move holds it at the old path, and comparing against that path keeps the + # breaking check running across the move instead of skipping it once. + baseline_dir="" + if [[ -n "${baseline_commit}" ]]; then + for candidate in src/platforms/grpc/grpc-contract src/grpc/grpc-contract; do + if git cat-file -e "${baseline_commit}:${candidate}/buf.yaml" 2>/dev/null; then + baseline_dir="${candidate}" + break + fi + done + fi + if [[ -z "${baseline_dir}" ]]; then # The first change that introduces the module has nothing to be compatible with. - echo "::notice::grpc-proto-buf: baseline ${BASELINE} has no src/grpc/grpc-contract/buf.yaml; breaking check skipped." + echo "::notice::grpc-proto-buf: baseline ${BASELINE} has no grpc-contract/buf.yaml; breaking check skipped." exit 0 fi - buf breaking --against "../../../.git#ref=${baseline_commit},subdir=src/grpc/grpc-contract" + buf breaking --against "../../../../.git#ref=${baseline_commit},subdir=${baseline_dir}" release-gate: needs: diff --git a/.github/workflows/integration-main.yml b/.github/workflows/integration-main.yml index e524546c..4c676633 100644 --- a/.github/workflows/integration-main.yml +++ b/.github/workflows/integration-main.yml @@ -207,7 +207,7 @@ jobs: - name: Run every optional-platform performance-category strict lane if: always() working-directory: src - run: ./gradlew -p optional-platforms performanceCheck --continue --stacktrace + run: ./gradlew -p platforms/optional-build performanceCheck --continue --stacktrace - name: Publish the performance lane reports if: always() uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2 @@ -234,7 +234,7 @@ jobs: # `grpc-operation-ledger-jpa:integrationTest`, which certifies the atomic # `INSERT ... ON CONFLICT DO NOTHING` claim that durable mutation idempotency rests on against a # real PostgreSQL. It was registered in Gradle, listed in `strictTestLanes`, and invoked by - # nothing: `-p optional-platforms ci` reaches `checkAll`, `qualityCheck` and the dependency + # nothing: `-p platforms/optional-build ci` reaches `checkAll`, `qualityCheck` and the dependency # verifier, none of which runs a lane whose category is INTEGRATION, and release.yml's gRPC gate # names only the three grpc-testkit lanes. # @@ -250,13 +250,13 @@ jobs: - uses: ./.github/actions/setup-gradle-java - name: Certify the gRPC operation ledger against real PostgreSQL working-directory: src - run: ./gradlew -p optional-platforms integrationCheck --stacktrace + run: ./gradlew -p platforms/optional-build integrationCheck --stacktrace - name: Publish the optional-platform lane reports if: always() uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2 with: name: grpc-optional-platform-integration-reports - path: src/optional-platforms/**/build/reports/tests/ + path: src/platforms/grpc*/**/build/reports/tests/ if-no-files-found: warn # Dynamic half of the compose-profile contract. Every blocking lane the matrix declares runs on diff --git a/.github/workflows/messaging-certification.yml b/.github/workflows/messaging-certification.yml index d20e9ca8..726ba8e8 100644 --- a/.github/workflows/messaging-certification.yml +++ b/.github/workflows/messaging-certification.yml @@ -15,7 +15,7 @@ name: messaging-certification on: pull_request: paths: - - "src/messaging/**" + - "src/platforms/messaging/**" - ".github/workflows/messaging-certification.yml" # Every Gradle job here installs its toolchain through this composite action, so a change to # it changes what this gate runs. @@ -47,5 +47,5 @@ jobs: uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2 with: name: messaging-broker-certification-evidence - path: src/messaging/messaging-kafka/build/messaging-certification/ + path: src/platforms/messaging/messaging-kafka/build/messaging-certification/ if-no-files-found: warn diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index e1c5b2d7..8a0593e4 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -132,7 +132,7 @@ jobs: - uses: ./.github/actions/setup-gradle-java - name: Run the gRPC Stable certification lanes working-directory: src - run: ./gradlew -p optional-platforms releaseCheck --stacktrace + run: ./gradlew -p platforms/optional-build releaseCheck --stacktrace # The operation ledger's real-PostgreSQL lane ran only on main and nightly # (integration-main.yml), so a tag could be cut from a main whose ledger lane was red. It needs # Docker, which a release runner has (review 2026-11-01 03-12). @@ -140,15 +140,15 @@ jobs: working-directory: src env: TESTCONTAINERS_REUSE_ENABLE: "false" - run: ./gradlew -p optional-platforms integrationCheck --stacktrace + run: ./gradlew -p platforms/optional-build integrationCheck --stacktrace - name: Publish the gRPC release evidence if: always() uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2 with: name: grpc-release-evidence path: | - src/grpc/grpc-testkit/build/reports/tests/ - src/grpc/grpc-operation-ledger-jpa/build/reports/tests/ + src/platforms/grpc/grpc-testkit/build/reports/tests/ + src/platforms/grpc/grpc-operation-ledger-jpa/build/reports/tests/ if-no-files-found: warn # Each gate runs as its own single-line `./gradlew ` step so that a failure names the gate @@ -194,7 +194,7 @@ jobs: # docs/jpa/support-matrix.md recorded all three as covered. start() now fails closed on a # multi-version selection, so this matrix is the only way the Stable majors get covered. # - # config/jpa/release-registry.json is the gate-task source: jpaReleaseQualification (persistence-jpa + # persistence-jpa release/release-registry.json is the gate-task source: jpaReleaseQualification (persistence-jpa # build.gradle) depends on its blocking gates, so a gate naming a missing task fails when the task # graph is built, and JpaReleaseRenderingTest holds this matrix and the promotion list below to the # registry's Stable majors. Editing one without the other fails the persistence-jpa unit lane. diff --git a/AGENTS.md b/AGENTS.md index 064de985..63aa22c6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -86,7 +86,7 @@ root `CLAUDE.md`는 작업을 시작할 때 읽는 지도이고, 이 목록을 `releaseCheck`, `qualityCheck`, `configContractCheck`)과 버전/리비전. `verifyStrictLaneStages --dry-run`(PR 게이트)은 그 빌드에서 `explicitOnly`가 아닌 strict lane이 workflow가 실제로 실행하는 단계(main 빌드: `ci`·`mainCheck`·`integrationCheck`·`performanceCheck`· - `releaseCheck`, optional-platforms 빌드: `-p optional-platforms`로 부르는 `ci`·`integrationCheck`· + `releaseCheck`, optional-platforms 빌드: `-p platforms/optional-build`로 부르는 `ci`·`integrationCheck`· `performanceCheck`·`releaseCheck`) 중 하나에 들어 있는지, 그리고 workflow의 접힌(`>`) run 블록이 빈 줄 때문에 옵션을 별개 명령으로 떼어 내지 않는지 검사한다. 두 빌드가 각자 검사를 돌린다. `-x`로 뺀 lane(Gradle처럼 축약 이름도 맞춰 본다)은 덮이지 않는다. Gradle이 작업을 돌리지 않는 명령(`--dry-run`· @@ -232,7 +232,7 @@ cd src ./gradlew mainCheck # main 단계 = env 계약·전체 기동·public path·전송/메시징 레인·leaf 문서 대조 레인·기능 생성 왕복(verifyFeatureScaffold)·테스트 코드 정적 분석(testQualityCheck) ./gradlew integrationCheck # 실제 컨테이너 integration 레인 전체(main·nightly, Docker 필요) ./gradlew performanceCheck # 부하·종료·자원 한계 레인(main·nightly). 상한은 항상 단언, 끄면 실패 -./gradlew verifyStrictLaneStages --dry-run # 이 빌드의 strict lane이 workflow가 실행하는 단계에 속하는지(optional 빌드는 -p optional-platforms로 따로) +./gradlew verifyStrictLaneStages --dry-run # 이 빌드의 strict lane이 workflow가 실행하는 단계에 속하는지(optional 빌드는 -p platforms/optional-build로 따로) ./gradlew verifyPublicPathSnapshot ./gradlew :app-bootstrap:verifyEnvKeys ``` @@ -301,7 +301,7 @@ Docker/runtime 규칙: 1. `src/settings.gradle`의 `rootProject.name`을 새 프로젝트명으로 바꾼다. 2. Java package `dev.caskeleton`을 새 organization/project package로 바꾼다. - gRPC 플랫폼을 쓰면 proto 조직 이름 `caskeleton`(`src/grpc/grpc-contract/src/main/proto/caskeleton/`의 + gRPC 플랫폼을 쓰면 proto 조직 이름 `caskeleton`(`src/platforms/grpc/grpc-contract/src/main/proto/caskeleton/`의 디렉터리, 각 `.proto`의 `package`·`java_package`)도 함께 바꾸고 `buf lint`로 확인한다. 3. `CaSkeletonApplication` 이름을 새 애플리케이션 이름으로 바꾼다. 4. production 모듈에는 목표 도메인의 entity, repository port, use case, adapter만 추가한다. diff --git a/CLAUDE.md b/CLAUDE.md index 97838d8e..89320333 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -54,11 +54,12 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이 ## 5. 코드만 보고는 헷갈리는 곳 +- **최상위 폴더는 정해진 것만 둔다.** 저장소 루트는 `compose.yaml`(개발 환경)·`compose/`(그 보조 파일)·`docs/`·`scripts/`·`src/`(Gradle 루트)다. `src/` 아래는 계층 leaf 폴더, `composition/`(조립), `platforms/`(들여온 제품: `messaging`·`grpc`·`grpc-advanced`와 optional 빌드 `optional-build`), Gradle 루트 표준(`build-logic`·`gradle`·`config`)이다. 테스트 환경 파일은 그 lane을 가진 leaf 안에 둔다. - **leaf 목록은 registry 하나다.** 문서는 leaf 개수를 적지 않는다(적힌 수는 leaf가 늘면 틀린다). runtime membership 목록은 없다. 조립 루트가 받을 수 있는 모듈은 registry의 `allowed_dependencies`가 정하고, 방향 게이트가 그 밖의 edge를 막는다. -- **`src/messaging/*`는 Clean Architecture 계층이 아니다.** 자기 API·SPI·adapter·조립 경계를 가진, 들여온(vendored) 메시징 제품이다. `domain-core`·`application-core`·`shared-contract`에 의존하지 않는다. 이 애플리케이션은 `adapter:outbound:messaging`의 bridge로만 닿는다. 이유와 지역 규칙은 `src/messaging/CLAUDE.md`다. +- **`src/platforms/messaging/*`는 Clean Architecture 계층이 아니다.** 자기 API·SPI·adapter·조립 경계를 가진, 들여온(vendored) 메시징 제품이다. `domain-core`·`application-core`·`shared-contract`에 의존하지 않는다. 이 애플리케이션은 `adapter:outbound:messaging`의 bridge로만 닿는다. 이유와 지역 규칙은 `src/platforms/messaging/CLAUDE.md`다. - **`composition:*` leaf는 조립만 한다.** outbox relay, 멱등성 executor, durable operation처럼 bootstrap에서 떼어 낸 조립이다. 각각 `runtimeOnly` 한 줄로 고른다. - **capability는 한 줄로 켜고 끈다.** 기본 조립은 web inbound, 운영 관측, core들, support·identifier뿐이다. JPA도 `src/app-bootstrap/build.gradle`의 `runtimeOnly` 한 줄로 켠다. 규칙은 `AGENTS.md` 「부가 기능(capability) 모듈 규칙」이다. -- **gRPC 플랫폼 라이브러리는 다른 빌드다.** `src/grpc/*`·`src/grpc-advanced/*`(registry의 `"build": "optional-grpc"`)는 `-p optional-platforms`로 돈다. `adapter:inbound:grpc`는 애플리케이션 adapter라 주 빌드에 있다. +- **gRPC 플랫폼 라이브러리는 다른 빌드다.** `src/platforms/grpc/*`·`src/platforms/grpc-advanced/*`(registry의 `"build": "optional-grpc"`)는 `-p platforms/optional-build`로 돈다. `adapter:inbound:grpc`는 애플리케이션 adapter라 주 빌드에 있다. - **새 기능의 예시는 `scripts/new-feature.sh`의 출력이다.** 샘플 모듈은 2026-11-07에 지웠다. 기법 예시는 `docs/manual/`이 실제 코드(fileserver, durable operation)를 가리킨다. - **성능 lane에는 단언을 끄는 스위치가 없다.** convention이 상한을 매번 단언하고, `performance.assertions.enabled`에 `true` 아닌 값이 들어오거나 skip이 있으면 테스트 전에 실패한다. 손으로 돌리든 workflow든 같다(`AGENTS.md` 「Gradle 정책 권위」). - **저장소 파일을 읽는 테스트는 태그가 있다.** 문서와 대조하는 테스트는 `document-contract`(main 단계 `mainCheck`), 빌드 스크립트·workflow를 읽는 테스트는 `repository-contract`(PR)다. 문서를 고치면 그 문서를 읽는 테스트를 찾는다. diff --git a/docs/jpa/repository-adaptation.md b/docs/jpa/repository-adaptation.md index 38e6f1bb..1da52e12 100644 --- a/docs/jpa/repository-adaptation.md +++ b/docs/jpa/repository-adaptation.md @@ -102,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/` | 2026-11-07에 지웠다(쓰는 곳이 없거나 운영 인프라 파일). 운영 DB 조건은 `docs/jpa/security.md`로 옮겼다. | | `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 | `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. | | +| release blocking aggregate | `jpaReleaseQualification` (persistence-jpa `build.gradle`) over `persistence-jpa/release/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". | diff --git a/docs/jpa/support-matrix.md b/docs/jpa/support-matrix.md index 793821bf..258fa1fa 100644 --- a/docs/jpa/support-matrix.md +++ b/docs/jpa/support-matrix.md @@ -1,7 +1,7 @@ # JPA Persistence Platform — Support Matrix **This document is a rendering. The machine-readable source is -[`src/config/jpa/release-registry.json`](../../src/config/jpa/release-registry.json).** +[`src/adapter/outbound/persistence-jpa/release/release-registry.json`](../../src/adapter/outbound/persistence-jpa/release/release-registry.json).** `JpaReleaseManifest` used to parse this file with regular expressions: every `PostgreSQL NN` it mentioned became a supported version, whatever table or sentence produced the match. An Experimental diff --git a/docs/messaging/support-matrix.md b/docs/messaging/support-matrix.md index bd3164cd..1a2e72c9 100644 --- a/docs/messaging/support-matrix.md +++ b/docs/messaging/support-matrix.md @@ -27,7 +27,7 @@ > `modules.json`은 messaging leaf의 `gradle_path`와 허용 의존성을 관리하지만 > `runtime_memberships` 필드는 없다. 실제 런타임 편입은 `app-bootstrap`의 Gradle 의존성과 starter / > auto-configuration 경로가 결정한다. 아래 등급은 "무엇이 증명되었는가"를 말하며 런타임 편입 여부와 -> 같은 축이 아니다. 자세한 composition/cutover 상태는 `src/messaging/CLAUDE.md`가 소유한다. +> 같은 축이 아니다. 자세한 composition/cutover 상태는 `src/platforms/messaging/CLAUDE.md`가 소유한다. ## 브로커 등급 diff --git a/docs/mongodb/advanced/sharding.md b/docs/mongodb/advanced/sharding.md index 2987a243..2f308936 100644 --- a/docs/mongodb/advanced/sharding.md +++ b/docs/mongodb/advanced/sharding.md @@ -13,7 +13,7 @@ enables the capability; construction is refused otherwise. | Topology | A real sharded cluster. A replica set cannot exercise routing. | | Server | MongoDB 7.0 or 8.0. | | Privilege | `MongoPrincipalRole.SHARD_ADMIN` for the admin plane; the application role is unchanged. | -| Gate | **Not promoted.** No `mongoShardedTest` lane is registered, and a sharded cluster is not an environment this repository stands up. Listed under `experimental_contracts` in `src/config/mongodb/release-contracts.json`; promoting it needs the lane, its required class, and protected-environment evidence to exist first. | +| Gate | **Not promoted.** No `mongoShardedTest` lane is registered, and a sharded cluster is not an environment this repository stands up. Listed under `experimental_contracts` in `src/adapter/outbound/persistence-mongo/release/release-contracts.json`; promoting it needs the lane, its required class, and protected-environment evidence to exist first. | ## Shard key diff --git a/docs/roadmap/messaging-r2.md b/docs/roadmap/messaging-r2.md index 40d88248..c463d1b7 100644 --- a/docs/roadmap/messaging-r2.md +++ b/docs/roadmap/messaging-r2.md @@ -10,7 +10,7 @@ - 대응하는 Test 태스크 없음 - 공통 스키마 validator 없음 -따라서 `config/messaging/readiness-cards.yaml`의 카드는 모두 `maturity: not-implemented`다. +따라서 `src/adapter/outbound/messaging/release/readiness-cards.yaml`의 카드는 모두 `maturity: not-implemented`다. 유일하게 `implemented-candidate`였던 `json-schema-envelope.v1`은 그 구현(adapter messaging의 `JsonSchemaIntegrationEventEncoder`와 `verifyMessagingJsonSchemaV1`)을 2026-09-25에 삭제하면서 `not-implemented`로 내렸다. 남은 evidence producer는 `verifyMessagingContracts` 하나다. @@ -41,7 +41,7 @@ verifyMessagingTargetBindingPreflight 1. 각 시나리오를 실제로 실행하는 Test 태스크. 2. 그 실행 결과(JUnit XML)에서 payload-free manifest를 만드는 producer. -3. `config/messaging/evidence/build-evidence-manifest-v1.schema.json`으로 그 manifest 바이트를 +3. `src/adapter/outbound/messaging/release/evidence/build-evidence-manifest-v1.schema.json`으로 그 manifest 바이트를 검증하는 단계(build-tools `VerifyMessagingEvidenceTask`가 쓰고 바로 검증한다). 4. 위 셋이 모두 생긴 다음에 `verifyMessagingR2` 태스크 등록. diff --git a/docs/runbooks/migration-failed.md b/docs/runbooks/migration-failed.md index a69f2c86..601f96a6 100644 --- a/docs/runbooks/migration-failed.md +++ b/docs/runbooks/migration-failed.md @@ -22,7 +22,7 @@ status: active 1. Stop rollout and keep the failed revision out of readiness. Do not route traffic to a partially migrated instance. -2. Identify the exact stream from `src/config/jpa/readiness-cards.yaml`. Each stream has an +2. Identify the exact stream from `src/adapter/outbound/persistence-jpa/release/readiness-cards.yaml`. Each stream has an independent `location` and `history-table`; do not infer ownership from a broad `classpath:db/migration` scan. 3. From a privileged migration session, capture the stream state before changing anything: diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index 431c7a86..cbf54325 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -64,7 +64,7 @@ | B-09 | `SecuritySettings`(adapter:inbound:web): `audience`가 `String` → `List`. `@ConfigurationProperties` 제거, `SecuritySettings.bind(Environment)`로 strict 바인딩. 생성자 `(String, String, List)` → `(String, List, List)`. `bootstrap.security.AuthenticationModeSettings` 삭제 | `audience()`를 문자열로 쓰는 코드, 직접 생성하는 테스트 컴파일 오류 | `List`으로 바꾼다. 인증 모드는 `SecuritySettings.authMode()`에서 읽는다 | `34565130`(List), `5786126c`(strict·삭제) · `src/adapter/inbound/web/.../settings/SecuritySettings.java` | | B-10 | adapter 공개 타입 삭제·이동: graphql `execution.GraphQlTimeoutPolicy`·`dataloader.GraphQlDataLoaderRequestRegistry` 삭제(`runtime.GraphQlDeadlineInstrumentation`·`GraphQlPerParentFetchInstrumentation` 추가). jpa `experimental.tenant.TenantId` 삭제 → `dev.caskeleton.application.tenant.TenantId`. persistence-notification의 엔티티는 `...platform.entity`, 저장소는 `...platform.repository`로 이동, `inbox` 하위 클래스는 `platform`으로 올라옴, `PreferenceJpaRepository`·`SuppressionJpaRepository` 삭제, `JpaNotificationSideEffect` → application-notification `dispatch.SuppressionSideEffect`. graphql `GraphQlClientPolicy.effectivePageSize(Integer, Integer)` 삭제 → `pagination.GraphQlConnectionPolicy.effectivePageSize`(상한 검사 포함, 재리뷰 RR-01-14). grpc(optional-platforms) `GrpcOperationLedger.release(identity)` → `boolean release(identity, GrpcClaimToken)`: 진행 중이고 그 token이 가진 claim만 지운다(RR-01-15) | import 실패, 호출부·직접 구현한 ledger 컴파일 오류. leaf `check`의 API surface 비교가 스냅샷과 달라 실패(자기 공개 타입을 더했다면 merge 충돌) | import를 바꾼다. 스냅샷 파일은 upstream 것을 받고 자기 추가분을 다시 승인한다 | `1400dc15`·`5786126c` · `docs/architecture/graphql-api-surface.txt`, `docs/architecture/jpa-api-surface.txt`(166→165), `docs/notification/api-surface-snapshot.txt`(362→364) | | B-11 | 조립·지원 타입: `bootstrap.autoconfigure.operation.DurableOperationConfig` → `composition:durable-operation`의 `composition.operation.DurableOperationAutoConfiguration`. `bootstrap.settings.LoggingSettings` 삭제. `composition.outbox.OutboxLeaderElectionToken` 삭제. `TracingSamplingEnvironmentPostProcessor` → `TracingEnvironmentPostProcessor`, `StartupOrder.TRACING_SAMPLING` → `TRACING_PROPERTIES`. `StartupRuleRunner(Environment, List)` → `StartupRuleRunner(Environment)`. `SecretSourceValidator(ConfigurableEnvironment, SecretSourcePort, List)` → `SecretSourceValidator(Supplier>)` | 이 타입을 참조하는 코드·테스트 컴파일 오류 | 새 이름으로 바꾼다 | `1400dc15`, `34565130`, `bbe944bd` · `src/composition/durable-operation/`, `src/adapter/outbound/support/.../startup/` | -| B-39 | vendored messaging SPI `KafkaQuarantinePublisher`(`messaging-kafka`): `quarantine(ConsumerRecord, Throwable)` → `quarantine(ConsumerRecord, FailureCategory category, Throwable reason)`. 호출자가 격리 이유(읽을 수 없는 레코드 `DESERIALIZATION`, 시도 예산 소진은 실패의 category 또는 `POISON_MESSAGE`)를 넘기고, 구현은 그것을 `msg.failure-category` header로 쓴다 | 이 SPI를 직접 구현한 서비스는 `does not override abstract method` 컴파일 오류. 람다로 만든 것도 인자 수 오류 | 세 인자 메서드로 고친다. category를 header나 저장소에 그대로 남겨야 redrive가 두 경우를 가른다(템플릿 `KafkaDeadLetterQuarantine`, 테스트 `KafkaDeadLetterQuarantineTest`) | `bbe944bd`(리뷰 06-14), 3차 수정에서 목록에 추가(재리뷰 2차 RR-02-16) · `src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java` | +| B-39 | vendored messaging SPI `KafkaQuarantinePublisher`(`messaging-kafka`): `quarantine(ConsumerRecord, Throwable)` → `quarantine(ConsumerRecord, FailureCategory category, Throwable reason)`. 호출자가 격리 이유(읽을 수 없는 레코드 `DESERIALIZATION`, 시도 예산 소진은 실패의 category 또는 `POISON_MESSAGE`)를 넘기고, 구현은 그것을 `msg.failure-category` header로 쓴다 | 이 SPI를 직접 구현한 서비스는 `does not override abstract method` 컴파일 오류. 람다로 만든 것도 인자 수 오류 | 세 인자 메서드로 고친다. category를 header나 저장소에 그대로 남겨야 redrive가 두 경우를 가른다(템플릿 `KafkaDeadLetterQuarantine`, 테스트 `KafkaDeadLetterQuarantineTest`) | `bbe944bd`(리뷰 06-14), 3차 수정에서 목록에 추가(재리뷰 2차 RR-02-16) · `src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java` | | B-41 | enum 값 추가: `IdempotencyStartOutcome.LEASE_EXPIRED`, `IdempotencyRenewOutcome.LEASE_EXPIRED`(둘 다 `carriesOwner()`=false). 주인이 아직 기록을 가졌지만 processing lease가 끝나 시작·renew를 거절한다는 뜻이다. 전에는 PostgreSQL이 둘 다 `NOT_OWNER`, Redis가 renew는 `NOT_OWNER`·시작은 `STARTED`였다 | `default` 없는 switch 식이 "does not cover all possible input values" 컴파일 오류. 직접 구현한 store는 `IdempotencyStoreContract`의 새 시간 케이스(lease 지난 시작·renew)에서 실패 | 새 값 분기를 더한다. `LEASE_EXPIRED`를 `NOT_OWNER`처럼 "기록을 잃었다"로 읽지 않는다 — 실행 중이면 주인은 여전히 `complete`·`markFailed` 한다. store는 lease가 끝난 시작·renew에 이 값을 돌려준다 | r9(재리뷰 README 15 남음, RR5-01-02) · `src/application-core/.../idempotency/IdempotencyStartOutcome.java`, `IdempotencyRenewOutcome.java`, `src/application-core/src/testFixtures/.../IdempotencyStoreContract.java` | ### 3.2 설정·기동 — 기동이 실패하거나 런타임 예외가 난다 @@ -77,7 +77,7 @@ | B-15 | 기동 rule이 모든 singleton보다 먼저 돈다(`StartupRuleRunner`가 `BeanFactoryPostProcessor`). `StartupRule`과 `RequiredProductionSecrets` bean은 `static @Bean`이고 `Environment`, bean factory, static 무인자 `RequiredProductionSecrets`의 `ObjectProvider`만 받아야 한다. 두 타입의 클래스는 `@Value`·`@Autowired`·`@Inject`·`@Resource` 멤버, `@PostConstruct`·`@PreDestroy`, `@ConfigurationProperties`를 가질 수 없다(post-processor보다 먼저 만들어져 비어 있게 된다, RR2-04-03) | non-static `@Bean`이거나 다른 bean을 받으면 기동 실패 `startup rule or secret list '<이름>' created [] while creating it ... Declare the rule with a static @Bean method ...`, 위 멤버가 있으면 `'<이름>' (...) is a StartupRule or RequiredProductionSecrets ... but it needs one: [...]`(둘 다 exit 78, 둘 다 모든 프로필. runner가 rule과 비밀 목록을 프로필과 무관하게 먼저 만들어, 인터페이스 타입 `@Bean`이 돌려준 실제 클래스까지 본다, RR3-04-01) | rule 선언을 `static`으로, 인자를 위 셋으로 줄인다. 값은 `violations(Environment)`가 받는 `Environment`에서 읽는다. 다른 bean이 필요한 검사는 rule이 아니라 일반 bean으로 둔다 | `34565130`, `bbe944bd` · `src/adapter/outbound/support/.../startup/StartupRule.java`, `StartupRuleRunner.java` | | B-16 | 권한 가드(새 `PermissionEnforcementGuard`): `@SystemInvoked` 유스케이스가 bean이면 기동 실패. `@RequiresPermission`을 단 bean에 적용되는 advisor가 없어도 기동 실패. ArchUnit `SYSTEM_INVOKED_USE_CASES_DECLARE_NO_PERMISSION`, `ONLY_SYSTEM_CALLERS_REACH_SYSTEM_INVOKED_USE_CASES`, `SYSTEM_CALLERS_ARE_SYSTEM_DRIVEN_INBOUND_ADAPTERS`, `USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS`, `SYSTEM_CALLERS_HAVE_ONLY_PROJECT_SUPERTYPES` 추가, 새 표시 `@SystemCaller` | 기동 실패 `@SystemInvoked use cases are registered as beans ...` 또는 `beans declare @RequiresPermission but no advisor enforces it ...`(exit 72). `@SystemCaller`가 아닌 inbound adapter가 그 유스케이스를 부르거나, 사용자 전송(controller 등)이 `@SystemCaller` bean을 직접·중간 클래스를 거쳐·그 작업이 구현하는 프로젝트 인터페이스로 부르면 architectureTest 실패. `@SystemCaller` 클래스가 `Runnable`·`ApplicationRunner` 같은 프로젝트 밖 타입을 구현·상속해도 실패. 설정(`@Configuration`)은 웹 bean(`WebMvcConfigurer`·CORS 설정·controller bean)과 handler bean을 함께 등록해도 사용자 전송으로 세지 않지만, 요청 처리기 타입(함수형 route·data fetcher·interceptor)에 의존하면 사용자 전송으로 센다. 처리 코드를 설정에 직접 쓰든, 다른 클래스의 메서드를 참조해 등록만 하든 같다. 설정 안에 중첩된 클래스는 설정용 타입(configurer·registry·CORS 설정·`RequestMethod`)에만 의존할 때를 빼고 다른 클래스처럼 사용자 전송 타입으로 판정한다(중첩된 JAX-RS 자원·`@ServerEndpoint`도 잡힌다). STOMP inbound channel interceptor(`ChannelInterceptor`·`ExecutorChannelInterceptor`)도 사용자 전송 타입이자 요청 처리기 타입이다. 사용자 전송 패키지 밖에 둔 interceptor, 설정에 중첩한 interceptor(익명 클래스 포함), interceptor를 구현한 설정이 `@SystemCaller`에 닿거나, interceptor를 `@Bean`으로 내놓는 설정이 `@SystemCaller` bean도 만들면 실패한다(2026-11-07 전에는 STOMP 헤더 타입을 읽는 interceptor만 잡혔다). record·enum이 언어로 받는 상위 타입(`Record`·`Enum` 등)과 예외 클래스는 프로젝트 밖 상위 타입으로 세지 않는다 | 시스템만 부르는 쓰기 유스케이스는 composition에서 `new`로 만들어 스케줄러에 넘기거나, 메시지 handler·예약 작업이면 그 클래스에 `@SystemCaller`를 달고 생성자에서 `new`로 만든다. 예약 작업은 서비스 leaf의 `..adapter.inbound.scheduler..` 패키지에 둔다. 세 경로와 두는 곳은 매뉴얼 07장 「시스템이 부르는 쓰기」(handler 작업 순서는 09장 「소비」 4단계). "지금 실행" endpoint가 필요하면 `@RequiresPermission` 유스케이스를 따로 만든다. 작업을 task scheduler에 직접 등록하던 코드는 작업이 `Runnable`을 구현하는 대신 등록하는 곳에서 `job::run`을 넘긴다. route·data fetcher·interceptor 등록은 handler bean을 만드는 설정과 다른 설정에 둔다. STOMP channel interceptor 등록도 같다. `@RequiresPermission`을 쓰면 web adapter(`MethodSecurityConfig`)가 조립돼 있어야 한다 | `1400dc15`, `bbe944bd`, r9 · `src/composition/service-runtime/.../authorization/PermissionEnforcementGuard.java`, `src/application-core/.../security/SystemInvoked.java`, `SystemCaller.java` | | B-17 | `IntegrationEventDraft`: `eventId`·`causationId`는 소문자 UUIDv7만. ArchUnit `INTEGRATION_EVENT_DRAFTS_ARE_BUILT_BY_THE_SHARED_HELPER`: `new IntegrationEventDraft<>(...)` 금지, `IntegrationEventDrafts.draft(...)`만 | 이벤트를 만드는 쓰기 요청이 `IllegalArgumentException: eventId must be a canonical lower-case UUIDv7...`로 실패. architectureTest 실패 | event id를 UUIDv7로 만든다(예: sample `UuidOutboxEventIdFactory`가 `UuidCreator.getTimeOrderedEpochPlus1()`). draft는 헬퍼로 만든다. tenant가 없는 이벤트는 `IntegrationEventDrafts.SINGLE_TENANT_SCOPE`(`global`) | `1400dc15`, `bbe944bd` · `src/application-core/.../messaging/event/IntegrationEventDraft.java`, `IntegrationEventDrafts.java` | -| B-18 | `MessageHandler.schemaVersions()`(vendored `messaging-core-api`, default `{v1}`): 소비자 decode 목록을 handler 선언으로 만든다. 같은 (메시지 타입, 버전)에 다른 payload class를 선언하면 실패 | 컴파일은 된다. v1이 아닌 메시지는 `SCHEMA_VERSION_NOT_REGISTERED`로 거부. 발행 등록(`MessageContracts`)과 class가 다르면 기동 실패 `MESSAGING_CONTRACT_CONFLICT` | v2 이상을 읽는 handler는 `schemaVersions()`를 override한다. 소비 타입을 `MessageContracts`에 따로 등록하던 코드는 지운다 | `5786126c` · `src/messaging/messaging-core-api/.../delivery/MessageHandler.java`, `messaging-spring-boot-starter/.../MessageContracts.java` | +| B-18 | `MessageHandler.schemaVersions()`(vendored `messaging-core-api`, default `{v1}`): 소비자 decode 목록을 handler 선언으로 만든다. 같은 (메시지 타입, 버전)에 다른 payload class를 선언하면 실패 | 컴파일은 된다. v1이 아닌 메시지는 `SCHEMA_VERSION_NOT_REGISTERED`로 거부. 발행 등록(`MessageContracts`)과 class가 다르면 기동 실패 `MESSAGING_CONTRACT_CONFLICT` | v2 이상을 읽는 handler는 `schemaVersions()`를 override한다. 소비 타입을 `MessageContracts`에 따로 등록하던 코드는 지운다 | `5786126c` · `src/platforms/messaging/messaging-core-api/.../delivery/MessageHandler.java`, `messaging-spring-boot-starter/.../MessageContracts.java` | | B-19 | `APP_FLYWAY_ENABLED`가 모든 프로필에서 읽힌다. dev·prod 프로필 파일의 `spring.flyway.enabled: true`·`app.persistence.vendor` 고정값을 지우고 persistence-jpa `config/module-defaults`가 `${APP_FLYWAY_ENABLED:true}`를 싣는다 | dev·prod 환경에 `APP_FLYWAY_ENABLED=false`가 있으면 전에는 무시됐지만 이제 기동 때 마이그레이션이 안 돈다 | dev·prod 환경 값을 확인한다. 자기 `application-dev.yml`·`application-prod.yml`에 같은 고정값을 다시 넣지 않는다 | `5786126c` · `src/app-bootstrap/src/main/resources/application-{dev,prod}.yml`, `src/adapter/outbound/persistence-jpa/.../module-defaults/persistence-jpa.yml` | | B-20 | JDBC batch 기본 켜짐: `APP_JPA_HIBERNATE_BATCH_SIZE` 0→50, `APP_JPA_HIBERNATE_ORDER_INSERTS`·`ORDER_UPDATES` false→true(registry `compatibility_impact: behavior-change`) | 컴파일·기동은 그대로. SQL이 묶여 나가고 insert·update 순서가 바뀐다. IDENTITY 키 엔티티는 batch가 조용히 꺼진다. `.env`에 옛 값(0·false)이 있으면 새 기본값이 안 먹는다 | 문장 순서에 기대는 코드가 있는지 본다. 끄려면 0·false를 명시 | `1400dc15` · `persistence-jpa.yml`, `docs/registries/env-keys.yaml` | | B-21 | 트랜잭션 제한: `TransactionPort` 쓰기·읽기 트랜잭션 30초(`app.persistence-jpa.transaction.write-timeout`·`read-timeout`, env 키 아님) | 30초를 넘는 트랜잭션은 문장이 취소되고 `DB_QUERY_CANCELED`로 실패 | 긴 일괄 작업은 쪼갠다. 꼭 필요하면 프로필 yml에서 값을 올린다 | `1400dc15` · `persistence-jpa.yml` | @@ -134,6 +134,7 @@ | B-49 | 샘플 모듈 삭제: `src/sample-portfolio`, `src/Dockerfile.sample`, registry `sample-portfolio` 행, 루트 `build.gradle`의 샘플 태스크·단계(`sampleWebContractCheck`, `:sample-portfolio:*` 의존, strict lane 단계 `:sample-portfolio:check`), `ci-quality-gates.yml`의 `sample-portfolio` job, `SampleRuntimeDefaultsContractTest`, spotbugs 제외의 샘플 클래스. 샘플에만 있던 검사(OpenAPI 스냅숏 `openapiCheckSnapshot`, Date 헤더, 가상 스레드 MDC 전파)도 함께 없어졌다 | 샘플을 고쳐 쓰던 서비스: 병합 때 "수정 대 삭제" 충돌. 샘플을 이미 지운 서비스: 충돌 없음 | 샘플을 이미 지웠으면 할 일 없음. 고쳐 쓰고 있으면 자기 leaf로 옮기고 registry 행·빌드 줄을 자기 것으로 둔다. 위 검사가 필요하면 자기 기능 leaf에 둔다 | `ab5982e9` | | B-50 | `infra/`에서 15개 삭제. 쓰는 곳이 없던 12개(`infra/httpclient/**`, `infra/jpa/postgres/README.md`, `infra/jpa/toxiproxy/`, `infra/messaging/{kafka,postgres,toxiproxy,tls}/`, `infra/notification/toxiproxy/`)와 운영 인프라 셋(`infra/fileserver/nginx/nginx.conf`, `infra/fileserver/kubernetes/pvc-certification-job.yaml`, `infra/jpa/roles/runtime-roles.sql`). `release.yml`의 `fileserver-pvc-certification` job도 지웠고, fileserver 지원 표에서 "Kubernetes ReadWriteOnce PVC — Limited" 주장을 「주장하지 않음」으로 옮겼다 | 그 파일을 배포에 쓰던 서비스: 병합이 파일을 지운다. 고쳐 쓰던 서비스: "수정 대 삭제" 충돌 | 그 파일은 자기 인프라 repo로 옮긴다. 지켜야 할 조건은 `docs/fileserver/operations.md` 「운영 환경이 지켜야 할 조건」, `docs/fileserver/storage-certification.md`, `docs/jpa/security.md` 「역할과 권한」·「서버 설정」에 있다 | 커밋 「쓰지 않는 파일과 운영 인프라 파일을 지운다」 | | B-51 | compose 정리. 루트 `docker-compose.yml`·`docker-compose.local.yml`·`docker-compose.infra.yml`을 개발 환경 `compose.yaml` 하나로 합쳤다(app은 `local` 런타임, 뒷단 서비스는 capability profile `jpa`·`redis`·`kafka`·`mongo`·`objectstorage`·`auth`·`mail`). 보조 파일은 `compose/`(keycloak realm·entrypoint, minio init, Redis ACL, mailpit 인증서 폴더). 테스트 lane fixture는 그 lane을 가진 leaf로 옮겼다: `docker-compose.dev.yml`·`docker-compose.prod-smoke.yml`·`docker-compose.tls.yml`·fileserver overlay·smoke 스크립트·스키마 적용 스크립트·lane 계약 JSON(`src/config/runtime/compose-profile-contracts.json`) → `src/app-bootstrap/compose-lanes/`, Redis topology compose → `src/adapter/outbound/redis-sdk/compose/`, NFS compose → `src/adapter/outbound/fileserver/compose/nfs/`. `infra/`는 없어졌다. lane 계약의 `composeProfile`(문자열)은 `composeProfiles`(목록)로 바뀌었고 `appMemoryLimit`이 생겼다. smoke는 lane 중 컨테이너가 재시작하거나 메모리로 죽으면 실패한다. `scripts/bootstrap-local.sh`는 인자를 받지 않는다 | `docker compose -f docker-compose.yml -f docker-compose.local.yml …`을 쓰던 스크립트·문서가 "no such file"로 실패. 옛 compose 파일에 서비스를 더했으면 수정 대 삭제 충돌. lane 계약을 고쳐 쓰던 서비스는 `composeProfile` 키를 smoke 스크립트가 읽지 않는다 | 명령을 `docker compose …`(루트 `compose.yaml`)와 profile로 바꾼다. 더한 서비스는 `compose.yaml`에 capability profile을 달아 옮기고, lane 전용이면 `src/app-bootstrap/compose-lanes/lane-services.yaml`에 둔다. 경로를 적은 workflow·문서를 위 새 경로로 고친다 | 커밋 「compose 파일을 개발 환경 하나와 lane fixture로 나눈다」 | +| B-52 | `src/` 배치 정리. 들여온 플랫폼 넷을 `src/platforms/` 아래로 옮겼다: `src/messaging` → `src/platforms/messaging`, `src/grpc` → `src/platforms/grpc`, `src/grpc-advanced` → `src/platforms/grpc-advanced`, `src/optional-platforms` → `src/platforms/optional-build`(빌드 이름 `optional-platforms`는 그대로). registry `source_path`만 바뀌고 Gradle 경로(`:messaging:*`, `:grpc:*`)는 그대로다. optional 빌드는 `./gradlew -p platforms/optional-build …`로 부른다. `src/config/`에서 기능 하나가 주인인 데이터를 그 leaf의 `release/`로 옮겼다: `config/jpa/*` → `adapter/outbound/persistence-jpa/release/`, `config/messaging/**` → `adapter/outbound/messaging/release/`, `config/mongodb/release-contracts.json` → `adapter/outbound/persistence-mongo/release/` | `-p optional-platforms`를 부르는 workflow·스크립트가 "Project directory … does not exist"로 실패. 옮긴 폴더를 고쳐 쓰던 서비스는 이름 바뀜 충돌(Git이 이동으로 알아보면 자동 병합). `rootProject.file('config/jpa/…')`처럼 옛 경로를 읽던 자기 빌드 줄은 파일 없음 | workflow·스크립트의 `-p`와 경로를 새 위치로 고친다. 자기 leaf를 `src/messaging` 아래에 더했다면 `src/platforms/messaging` 아래로 옮기고 registry `source_path`를 고친다 | 커밋 「들여온 플랫폼을 src/platforms 아래로 묶는다」 | ## 4. DB 마이그레이션 diff --git a/docs/work/delegate.md b/docs/work/delegate.md index 4a83e6ca..ded7c1bd 100644 --- a/docs/work/delegate.md +++ b/docs/work/delegate.md @@ -49,10 +49,10 @@ design-docs `conventions/delegation-loop.md` 3절 순서대로 한다: 크기 | 영역 | 경로 | | --- | --- | | core·application | `src/domain-core`, `src/application-*`, `src/shared-contract` | -| inbound 전송 | `src/adapter/inbound/*`, `src/grpc/*`·`src/grpc-advanced/*`(optional 빌드) | +| inbound 전송 | `src/adapter/inbound/*`, `src/platforms/grpc/*`·`src/platforms/grpc-advanced/*`(optional 빌드) | | persistence | `src/adapter/outbound/persistence-*`, 마이그레이션 | | outbound capability | 그 밖의 `src/adapter/outbound/*`, 멱등성 store | -| messaging | `src/messaging/*`, `src/adapter/outbound/messaging` | +| messaging | `src/platforms/messaging/*`, `src/adapter/outbound/messaging` | | bootstrap·build·CI | `src/app-bootstrap`, `src/composition/*`, `src/build-logic`, `src/build.gradle`, `.github/` | | 보안(영역을 가로질러) | 인증·인가 체인, 비밀, 공개 경로 | | 문서 | `docs/` | diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index 2872e0dd..bd60ed44 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -74,6 +74,7 @@ | 생성 명령 | JPA adapter를 만들지 않음(서비스 전용 persistence leaf가 기본), 생성된 쓰기 API는 역할 매핑 전 403 | 위임 | `1101` 15절(r2-10) | | `@SystemInvoked` | bean으로 등록돼 있으면 기동 실패, inbound adapter가 직접 부르지 못하게 ArchUnit | 위임 | `1103` 4절(RR-01-02) | | 시스템 호출 경로 | 사용자가 닿는 전송(web·GraphQL·gRPC·WebSocket)만 `@SystemInvoked`에 닿지 못한다. 메시지 소비자·스케줄러는 `@SystemCaller(reason)` 표시로 허용 | 위임 | `1103` 9.1절(RR-01-12), 10절 r5-b | +| `src/` 배치 | 들여온 플랫폼 넷(`messaging`, `grpc`, `grpc-advanced`, optional 빌드)을 `src/platforms/` 아래로 묶는다. registry `source_path`만 바꾸고 Gradle 경로는 그대로 둔다. `build-logic`·`gradle`·`config`는 Gradle 루트 표준이라 남기고, `composition`은 조립 계층이라 옮기지 않는다. `config/`에서 기능 하나가 주인인 데이터 파일은 그 leaf로 보낸다. Gradle 루트를 저장소 루트로 옮길지는 CI 재편 때 다시 본다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.1절 | | 개발 compose 파일 | 저장소 루트에 `compose.yaml` 하나. 뒷단 서비스는 capability 이름 profile로 고르고, 마운트하는 보조 파일은 `compose/`에 둔다. 테스트 lane fixture는 그 lane을 가진 leaf로 보낸다(compose lane → app-bootstrap `compose-lanes/`, Redis topology → redis-sdk, NFS → fileserver). `docker-compose.dev.yml`은 `dev` 배포 프로필이 뜨는지 보는 lane fixture로 app-bootstrap에 둔다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 | | 인프라 실행 파일 | nginx 설정, Kubernetes PVC job, DB 역할 SQL은 이 repo에서 지우고, 기능이 운영 환경에 요구하는 조건만 그 기능 문서에 적는다. 아무도 쓰지 않는 `infra/` 파일도 지운다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 | | 샘플 모듈 | `src/sample-portfolio`와 `src/Dockerfile.sample`을 폴더째 지운다. 역할은 옮기지 않는다. 샘플 안에만 있던 템플릿 검사(OpenAPI 스냅숏, Date 헤더, 가상 스레드 MDC)도 함께 지운다. 예시는 매뉴얼과 생성 명령 출력이 맡는다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.2절 | diff --git a/docs/work/reference/defect-patterns.md b/docs/work/reference/defect-patterns.md index 1382c2d2..d53b87d7 100644 --- a/docs/work/reference/defect-patterns.md +++ b/docs/work/reference/defect-patterns.md @@ -121,7 +121,7 @@ | 규칙을 일부러 다르게 둔 타입 | 그 타입의 Javadoc | | 정적 분석 제외 | 제외 항목 옆 이유(`src/config/spotbugs/exclude-test.xml` 등) | | 규칙의 예외 경로 | 이유를 요구하는 표시(`@SystemCaller(reason)`) | -| 복사본을 남긴 이유 | 가까운 `CLAUDE.md`(예: `src/messaging/CLAUDE.md`) | +| 복사본을 남긴 이유 | 가까운 `CLAUDE.md`(예: `src/platforms/messaging/CLAUDE.md`) | | 되돌리기 비싼 선택 | `docs/adr/ADR-<영역>-<번호>-<제목>.md` | ## 패턴을 더하는 법 diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 61f740c3..aa8203a2 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -20,8 +20,8 @@ | `qualityCheck` | SpotBugs, FindSecBugs(운영 코드) | PR(`ci` 안) | `src/build.gradle` | | `testQualityCheck` | 같은 분석을 모든 테스트 source set에(`config/spotbugs/exclude-test.xml` 기준) | main(`mainCheck` 안), optional 빌드는 `ci` | `src/build.gradle` | | `ci` | leaf `check`(API surface 포함) + `architectureCheck` + `qualityCheck` | PR | `ci-quality-gates.yml`: `./gradlew :ci :verifyDependencyLocks --warning-mode=fail` | -| `verifyStrictLaneStages --dry-run` | `explicitOnly`가 아닌 strict lane이 workflow가 실행하는 단계에 속하는가 | PR(두 빌드 각각) | `ci-quality-gates.yml`, optional 빌드는 `-p optional-platforms` | -| `-p optional-platforms ci` | gRPC 플랫폼 빌드 | PR | `ci-quality-gates.yml` | +| `verifyStrictLaneStages --dry-run` | `explicitOnly`가 아닌 strict lane이 workflow가 실행하는 단계에 속하는가 | PR(두 빌드 각각) | `ci-quality-gates.yml`, optional 빌드는 `-p platforms/optional-build` | +| `-p platforms/optional-build ci` | gRPC 플랫폼 빌드 | PR | `ci-quality-gates.yml` | | `bash scripts/verify-compose-profile-contracts.sh` | compose lane이 선언대로 렌더링되는가(저장소 루트에서) | PR | `ci-quality-gates.yml` | | `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `integration-main.yml`: `./gradlew :mainCheck --continue --warning-mode=fail` | | `integrationCheck` | 선언된 strict integration lane 전체(실 컨테이너). 입력이 없는 lane은 빼고 이름을 댄다 | main·nightly | `integration-main.yml`, optional 빌드도 | @@ -98,18 +98,18 @@ cd src # PR: ci-quality-gates.yml ./gradlew :ci :verifyDependencyLocks --warning-mode=fail --no-build-cache --console=plain ./gradlew :verifyStrictLaneStages --dry-run --console=plain -./gradlew -p optional-platforms ci --no-build-cache --console=plain -./gradlew -p optional-platforms :verifyStrictLaneStages --dry-run --console=plain +./gradlew -p platforms/optional-build ci --no-build-cache --console=plain +./gradlew -p platforms/optional-build :verifyStrictLaneStages --dry-run --console=plain # main push: integration-main.yml ./gradlew :mainCheck --continue --warning-mode=fail --no-build-cache --console=plain ./gradlew :integrationCheck --continue --no-build-cache --console=plain ./gradlew :performanceCheck --continue --no-build-cache --console=plain -./gradlew -p optional-platforms performanceCheck --continue --no-build-cache --console=plain -./gradlew -p optional-platforms integrationCheck --no-build-cache --console=plain +./gradlew -p platforms/optional-build performanceCheck --continue --no-build-cache --console=plain +./gradlew -p platforms/optional-build integrationCheck --no-build-cache --console=plain ./gradlew :adapter:outbound:httpclient:test -Phttp3.tests.enabled=true --no-build-cache --console=plain # 실험 job, 실패해도 workflow는 통과 # 태그: release.yml (CI는 GITHUB_SHA로 커밋을 받는다. 손으로 돌릴 때는 -PgitRevision) ./gradlew :releaseCheck -PgitRevision="$(git rev-parse HEAD)" --no-build-cache --console=plain -./gradlew -p optional-platforms releaseCheck -PgitRevision="$(git rev-parse HEAD)" --no-build-cache --console=plain +./gradlew -p platforms/optional-build releaseCheck -PgitRevision="$(git rev-parse HEAD)" --no-build-cache --console=plain cd .. bash scripts/verify-compose-profile-contracts.sh bash scripts/run-compose-runtime-smoke.sh --matrix src/app-bootstrap/compose-lanes/compose-profile-contracts.json @@ -183,7 +183,7 @@ for k in tests skipped failures errors; do cat $(find "$x" -name 'TEST-*.xml') | | 장치 | 고정하는 것 | 단계 | | --- | --- | --- | | 자원 한계 lane | Tomcat·Jetty 부하·느린 클라이언트·종료, HTTP client 풀·스트리밍·재시도, Hikari 풀 | `performanceCheck` | -| JMH 벤치마크 | `src/messaging/messaging-kafka/src/jmh`, `src/messaging/messaging-testkit/src/jmh`, `src/adapter/outbound/httpclient/src/jmh` | 명시 실행 | +| JMH 벤치마크 | `src/platforms/messaging/messaging-kafka/src/jmh`, `src/platforms/messaging/messaging-testkit/src/jmh`, `src/adapter/outbound/httpclient/src/jmh` | 명시 실행 | ## 6. 게이트를 믿을 조건 — 거짓 통과 막기 diff --git a/scripts/verify-mongodb-advanced.sh b/scripts/verify-mongodb-advanced.sh index e0da8549..c30b0503 100755 --- a/scripts/verify-mongodb-advanced.sh +++ b/scripts/verify-mongodb-advanced.sh @@ -84,7 +84,7 @@ echo "=== [actual-topology] provider environments" # # The selector names the contract's class. `--tests '*Shard*'` was satisfied by the hermetic # ShardKeyAnalyzerTest, so "sharded topology" was certified by a unit test that never opened a -# connection. Which classes count is `src/config/mongodb/release-contracts.json`, and +# connection. Which classes count is `src/adapter/outbound/persistence-mongo/release/release-contracts.json`, and # MongoReleaseEvidenceVerifier checks the JUnit XML rather than the exit code. if [[ -n "${MONGODB_SHARDED_URI:-}" ]]; then # Not promoted. `mongoShardedTest` is declared in release-contracts.json under @@ -94,7 +94,7 @@ if [[ -n "${MONGODB_SHARDED_URI:-}" ]]; then # a silent skip: an operator who set it expected a qualification to run. echo "sharded topology is experimental and has no registered lane;" >&2 echo " MONGODB_SHARDED_URI was set but mongoShardedTest does not exist." >&2 - echo " See experimental_contracts in src/config/mongodb/release-contracts.json." >&2 + echo " See experimental_contracts in src/adapter/outbound/persistence-mongo/release/release-contracts.json." >&2 FAILED+=("actual-topology:sharded-not-promoted") else echo "actual-topology(sharded): no MONGODB_SHARDED_URI" diff --git a/scripts/verify-mongodb-platform.sh b/scripts/verify-mongodb-platform.sh index 2808fcf2..6543f2d8 100755 --- a/scripts/verify-mongodb-platform.sh +++ b/scripts/verify-mongodb-platform.sh @@ -155,8 +155,8 @@ mkdir -p "${MANIFEST_DIR}" echo " \"commitDirty\": $( [[ -n "$(git -C "${REPO_ROOT}" status --porcelain)" ]] && echo true || echo false )," echo " \"serverImage\": \"${MONGODB_IMAGE:-mongo:8.0.16}\"," echo " \"generatedAt\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"," - echo " \"contractManifest\": \"src/config/mongodb/release-contracts.json\"," - echo " \"contractManifestSha256\": \"$(sha256sum "${REPO_ROOT}/src/config/mongodb/release-contracts.json" | cut -d' ' -f1)\"" + echo " \"contractManifest\": \"src/adapter/outbound/persistence-mongo/release/release-contracts.json\"," + echo " \"contractManifestSha256\": \"$(sha256sum "${REPO_ROOT}/src/adapter/outbound/persistence-mongo/release/release-contracts.json" | cut -d' ' -f1)\"" echo "}" } > "${MANIFEST_DIR}/promotion.json" echo "promotion manifest: ${MANIFEST_DIR}/promotion.json" diff --git a/src/adapter/outbound/messaging-kafka/CLAUDE.md b/src/adapter/outbound/messaging-kafka/CLAUDE.md index 293b83c7..060cd2b3 100644 --- a/src/adapter/outbound/messaging-kafka/CLAUDE.md +++ b/src/adapter/outbound/messaging-kafka/CLAUDE.md @@ -7,7 +7,7 @@ `messaging:messaging-spring-boot-starter-kafka` (the vendored platform and its Kafka transport) and ships the module defaults in `config/module-defaults/messaging.yml`. - Boundaries: add no code here. A publish rule belongs to the bridge (`adapter:outbound:messaging`), - a Kafka rule to the vendored product (`src/messaging/CLAUDE.md`); a class here would be a third + a Kafka rule to the vendored product (`src/platforms/messaging/CLAUDE.md`); a class here would be a third place. Allowed edges come only from the registry entry. - Tests: activation tests (`./gradlew :adapter:outbound:messaging-kafka:test`) and the real-Kafka lane `messagingKafkaRelayIntegrationTest` (relay → bridge → broker record bytes; `:integrationCheck`). diff --git a/src/adapter/outbound/messaging/CLAUDE.md b/src/adapter/outbound/messaging/CLAUDE.md index 65c7228b..d7d4f08d 100644 --- a/src/adapter/outbound/messaging/CLAUDE.md +++ b/src/adapter/outbound/messaging/CLAUDE.md @@ -38,7 +38,7 @@ Package root: `dev.caskeleton.adapter.outbound.messaging`. may not carry this module. The R1 contract/binding compilers and JSON Schema envelope encoder were removed on 2026-09-25 (see `docs/capability-status.md`). - No JSON Schema engine (NetworkNT) on the main classpath. The evidence manifest schema check and the - capability card check (`config/messaging`) are this leaf's tests (`evidence/`); snakeyaml is + capability card check (`release/`) are this leaf's tests (`evidence/`); snakeyaml is test-only (owner decision 2026-09-25). - Do not hide use-case sequencing or business routing policy in broker adapters. - `OutboxMessagePublishAdapter` is delegate-only and emits no dependency log. The confirmed diff --git a/src/adapter/outbound/messaging/build.gradle b/src/adapter/outbound/messaging/build.gradle index e768936c..6267abee 100644 --- a/src/adapter/outbound/messaging/build.gradle +++ b/src/adapter/outbound/messaging/build.gradle @@ -19,7 +19,7 @@ dependencies { // Test-only: MessagingEvidenceSchemaValidatorTest holds the common evidence schema to Draft 2020-12. testImplementation libs.json.schema.validator // Test-only (owner decision 29): MessagingCapabilityRegistryContractTest reads the capability - // cards in config/messaging/*.yaml. The rules below keep snakeyaml out of every main + // cards in release/*.yaml. The rules below keep snakeyaml out of every main // configuration; only the `test*` ones may resolve it. testImplementation 'org.yaml:snakeyaml' } @@ -57,8 +57,8 @@ configurations.configureEach { configuration -> } } -// The card check reads the whole config/messaging tree (cards, profiles, the evidence schema). +// The card check reads the whole release tree (cards, profiles, the evidence schema). tasks.named('test') { - inputs.dir(rootProject.file('config/messaging')) + inputs.dir(file('release')) .withPathSensitivity(PathSensitivity.RELATIVE) } diff --git a/src/config/messaging/evidence/build-evidence-manifest-v1.schema.json b/src/adapter/outbound/messaging/release/evidence/build-evidence-manifest-v1.schema.json similarity index 100% rename from src/config/messaging/evidence/build-evidence-manifest-v1.schema.json rename to src/adapter/outbound/messaging/release/evidence/build-evidence-manifest-v1.schema.json diff --git a/src/config/messaging/profile-compatibility.yaml b/src/adapter/outbound/messaging/release/profile-compatibility.yaml similarity index 100% rename from src/config/messaging/profile-compatibility.yaml rename to src/adapter/outbound/messaging/release/profile-compatibility.yaml diff --git a/src/config/messaging/readiness-cards.yaml b/src/adapter/outbound/messaging/release/readiness-cards.yaml similarity index 100% rename from src/config/messaging/readiness-cards.yaml rename to src/adapter/outbound/messaging/release/readiness-cards.yaml diff --git a/src/config/messaging/release-profile-assertions.yaml b/src/adapter/outbound/messaging/release/release-profile-assertions.yaml similarity index 100% rename from src/config/messaging/release-profile-assertions.yaml rename to src/adapter/outbound/messaging/release/release-profile-assertions.yaml diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingCapabilityRegistryContractTest.java b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingCapabilityRegistryContractTest.java index 97b5c182..f26caaff 100644 --- a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingCapabilityRegistryContractTest.java +++ b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingCapabilityRegistryContractTest.java @@ -23,8 +23,9 @@ import tools.jackson.core.type.TypeReference; import tools.jackson.databind.json.JsonMapper; /** - * The messaging capability cards under {@code config/messaging} (readiness cards, compatibility and - * release profiles, the common evidence manifest schema) stay closed and fail-safe. + * The messaging capability cards under {@code adapter/outbound/messaging/release} (readiness cards, + * compatibility and release profiles, the common evidence manifest schema) stay closed and + * fail-safe. * *

Owner decision 29: the card check lives in this leaf's tests, and snakeyaml is on this leaf's * test classpath only — main stays YAML-free (build.gradle). The files it reads are declared as @@ -350,7 +351,8 @@ class MessagingCapabilityRegistryContractTest { } private static Path requiredConfig(String relativePath) { - Path path = repositorySrcRoot().resolve("config/messaging").resolve(relativePath); + Path path = + repositorySrcRoot().resolve("adapter/outbound/messaging/release").resolve(relativePath); assertThat(path).as("required Messaging configuration %s", path).isRegularFile(); return path; } diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingEvidenceSchemaValidatorTest.java b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingEvidenceSchemaValidatorTest.java index 168e76ff..4855926f 100644 --- a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingEvidenceSchemaValidatorTest.java +++ b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/evidence/MessagingEvidenceSchemaValidatorTest.java @@ -11,13 +11,13 @@ import java.util.List; import org.junit.jupiter.api.Test; /** - * The common build-evidence manifest schema (config/messaging/evidence) is valid Draft 2020-12 and - * accepts the manifest shape the R2 evidence producers are specified to write. + * The common build-evidence manifest schema (release/evidence) is valid Draft 2020-12 and accepts + * the manifest shape the R2 evidence producers are specified to write. */ class MessagingEvidenceSchemaValidatorTest { private static final Path COMMON_SCHEMA = - Path.of("../../../config/messaging/evidence/build-evidence-manifest-v1.schema.json"); + Path.of("release/evidence/build-evidence-manifest-v1.schema.json"); private static final String SHA256 = "sha256:" + "0".repeat(64); private static final String VALID_MANIFEST = """ diff --git a/src/adapter/outbound/persistence-fileserver/CLAUDE.md b/src/adapter/outbound/persistence-fileserver/CLAUDE.md index ff897720..1df1b76c 100644 --- a/src/adapter/outbound/persistence-fileserver/CLAUDE.md +++ b/src/adapter/outbound/persistence-fileserver/CLAUDE.md @@ -60,7 +60,7 @@ in `platform`), so the two capability leaves read the same way. `jpaPlatformContractTest` lane on `FileserverPostgreSqlStack`, whose clock a case moves. - The real-PostgreSQL tests are still in `persistence-jpa`'s `postgresqlIntegrationTest` source set, which owns the container and Flyway wiring, and the JPA readiness card - (`config/jpa/readiness-cards.yaml`, checked by `JpaReadinessRegistryTest`) names them as that + (`persistence-jpa/release/readiness-cards.yaml`, checked by `JpaReadinessRegistryTest`) names them as that leaf's tasks — moving them means moving the card's tasks and selectors with them: `postgresqlFileserverMigrationIntegrationTest`, `postgresqlFileserverMetadataIntegrationTest`, `postgresqlFileserverReclamationIntegrationTest` diff --git a/src/adapter/outbound/persistence-fileserver/build.gradle b/src/adapter/outbound/persistence-fileserver/build.gradle index 4f3fc89f..4ec73236 100644 --- a/src/adapter/outbound/persistence-fileserver/build.gradle +++ b/src/adapter/outbound/persistence-fileserver/build.gradle @@ -46,6 +46,6 @@ apiSurface { adopterBaseline = rootProject.file('../docs/architecture/persistence-fileserver-adopter-api-surface.txt') adopterSources = fileTree(rootProject.projectDir) { include '*/**/src/main/java/**/*.java' - exclude '**/build/**', 'adapter/outbound/persistence-fileserver/**', 'build-logic/**', 'optional-platforms/**' + exclude '**/build/**', 'adapter/outbound/persistence-fileserver/**', 'build-logic/**', 'platforms/optional-build/**' } } diff --git a/src/adapter/outbound/persistence-jpa/README.md b/src/adapter/outbound/persistence-jpa/README.md index fcc260cf..5f07bbd6 100644 --- a/src/adapter/outbound/persistence-jpa/README.md +++ b/src/adapter/outbound/persistence-jpa/README.md @@ -389,7 +389,7 @@ cadence 측정 필요). retention 한 값은 reaper-local 이라 `@Value` 로 ## JPA production capability candidate -`src/config/jpa/readiness-cards.yaml`이 capability와 독립 schema stream의 +`src/adapter/outbound/persistence-jpa/release/readiness-cards.yaml`이 capability와 독립 schema stream의 machine-readable SSOT다(개수는 registry가 소유한다). `selected` base card와 `implemented-candidate` reliability card를 구분하며, 실제 PostgreSQL 테스트 통과만으로 immutable 운영 evidence가 필요한 R2를 주장하지 않는다. diff --git a/src/adapter/outbound/persistence-jpa/build.gradle b/src/adapter/outbound/persistence-jpa/build.gradle index 4329176e..e1d40ba0 100644 --- a/src/adapter/outbound/persistence-jpa/build.gradle +++ b/src/adapter/outbound/persistence-jpa/build.gradle @@ -117,7 +117,7 @@ dependencies { postgresqlIntegrationTestImplementation testFixtures(project(':application-fileserver')) // The notification capability's persistence moved out the same way, and its real-PostgreSQL // qualifications stay here for the same reason: this lane owns the container, the Flyway wiring - // and the readiness cards that name those tests (config/jpa/readiness-cards.yaml). Test scope + // and the readiness cards that name those tests (release/readiness-cards.yaml). Test scope // only. postgresqlIntegrationTestImplementation project(':adapter:outbound:persistence-notification') postgresqlIntegrationTestImplementation project(':application-notification') @@ -171,7 +171,7 @@ dependencies { // Real-PostgreSQL lanes. A readiness lane runs one named class (the security lane also names the // runtime-role namespace-denial method), a platform lane selects a tag, and the pool lane has a -// source set of its own. release.yml (jpa-release-gate) and config/jpa/*.{json,yaml} name these tasks. +// source set of its own. release.yml (jpa-release-gate) and release/*.{json,yaml} name these tasks. def jpaEvidenceImage = providers.gradleProperty('jpaPostgreSqlEvidenceImage').orElse(testContainerImages['postgres-16']).get() def jpaMatrixVersions = providers.gradleProperty('jpa.matrix.versions').orElse('16').get() def readinessLanes = [ @@ -205,12 +205,12 @@ def platformLanes = [ jpaPlatformQueryPlanTest: ['jpa-queryplan', 'Asserts query plan structure and planner estimate error (design §33).'], jpaPlatformSecurityTest : ['jpa-security', 'Verifies runtime role privileges and search_path safety (design §36).'], ] -// Every scenario a readiness card cites (config/jpa/readiness-cards.yaml `evidence.scenarios`) is a +// Every scenario a readiness card cites (release/readiness-cards.yaml `evidence.scenarios`) is a // required test of the lane that runs its class, and a readiness lane rejects skips. That is what the // deleted JPA evidence manifest used to establish from JUnit XML after the fact; JpaReadinessRegistryTest // checks the cards themselves. def readinessScenarios = new groovy.json.JsonSlurper() - .parse(rootProject.file('config/jpa/readiness-cards.yaml')) + .parse(file('release/readiness-cards.yaml')) .cards.values() .findAll { it.state != 'not-implemented' } .collectMany { card -> (card.evidence?.scenarios ?: []).collect { it.selector } } @@ -287,7 +287,7 @@ tasks.named('postgresqlSecurityBaselineIntegrationTest') { dependsOn ':adapter:inbound:web:jpaPersistenceRedactionContractTest' } -// Which JPA lanes block a release is declared by config/jpa/release-registry.json (jpaReleaseQualification below). +// Which JPA lanes block a release is declared by release/release-registry.json (jpaReleaseQualification below). // This leaf declares the lanes and how each runs; it does not own release orchestration. // The unit lane reads three files that are not Java sources: the release registry and its two @@ -298,9 +298,9 @@ tasks.named('postgresqlSecurityBaselineIntegrationTest') { // up-to-date after a registry demotion or a workflow edit — so the drift checks that exist to catch // exactly those edits never run on them. tasks.named('test') { - inputs.file(rootProject.file('config/jpa/release-registry.json')) + inputs.file(file('release/release-registry.json')) // JpaReadinessRegistryTest: the readiness cards, the lanes they name and the scenarios they cite. - inputs.file(rootProject.file('config/jpa/readiness-cards.yaml')) + inputs.file(file('release/readiness-cards.yaml')) inputs.dir(file('src/postgresqlIntegrationTest/java')).withPropertyName('readinessScenarioSources') inputs.file(new File(rootProject.projectDir.parentFile, 'docs/jpa/support-matrix.md')) inputs.file(new File(rootProject.projectDir.parentFile, 'docs/jpa/repository-adaptation.md')) @@ -316,7 +316,7 @@ tasks.named('test') { inputs.dir(file('../persistence-fileserver/src/main/resources/db/migration')) .withPropertyName('fileserverMigrations') // ...and the messaging platform's tree, whose inbox range the consume side applies here. - inputs.dir(file('../../../messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration')) + inputs.dir(file('../../../platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration')) .withPropertyName('messagingMigrations') } @@ -351,20 +351,20 @@ apiSurface { include '*/**/src/main/java/**/*.java' exclude '**/build/**', 'adapter/outbound/persistence-jpa/**', 'adapter/outbound/persistence-fileserver/**', 'adapter/outbound/persistence-notification/**', - 'build-logic/**', 'optional-platforms/**' + 'build-logic/**', 'platforms/optional-build/**' } } -// The release registry (config/jpa/release-registry.json) names the blocking release gates; this +// The release registry (release/release-registry.json) names the blocking release gates; this // aggregate runs exactly those. It replaced the build-tools `ca.jpa-qualification` plugin (review // 2026-09-24 BUILD-O3-2): a gate that names a task that does not exist fails when the task graph is // built, which is the whole of what `verifyJpaReleaseGateTasks` used to check. tasks.register('jpaReleaseQualification') { group = 'verification' - description = 'Runs exactly the blocking JPA release gates declared by config/jpa/release-registry.json.' + description = 'Runs exactly the blocking JPA release gates declared by release/release-registry.json.' dependsOn(new groovy.json.JsonSlurper() - .parse(rootProject.file('config/jpa/release-registry.json')) + .parse(file('release/release-registry.json')) .gates.findAll { it.blocking }.collect { it.task }) } diff --git a/src/config/jpa/readiness-cards.yaml b/src/adapter/outbound/persistence-jpa/release/readiness-cards.yaml similarity index 100% rename from src/config/jpa/readiness-cards.yaml rename to src/adapter/outbound/persistence-jpa/release/readiness-cards.yaml diff --git a/src/config/jpa/release-registry.json b/src/adapter/outbound/persistence-jpa/release/release-registry.json similarity index 100% rename from src/config/jpa/release-registry.json rename to src/adapter/outbound/persistence-jpa/release/release-registry.json diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/MigrationTrees.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/MigrationTrees.java index 83cd9ab0..018843b1 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/MigrationTrees.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/MigrationTrees.java @@ -40,7 +40,7 @@ final class MigrationTrees { Path.of("../persistence-notification/src/main/resources/db/migration"), Path.of("../persistence-fileserver/src/main/resources/db/migration"), Path.of( - "../../../messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration")); + "../../../platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration")); private MigrationTrees() {} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReadinessRegistryTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReadinessRegistryTest.java index abb795df..b9451b34 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReadinessRegistryTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReadinessRegistryTest.java @@ -20,7 +20,8 @@ import tools.jackson.databind.JsonNode; import tools.jackson.databind.json.JsonMapper; /** - * The JPA readiness cards ({@code src/config/jpa/readiness-cards.yaml}) against the lanes and tests + * The JPA readiness cards ({@code + * src/adapter/outbound/persistence-jpa/release/readiness-cards.yaml}) against the lanes and tests * they name. * *

This replaced the build-tools {@code ca.jpa-qualification}/{@code ca.jpa-evidence} plugins @@ -33,8 +34,8 @@ import tools.jackson.databind.json.JsonMapper; class JpaReadinessRegistryTest { private static final Path SOURCE_ROOT = Path.of("../../..").toAbsolutePath().normalize(); - private static final Path REGISTRY = SOURCE_ROOT.resolve("config/jpa/readiness-cards.yaml"); private static final Path LEAF = SOURCE_ROOT.resolve("adapter/outbound/persistence-jpa"); + private static final Path REGISTRY = LEAF.resolve("release/readiness-cards.yaml"); private static final String LEAF_PATH = ":adapter:outbound:persistence-jpa:"; private static final Set STATES = Set.of("selected", "implemented-candidate", "not-implemented"); diff --git a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/release/JpaReleaseManifest.java b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/release/JpaReleaseManifest.java index e113da59..cba4d2dc 100644 --- a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/release/JpaReleaseManifest.java +++ b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/release/JpaReleaseManifest.java @@ -43,7 +43,8 @@ public record JpaReleaseManifest( String providerBaseline) { /** Where the registry lives, relative to the repository's {@code src} directory. */ - public static final String REGISTRY_PATH = "config/jpa/release-registry.json"; + public static final String REGISTRY_PATH = + "adapter/outbound/persistence-jpa/release/release-registry.json"; /** * The registry, located by walking up from the working directory. diff --git a/src/adapter/outbound/persistence-mongo/CLAUDE.md b/src/adapter/outbound/persistence-mongo/CLAUDE.md index 71ce0ab9..3936e48c 100644 --- a/src/adapter/outbound/persistence-mongo/CLAUDE.md +++ b/src/adapter/outbound/persistence-mongo/CLAUDE.md @@ -109,7 +109,7 @@ The architecture rule catalogue (`…mongo.architecture`) is in the **testkit** production: it is ArchUnit input, and shipping it put rule text on every consumer's runtime classpath. Release gating is testkit-only for the same reason and is one implementation, not two: `…mongo.testkit.release` reads the JUnit XML a lane wrote and is what -`scripts/verify-mongodb-platform.sh` and `src/config/mongodb/release-contracts.json` drive. A second +`scripts/verify-mongodb-platform.sh` and `src/adapter/outbound/persistence-mongo/release/release-contracts.json` drive. A second pair on the production classpath — a hand-built set of category names and a gate that checked it — had no caller outside its own test and no source of truth behind the categories; it is gone rather than moved. diff --git a/src/adapter/outbound/persistence-mongo/build.gradle b/src/adapter/outbound/persistence-mongo/build.gradle index c33c1752..2b68b247 100644 --- a/src/adapter/outbound/persistence-mongo/build.gradle +++ b/src/adapter/outbound/persistence-mongo/build.gradle @@ -257,7 +257,7 @@ tasks.named('check') { strictTestLanes { lane('mongoDocumentContractTest') { tag = 'document-contract' - description = 'Holds the Mongo lane tags to config/mongodb/release-contracts.json.' + description = 'Holds the Mongo lane tags to release/release-contracts.json.' rejectSkipped = true mainStage() } diff --git a/src/config/mongodb/release-contracts.json b/src/adapter/outbound/persistence-mongo/release/release-contracts.json similarity index 100% rename from src/config/mongodb/release-contracts.json rename to src/adapter/outbound/persistence-mongo/release/release-contracts.json diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoTestLaneContractTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoTestLaneContractTest.java index d9854111..595b211b 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoTestLaneContractTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoTestLaneContractTest.java @@ -30,8 +30,7 @@ import tools.jackson.databind.json.JsonMapper; class MongoTestLaneContractTest { private static final Path INTEGRATION_SOURCES = Path.of("src/mongoIntegrationTest/java"); - private static final Path RELEASE_CONTRACTS = - Path.of("../../../config/mongodb/release-contracts.json"); + private static final Path RELEASE_CONTRACTS = Path.of("release/release-contracts.json"); private static final Set DOCKER_LANE_TAGS = Set.of( "mongodb-replicaset", diff --git a/src/app-bootstrap/README.md b/src/app-bootstrap/README.md index 05ae2ff4..3881e831 100644 --- a/src/app-bootstrap/README.md +++ b/src/app-bootstrap/README.md @@ -473,12 +473,12 @@ app-bootstrap 은 합성 루트라 "왜 이 의존성이, 왜 이 scope 로" 결 - **`spring-security-test`** — `@WithMockUser`로 actuator 보안 인가(permit-all 프로브 / 인증 필요한 링크 / 노출 안 한 loggers)를 검증한다. - **`snakeyaml`** — `docs/registries/*.yaml` 같은 checked-in YAML 레지스트리를 contract 테스트가 - 읽는다. `config/messaging/*.yaml` 카드 검증(`MessagingCapabilityRegistryContractTest`)은 소유자 + 읽는다. `adapter/outbound/messaging/release/*.yaml` 카드 검증(`MessagingCapabilityRegistryContractTest`)은 소유자 결정 29로 `adapter:outbound:messaging` 테스트로 옮겼다. ### Messaging qualification scaffold -`config/messaging/`은 first polling-producer tuple의 machine-readable 계획 truth만 보관한다. +`adapter/outbound/messaging/release/`는 first polling-producer tuple의 machine-readable 계획 truth만 보관한다. 현재 card 11개는 모두 `maturity: not-implemented`, `evidenceFingerprint: ""`이고 consumer, CDC, EOS, schema-registry 확장 row는 없다. `verifyMessagingContracts`는 application-core· shared-contract의 exact qualification test를 실행하고 `contracts-schema/manifest.json`을 쓴 뒤 그 diff --git a/src/app-bootstrap/build.gradle b/src/app-bootstrap/build.gradle index 6be01ae9..e2a7b6bd 100644 --- a/src/app-bootstrap/build.gradle +++ b/src/app-bootstrap/build.gradle @@ -183,7 +183,7 @@ dependencies { capabilityProjects.each { architectureTestRuntimeOnly project(it) } // What this import does NOT see: the optional-platforms build (`grpc:*`, `grpc-advanced:*`). // It is a separate Gradle build, so its classes cannot be on this classpath; its registered - // leaves are held by the Gradle direction gate (`-p optional-platforms ci` runs + // leaves are held by the Gradle direction gate (`-p platforms/optional-build ci` runs // verifyCleanArchitectureDependencies), which is the whole of what the owner decided it needs. // The capability integration lane selects Fileserver and object storage together, as a service @@ -349,6 +349,8 @@ def repositoryContractInputs = files( include 'config/**', '**/*.gradle', 'gradle/*.toml', 'Dockerfile*', '.env*', '**/src/main/**' // The compose lane fixtures this leaf owns (the lane contract, overlays, smoke clients). include 'app-bootstrap/compose-lanes/**' + // The release data a capability leaf owns (readiness cards, release registries). + include 'adapter/outbound/*/release/**' exclude '**/*.md' exclude repositoryContractExcludes }) diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java index 02a31d7d..5a9f5845 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java @@ -371,19 +371,19 @@ class DeveloperExperienceContractTest { // and the dependency verifier, and none of those runs a lane whose category is INTEGRATION. // A lane nobody runs is not coverage, so both halves are pinned here — the aggregate that // covers the category, and the workflow that executes the aggregate. - assertThat(read("src/optional-platforms/build.gradle")) + assertThat(read("src/platforms/optional-build/build.gradle")) .as("the optional platform build must aggregate its integration-category lanes") .contains("tasks.register('integrationCheck')") .contains(":integrationTestLaneCheck"); - assertThat(read("src/grpc/grpc-operation-ledger-jpa/build.gradle")) + assertThat(read("src/platforms/grpc/grpc-operation-ledger-jpa/build.gradle")) .as("the operation ledger lane this contract protects must still be declared") .contains("lane('integrationTest')") .contains("integration()"); assertThat(read(".github/workflows/integration-main.yml")) .as("a workflow must actually execute the optional platform integration aggregate") - .contains("./gradlew -p optional-platforms integrationCheck"); + .contains("./gradlew -p platforms/optional-build integrationCheck"); } @Test diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingAuthorityContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingAuthorityContractTest.java index 143039be..2554634a 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingAuthorityContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingAuthorityContractTest.java @@ -51,7 +51,7 @@ class MessagingAuthorityContractTest { Pattern.compile("String PREFIX\\s*=\\s*\"app\\.messaging\""); private static final List MESSAGING_SOURCES = - loadSources("adapter/outbound/messaging", "messaging", "app-bootstrap"); + loadSources("adapter/outbound/messaging", "platforms/messaging", "app-bootstrap"); private static final List CORE_SOURCES = loadSources("application-core", "domain-core"); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingPublicSurfaceContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingPublicSurfaceContractTest.java index 922d9399..22527fd2 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingPublicSurfaceContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingPublicSurfaceContractTest.java @@ -34,8 +34,8 @@ import org.junit.jupiter.api.Test; * *

So the rule is one-directional and mechanical: a vendor library named in a public or protected * signature is declared {@code api}; one used only behind private members stays {@code - * implementation}. {@code src/messaging/CLAUDE.md} states it as policy — this holds it to the - * source so the two cannot drift. + * implementation}. {@code src/platforms/messaging/CLAUDE.md} states it as policy — this holds it to + * the source so the two cannot drift. * *

The libraries checked are the ones an adopter would otherwise have to reverse-engineer into * their own build: broker clients, codec libraries, the metrics registry, the reactive facade. @@ -345,7 +345,7 @@ class MessagingPublicSurfaceContractTest { } private static List messagingLeaves() { - Path family = repositoryRoot().resolve("src/messaging"); + Path family = repositoryRoot().resolve("src/platforms/messaging"); try (Stream children = Files.list(family)) { return children .filter(Files::isDirectory) diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/registry/ReleaseManifestTaskExistenceTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/registry/ReleaseManifestTaskExistenceTest.java index 82746f04..73fea2a7 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/registry/ReleaseManifestTaskExistenceTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/registry/ReleaseManifestTaskExistenceTest.java @@ -66,7 +66,8 @@ class ReleaseManifestTaskExistenceTest { // Only the blocking set. experimental_contracts is explicitly not promoted and is never // aggregated into a release manifest, so a task it names is allowed not to exist yet. List named = - blockingTaskNamesIn(root.resolve("src/config/mongodb/release-contracts.json")); + blockingTaskNamesIn( + root.resolve("src/adapter/outbound/persistence-mongo/release/release-contracts.json")); List registered = registeredTaskNamesIn(root.resolve("src/adapter/outbound/persistence-mongo/build.gradle")); diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/MainBuild.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/MainBuild.java new file mode 100644 index 00000000..c64083b9 --- /dev/null +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/MainBuild.java @@ -0,0 +1,78 @@ +package dev.caskeleton.buildlogic; + +import java.io.File; +import java.io.IOException; +import java.io.UncheckedIOException; +import org.gradle.api.GradleException; + +/** + * Where the main build is, seen from any build of this repository. + * + *

The main build is the Gradle root that owns the module registry ({@code + * config/architecture/modules.json}); the repository root is its parent. The optional platform build + * lives inside it ({@code src/platforms/optional-build}), and the code that needs the registry, the + * shared tool configuration or the test image catalog used to reach the main build by taking one + * parent of the optional build's root. That held only while the optional build sat directly under + * the main build; it is found by walking up instead, so the optional build's depth is not a fact + * every caller repeats. + */ +public final class MainBuild { + /** The registry, relative to the main build: what makes a directory the main build. */ + public static final String REGISTRY = "config/architecture/modules.json"; + + private MainBuild() {} + + /** + * The main build's directory: {@code buildRoot} itself or the nearest directory above it that + * holds the module registry. + * + * @param buildRoot the root directory of the build asking (its settings or root project directory) + * @return the canonical main build directory + */ + public static File directory(File buildRoot) { + File registry = nearest(buildRoot, REGISTRY); + if (registry == null) { + throw new GradleException( + "No " + REGISTRY + " at or above " + buildRoot + "; this build is not inside the repository"); + } + return registry.getParentFile().getParentFile().getParentFile(); + } + + /** + * The nearest {@code relativePath} at or above {@code buildRoot}: in the build's own root first, + * then in each parent. A file or a directory; {@code null} when no ancestor has it. + * + * @param buildRoot the root directory of the build asking + * @param relativePath the path to look for, relative to each candidate directory + * @return the canonical path found, or {@code null} + */ + public static File nearest(File buildRoot, String relativePath) { + for (File directory = canonical(buildRoot); + directory != null; + directory = directory.getParentFile()) { + File candidate = new File(directory, relativePath); + if (candidate.exists()) { + return candidate; + } + } + return null; + } + + /** + * The repository root: the main build's parent. + * + * @param buildRoot the root directory of the build asking + * @return the canonical repository root + */ + public static File repositoryRoot(File buildRoot) { + return directory(buildRoot).getParentFile(); + } + + private static File canonical(File file) { + try { + return file.getCanonicalFile(); + } catch (IOException exception) { + throw new UncheckedIOException("cannot resolve " + file, exception); + } + } +} diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java index 3e5d1008..a15d3d92 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java @@ -1,9 +1,8 @@ package dev.caskeleton.buildlogic.architecture; +import dev.caskeleton.buildlogic.MainBuild; import dev.caskeleton.buildlogic.ModuleRegistry; import java.io.File; -import java.io.IOException; -import java.io.UncheckedIOException; import java.nio.file.Path; import java.util.ArrayList; import java.util.HashSet; @@ -33,15 +32,9 @@ public final class ArchitecturePlugin implements Plugin { Project root = project.getRootProject(); boolean optionalGrpcBuild = root.getName().equals("optional-platforms"); String buildName = optionalGrpcBuild ? "optional-grpc" : "main"; - File mainBuildDirectory = - optionalGrpcBuild ? root.getProjectDir().getParentFile() : root.getProjectDir(); - File registryFile = new File(mainBuildDirectory, "config/architecture/modules.json"); - File repositoryRoot; - try { - repositoryRoot = mainBuildDirectory.getParentFile().getCanonicalFile(); - } catch (IOException exception) { - throw new UncheckedIOException("failed to resolve repository root", exception); - } + File mainBuildDirectory = MainBuild.directory(root.getProjectDir()); + File registryFile = new File(mainBuildDirectory, MainBuild.REGISTRY); + File repositoryRoot = mainBuildDirectory.getParentFile(); ModuleRegistry registry = ModuleRegistry.read(registryFile, repositoryRoot); List modules = registry.modulesForBuild(buildName); List registryViolations = registryViolations(registry, modules); diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java index 8452995f..8e9b2cb9 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java @@ -1,5 +1,6 @@ package dev.caskeleton.buildlogic.java; +import dev.caskeleton.buildlogic.MainBuild; import io.spring.gradle.dependencymanagement.dsl.DependencyManagementExtension; import java.io.File; import java.io.IOException; @@ -282,11 +283,12 @@ public final class JavaConventionsPlugin implements Plugin { public static final String CONTAINER_IMAGE_PROPERTY_PREFIX = "ca.test.image."; private static File containerImageCatalog(Project project) { + // The optional platform build's root is a directory inside the main build, which owns the + // catalog. File root = project.getRootProject().getProjectDir(); - File catalog = new File(root, "config/testing/container-images.properties"); - if (!catalog.isFile()) { - // The optional-platforms build's root is a directory inside the main build. - catalog = new File(root.getParentFile(), "config/testing/container-images.properties"); + File catalog = MainBuild.nearest(root, "config/testing/container-images.properties"); + if (catalog == null) { + catalog = new File(root, "config/testing/container-images.properties"); } if (!catalog.isFile()) { throw new GradleException("Missing test container image catalog: " + catalog); diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/quality/QualityConventionsPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/quality/QualityConventionsPlugin.java index a6c5724d..82b53c5f 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/quality/QualityConventionsPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/quality/QualityConventionsPlugin.java @@ -5,6 +5,7 @@ import com.github.spotbugs.snom.Confidence; import com.github.spotbugs.snom.SpotBugsExtension; import com.github.spotbugs.snom.SpotBugsReport; import com.github.spotbugs.snom.SpotBugsTask; +import dev.caskeleton.buildlogic.MainBuild; import java.io.File; import java.util.List; import net.ltgt.gradle.errorprone.ErrorProneOptions; @@ -36,11 +37,14 @@ public final class QualityConventionsPlugin implements Plugin { SourceSet main = javaExtension.getSourceSets().getByName(SourceSet.MAIN_SOURCE_SET_NAME); SourceSet test = javaExtension.getSourceSets().getByName(SourceSet.TEST_SOURCE_SET_NAME); - File repositoryConfigDirectory = project.getRootProject().file("config"); - if (!repositoryConfigDirectory.isDirectory()) { - repositoryConfigDirectory = - new File(project.getRootProject().getProjectDir().getParentFile(), "config"); - } + // The optional platform build's root is a directory inside the main build, which owns the tool + // configuration. + File repositoryConfigDirectory = + MainBuild.nearest(project.getRootProject().getProjectDir(), "config/checkstyle"); + repositoryConfigDirectory = + repositoryConfigDirectory == null + ? project.getRootProject().file("config") + : repositoryConfigDirectory.getParentFile(); SpotlessExtension spotless = project.getExtensions().getByType(SpotlessExtension.class); spotless.java( diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/settings/OptionalArchitectureRegistrySettingsPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/settings/OptionalArchitectureRegistrySettingsPlugin.java index 6580a552..90b41b7c 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/settings/OptionalArchitectureRegistrySettingsPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/settings/OptionalArchitectureRegistrySettingsPlugin.java @@ -1,23 +1,17 @@ package dev.caskeleton.buildlogic.settings; +import dev.caskeleton.buildlogic.MainBuild; import dev.caskeleton.buildlogic.ModuleRegistrySettingsInstaller; import java.io.File; -import java.io.IOException; -import java.io.UncheckedIOException; import org.gradle.api.Plugin; import org.gradle.api.initialization.Settings; public final class OptionalArchitectureRegistrySettingsPlugin implements Plugin { @Override public void apply(Settings settings) { - try { - File mainBuildDirectory = settings.getSettingsDir().getParentFile().getCanonicalFile(); - File repositoryRoot = mainBuildDirectory.getParentFile().getCanonicalFile(); - File registryFile = new File(mainBuildDirectory, "config/architecture/modules.json"); - ModuleRegistrySettingsInstaller.install( - settings, registryFile, repositoryRoot, "optional-grpc"); - } catch (IOException exception) { - throw new UncheckedIOException("failed to resolve optional architecture registry paths", exception); - } + File mainBuildDirectory = MainBuild.directory(settings.getSettingsDir()); + File registryFile = new File(mainBuildDirectory, MainBuild.REGISTRY); + ModuleRegistrySettingsInstaller.install( + settings, registryFile, mainBuildDirectory.getParentFile(), "optional-grpc"); } } diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesExtension.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesExtension.java index 6a140481..03d1dd51 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesExtension.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesExtension.java @@ -18,7 +18,7 @@ public abstract class StrictLaneStagesExtension { * command executes this build's stages only when it starts in this build's directory from there * — its step's {@code working-directory} joined with its {@code -p}. The directory is read from * where the build is, so no build states it (review 2026-11-04 RR2-04-04: a {@code -p} value - * alone missed {@code working-directory: src/optional-platforms} with {@code ../gradlew}). + * alone missed {@code working-directory: src/platforms/optional-build} with {@code ../gradlew}). */ public abstract DirectoryProperty getWorkflowDirectory(); diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java index 7d494a1d..891cdf22 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java @@ -298,7 +298,7 @@ public final class StrictLaneStagesPlugin implements Plugin { /** * This build's directory from the repository root, which holds {@code .github/workflows}: {@code - * src} for the main build, {@code src/optional-platforms} for the optional one. + * src} for the main build, {@code src/platforms/optional-build} for the optional one. */ private static String buildDirectory(Project root, File workflowDirectory) { File repository = workflowDirectory.getAbsoluteFile().getParentFile().getParentFile(); diff --git a/src/config/architecture/modules.json b/src/config/architecture/modules.json index 9c284f5b..162d6d0f 100644 --- a/src/config/architecture/modules.json +++ b/src/config/architecture/modules.json @@ -386,13 +386,13 @@ { "id": "messaging-core-api", "gradle_path": ":messaging:messaging-core-api", - "source_path": "src/messaging/messaging-core-api", + "source_path": "src/platforms/messaging/messaging-core-api", "allowed_dependencies": [] }, { "id": "messaging-schema-json", "gradle_path": ":messaging:messaging-schema-json", - "source_path": "src/messaging/messaging-schema-json", + "source_path": "src/platforms/messaging/messaging-schema-json", "allowed_dependencies": [ "messaging-core-api" ] @@ -400,7 +400,7 @@ { "id": "messaging-schema-avro", "gradle_path": ":messaging:messaging-schema-avro", - "source_path": "src/messaging/messaging-schema-avro", + "source_path": "src/platforms/messaging/messaging-schema-avro", "allowed_dependencies": [ "messaging-core-api" ] @@ -408,7 +408,7 @@ { "id": "messaging-schema-protobuf", "gradle_path": ":messaging:messaging-schema-protobuf", - "source_path": "src/messaging/messaging-schema-protobuf", + "source_path": "src/platforms/messaging/messaging-schema-protobuf", "allowed_dependencies": [ "messaging-core-api" ] @@ -416,7 +416,7 @@ { "id": "messaging-cloudevents", "gradle_path": ":messaging:messaging-cloudevents", - "source_path": "src/messaging/messaging-cloudevents", + "source_path": "src/platforms/messaging/messaging-cloudevents", "allowed_dependencies": [ "messaging-core-api" ] @@ -424,7 +424,7 @@ { "id": "messaging-policy", "gradle_path": ":messaging:messaging-policy", - "source_path": "src/messaging/messaging-policy", + "source_path": "src/platforms/messaging/messaging-policy", "allowed_dependencies": [ "messaging-core-api" ] @@ -432,7 +432,7 @@ { "id": "messaging-transport-spi", "gradle_path": ":messaging:messaging-transport-spi", - "source_path": "src/messaging/messaging-transport-spi", + "source_path": "src/platforms/messaging/messaging-transport-spi", "allowed_dependencies": [ "messaging-core-api", "messaging-policy" @@ -441,7 +441,7 @@ { "id": "messaging-runtime-core", "gradle_path": ":messaging:messaging-runtime-core", - "source_path": "src/messaging/messaging-runtime-core", + "source_path": "src/platforms/messaging/messaging-runtime-core", "allowed_dependencies": [ "messaging-core-api", "messaging-policy", @@ -453,7 +453,7 @@ { "id": "messaging-observability", "gradle_path": ":messaging:messaging-observability", - "source_path": "src/messaging/messaging-observability", + "source_path": "src/platforms/messaging/messaging-observability", "allowed_dependencies": [ "messaging-core-api" ] @@ -461,7 +461,7 @@ { "id": "messaging-security", "gradle_path": ":messaging:messaging-security", - "source_path": "src/messaging/messaging-security", + "source_path": "src/platforms/messaging/messaging-security", "allowed_dependencies": [ "messaging-core-api" ] @@ -469,7 +469,7 @@ { "id": "messaging-kafka", "gradle_path": ":messaging:messaging-kafka", - "source_path": "src/messaging/messaging-kafka", + "source_path": "src/platforms/messaging/messaging-kafka", "allowed_dependencies": [ "messaging-core-api", "messaging-policy", @@ -482,7 +482,7 @@ { "id": "messaging-reliability-api", "gradle_path": ":messaging:messaging-reliability-api", - "source_path": "src/messaging/messaging-reliability-api", + "source_path": "src/platforms/messaging/messaging-reliability-api", "allowed_dependencies": [ "messaging-core-api" ] @@ -490,7 +490,7 @@ { "id": "messaging-reliability", "gradle_path": ":messaging:messaging-reliability", - "source_path": "src/messaging/messaging-reliability", + "source_path": "src/platforms/messaging/messaging-reliability", "allowed_dependencies": [ "messaging-core-api", "messaging-reliability-api" @@ -499,7 +499,7 @@ { "id": "messaging-reliability-jdbc-postgresql", "gradle_path": ":messaging:messaging-reliability-jdbc-postgresql", - "source_path": "src/messaging/messaging-reliability-jdbc-postgresql", + "source_path": "src/platforms/messaging/messaging-reliability-jdbc-postgresql", "allowed_dependencies": [ "messaging-core-api", "messaging-reliability-api", @@ -510,7 +510,7 @@ { "id": "messaging-claim-check", "gradle_path": ":messaging:messaging-claim-check", - "source_path": "src/messaging/messaging-claim-check", + "source_path": "src/platforms/messaging/messaging-claim-check", "allowed_dependencies": [ "messaging-core-api", "messaging-reliability-api" @@ -519,7 +519,7 @@ { "id": "messaging-admin", "gradle_path": ":messaging:messaging-admin", - "source_path": "src/messaging/messaging-admin", + "source_path": "src/platforms/messaging/messaging-admin", "allowed_dependencies": [ "messaging-core-api", "messaging-observability" @@ -528,7 +528,7 @@ { "id": "messaging-spring-boot-starter", "gradle_path": ":messaging:messaging-spring-boot-starter", - "source_path": "src/messaging/messaging-spring-boot-starter", + "source_path": "src/platforms/messaging/messaging-spring-boot-starter", "allowed_dependencies": [ "messaging-admin", "messaging-core-api", @@ -546,7 +546,7 @@ { "id": "messaging-spring-boot-starter-kafka", "gradle_path": ":messaging:messaging-spring-boot-starter-kafka", - "source_path": "src/messaging/messaging-spring-boot-starter-kafka", + "source_path": "src/platforms/messaging/messaging-spring-boot-starter-kafka", "allowed_dependencies": [ "messaging-spring-boot-starter", "messaging-kafka", @@ -562,7 +562,7 @@ { "id": "messaging-testkit", "gradle_path": ":messaging:messaging-testkit", - "source_path": "src/messaging/messaging-testkit", + "source_path": "src/platforms/messaging/messaging-testkit", "allowed_dependencies": [ "messaging-core-api", "messaging-policy", @@ -572,21 +572,21 @@ { "id": "grpc-contract", "gradle_path": ":grpc:grpc-contract", - "source_path": "src/grpc/grpc-contract", + "source_path": "src/platforms/grpc/grpc-contract", "allowed_dependencies": [], "build": "optional-grpc" }, { "id": "grpc-core-api", "gradle_path": ":grpc:grpc-core-api", - "source_path": "src/grpc/grpc-core-api", + "source_path": "src/platforms/grpc/grpc-core-api", "allowed_dependencies": [], "build": "optional-grpc" }, { "id": "grpc-observability", "gradle_path": ":grpc:grpc-observability", - "source_path": "src/grpc/grpc-observability", + "source_path": "src/platforms/grpc/grpc-observability", "allowed_dependencies": [ "grpc-core-api" ], @@ -595,7 +595,7 @@ { "id": "grpc-operation-ledger-jpa", "gradle_path": ":grpc:grpc-operation-ledger-jpa", - "source_path": "src/grpc/grpc-operation-ledger-jpa", + "source_path": "src/platforms/grpc/grpc-operation-ledger-jpa", "allowed_dependencies": [ "grpc-core-api" ], @@ -604,7 +604,7 @@ { "id": "grpc-runtime", "gradle_path": ":grpc:grpc-runtime", - "source_path": "src/grpc/grpc-runtime", + "source_path": "src/platforms/grpc/grpc-runtime", "allowed_dependencies": [ "grpc-core-api" ], @@ -613,7 +613,7 @@ { "id": "grpc-spring-boot-starter", "gradle_path": ":grpc:grpc-spring-boot-starter", - "source_path": "src/grpc/grpc-spring-boot-starter", + "source_path": "src/platforms/grpc/grpc-spring-boot-starter", "allowed_dependencies": [ "grpc-core-api", "grpc-runtime", @@ -624,7 +624,7 @@ { "id": "grpc-testkit", "gradle_path": ":grpc:grpc-testkit", - "source_path": "src/grpc/grpc-testkit", + "source_path": "src/platforms/grpc/grpc-testkit", "allowed_dependencies": [ "grpc-core-api", "grpc-runtime", @@ -636,7 +636,7 @@ { "id": "grpc-advanced", "gradle_path": ":grpc-advanced:grpc-advanced", - "source_path": "src/grpc-advanced/grpc-advanced", + "source_path": "src/platforms/grpc-advanced/grpc-advanced", "allowed_dependencies": [ "grpc-core-api", "grpc-runtime" @@ -646,7 +646,7 @@ { "id": "grpc-advanced-compat", "gradle_path": ":grpc-advanced:grpc-advanced-compat", - "source_path": "src/grpc-advanced/grpc-advanced-compat", + "source_path": "src/platforms/grpc-advanced/grpc-advanced-compat", "allowed_dependencies": [ "grpc-core-api", "grpc-runtime" diff --git a/src/grpc-advanced/CLAUDE.md b/src/platforms/grpc-advanced/CLAUDE.md similarity index 100% rename from src/grpc-advanced/CLAUDE.md rename to src/platforms/grpc-advanced/CLAUDE.md diff --git a/src/grpc-advanced/grpc-advanced-compat/build.gradle b/src/platforms/grpc-advanced/grpc-advanced-compat/build.gradle similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/build.gradle rename to src/platforms/grpc-advanced/grpc-advanced-compat/build.gradle diff --git a/src/grpc-advanced/grpc-advanced-compat/gradle.lockfile b/src/platforms/grpc-advanced/grpc-advanced-compat/gradle.lockfile similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/gradle.lockfile rename to src/platforms/grpc-advanced/grpc-advanced-compat/gradle.lockfile diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/kotlin/GrpcCoroutineContextBridge.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/kotlin/GrpcCoroutineContextBridge.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/kotlin/GrpcCoroutineContextBridge.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/kotlin/GrpcCoroutineContextBridge.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorCancellationBridge.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorCancellationBridge.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorCancellationBridge.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorCancellationBridge.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorContextBridge.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorContextBridge.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorContextBridge.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/GrpcReactorContextBridge.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcClient.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcClient.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcClient.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcClient.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProfile.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProfile.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProfile.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProfile.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProxyContract.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProxyContract.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProxyContract.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebProxyContract.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebRpcSupport.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebRpcSupport.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebRpcSupport.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/web/GrpcWebRpcSupport.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcCoroutineContextBridgeTest.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcCoroutineContextBridgeTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcCoroutineContextBridgeTest.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcCoroutineContextBridgeTest.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcWebCompatibilityTest.java b/src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcWebCompatibilityTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcWebCompatibilityTest.java rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcWebCompatibilityTest.java diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/resources/envoy/envoy.yaml b/src/platforms/grpc-advanced/grpc-advanced-compat/src/test/resources/envoy/envoy.yaml similarity index 100% rename from src/grpc-advanced/grpc-advanced-compat/src/test/resources/envoy/envoy.yaml rename to src/platforms/grpc-advanced/grpc-advanced-compat/src/test/resources/envoy/envoy.yaml diff --git a/src/grpc-advanced/grpc-advanced/build.gradle b/src/platforms/grpc-advanced/grpc-advanced/build.gradle similarity index 100% rename from src/grpc-advanced/grpc-advanced/build.gradle rename to src/platforms/grpc-advanced/grpc-advanced/build.gradle diff --git a/src/grpc-advanced/grpc-advanced/gradle.lockfile b/src/platforms/grpc-advanced/grpc-advanced/gradle.lockfile similarity index 100% rename from src/grpc-advanced/grpc-advanced/gradle.lockfile rename to src/platforms/grpc-advanced/grpc-advanced/gradle.lockfile diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapabilityDisabledException.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapabilityDisabledException.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapabilityDisabledException.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapabilityDisabledException.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedFeatureFlags.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedFeatureFlags.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedFeatureFlags.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedFeatureFlags.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuard.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuard.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuard.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuard.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcCapabilityGrade.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcCapabilityGrade.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcCapabilityGrade.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcCapabilityGrade.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsSnapshot.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsSnapshot.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsSnapshot.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsSnapshot.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcCustomResolver.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcCustomResolver.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcCustomResolver.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcCustomResolver.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointCandidate.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointCandidate.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointCandidate.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointCandidate.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointSnapshot.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointSnapshot.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointSnapshot.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcEndpointSnapshot.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerDecision.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerDecision.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerDecision.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerDecision.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerPicker.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerPicker.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerPicker.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerPicker.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerSafetyPolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerSafetyPolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerSafetyPolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcLoadBalancerSafetyPolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverSafetyPolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverSafetyPolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverSafetyPolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverSafetyPolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverUpdate.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverUpdate.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverUpdate.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/discovery/GrpcResolverUpdate.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024Policy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024Policy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024Policy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024Policy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026Status.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026Status.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026Status.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026Status.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReport.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReport.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReport.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReport.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEditionCompatibilityReport.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEditionCompatibilityReport.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEditionCompatibilityReport.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/edition/GrpcEditionCompatibilityReport.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingBudget.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingBudget.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingBudget.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingBudget.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingPolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingPolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingPolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingPolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingResult.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingResult.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingResult.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingResult.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiDirectionState.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiDirectionState.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiDirectionState.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiDirectionState.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiResumeState.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiResumeState.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiResumeState.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiResumeState.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTracker.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTracker.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTracker.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTracker.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSession.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSession.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSession.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSession.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicator.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicator.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicator.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicator.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamCheckpoint.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamCheckpoint.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamCheckpoint.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamCheckpoint.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamMessage.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamMessage.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamMessage.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamMessage.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamResumeDecision.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamResumeDecision.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamResumeDecision.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamResumeDecision.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamSessionId.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamSessionId.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamSessionId.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamSessionId.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamState.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamState.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamState.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamState.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandController.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandController.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandController.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandController.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandDecision.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandDecision.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandDecision.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandDecision.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcManualFlowControlPolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcManualFlowControlPolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcManualFlowControlPolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/streaming/GrpcManualFlowControlPolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsFailurePolicy.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsFailurePolicy.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsFailurePolicy.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsFailurePolicy.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsProfile.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsProfile.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsProfile.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsProfile.java diff --git a/src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsResourceSnapshot.java b/src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsResourceSnapshot.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsResourceSnapshot.java rename to src/platforms/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/xds/GrpcXdsResourceSnapshot.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactorIdempotenceTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactorIdempotenceTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactorIdempotenceTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactorIdempotenceTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024PolicyTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024PolicyTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024PolicyTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2024PolicyTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReportTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReportTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReportTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/edition/GrpcEdition2026WatchReportTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcLoadBalancerSafetyPolicyTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcLoadBalancerSafetyPolicyTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcLoadBalancerSafetyPolicyTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcLoadBalancerSafetyPolicyTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcResolverSafetyPolicyTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcResolverSafetyPolicyTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcResolverSafetyPolicyTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcResolverSafetyPolicyTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcXdsProfileTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcXdsProfileTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcXdsProfileTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcXdsProfileTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTrackerTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTrackerTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTrackerTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcBidiSequenceTrackerTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicatorTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicatorTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicatorTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientMessageDeduplicatorTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicyTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicyTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicyTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcClientStreamPolicyTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandControllerTest.java b/src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandControllerTest.java similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandControllerTest.java rename to src/platforms/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/streaming/GrpcDemandControllerTest.java diff --git a/src/grpc-advanced/grpc-advanced/src/test/resources/proto/edition2024/compatibility.proto b/src/platforms/grpc-advanced/grpc-advanced/src/test/resources/proto/edition2024/compatibility.proto similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/resources/proto/edition2024/compatibility.proto rename to src/platforms/grpc-advanced/grpc-advanced/src/test/resources/proto/edition2024/compatibility.proto diff --git a/src/grpc-advanced/grpc-advanced/src/test/resources/xds/control-plane-snapshot.json b/src/platforms/grpc-advanced/grpc-advanced/src/test/resources/xds/control-plane-snapshot.json similarity index 100% rename from src/grpc-advanced/grpc-advanced/src/test/resources/xds/control-plane-snapshot.json rename to src/platforms/grpc-advanced/grpc-advanced/src/test/resources/xds/control-plane-snapshot.json diff --git a/src/grpc/CLAUDE.md b/src/platforms/grpc/CLAUDE.md similarity index 94% rename from src/grpc/CLAUDE.md rename to src/platforms/grpc/CLAUDE.md index dbaaccd0..39ec8872 100644 --- a/src/grpc/CLAUDE.md +++ b/src/platforms/grpc/CLAUDE.md @@ -1,7 +1,7 @@ # grpc — local authority for the gRPC platform family 이 문서는 `grpc:*` family의 **local authority**다. gRPC platform은 기본 application build와 분리된 -`src/optional-platforms` build가 소유한다. 여기서 정하는 것은 family별 framework 규칙, 증거 등급, +`src/platforms/optional-build` build가 소유한다. 여기서 정하는 것은 family별 framework 규칙, 증거 등급, Stable 범위의 경계와 application에 채택될 때 필요한 계약이다. Root 정책(`CLAUDE.md` / `AGENTS.md`)과 충돌하면 root가 이긴다. @@ -11,7 +11,7 @@ Root 정책(`CLAUDE.md` / `AGENTS.md`)과 충돌하면 root가 이긴다. `adapter:inbound:grpc`를 통해 라이브러리로서 도달한다. 설계 근거와 원본 계획 대비 deviation은 -[docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md](../../docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md)가 SSOT다. +[docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md](../../../docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md)가 SSOT다. ## Family와 framework 규칙 @@ -86,7 +86,7 @@ capability flag 뒤에 있다. `GrpcPlatformStartupValidator`가 Stable catalog `grpc:*`와 `grpc-advanced:*`는 기본 `ca-skeleton` settings에 include되지 않는다. 따라서 일반 `:app-bootstrap:build`는 이 project들을 configure하지 않는다(목록은 registry의 `"build": "optional-grpc"`). 플랫폼 자체는 -`./gradlew -p optional-platforms ci`로 검증하고, application runtime에 실제 채택하려면 composition root가 +`./gradlew -p platforms/optional-build ci`로 검증하고, application runtime에 실제 채택하려면 composition root가 명시적으로 dependency를 가져오는 별도 변경이 필요하다. 런타임 포함 여부와 qualification은 별개다. in-process·Netty·fault lane이 통과해도 실제 배포 환경의 @@ -115,11 +115,11 @@ focused test는 registry의 `gradle_path`에서 파생한다. ```bash cd src -./gradlew -p optional-platforms :grpc::test --console=plain -./gradlew -p optional-platforms :grpc:grpc-testkit:grpcInProcessContractTest --console=plain -./gradlew -p optional-platforms :grpc:grpc-testkit:grpcNettyContractTest --console=plain -./gradlew -p optional-platforms :grpc:grpc-testkit:grpcFaultTest --console=plain -./gradlew -p optional-platforms :grpc:grpc-testkit:grpcPerformanceTest --console=plain +./gradlew -p platforms/optional-build :grpc::test --console=plain +./gradlew -p platforms/optional-build :grpc:grpc-testkit:grpcInProcessContractTest --console=plain +./gradlew -p platforms/optional-build :grpc:grpc-testkit:grpcNettyContractTest --console=plain +./gradlew -p platforms/optional-build :grpc:grpc-testkit:grpcFaultTest --console=plain +./gradlew -p platforms/optional-build :grpc:grpc-testkit:grpcPerformanceTest --console=plain ``` ## 금지 diff --git a/src/grpc/grpc-contract/buf.yaml b/src/platforms/grpc/grpc-contract/buf.yaml similarity index 85% rename from src/grpc/grpc-contract/buf.yaml rename to src/platforms/grpc/grpc-contract/buf.yaml index 5565f6e5..d81d5f19 100644 --- a/src/grpc/grpc-contract/buf.yaml +++ b/src/platforms/grpc/grpc-contract/buf.yaml @@ -4,9 +4,9 @@ # build.gradle) owns compilation. CI runs both `buf lint` and `buf breaking` from this directory — # see the `grpc-proto-buf` job in .github/workflows/ci-quality-gates.yml. # -# cd src/grpc/grpc-contract +# cd src/platforms/grpc/grpc-contract # buf lint -# buf breaking --against '#subdir=src/grpc/grpc-contract' +# buf breaking --against '#subdir=src/platforms/grpc/grpc-contract' # # No dependencies: the only imports are protoc's own well-known types (google/protobuf/*.proto). version: v2 diff --git a/src/grpc/grpc-contract/build.gradle b/src/platforms/grpc/grpc-contract/build.gradle similarity index 100% rename from src/grpc/grpc-contract/build.gradle rename to src/platforms/grpc/grpc-contract/build.gradle diff --git a/src/grpc/grpc-contract/gradle.lockfile b/src/platforms/grpc/grpc-contract/gradle.lockfile similarity index 100% rename from src/grpc/grpc-contract/gradle.lockfile rename to src/platforms/grpc/grpc-contract/gradle.lockfile diff --git a/src/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/error.proto b/src/platforms/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/error.proto similarity index 100% rename from src/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/error.proto rename to src/platforms/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/error.proto diff --git a/src/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/stream.proto b/src/platforms/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/stream.proto similarity index 100% rename from src/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/stream.proto rename to src/platforms/grpc/grpc-contract/src/main/proto/caskeleton/grpc/common/v1/stream.proto diff --git a/src/grpc/grpc-contract/src/test/java/dev/caskeleton/grpc/contract/GrpcContractGeneratedCodeTest.java b/src/platforms/grpc/grpc-contract/src/test/java/dev/caskeleton/grpc/contract/GrpcContractGeneratedCodeTest.java similarity index 100% rename from src/grpc/grpc-contract/src/test/java/dev/caskeleton/grpc/contract/GrpcContractGeneratedCodeTest.java rename to src/platforms/grpc/grpc-contract/src/test/java/dev/caskeleton/grpc/contract/GrpcContractGeneratedCodeTest.java diff --git a/src/grpc/grpc-core-api/build.gradle b/src/platforms/grpc/grpc-core-api/build.gradle similarity index 100% rename from src/grpc/grpc-core-api/build.gradle rename to src/platforms/grpc/grpc-core-api/build.gradle diff --git a/src/grpc/grpc-core-api/gradle.lockfile b/src/platforms/grpc/grpc-core-api/gradle.lockfile similarity index 100% rename from src/grpc/grpc-core-api/gradle.lockfile rename to src/platforms/grpc/grpc-core-api/gradle.lockfile diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcClaimToken.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcClaimToken.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcClaimToken.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcClaimToken.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcTransportLimits.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcTransportLimits.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcTransportLimits.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcTransportLimits.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcChannelProfileName.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcChannelProfileName.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcChannelProfileName.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcChannelProfileName.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcIdentifiers.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcIdentifiers.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcIdentifiers.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcIdentifiers.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcMethodName.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcMethodName.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcMethodName.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcMethodName.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcServiceName.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcServiceName.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcServiceName.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcServiceName.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcStatusCode.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcStatusCode.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcStatusCode.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/GrpcStatusCode.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/RpcType.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/RpcType.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/RpcType.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/core/RpcType.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcBusinessEvidence.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcBusinessEvidence.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcBusinessEvidence.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcBusinessEvidence.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidence.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidence.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidence.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidence.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcStreamEvidence.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcStreamEvidence.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcStreamEvidence.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcStreamEvidence.java diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcTransportEvidence.java b/src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcTransportEvidence.java similarity index 100% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcTransportEvidence.java rename to src/platforms/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/evidence/GrpcTransportEvidence.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentityTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentityTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentityTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentityTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedgerContractTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedgerContractTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedgerContractTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedgerContractTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcCoreIdentifiersTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcCoreIdentifiersTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcCoreIdentifiersTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcCoreIdentifiersTest.java diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidenceTest.java b/src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidenceTest.java similarity index 100% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidenceTest.java rename to src/platforms/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/evidence/GrpcExecutionEvidenceTest.java diff --git a/src/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java b/src/platforms/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java similarity index 100% rename from src/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java rename to src/platforms/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerContract.java diff --git a/src/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedger.java b/src/platforms/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedger.java similarity index 100% rename from src/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedger.java rename to src/platforms/grpc/grpc-core-api/src/testFixtures/java/dev/caskeleton/grpc/api/ledger/InMemoryOperationLedger.java diff --git a/src/grpc/grpc-observability/build.gradle b/src/platforms/grpc/grpc-observability/build.gradle similarity index 100% rename from src/grpc/grpc-observability/build.gradle rename to src/platforms/grpc/grpc-observability/build.gradle diff --git a/src/grpc/grpc-observability/gradle.lockfile b/src/platforms/grpc/grpc-observability/gradle.lockfile similarity index 100% rename from src/grpc/grpc-observability/gradle.lockfile rename to src/platforms/grpc/grpc-observability/gradle.lockfile diff --git a/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicy.java b/src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicy.java similarity index 100% rename from src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicy.java rename to src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicy.java diff --git a/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcObservationConvention.java b/src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcObservationConvention.java similarity index 100% rename from src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcObservationConvention.java rename to src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcObservationConvention.java diff --git a/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java b/src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java similarity index 100% rename from src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java rename to src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java diff --git a/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcStreamObservation.java b/src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcStreamObservation.java similarity index 100% rename from src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcStreamObservation.java rename to src/platforms/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcStreamObservation.java diff --git a/src/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java b/src/platforms/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java similarity index 100% rename from src/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java rename to src/platforms/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java diff --git a/src/grpc/grpc-operation-ledger-jpa/build.gradle b/src/platforms/grpc/grpc-operation-ledger-jpa/build.gradle similarity index 97% rename from src/grpc/grpc-operation-ledger-jpa/build.gradle rename to src/platforms/grpc/grpc-operation-ledger-jpa/build.gradle index e4a8fc38..6a83f775 100644 --- a/src/grpc/grpc-operation-ledger-jpa/build.gradle +++ b/src/platforms/grpc/grpc-operation-ledger-jpa/build.gradle @@ -27,7 +27,7 @@ configurations { // dependency on the main build (it would pull the whole main build into this one), and a test that // compares two copies (two definitions stay, and the test would have to parse Java source text). def sharedMigrationFileSources = tasks.register('sharedMigrationFileSources', Sync) { - from(file('../../adapter/outbound/persistence-jpa/src/testFixtures/java')) { + from(file('../../../adapter/outbound/persistence-jpa/src/testFixtures/java')) { include 'dev/caskeleton/adapter/outbound/persistence/testkit/migration/VersionedMigrationFiles.java' include 'dev/caskeleton/adapter/outbound/persistence/testkit/migration/ConcurrentIndexMigrationInspector.java' include 'dev/caskeleton/adapter/outbound/persistence/testkit/migration/MigrationResource.java' diff --git a/src/grpc/grpc-operation-ledger-jpa/gradle.lockfile b/src/platforms/grpc/grpc-operation-ledger-jpa/gradle.lockfile similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/gradle.lockfile rename to src/platforms/grpc/grpc-operation-ledger-jpa/gradle.lockfile diff --git a/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrations.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrations.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrations.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrations.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedgerContractIT.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedgerContractIT.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedgerContractIT.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedgerContractIT.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V001__create_grpc_operation_ledger.sql b/src/platforms/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V001__create_grpc_operation_ledger.sql similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V001__create_grpc_operation_ledger.sql rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V001__create_grpc_operation_ledger.sql diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V002__index_grpc_operation_ledger_finished_rows.sql b/src/platforms/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V002__index_grpc_operation_ledger_finished_rows.sql similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V002__index_grpc_operation_ledger_finished_rows.sql rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V002__index_grpc_operation_ledger_finished_rows.sql diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V003__add_grpc_operation_ledger_claim_attempt.sql b/src/platforms/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V003__add_grpc_operation_ledger_claim_attempt.sql similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V003__add_grpc_operation_ledger_claim_attempt.sql rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/main/resources/db/migration/grpc/V003__add_grpc_operation_ledger_claim_attempt.sql diff --git a/src/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java b/src/platforms/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java similarity index 100% rename from src/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java rename to src/platforms/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java diff --git a/src/grpc/grpc-runtime/build.gradle b/src/platforms/grpc/grpc-runtime/build.gradle similarity index 100% rename from src/grpc/grpc-runtime/build.gradle rename to src/platforms/grpc/grpc-runtime/build.gradle diff --git a/src/grpc/grpc-runtime/gradle.lockfile b/src/platforms/grpc/grpc-runtime/gradle.lockfile similarity index 100% rename from src/grpc/grpc-runtime/gradle.lockfile rename to src/platforms/grpc/grpc-runtime/gradle.lockfile diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcAdminExposurePolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcAdminExposurePolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcAdminExposurePolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcAdminExposurePolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPhase.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPhase.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPhase.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPhase.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainResult.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainResult.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainResult.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcDrainResult.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthState.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthState.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthState.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcHealthState.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshot.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshot.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshot.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshot.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotService.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotService.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotService.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotService.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionAccessDecision.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionAccessDecision.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionAccessDecision.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionAccessDecision.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionMode.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionMode.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionMode.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionMode.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistry.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistry.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistry.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistry.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcCallCredentialProvider.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcCallCredentialProvider.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcCallCredentialProvider.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcCallCredentialProvider.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelDrainPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelDrainPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelDrainPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelDrainPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelGeneration.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelGeneration.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelGeneration.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelGeneration.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelProfileValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelProfileValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelProfileValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelProfileValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntime.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntime.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntime.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntime.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcLoadBalancingPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcLoadBalancingPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcLoadBalancingPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcLoadBalancingPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubDescriptor.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubDescriptor.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubDescriptor.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubDescriptor.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcTypedStubFactory.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcTypedStubFactory.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcTypedStubFactory.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/client/GrpcTypedStubFactory.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextBinder.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextBinder.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextBinder.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextBinder.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextPropagationPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextPropagationPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextPropagationPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextPropagationPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellableOperation.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellableOperation.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellableOperation.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellableOperation.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationReason.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationReason.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationReason.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationReason.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDependencyBudget.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDependencyBudget.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDependencyBudget.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/deadline/GrpcDependencyBudget.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesRoutingMode.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesRoutingMode.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesRoutingMode.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcKubernetesRoutingMode.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverType.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverType.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverType.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcResolverType.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcStableLoadBalancer.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcStableLoadBalancer.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcStableLoadBalancer.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/discovery/GrpcStableLoadBalancer.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorExposurePolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorExposurePolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorExposurePolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorExposurePolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcRichErrorDetail.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcRichErrorDetail.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcRichErrorDetail.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcRichErrorDetail.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconciler.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconciler.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconciler.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconciler.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionResolution.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionResolution.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionResolution.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcCompletionResolution.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyDecision.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyDecision.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyDecision.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyDecision.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetention.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetention.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetention.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetention.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatus.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatus.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatus.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatus.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcRequestFingerprint.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcRequestFingerprint.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcRequestFingerprint.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/idempotency/GrpcRequestFingerprint.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcCompressionProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcCompressionProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcCompressionProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcCompressionProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcMessageSizeProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcMessageSizeProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcMessageSizeProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcMessageSizeProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcSizeViolation.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcSizeViolation.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcSizeViolation.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/policy/GrpcSizeViolation.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcMethodRetryConfig.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcMethodRetryConfig.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcMethodRetryConfig.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcMethodRetryConfig.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryBudget.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryBudget.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryBudget.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryBudget.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryDecision.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryDecision.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryDecision.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryDecision.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyDecision.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyDecision.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyDecision.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyDecision.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcAuthenticationProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcAuthenticationProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcAuthenticationProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcAuthenticationProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialGeneration.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialGeneration.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialGeneration.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialGeneration.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManager.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManager.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManager.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManager.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcTlsProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcTlsProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcTlsProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/security/GrpcTlsProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcAdmissionController.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcAdmissionController.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcAdmissionController.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcAdmissionController.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcExecutorProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcExecutorProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcExecutorProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcExecutorProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyParityContract.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyParityContract.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyParityContract.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyParityContract.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariant.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariant.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariant.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariant.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelector.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelector.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelector.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelector.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcResponseMapper.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcResponseMapper.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcResponseMapper.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcResponseMapper.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorChain.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorChain.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorChain.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorChain.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrder.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrder.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrder.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrder.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorStage.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorStage.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorStage.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerInterceptorStage.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerProfile.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerProfile.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerProfile.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerProfile.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerTransport.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerTransport.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerTransport.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServerTransport.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapterDescriptor.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapterDescriptor.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapterDescriptor.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapterDescriptor.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlDecision.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlDecision.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlDecision.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlDecision.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeDecision.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeDecision.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeDecision.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeDecision.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeToken.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeToken.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeToken.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeToken.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodec.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodec.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodec.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodec.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSlowConsumerPolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSlowConsumerPolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSlowConsumerPolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcSlowConsumerPolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelope.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelope.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelope.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelope.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamGapDetector.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamGapDetector.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamGapDetector.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamGapDetector.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamHeartbeat.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamHeartbeat.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamHeartbeat.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamHeartbeat.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamId.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamId.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamId.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamId.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifecycleCoordinator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifecycleCoordinator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifecycleCoordinator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifecycleCoordinator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicy.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicy.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicy.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicy.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamSequence.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamSequence.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamSequence.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamSequence.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamTerminationReason.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamTerminationReason.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamTerminationReason.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamTerminationReason.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriteResult.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriteResult.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriteResult.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriteResult.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriterState.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriterState.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriterState.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamWriterState.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcTransportValidator.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcTransportValidator.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcTransportValidator.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcTransportValidator.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java diff --git a/src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationViolation.java b/src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationViolation.java similarity index 100% rename from src/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationViolation.java rename to src/platforms/grpc/grpc-runtime/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationViolation.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinatorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinatorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinatorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcDrainCoordinatorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotServiceTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotServiceTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotServiceTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcPlatformSnapshotServiceTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicyTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicyTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicyTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcReflectionPolicyTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistryTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistryTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistryTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/admin/GrpcServiceHealthRegistryTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistryTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistryTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistryTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistryTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfileTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfileTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfileTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcNamedChannelProfileTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidatorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidatorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidatorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcDiscoveryPolicyValidatorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/discovery/GrpcKubernetesProfileTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetentionTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetentionTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetentionTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOperationLedgerRetentionTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicyTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicyTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicyTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/policy/GrpcPayloadBoundaryPolicyTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManagerTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManagerTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManagerTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcCredentialRotationManagerTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcTlsProfileTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcTlsProfileTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcTlsProfileTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/security/GrpcTlsProfileTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcAdmissionControllerTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcAdmissionControllerTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcAdmissionControllerTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcAdmissionControllerTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelectorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelectorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelectorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcNettyVariantSelectorTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrderTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrderTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrderTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerInterceptorOrderTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerProfileTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerProfileTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerProfileTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServerProfileTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicyTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicyTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicyTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcFlowControlPolicyTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodecTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodecTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodecTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcResumeTokenCodecTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelopeTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelopeTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelopeTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamEnvelopeTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicyTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicyTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicyTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamLifetimePolicyTest.java diff --git a/src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java b/src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java similarity index 100% rename from src/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java rename to src/platforms/grpc/grpc-runtime/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java diff --git a/src/grpc/grpc-spring-boot-starter/build.gradle b/src/platforms/grpc/grpc-spring-boot-starter/build.gradle similarity index 100% rename from src/grpc/grpc-spring-boot-starter/build.gradle rename to src/platforms/grpc/grpc-spring-boot-starter/build.gradle diff --git a/src/grpc/grpc-spring-boot-starter/gradle.lockfile b/src/platforms/grpc/grpc-spring-boot-starter/gradle.lockfile similarity index 100% rename from src/grpc/grpc-spring-boot-starter/gradle.lockfile rename to src/platforms/grpc/grpc-spring-boot-starter/gradle.lockfile diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java b/src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java rename to src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformConfigurationException.java b/src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformConfigurationException.java similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformConfigurationException.java rename to src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformConfigurationException.java diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java b/src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java rename to src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java b/src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java rename to src/platforms/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java diff --git a/src/grpc/grpc-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/platforms/grpc/grpc-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports rename to src/platforms/grpc/grpc-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports diff --git a/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java b/src/platforms/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java rename to src/platforms/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java diff --git a/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java b/src/platforms/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java similarity index 100% rename from src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java rename to src/platforms/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java diff --git a/src/grpc/grpc-testkit/build.gradle b/src/platforms/grpc/grpc-testkit/build.gradle similarity index 100% rename from src/grpc/grpc-testkit/build.gradle rename to src/platforms/grpc/grpc-testkit/build.gradle diff --git a/src/grpc/grpc-testkit/gradle.lockfile b/src/platforms/grpc/grpc-testkit/gradle.lockfile similarity index 100% rename from src/grpc/grpc-testkit/gradle.lockfile rename to src/platforms/grpc/grpc-testkit/gradle.lockfile diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceBudget.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceBudget.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceBudget.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceBudget.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceGate.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceGate.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceGate.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceGate.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceResult.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceResult.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceResult.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/performance/GrpcPerformanceResult.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcEvidenceGrade.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcEvidenceGrade.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcEvidenceGrade.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcEvidenceGrade.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContract.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContract.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContract.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContract.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingContractResult.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingContractResult.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingContractResult.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingContractResult.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingScenario.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingScenario.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingScenario.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcStreamingScenario.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcTextCodec.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcTextCodec.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcTextCodec.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcTextCodec.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultPoint.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultPoint.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultPoint.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultPoint.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessContractFixture.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessContractFixture.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessContractFixture.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessContractFixture.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestClient.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestClient.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestClient.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestClient.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestServer.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestServer.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestServer.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/inprocess/GrpcInProcessTestServer.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyContractProfile.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyContractProfile.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyContractProfile.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyContractProfile.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestClient.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestClient.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestClient.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestClient.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestServer.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestServer.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestServer.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcNettyTestServer.java diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java b/src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java similarity index 100% rename from src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java rename to src/platforms/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceGateTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceGateTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceGateTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceGateTest.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceLaneTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceLaneTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceLaneTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/performance/GrpcPerformanceLaneTest.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcInProcessContractFixtureTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcInProcessContractFixtureTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcInProcessContractFixtureTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcInProcessContractFixtureTest.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcNettyContractProfileTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcNettyContractProfileTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcNettyContractProfileTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcNettyContractProfileTest.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java similarity index 95% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java index a5f460cb..706fc1b4 100644 --- a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java +++ b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java @@ -20,7 +20,7 @@ class GrpcPackageOwnershipTest { List leaves = List.of("grpc-core-api", "grpc-runtime", "grpc-operation-ledger-jpa"); Map> owners = new LinkedHashMap<>(); for (String leaf : leaves) { - Path source = repo.resolve("src/grpc").resolve(leaf).resolve("src/main/java"); + Path source = repo.resolve("src/platforms/grpc").resolve(leaf).resolve("src/main/java"); try (var files = Files.walk(source)) { for (Path file : files.filter(path -> path.toString().endsWith(".java")).toList()) { var matcher = PACKAGE.matcher(Files.readString(file)); diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContractTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContractTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContractTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcServerStreamingContractTest.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java b/src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java similarity index 100% rename from src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java rename to src/platforms/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java diff --git a/src/messaging/CLAUDE.md b/src/platforms/messaging/CLAUDE.md similarity index 100% rename from src/messaging/CLAUDE.md rename to src/platforms/messaging/CLAUDE.md diff --git a/src/messaging/messaging-admin/build.gradle b/src/platforms/messaging/messaging-admin/build.gradle similarity index 100% rename from src/messaging/messaging-admin/build.gradle rename to src/platforms/messaging/messaging-admin/build.gradle diff --git a/src/messaging/messaging-admin/gradle.lockfile b/src/platforms/messaging/messaging-admin/gradle.lockfile similarity index 100% rename from src/messaging/messaging-admin/gradle.lockfile rename to src/platforms/messaging/messaging-admin/gradle.lockfile diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminApproval.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminApproval.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminApproval.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminApproval.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationJournal.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationJournal.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationJournal.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationJournal.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationLease.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationLease.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationLease.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationLease.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationRecord.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationRecord.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationRecord.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationRecord.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationState.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationState.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationState.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/AdminOperationState.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalGrant.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalGrant.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalGrant.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalGrant.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalVerifier.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalVerifier.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalVerifier.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovalVerifier.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedRedrivePlan.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedRedrivePlan.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedRedrivePlan.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedRedrivePlan.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedReplayPlan.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedReplayPlan.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedReplayPlan.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ApprovedReplayPlan.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestinationTopology.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestinationTopology.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestinationTopology.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestinationTopology.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperation.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperation.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperation.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperation.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperationGuard.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperationGuard.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperationGuard.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/DestructiveOperationGuard.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/HmacApprovalVerifier.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/HmacApprovalVerifier.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/HmacApprovalVerifier.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/HmacApprovalVerifier.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/PlanDigest.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/PlanDigest.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/PlanDigest.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/PlanDigest.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedrivePlan.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedrivePlan.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedrivePlan.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedrivePlan.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveRequest.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveRequest.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveRequest.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveRequest.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveResult.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveResult.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveResult.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/RedriveResult.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayPlan.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayPlan.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayPlan.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayPlan.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayRequest.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayRequest.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayRequest.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayRequest.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayResult.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayResult.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayResult.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/ReplayResult.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyIssue.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyIssue.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyIssue.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyIssue.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManagementMode.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManagementMode.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManagementMode.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManagementMode.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManifest.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManifest.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManifest.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyManifest.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyValidationReport.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyValidationReport.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyValidationReport.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/TopologyValidationReport.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/VerifiedApproval.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/VerifiedApproval.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/VerifiedApproval.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/VerifiedApproval.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/BrokerTopologyInspector.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/BrokerTopologyInspector.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/BrokerTopologyInspector.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/BrokerTopologyInspector.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/CompositeTopologyValidator.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/CompositeTopologyValidator.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/CompositeTopologyValidator.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/CompositeTopologyValidator.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DefaultMessagingAdminService.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DefaultMessagingAdminService.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DefaultMessagingAdminService.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DefaultMessagingAdminService.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/InMemoryAdminOperationJournal.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/InMemoryAdminOperationJournal.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/InMemoryAdminOperationJournal.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/InMemoryAdminOperationJournal.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/MessagingAdminService.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/MessagingAdminService.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/MessagingAdminService.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/MessagingAdminService.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveReport.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveReport.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveReport.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveReport.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveService.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveService.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveService.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/RedriveService.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayReport.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayReport.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayReport.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayReport.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntime.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntime.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntime.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntime.java diff --git a/src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidator.java b/src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidator.java similarity index 100% rename from src/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidator.java rename to src/platforms/messaging/messaging-admin/src/main/java/dev/caskeleton/messaging/admin/runtime/TopologyValidator.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/DestructiveOperationGuardTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/DestructiveOperationGuardTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/DestructiveOperationGuardTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/DestructiveOperationGuardTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/AdminOperationJournalTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/AdminOperationJournalTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/AdminOperationJournalTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/AdminOperationJournalTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovedPlanExecutionTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovedPlanExecutionTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovedPlanExecutionTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovedPlanExecutionTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/RedriveResumptionTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/RedriveResumptionTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/RedriveResumptionTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/RedriveResumptionTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntimeTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntimeTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntimeTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidationRuntimeTest.java diff --git a/src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidatorTest.java b/src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidatorTest.java similarity index 100% rename from src/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidatorTest.java rename to src/platforms/messaging/messaging-admin/src/test/java/dev/caskeleton/messaging/admin/runtime/TopologyValidatorTest.java diff --git a/src/messaging/messaging-claim-check/build.gradle b/src/platforms/messaging/messaging-claim-check/build.gradle similarity index 100% rename from src/messaging/messaging-claim-check/build.gradle rename to src/platforms/messaging/messaging-claim-check/build.gradle diff --git a/src/messaging/messaging-claim-check/gradle.lockfile b/src/platforms/messaging/messaging-claim-check/gradle.lockfile similarity index 100% rename from src/messaging/messaging-claim-check/gradle.lockfile rename to src/platforms/messaging/messaging-claim-check/gradle.lockfile diff --git a/src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityException.java b/src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityException.java similarity index 100% rename from src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityException.java rename to src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityException.java diff --git a/src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuard.java b/src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuard.java similarity index 100% rename from src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuard.java rename to src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuard.java diff --git a/src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPolicy.java b/src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPolicy.java similarity index 100% rename from src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPolicy.java rename to src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPolicy.java diff --git a/src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPublisher.java b/src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPublisher.java similarity index 100% rename from src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPublisher.java rename to src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckPublisher.java diff --git a/src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolver.java b/src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolver.java similarity index 100% rename from src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolver.java rename to src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolver.java diff --git a/src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckStore.java b/src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckStore.java similarity index 100% rename from src/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckStore.java rename to src/platforms/messaging/messaging-claim-check/src/main/java/dev/caskeleton/messaging/claimcheck/ClaimCheckStore.java diff --git a/src/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuardTest.java b/src/platforms/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuardTest.java similarity index 100% rename from src/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuardTest.java rename to src/platforms/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckIntegrityGuardTest.java diff --git a/src/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolverTest.java b/src/platforms/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolverTest.java similarity index 100% rename from src/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolverTest.java rename to src/platforms/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckResolverTest.java diff --git a/src/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckRetentionValidatorTest.java b/src/platforms/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckRetentionValidatorTest.java similarity index 100% rename from src/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckRetentionValidatorTest.java rename to src/platforms/messaging/messaging-claim-check/src/test/java/dev/caskeleton/messaging/claimcheck/ClaimCheckRetentionValidatorTest.java diff --git a/src/messaging/messaging-cloudevents/build.gradle b/src/platforms/messaging/messaging-cloudevents/build.gradle similarity index 100% rename from src/messaging/messaging-cloudevents/build.gradle rename to src/platforms/messaging/messaging-cloudevents/build.gradle diff --git a/src/messaging/messaging-cloudevents/gradle.lockfile b/src/platforms/messaging/messaging-cloudevents/gradle.lockfile similarity index 100% rename from src/messaging/messaging-cloudevents/gradle.lockfile rename to src/platforms/messaging/messaging-cloudevents/gradle.lockfile diff --git a/src/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventExtensions.java b/src/platforms/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventExtensions.java similarity index 100% rename from src/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventExtensions.java rename to src/platforms/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventExtensions.java diff --git a/src/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventMapper.java b/src/platforms/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventMapper.java similarity index 100% rename from src/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventMapper.java rename to src/platforms/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/CloudEventMapper.java diff --git a/src/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/DefaultCloudEventMapper.java b/src/platforms/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/DefaultCloudEventMapper.java similarity index 100% rename from src/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/DefaultCloudEventMapper.java rename to src/platforms/messaging/messaging-cloudevents/src/main/java/dev/caskeleton/messaging/cloudevents/DefaultCloudEventMapper.java diff --git a/src/messaging/messaging-cloudevents/src/test/java/dev/caskeleton/messaging/cloudevents/CloudEventMappingTest.java b/src/platforms/messaging/messaging-cloudevents/src/test/java/dev/caskeleton/messaging/cloudevents/CloudEventMappingTest.java similarity index 100% rename from src/messaging/messaging-cloudevents/src/test/java/dev/caskeleton/messaging/cloudevents/CloudEventMappingTest.java rename to src/platforms/messaging/messaging-cloudevents/src/test/java/dev/caskeleton/messaging/cloudevents/CloudEventMappingTest.java diff --git a/src/messaging/messaging-core-api/build.gradle b/src/platforms/messaging/messaging-core-api/build.gradle similarity index 100% rename from src/messaging/messaging-core-api/build.gradle rename to src/platforms/messaging/messaging-core-api/build.gradle diff --git a/src/messaging/messaging-core-api/gradle.lockfile b/src/platforms/messaging/messaging-core-api/gradle.lockfile similarity index 100% rename from src/messaging/messaging-core-api/gradle.lockfile rename to src/platforms/messaging/messaging-core-api/gradle.lockfile diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CausationId.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CausationId.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CausationId.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CausationId.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ContentType.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ContentType.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ContentType.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ContentType.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CorrelationId.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CorrelationId.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CorrelationId.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/CorrelationId.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageEnvelope.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageEnvelope.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageEnvelope.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageEnvelope.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageId.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageId.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageId.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageId.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageType.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageType.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageType.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/MessageType.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ProducerId.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ProducerId.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ProducerId.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/ProducerId.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/SchemaVersion.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/SchemaVersion.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/SchemaVersion.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/SchemaVersion.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TenantContext.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TenantContext.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TenantContext.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TenantContext.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TraceContext.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TraceContext.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TraceContext.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/TraceContext.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/UuidV7.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/UuidV7.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/UuidV7.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/UuidV7.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/WireSafeText.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/WireSafeText.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/WireSafeText.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/WireSafeText.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryContext.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryContext.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryContext.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryContext.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryGuarantee.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryGuarantee.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryGuarantee.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryGuarantee.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryMetadata.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryMetadata.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryMetadata.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/DeliveryMetadata.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/ExternalSideEffectGuarantee.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/ExternalSideEffectGuarantee.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/ExternalSideEffectGuarantee.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/ExternalSideEffectGuarantee.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/HandleResult.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/HandleResult.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/HandleResult.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/HandleResult.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageDelivery.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageDelivery.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageDelivery.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageDelivery.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageHandler.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageHandler.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageHandler.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/MessageHandler.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/OrderingScope.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/OrderingScope.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/OrderingScope.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/delivery/OrderingScope.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/ConfirmationRequirement.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/ConfirmationRequirement.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/ConfirmationRequirement.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/ConfirmationRequirement.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationCapabilities.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationCapabilities.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationCapabilities.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationCapabilities.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationKind.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationKind.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationKind.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationKind.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationName.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationName.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationName.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/DestinationName.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessageDestination.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessageDestination.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessageDestination.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessageDestination.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessagingCapabilities.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessagingCapabilities.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessagingCapabilities.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/destination/MessagingCapabilities.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureCategory.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureCategory.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureCategory.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureCategory.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureDescriptor.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureDescriptor.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureDescriptor.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/FailureDescriptor.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageAuthorizationException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageAuthorizationException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageAuthorizationException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageAuthorizationException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageBackpressureException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageBackpressureException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageBackpressureException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageBackpressureException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagePublishTimeoutException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagePublishTimeoutException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagePublishTimeoutException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagePublishTimeoutException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSchemaIncompatibleException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSchemaIncompatibleException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSchemaIncompatibleException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSchemaIncompatibleException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSerializationException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSerializationException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSerializationException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageSerializationException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTooLargeException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTooLargeException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTooLargeException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTooLargeException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTopologyException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTopologyException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTopologyException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageTopologyException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageValidationException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageValidationException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageValidationException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessageValidationException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingCapabilityUnavailableException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingCapabilityUnavailableException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingCapabilityUnavailableException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingCapabilityUnavailableException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingConfigurationException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingConfigurationException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingConfigurationException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingConfigurationException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingException.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingException.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingException.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/error/MessagingException.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/CanonicalEnvelopeHeaders.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/CanonicalEnvelopeHeaders.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/CanonicalEnvelopeHeaders.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/CanonicalEnvelopeHeaders.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderName.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderName.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderName.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderName.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderValue.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderValue.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderValue.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/HeaderValue.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/MessageHeaders.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/MessageHeaders.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/MessageHeaders.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/MessageHeaders.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/ReservedHeaders.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/ReservedHeaders.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/ReservedHeaders.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/header/ReservedHeaders.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/BrokerPosition.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/BrokerPosition.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/BrokerPosition.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/BrokerPosition.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/ConfirmationLevel.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/ConfirmationLevel.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/ConfirmationLevel.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/ConfirmationLevel.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/MessagePublisher.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/MessagePublisher.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/MessagePublisher.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/MessagePublisher.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishCompletion.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishCompletion.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishCompletion.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishCompletion.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishDeduplication.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishDeduplication.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishDeduplication.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishDeduplication.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishEvidence.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishEvidence.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishEvidence.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishEvidence.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishOptions.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishOptions.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishOptions.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishOptions.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishRequest.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishRequest.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishRequest.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishRequest.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishResult.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishResult.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishResult.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/PublishResult.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/RoutingOutcome.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/RoutingOutcome.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/RoutingOutcome.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/RoutingOutcome.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/TransmissionEvidence.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/TransmissionEvidence.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/TransmissionEvidence.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/publish/TransmissionEvidence.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementCompletion.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementCompletion.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementCompletion.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementCompletion.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementEvidence.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementEvidence.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementEvidence.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementEvidence.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementResult.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementResult.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementResult.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/api/settlement/SettlementResult.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/BoundedByteSink.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/BoundedByteSink.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/BoundedByteSink.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/BoundedByteSink.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessage.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessage.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessage.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessage.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessagePublisher.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessagePublisher.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessagePublisher.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/EncodedMessagePublisher.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodec.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodec.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodec.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodec.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodecRegistry.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodecRegistry.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodecRegistry.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageCodecRegistry.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageContractKey.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageContractKey.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageContractKey.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/MessageContractKey.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/RawBytesMessageCodec.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/RawBytesMessageCodec.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/RawBytesMessageCodec.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/RawBytesMessageCodec.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibility.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibility.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibility.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibility.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidator.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidator.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidator.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidator.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaReference.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaReference.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaReference.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaReference.java diff --git a/src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaRegistry.java b/src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaRegistry.java similarity index 100% rename from src/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaRegistry.java rename to src/platforms/messaging/messaging-core-api/src/main/java/dev/caskeleton/messaging/schema/SchemaRegistry.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/CoreValueTypesTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/CoreValueTypesTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/CoreValueTypesTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/CoreValueTypesTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/MessageEnvelopeTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/MessageEnvelopeTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/MessageEnvelopeTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/MessageEnvelopeTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/ModuleSmokeTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/ModuleSmokeTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/ModuleSmokeTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/ModuleSmokeTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireBoundaryRejectionTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireBoundaryRejectionTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireBoundaryRejectionTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireBoundaryRejectionTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireSafeValueObjectTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireSafeValueObjectTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireSafeValueObjectTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/WireSafeValueObjectTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/delivery/ConsumerContractTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/delivery/ConsumerContractTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/delivery/ConsumerContractTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/delivery/ConsumerContractTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/destination/DestinationCapabilityTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/destination/DestinationCapabilityTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/destination/DestinationCapabilityTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/destination/DestinationCapabilityTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/publish/PublishResultTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/publish/PublishResultTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/publish/PublishResultTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/api/publish/PublishResultTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/BoundedByteSinkTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/BoundedByteSinkTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/BoundedByteSinkTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/BoundedByteSinkTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/RawBytesMessageCodecTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/RawBytesMessageCodecTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/RawBytesMessageCodecTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/RawBytesMessageCodecTest.java diff --git a/src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidatorTest.java b/src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidatorTest.java similarity index 100% rename from src/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidatorTest.java rename to src/platforms/messaging/messaging-core-api/src/test/java/dev/caskeleton/messaging/schema/SchemaCompatibilityValidatorTest.java diff --git a/src/messaging/messaging-kafka/build.gradle b/src/platforms/messaging/messaging-kafka/build.gradle similarity index 97% rename from src/messaging/messaging-kafka/build.gradle rename to src/platforms/messaging/messaging-kafka/build.gradle index cfa3122a..620f1090 100644 --- a/src/messaging/messaging-kafka/build.gradle +++ b/src/platforms/messaging/messaging-kafka/build.gradle @@ -98,7 +98,7 @@ tasks.register('verifyMessagingCertificationEvidence') { description = 'Fails when the committed broker certification manifest claims a scenario the certification lane did not produce.' dependsOn 'messagingCertificationTest' def produced = layout.buildDirectory.file('messaging-certification/broker-certification-evidence.jsonl') - def committed = rootProject.file('messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl') + def committed = rootProject.file('platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl') inputs.file(produced) inputs.file(committed) doLast { diff --git a/src/messaging/messaging-kafka/gradle.lockfile b/src/platforms/messaging/messaging-kafka/gradle.lockfile similarity index 100% rename from src/messaging/messaging-kafka/gradle.lockfile rename to src/platforms/messaging/messaging-kafka/gradle.lockfile diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java diff --git a/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java b/src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java rename to src/platforms/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java diff --git a/src/messaging/messaging-kafka/src/jmh/java/dev/caskeleton/messaging/kafka/KafkaPublishBenchmark.java b/src/platforms/messaging/messaging-kafka/src/jmh/java/dev/caskeleton/messaging/kafka/KafkaPublishBenchmark.java similarity index 100% rename from src/messaging/messaging-kafka/src/jmh/java/dev/caskeleton/messaging/kafka/KafkaPublishBenchmark.java rename to src/platforms/messaging/messaging-kafka/src/jmh/java/dev/caskeleton/messaging/kafka/KafkaPublishBenchmark.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTracker.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTracker.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTracker.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTracker.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaBrokerProfile.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaBrokerProfile.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaBrokerProfile.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaBrokerProfile.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaCredentialCallbackHandler.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaCredentialCallbackHandler.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaCredentialCallbackHandler.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaCredentialCallbackHandler.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeadLetterPublisher.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeadLetterPublisher.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeadLetterPublisher.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeadLetterPublisher.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeliveryMapper.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeliveryMapper.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeliveryMapper.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaDeliveryMapper.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapper.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapper.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapper.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapper.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransport.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransport.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransport.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransport.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaOffsetResetExecutor.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaOffsetResetExecutor.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaOffsetResetExecutor.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaOffsetResetExecutor.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPartitionRetryScheduler.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPartitionRetryScheduler.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPartitionRetryScheduler.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPartitionRetryScheduler.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPosition.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPosition.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPosition.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPosition.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaProfileValidator.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaProfileValidator.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaProfileValidator.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaProfileValidator.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java similarity index 97% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java index d6569fdc..ce51ab3c 100644 --- a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java +++ b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifier.java @@ -73,8 +73,8 @@ public final class KafkaPublishFailureClassifier { * *

This flag departs from {@link FailureDescriptor#defaultRetryable} on purpose, for publish * only: that default says an authentication or authorization failure is not retried, and it still - * governs consumption, where the retry engine requires both. See {@code src/messaging/CLAUDE.md} - * "Publish retryability of authentication and authorization". + * governs consumption, where the retry engine requires both. See {@code + * src/platforms/messaging/CLAUDE.md} "Publish retryability of authentication and authorization". */ private static boolean mayPassOnRetry(Throwable cause) { return cause instanceof AuthenticationException || cause instanceof AuthorizationException; diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishMapper.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishMapper.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishMapper.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaPublishMapper.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaQuarantinePublisher.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayCapability.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayCapability.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayCapability.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayCapability.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlan.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlan.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlan.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlan.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlanner.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlanner.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlanner.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaReplayPlanner.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryExecutor.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryExecutor.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryExecutor.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryExecutor.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryMetadataMapper.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryMetadataMapper.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryMetadataMapper.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryMetadataMapper.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryOutcome.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryOutcome.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryOutcome.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryOutcome.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryTopicPublisher.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryTopicPublisher.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryTopicPublisher.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaRetryTopicPublisher.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementCommand.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementCommand.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementCommand.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementCommand.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementQueue.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementQueue.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementQueue.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSettlementQueue.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionProfileValidator.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionProfileValidator.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionProfileValidator.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionProfileValidator.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalDelivery.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalDelivery.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalDelivery.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalDelivery.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalOutput.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalOutput.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalOutput.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalOutput.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalProcessor.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalProcessor.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalProcessor.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalProcessor.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalPublisher.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalPublisher.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalPublisher.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaTransactionalPublisher.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionOffsetTracker.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionOffsetTracker.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionOffsetTracker.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionOffsetTracker.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinator.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinator.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinator.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinator.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/SpringKafkaTransactionalProcessor.java b/src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/SpringKafkaTransactionalProcessor.java similarity index 100% rename from src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/SpringKafkaTransactionalProcessor.java rename to src/platforms/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/SpringKafkaTransactionalProcessor.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTrackerTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTrackerTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTrackerTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ContiguousPartitionOffsetTrackerTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaEnvelopeRoundTripTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaEnvelopeRoundTripTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaEnvelopeRoundTripTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaEnvelopeRoundTripTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapperTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapperTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapperTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaHeaderMapperTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransportTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransportTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransportTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaMessagingTransportTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProducerContractTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProducerContractTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProducerContractTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProducerContractTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProfileValidatorTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProfileValidatorTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProfileValidatorTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaProfileValidatorTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifierTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifierTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifierTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaPublishFailureClassifierTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReplayPlannerTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReplayPlannerTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReplayPlannerTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReplayPlannerTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurerTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurerTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurerTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurerTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionOrderingTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionOrderingTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionOrderingTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionOrderingTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinatorTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinatorTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinatorTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/PartitionWorkCoordinatorTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ReservedHeaderForgeryTest.java b/src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ReservedHeaderForgeryTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ReservedHeaderForgeryTest.java rename to src/platforms/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/ReservedHeaderForgeryTest.java diff --git a/src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java b/src/platforms/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java similarity index 100% rename from src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java rename to src/platforms/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java diff --git a/src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java b/src/platforms/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java similarity index 100% rename from src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java rename to src/platforms/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java diff --git a/src/messaging/messaging-observability/build.gradle b/src/platforms/messaging/messaging-observability/build.gradle similarity index 100% rename from src/messaging/messaging-observability/build.gradle rename to src/platforms/messaging/messaging-observability/build.gradle diff --git a/src/messaging/messaging-observability/gradle.lockfile b/src/platforms/messaging/messaging-observability/gradle.lockfile similarity index 100% rename from src/messaging/messaging-observability/gradle.lockfile rename to src/platforms/messaging/messaging-observability/gradle.lockfile diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/CardinalityGuard.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/CardinalityGuard.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/CardinalityGuard.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/CardinalityGuard.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/DefaultMessagingObservationConvention.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/DefaultMessagingObservationConvention.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/DefaultMessagingObservationConvention.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/DefaultMessagingObservationConvention.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditEvent.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditEvent.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditEvent.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditEvent.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditSink.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditSink.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditSink.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingAuditSink.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingMetrics.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingMetrics.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingMetrics.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingMetrics.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingObservation.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingObservation.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingObservation.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingObservation.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingRedactor.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingRedactor.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingRedactor.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingRedactor.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTags.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTags.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTags.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTags.java diff --git a/src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTracer.java b/src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTracer.java similarity index 100% rename from src/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTracer.java rename to src/platforms/messaging/messaging-observability/src/main/java/dev/caskeleton/messaging/observation/MessagingTracer.java diff --git a/src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingMetricCardinalityTest.java b/src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingMetricCardinalityTest.java similarity index 100% rename from src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingMetricCardinalityTest.java rename to src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingMetricCardinalityTest.java diff --git a/src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingRedactorTest.java b/src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingRedactorTest.java similarity index 100% rename from src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingRedactorTest.java rename to src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingRedactorTest.java diff --git a/src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingSecretLeakTest.java b/src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingSecretLeakTest.java similarity index 100% rename from src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingSecretLeakTest.java rename to src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingSecretLeakTest.java diff --git a/src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingTraceLinkTest.java b/src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingTraceLinkTest.java similarity index 100% rename from src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingTraceLinkTest.java rename to src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/MessagingTraceLinkTest.java diff --git a/src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakScannerCharacterizationTest.java b/src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakScannerCharacterizationTest.java similarity index 100% rename from src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakScannerCharacterizationTest.java rename to src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakScannerCharacterizationTest.java diff --git a/src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakStaticScanTest.java b/src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakStaticScanTest.java similarity index 100% rename from src/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakStaticScanTest.java rename to src/platforms/messaging/messaging-observability/src/test/java/dev/caskeleton/messaging/observation/SecretLeakStaticScanTest.java diff --git a/src/messaging/messaging-policy/build.gradle b/src/platforms/messaging/messaging-policy/build.gradle similarity index 100% rename from src/messaging/messaging-policy/build.gradle rename to src/platforms/messaging/messaging-policy/build.gradle diff --git a/src/messaging/messaging-policy/gradle.lockfile b/src/platforms/messaging/messaging-policy/gradle.lockfile similarity index 100% rename from src/messaging/messaging-policy/gradle.lockfile rename to src/platforms/messaging/messaging-policy/gradle.lockfile diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ApiTier.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ApiTier.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ApiTier.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ApiTier.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/BackoffCalculator.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/BackoffCalculator.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/BackoffCalculator.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/BackoffCalculator.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ConsumerPolicy.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ConsumerPolicy.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ConsumerPolicy.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ConsumerPolicy.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterEnvelopeFactory.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterEnvelopeFactory.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterEnvelopeFactory.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterEnvelopeFactory.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterMetadata.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterMetadata.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterMetadata.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterMetadata.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterOrchestrator.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterOrchestrator.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterOrchestrator.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterOrchestrator.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterPolicy.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterPolicy.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterPolicy.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterPolicy.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterResult.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterResult.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterResult.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DeadLetterResult.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DefaultRetryDecisionEngine.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DefaultRetryDecisionEngine.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DefaultRetryDecisionEngine.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DefaultRetryDecisionEngine.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfile.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfile.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfile.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfile.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/FailureDescriptorDefaults.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/FailureDescriptorDefaults.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/FailureDescriptorDefaults.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/FailureDescriptorDefaults.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/InFlightLimiter.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/InFlightLimiter.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/InFlightLimiter.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/InFlightLimiter.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/OrderingImpact.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/OrderingImpact.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/OrderingImpact.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/OrderingImpact.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadLimitGuard.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadLimitGuard.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadLimitGuard.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadLimitGuard.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadPolicy.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadPolicy.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadPolicy.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PayloadPolicy.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PhysicalDestination.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PhysicalDestination.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PhysicalDestination.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/PhysicalDestination.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ProducerPolicy.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ProducerPolicy.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ProducerPolicy.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/ProducerPolicy.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryContext.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryContext.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryContext.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryContext.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecision.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecision.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecision.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecision.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecisionEngine.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecisionEngine.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecisionEngine.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryDecisionEngine.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryMode.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryMode.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryMode.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryMode.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryPolicy.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryPolicy.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryPolicy.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/RetryPolicy.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SchemaPolicy.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SchemaPolicy.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SchemaPolicy.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SchemaPolicy.java diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SourceSettlement.java b/src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SourceSettlement.java similarity index 100% rename from src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SourceSettlement.java rename to src/platforms/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/SourceSettlement.java diff --git a/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DeadLetterOrchestratorTest.java b/src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DeadLetterOrchestratorTest.java similarity index 100% rename from src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DeadLetterOrchestratorTest.java rename to src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DeadLetterOrchestratorTest.java diff --git a/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java b/src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java similarity index 100% rename from src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java rename to src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java diff --git a/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/MessagingAdmissionControllerTest.java b/src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/MessagingAdmissionControllerTest.java similarity index 100% rename from src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/MessagingAdmissionControllerTest.java rename to src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/MessagingAdmissionControllerTest.java diff --git a/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/RetryDecisionEngineTest.java b/src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/RetryDecisionEngineTest.java similarity index 100% rename from src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/RetryDecisionEngineTest.java rename to src/platforms/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/RetryDecisionEngineTest.java diff --git a/src/messaging/messaging-reliability-api/build.gradle b/src/platforms/messaging/messaging-reliability-api/build.gradle similarity index 100% rename from src/messaging/messaging-reliability-api/build.gradle rename to src/platforms/messaging/messaging-reliability-api/build.gradle diff --git a/src/messaging/messaging-reliability-api/gradle.lockfile b/src/platforms/messaging/messaging-reliability-api/gradle.lockfile similarity index 100% rename from src/messaging/messaging-reliability-api/gradle.lockfile rename to src/platforms/messaging/messaging-reliability-api/gradle.lockfile diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/ClaimCheckReference.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/ClaimCheckReference.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/ClaimCheckReference.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/ClaimCheckReference.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/InboxRepository.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/InboxRepository.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/InboxRepository.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/InboxRepository.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxCanonicalMetadata.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxCanonicalMetadata.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxCanonicalMetadata.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxCanonicalMetadata.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxLease.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxLease.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxLease.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxLease.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRecord.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRecord.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRecord.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRecord.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxStatus.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxStatus.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxStatus.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxStatus.java diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxTransitionResult.java b/src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxTransitionResult.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxTransitionResult.java rename to src/platforms/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxTransitionResult.java diff --git a/src/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java b/src/platforms/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java similarity index 100% rename from src/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java rename to src/platforms/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/build.gradle b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/build.gradle similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/build.gradle rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/build.gradle diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/gradle.lockfile b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/gradle.lockfile similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/gradle.lockfile rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/gradle.lockfile diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/inbox/JdbcInboxRepository.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/inbox/JdbcInboxRepository.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/inbox/JdbcInboxRepository.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/inbox/JdbcInboxRepository.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcAdminOperationJournal.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcAdminOperationJournal.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcAdminOperationJournal.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcAdminOperationJournal.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1005__messaging_outbox_ordering_key_index.sql b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1005__messaging_outbox_ordering_key_index.sql similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1005__messaging_outbox_ordering_key_index.sql rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1005__messaging_outbox_ordering_key_index.sql diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/JdbcInboxTransactionRequirementTest.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/JdbcInboxTransactionRequirementTest.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/JdbcInboxTransactionRequirementTest.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/JdbcInboxTransactionRequirementTest.java diff --git a/src/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/JdbcOutboxTransactionRequirementTest.java b/src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/JdbcOutboxTransactionRequirementTest.java similarity index 100% rename from src/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/JdbcOutboxTransactionRequirementTest.java rename to src/platforms/messaging/messaging-reliability-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/JdbcOutboxTransactionRequirementTest.java diff --git a/src/messaging/messaging-reliability/build.gradle b/src/platforms/messaging/messaging-reliability/build.gradle similarity index 100% rename from src/messaging/messaging-reliability/build.gradle rename to src/platforms/messaging/messaging-reliability/build.gradle diff --git a/src/messaging/messaging-reliability/gradle.lockfile b/src/platforms/messaging/messaging-reliability/gradle.lockfile similarity index 100% rename from src/messaging/messaging-reliability/gradle.lockfile rename to src/platforms/messaging/messaging-reliability/gradle.lockfile diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/IdempotentConsumer.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/IdempotentConsumer.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/IdempotentConsumer.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/IdempotentConsumer.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxCleanupJob.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxCleanupJob.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxCleanupJob.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxCleanupJob.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxMessageHandler.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxMessageHandler.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxMessageHandler.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxMessageHandler.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxOutcome.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxOutcome.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxOutcome.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxOutcome.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxRetentionPolicy.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxRetentionPolicy.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxRetentionPolicy.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/inbox/InboxRetentionPolicy.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxCleanupJob.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxCleanupJob.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxCleanupJob.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxCleanupJob.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactory.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactory.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactory.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactory.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxProperties.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxProperties.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxProperties.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxProperties.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelay.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelay.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelay.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelay.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayReport.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayReport.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayReport.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayReport.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayWorker.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayWorker.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayWorker.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRelayWorker.java diff --git a/src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRetryScheduler.java b/src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRetryScheduler.java similarity index 100% rename from src/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRetryScheduler.java rename to src/platforms/messaging/messaging-reliability/src/main/java/dev/caskeleton/messaging/outbox/OutboxRetryScheduler.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/IdempotentConsumerTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/IdempotentConsumerTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/IdempotentConsumerTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/IdempotentConsumerTest.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxMessageHandlerTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxMessageHandlerTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxMessageHandlerTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxMessageHandlerTest.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxOperationsTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxOperationsTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxOperationsTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/inbox/InboxOperationsTest.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactoryTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactoryTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactoryTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxEnvelopeFactoryTest.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java diff --git a/src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayWorkerTest.java b/src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayWorkerTest.java similarity index 100% rename from src/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayWorkerTest.java rename to src/platforms/messaging/messaging-reliability/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayWorkerTest.java diff --git a/src/messaging/messaging-runtime-core/build.gradle b/src/platforms/messaging/messaging-runtime-core/build.gradle similarity index 100% rename from src/messaging/messaging-runtime-core/build.gradle rename to src/platforms/messaging/messaging-runtime-core/build.gradle diff --git a/src/messaging/messaging-runtime-core/gradle.lockfile b/src/platforms/messaging/messaging-runtime-core/gradle.lockfile similarity index 100% rename from src/messaging/messaging-runtime-core/gradle.lockfile rename to src/platforms/messaging/messaging-runtime-core/gradle.lockfile diff --git a/src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DeclaredDestinationAccess.java b/src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DeclaredDestinationAccess.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DeclaredDestinationAccess.java rename to src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DeclaredDestinationAccess.java diff --git a/src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessor.java b/src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessor.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessor.java rename to src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessor.java diff --git a/src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java b/src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java rename to src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisher.java diff --git a/src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DestinationProfileRegistry.java b/src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DestinationProfileRegistry.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DestinationProfileRegistry.java rename to src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/DestinationProfileRegistry.java diff --git a/src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecs.java b/src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecs.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecs.java rename to src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecs.java diff --git a/src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/TransportMessagingRuntime.java b/src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/TransportMessagingRuntime.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/TransportMessagingRuntime.java rename to src/platforms/messaging/messaging-runtime-core/src/main/java/dev/caskeleton/messaging/runtime/TransportMessagingRuntime.java diff --git a/src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessorTest.java b/src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessorTest.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessorTest.java rename to src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultDeliveryProcessorTest.java diff --git a/src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisherTest.java b/src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisherTest.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisherTest.java rename to src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/DefaultMessagePublisherTest.java diff --git a/src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecsTest.java b/src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecsTest.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecsTest.java rename to src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RegisteredMessageCodecsTest.java diff --git a/src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RuntimeFixtures.java b/src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RuntimeFixtures.java similarity index 100% rename from src/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RuntimeFixtures.java rename to src/platforms/messaging/messaging-runtime-core/src/test/java/dev/caskeleton/messaging/runtime/RuntimeFixtures.java diff --git a/src/messaging/messaging-schema-avro/build.gradle b/src/platforms/messaging/messaging-schema-avro/build.gradle similarity index 100% rename from src/messaging/messaging-schema-avro/build.gradle rename to src/platforms/messaging/messaging-schema-avro/build.gradle diff --git a/src/messaging/messaging-schema-avro/gradle.lockfile b/src/platforms/messaging/messaging-schema-avro/gradle.lockfile similarity index 100% rename from src/messaging/messaging-schema-avro/gradle.lockfile rename to src/platforms/messaging/messaging-schema-avro/gradle.lockfile diff --git a/src/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityGate.java b/src/platforms/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityGate.java similarity index 100% rename from src/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityGate.java rename to src/platforms/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityGate.java diff --git a/src/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroMessageCodec.java b/src/platforms/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroMessageCodec.java similarity index 100% rename from src/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroMessageCodec.java rename to src/platforms/messaging/messaging-schema-avro/src/main/java/dev/caskeleton/messaging/schema/avro/AvroMessageCodec.java diff --git a/src/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityTest.java b/src/platforms/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityTest.java similarity index 100% rename from src/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityTest.java rename to src/platforms/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroCompatibilityTest.java diff --git a/src/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroHostileInputTest.java b/src/platforms/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroHostileInputTest.java similarity index 100% rename from src/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroHostileInputTest.java rename to src/platforms/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroHostileInputTest.java diff --git a/src/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroRegistryBoundsTest.java b/src/platforms/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroRegistryBoundsTest.java similarity index 100% rename from src/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroRegistryBoundsTest.java rename to src/platforms/messaging/messaging-schema-avro/src/test/java/dev/caskeleton/messaging/schema/avro/AvroRegistryBoundsTest.java diff --git a/src/messaging/messaging-schema-avro/src/test/resources/schemas/order.created/v1.avsc b/src/platforms/messaging/messaging-schema-avro/src/test/resources/schemas/order.created/v1.avsc similarity index 100% rename from src/messaging/messaging-schema-avro/src/test/resources/schemas/order.created/v1.avsc rename to src/platforms/messaging/messaging-schema-avro/src/test/resources/schemas/order.created/v1.avsc diff --git a/src/messaging/messaging-schema-json/build.gradle b/src/platforms/messaging/messaging-schema-json/build.gradle similarity index 100% rename from src/messaging/messaging-schema-json/build.gradle rename to src/platforms/messaging/messaging-schema-json/build.gradle diff --git a/src/messaging/messaging-schema-json/gradle.lockfile b/src/platforms/messaging/messaging-schema-json/gradle.lockfile similarity index 100% rename from src/messaging/messaging-schema-json/gradle.lockfile rename to src/platforms/messaging/messaging-schema-json/gradle.lockfile diff --git a/src/messaging/messaging-schema-json/src/main/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodec.java b/src/platforms/messaging/messaging-schema-json/src/main/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodec.java similarity index 100% rename from src/messaging/messaging-schema-json/src/main/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodec.java rename to src/platforms/messaging/messaging-schema-json/src/main/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodec.java diff --git a/src/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodecTest.java b/src/platforms/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodecTest.java similarity index 100% rename from src/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodecTest.java rename to src/platforms/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JacksonMessageCodecTest.java diff --git a/src/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JsonContractRegistryTest.java b/src/platforms/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JsonContractRegistryTest.java similarity index 100% rename from src/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JsonContractRegistryTest.java rename to src/platforms/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/JsonContractRegistryTest.java diff --git a/src/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/PlatformOverheadPerformanceTest.java b/src/platforms/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/PlatformOverheadPerformanceTest.java similarity index 100% rename from src/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/PlatformOverheadPerformanceTest.java rename to src/platforms/messaging/messaging-schema-json/src/test/java/dev/caskeleton/messaging/schema/json/PlatformOverheadPerformanceTest.java diff --git a/src/messaging/messaging-schema-protobuf/build.gradle b/src/platforms/messaging/messaging-schema-protobuf/build.gradle similarity index 100% rename from src/messaging/messaging-schema-protobuf/build.gradle rename to src/platforms/messaging/messaging-schema-protobuf/build.gradle diff --git a/src/messaging/messaging-schema-protobuf/gradle.lockfile b/src/platforms/messaging/messaging-schema-protobuf/gradle.lockfile similarity index 100% rename from src/messaging/messaging-schema-protobuf/gradle.lockfile rename to src/platforms/messaging/messaging-schema-protobuf/gradle.lockfile diff --git a/src/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageCodec.java b/src/platforms/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageCodec.java similarity index 100% rename from src/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageCodec.java rename to src/platforms/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageCodec.java diff --git a/src/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageContract.java b/src/platforms/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageContract.java similarity index 100% rename from src/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageContract.java rename to src/platforms/messaging/messaging-schema-protobuf/src/main/java/dev/caskeleton/messaging/schema/protobuf/ProtobufMessageContract.java diff --git a/src/messaging/messaging-schema-protobuf/src/test/java/dev/caskeleton/messaging/schema/protobuf/ProtobufCompatibilityTest.java b/src/platforms/messaging/messaging-schema-protobuf/src/test/java/dev/caskeleton/messaging/schema/protobuf/ProtobufCompatibilityTest.java similarity index 100% rename from src/messaging/messaging-schema-protobuf/src/test/java/dev/caskeleton/messaging/schema/protobuf/ProtobufCompatibilityTest.java rename to src/platforms/messaging/messaging-schema-protobuf/src/test/java/dev/caskeleton/messaging/schema/protobuf/ProtobufCompatibilityTest.java diff --git a/src/messaging/messaging-schema-protobuf/src/test/proto/order_created_v1.proto b/src/platforms/messaging/messaging-schema-protobuf/src/test/proto/order_created_v1.proto similarity index 100% rename from src/messaging/messaging-schema-protobuf/src/test/proto/order_created_v1.proto rename to src/platforms/messaging/messaging-schema-protobuf/src/test/proto/order_created_v1.proto diff --git a/src/messaging/messaging-security/build.gradle b/src/platforms/messaging/messaging-security/build.gradle similarity index 100% rename from src/messaging/messaging-security/build.gradle rename to src/platforms/messaging/messaging-security/build.gradle diff --git a/src/messaging/messaging-security/gradle.lockfile b/src/platforms/messaging/messaging-security/gradle.lockfile similarity index 100% rename from src/messaging/messaging-security/gradle.lockfile rename to src/platforms/messaging/messaging-security/gradle.lockfile diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerAclManifest.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerAclManifest.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerAclManifest.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerAclManifest.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerCredentialProfile.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerCredentialProfile.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerCredentialProfile.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerCredentialProfile.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerSecurityProfile.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerSecurityProfile.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerSecurityProfile.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerSecurityProfile.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTlsPolicy.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTlsPolicy.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTlsPolicy.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTlsPolicy.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTrustStore.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTrustStore.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTrustStore.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/BrokerTrustStore.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialIds.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialIds.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialIds.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialIds.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialProvider.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialProvider.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialProvider.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialProvider.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRotationPlan.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRotationPlan.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRotationPlan.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRotationPlan.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntime.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntime.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntime.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntime.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistry.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistry.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistry.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistry.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessPolicy.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessPolicy.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessPolicy.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessPolicy.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessValidator.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessValidator.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessValidator.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/DestinationAccessValidator.java diff --git a/src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/MessageSecurityValidator.java b/src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/MessageSecurityValidator.java similarity index 100% rename from src/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/MessageSecurityValidator.java rename to src/platforms/messaging/messaging-security/src/main/java/dev/caskeleton/messaging/security/MessageSecurityValidator.java diff --git a/src/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRotationContractTest.java b/src/platforms/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRotationContractTest.java similarity index 100% rename from src/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRotationContractTest.java rename to src/platforms/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRotationContractTest.java diff --git a/src/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistryTest.java b/src/platforms/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistryTest.java similarity index 100% rename from src/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistryTest.java rename to src/platforms/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/CredentialRuntimeRegistryTest.java diff --git a/src/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/MessageSecurityValidatorTest.java b/src/platforms/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/MessageSecurityValidatorTest.java similarity index 100% rename from src/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/MessageSecurityValidatorTest.java rename to src/platforms/messaging/messaging-security/src/test/java/dev/caskeleton/messaging/security/MessageSecurityValidatorTest.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/build.gradle b/src/platforms/messaging/messaging-spring-boot-starter-kafka/build.gradle similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/build.gradle rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/build.gradle diff --git a/src/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile b/src/platforms/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerCatalog.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerCatalog.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerCatalog.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerCatalog.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerSettings.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerSettings.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerSettings.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaBrokerSettings.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerLifecycle.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerLifecycle.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerLifecycle.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaConsumerLifecycle.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantine.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantine.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantine.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantine.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaPolledRegistration.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaPolledRegistration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaPolledRegistration.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaPolledRegistration.java diff --git a/src/messaging/messaging-spring-boot-starter-kafka/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantineTest.java b/src/platforms/messaging/messaging-spring-boot-starter-kafka/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantineTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter-kafka/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantineTest.java rename to src/platforms/messaging/messaging-spring-boot-starter-kafka/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaDeadLetterQuarantineTest.java diff --git a/src/messaging/messaging-spring-boot-starter/README.md b/src/platforms/messaging/messaging-spring-boot-starter/README.md similarity index 100% rename from src/messaging/messaging-spring-boot-starter/README.md rename to src/platforms/messaging/messaging-spring-boot-starter/README.md diff --git a/src/messaging/messaging-spring-boot-starter/build.gradle b/src/platforms/messaging/messaging-spring-boot-starter/build.gradle similarity index 100% rename from src/messaging/messaging-spring-boot-starter/build.gradle rename to src/platforms/messaging/messaging-spring-boot-starter/build.gradle diff --git a/src/messaging/messaging-spring-boot-starter/gradle.lockfile b/src/platforms/messaging/messaging-spring-boot-starter/gradle.lockfile similarity index 100% rename from src/messaging/messaging-spring-boot-starter/gradle.lockfile rename to src/platforms/messaging/messaging-spring-boot-starter/gradle.lockfile diff --git a/src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingKafkaConsumeQualificationTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingKafkaConsumeQualificationTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingKafkaConsumeQualificationTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingKafkaConsumeQualificationTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingSecuredBrokerQualificationTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingSecuredBrokerQualificationTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingSecuredBrokerQualificationTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingSecuredBrokerQualificationTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSecuritySettings.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSecuritySettings.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSecuritySettings.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSecuritySettings.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSettings.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSettings.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSettings.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/BrokerSettings.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DestinationSettings.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DestinationSettings.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DestinationSettings.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DestinationSettings.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageConsumers.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageConsumers.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageConsumers.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageConsumers.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageContracts.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageContracts.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageContracts.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessageContracts.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminDurabilityValidator.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminDurabilityValidator.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminDurabilityValidator.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminDurabilityValidator.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCredentialRequirementValidator.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCredentialRequirementValidator.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCredentialRequirementValidator.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCredentialRequirementValidator.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpoint.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpoint.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpoint.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpoint.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingObservabilityConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingObservabilityConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingObservabilityConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingObservabilityConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycle.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycle.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycle.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycle.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPrefixMigrationValidator.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPrefixMigrationValidator.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPrefixMigrationValidator.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPrefixMigrationValidator.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPublishConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPublishConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPublishConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPublishConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingReliabilityAutoConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingReliabilityAutoConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingReliabilityAutoConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingReliabilityAutoConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingSettings.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingSettings.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingSettings.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingSettings.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycle.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycle.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycle.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycle.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingValidationConfiguration.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingValidationConfiguration.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingValidationConfiguration.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingValidationConfiguration.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/StartupProfileValidation.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/StartupProfileValidation.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/StartupProfileValidation.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/StartupProfileValidation.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/ValidatedDestinationRegistry.java b/src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/ValidatedDestinationRegistry.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/ValidatedDestinationRegistry.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/ValidatedDestinationRegistry.java diff --git a/src/messaging/messaging-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/platforms/messaging/messaging-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports rename to src/platforms/messaging/messaging-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BrokerAccessListTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BrokerAccessListTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BrokerAccessListTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BrokerAccessListTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerConfigTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerConfigTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerConfigTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerConfigTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerSecurityTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerSecurityTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerSecurityTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/KafkaProducerSecurityTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfigurationTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfigurationTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfigurationTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConsumeConfigurationTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpointTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpointTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpointTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingEndpointTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingInboxAssemblyTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingInboxAssemblyTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingInboxAssemblyTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingInboxAssemblyTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformAutoConfigurationRegistrationTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformAutoConfigurationRegistrationTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformAutoConfigurationRegistrationTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformAutoConfigurationRegistrationTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycleTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycleTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycleTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingShutdownLifecycleTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java b/src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java diff --git a/src/messaging/messaging-spring-boot-starter/src/test/resources/application-invalid-ordering.yml b/src/platforms/messaging/messaging-spring-boot-starter/src/test/resources/application-invalid-ordering.yml similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/resources/application-invalid-ordering.yml rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/resources/application-invalid-ordering.yml diff --git a/src/messaging/messaging-spring-boot-starter/src/test/resources/application-valid.yml b/src/platforms/messaging/messaging-spring-boot-starter/src/test/resources/application-valid.yml similarity index 100% rename from src/messaging/messaging-spring-boot-starter/src/test/resources/application-valid.yml rename to src/platforms/messaging/messaging-spring-boot-starter/src/test/resources/application-valid.yml diff --git a/src/messaging/messaging-testkit/build.gradle b/src/platforms/messaging/messaging-testkit/build.gradle similarity index 100% rename from src/messaging/messaging-testkit/build.gradle rename to src/platforms/messaging/messaging-testkit/build.gradle diff --git a/src/messaging/messaging-testkit/gradle.lockfile b/src/platforms/messaging/messaging-testkit/gradle.lockfile similarity index 100% rename from src/messaging/messaging-testkit/gradle.lockfile rename to src/platforms/messaging/messaging-testkit/gradle.lockfile diff --git a/src/messaging/messaging-testkit/src/jmh/java/dev/caskeleton/messaging/testkit/EnvelopeCodecBenchmark.java b/src/platforms/messaging/messaging-testkit/src/jmh/java/dev/caskeleton/messaging/testkit/EnvelopeCodecBenchmark.java similarity index 100% rename from src/messaging/messaging-testkit/src/jmh/java/dev/caskeleton/messaging/testkit/EnvelopeCodecBenchmark.java rename to src/platforms/messaging/messaging-testkit/src/jmh/java/dev/caskeleton/messaging/testkit/EnvelopeCodecBenchmark.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractAssertions.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractAssertions.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractAssertions.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractAssertions.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractMessage.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractMessage.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractMessage.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ContractMessage.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/DockerAvailability.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/DockerAvailability.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/DockerAvailability.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/DockerAvailability.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/FaultController.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/FaultController.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/FaultController.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/FaultController.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/HandleOutcome.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/HandleOutcome.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/HandleOutcome.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/HandleOutcome.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterContract.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterContract.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterContract.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterContract.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterHarness.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterHarness.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterHarness.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/MessagingAdapterHarness.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/NetworkFaultScenario.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/NetworkFaultScenario.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/NetworkFaultScenario.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/NetworkFaultScenario.java diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ObservedDelivery.java b/src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ObservedDelivery.java similarity index 100% rename from src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ObservedDelivery.java rename to src/platforms/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/ObservedDelivery.java diff --git a/src/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl b/src/platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl similarity index 100% rename from src/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl rename to src/platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CertifiedEvidenceTest.java b/src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CertifiedEvidenceTest.java similarity index 100% rename from src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CertifiedEvidenceTest.java rename to src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CertifiedEvidenceTest.java diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java b/src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java similarity index 100% rename from src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java rename to src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CrossBrokerContractSuite.java b/src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CrossBrokerContractSuite.java similarity index 100% rename from src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CrossBrokerContractSuite.java rename to src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CrossBrokerContractSuite.java diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryHarnessContractTest.java b/src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryHarnessContractTest.java similarity index 100% rename from src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryHarnessContractTest.java rename to src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryHarnessContractTest.java diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryMessagingHarness.java b/src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryMessagingHarness.java similarity index 100% rename from src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryMessagingHarness.java rename to src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/InMemoryMessagingHarness.java diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/MessagingDocumentationContractTest.java b/src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/MessagingDocumentationContractTest.java similarity index 100% rename from src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/MessagingDocumentationContractTest.java rename to src/platforms/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/MessagingDocumentationContractTest.java diff --git a/src/messaging/messaging-transport-spi/build.gradle b/src/platforms/messaging/messaging-transport-spi/build.gradle similarity index 100% rename from src/messaging/messaging-transport-spi/build.gradle rename to src/platforms/messaging/messaging-transport-spi/build.gradle diff --git a/src/messaging/messaging-transport-spi/gradle.lockfile b/src/platforms/messaging/messaging-transport-spi/gradle.lockfile similarity index 100% rename from src/messaging/messaging-transport-spi/gradle.lockfile rename to src/platforms/messaging/messaging-transport-spi/gradle.lockfile diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/DefaultMessagingRuntimeRegistry.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/DefaultMessagingRuntimeRegistry.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/DefaultMessagingRuntimeRegistry.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/DefaultMessagingRuntimeRegistry.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/GracefulShutdownCoordinator.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/GracefulShutdownCoordinator.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/GracefulShutdownCoordinator.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/GracefulShutdownCoordinator.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntime.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntime.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntime.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntime.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeLease.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeLease.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeLease.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeLease.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistry.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistry.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistry.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistry.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingTransport.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingTransport.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingTransport.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/MessagingTransport.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerRegistration.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerRegistration.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerRegistration.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerRegistration.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerSpec.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerSpec.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerSpec.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportConsumerSpec.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportDelivery.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportDelivery.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportDelivery.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportDelivery.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishRequest.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishRequest.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishRequest.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishRequest.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishResult.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishResult.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishResult.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportPublishResult.java diff --git a/src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportSettlement.java b/src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportSettlement.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportSettlement.java rename to src/platforms/messaging/messaging-transport-spi/src/main/java/dev/caskeleton/messaging/transport/TransportSettlement.java diff --git a/src/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/GracefulShutdownTest.java b/src/platforms/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/GracefulShutdownTest.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/GracefulShutdownTest.java rename to src/platforms/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/GracefulShutdownTest.java diff --git a/src/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistryTest.java b/src/platforms/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistryTest.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistryTest.java rename to src/platforms/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/MessagingRuntimeRegistryTest.java diff --git a/src/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/ResourceLeakGateTest.java b/src/platforms/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/ResourceLeakGateTest.java similarity index 100% rename from src/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/ResourceLeakGateTest.java rename to src/platforms/messaging/messaging-transport-spi/src/test/java/dev/caskeleton/messaging/transport/ResourceLeakGateTest.java diff --git a/src/optional-platforms/README.md b/src/platforms/optional-build/README.md similarity index 81% rename from src/optional-platforms/README.md rename to src/platforms/optional-build/README.md index cd6ddebd..e6bce651 100644 --- a/src/optional-platforms/README.md +++ b/src/platforms/optional-build/README.md @@ -5,8 +5,8 @@ registry entries with `"build": "optional-grpc"`) are kept out of the main multi internal project dependencies while making their configuration opt-in. ```bash -./gradlew -p optional-platforms ci -./gradlew -p optional-platforms :grpc:grpc-testkit:grpcInProcessContractTest +./gradlew -p platforms/optional-build ci +./gradlew -p platforms/optional-build :grpc:grpc-testkit:grpcInProcessContractTest ``` `adapter:inbound:grpc` remains in the main application build because it is an application adapter; diff --git a/src/optional-platforms/build.gradle b/src/platforms/optional-build/build.gradle similarity index 96% rename from src/optional-platforms/build.gradle rename to src/platforms/optional-build/build.gradle index c73bdc21..9a2eb59c 100644 --- a/src/optional-platforms/build.gradle +++ b/src/platforms/optional-build/build.gradle @@ -84,9 +84,9 @@ tasks.register('releaseCheck') { } // The stages this build's strict lanes may belong to, executed by workflows as -// `./gradlew -p optional-platforms ` from `src`. A command counts when it starts in this +// `./gradlew -p platforms/optional-build ` from `src`. A command counts when it starts in this // directory (working-directory joined with -p), which the plugin reads from where this build is. strictLaneStages { stage ':ci', ':integrationCheck', ':performanceCheck', ':releaseCheck' - workflowDirectory = layout.projectDirectory.dir('../../.github/workflows') + workflowDirectory = layout.projectDirectory.dir('../../../.github/workflows') } diff --git a/src/optional-platforms/gradle.properties b/src/platforms/optional-build/gradle.properties similarity index 82% rename from src/optional-platforms/gradle.properties rename to src/platforms/optional-build/gradle.properties index 0d1f5861..cabb8146 100644 --- a/src/optional-platforms/gradle.properties +++ b/src/platforms/optional-build/gradle.properties @@ -1,4 +1,4 @@ -# optional-platforms is a build of its own (`./gradlew -p optional-platforms ...`), and Gradle reads +# optional-platforms is a build of its own (`./gradlew -p platforms/optional-build ...`), and Gradle reads # gradle.properties from the build's root directory only, so src/gradle.properties never reached it: # the optional build ran serially and without the build cache (review 2026-11-01 08-06). # The values and their reasons are src/gradle.properties'. settings.gradle fails the build when the diff --git a/src/optional-platforms/settings-gradle.lockfile b/src/platforms/optional-build/settings-gradle.lockfile similarity index 100% rename from src/optional-platforms/settings-gradle.lockfile rename to src/platforms/optional-build/settings-gradle.lockfile diff --git a/src/optional-platforms/settings.gradle b/src/platforms/optional-build/settings.gradle similarity index 80% rename from src/optional-platforms/settings.gradle rename to src/platforms/optional-build/settings.gradle index a34cfb8d..bec77029 100644 --- a/src/optional-platforms/settings.gradle +++ b/src/platforms/optional-build/settings.gradle @@ -1,5 +1,5 @@ pluginManagement { - includeBuild('../build-logic') + includeBuild('../../build-logic') } plugins { @@ -13,7 +13,7 @@ dependencyResolutionManagement { } versionCatalogs { libs { - from(files('../gradle/libs.versions.toml')) + from(files('../../gradle/libs.versions.toml')) } } } @@ -28,9 +28,9 @@ def readBuildProperties = { File file -> file.withInputStream { properties.load(it) } properties } -def mainBuildProperties = readBuildProperties(new File(settingsDir, '../gradle.properties')) +def mainBuildProperties = readBuildProperties(new File(settingsDir, '../../gradle.properties')) def ownBuildProperties = readBuildProperties(new File(settingsDir, 'gradle.properties')) if (mainBuildProperties != ownBuildProperties) { - throw new GradleException("optional-platforms/gradle.properties differs from src/gradle.properties: " + + throw new GradleException("platforms/optional-build/gradle.properties differs from src/gradle.properties: " + "${ownBuildProperties} vs ${mainBuildProperties}. Copy the main build's values.") } From 1ed683ffdb950d62c371c7c20cbcaa0a8e75a938 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 13:07:47 +0900 Subject: [PATCH 5/8] =?UTF-8?q?fix(messaging):=20=EC=9D=B8=EC=A6=9D=20?= =?UTF-8?q?=EC=A6=9D=EA=B1=B0=EB=A5=BC=20digest=EB=A1=9C=20=EA=B3=A0?= =?UTF-8?q?=EC=A0=95=ED=95=9C=20Kafka=20=EC=9D=B4=EB=AF=B8=EC=A7=80?= =?UTF-8?q?=EB=A1=9C=20=EB=8B=A4=EC=8B=9C=20=EB=A7=8C=EB=93=A0=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: :messaging:messaging-kafka:verifyMessagingCertificationEvidence가 rc=1이다. 커밋된 증거 broker-certification-evidence.jsonl(2026-08-24)의 brokerImage는 apache/kafka:4.1.0인데, 2026-11-03 container-images.properties 가 kafka 이미지를 digest로 고정한 뒤 레인은 apache/kafka@sha256:bff074a5…로 돈다. 시나리오 넷의 결과는 같고 이미지 이름만 다르다. 이 workflow는 messaging 경로가 바뀔 때만 PR에서 돌아 그동안 드러나지 않았다. 고른 방법: 게이트가 안내하는 대로 이번 실행이 만든 jsonl로 커밋된 파일을 바꾼다(증거는 실행 기록이다). 손으로 이미지 이름만 고치지 않는다. 위험·한계: gitCommit 칸은 레인을 돌린 트리의 커밋(8d69e599, 이 파일만 다르다)을 가리킨다. 레인은 실 Kafka 컨테이너와 Toxiproxy가 있는 곳에서만 돈다. 검증(desktop, ~/t1-layout-logs/): - 고치기 전(트리 2b3354a4): verifyMessagingCertificationEvidence rc=1. claimed/produced 차이는 brokerImage(apache/kafka:4.1.0 ↔ apache/kafka@sha256:bff074a5…)뿐이고 시나리오·결과·testId는 같다 - 고친 뒤(트리 4b304c59): :messaging:messaging-kafka:verifyMessagingCertificationEvidence -PcertificationCommit=8d69e599… :messaging:messaging-testkit:check :messaging:messaging-kafka:check rc=0 (messagingCertificationTest 실행) --- .../messaging/broker-certification-evidence.jsonl | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl b/src/platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl index 5a94717d..5867276a 100644 --- a/src/platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl +++ b/src/platforms/messaging/messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl @@ -1,4 +1,4 @@ -{"adapter":"messaging-kafka","brokerImage":"apache/kafka:4.1.0","scenario":"confirm-timeout","testId":"KafkaBrokerCertificationIT#aConfirmThatNeverArrivesIsReportedAsAmbiguousAndTheRecordIsThere","outcome":"AMBIGUOUS","gitCommit":"e98b56eb03ecab588c21fd1e7dbcaa493c1d8645","observedAt":"2026-08-19T14:21:30.826332993Z"} -{"adapter":"messaging-kafka","brokerImage":"apache/kafka:4.1.0","scenario":"connection-cut-after-write","testId":"KafkaBrokerCertificationIT#aConnectionCutAfterTheWriteIsReportedAsAmbiguous","outcome":"AMBIGUOUS","gitCommit":"e98b56eb03ecab588c21fd1e7dbcaa493c1d8645","observedAt":"2026-08-19T14:21:34.906464945Z"} -{"adapter":"messaging-kafka","brokerImage":"apache/kafka:4.1.0","scenario":"high-latency","testId":"KafkaBrokerCertificationIT#latencyBeyondThePublishDeadlineIsReportedAsAmbiguous","outcome":"AMBIGUOUS","gitCommit":"e98b56eb03ecab588c21fd1e7dbcaa493c1d8645","observedAt":"2026-08-19T14:21:21.870705263Z"} -{"adapter":"messaging-kafka","brokerImage":"apache/kafka:4.1.0","scenario":"settlement-lost","testId":"KafkaBrokerCertificationIT#aDeliveryLostBeforeSettlementIsRedelivered","outcome":"REDELIVERED","gitCommit":"e98b56eb03ecab588c21fd1e7dbcaa493c1d8645","observedAt":"2026-08-19T14:21:42.058283607Z"} +{"adapter":"messaging-kafka","brokerImage":"apache/kafka@sha256:bff074a5d0051dbc0bbbcd25b045bb1fe84833ec0d3c7c965d1797dd289ec88f","scenario":"confirm-timeout","testId":"KafkaBrokerCertificationIT#aConfirmThatNeverArrivesIsReportedAsAmbiguousAndTheRecordIsThere","outcome":"AMBIGUOUS","gitCommit":"8d69e599a376e4db29fdf7b96e06fa457ba6ace1","observedAt":"2026-11-07T04:05:39.857063221Z"} +{"adapter":"messaging-kafka","brokerImage":"apache/kafka@sha256:bff074a5d0051dbc0bbbcd25b045bb1fe84833ec0d3c7c965d1797dd289ec88f","scenario":"connection-cut-after-write","testId":"KafkaBrokerCertificationIT#aConnectionCutAfterTheWriteIsReportedAsAmbiguous","outcome":"AMBIGUOUS","gitCommit":"8d69e599a376e4db29fdf7b96e06fa457ba6ace1","observedAt":"2026-11-07T04:05:43.917138801Z"} +{"adapter":"messaging-kafka","brokerImage":"apache/kafka@sha256:bff074a5d0051dbc0bbbcd25b045bb1fe84833ec0d3c7c965d1797dd289ec88f","scenario":"high-latency","testId":"KafkaBrokerCertificationIT#latencyBeyondThePublishDeadlineIsReportedAsAmbiguous","outcome":"AMBIGUOUS","gitCommit":"8d69e599a376e4db29fdf7b96e06fa457ba6ace1","observedAt":"2026-11-07T04:05:29.018486328Z"} +{"adapter":"messaging-kafka","brokerImage":"apache/kafka@sha256:bff074a5d0051dbc0bbbcd25b045bb1fe84833ec0d3c7c965d1797dd289ec88f","scenario":"settlement-lost","testId":"KafkaBrokerCertificationIT#aDeliveryLostBeforeSettlementIsRedelivered","outcome":"REDELIVERED","gitCommit":"8d69e599a376e4db29fdf7b96e06fa457ba6ace1","observedAt":"2026-11-07T04:05:51.014447Z"} From e13a29024fa89e11a3103740be32ca8bb5a72eff Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 13:09:05 +0900 Subject: [PATCH 6/8] =?UTF-8?q?ci(repo)!:=20=EC=B5=9C=EC=83=81=EC=9C=84=20?= =?UTF-8?q?=ED=8F=B4=EB=8D=94=20=ED=97=88=EC=9A=A9=20=EB=AA=A9=EB=A1=9D=20?= =?UTF-8?q?=EA=B2=80=EC=82=AC=EB=A5=BC=20=EB=8D=94=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: src/ 아래 계층이 아닌 폴더가 2026-07-24의 둘에서 두 달 사이 여덟으로 늘었고, 루트에는 compose 파일과 infra/가 쌓였다. 어느 커밋도 최상위 모양을 묻지 않았고 리뷰 기준에도 그 칸이 없었다. 고른 방법(소유자 결정 2026-11-07, 설계 10.3절): scripts/check-repo-layout.py - 저장소 루트와 src/ 바로 아래의 추적 항목이 허용 목록 안에 있는가 - registry source_path가 허용된 src/ 폴더 아래인가 - (경고) compose·스크립트·compose 보조 파일을 아무 추적 파일도 가리키지 않는가 를 본다. ci-quality-gates.yml quality-gates job에 한 단계로 붙인다. Gradle 밖 스크립트다(문서·배치를 파싱하는 Gradle 검사를 두지 않는 정책). 버린 대안: registry에서 허용 폴더를 파생하기. 새 vendored 폴더를 registry 에 등록하는 것만으로 통과해, 막으려는 drift를 막지 못한다. 위험·한계: 참조 0 경고는 경로를 변수로 조립하는 workflow를 따라가지 못해 경고로만 둔다. 리뷰 기준·playbook 문장은 매뉴얼 보강 작업이 넣는다. 검증: - 노트북·desktop: python3 scripts/check-repo-layout.py rc=0, 경고 0 - 일부러 infra/, src/messaging/, 고아 compose/orphan.sh를 둔 임시 저장소: rc=1, 실패 3건과 경고 1건 - desktop(트리 c7cacf54): :app-bootstrap:repositoryContractTest :app-bootstrap:documentContractTest rc=0, :verifyStrictLaneStages --dry-run rc=0 - check-work-docs.py rc=0 - 업그레이드 안내 B-50~B-52의 근거 칸을 커밋 해시로 채운다 Refs: design-docs repo-structure/README.md 3.1, repo-structure/01-backend-layout.md 10.3 BREAKING CHANGE: 저장소 루트나 src/에 허용 목록 밖의 최상위 폴더를 둔 파생 서비스는 PR 게이트가 실패한다. docs/upgrade/2026-11-maturity-review.md B-53. --- .github/workflows/ci-quality-gates.yml | 4 + CLAUDE.md | 2 +- docs/upgrade/2026-11-maturity-review.md | 7 +- docs/work/reference/decisions.md | 1 + docs/work/reference/gates.md | 4 +- scripts/check-repo-layout.py | 210 ++++++++++++++++++++++++ 6 files changed, 223 insertions(+), 5 deletions(-) create mode 100755 scripts/check-repo-layout.py diff --git a/.github/workflows/ci-quality-gates.yml b/.github/workflows/ci-quality-gates.yml index 6d13fd90..d26c661c 100644 --- a/.github/workflows/ci-quality-gates.yml +++ b/.github/workflows/ci-quality-gates.yml @@ -57,6 +57,10 @@ jobs: run: ./gradlew :verifyStrictLaneStages --dry-run --stacktrace - name: Verify Compose profile contracts render exactly as declared run: bash scripts/verify-compose-profile-contracts.sh + # The repository root and src/ hold only the entries on the allow list (owner decision + # 2026-11-07): a new top-level folder is a decision, not a side effect of a feature commit. + - name: Refuse a top-level folder outside the allow list + run: python3 scripts/check-repo-layout.py optional-platforms: runs-on: ubuntu-latest diff --git a/CLAUDE.md b/CLAUDE.md index 89320333..d9d9826a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -54,7 +54,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이 ## 5. 코드만 보고는 헷갈리는 곳 -- **최상위 폴더는 정해진 것만 둔다.** 저장소 루트는 `compose.yaml`(개발 환경)·`compose/`(그 보조 파일)·`docs/`·`scripts/`·`src/`(Gradle 루트)다. `src/` 아래는 계층 leaf 폴더, `composition/`(조립), `platforms/`(들여온 제품: `messaging`·`grpc`·`grpc-advanced`와 optional 빌드 `optional-build`), Gradle 루트 표준(`build-logic`·`gradle`·`config`)이다. 테스트 환경 파일은 그 lane을 가진 leaf 안에 둔다. +- **최상위 폴더는 정해진 것만 둔다.** 저장소 루트는 `compose.yaml`(개발 환경)·`compose/`(그 보조 파일)·`docs/`·`scripts/`·`src/`(Gradle 루트)다. `src/` 아래는 계층 leaf 폴더, `composition/`(조립), `platforms/`(들여온 제품: `messaging`·`grpc`·`grpc-advanced`와 optional 빌드 `optional-build`), Gradle 루트 표준(`build-logic`·`gradle`·`config`)이다. 테스트 환경 파일은 그 lane을 가진 leaf 안에 둔다. `scripts/check-repo-layout.py`(PR 게이트)가 허용 목록 밖의 최상위 항목을 막는다. - **leaf 목록은 registry 하나다.** 문서는 leaf 개수를 적지 않는다(적힌 수는 leaf가 늘면 틀린다). runtime membership 목록은 없다. 조립 루트가 받을 수 있는 모듈은 registry의 `allowed_dependencies`가 정하고, 방향 게이트가 그 밖의 edge를 막는다. - **`src/platforms/messaging/*`는 Clean Architecture 계층이 아니다.** 자기 API·SPI·adapter·조립 경계를 가진, 들여온(vendored) 메시징 제품이다. `domain-core`·`application-core`·`shared-contract`에 의존하지 않는다. 이 애플리케이션은 `adapter:outbound:messaging`의 bridge로만 닿는다. 이유와 지역 규칙은 `src/platforms/messaging/CLAUDE.md`다. - **`composition:*` leaf는 조립만 한다.** outbox relay, 멱등성 executor, durable operation처럼 bootstrap에서 떼어 낸 조립이다. 각각 `runtimeOnly` 한 줄로 고른다. diff --git a/docs/upgrade/2026-11-maturity-review.md b/docs/upgrade/2026-11-maturity-review.md index cbf54325..5a5f3ebf 100644 --- a/docs/upgrade/2026-11-maturity-review.md +++ b/docs/upgrade/2026-11-maturity-review.md @@ -132,9 +132,10 @@ | # | 무엇이 바뀌었나 | 파생 서비스 증상 | 할 일 | 근거 | |---|---|---|---|---| | B-49 | 샘플 모듈 삭제: `src/sample-portfolio`, `src/Dockerfile.sample`, registry `sample-portfolio` 행, 루트 `build.gradle`의 샘플 태스크·단계(`sampleWebContractCheck`, `:sample-portfolio:*` 의존, strict lane 단계 `:sample-portfolio:check`), `ci-quality-gates.yml`의 `sample-portfolio` job, `SampleRuntimeDefaultsContractTest`, spotbugs 제외의 샘플 클래스. 샘플에만 있던 검사(OpenAPI 스냅숏 `openapiCheckSnapshot`, Date 헤더, 가상 스레드 MDC 전파)도 함께 없어졌다 | 샘플을 고쳐 쓰던 서비스: 병합 때 "수정 대 삭제" 충돌. 샘플을 이미 지운 서비스: 충돌 없음 | 샘플을 이미 지웠으면 할 일 없음. 고쳐 쓰고 있으면 자기 leaf로 옮기고 registry 행·빌드 줄을 자기 것으로 둔다. 위 검사가 필요하면 자기 기능 leaf에 둔다 | `ab5982e9` | -| B-50 | `infra/`에서 15개 삭제. 쓰는 곳이 없던 12개(`infra/httpclient/**`, `infra/jpa/postgres/README.md`, `infra/jpa/toxiproxy/`, `infra/messaging/{kafka,postgres,toxiproxy,tls}/`, `infra/notification/toxiproxy/`)와 운영 인프라 셋(`infra/fileserver/nginx/nginx.conf`, `infra/fileserver/kubernetes/pvc-certification-job.yaml`, `infra/jpa/roles/runtime-roles.sql`). `release.yml`의 `fileserver-pvc-certification` job도 지웠고, fileserver 지원 표에서 "Kubernetes ReadWriteOnce PVC — Limited" 주장을 「주장하지 않음」으로 옮겼다 | 그 파일을 배포에 쓰던 서비스: 병합이 파일을 지운다. 고쳐 쓰던 서비스: "수정 대 삭제" 충돌 | 그 파일은 자기 인프라 repo로 옮긴다. 지켜야 할 조건은 `docs/fileserver/operations.md` 「운영 환경이 지켜야 할 조건」, `docs/fileserver/storage-certification.md`, `docs/jpa/security.md` 「역할과 권한」·「서버 설정」에 있다 | 커밋 「쓰지 않는 파일과 운영 인프라 파일을 지운다」 | -| B-51 | compose 정리. 루트 `docker-compose.yml`·`docker-compose.local.yml`·`docker-compose.infra.yml`을 개발 환경 `compose.yaml` 하나로 합쳤다(app은 `local` 런타임, 뒷단 서비스는 capability profile `jpa`·`redis`·`kafka`·`mongo`·`objectstorage`·`auth`·`mail`). 보조 파일은 `compose/`(keycloak realm·entrypoint, minio init, Redis ACL, mailpit 인증서 폴더). 테스트 lane fixture는 그 lane을 가진 leaf로 옮겼다: `docker-compose.dev.yml`·`docker-compose.prod-smoke.yml`·`docker-compose.tls.yml`·fileserver overlay·smoke 스크립트·스키마 적용 스크립트·lane 계약 JSON(`src/config/runtime/compose-profile-contracts.json`) → `src/app-bootstrap/compose-lanes/`, Redis topology compose → `src/adapter/outbound/redis-sdk/compose/`, NFS compose → `src/adapter/outbound/fileserver/compose/nfs/`. `infra/`는 없어졌다. lane 계약의 `composeProfile`(문자열)은 `composeProfiles`(목록)로 바뀌었고 `appMemoryLimit`이 생겼다. smoke는 lane 중 컨테이너가 재시작하거나 메모리로 죽으면 실패한다. `scripts/bootstrap-local.sh`는 인자를 받지 않는다 | `docker compose -f docker-compose.yml -f docker-compose.local.yml …`을 쓰던 스크립트·문서가 "no such file"로 실패. 옛 compose 파일에 서비스를 더했으면 수정 대 삭제 충돌. lane 계약을 고쳐 쓰던 서비스는 `composeProfile` 키를 smoke 스크립트가 읽지 않는다 | 명령을 `docker compose …`(루트 `compose.yaml`)와 profile로 바꾼다. 더한 서비스는 `compose.yaml`에 capability profile을 달아 옮기고, lane 전용이면 `src/app-bootstrap/compose-lanes/lane-services.yaml`에 둔다. 경로를 적은 workflow·문서를 위 새 경로로 고친다 | 커밋 「compose 파일을 개발 환경 하나와 lane fixture로 나눈다」 | -| B-52 | `src/` 배치 정리. 들여온 플랫폼 넷을 `src/platforms/` 아래로 옮겼다: `src/messaging` → `src/platforms/messaging`, `src/grpc` → `src/platforms/grpc`, `src/grpc-advanced` → `src/platforms/grpc-advanced`, `src/optional-platforms` → `src/platforms/optional-build`(빌드 이름 `optional-platforms`는 그대로). registry `source_path`만 바뀌고 Gradle 경로(`:messaging:*`, `:grpc:*`)는 그대로다. optional 빌드는 `./gradlew -p platforms/optional-build …`로 부른다. `src/config/`에서 기능 하나가 주인인 데이터를 그 leaf의 `release/`로 옮겼다: `config/jpa/*` → `adapter/outbound/persistence-jpa/release/`, `config/messaging/**` → `adapter/outbound/messaging/release/`, `config/mongodb/release-contracts.json` → `adapter/outbound/persistence-mongo/release/` | `-p optional-platforms`를 부르는 workflow·스크립트가 "Project directory … does not exist"로 실패. 옮긴 폴더를 고쳐 쓰던 서비스는 이름 바뀜 충돌(Git이 이동으로 알아보면 자동 병합). `rootProject.file('config/jpa/…')`처럼 옛 경로를 읽던 자기 빌드 줄은 파일 없음 | workflow·스크립트의 `-p`와 경로를 새 위치로 고친다. 자기 leaf를 `src/messaging` 아래에 더했다면 `src/platforms/messaging` 아래로 옮기고 registry `source_path`를 고친다 | 커밋 「들여온 플랫폼을 src/platforms 아래로 묶는다」 | +| B-50 | `infra/`에서 15개 삭제. 쓰는 곳이 없던 12개(`infra/httpclient/**`, `infra/jpa/postgres/README.md`, `infra/jpa/toxiproxy/`, `infra/messaging/{kafka,postgres,toxiproxy,tls}/`, `infra/notification/toxiproxy/`)와 운영 인프라 셋(`infra/fileserver/nginx/nginx.conf`, `infra/fileserver/kubernetes/pvc-certification-job.yaml`, `infra/jpa/roles/runtime-roles.sql`). `release.yml`의 `fileserver-pvc-certification` job도 지웠고, fileserver 지원 표에서 "Kubernetes ReadWriteOnce PVC — Limited" 주장을 「주장하지 않음」으로 옮겼다 | 그 파일을 배포에 쓰던 서비스: 병합이 파일을 지운다. 고쳐 쓰던 서비스: "수정 대 삭제" 충돌 | 그 파일은 자기 인프라 repo로 옮긴다. 지켜야 할 조건은 `docs/fileserver/operations.md` 「운영 환경이 지켜야 할 조건」, `docs/fileserver/storage-certification.md`, `docs/jpa/security.md` 「역할과 권한」·「서버 설정」에 있다 | `a025f244` | +| B-51 | compose 정리. 루트 `docker-compose.yml`·`docker-compose.local.yml`·`docker-compose.infra.yml`을 개발 환경 `compose.yaml` 하나로 합쳤다(app은 `local` 런타임, 뒷단 서비스는 capability profile `jpa`·`redis`·`kafka`·`mongo`·`objectstorage`·`auth`·`mail`). 보조 파일은 `compose/`(keycloak realm·entrypoint, minio init, Redis ACL, mailpit 인증서 폴더). 테스트 lane fixture는 그 lane을 가진 leaf로 옮겼다: `docker-compose.dev.yml`·`docker-compose.prod-smoke.yml`·`docker-compose.tls.yml`·fileserver overlay·smoke 스크립트·스키마 적용 스크립트·lane 계약 JSON(`src/config/runtime/compose-profile-contracts.json`) → `src/app-bootstrap/compose-lanes/`, Redis topology compose → `src/adapter/outbound/redis-sdk/compose/`, NFS compose → `src/adapter/outbound/fileserver/compose/nfs/`. `infra/`는 없어졌다. lane 계약의 `composeProfile`(문자열)은 `composeProfiles`(목록)로 바뀌었고 `appMemoryLimit`이 생겼다. smoke는 lane 중 컨테이너가 재시작하거나 메모리로 죽으면 실패한다. `scripts/bootstrap-local.sh`는 인자를 받지 않는다 | `docker compose -f docker-compose.yml -f docker-compose.local.yml …`을 쓰던 스크립트·문서가 "no such file"로 실패. 옛 compose 파일에 서비스를 더했으면 수정 대 삭제 충돌. lane 계약을 고쳐 쓰던 서비스는 `composeProfile` 키를 smoke 스크립트가 읽지 않는다 | 명령을 `docker compose …`(루트 `compose.yaml`)와 profile로 바꾼다. 더한 서비스는 `compose.yaml`에 capability profile을 달아 옮기고, lane 전용이면 `src/app-bootstrap/compose-lanes/lane-services.yaml`에 둔다. 경로를 적은 workflow·문서를 위 새 경로로 고친다 | `50cd7154` | +| B-52 | `src/` 배치 정리. 들여온 플랫폼 넷을 `src/platforms/` 아래로 옮겼다: `src/messaging` → `src/platforms/messaging`, `src/grpc` → `src/platforms/grpc`, `src/grpc-advanced` → `src/platforms/grpc-advanced`, `src/optional-platforms` → `src/platforms/optional-build`(빌드 이름 `optional-platforms`는 그대로). registry `source_path`만 바뀌고 Gradle 경로(`:messaging:*`, `:grpc:*`)는 그대로다. optional 빌드는 `./gradlew -p platforms/optional-build …`로 부른다. `src/config/`에서 기능 하나가 주인인 데이터를 그 leaf의 `release/`로 옮겼다: `config/jpa/*` → `adapter/outbound/persistence-jpa/release/`, `config/messaging/**` → `adapter/outbound/messaging/release/`, `config/mongodb/release-contracts.json` → `adapter/outbound/persistence-mongo/release/` | `-p optional-platforms`를 부르는 workflow·스크립트가 "Project directory … does not exist"로 실패. 옮긴 폴더를 고쳐 쓰던 서비스는 이름 바뀜 충돌(Git이 이동으로 알아보면 자동 병합). `rootProject.file('config/jpa/…')`처럼 옛 경로를 읽던 자기 빌드 줄은 파일 없음 | workflow·스크립트의 `-p`와 경로를 새 위치로 고친다. 자기 leaf를 `src/messaging` 아래에 더했다면 `src/platforms/messaging` 아래로 옮기고 registry `source_path`를 고친다 | `8d69e599` | +| B-53 | 새 PR 검사 `python3 scripts/check-repo-layout.py`(`ci-quality-gates.yml`): 저장소 루트와 `src/` 최상위의 추적 항목이 허용 목록 안에 있어야 하고, registry `source_path`가 허용된 `src/` 폴더 아래여야 한다 | 자기 최상위 폴더(예: `infra/`, `src/<서비스 전용 폴더>`)를 둔 서비스는 PR 게이트가 실패한다 | 그 폴더가 정말 필요하면 스크립트의 `ROOT_ALLOWED`·`SRC_ALLOWED`와 자기 `CLAUDE.md` 지도에 같은 변경으로 더한다. 아니면 그 내용을 주인 leaf나 `docs/`로 옮긴다 | 커밋 「최상위 폴더 허용 목록 검사를 더한다」 | ## 4. DB 마이그레이션 diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index bd60ed44..f083fff2 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -74,6 +74,7 @@ | 생성 명령 | JPA adapter를 만들지 않음(서비스 전용 persistence leaf가 기본), 생성된 쓰기 API는 역할 매핑 전 403 | 위임 | `1101` 15절(r2-10) | | `@SystemInvoked` | bean으로 등록돼 있으면 기동 실패, inbound adapter가 직접 부르지 못하게 ArchUnit | 위임 | `1103` 4절(RR-01-02) | | 시스템 호출 경로 | 사용자가 닿는 전송(web·GraphQL·gRPC·WebSocket)만 `@SystemInvoked`에 닿지 못한다. 메시지 소비자·스케줄러는 `@SystemCaller(reason)` 표시로 허용 | 위임 | `1103` 9.1절(RR-01-12), 10절 r5-b | +| 배치 규칙 검사 | 저장소 루트와 `src/` 최상위 허용 목록을 `scripts/check-repo-layout.py`로 PR에서 막는다. 리뷰 기준에도 넣는다(매뉴얼 보강 작업) | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 10.3절 | | `src/` 배치 | 들여온 플랫폼 넷(`messaging`, `grpc`, `grpc-advanced`, optional 빌드)을 `src/platforms/` 아래로 묶는다. registry `source_path`만 바꾸고 Gradle 경로는 그대로 둔다. `build-logic`·`gradle`·`config`는 Gradle 루트 표준이라 남기고, `composition`은 조립 계층이라 옮기지 않는다. `config/`에서 기능 하나가 주인인 데이터 파일은 그 leaf로 보낸다. Gradle 루트를 저장소 루트로 옮길지는 CI 재편 때 다시 본다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.1절 | | 개발 compose 파일 | 저장소 루트에 `compose.yaml` 하나. 뒷단 서비스는 capability 이름 profile로 고르고, 마운트하는 보조 파일은 `compose/`에 둔다. 테스트 lane fixture는 그 lane을 가진 leaf로 보낸다(compose lane → app-bootstrap `compose-lanes/`, Redis topology → redis-sdk, NFS → fileserver). `docker-compose.dev.yml`은 `dev` 배포 프로필이 뜨는지 보는 lane fixture로 app-bootstrap에 둔다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 | | 인프라 실행 파일 | nginx 설정, Kubernetes PVC job, DB 역할 SQL은 이 repo에서 지우고, 기능이 운영 환경에 요구하는 조건만 그 기능 문서에 적는다. 아무도 쓰지 않는 `infra/` 파일도 지운다 | 소유자(2026-11-07) | design-docs `repo-structure/README.md` 3.1절, `repo-structure/01-backend-layout.md` 6.3절 | diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index aa8203a2..e70416e3 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -23,6 +23,7 @@ | `verifyStrictLaneStages --dry-run` | `explicitOnly`가 아닌 strict lane이 workflow가 실행하는 단계에 속하는가 | PR(두 빌드 각각) | `ci-quality-gates.yml`, optional 빌드는 `-p platforms/optional-build` | | `-p platforms/optional-build ci` | gRPC 플랫폼 빌드 | PR | `ci-quality-gates.yml` | | `bash scripts/verify-compose-profile-contracts.sh` | compose lane이 선언대로 렌더링되는가(저장소 루트에서) | PR | `ci-quality-gates.yml` | +| `python3 scripts/check-repo-layout.py` | 저장소 루트와 `src/` 최상위에 허용 목록 밖의 항목이 없는가, registry 경로가 허용 폴더 안인가. 아무도 가리키지 않는 compose·스크립트 파일은 경고 | PR | `ci-quality-gates.yml` | | `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `integration-main.yml`: `./gradlew :mainCheck --continue --warning-mode=fail` | | `integrationCheck` | 선언된 strict integration lane 전체(실 컨테이너). 입력이 없는 lane은 빼고 이름을 댄다 | main·nightly | `integration-main.yml`, optional 빌드도 | | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | main·nightly | `integration-main.yml`, optional 빌드도. 5절 | @@ -81,7 +82,7 @@ python3 scripts/check-work-docs.py --links $(git ls-files ':(glob)README.md' ':( | brief의 말 | 돌릴 것 | | --- | --- | -| pull request 단계 게이트 | (가)의 `# PR` 줄과 `verify-compose-profile-contracts.sh`, (나)에서 `pull_request`로 켜지는 것, (다) | +| pull request 단계 게이트 | (가)의 `# PR` 줄과 `verify-compose-profile-contracts.sh`·`check-repo-layout.py`, (나)에서 `pull_request`로 켜지는 것, (다) | | main 단계 | (가)의 `# main push` 줄과 `run-compose-runtime-smoke.sh`, (나)에서 main `push`로 켜지는 것 | | 라운드 끝 | 위 둘 전부와 (가)의 `# 태그` 두 줄 | @@ -112,6 +113,7 @@ cd src ./gradlew -p platforms/optional-build releaseCheck -PgitRevision="$(git rev-parse HEAD)" --no-build-cache --console=plain cd .. bash scripts/verify-compose-profile-contracts.sh +python3 scripts/check-repo-layout.py bash scripts/run-compose-runtime-smoke.sh --matrix src/app-bootstrap/compose-lanes/compose-profile-contracts.json ``` diff --git a/scripts/check-repo-layout.py b/scripts/check-repo-layout.py new file mode 100755 index 00000000..805adb87 --- /dev/null +++ b/scripts/check-repo-layout.py @@ -0,0 +1,210 @@ +#!/usr/bin/env python3 +"""저장소 루트와 src/ 최상위에 허용 목록 밖의 항목이 생기면 실패한다. + +왜: src/ 아래 계층이 아닌 폴더가 2026-07-24의 둘에서 두 달 사이 여덟으로 늘었고, 어느 커밋도 최상위 +모양을 묻지 않았다. 루트에는 개발 환경·테스트 fixture·운영 인프라가 섞인 compose 파일과 infra/ 폴더가 +쌓였다(2026-11-07 저장소 정리, design-docs repo-structure/01-backend-layout.md). 소유자는 배치 규칙을 +리뷰 기준에 두고, 이 허용 목록 검사로도 막기로 정했다(같은 날, repo-structure/README.md 3.1절). + +무엇을 보나: + +1. 저장소 루트의 추적 파일·폴더가 ROOT_ALLOWED 안에 있는가. +2. src/ 바로 아래의 추적 파일·폴더가 SRC_ALLOWED 안에 있는가. +3. registry(src/config/architecture/modules.json)의 모든 source_path가 허용된 src/ 폴더 아래에 있는가. +4. (경고만) 개발 환경·테스트 fixture 파일(compose 파일, 셸 스크립트, compose/ 아래 보조 파일)을 다른 + 추적 파일이 하나도 가리키지 않으면 이름을 출력한다. 아무도 읽지 않는 파일이 소리 없이 남는 것이 + infra/ 12개가 쌓인 방식이다. 경로를 변수로 조립하는 workflow는 이 검사가 따라가지 못하므로 경고로만 둔다. + +추적 파일만 본다(git ls-files). build 출력과 IDE 폴더는 처음부터 대상이 아니다. + +새 최상위 항목이 정말 필요하면 아래 목록과 루트 CLAUDE.md 5절 「최상위 폴더는 정해진 것만 둔다」를 같은 +변경에서 고친다. 최상위 폴더를 만들거나 옮기는 일은 파일 하나여도 큰 일이다(docs/work/README.md 2절). + +Gradle 밖에 둔다: 빌드는 저장소 배치를 판단하지 않는다(scripts/check-work-docs.py와 같은 자리). + + python3 scripts/check-repo-layout.py +""" + +from __future__ import annotations + +import json +import subprocess +import sys +from pathlib import Path, PurePosixPath + +REPO_ROOT = Path(__file__).resolve().parent.parent +REGISTRY = "src/config/architecture/modules.json" + +# 저장소 루트: 문서·스크립트·CI·개발 환경과 Gradle 루트(src)뿐이다. +ROOT_ALLOWED = { + # 폴더 + ".claude": "에이전트 세션 설정(추적되는 settings.json)", + ".github": "workflow와 공용 action", + "compose": "compose.yaml이 마운트하는 보조 파일", + "docs": "문서", + "scripts": "Gradle 밖 검사·실행 스크립트", + "src": "Gradle 루트", + # 파일 + ".gitattributes": "Git 설정", + ".gitignore": "Git 설정", + ".tool-versions": "JDK 버전 고정", + ".trivyignore.yaml": "취약점 검사 예외", + "AGENTS.md": "규칙 정본", + "CLAUDE.md": "작업 지도", + "README.md": "저장소 소개", + "compose.yaml": "개발 환경(하나뿐)", + "renovate.json": "의존성 갱신 봇 설정", + "skills-lock.json": "에이전트 스킬 고정", + "testcontainers.properties.example": "Testcontainers 로컬 설정 예", +} + +# src/ 바로 아래: 계층·조립 leaf, 들여온 제품 묶음, Gradle 루트 표준 폴더와 빌드 파일. +SRC_ALLOWED = { + # 계층과 조립 + "domain-core": "계층", + "shared-contract": "계층", + "application-core": "계층", + "application-fileserver": "계층(capability)", + "application-notification": "계층(capability)", + "application-objectstorage": "계층(capability)", + "adapter": "계층(adapter leaf 묶음)", + "composition": "조립(Clean Architecture의 Main)", + "app-bootstrap": "조립 루트", + # 들여온 제품 + "platforms": "들여온 제품(messaging, grpc, grpc-advanced)과 optional 빌드", + # Gradle 루트 표준 + "build-logic": "빌드 규칙(included build)", + "config": "빌드 전체 도구 설정(registry, checkstyle, spotbugs, 테스트 이미지)", + "gradle": "wrapper와 버전 카탈로그", + # 파일 + ".dockerignore": "이미지 빌드 context", + ".env.example": "env 계약", + ".env.local.example": "로컬 env 예", + ".gitignore": "Git 설정", + "Dockerfile": "릴리스 이미지", + "README.md": "빌드·env 안내", + "build.gradle": "루트 빌드", + "gradle.properties": "Gradle 설정", + "gradlew": "wrapper", + "gradlew.bat": "wrapper", + "settings-gradle.lockfile": "settings 잠금", + "settings.gradle": "settings", +} + +# 아무도 가리키지 않으면 경고할 파일: 개발 환경과 테스트 fixture. +FIXTURE_SUFFIXES = (".sh", ".acl", ".json", ".yaml", ".yml") +FIXTURE_PREFIXES = ("compose/", "scripts/", "src/app-bootstrap/compose-lanes/") +HISTORY_PREFIXES = ( + "docs/reviews/", + "docs/superpowers/", + "docs/evidence/", + "docs/study/", + "docs/adr/", +) + + +def tracked_files() -> list[str]: + result = subprocess.run( + ["git", "ls-files", "-z"], + cwd=REPO_ROOT, + check=True, + capture_output=True, + ) + return [path for path in result.stdout.decode("utf-8").split("\0") if path] + + +def top_level(paths: list[str], prefix: str) -> set[str]: + names = set() + for path in paths: + if not path.startswith(prefix): + continue + rest = path[len(prefix):] + names.add(rest.split("/", 1)[0]) + return names + + +def registry_violations() -> list[str]: + modules = json.loads((REPO_ROOT / REGISTRY).read_text(encoding="utf-8"))["modules"] + problems = [] + for module in modules: + source = PurePosixPath(module["source_path"]) + parts = source.parts + if len(parts) < 2 or parts[0] != "src" or parts[1] not in SRC_ALLOWED: + problems.append( + f"{REGISTRY}: {module['id']} source_path {source} is not under an allowed src/ folder" + ) + return problems + + +def is_fixture(path: str) -> bool: + if path.endswith(("README.md", ".gitignore")): + return False + name = PurePosixPath(path).name + if path.startswith(FIXTURE_PREFIXES) and name.endswith(FIXTURE_SUFFIXES): + return True + return "compose" in name and name.endswith((".yaml", ".yml")) + + +def unreferenced_fixtures(paths: list[str]) -> list[str]: + this_script = str(Path(__file__).resolve().relative_to(REPO_ROOT)) + readable = [ + p for p in paths if not p.startswith(HISTORY_PREFIXES) and p != this_script + ] + texts = {} + for path in readable: + file = REPO_ROOT / path + try: + if file.stat().st_size > 2_000_000: + continue + texts[path] = file.read_text(encoding="utf-8") + except (UnicodeDecodeError, OSError): + continue + lonely = [] + for path in sorted(p for p in paths if is_fixture(p)): + pure = PurePosixPath(path) + # The file's own path or name, or its folder when a compose file mounts the whole folder + # (./compose/redis/acl). A one-segment folder such as compose/ names too much to count. + needles = {path, pure.name} + if len(pure.parent.parts) >= 2: + needles.add(str(pure.parent)) + referenced = any( + other != path and any(needle in text for needle in needles) + for other, text in texts.items() + ) + if not referenced: + lonely.append(path) + return lonely + + +def main() -> int: + paths = tracked_files() + failures = [] + + for name in sorted(top_level(paths, "") - ROOT_ALLOWED.keys()): + failures.append(f"repository root: '{name}' is not in ROOT_ALLOWED") + for name in sorted(top_level(paths, "src/") - SRC_ALLOWED.keys()): + failures.append(f"src/: '{name}' is not in SRC_ALLOWED") + failures.extend(registry_violations()) + + for path in unreferenced_fixtures(paths): + print(f"warning: no tracked file refers to {path}") + + if failures: + for failure in failures: + print(f"FAIL: {failure}", file=sys.stderr) + print( + "check-repo-layout: a new top-level entry changes the repository's shape. If it is " + "wanted, add it to the allow list in scripts/check-repo-layout.py and to CLAUDE.md " + "section 5 in the same change.", + file=sys.stderr, + ) + return 1 + print( + f"check-repo-layout: OK — {len(top_level(paths, ''))} root entries, " + f"{len(top_level(paths, 'src/'))} src/ entries, registry paths inside allowed folders" + ) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) From 7305ab38a3c4e30474d8669617bc57b0a785bff6 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 14:34:22 +0900 Subject: [PATCH 7/8] =?UTF-8?q?fix(docker):=20=EC=9D=98=EC=A1=B4=EC=84=B1?= =?UTF-8?q?=20=EB=8B=A8=EA=B3=84=EC=97=90=20leaf=EC=9D=98=20release=20?= =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=84=B0=EB=A5=BC=20=EB=B3=B5=EC=82=AC?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 8d69e599가 config/jpa를 persistence-jpa의 release/로 옮긴 뒤 이미지 빌드가 깨진다. Dockerfile 의존성 단계는 config/와 빌드 파일만 복사하고 ./gradlew verifyDependencyLocks를 도는데, persistence-jpa build.gradle은 설정 평가 중에 release/readiness-cards.yaml을 읽는다("Unable to process file: …/release/readiness-cards.yaml"). 빠른 시작(bootstrap-local.sh)이 최종 게이트에서 rc=1로 드러냈다. compose smoke는 같은 빌드 실패를 무시해 이 결함을 숨겼다(다음 커밋). 고른 방법: 의존성 단계에 COPY --parents **/release/*.yaml **/release/*.json 한 줄을 더한다. 빌드 파일만 복사하는 단계의 성질(의존성 계층 캐시)은 그대로 두고, 설정 평가가 읽는 데이터만 더한다. 버린 대안: build.gradle이 그 파일을 늦게 읽게 바꾸기. readiness lane이 요구하는 테스트 목록이 설정 시점에 정해져야 해서 늦출 수 없다. DeveloperExperienceContractTest의 의존성 단계 계약에 이 줄을 더한다. 위험·한계: release/ 데이터가 바뀌면 의존성 계층도 다시 만든다(예전 config/와 같다). 검증(desktop ~/workspace/t1-final, ~/t1-layout-logs/): - RED: 8d69e599 이후 트리에서 이미지 빌드가 위 오류로 실패 (final/final-bootstrap.log, rc=1) - scripts/bootstrap-local.sh rc=0(이미지 빌드, /api/healthcheck 200 UP, 트리 3b755111 — 이 커밋과 Dockerfile 주석 한 줄만 다르다) - :app-bootstrap:repositoryContractTest :app-bootstrap:spotlessCheck rc=0 (트리 b91277be) Fixes: 8d69e599a376 ("refactor(repo)!: 들여온 플랫폼을 src/platforms 아래로 묶는다") --- src/Dockerfile | 5 +++++ .../bootstrap/contract/DeveloperExperienceContractTest.java | 4 +++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/src/Dockerfile b/src/Dockerfile index f7705495..20806c64 100644 --- a/src/Dockerfile +++ b/src/Dockerfile @@ -46,6 +46,11 @@ COPY gradle/ gradle/ COPY gradle.properties ./ COPY config/ ./config/ COPY --parents settings.gradle build.gradle **/build.gradle **/gradle.lockfile ./ +# The data a leaf's build script reads while Gradle configures it: the JPA leaf's readiness cards +# decide which scenarios each readiness lane requires. Since 2026-11-07 such data lives in the +# release/ folder of the leaf that owns it rather than under config/, and without this line that +# leaf fails to configure in the dependency-resolution stage below. +COPY --parents **/release/*.yaml **/release/*.json ./ # The convention plugins, whole. The glob above copies files named build.gradle and gradle.lockfile, # which picks up build-logic's own build script and misses the precompiled script plugins beside it — # so settings.gradle's `includeBuild('build-logic')` resolved against a build that declared no diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java index 5a9f5845..af7bb788 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java @@ -545,7 +545,9 @@ class DeveloperExperienceContractTest { .isEqualTo("/build/src"); assertThat(dependencyCachePrefix) .as("dependency-cache inputs before Gradle in %s", dockerfile) - .contains("COPY config/ ./config/"); + .contains("COPY config/ ./config/") + // The JPA leaf's build script parses release/readiness-cards.yaml while it configures. + .contains("COPY --parents **/release/*.yaml **/release/*.json ./"); } private static void assertDockerJarSelectionContract( From 2dd4acc6ebce0b596816f94df5677b640cc203fa Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 14:50:47 +0900 Subject: [PATCH 8/8] =?UTF-8?q?fix(compose):=20smoke=20matrix=EA=B0=80=20?= =?UTF-8?q?=EC=8B=A4=ED=8C=A8=ED=95=9C=20=EB=8B=A8=EA=B3=84=EB=A5=BC=20?= =?UTF-8?q?=EB=AC=B4=EC=8B=9C=ED=95=98=EC=A7=80=20=EC=95=8A=EA=B2=8C=20?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: scripts/run-compose-runtime-smoke.sh --matrix는 lane마다 `if ( trap cleanup_lane EXIT; run_lane ... )`로 돈다. bash는 if 조건으로 도는 명령 안에서(함수·subshell 포함) set -e를 끈다. 그래서 명시적으로 `return 1` 하지 않는 단계 — 계약 검사, config, 이미지 build, create, up --wait — 의 실패가 무시된다. 2026-11-07 최종 게이트에서 이미지 build가 실패했는데(7305ab38이 고친 결함), lane은 두 시간 전에 만든 이미지로 떠서 18개 모두 "passed"였다. --lane 모드는 run_lane을 직접 불러 영향이 없었다. 고른 방법: lane을 `set -e`를 켠 subshell에서 돌리고, 끝난 뒤 그 상태를 읽는다(if 조건으로 부르지 않는다). --lane 모드와 같은 동작이 된다. 버린 대안: 단계마다 `|| return 1`을 붙이기. 새 단계를 더할 때마다 다시 빠뜨리기 쉽다. 위험·한계: 지금까지 무시되던 단계의 실패가 이제 lane 실패가 된다. 그것이 목적이다. 검증(desktop ~/workspace/t1-final, ~/t1-layout-logs/): - RED: 이미지 build가 깨진 트리(e13a2902)에서 이 수정만 얹고 off-local 한 lane matrix: rc=1, "1 lane(s) failed: off-local" (red-smoke-buildfail.log). 수정 전 같은 트리의 18 lane matrix는 build 실패를 무시하고 rc=0(final/final-smoke.log) - 고친 뒤(트리 31466b8e = 이 커밋): run-compose-runtime-smoke.sh --matrix 18 lane rc=0(693초). 이미지를 새로 빌드했고(build.log ERROR 0), 모든 lane 컨테이너 재시작 0. 같은 트리에서 :ci, :mainCheck, scripts/bootstrap-local.sh, releaseCheck(두 빌드) rc=0 (~/t1-layout-logs/final/final2-summary.txt) Fixes: 50cd7154d05f ("refactor(compose)!: compose 파일을 개발 환경 하나와 lane fixture로 나눈다") --- scripts/run-compose-runtime-smoke.sh | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/scripts/run-compose-runtime-smoke.sh b/scripts/run-compose-runtime-smoke.sh index 9d854e30..5c07ec0d 100755 --- a/scripts/run-compose-runtime-smoke.sh +++ b/scripts/run-compose-runtime-smoke.sh @@ -623,11 +623,22 @@ echo "running ${total} blocking lane(s), zero-skip" # script reported that all six had passed. A wrapper whose own success message is a false green is # worse than no wrapper, and nothing else here would have caught it: the count came from the # contract and the exit status from the one lane that did run. +# +# Each lane runs in a subshell with `set -e` on and its status read afterwards, never as an `if` +# condition. Bash ignores `set -e` for every command run as part of an `if` condition, functions and +# subshells included, so `if ( run_lane ... )` turned every step that relied on it into a step whose +# failure was ignored. The image build was one: a build that failed left the lane to start the +# previous run's image, and all eighteen lanes reported green on code the build had refused +# (2026-11-07). --lane mode calls run_lane directly and was not affected. RAN_LANES=0 while read -r -u 3 lane_json; do [[ -z "${lane_json}" ]] && continue RAN_LANES=$((RAN_LANES + 1)) - if ( trap cleanup_lane EXIT; run_lane "${lane_json}" ); then :; else + set +e + ( set -e; trap cleanup_lane EXIT; run_lane "${lane_json}" ) + lane_status=$? + set -e + if [[ ${lane_status} -ne 0 ]]; then FAILED_LANES+=("$(jq -r '.id' <<<"${lane_json}")") fi done 3<<<"${blocking}"